add an example of -a usage (ITS#3930)

diff --git a/doc/man/man8/slapcat.8 b/doc/man/man8/slapcat.8
index 1609dbf8214c7825a061b3a38d7c09c635f04b85..d6eb2ff77f4f6b50fad9260b0676703e28b8f51e 100644 (file)
--- a/doc/man/man8/slapcat.8
+++ b/doc/man/man8/slapcat.8
@@ -62,7 +62,14 @@ cannot be used in conjunction with the
 option.
 .TP
 .BI \-a " filter"
-Only dump entries matching the asserted filter.  
+Only dump entries matching the asserted filter.
+For example
+
+slapcat -a \\
+    "(!(entryDN:dnSubtreeMatch:=ou=People,dc=example,dc=com))"
+
+will dump all but the "ou=People,dc=example,dc=com" subtree
+of the "dc=example,dc=com" database.
 .TP
 .BI \-s " subtree-dn"
 Only dump entries in the subtree specified by this DN.