diff --git a/doc/modsecurity2-apache-reference.xml b/doc/modsecurity2-apache-reference.xml
index 321ef877..5f75673f 100644
--- a/doc/modsecurity2-apache-reference.xml
+++ b/doc/modsecurity2-apache-reference.xml
@@ -855,17 +855,38 @@ SecAuditLogStorageDir logs/audit
Dependencies/Notes: The internal
chroot functionality provided by ModSecurity works great for simple
setups. One example of a simple setup is Apache serving static files
- only, or running scripts using modules. For more complex setups you
- should consider building a jail the old-fashioned way. The internal
- chroot feature should be treated as somewhat experimental. Due to the
- large number of default and third-party modules available for the Apache
- web server, it is not possible to verify the internal chroot works
- reliably with all of them. You are advised to think about your option
- and make your own decision. In particular, if you are using any of the
- modules that fork in the module initialisation phase (e.g. mod_fastcgi,
- mod_fcgid, mod_cgid), you are advised to examine each Apache process and
- observe its current working directory, process root, and the list of
- open files.
+ only, or running scripts using modules. Some problems you might
+ encounter with more complex setups:
+
+
+
+ DNS lookups do not work (this is because this feature requires
+ a shared library that is loaded on demand, after chroot takes
+ place).
+
+
+
+ You cannot send email from PHP because it uses sendmail and
+ sendmail is outside the jail.
+
+
+
+ In some cases Apache graceful no longer works.
+
+
+
+ You should be aware that the internal chroot feature might not be
+ 100% reliable. Due to the large number of default and third-party
+ modules available for the Apache web server, it is not possible to
+ verify the internal chroot works reliably with all of them. A module,
+ working from within Apache, can do things that make it easy to break out
+ of the jail. In particular, if you are using any of the modules that
+ fork in the module initialisation phase (e.g.
+ mod_fastcgi, mod_fcgid,
+ mod_cgid), you are advised to examine each Apache
+ process and observe its current working directory, process root, and the
+ list of open files. Consider what your options are and make your own
+ decision.