From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#16322: Acknowledgement (24.3; [PATCH] Streamline EUDC LDAP configuration) Date: Thu, 13 Nov 2014 22:16:07 +0200 Message-ID: <83ioiikgag.fsf@gnu.org> References: <83mw7vkvf1.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1415909849 29534 80.91.229.3 (13 Nov 2014 20:17:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 13 Nov 2014 20:17:29 +0000 (UTC) Cc: 16322@debbugs.gnu.org To: Thomas Fitzsimmons Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Nov 13 21:17:16 2014 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Xp0pQ-0001Cv-B5 for geb-bug-gnu-emacs@m.gmane.org; Thu, 13 Nov 2014 21:17:16 +0100 Original-Received: from localhost ([::1]:33759 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xp0pP-0007J9-Ti for geb-bug-gnu-emacs@m.gmane.org; Thu, 13 Nov 2014 15:17:15 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52199) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xp0pH-0007Is-OT for bug-gnu-emacs@gnu.org; Thu, 13 Nov 2014 15:17:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xp0pC-0002sv-Hx for bug-gnu-emacs@gnu.org; Thu, 13 Nov 2014 15:17:07 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:34337) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xp0pC-0002sr-Eo for bug-gnu-emacs@gnu.org; Thu, 13 Nov 2014 15:17:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Xp0pB-0001Zl-VV for bug-gnu-emacs@gnu.org; Thu, 13 Nov 2014 15:17:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 13 Nov 2014 20:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 16322 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 16322-submit@debbugs.gnu.org id=B16322.14159097725979 (code B ref 16322); Thu, 13 Nov 2014 20:17:01 +0000 Original-Received: (at 16322) by debbugs.gnu.org; 13 Nov 2014 20:16:12 +0000 Original-Received: from localhost ([127.0.0.1]:59783 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Xp0oN-0001YN-Lx for submit@debbugs.gnu.org; Thu, 13 Nov 2014 15:16:11 -0500 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:33045) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Xp0oL-0001YD-LC for 16322@debbugs.gnu.org; Thu, 13 Nov 2014 15:16:10 -0500 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0NEZ00700UO0ML00@a-mtaout22.012.net.il> for 16322@debbugs.gnu.org; Thu, 13 Nov 2014 22:16:08 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NEZ007WAUYVID30@a-mtaout22.012.net.il>; Thu, 13 Nov 2014 22:16:08 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:95954 > From: Thomas Fitzsimmons > Cc: 16322@debbugs.gnu.org > Date: Thu, 13 Nov 2014 12:11:59 -0500 > > * eudc.texi (LDAP Configuration): Rename from LDAP Requirements > and provide configuration examples. A few comments about this part: > +LDAP support is added by means of @file{ldap.el}, which is part of > +Emacs. @file{ldap.el} needs an external command line utility named > +@file{ldapsearch}, available as part of OpenLDAP Command names are better given the @command markup (here and elsewhere in the patch). > +@subsection Emacs-only Configuration Please don't use sectioning commands without a corresponding @node. Having subsections that aren't nodes makes those subsections harder to find. > +Specifying the function @code{ldap-password-read} for @code{passwd} > +will cause Emacs to prompt interactively for the password. The > +password will then be validated and cached, unless > +@code{password-cache} is nil. You can customize > +@code{password-cache-expiry} to control the duration for which the > +password is cached. If you want to clear the cache, call > +@code{password-reset}. Each variable or function you describe should have a corresponding @findex or @vindex entry right before the description. > +To authenticate, the @dfn{bind distinguished name (binddn)} is When you introduce a new term using @dfn, please provide a @cindex entry for that term. > +@example > +machine ldaps://directory.example.com binddn example\emacsuser password s3cr3t > +@end example This line is too long, and since lines in @example are never broken by the typesetter, it will overflow the right margin. Break it into 2 or more lines, and indicate in the text that this is one long line, to avoid confusion. > +@example > +binddn example\emacsuser password s3cr3t > +@end example > + > +and the @file{.emacs} expressions become: You need @noindent before the last line, otherwise it will be indented, as it starts a new paragraph. > +@lisp > +(eval-after-load "message" > + '(define-key message-mode-map (kbd "TAB") 'eudc-expand-inline)) > +(customize-set-variable 'eudc-server-hotlist '(("" . bbdb) ("" . ldap))) > +(customize-set-variable 'ldap-host-parameters-alist '(("" auth-source t))) > +@end lisp I think these lines are also too long, consider breaking them. Thanks.