From b6bc438fa1fc2dfc20b04845eb85f7da986e62b8 Mon Sep 17 00:00:00 2001
From: Alain Reguera Delgado <alain.reguera@gmail.com>
Date: Oct 08 2012 03:52:42 +0000
Subject: Update `Scripts/Bash/tuneup.docbook' file.


---

diff --git a/Documentation/Models/Docbook/Tcar-ug/Scripts/Bash/tuneup.docbook b/Documentation/Models/Docbook/Tcar-ug/Scripts/Bash/tuneup.docbook
index c4fcc6b..7dac645 100644
--- a/Documentation/Models/Docbook/Tcar-ug/Scripts/Bash/tuneup.docbook
+++ b/Documentation/Models/Docbook/Tcar-ug/Scripts/Bash/tuneup.docbook
@@ -1,19 +1,18 @@
-<section id="scripts-bash-tuneup">
+<refentry id="scripts-bash-tuneup">
 
-    <title>Standardizing Maintainance Tasks</title>
+    <refmeta>
+        <refentrytitle>tuneup</refentrytitle>
+        <indexterm type="specific-function">
+            <primary>Standardize maintainance tasks inside &TCAR;</primary>
+        </indexterm>
+    </refmeta>
 
-    <para>
-        The <function>tuneup</function> functionality is the
-        interface the <command>centos-art.sh</command> script provides
-        to standardize the maintainance tasks related to individual
-        files inside the working copy.
-    </para>
-
-    <simplesect id="scripts-bash-tuneup-syntax">
-    <title>Syntax</title>
-
-    <screen>centos-art tuneup [OPTIONS] [DIRECTORY]</screen>
+    <refnamediv>
+        <refname>tuneup</refname>
+        <refpurpose>Standardize maintainance tasks inside &TCAR;</refpurpose>
+    </refnamediv>
 
+    <refsynopsisdiv>
     <para>
         The <varname>DIRECTORY</varname> parameter specifies the
         directory path, inside the working copy of &TCAR;, where the
@@ -23,67 +22,9 @@
         parameter is not provided, the current directory path where
         the command was called from is used instead.
     </para>
-    </simplesect>
-
-    <simplesect id="scripts-bash-tuneup-options">
-    <title>Options</title>
-    <para>
-        The <function>tuneup</function> functionality accepts the
-        following options: 
-    </para>
-
-    <variablelist>
-    <varlistentry>
-    <term><option>--quiet</option></term>
-    <listitem>
-    <para>
-        Supress all output messages except error messages.  When this
-        option is passed, all confirmation requests are supressed and
-        a possitive answer is assumed for them, just as if the
-        <option>--answer-yes</option> option would have been provided.
-    </para>
-    </listitem>
-    </varlistentry>
-
-    <varlistentry>
-    <term><option>--answer-yes</option></term>
-    <listitem>
-    <para>
-       Assume <emphasis>yes</emphasis> to all confirmation requests.
-    </para>
-    </listitem>
-    </varlistentry>
-
-    <varlistentry>
-    <term><option>--filter="REGEX"</option></term>
-    <listitem>
-    <para>
-        Reduce the list of files to process inside
-        <replaceable>path/to/dir</replaceable> using
-        <replaceable>REGEX</replaceable> as pattern.  You can use this
-        option to control the amount of files you want to tuneup.  The
-        deeper you go into the directory structure the more specific
-        you'll be about the files you want to tuneup.  When you cannot
-        go deeper into the directory structure through
-        <replaceable>path/to/dir</replaceable> specification, use this
-        option to reduce the list of files therein.
-    </para>
-    </listitem>
-    </varlistentry>
-
-    <varlistentry>
-    <term><option>--sync-changes</option></term>
-    <listitem>
-    <para>
-        Synchronizes available changes between the working copy and
-        the central repository.
-    </para>
-    </listitem>
-    </varlistentry>
-    </variablelist>
-    </simplesect>
+    </refsynopsisdiv>
 
-    <simplesect id="scripts-bash-tuneup-description">
+    <refsection id="scripts-bash-tuneup-description">
     <title>Description</title>
 
     <para>
@@ -102,7 +43,7 @@
         <filename class="extension">.svg</filename> and <filename
         class="extension">.xhtml</filename>) in the directory
         specified, builds a list with them and applies the
-        maintainance tasks using file extensions as section.
+        maintainance tasks using file extensions as refentry.
     </para>
 
     <para>
@@ -170,7 +111,7 @@
         dynamicaly combining the absolute path of the file being
         currently modified, the workstation's date information, the
         <command>centos-art.sh</command> script copyright holder
-        (e.g., =COPYRIGHT_HOLDER=) as section and the Creative
+        (e.g., =COPYRIGHT_HOLDER=) as refentry and the Creative
         Common Distribution-ShareAlike 3.0 License as default license
         to release SVG files.
     </para>
@@ -206,7 +147,7 @@
         element are set dynamically using the md5sum output of
         combining the page location, the <literal>head-</literal>
         string and the heading content itself.  If any of the
-        components used to build the heading section changes, you
+        components used to build the heading refentry changes, you
         need to run the the tuneup functionality of
         <command>centos-art.sh</command> script in order for the
         anchor elements to use the correct information.
@@ -246,16 +187,74 @@
     </mediaobject>
     </screenshot>
     </example>
-    </simplesect>
+    </refsection>
+
+    <refsection id="scripts-bash-tuneup-options">
+    <title>Options</title>
+    <para>
+        The <function>tuneup</function> functionality accepts the
+        following options: 
+    </para>
+
+    <variablelist>
+    <varlistentry>
+    <term><option>--quiet</option></term>
+    <listitem>
+    <para>
+        Supress all output messages except error messages.  When this
+        option is passed, all confirmation requests are supressed and
+        a possitive answer is assumed for them, just as if the
+        <option>--answer-yes</option> option would have been provided.
+    </para>
+    </listitem>
+    </varlistentry>
+
+    <varlistentry>
+    <term><option>--answer-yes</option></term>
+    <listitem>
+    <para>
+       Assume <emphasis>yes</emphasis> to all confirmation requests.
+    </para>
+    </listitem>
+    </varlistentry>
+
+    <varlistentry>
+    <term><option>--filter="REGEX"</option></term>
+    <listitem>
+    <para>
+        Reduce the list of files to process inside
+        <replaceable>path/to/dir</replaceable> using
+        <replaceable>REGEX</replaceable> as pattern.  You can use this
+        option to control the amount of files you want to tuneup.  The
+        deeper you go into the directory structure the more specific
+        you'll be about the files you want to tuneup.  When you cannot
+        go deeper into the directory structure through
+        <replaceable>path/to/dir</replaceable> specification, use this
+        option to reduce the list of files therein.
+    </para>
+    </listitem>
+    </varlistentry>
+
+    <varlistentry>
+    <term><option>--sync-changes</option></term>
+    <listitem>
+    <para>
+        Synchronizes available changes between the working copy and
+        the central repository.
+    </para>
+    </listitem>
+    </varlistentry>
+    </variablelist>
+    </refsection>
 
-    <simplesect id="script-bash-tuneup-environment">
+    <refsection id="scripts-bash-tuneup-environment">
     <title>Function Specific Environment</title>
     <para>
         ...
     </para>
-    </simplesect>
+    </refsection>
 
-    <simplesect id="scripts-bash-tuneup-authors">
+    <refsection id="scripts-bash-tuneup-authors">
     <title>Authors</title>
     <para>
         The following people have worked in the
@@ -268,9 +267,9 @@
     </para>
     </listitem>
     </itemizedlist>
-    </simplesect>
+    </refsection>
 
-    <simplesect id="scripts-bash-tuneup-licence">
+    <refsection id="scripts-bash-tuneup-licence">
     <title>License</title>
 
     <para>
@@ -297,6 +296,6 @@
         Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
         USA.
     </para>
-    </simplesect>
+    </refsection>
 
-</section>
+</refentry>