fix and clarify usage details

diff --git a/doc/man/man5/slapo-chain.5 b/doc/man/man5/slapo-chain.5
index 9eb0296c68576c4c474506c8e33e1541d3f32c51..6981fe10bdc645f3f529c1aff45fa91d70b2892a 100644 (file)
--- a/doc/man/man5/slapo-chain.5
+++ b/doc/man/man5/slapo-chain.5
@@ -81,13 +81,16 @@ If the \fBcritical\fP flag affects the control criticality if provided.
 .TP
 .B chain-max-depth <n>
 In case a referral is returned during referral chasing, further chasing
-occurs at most \fB<n>\fP levels.  Set to \fB0\fP to disable further 
-referral chasing.
+occurs at most \fB<n>\fP levels deep.  Set to \fB1\fP (the default) 
+to disable further referral chasing.
 .TP
 .B chain-return-error {FALSE|true}
 In case referral chasing fails, the real error is returned instead
 of the original referral.  In case multiple referral URIs are present,
-only the first error is returned.
+only the first error is returned.  This behavior may not be always
+appropriate nor desirable, since failures in referral chasing might be
+better resolved by the client (e.g. when caused by distributed 
+authentication issues).
 .TP
 .B chain-uri <ldapuri>
 This directive instantiates a new underlying \fIldap\fP database