diff --git a/forrest.properties b/forrest.properties
index ce97bb0..41b9f46 100644
--- a/forrest.properties
+++ b/forrest.properties
@@ -17,6 +17,10 @@
 # layout properties
 
 # Properties that must be set to override the default locations
+#
+# Parent properties must be set. This usually means uncommenting
+# project.content-dir if any other property using it is uncommented
+
 #project.status=status.xml
 #project.content-dir=src/documentation
 #project.conf-dir=${project.content-dir}/conf
@@ -31,6 +35,16 @@
 #project.classes-dir=${project.content-dir}/classes
 
 
+##############
+# Cocoon catalog entity resolver properties
+
+# A local catalog to supplement the default Forrest catalog
+#project.catalog=${project.schema-dir}/catalog
+
+# The verbosity level for the entity resolver (1..10)
+#forrest.catalog.verbosity=1
+
+
 ##############
 # validation properties
 
@@ -57,7 +71,7 @@
 #
 #forrest.validate.xdocs.failonerror=${forrest.validate.failonerror}
 #
-#forrest.validate.xdocs.includes=*.x*
+#forrest.validate.xdocs.includes=**/*.x*
 #forrest.validate.xdocs.excludes=
 #
 #forrest.validate.skinconf.includes=${skinconf-file}