misc man page updates

doc/man/man5/slapd-dnssrv.5

@@ -11,6 +11,8 @@ The DNSSRV backend to
 .BR slapd (8)
 serves up referrals based upon SRV resource records held in
 the Domain Name System.
+.LP
+This backend is experimental.
 .SH CONFIGURATION
 The DNSSRV backend has no backend nor database specific options.
 It is configured simply by "database dnssrv" followed a suffix

doc/man/man5/slapd-ldap.5

@@ -37,7 +37,14 @@ modification should not be used, as they could be passed to the target
 servers, generating an error.
 .TP
 .B uri <ldapurl>
-LDAP server to use.
+LDAP server to use.  Multiple URIs can be set in in a single
+.B ldapurl
+argument, resulting in the underlying library automatically 
+call the first server of the list that responds, e.g. 
+
+\fBuri "ldap://host/ ldap://backup-host"\fP
+
+The URI list is space- or comma-separated.
 .TP
 .B server <hostport>
 Obsolete option; same as `uri ldap://<hostport>/'.

doc/man/man5/slapd-meta.5

@@ -115,6 +115,10 @@ uri    "ldap://x.foo.com/dc=x,\fBdc=foo,dc=com\fP"
 .LP
 The <naming context> part doesn't need to be unique across the targets;
 it may also match one of the values of the "suffix" directive.
+Multiple URIs may be defined in a single argument.  The URIs must
+be separated by TABs (e.g. '\\t'), and the additional URIs must have
+no <naming context> part.  This causes the underlying library
+to contact the first server of the list that responds.
 .TP
 .B default-target [<target>]
 The "default-target" directive can also be used during target specification.
@@ -135,6 +139,10 @@ check permissions.
 This directive sets the password for acl checking in conjunction
 with the above mentioned "binddn" directive.
 .TP
+.B rebind-as-user
+If this option is given, the client's bind credentials are remembered
+for rebinds when chasing referrals.
+.TP
 .B pseudorootdn "<substitute DN in case of rootdn bind>"
 This directive, if present, sets the DN that will be substituted to
 the bind DN if a bind with the backend's "rootdn" succeeds.

doc/man/man5/slapd-passwd.5

@@ -11,7 +11,7 @@ The PASSWD backend to
 .BR slapd (8)
 serves up the user account information listed in the system
 .BR passwd (5)
-file.
+file.  This backend is provided for demonstration purposes only.
 The DN of each entry is "uid=<username>,<suffix>".
 Note that non-base searches scan the the entire passwd file, and
 are best suited for hosts with small passwd files.

doc/man/man5/slapd-shell.5

@@ -13,6 +13,8 @@ executes external programs to implement operations, and is designed to
 make it easy to tie an existing database to the
 .B slapd
 front-end.
+.LP
+This backend is is primarily intended to be used in prototypes.
 .SH WARNING
 .B "This backend's calling conventions have changed since OpenLDAP 2.0."
 The abandon operation now gets a new "pid:" line.

doc/man/man5/slapd-sql.5

@@ -40,6 +40,8 @@ Also, it uses ODBC to connect to RDBMSes, and is highly configurable
 for SQL dialects RDBMSes may use, so it may be used for integration
 and distribution of data on different RDBMSes, OSes, hosts etc., in
 other words, in highly heterogeneous environment.
+.LP
+This backend is experimental.
 .SH CONFIGURATION
 These
 .B slapd.conf

doc/man/man5/slapd-tcl.5

@@ -14,6 +14,8 @@ interpreter into
 Any tcl database section of the configuration file
 .BR slapd.conf (5)
 must then specify what Tcl script to use.
+.LP
+This backend is experimental.
 .SH WARNING
 .B "This backend's calling conventions have changed since OpenLDAP 2.0."
 Previously, the 2nd argument to the procs was a message ID.

doc/man/man5/slapd.access.5

@@ -94,7 +94,7 @@ for an exact match of the entry,
 .B one
 to indicate all the entries immediately below the
 .BR pattern ,
-.B sub
+.B subtree
 to indicate all the subentries of an entry including the entry itself,
 .B children
 to indicate all the subentries of an entry not including the entry itself.
@@ -102,7 +102,7 @@ Note that
 .B dn=".*"
 is equivalent to
 .BR * .
-The regex form of the pattern does not support UTF-8 (7) yet.
+The regex form of the pattern does not support UTF-8 yet.
 .LP
 The statement
 .B filter=<ldapfilter>