diff --git a/reference/crack/book.xml b/reference/crack/book.xml
new file mode 100644
index 0000000000..834121daf1
--- /dev/null
+++ b/reference/crack/book.xml
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.2 $ -->
+<!-- Purpose: mathcrypto.crypto -->
+<!-- Membership: pecl, external -->
+ 
+<book xml:id="book.crack" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Crack</title>
+ 
+ <!-- {{{ preface -->
+ <preface xml:id="intro.crack">
+  &reftitle.intro;
+  <para>
+   These functions allow you to use the CrackLib library to test the
+   'strength' of a password.  The 'strength' of a password is tested by that
+   checks length, use of upper and lower case and checked against the
+   specified CrackLib dictionary.  CrackLib will also give helpful diagnostic
+   messages that will help 'strengthen' the password.
+  </para>
+  <note>
+   <para>
+    &pecl.moved-ver;5.0.0.
+   </para>
+  </note>
+ </preface>
+ <!-- }}} -->
+ 
+ &reference.crack.setup;
+ &reference.crack.constants;
+ &reference.crack.examples;
+ &reference.crack.reference;
+
+</book>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
diff --git a/reference/crack/constants.xml b/reference/crack/constants.xml
new file mode 100644
index 0000000000..c978c494d4
--- /dev/null
+++ b/reference/crack/constants.xml
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.2 $ -->
+
+<appendix xml:id="crack.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.constants;
+ &no.constants;
+</appendix>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
diff --git a/reference/crack/examples.xml b/reference/crack/examples.xml
new file mode 100644
index 0000000000..1537871258
--- /dev/null
+++ b/reference/crack/examples.xml
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.2 $ -->
+
+<appendix xml:id="crack.examples">
+ &reftitle.examples;
+ <para>
+  This example shows how to open a CrackLib dictionary, test a given
+  password, retrieve any diagnostic messages, and close the dictionary.
+  <example>
+   <title>CrackLib example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Open CrackLib Dictionary
+$dictionary = crack_opendict('/usr/local/lib/pw_dict')
+     or die('Unable to open CrackLib dictionary');
+
+// Perform password check
+$check = crack_check($dictionary, 'gx9A2s0x');
+
+// Retrieve messages
+$diag = crack_getlastmessage();
+echo $diag; // 'strong password'
+
+// Close dictionary
+crack_closedict($dictionary);
+?>
+]]>
+    </programlisting>
+  </example>
+ </para>
+ <note>
+  <para>
+   If <function>crack_check</function> returns &true;,
+   <function>crack_getlastmessage</function> will return 'strong password'.
+  </para>
+ </note>
+</appendix>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
diff --git a/reference/crack/ini.xml b/reference/crack/ini.xml
index 3e0fe5c523..ed7c5a7a1c 100644
--- a/reference/crack/ini.xml
+++ b/reference/crack/ini.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <section xml:id="crack.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
  &extension.runtime;
diff --git a/reference/crack/reference.xml b/reference/crack/reference.xml
index 5f50875200..6024dff643 100644
--- a/reference/crack/reference.xml
+++ b/reference/crack/reference.xml
@@ -1,94 +1,13 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.14 $ -->
-<!-- Purpose: mathcrypto.crypto -->
-<!-- Membership: pecl, external -->
+<!-- $Revision: 1.15 $ -->
 
- <reference xml:id="ref.crack" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
-  <title>Crack Functions</title>
-  <titleabbrev>Crack</titleabbrev>
+<reference xml:id="ref.crack" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Crack &Functions;</title>
 
-  <partintro>
-   <section xml:id="crack.intro">
-    &reftitle.intro;
-    <para>
-     These functions allow you to use the CrackLib library to test the
-     'strength' of a password.  The 'strength' of a password is tested by that
-     checks length, use of upper and lower case and checked against the
-     specified CrackLib dictionary.  CrackLib will also give helpful diagnostic
-     messages that will help 'strengthen' the password.
-    </para>
-    <note>
-     <para>
-      &pecl.moved-ver;5.0.0.
-     </para>
-    </note>
-   </section>
+ &reference.crack.entities.functions;
 
-   <section xml:id="crack.requirements">
-    &reftitle.required;
-    <para>
-     More information regarding CrackLib along with the library can be found at
-     <link xlink:href="&url.crack;">&url.crack;</link>.
-    </para>
-   </section>
-    
-   &reference.crack.configure;
+</reference>
 
-   &reference.crack.ini;
-
-   <section xml:id="crack.resources">
-    &reftitle.resources;
-    <para>
-     The CrackLib extension defines a dictionary resource identifier returned
-     by <function>crack_opendict</function>.
-    </para>
-   </section>
-
-   <section xml:id="crack.constants">
-    &reftitle.constants;
-    &no.constants;
-   </section>
-
-   <section xml:id="crack.examples">
-    &reftitle.examples;
-    <para>
-     This example shows how to open a CrackLib dictionary, test a given
-     password, retrieve any diagnostic messages, and close the dictionary.
-     <example>
-      <title>CrackLib example</title>
-       <programlisting role="php">
-<![CDATA[
-<?php
-// Open CrackLib Dictionary
-$dictionary = crack_opendict('/usr/local/lib/pw_dict')
-     or die('Unable to open CrackLib dictionary');
-
-// Perform password check
-$check = crack_check($dictionary, 'gx9A2s0x');
-
-// Retrieve messages
-$diag = crack_getlastmessage();
-echo $diag; // 'strong password'
-
-// Close dictionary
-crack_closedict($dictionary);
-?>
-]]>
-       </programlisting>
-     </example>
-    </para>
-    <note>
-     <para>
-      If <function>crack_check</function> returns &true;,
-      <function>crack_getlastmessage</function> will return 'strong password'.
-     </para>
-    </note>
-   </section>
-  </partintro>
-
-&reference.crack.entities.functions;
-
- </reference>
  <!-- Keep this comment at the end of the file
  Local variables:
  mode: sgml
diff --git a/reference/crack/setup.xml b/reference/crack/setup.xml
new file mode 100644
index 0000000000..a946fc5a02
--- /dev/null
+++ b/reference/crack/setup.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.2 $ -->
+
+<chapter xml:id="crack.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.setup;
+
+ <!-- {{{ Requirements -->
+ <section xml:id="crack.requirements">
+  &reftitle.required;
+  <para>
+   More information regarding CrackLib along with the library can be found at
+   <link xlink:href="&url.crack;">&url.crack;</link>.
+  </para>
+ </section>
+ <!-- }}} -->
+
+ <!-- {{{ Installation -->
+ &reference.crack.configure;
+ <!-- }}} -->
+
+ <!-- {{{ Configuration -->
+ &reference.crack.ini;
+ <!-- }}} -->
+
+ <!-- {{{ Resources -->
+ <section xml:id="crack.resources">
+  &reftitle.resources;
+  <para>
+   The CrackLib extension defines a dictionary resource identifier returned
+   by <function>crack_opendict</function>.
+  </para>
+ </section>
+ <!-- }}} -->
+
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+