diff --git a/conf/type/__directory/man.text b/conf/type/__directory/man.text
index 3f005b55..1f4def7d 100644
--- a/conf/type/__directory/man.text
+++ b/conf/type/__directory/man.text
@@ -33,8 +33,8 @@ owner::
    User to chown to.
 
 
-OPTIONAL BOOLEAN PARAMETERS
----------------------------
+BOOLEAN PARAMETERS
+------------------
 parents::
    Whether to create parents as well (mkdir -p behaviour)
 
@@ -42,6 +42,7 @@ recursive::
    If supplied the chgrp and chown call will run recursively.
    This does *not* influence the behaviour of chmod.
 
+
 EXAMPLES
 --------
 
@@ -56,13 +57,18 @@ __directory /tmp/foobar --state absent
 __directory /etc --owner root --group root --mode 0755
 
 # Create nfs service directory, including parents
-__directory /home/services/nfs --parents yes
+__directory /home/services/nfs --parents
 
 # Change permissions recursively
-__directory /home/services --recursive yes --owner root --group root
+__directory /home/services --recursive --owner root --group root
 
 # Setup a temp directory
 __directory /local --mode 1777
+
+# Take it all
+__directory /home/services/kvm --recursive --parents \
+    --owner root --group root --mode 0755 --state present
+
 --------------------------------------------------------------------------------