diff --git a/reference/dir/functions/chroot.xml b/reference/dir/functions/chroot.xml
index 207bc8d6a9..019c0f0969 100644
--- a/reference/dir/functions/chroot.xml
+++ b/reference/dir/functions/chroot.xml
@@ -15,11 +15,12 @@
   </methodsynopsis>
   <para>
    Changes the root directory of the current process to
-   <parameter>directory</parameter>.
+   <parameter>directory</parameter>, and changes the current
+   working directory to "/".
   </para>
   <para>
-   This function is only available if your system supports it and
-   you're using the CLI, CGI or Embed SAPI. Also, this function
+   This function is only available to GNU and BSD systems, and
+   only when using the CLI, CGI or Embed SAPI. Also, this function
    requires root privileges.
   </para>
  </refsect1>
@@ -32,7 +33,7 @@
      <term><parameter>directory</parameter></term>
      <listitem>
       <para>
-       The new directory
+       The path to change the root directory to.
       </para>
      </listitem>
     </varlistentry>
@@ -47,6 +48,28 @@
   </para> 
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example><title></title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+chroot("/path/to/your/chroot/");
+echo getcwd();
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+/
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
  <refsect1 role="notes">
   &reftitle.notes;
   &note.no-windows;