From 93306116c59cdabe374adcc7b3f9d084c5059242 Mon Sep 17 00:00:00 2001
From: Alain Reguera Delgado <alain.reguera@gmail.com>
Date: Jun 25 2011 02:39:25 +0000
Subject: Update The CentOS Artwork Repository User's Guide (tcar-ug) in docbook

format.


---

diff --git a/Manuals/TCAR-UG/Docbook/Commons.ent b/Manuals/TCAR-UG/Docbook/Commons.ent
index f42fa3b..1c9682f 100644
--- a/Manuals/TCAR-UG/Docbook/Commons.ent
+++ b/Manuals/TCAR-UG/Docbook/Commons.ent
@@ -6,8 +6,6 @@
     their maintainance easier to realize.
 -->
 
-<!ENTITY COPYRIGHT "Copyright &copy; 2009, 2010, 2011 &TCAS;">
-
 <!-- About Corporate Identity -->
 
 <!ENTITY CI         "Corporate Identity">
diff --git a/Manuals/TCAR-UG/Docbook/Introduction.docbook b/Manuals/TCAR-UG/Docbook/Introduction.docbook
index e6e0f1c..d95bcfa 100644
--- a/Manuals/TCAR-UG/Docbook/Introduction.docbook
+++ b/Manuals/TCAR-UG/Docbook/Introduction.docbook
@@ -7,10 +7,64 @@
     </para>
 
     <para>
-        &TCARUG; describes how &TCPCVI; is organized and produced
-        inside &TCAR;.  If you are looking for a comprehensive,
-        task-oriented guide for understanding how &TCPCI; is produced,
-        this is the manual for you.
+        &TCAR; User's Guide describes how &TCPCVI; is organized and
+        produced inside &TCAR;.  If you are looking for a
+        comprehensive, task-oriented guide for understanding how
+        &TCPCI; is produced, this is the manual for you.
+    </para>
+
+    <para>
+
+        This manual is divided into the following main parts:
+
+    <itemizedlist>
+    <listitem>
+    <para>
+        <xref linkend="repo" /> &mdash; This part describes what
+        &TCAR; is, how it is organized, the things you can achieve
+        inside it and how you can do such things.
+    </para>
+    </listitem>
+
+    <listitem>
+    <para>
+        <xref linkend="identity" /> &mdash; This part describes &TCP;
+        as organization. Here we dig in the ground and climb up to the
+        sky, looking for the roots, flowers and thorns &TCP; is made
+        of.
+    </para>
+    </listitem>
+
+    <listitem>
+    <para>
+        <xref linkend="l10n" /> &mdash; This part describes how to
+        produce localized content inside the repository.
+    </para>
+    </listitem>
+
+    <listitem>
+    <para>
+        <xref linkend="doc" /> &mdash; This part describes how to
+        produce and maintain documentation inside the repository.
+    </para>
+    </listitem>
+
+    <listitem>
+    <para>
+        <xref linkend="scripts" /> &mdash; This part describes how
+        automation scripts are implemented and used inside the
+        repository.
+    </para>
+    </listitem>
+
+    <listitem>
+    <para>
+        <xref linkend="licenses" /> &mdash; This part contains the
+        licenses refered in this manual.  </para>
+    </listitem>
+
+    </itemizedlist>
+
     </para>
 
     <para>
diff --git a/Manuals/TCAR-UG/Docbook/Licenses.docbook b/Manuals/TCAR-UG/Docbook/Licenses.docbook
index 2b72b81..dfc86ce 100644
--- a/Manuals/TCAR-UG/Docbook/Licenses.docbook
+++ b/Manuals/TCAR-UG/Docbook/Licenses.docbook
@@ -1,4 +1,4 @@
-<part>
+<part id="licenses">
     <title>Licenses</title>
     &licenses-gpl;
     &licenses-gfdl;
diff --git a/Manuals/TCAR-UG/Docbook/Locales.docbook b/Manuals/TCAR-UG/Docbook/Locales.docbook
index fd17f6b..f33f6e9 100644
--- a/Manuals/TCAR-UG/Docbook/Locales.docbook
+++ b/Manuals/TCAR-UG/Docbook/Locales.docbook
@@ -1,4 +1,4 @@
-<part>
+<part id="l10n">
 
     <title>Localization</title>
 
diff --git a/Manuals/TCAR-UG/Docbook/Manuals.docbook b/Manuals/TCAR-UG/Docbook/Manuals.docbook
index 3f0f888..80d9424 100644
--- a/Manuals/TCAR-UG/Docbook/Manuals.docbook
+++ b/Manuals/TCAR-UG/Docbook/Manuals.docbook
@@ -1,4 +1,4 @@
-<part id="manuals">
+<part id="doc">
 
     <title>Documentation</title>
 
diff --git a/Manuals/TCAR-UG/Docbook/Manuals/Docbook.docbook b/Manuals/TCAR-UG/Docbook/Manuals/Docbook.docbook
index 671428c..24c369a 100644
--- a/Manuals/TCAR-UG/Docbook/Manuals/Docbook.docbook
+++ b/Manuals/TCAR-UG/Docbook/Manuals/Docbook.docbook
@@ -1,4 +1,4 @@
-<chapter id="manuals-docbook">
+<chapter id="doc-docbook">
 
     <title>DocBook Backend</title>
 
diff --git a/Manuals/TCAR-UG/Docbook/Manuals/Docbook/intro.docbook b/Manuals/TCAR-UG/Docbook/Manuals/Docbook/intro.docbook
index ce80f3c..4645113 100644
--- a/Manuals/TCAR-UG/Docbook/Manuals/Docbook/intro.docbook
+++ b/Manuals/TCAR-UG/Docbook/Manuals/Docbook/intro.docbook
@@ -1,4 +1,4 @@
-<sect1 id="manuals-docbook-intro">
+<sect1 id="doc-docbook-intro">
 
     <title>Introduction</title>
 
diff --git a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo.docbook b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo.docbook
index b3702b3..3f0523f 100644
--- a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo.docbook
+++ b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo.docbook
@@ -1,4 +1,4 @@
-<chapter id="manuals-texinfo">
+<chapter id="doc-texinfo">
 
     <title>Texinfo Backend</title>
 
diff --git a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/encoding.docbook b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/encoding.docbook
index 3d72a9b..a9ac2a7 100644
--- a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/encoding.docbook
+++ b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/encoding.docbook
@@ -1,4 +1,4 @@
-<sect1 id="manuals-texinfo-encoding">
+<sect1 id="doc-texinfo-encoding">
     <title>Document Encoding</title>
     <para>...</para>
 </sect1>
diff --git a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/intro.docbook b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/intro.docbook
index 857d75e..f9c99b0 100644
--- a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/intro.docbook
+++ b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/intro.docbook
@@ -1,4 +1,4 @@
-<sect1 id="manuals-texinfo-intro">
+<sect1 id="doc-texinfo-intro">
 
     <title>Introduction</title>
 
diff --git a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/localizing.docbook b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/localizing.docbook
index 871f277..0661a4c 100644
--- a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/localizing.docbook
+++ b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/localizing.docbook
@@ -1,4 +1,4 @@
-<sect1 id="manuals-texinfo-l10n">
+<sect1 id="doc-texinfo-l10n">
     <title>Document Localization</title>
     <para>...</para>
 </sect1>
diff --git a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/structure.docbook b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/structure.docbook
index 7527e4b..7fc3abf 100644
--- a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/structure.docbook
+++ b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/structure.docbook
@@ -1,4 +1,4 @@
-<sect1 id="manuals-texinfo-structure">
+<sect1 id="doc-texinfo-structure">
 
     <title>Document Structure</title>
 
@@ -94,11 +94,11 @@
         there are documentation entries to store the document's content
         itself, using arbitrary file names prefixed with the <filename
         class="extension">texinfo</filename> extension, just as it is
-        illustrated in <xref linkend="manuals-texinfo-structure-eg1"
+        illustrated in <xref linkend="doc-texinfo-structure-eg1"
         />.
     </para>
 
-    <example id="manuals-texinfo-structure-eg1">
+    <example id="doc-texinfo-structure-eg1">
     <title>Texinfo backend's document structure.</title>
     <screenshot>
     <screeninfo>Texinfo backend's document structure.</screeninfo>
diff --git a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/templates.docbook b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/templates.docbook
index 0ba3d41..e459647 100644
--- a/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/templates.docbook
+++ b/Manuals/TCAR-UG/Docbook/Manuals/Texinfo/templates.docbook
@@ -1,4 +1,4 @@
-<sect1 id="manuals-texinfo-templates">
+<sect1 id="doc-texinfo-templates">
     <title>Document Templates</title>
     <para>...</para>
 </sect1>
diff --git a/Manuals/TCAR-UG/Docbook/Repository/Copying.docbook b/Manuals/TCAR-UG/Docbook/Repository/Copying.docbook
index 23653a1..b84487a 100644
--- a/Manuals/TCAR-UG/Docbook/Repository/Copying.docbook
+++ b/Manuals/TCAR-UG/Docbook/Repository/Copying.docbook
@@ -3,10 +3,6 @@
     <title>Copying Conditions</title>
     
     <para>
-        &COPYRIGHT;
-    </para>
-
-    <para>
         &TCAS; uses &TCAR; to implement &TCPCVI;. The implementation
         itself is controlled by the <command>centos-art.sh</command>
         script.
diff --git a/Manuals/TCAR-UG/Docbook/Scripts/Bash/help.docbook b/Manuals/TCAR-UG/Docbook/Scripts/Bash/help.docbook
index cbef852..531b199 100644
--- a/Manuals/TCAR-UG/Docbook/Scripts/Bash/help.docbook
+++ b/Manuals/TCAR-UG/Docbook/Scripts/Bash/help.docbook
@@ -9,7 +9,7 @@
         update output files, etc.) requied by specific documentation
         backends.  Documentation backends supported by
         <function>help</function> functionality are described in <xref
-        linkend="manuals"/>.
+        linkend="doc"/>.
     </para>
 
     <simplesect>