Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.1 From: Daniel Shahaf To: zsh-workers@zsh.org Subject: [PATCH] docs: compsys: Clarify documentation of the 'filter' style. Date: Tue, 15 Mar 2016 00:06:48 +0000 Message-Id: <1458000408-3277-1-git-send-email-danielsh@tarsus.local2> X-Mailer: git-send-email 1.8.4.5 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Seq: zsh-workers 38155 --- A user on IRC misunderstood the incumbent text as describing «ldapsearch mail=», although we don't ship an ldapsearch completion. The function «_email_addresses» isn't documented in the man pages yet, only in source code comments. I'm leaving that for future work. Cheers, Daniel Doc/Zsh/compsys.yo | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Doc/Zsh/compsys.yo b/Doc/Zsh/compsys.yo index 2aa0740..d478e81 100644 --- a/Doc/Zsh/compsys.yo +++ b/Doc/Zsh/compsys.yo @@ -1554,7 +1554,8 @@ of the links themselves. ) kindex(filter, completion style) item(tt(filter))( -This is used by the LDAP plugin for e-mail address completion to specify +The tt(ldap) plugin of email address completion (see tt(_email_addresses)) uses +this style to specify the attributes to match against when filtering entries. So for example, if the style is set to `tt(sn)', matching is done against surnames. Standard LDAP filtering is used so normal completion matching is bypassed. If this