Fix docs.

* doc/Makefile.am (check-ldaphome-config): Take into account
gray_env_get_bool (see 7636fa3e).
* doc/pam-modules.texi: Update; final check.
* NEWS: Update.

3 files changed, 78 insertions, 36 deletions

diff --git a/NEWS b/NEWS
index 1d0b2d9..fd74ce3 100644
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-pam-modules -- history of user-visible changes. 2014-05-20
+pam-modules -- history of user-visible changes. 2014-05-21
 Copyright (C) 2001, 2004-2005, 2007-2012, 2014 Sergey Poznyakoff
 See the end of file for copying conditions.
 
@@ -20,6 +20,21 @@ per-user customization of the files copied from the skeleton dir.
 The examples directory contains a perl program "usergitconfig", which,
 when used as inirc-command, initializes the user's .gitconfig file.
 
+* New auxiliary utilities
+
+** ldappubkey
+
+The `ldappubkey' utility is a simple Perl program which takes user
+login name as its argument and produces on the standard output public
+ssh keys for that user, each on a separate line.  The program is
+designed for use with `openssh' version 6.2p1 or higher.
+
+** usergitconfig
+
+Customizes user's `.gitconfig' file using attributes from his LDAP
+entry.  This utility can be used with the initrc-command statement
+in pam_ldaphome.conf file.
+
 * Bugfixes
 
 
diff --git a/doc/Makefile.am b/doc/Makefile.am
index e792390..5daae7a 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -103,7 +103,7 @@ check-sql-config:
 
 check-ldaphome-config:
         @$(CHECK_DOCS) 'pam_ldaphome configuration keywords' \
-           's/.*gray_env_get(.[^,]*, *"\(.[^"]*\)".*/\1/p;s/.*get_intval(.[^,]*, *"\(.[^"]*\)".*/\1/p' \
+           's/.*gray_env_get(.[^,]*, *"\(.[^"]*\)".*/\1/p;s/.*gray_env_get_bool(.[^,]*, *"\(.[^"]*\)".*/\1/p;s/.*get_intval(.[^,]*, *"\(.[^"]*\)".*/\1/p' \
            's/@deffn  *{pam_ldaphome config}  *\([a-zA-Z_][a-zA-Z0-9_-]*\) .*/\1/p' \
            $(top_srcdir)/pam_ldaphome/pam_ldaphome.c -- \
            $(MAKEINFO) $(AM_MAKEINFOFLAGS) $(MAKEINFOFLAGS) -I $(srcdir) -E - \
diff --git a/doc/pam-modules.texi b/doc/pam-modules.texi
index 8d9a1c8..506ec33 100644
--- a/doc/pam-modules.texi
+++ b/doc/pam-modules.texi
@@ -121,6 +121,25 @@ SQL Authentication and Session Management.
 * sql session:: Using @acronym{SQL} modules for session management.
 * sql summary:: Summary of configuration statements.
 
+pam_ldaphome
+
+* ldaphome example::
+* ldappubkey::
+* usergitconfig::
+
+Example of pam_ldaphome configuration
+
+* 5.x::         Openssh versions prior to 6.2p1.
+* 6.2p1::       Openssh versions 6.2p1 and newer.
+
+pam_umotd
+
+* summary of pam_umotd options::
+
+pam_groupmember
+
+* summary of pam_groupmember options::
+
 @end detailmenu
 @end menu
 
@@ -1164,20 +1183,20 @@ Actual module configuration is read from the configuration file, which
 has the same syntax as described in @ref{config, SQL configuration
 file}.  The following keywords are defined:
 
-@deffn {pam_ldaphome config} allow-home-dir path
+@deffn {pam_ldaphome config} allow-home-dir @var{path}
 If present, this option controls where @command{pam_ldaphome} should
 try to create home directories.  Its value is a list of directories
 separated by colons.  The user's home directory will be created only
 if the directory part of its name is listed in @var{path}.
 @end deffn
 
-@deffn {pam_ldaphome config} skel dir
+@deffn {pam_ldaphome config} skel @var{dir}
 Supplies the name of a @dfn{skeleton directory}.  The contents of this
 directory is copied to the newly created user home directory.  The
 file modes and permissions are preserved.
 @end deffn
 
-@deffn {pam_ldaphome config} uri arg
+@deffn {pam_ldaphome config} uri @var{arg}
 Sets the URI of the LDAP server to consult for the user profile.
 Example:
 
@@ -1186,12 +1205,12 @@ uri ldap://127.0.0.1/
 @end example
 @end deffn
 
-@deffn {pam_ldaphome config} ldap-version v
+@deffn {pam_ldaphome config} ldap-version @var{v}
 Sets the LDAP version to use.  Valid values for @var{v} are @samp{2}
 and @samp{3} (the default).
 @end deffn
 
-@deffn {pam_ldaphome config} base searchbase
+@deffn {pam_ldaphome config} base @var{searchbase}
 Use @var{searchbase} as the starting point for the search instead of
 the default, e.g.:
 
@@ -1200,7 +1219,7 @@ base dc=gnu,dc=org,dc=ua
 @end example
 @end deffn
 
-@deffn {pam_ldaphome config} binddn dn
+@deffn {pam_ldaphome config} binddn @var{dn}
 Use the Distinguished Name @var{dn} to bind to the LDAP directory.
 Example:
 
@@ -1209,16 +1228,16 @@ binddn cn=Manager,dc=gnu,dc=org,dc=ua
 @end example
 @end deffn
 
-@deffn {pam_ldaphome config} bindpw password
+@deffn {pam_ldaphome config} bindpw @var{password}
 If @code{binddn} statement is used, this statement supplies the
 password for simple authentication.
 @end deffn
 
-@deffn {pam_ldaphome config} bindpwfile file
+@deffn {pam_ldaphome config} bindpwfile @var{file}
 Read password for simple authentication from @var{file}.
 @end deffn
 
-@deffn {pam_ldaphome config} tls val
+@deffn {pam_ldaphome config} tls @var{val}
 Controls whether TLS is desired or required.  If @var{val} is
 @samp{no} (the default), TLS will not be used.  If it is @samp{yes},
 the module will issue the @samp{StartTLS} command, but will continue
@@ -1227,7 +1246,7 @@ mandatory, and the module will not establish LDAP connection unless
 @samp{StartTLS} succeeds.
 @end deffn
 
-@deffn {pam_ldaphome config} min-uid n
+@deffn {pam_ldaphome config} min-uid @var{n}
 Sets the minimal UID.  For users with UIDs less than @var{n},
 @command{pam_ldaphome} returns PAM_SUCCESS immediately.  This allows
 you to have a set of basic users whose credentials are kept in the
@@ -1236,45 +1255,45 @@ system database and who will not be disturbed by
 @samp{allow-groups}.
 @end deffn
 
-@deffn {pam_ldaphome config} min-gid n
+@deffn {pam_ldaphome config} min-gid @var{n}
 Sets the minimal GID.  For users with GIDs less than @var{n},
 @command{pam_ldaphome} returns PAM_SUCCESS immediately.
 @end deffn
 
-@deffn {pam_ldaphome config} allow-groups group [group...]
+@deffn {pam_ldaphome config} allow-groups @var{group} [@var{group}...]
 Only handle members of the listed groups.
 @end deffn
 
-@deffn {pam_ldaphome config} filter expr
+@deffn {pam_ldaphome config} filter @var{expr}
 Sets the LDAP filter expression to return a user profile.  The
 @var{expr} should conform to the string representation for search
 filters as defined in RFC 4515.
 @end deffn
 
-@deffn {pam_ldaphome config} import-public-keys bool
+@deffn {pam_ldaphome config} import-public-keys @var{bool}
 When set to @samp{no}, disables importing public keys from LDAP.  You
 may wish to use this option if you are using @command{openssh} 6.1 or
 later with @command{ldappubkey} as @samp{AuthorizedKeysCommand}.
 @end deffn
 
-@deffn {pam_ldaphome config} pubkey-attr text
+@deffn {pam_ldaphome config} pubkey-attr @var{text}
 Defines the name of the attribute which holds the user public key.
 @end deffn
 
-@deffn {pam_ldaphome config} copy-buf-size n
+@deffn {pam_ldaphome config} copy-buf-size @var{n}