From 460d3eafe911eb9e0e7e58d5b74de875661f8583 Mon Sep 17 00:00:00 2001
From: Alain Reguera Delgado <alain.reguera@gmail.com>
Date: Jun 16 2011 04:08:27 +0000
Subject: Update repository user's guide.


    - Add Identity, Localization, Documentation and Automation as main
      parts of repository user's guide. These parts reflect the
      repository top level directory structure.

    - Fix history.docbook.

    - Update repository.docbook.


---

diff --git a/Manuals/Userguide/Identity.docbook b/Manuals/Userguide/Identity.docbook
new file mode 100644
index 0000000..a592006
--- /dev/null
+++ b/Manuals/Userguide/Identity.docbook
@@ -0,0 +1,20 @@
+<part>
+
+    <title>Identity</title>
+
+    <partintro>
+        <para>...</para>
+    </partintro>
+
+    <chapter>
+            <title>...</title>
+            <para>...</para>
+
+        <sect1>
+            <title>...</title>
+            <para>...</para>
+        </sect1>
+
+    </chapter>
+
+</part>
diff --git a/Manuals/Userguide/Identity.ent b/Manuals/Userguide/Identity.ent
new file mode 100644
index 0000000..7be8037
--- /dev/null
+++ b/Manuals/Userguide/Identity.ent
@@ -0,0 +1 @@
+<!ENTITY identity   SYSTEM "Identity.docbook">
diff --git a/Manuals/Userguide/Introduction/history.docbook b/Manuals/Userguide/Introduction/history.docbook
index 8bdef8e..ed9669e 100644
--- a/Manuals/Userguide/Introduction/history.docbook
+++ b/Manuals/Userguide/Introduction/history.docbook
@@ -208,17 +208,23 @@
     </para> 
 
     <para>
-        Redesign <code>help</code> functionality to start using
-        DocBook XML as default documentation backend. Produciing
-        documentation through DocBook XML as default documentation
-        backend consolidates <code>render</code> and
-        <code>locale</code> even more. In this configuration, once the
-        DocBook files are written, we use <code>locale</code>
+        To build DocBook documentation, it was considered the idea of
+        using concepts behind repository directory structure as base,
+        not the opposite (as I've been doing with Texinfo backend, so
+        far).
+    </para>
+
+    <para>
+        Producing documentation through DocBook XML as default
+        documentation backend consolidates <code>render</code> and
+        <code>locale</code> even more.  In this configuration, once
+        the DocBook files are written, we use <code>locale</code>
         functionality to localize the DocBook files in your prefered
         language and later, using <code>render</code> functionality,
-        we produce the XTHML and PDF outputs as specified in the
-        XSLT customization driver we defined.
+        we produce the XTHML and PDF outputs as specified in the XSLT
+        customization driver we can define.
     </para>
+
     </sect1>
 
 </chapter>
diff --git a/Manuals/Userguide/Locales.docbook b/Manuals/Userguide/Locales.docbook
new file mode 100644
index 0000000..fd17f6b
--- /dev/null
+++ b/Manuals/Userguide/Locales.docbook
@@ -0,0 +1,21 @@
+<part>
+
+    <title>Localization</title>
+
+    <partintro>
+        <para>...</para>
+    </partintro>
+
+    <chapter>
+            <title>...</title>
+            <para>...</para>
+
+        <sect1>
+            <title>...</title>
+            <para>...</para>
+        </sect1>
+
+    </chapter>
+
+</part>
+
diff --git a/Manuals/Userguide/Locales.ent b/Manuals/Userguide/Locales.ent
new file mode 100644
index 0000000..48245e8
--- /dev/null
+++ b/Manuals/Userguide/Locales.ent
@@ -0,0 +1,2 @@
+<!ENTITY locales    SYSTEM "Locales.docbook">
+
diff --git a/Manuals/Userguide/Manuals.docbook b/Manuals/Userguide/Manuals.docbook
new file mode 100644
index 0000000..e8d1b16
--- /dev/null
+++ b/Manuals/Userguide/Manuals.docbook
@@ -0,0 +1,21 @@
+<part>
+
+    <title>Documentation</title>
+
+    <partintro>
+        <para>...</para>
+    </partintro>
+
+    <chapter>
+            <title>...</title>
+            <para>...</para>
+
+        <sect1>
+            <title>...</title>
+            <para>...</para>
+        </sect1>
+
+    </chapter>
+
+</part>
+
diff --git a/Manuals/Userguide/Manuals.ent b/Manuals/Userguide/Manuals.ent
new file mode 100644
index 0000000..c1569ac
--- /dev/null
+++ b/Manuals/Userguide/Manuals.ent
@@ -0,0 +1 @@
+<!ENTITY manuals    SYSTEM "Manuals.docbook">
diff --git a/Manuals/Userguide/Scripts.docbook b/Manuals/Userguide/Scripts.docbook
new file mode 100644
index 0000000..f80f2c6
--- /dev/null
+++ b/Manuals/Userguide/Scripts.docbook
@@ -0,0 +1,21 @@
+<part>
+
+    <title>Automation</title>
+
+    <partintro>
+        <para>...</para>
+    </partintro>
+
+    <chapter>
+            <title>...</title>
+            <para>...</para>
+
+        <sect1>
+            <title>...</title>
+            <para>...</para>
+        </sect1>
+
+    </chapter>
+
+</part>
+
diff --git a/Manuals/Userguide/Scripts.ent b/Manuals/Userguide/Scripts.ent
new file mode 100644
index 0000000..fb2149b
--- /dev/null
+++ b/Manuals/Userguide/Scripts.ent
@@ -0,0 +1 @@
+<!ENTITY scripts    SYSTEM "Scripts.docbook">
diff --git a/Manuals/Userguide/repository.docbook b/Manuals/Userguide/repository.docbook
index 32f233b..93e5587 100644
--- a/Manuals/Userguide/repository.docbook
+++ b/Manuals/Userguide/repository.docbook
@@ -4,11 +4,17 @@
                [
 
 <!ENTITY % Introduction.ent     SYSTEM "Introduction.ent">
-<!ENTITY % Directories.ent      SYSTEM "Directories.ent">
+<!ENTITY % Identity.ent         SYSTEM "Identity.ent">
+<!ENTITY % Locales.ent          SYSTEM "Locales.ent">
+<!ENTITY % Manuals.ent          SYSTEM "Manuals.ent">
+<!ENTITY % Scripts.ent          SYSTEM "Scripts.ent">
 <!ENTITY % Licenses.ent         SYSTEM "Licenses.ent">
 
 %Introduction.ent;
-%Directories.ent;
+%Identity.ent;
+%Locales.ent;
+%Manuals.ent;
+%Scripts.ent;
 %Licenses.ent;
 ]>
 
@@ -63,7 +69,10 @@
 
     <!-- Main matter -->
     &intro;
-    &dir;
+    &identity;
+    &locales;
+    &manuals;
+    &scripts;
     &licenses;
 
 </book>