diff --git a/Manuals/en/Html/Repository/repository.html b/Manuals/en/Html/Repository/repository.html
index 8dcbe28..b7c98a3 100644
--- a/Manuals/en/Html/Repository/repository.html
+++ b/Manuals/en/Html/Repository/repository.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -104,7 +104,7 @@ Documentation License.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_1.html b/Manuals/en/Html/Repository/repository_1.html
index 119a6f6..b29bb08 100644
--- a/Manuals/en/Html/Repository/repository_1.html
+++ b/Manuals/en/Html/Repository/repository_1.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -91,7 +91,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_10.html b/Manuals/en/Html/Repository/repository_10.html
index 5667571..219ca65 100644
--- a/Manuals/en/Html/Repository/repository_10.html
+++ b/Manuals/en/Html/Repository/repository_10.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -114,7 +114,7 @@ to HTML design models.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_11.html b/Manuals/en/Html/Repository/repository_11.html
index abcaa61..3c0f79f 100644
--- a/Manuals/en/Html/Repository/repository_11.html
+++ b/Manuals/en/Html/Repository/repository_11.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -115,7 +115,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_12.html b/Manuals/en/Html/Repository/repository_12.html
index 08cbe5e..7d888d8 100644
--- a/Manuals/en/Html/Repository/repository_12.html
+++ b/Manuals/en/Html/Repository/repository_12.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -119,7 +119,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_13.html b/Manuals/en/Html/Repository/repository_13.html
index 735b622..0136667 100644
--- a/Manuals/en/Html/Repository/repository_13.html
+++ b/Manuals/en/Html/Repository/repository_13.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -115,7 +115,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_14.html b/Manuals/en/Html/Repository/repository_14.html
index 46f6418..d14a36d 100644
--- a/Manuals/en/Html/Repository/repository_14.html
+++ b/Manuals/en/Html/Repository/repository_14.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -447,7 +447,7 @@ CentOS [base] and CentOS [updates] repositories.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_15.html b/Manuals/en/Html/Repository/repository_15.html
index e3e1de7..8463cb4 100644
--- a/Manuals/en/Html/Repository/repository_15.html
+++ b/Manuals/en/Html/Repository/repository_15.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -115,7 +115,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_16.html b/Manuals/en/Html/Repository/repository_16.html
index 337cbb9..e1a08c0 100644
--- a/Manuals/en/Html/Repository/repository_16.html
+++ b/Manuals/en/Html/Repository/repository_16.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -107,7 +107,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_17.html b/Manuals/en/Html/Repository/repository_17.html
index 1e38e6d..2435766 100644
--- a/Manuals/en/Html/Repository/repository_17.html
+++ b/Manuals/en/Html/Repository/repository_17.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -123,7 +123,7 @@ final CentOS themes. CentOS themes can be tagged as "Default" or
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_18.html b/Manuals/en/Html/Repository/repository_18.html
index d603f23..ada15a5 100644
--- a/Manuals/en/Html/Repository/repository_18.html
+++ b/Manuals/en/Html/Repository/repository_18.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -121,7 +121,7 @@ a directory to the list. By default you have the `See section <a href="repositor
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_19.html b/Manuals/en/Html/Repository/repository_19.html
index 6762097..97cac43 100644
--- a/Manuals/en/Html/Repository/repository_19.html
+++ b/Manuals/en/Html/Repository/repository_19.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -119,7 +119,7 @@ themes are maintained by CentOS Community.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_2.html b/Manuals/en/Html/Repository/repository_2.html
index 8322901..6268e92 100644
--- a/Manuals/en/Html/Repository/repository_2.html
+++ b/Manuals/en/Html/Repository/repository_2.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -91,7 +91,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_20.html b/Manuals/en/Html/Repository/repository_20.html
index adaf525..2ea1461 100644
--- a/Manuals/en/Html/Repository/repository_20.html
+++ b/Manuals/en/Html/Repository/repository_20.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -120,7 +120,7 @@ described in See section <a href="repository_25.html#SEC132">Theme Motifs</a>.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_21.html b/Manuals/en/Html/Repository/repository_21.html
index a2cd3cb..295fb74 100644
--- a/Manuals/en/Html/Repository/repository_21.html
+++ b/Manuals/en/Html/Repository/repository_21.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -179,7 +179,7 @@ the CentOS brand will exonerate user form visual isolation.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_22.html b/Manuals/en/Html/Repository/repository_22.html
index 8b26436..db5f636 100644
--- a/Manuals/en/Html/Repository/repository_22.html
+++ b/Manuals/en/Html/Repository/repository_22.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -107,7 +107,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_23.html b/Manuals/en/Html/Repository/repository_23.html
index 2b32658..d4c08af 100644
--- a/Manuals/en/Html/Repository/repository_23.html
+++ b/Manuals/en/Html/Repository/repository_23.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -120,7 +120,7 @@ examples of promotion designs.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_24.html b/Manuals/en/Html/Repository/repository_24.html
index 4a2d817..5bfbc78 100644
--- a/Manuals/en/Html/Repository/repository_24.html
+++ b/Manuals/en/Html/Repository/repository_24.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -119,7 +119,7 @@ HTML standards should be consider here.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_25.html b/Manuals/en/Html/Repository/repository_25.html
index ba31896..84f46e4 100644
--- a/Manuals/en/Html/Repository/repository_25.html
+++ b/Manuals/en/Html/Repository/repository_25.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -203,7 +203,7 @@ works are released under
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_26.html b/Manuals/en/Html/Repository/repository_26.html
index 23dd467..2aeb1d0 100644
--- a/Manuals/en/Html/Repository/repository_26.html
+++ b/Manuals/en/Html/Repository/repository_26.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -223,7 +223,7 @@ can contain subdirectories to help you organize the design process.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_27.html b/Manuals/en/Html/Repository/repository_27.html
index 4881af0..0d0c92b 100644
--- a/Manuals/en/Html/Repository/repository_27.html
+++ b/Manuals/en/Html/Repository/repository_27.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -112,7 +112,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_28.html b/Manuals/en/Html/Repository/repository_28.html
index 0dc600c..4be61bc 100644
--- a/Manuals/en/Html/Repository/repository_28.html
+++ b/Manuals/en/Html/Repository/repository_28.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -111,7 +111,7 @@ command line interface.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_29.html b/Manuals/en/Html/Repository/repository_29.html
index 9f6c1f3..0cacd79 100644
--- a/Manuals/en/Html/Repository/repository_29.html
+++ b/Manuals/en/Html/Repository/repository_29.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -120,7 +120,7 @@ based on them. In this last case you need the <tt>`Xcf/'</tt> directory.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_3.html b/Manuals/en/Html/Repository/repository_3.html
index da66b81..9a197f1 100644
--- a/Manuals/en/Html/Repository/repository_3.html
+++ b/Manuals/en/Html/Repository/repository_3.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -206,7 +206,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_30.html b/Manuals/en/Html/Repository/repository_30.html
index 6f85e19..0a05c30 100644
--- a/Manuals/en/Html/Repository/repository_30.html
+++ b/Manuals/en/Html/Repository/repository_30.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -148,7 +148,7 @@ centos-art render --identity
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_31.html b/Manuals/en/Html/Repository/repository_31.html
index 2220889..81f51af 100644
--- a/Manuals/en/Html/Repository/repository_31.html
+++ b/Manuals/en/Html/Repository/repository_31.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -112,7 +112,7 @@ limitations. Theme palettes contain theme's unique color information.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_32.html b/Manuals/en/Html/Repository/repository_32.html
index 4383c8f..7616b52 100644
--- a/Manuals/en/Html/Repository/repository_32.html
+++ b/Manuals/en/Html/Repository/repository_32.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -107,7 +107,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_33.html b/Manuals/en/Html/Repository/repository_33.html
index b4a9179..60f2abc 100644
--- a/Manuals/en/Html/Repository/repository_33.html
+++ b/Manuals/en/Html/Repository/repository_33.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -418,7 +418,7 @@ the following <tt>`syslinux.hex'</tt> file:
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_34.html b/Manuals/en/Html/Repository/repository_34.html
index 48dd22d..a9aa72e 100644
--- a/Manuals/en/Html/Repository/repository_34.html
+++ b/Manuals/en/Html/Repository/repository_34.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -107,7 +107,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_35.html b/Manuals/en/Html/Repository/repository_35.html
index 640da1b..738cfa4 100644
--- a/Manuals/en/Html/Repository/repository_35.html
+++ b/Manuals/en/Html/Repository/repository_35.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -158,7 +158,7 @@ repository):
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_36.html b/Manuals/en/Html/Repository/repository_36.html
index 2bbe5bb..eaf0937 100644
--- a/Manuals/en/Html/Repository/repository_36.html
+++ b/Manuals/en/Html/Repository/repository_36.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -118,7 +118,7 @@ programming language.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_37.html b/Manuals/en/Html/Repository/repository_37.html
index c76a12c..9aaa074 100644
--- a/Manuals/en/Html/Repository/repository_37.html
+++ b/Manuals/en/Html/Repository/repository_37.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -209,7 +209,7 @@ each specific function documentation (see section <a href="repository_38.html#SE
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_38.html b/Manuals/en/Html/Repository/repository_38.html
index 277f483..5d43fde 100644
--- a/Manuals/en/Html/Repository/repository_38.html
+++ b/Manuals/en/Html/Repository/repository_38.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -97,7 +97,7 @@ improve them in order for them to do so.
inside specific directories under <tt>`trunk/Scripts/Bash/Functions'</tt>
location. Each specific function directory should be named as the
function it represents, with the first letter in uppercase. For
-example, if the function name is <samp>`render'</samp>, the specific function
+example, if the function name is <code>render</code>, the specific function
directory for it would be <samp>`trunk/Scripts/Bash/Functions/Render'</samp>.
</p>
<p>To better understand how specific functions of <tt>`centos-art.sh'</tt>
@@ -120,11 +120,11 @@ advantage can be taken from them. Global functions are stored
immediatly under <tt>`trunk/Scripts/Bash/Functions'</tt> directory in
files begining with <samp>`cli'</samp> prefix.
</p>
-<p>OK, let's begin with our specific functionality example.
+<p>OK, let's begin with our <code>greet</code> specific functionality example.
</p>
<p>What function name do we use? Well, lets use <code>greet</code>. Note that
<samp>`hello'</samp> is not a verb, but an expression, a kind of greeting, an
-interjection specifically. In contrast, <code>greet</code> is a verb and
+interjection specifically. In contrast, <samp>`greet'</samp> is a verb and
describes what we do when we say <samp>`Hello!'</samp>, <samp>`Hi!'</samp>, and so on.
</p>
<p>So far, we've gathered the following function information:
@@ -133,21 +133,15 @@ describes what we do when we say <samp>`Hello!'</samp>, <samp>`Hi!'</samp>, and
Path: trunk/Scripts/Bash/Functions/Greet
File: trunk/Scripts/Bash/Functions/Greet/greet.sh
</pre>
-<blockquote class="blue"><img src="/home/centos/artwork/trunk/Identity/Widgets/Img/icon-admonition-info.png" alt="info"><h3>Note</h3><p> Note how function name is used as reference to define
-function path, function script, and function definition inside
-function script.
-</p></blockquote>
-
-<p>As consistency convenction, files related to <code>greet</code>
-functionality are stored under its own function path. The
-<tt>`greet.sh'</tt> function script is the first file <tt>`centos-art.sh'</tt>
-script loads when the <code>greet</code> functionality is called using
-commands like <samp>`centos-art greet --hello='World''</samp>.
+<p>The <tt>`greet.sh'</tt> function script is the first file
+<tt>`centos-art.sh'</tt> script loads when the <samp>`greet'</samp> functionality
+is called using commands like <samp>`centos-art greet --hello='World''</samp>.
+The <tt>`greet.sh'</tt> function script contains the <code>greet</code> function
+definition.
</p>
-<p>The <tt>`greet.sh'</tt> function script contains the <code>greet</code> function
-definition. Inside <tt>`centos-art.sh'</tt> script, each function
-definition has its own top commentary, followed by one blank line, and
-then one function defintion below it.
+<p>Inside <tt>`centos-art.sh'</tt> script, each function definition has its
+own top commentary, followed by one blank line, and then one function
+defintion below it.
</p>
<p>The function top commentary contains a brief description about what
the function does, one-line for copyright note --with your personal
@@ -155,8 +149,10 @@ information--, the license under which the function source code is
released --the <tt>`centos-art.sh'</tt> script is released as GPL, so do
all its functions--, and the subversion <code>$Id$</code> keyword--which
is later expanded when we do <code>svn propset</code> over
-<tt>`greet.sh'</tt> file--. In our function example, the <tt>`greet.sh'</tt>
-top commentary would look like the following:
+<tt>`greet.sh'</tt> file--.
+</p>
+<p>In our <code>greet</code> function example, the <tt>`greet.sh'</tt> top
+commentary would look like the following:
</p>
<pre class="verbatim">#!/bin/bash
#
@@ -185,14 +181,7 @@ top commentary would look like the following:
# $Id$
# ----------------------------------------------------------------------
</pre>
-<p>The <code>greet</code> function defines variables that will be available
-along <code>greet</code> function execution environment. Later, as final
-definition, the <code>greet</code> function calls the
-<tt>`greet_getActions'</tt> function defined inside
-<tt>`greet_getActions.sh'</tt> function script.
-</p>
-<p>In our example, the <code>greet</code> function definition would look as
-follows:
+<p>The <code>greet</code> function definition would look as follows:
</p>
<pre class="verbatim">function greet {
@@ -203,16 +192,17 @@ follows:
}
</pre>
-<p>This time we didn't use global variable definitions for <code>greet</code>
-execution environment, so we left the section empty.
-</p>
-<p>The <code>greet_getActions</code> function defines the command-line
-interface of <code>greet</code> functionality. The command-line interface
-defines what to do with arguments passed to <tt>`centos-art.sh'</tt>
-script once <code>greet</code> has been specified as second argument.
-</p>
-<p>In our function example, the <code>greet_getActions</code> function
-definition would look like the following:
+<p>The first definition inside <code>greet</code> function, are global
+variables that will be available along <code>greet</code> function execution
+environment. This time we didn't use global variable definitions for
+<code>greet</code> function execution environment, so we left that section
+empty.
+</p>
+<p>Later, we call <code>greet_getActions</code> function to define the
+command-line interface of <code>greet</code> functionality. The command-line
+interface sets what we can do with arguments passed to
+<tt>`centos-art.sh'</tt> script, once <samp>`greet'</samp> has been specified as
+first argument in the command-line.
</p>
<pre class="verbatim">function greet_getActions {
@@ -234,26 +224,29 @@ definition would look like the following:
}
</pre>
-<p>In the above example, we've defined a selection case based on second
-argument's option name (<var>OPTIONNAM</var>). In our selection case, we
-defined the <samp>`--hello'</samp> and <samp>`--bye'</samp> options as valid
-options. If no one of them is provided as second command-line
-argument, the <samp>`*'</samp> option is evaluated instead.
-</p>
-<p>The <samp>`*'</samp> option and the two following lines, should always be
-present in <tt>`*_getActions.sh'</tt> function scripts, no matter what
-specific functionality you are creating. This convenction helps the
-user to find out documentation about the current functionality in use.
-Of course, function documentation needs to be created first
-(see section <a href="repository_39.html#SEC208">trunk/Scripts/Bash/Functions/Help</a>, to know how), and that
-task is something you --as author of specific functions-- probably
-want to do personally.
-</p>
-<p>Following with our example, the <code>greet_doHello</code>, and
-<code>greet_doBye</code> function definitions are the core of <code>greet</code>
-specific functionality. In such function definitions is where we
-define what our function realy does --output different kinds of
-greetings, in the sake of our example--.
+<p>The <var>OPTIONNAM</var> global variable is defined in <tt>`cli.sh'</tt>
+function script and contains the value passed before the equal sign
+(i.e., <samp>`='</samp>) in the second command-line argument of
+<tt>`centos-art.sh'</tt> script. For example, if the second command-line
+argument is <samp>`--hello='World''</samp>, the value of <var>OPTIONNAM</var>
+variable would be <samp>`--hello'</samp>. Using this configuration let us
+deside which action to perform based on the option name passed to
+<tt>`centos-art.sh'</tt> script as second argument.
+</p>
+<p>The <code>greet</code> specific function makes available two valid greetings
+through <samp>`--hello'</samp> and <samp>`--bye'</samp> options. If no one of
+them is provided as second command-line argument, the <samp>`*'</samp> case is
+evaluated instead.
+</p>
+<p>The <samp>`*'</samp> case and its two further lines should always be present
+in <tt>`_getActions.sh'</tt> function scripts, no matter what specific
+functionality you are creating. This convenction helps the user to
+find out documentation about current functionality in use.
+</p>
+<p>The <code>greet_doHello</code> and <code>greet_doBye</code> function definitions
+are the core of <code>greet</code> specific functionality. In such function
+definitions we set what our <code>greet</code> function really does: to
+output different kinds of greetings.
</p>
<pre class="verbatim">function greet_doHello {
@@ -277,16 +270,15 @@ greetings, in the sake of our example--.
scripts are stored inside <code>greet</code>'s function directory path (i.e.
<tt>`trunk/Scripts/Bash/Functions/Greet'</tt>).
</p>
-<p>In the examples above, we use the <var>OPTIONVAL</var> global variable.
-The <var>OPTIONVAL</var> variable is defined in <tt>`cli.sh'</tt> function
-script and contains the value passed after the equal sign (i.e.,
-<samp>`='</samp>) in the second command-line argument of <tt>`centos-art.sh'</tt>
-script. For example, if the second command-line argument is
-<samp>`--hello='World''</samp>, the value of <var>OPTIONVAL</var> variable would
-be <samp>`World'</samp> without quotes.
+<p>The <var>OPTIONVAL</var> global variable is defined in <tt>`cli.sh'</tt>
+function script and contains the value passed after the equal sign
+(i.e., <samp>`='</samp>) in the second command-line argument of
+<tt>`centos-art.sh'</tt> script. For example, if the second command-line
+argument is <samp>`--hello='World''</samp>, the value of <var>OPTIONVAL</var>
+variable would be <samp>`World'</samp> without quotes.
</p>
<p>Let's see how <code>greet</code> specific functionality files are organzied
-under <code>greet</code>'s function directory. To see file organization, we
+under <code>greet</code>'s function directory. To see file organization we
use the <code>tree</code> command:
</p>
<pre class="verbatim">trunk/Scripts/Bash/Functions/Greet
@@ -295,10 +287,10 @@ use the <code>tree</code> command:
|-- greet_getActions.sh
`-- greet.sh
</pre>
-<p>To try the <code>greet</code> specific functionality, pass <code>greet</code>
-string as first argument to <tt>`centos-art.sh'</tt> script, and any of
-the valid options as second argument. Some examples are illustrated
-below:
+<p>To try the <code>greet</code> specific functionality, pass the function name
+(i.e., <samp>`greet'</samp>) as first argument to <tt>`centos-art.sh'</tt> script,
+and any of the valid options as second argument. Some examples are
+illustrated below:
</p>
<pre class="verbatim">[centos@projects ~]$ centos-art greet --hello='World'
Hello World
@@ -306,22 +298,39 @@ Hello World
Goodbye World
[centos@projects ~]$
</pre>
-<p>The word <samp>`World'</samp> in the examples above, can be anything. In fact,
-change it to have a little fun :).
+<p>The word <samp>`World'</samp> in the examples above can be anything. In fact,
+change it to have a little fun.
</p>
<p>Now that we have a specific function that works as we expect, it is
time to document it. To document <code>greet</code> specific functionality,
-we need to use its directory path and the <code>help</code> functionality
+we use its directory path and the <code>help</code> functionality
(see section <a href="repository_39.html#SEC208">trunk/Scripts/Bash/Functions/Help</a>) of <tt>`centos-art.sh'</tt>
script, just as the following command illustrates:
</p>
<pre class="verbatim">centos-art help --edit=trunk/Scripts/Bash/Functions/Greet
</pre>
+<p>Now that we have documented our function, it is time to translate its
+output messages to different languages. To translate specific
+functionality output messages to different languages we use the
+<code>locale</code> functionality (see section <a href="repository_41.html#SEC218">trunk/Scripts/Bash/Functions/Locale</a>) of <tt>`centos-art.sh'</tt> script, just as the following command
+illustrates:
+</p>
+<pre class="verbatim">centos-art locale --edit
+</pre>
+<blockquote class="orange"><img src="/home/centos/artwork/trunk/Identity/Widgets/Img/icon-admonition-alert.png" alt="Warning"><h3>Warning</h3><p> To translate output messages in different languages,
+your system locale information --as in <code>LANG</code> environment
+variable-- must be set to that locale you want to produce translated
+messages for. For example, if you want to produce translated messages
+for Spanish language, your system locale information must be set to
+<samp>`es_ES.UTF-8'</samp> or similar.
+</p></blockquote>
+
<p>Well, it seems that our example is rather complete by now.
</p>
-<p>In <code>greet</code> example we've described so far, we only use the
-<code>cli_printMessage</code> global function in action specific
-functions, but more interesting things can be achieved inside them.
+<p>In <code>greet</code> function example we've described so far, we only use
+<code>cli_printMessage</code> global function in action specific function
+definitions in order to print a message simply, but more interesting
+things can be achieved inside action specific function definitions.
For example, if you pass a directory path as second argument option
value, you could retrive a list of files from therein, and process
them. If the list of files turns too long, you could add the third
@@ -334,7 +343,7 @@ some of luck this introduction will also serve you as motivation to
create your own specific functionalities.
</p>
<p>By the way, the <code>greet</code> functionality doesn't exist inside
-<tt>`centos-art.sh'</tt> script. Would you like to create it?
+<tt>`centos-art.sh'</tt> script yet. Would you like to create it?
</p>
<a name="SEC203"></a>
@@ -479,7 +488,7 @@ verification as specified in <var>TYPE</var>.
</p>
<p>When <var>TYPE</var> is not specified, <code>cli_checkFiles</code> verifies
<var>FILE</var> existence, no matter what kind of file it be. If
-<var>TYPE</var> is specified, it can take one of the following values:
+<var>TYPE</var> is specified, use one of the following values:
</p>
<dl compact="compact">
<dt> <samp>`d'</samp></dt>
@@ -501,31 +510,30 @@ When <var>FILE</var> is neither a regular file or a symbolic link,
</p></dd>
</dl>
-<p>When <var>ACTION</var> is not specified, <code>cli_checkFiles</code> function uses
-<samp>`Checking'</samp> as default action message. The action message is used
-on left-column as description for verification action. It may be cases
-where you need to change default action message with your own. In that
-cases remember to use the <code>"`gettext "Your message"`"</code>
+<p>When <var>ACTION</var> is not specified, <code>cli_checkFiles</code> function
+uses <samp>`Checking'</samp> as default action message. The action message is
+used on left-column as description to action verification. It may be
+cases where you need to change default action message with your own.
+In those cases remember to use the <code>"`gettext "Your message"`"</code>
construction in order for <code>gettext</code> to know about it. This way
-your action message can be translated to other languages too.
+your action message can be translated to other languages too. By
+default <code>cli_checkFiles</code> output information about <var>FILE</var> on
+the right column.
</p>
-<p>By default <code>cli_checkFiles</code> output information about <var>FILE</var>
-on the right column. When <var>OPTIONS</var> is specified, default behaivour
-is modified as specified in <var>OPTIONS</var>. The <var>OPTIONS</var> can take
-any of the following options:
-</p><dl compact="compact">
+<p>When <var>OPTIONS</var> is specified, default behaivour is modified as
+specified in <var>OPTIONS</var>. The <var>OPTIONS</var> can take any of the
+following options: </p><dl compact="compact">
<dt> <samp>`--quiet'</samp></dt>
-<dd><p>If this option is specified, <code>cli_checkFiles</code> supresses
-verification output. This option is useful if you only want to do
-file verifications but don't want to output any information about it.
-</p>
-<pre class="verbatim">cli_checkFiles $FILE 'f' '' '--quiet'
+<dd><p>The <samp>`--quiet'</samp> option supresses verification output.
+</p><pre class="verbatim">cli_checkFiles $FILE 'f' '' '--quiet'
if [[ $? -eq 0 ]];then
- echo "File exists."
+ INFO="`gettext "The file exists."`"
else
- echo "File doesn't exist"
+ INFO="`gettext "The file doesn't exist."`"
fi
-</pre></dd>
+</pre><p>Use <samp>`--quiet'</samp> option whenever you want to do file verifications
+but don't want to output any information about it.
+</p></dd>
</dl>
</dd></dl>
@@ -535,7 +543,7 @@ fi
</dt>
<dd><p><code>cli_getCountryCodes</code> function outputs a list with country codes
as defined in ISO3166 standard. When <var>FILTER</var> is provided,
-<code>cli_getCountryCodes</code> outpus country codes that match
+<code>cli_getCountryCodes</code> outputs country codes that match
<var>FILTER</var> regular expression pattern.
</p></dd></dl>
@@ -553,10 +561,27 @@ ISO3166. If filter is specified, just the country name that matches
<dt><u>Function:</u> <b>cli_getCurrentLocale</b>
<a name="IDX14"></a>
</dt>
-<dd><p><code>cli_getCurrentLocale</code> function checks <var>LANG</var> environment
-variable and returns the current locale from more specific to less
-specific. For example, if the locale <samp>`en_GB'</samp> is the current one,
-it should be used instead of just <samp>`en'</samp>.
+<dd><p><code>cli_getCurrentLocale</code> function uses <code>LANG</code> environment
+variable to build a locale pattern that is later applied to
+<code>cli_getLocales</code> function output in order to return the current
+locale that <tt>`centos-art.sh'</tt> script works with.
+</p>
+<p>The current locale information, returned by
+<code>cli_getCurrentLocale</code>, is output from more specific to less
+specific. For example, if <samp>`en_GB'</samp> locale exists in
+<code>cli_getLocales</code> function output, the <samp>`en_GB'</samp> locale would
+take precedence before <samp>`en'</samp> locale.
+</p>
+<p>Locale precedence selection is quite important in order to define the
+locale type we use for message translations. For example, if
+<samp>`en_GB'</samp> is used, we are also saying that no common language
+specification is used for English language (i.e., <samp>`en'</samp>). Instead,
+we are using English non-common country-specific language
+specifications like <samp>`en_AU'</samp>, <samp>`en_BW'</samp>, <samp>`en_GB'</samp>,
+<samp>`en_US'</samp>, etc., for message translations.
+</p>
+<p>Use <code>cli_getCurrentLocale</code> function to know what current locale
+information to use inside <tt>`centos-art.sh'</tt> script.
</p></dd></dl>
<dl>
@@ -570,43 +595,90 @@ regular expression pattern.
</p></dd></dl>
<dl>
-<dt><u>Function:</u> <b>cli_getLangNames</b>
+<dt><u>Function:</u> <b>cli_getLangName</b><i> [FILTER]</i>
<a name="IDX16"></a>
</dt>
-<dd><p><code>cli_getLangNames</code> function reads one language locale code in the
+<dd><p><code>cli_getLangName</code> function reads one language locale code in the
format LL_CC and outputs its language name as defined in ISO639
-standard. If filter is specified, just the language name that matches
-<var>FILTER</var>, exactly, is returned.
+standard. If <var>FILTER</var> is specified, just the language name that
+matches <var>FILTER</var>, exactly, is returned.
</p></dd></dl>
<dl>
<dt><u>Function:</u> <b>cli_getLocales</b>
<a name="IDX17"></a>
</dt>
-<dd><p><code>cli_getLocales</code> function outputs locale codes in LL and LL_CC
-format. Combine both ISO639 and ISO3166 specification in order to
-build the final locale list. The <code>cli_getLocales</code> function
-defines which translation locales are supported inside CentOS Artwork
-Repository.
+<dd><p><code>cli_getLocales</code> defines what locale codes does
+<tt>`centos-art.sh'</tt> script support.
+</p>
+<p>Occasionally, you use <code>cli_getLocales</code> function to add locale
+information in non-common country-specific language (<samp>`LL_CC'</samp>)
+format for those languages (e.g., <samp>`bn_IN'</samp>, <samp>`pt_BR'</samp>, etc.)
+which locale differences cannot be solved using common language
+specifications (<samp>`LL'</samp>) into one unique common locale specification
+(e.g., <samp>`bn'</samp>, <samp>`pt'</samp>, etc.).
</p></dd></dl>
<dl>
-<dt><u>Function:</u> <b>cli_getRepoNames</b>
+<dt><u>Function:</u> <b>cli_getRepoName</b><i> NAME TYPE</i>
<a name="IDX18"></a>
</dt>
-<dd><p><code>cli_getRepoNames</code> function sets naming convenction inside CentOS
-Artowrk Repository. As convenction, regular files are written in lower
-case and directories are written in CamelCase. Use this function to
-sanitate the name of regular files and directories you work with.
-</p></dd></dl>
+<dd><p><code>cli_getRepoName</code> function sets file names convenctions inside
+<tt>`centos-art.sh'</tt> script. File name convenctions, as set by
+<code>cli_getRepoName</code>, are used by specific functionalities of
+<tt>`centos-art.sh'</tt> script that rely on repository file system
+organization to do the work they were initially conceived to do.
+Consider <code>cli_getRepoName</code> function as a place to manage file
+name convenction centrally.
+</p>
+<blockquote class="orange"><img src="/home/centos/artwork/trunk/Identity/Widgets/Img/icon-admonition-alert.png" alt="Warning"><h3>Warning</h3><p> <code>cli_getRepoName</code> function doesn't verify file
+or directory existence, for that purpose use <code>cli_checkFiles</code>
+function instead.
+</p></blockquote>
+
+<p>The <var>NAME</var> variable contains the file name or directory name you
+want to sanitate.
+</p>
+<p>The <var>TYPE</var> variable can be one of the following values:
+</p><dl compact="compact">
+<dt> <samp>`d'</samp></dt>
+<dt> <samp>`directory'</samp></dt>
+<dd><p>Sanitate directory <var>NAME</var>s.
+</p></dd>
+<dt> <samp>`f'</samp></dt>
+<dt> <samp>`regular-file'</samp></dt>
+<dd><p>Sanitate regular file <var>NAME</var>s.
+</p></dd>
+</dl>
+
+<p>Use <code>cli_getRepoName</code> function to sanitate file names and
+directory names before their utilization.
+</p>
+<p>Use <code>cli_getRepoName</code> when you need to change file name
+convenction inside <tt>`centos-art.sh'</tt> script. When changing file
+name convenctions inside <code>cli_getRepoName</code> what you are really
+changing is the way functions interpret repository file system
+organization. In order to a complete file name convenction change, you
+also need to change file names and directory names inside repository
+file system organization, just as you did in <code>cli_getRepoName</code>
+function.
+</p>
+<blockquote class="blue"><img src="/home/centos/artwork/trunk/Identity/Widgets/Img/icon-admonition-info.png" alt="info"><h3>Note</h3><p> See section <a href="repository_42.html#SEC223">trunk/Scripts/Bash/Functions/Path</a>, for more
+information on how to rename files and directories massively inside
+repository file system organization.
+</p></blockquote>
+</dd></dl>
<dl>
<dt><u>Function:</u> <b>cli_getThemeName</b>
<a name="IDX19"></a>
</dt>
-<dd><p><code>cli_getThemeName</code> function manipulates the current absolute path
-to extract the theme name from it. If there is no theme in the path,
-this function returns an empty string.
+<dd><p><code>cli_getThemeName</code> function evaluates <var>OPTIONVAL</var> global
+variable to extract theme name from it. In order for
+<code>cli_getThemeName</code> function to extract theme name correctly, the
+<var>OPTIONVAL</var> variable must contain a directory path under
+<tt>`trunk/Identity/Themes/Motifs/'</tt> directory structure. Otherwise,
+<code>cli_getThemeName</code> returns an empty string.
</p></dd></dl>
<dl>
@@ -615,9 +687,7 @@ this function returns an empty string.
</dt>
<dd><p><code>cli_printMessage</code> function outputs information in predifined
formats. The <code>cli_printMessage</code> function is the standard way to
-output information inside <tt>`centos-art.sh'</tt> script. Use this
-function whenever you need to output information from
-<tt>`centos-art.sh'</tt>.
+output information inside <tt>`centos-art.sh'</tt> script.
</p>
<p>When <var>FORMAT</var> is not specified, <code>cli_printMessage</code> outputs
information just as it was passed in <var>MESSAGE</var> variable.
@@ -752,7 +822,9 @@ using two-columns format.
<tt>`trunk/Scripts/Bash/Styles/output_forTwoColumns.awk'</tt> file.
</p></dd>
</dl>
-</dd></dl>
+<p>Use <code>cli_printMessage</code> function whenever you need to output
+information from <tt>`centos-art.sh'</tt>.
+</p></dd></dl>
<a name="SEC206"></a>
@@ -804,7 +876,7 @@ available for you to use:
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_39.html b/Manuals/en/Html/Repository/repository_39.html
index c687386..19e5135 100644
--- a/Manuals/en/Html/Repository/repository_39.html
+++ b/Manuals/en/Html/Repository/repository_39.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -115,7 +115,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_4.html b/Manuals/en/Html/Repository/repository_4.html
index d37d1ac..96622fd 100644
--- a/Manuals/en/Html/Repository/repository_4.html
+++ b/Manuals/en/Html/Repository/repository_4.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -531,7 +531,7 @@ links).
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_40.html b/Manuals/en/Html/Repository/repository_40.html
index a06b53c..cc84eac 100644
--- a/Manuals/en/Html/Repository/repository_40.html
+++ b/Manuals/en/Html/Repository/repository_40.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -115,7 +115,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_41.html b/Manuals/en/Html/Repository/repository_41.html
index 2a5c2ea..316182e 100644
--- a/Manuals/en/Html/Repository/repository_41.html
+++ b/Manuals/en/Html/Repository/repository_41.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -101,23 +101,23 @@ location <tt>`$CLI_LANG/$CLI_LANG.po'</tt>.
<p>The <var>CLI_LANG</var> variable discribes the locale language used to
output messages inside <code>centos-art</code> command. The locale
language used inside <code>centos-art</code> command is taken from the
-<var>LANG</var> environment variable. The <var>CLI_LANG</var> variable has the
+<code>LANG</code> environment variable. The <var>CLI_LANG</var> variable has the
<samp>`LL_CC'</samp> format, where <samp>`LL'</samp> is a language code from the
ISO-639 standard, and <samp>`CC'</samp> a country code from the ISO-3166
standard.
</p>
-<p>The <var>LANG</var> environment variable is set when you do log in to your
+<p>The <code>LANG</code> environment variable is set when you do log in to your
system. If you are using a graphical session, change language to your
-native language and do login. That would set and exoprt the <var>LANG</var>
+native language and do login. That would set and exoprt the <code>LANG</code>
environment variable to the correct value. On the other side, if you
are using a text session edit your <tt>`~/.bash_profile'</tt> file to set
-and export the <var>LANG</var> environment variable to your native locale
+and export the <code>LANG</code> environment variable to your native locale
as defines the <code>locale -a</code> command output; do logout, and do
login again.
</p>
-<p>At this point, the <var>LANG</var> environment variable has the appropriate
+<p>At this point, the <code>LANG</code> environment variable has the appropriate
value you need, in order to translate <code>centos-art.sh</code> messages
-to your native language (the one set in <var>LANG</var> environment
+to your native language (the one set in <code>LANG</code> environment
variable).
</p>
<p>With the <tt>`$CLI_LANG/$CLI_LANG.po'</tt> file up to date, the
@@ -156,7 +156,7 @@ can find such modifications in the following files:
<dl compact="compact">
<dt> <samp>`centos-art locale --edit'</samp></dt>
<dd><p>Use this command to translate command-line interface output messages
-in the current system locale you are using (as specified in <var>LANG</var>
+in the current system locale you are using (as specified in <code>LANG</code>
environment variable).
</p></dd>
<dt> <samp>`centos-art locale --list'</samp></dt>
@@ -180,7 +180,7 @@ environment variable).
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_42.html b/Manuals/en/Html/Repository/repository_42.html
index e958c9c..08157d1 100644
--- a/Manuals/en/Html/Repository/repository_42.html
+++ b/Manuals/en/Html/Repository/repository_42.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -99,17 +99,25 @@ repository file system syncronized with documentation file system.
<p>This feature is not supported yet.
</p>
<dl compact="compact">
-<dt> <samp>`centos-art path 'path/to/dir/' --copy-to='path/to/dir''</samp></dt>
-<dt> <samp>`centos-art path 'path/to/dir/' --copy-to='path/to/dir/filename''</samp></dt>
-<dt> <samp>`centos-art path 'path/to/dir/' --move-to='path/to/dir''</samp></dt>
-<dt> <samp>`centos-art path 'path/to/dir/' --move-to='path/to/dir/filename''</samp></dt>
-<dt> <samp>`centos-art path 'path/to/dir/' --remove'</samp></dt>
+<dt> <samp>`centos-art path --rename='old new' --filter='d''</samp></dt>
+<dd><p>Rename all occurences of <samp>`old'</samp> directory names with <samp>`new'</samp>
+directory name, recursively under the current location.
+</p>
+</dd>
+<dt> <samp>`centos-art path --rename='old new' --filter='f''</samp></dt>
+<dd><p>Rename all occurences of <samp>`old'</samp> file names with <samp>`new'</samp> file
+name, recursively under the current location.
+</p></dd>
</dl>
<a name="SEC227"></a>
<h3 class="subsection"> 3.39.4 See also </h3>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top"><a href="repository_38.html#SEC200">3.35 trunk/Scripts/Bash/Functions</a></td><td> </td><td align="left" valign="top">
+</td></tr>
+</table>
<table cellpadding="1" cellspacing="1" border="0">
@@ -122,7 +130,7 @@ repository file system syncronized with documentation file system.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_43.html b/Manuals/en/Html/Repository/repository_43.html
index 66b54ea..d4fc6e3 100644
--- a/Manuals/en/Html/Repository/repository_43.html
+++ b/Manuals/en/Html/Repository/repository_43.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -119,7 +119,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_44.html b/Manuals/en/Html/Repository/repository_44.html
index a5fb726..47d45dd 100644
--- a/Manuals/en/Html/Repository/repository_44.html
+++ b/Manuals/en/Html/Repository/repository_44.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -282,7 +282,7 @@ directory path under <tt>`trunk/Identity'</tt> or
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_45.html b/Manuals/en/Html/Repository/repository_45.html
index e119c85..1430ed7 100644
--- a/Manuals/en/Html/Repository/repository_45.html
+++ b/Manuals/en/Html/Repository/repository_45.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -115,7 +115,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_46.html b/Manuals/en/Html/Repository/repository_46.html
index 83554d7..b209164 100644
--- a/Manuals/en/Html/Repository/repository_46.html
+++ b/Manuals/en/Html/Repository/repository_46.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -138,7 +138,7 @@ file.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_47.html b/Manuals/en/Html/Repository/repository_47.html
index db346ad..74a1050 100644
--- a/Manuals/en/Html/Repository/repository_47.html
+++ b/Manuals/en/Html/Repository/repository_47.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -189,7 +189,7 @@ modify your <tt>`~/.bash_profile'</tt> file.
evaluates the following environment variables:
</p>
<dl compact="compact">
-<dt> <var>EDITOR</var></dt>
+<dt> <code>EDITOR</code></dt>
<dd>
<p>Default text editor.
</p>
@@ -203,7 +203,7 @@ needs to edit text-based files (e.g., subversion's pre-commit
messages, translation files, configuration files, script files, etc.)
</p>
</dd>
-<dt> <var>TZ</var></dt>
+<dt> <code>TZ</code></dt>
<dd>
<p>Default time zone representation.
</p>
@@ -232,19 +232,19 @@ time information of your zone, taking UTC representation as reference.
</p></blockquote>
</dd>
-<dt> <var>TEXTDOMAIN</var></dt>
+<dt> <code>TEXTDOMAIN</code></dt>
<dd>
<p>Default domain used to retrieve translated messages. This value is
set in <tt>`initFunctions.sh'</tt> and shouldn't be changed.
</p>
</dd>
-<dt> <var>TEXTDOMAINDIR</var></dt>
+<dt> <code>TEXTDOMAINDIR</code></dt>
<dd>
<p>Default directory used to retrieve translated messages. This value is
set in <tt>`initFunctions.sh'</tt> and shouldn't be changed.
</p>
</dd>
-<dt> <var>LANG</var></dt>
+<dt> <code>LANG</code></dt>
<dd>
<p>Default locale information. This value is set when you start your
session and can be changed using the "locale" functionality of
@@ -327,7 +327,7 @@ provided at all.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_48.html b/Manuals/en/Html/Repository/repository_48.html
index b013513..b7ee858 100644
--- a/Manuals/en/Html/Repository/repository_48.html
+++ b/Manuals/en/Html/Repository/repository_48.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -122,7 +122,7 @@ be managed manually. Instead, use the "locale" functionality of
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_49.html b/Manuals/en/Html/Repository/repository_49.html
index 6527c7d..8ae995d 100644
--- a/Manuals/en/Html/Repository/repository_49.html
+++ b/Manuals/en/Html/Repository/repository_49.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -107,7 +107,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_5.html b/Manuals/en/Html/Repository/repository_5.html
index 9dd690f..a023c1d 100644
--- a/Manuals/en/Html/Repository/repository_5.html
+++ b/Manuals/en/Html/Repository/repository_5.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -107,7 +107,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_50.html b/Manuals/en/Html/Repository/repository_50.html
index 5b61659..1c19138 100644
--- a/Manuals/en/Html/Repository/repository_50.html
+++ b/Manuals/en/Html/Repository/repository_50.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -115,7 +115,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_51.html b/Manuals/en/Html/Repository/repository_51.html
index 7360186..589e186 100644
--- a/Manuals/en/Html/Repository/repository_51.html
+++ b/Manuals/en/Html/Repository/repository_51.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -727,7 +727,7 @@ distribution you want to render translations for.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_52.html b/Manuals/en/Html/Repository/repository_52.html
index 66c87d8..b8d380a 100644
--- a/Manuals/en/Html/Repository/repository_52.html
+++ b/Manuals/en/Html/Repository/repository_52.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -131,7 +131,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_53.html b/Manuals/en/Html/Repository/repository_53.html
index b7c8853..d2655bb 100644
--- a/Manuals/en/Html/Repository/repository_53.html
+++ b/Manuals/en/Html/Repository/repository_53.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -201,7 +201,7 @@ inside template translation files.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_54.html b/Manuals/en/Html/Repository/repository_54.html
index def5f74..bb9862a 100644
--- a/Manuals/en/Html/Repository/repository_54.html
+++ b/Manuals/en/Html/Repository/repository_54.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -103,7 +103,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_55.html b/Manuals/en/Html/Repository/repository_55.html
index 85ee0f4..fdaf7fd 100644
--- a/Manuals/en/Html/Repository/repository_55.html
+++ b/Manuals/en/Html/Repository/repository_55.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -164,7 +164,7 @@ directory (<tt>`Tpl/'</tt>), nor translation rendering using
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_56.html b/Manuals/en/Html/Repository/repository_56.html
index 459f4b5..a39caad 100644
--- a/Manuals/en/Html/Repository/repository_56.html
+++ b/Manuals/en/Html/Repository/repository_56.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -103,7 +103,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_57.html b/Manuals/en/Html/Repository/repository_57.html
index ddf42de..e9e9023 100644
--- a/Manuals/en/Html/Repository/repository_57.html
+++ b/Manuals/en/Html/Repository/repository_57.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -103,7 +103,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_58.html b/Manuals/en/Html/Repository/repository_58.html
index 307725c..ccc9d51 100644
--- a/Manuals/en/Html/Repository/repository_58.html
+++ b/Manuals/en/Html/Repository/repository_58.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -103,7 +103,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_59.html b/Manuals/en/Html/Repository/repository_59.html
index 713d903..a905aa8 100644
--- a/Manuals/en/Html/Repository/repository_59.html
+++ b/Manuals/en/Html/Repository/repository_59.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -115,7 +115,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_6.html b/Manuals/en/Html/Repository/repository_6.html
index 0eb10c3..ab30ade 100644
--- a/Manuals/en/Html/Repository/repository_6.html
+++ b/Manuals/en/Html/Repository/repository_6.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -173,7 +173,7 @@ improve this section with your reasons.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_60.html b/Manuals/en/Html/Repository/repository_60.html
index b3eba14..97b4641 100644
--- a/Manuals/en/Html/Repository/repository_60.html
+++ b/Manuals/en/Html/Repository/repository_60.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -183,7 +183,7 @@ documentation entry (see section <a href="repository_51.html#SEC274">trunk/Trans
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_61.html b/Manuals/en/Html/Repository/repository_61.html
index 42678d3..ecc3b1a 100644
--- a/Manuals/en/Html/Repository/repository_61.html
+++ b/Manuals/en/Html/Repository/repository_61.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -122,7 +122,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_62.html b/Manuals/en/Html/Repository/repository_62.html
index 05f99d7..852f1c0 100644
--- a/Manuals/en/Html/Repository/repository_62.html
+++ b/Manuals/en/Html/Repository/repository_62.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -199,7 +199,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_63.html b/Manuals/en/Html/Repository/repository_63.html
index e363e21..3c49155 100644
--- a/Manuals/en/Html/Repository/repository_63.html
+++ b/Manuals/en/Html/Repository/repository_63.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -100,7 +100,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_7.html b/Manuals/en/Html/Repository/repository_7.html
index b3236c2..0b49e7d 100644
--- a/Manuals/en/Html/Repository/repository_7.html
+++ b/Manuals/en/Html/Repository/repository_7.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -107,7 +107,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_8.html b/Manuals/en/Html/Repository/repository_8.html
index 065ea16..0c2dd1a 100644
--- a/Manuals/en/Html/Repository/repository_8.html
+++ b/Manuals/en/Html/Repository/repository_8.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -107,7 +107,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_9.html b/Manuals/en/Html/Repository/repository_9.html
index 9ec2ed4..73bbedd 100644
--- a/Manuals/en/Html/Repository/repository_9.html
+++ b/Manuals/en/Html/Repository/repository_9.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -118,7 +118,7 @@ to build artworks.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_abt.html b/Manuals/en/Html/Repository/repository_abt.html
index 24e368a..e1d9a8f 100644
--- a/Manuals/en/Html/Repository/repository_abt.html
+++ b/Manuals/en/Html/Repository/repository_abt.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -64,7 +64,7 @@ ul.toc {list-style: none}
</tr></table>
<h1>About This Document</h1>
<p>
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</p>
<p>
The buttons in the navigation panels have the following meaning:
@@ -172,7 +172,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_fot.html b/Manuals/en/Html/Repository/repository_fot.html
index 3b45dde..cf4fe77 100644
--- a/Manuals/en/Html/Repository/repository_fot.html
+++ b/Manuals/en/Html/Repository/repository_fot.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -84,7 +84,7 @@ CentOS release schema.
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Html/Repository/repository_toc.html b/Manuals/en/Html/Repository/repository_toc.html
index ff266ce..268f3b3 100644
--- a/Manuals/en/Html/Repository/repository_toc.html
+++ b/Manuals/en/Html/Repository/repository_toc.html
@@ -13,7 +13,7 @@ Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
-<!-- Created on November, 3 2010 by texi2html 1.76 -->
+<!-- Created on November, 4 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -561,7 +561,7 @@ ul.toc {list-style: none}
</tr></table>
<p>
<font size="-1">
- This document was generated on <i>November, 3 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
+ This document was generated on <i>November, 4 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
diff --git a/Manuals/en/Info/Repository/repository.info.bz2 b/Manuals/en/Info/Repository/repository.info.bz2
index 5c4f462..edbebdc 100644
Binary files a/Manuals/en/Info/Repository/repository.info.bz2 and b/Manuals/en/Info/Repository/repository.info.bz2 differ
diff --git a/Manuals/en/Plaintext/Repository/repository.txt b/Manuals/en/Plaintext/Repository/repository.txt
index 4346145..c8034a7 100644
--- a/Manuals/en/Plaintext/Repository/repository.txt
+++ b/Manuals/en/Plaintext/Repository/repository.txt
@@ -2583,7 +2583,7 @@ advantage can be taken from them. Global functions are stored
immediatly under `trunk/Scripts/Bash/Functions' directory in files
begining with `cli' prefix.
- OK, let's begin with our specific functionality example.
+ OK, let's begin with our `greet' specific functionality example.
What function name do we use? Well, lets use `greet'. Note that
`hello' is not a verb, but an expression, a kind of greeting, an
@@ -2597,28 +2597,24 @@ Name: greet
Path: trunk/Scripts/Bash/Functions/Greet
File: trunk/Scripts/Bash/Functions/Greet/greet.sh
- *Note* Note how function name is used as reference to define
- function path, function script, and function definition inside
- function script.
+ The `greet.sh' function script is the first file `centos-art.sh'
+script loads when the `greet' functionality is called using commands
+like `centos-art greet --hello='World''. The `greet.sh' function
+script contains the `greet' function definition.
- As consistency convenction, files related to `greet' functionality
-are stored under its own function path. The `greet.sh' function script
-is the first file `centos-art.sh' script loads when the `greet'
-functionality is called using commands like `centos-art greet
---hello='World''.
-
- The `greet.sh' function script contains the `greet' function
-definition. Inside `centos-art.sh' script, each function definition has
-its own top commentary, followed by one blank line, and then one
-function defintion below it.
+ Inside `centos-art.sh' script, each function definition has its own
+top commentary, followed by one blank line, and then one function
+defintion below it.
The function top commentary contains a brief description about what
the function does, one-line for copyright note --with your personal
information--, the license under which the function source code is
released --the `centos-art.sh' script is released as GPL, so do all its
functions--, and the subversion `$Id$' keyword--which is later expanded
-when we do `svn propset' over `greet.sh' file--. In our function
-example, the `greet.sh' top commentary would look like the following:
+when we do `svn propset' over `greet.sh' file--.
+
+ In our `greet' function example, the `greet.sh' top commentary would
+look like the following:
#!/bin/bash
@@ -2648,13 +2644,7 @@ example, the `greet.sh' top commentary would look like the following:
# $Id$
# ----------------------------------------------------------------------
- The `greet' function defines variables that will be available along
-`greet' function execution environment. Later, as final definition, the
-`greet' function calls the `greet_getActions' function defined inside
-`greet_getActions.sh' function script.
-
- In our example, the `greet' function definition would look as
-follows:
+ The `greet' function definition would look as follows:
function greet {
@@ -2666,16 +2656,16 @@ function greet {
}
- This time we didn't use global variable definitions for `greet'
-execution environment, so we left the section empty.
+ The first definition inside `greet' function, are global variables
+that will be available along `greet' function execution environment.
+This time we didn't use global variable definitions for `greet'
+function execution environment, so we left that section empty.
- The `greet_getActions' function defines the command-line interface
-of `greet' functionality. The command-line interface defines what to do
-with arguments passed to `centos-art.sh' script once `greet' has been
-specified as second argument.
-
- In our function example, the `greet_getActions' function definition
-would look like the following:
+ Later, we call `greet_getActions' function to define the
+command-line interface of `greet' functionality. The command-line
+interface sets what we can do with arguments passed to `centos-art.sh'
+script, once `greet' has been specified as first argument in the
+command-line.
function greet_getActions {
@@ -2698,25 +2688,27 @@ function greet_getActions {
}
- In the above example, we've defined a selection case based on second
-argument's option name (OPTIONNAM). In our selection case, we defined
-the `--hello' and `--bye' options as valid options. If no one of them
-is provided as second command-line argument, the `*' option is
-evaluated instead.
+ The OPTIONNAM global variable is defined in `cli.sh' function script
+and contains the value passed before the equal sign (i.e., `=') in the
+second command-line argument of `centos-art.sh' script. For example, if
+the second command-line argument is `--hello='World'', the value of
+OPTIONNAM variable would be `--hello'. Using this configuration let us
+deside which action to perform based on the option name passed to
+`centos-art.sh' script as second argument.
+
+ The `greet' specific function makes available two valid greetings
+through `--hello' and `--bye' options. If no one of them is provided
+as second command-line argument, the `*' case is evaluated instead.
- The `*' option and the two following lines, should always be present
-in `*_getActions.sh' function scripts, no matter what specific
+ The `*' case and its two further lines should always be present in
+`_getActions.sh' function scripts, no matter what specific
functionality you are creating. This convenction helps the user to find
-out documentation about the current functionality in use. Of course,
-function documentation needs to be created first (*note trunk Scripts
-Bash Functions Help::, to know how), and that task is something you
---as author of specific functions-- probably want to do personally.
+out documentation about current functionality in use.
- Following with our example, the `greet_doHello', and `greet_doBye'
-function definitions are the core of `greet' specific functionality.
-In such function definitions is where we define what our function realy
-does --output different kinds of greetings, in the sake of our
-example--.
+ The `greet_doHello' and `greet_doBye' function definitions are the
+core of `greet' specific functionality. In such function definitions
+we set what our `greet' function really does: to output different kinds
+of greetings.
function greet_doHello {
@@ -2742,16 +2734,15 @@ function greet_doBye {
stored inside `greet''s function directory path (i.e.
`trunk/Scripts/Bash/Functions/Greet').
- In the examples above, we use the OPTIONVAL global variable. The
-OPTIONVAL variable is defined in `cli.sh' function script and contains
-the value passed after the equal sign (i.e., `=') in the second
-command-line argument of `centos-art.sh' script. For example, if the
-second command-line argument is `--hello='World'', the value of
+ The OPTIONVAL global variable is defined in `cli.sh' function script
+and contains the value passed after the equal sign (i.e., `=') in the
+second command-line argument of `centos-art.sh' script. For example, if
+the second command-line argument is `--hello='World'', the value of
OPTIONVAL variable would be `World' without quotes.
Let's see how `greet' specific functionality files are organzied
-under `greet''s function directory. To see file organization, we use
-the `tree' command:
+under `greet''s function directory. To see file organization we use the
+`tree' command:
trunk/Scripts/Bash/Functions/Greet
@@ -2760,9 +2751,10 @@ trunk/Scripts/Bash/Functions/Greet
|-- greet_getActions.sh
`-- greet.sh
- To try the `greet' specific functionality, pass `greet' string as
-first argument to `centos-art.sh' script, and any of the valid options
-as second argument. Some examples are illustrated below:
+ To try the `greet' specific functionality, pass the function name
+(i.e., `greet') as first argument to `centos-art.sh' script, and any of
+the valid options as second argument. Some examples are illustrated
+below:
[centos@projects ~]$ centos-art greet --hello='World'
@@ -2771,28 +2763,45 @@ Hello World
Goodbye World
[centos@projects ~]$
- The word `World' in the examples above, can be anything. In fact,
-change it to have a little fun :).
+ The word `World' in the examples above can be anything. In fact,
+change it to have a little fun.
Now that we have a specific function that works as we expect, it is
-time to document it. To document `greet' specific functionality, we
-need to use its directory path and the `help' functionality (*note
-trunk Scripts Bash Functions Help::) of `centos-art.sh' script, just as
-the following command illustrates:
+time to document it. To document `greet' specific functionality, we use
+its directory path and the `help' functionality (*note trunk Scripts
+Bash Functions Help::) of `centos-art.sh' script, just as the following
+command illustrates:
centos-art help --edit=trunk/Scripts/Bash/Functions/Greet
+ Now that we have documented our function, it is time to translate its
+output messages to different languages. To translate specific
+functionality output messages to different languages we use the
+`locale' functionality (*note trunk Scripts Bash Functions Locale::) of
+`centos-art.sh' script, just as the following command illustrates:
+
+
+centos-art locale --edit
+
+ *Warning* To translate output messages in different languages,
+ your system locale information --as in `LANG' environment
+ variable-- must be set to that locale you want to produce
+ translated messages for. For example, if you want to produce
+ translated messages for Spanish language, your system locale
+ information must be set to `es_ES.UTF-8' or similar.
+
Well, it seems that our example is rather complete by now.
- In `greet' example we've described so far, we only use the
-`cli_printMessage' global function in action specific functions, but
-more interesting things can be achieved inside them. For example, if
-you pass a directory path as second argument option value, you could
-retrive a list of files from therein, and process them. If the list of
-files turns too long, you could add the third argument in the form
-`--filter='regex'' and reduce the amount of files to process using a
-regular expression pattern.
+ In `greet' function example we've described so far, we only use
+`cli_printMessage' global function in action specific function
+definitions in order to print a message simply, but more interesting
+things can be achieved inside action specific function definitions.
+For example, if you pass a directory path as second argument option
+value, you could retrive a list of files from therein, and process
+them. If the list of files turns too long, you could add the third
+argument in the form `--filter='regex'' and reduce the amount of files
+to process using a regular expression pattern.
This description may serve you as an introduction to understand how
specific functionalities work inside `centos-art.sh' script. With some
@@ -2800,7 +2809,7 @@ of luck this introduction will also serve you as motivation to create
your own specific functionalities.
By the way, the `greet' functionality doesn't exist inside
-`centos-art.sh' script. Would you like to create it?
+`centos-art.sh' script yet. Would you like to create it?
3.35.3 Usage
------------
@@ -2898,7 +2907,7 @@ for you to use inside specific functions:
When TYPE is not specified, `cli_checkFiles' verifies FILE
existence, no matter what kind of file it be. If TYPE is
- specified, it can take one of the following values:
+ specified, use one of the following values:
`d'
`directory'
@@ -2920,34 +2929,33 @@ for you to use inside specific functions:
When ACTION is not specified, `cli_checkFiles' function uses
`Checking' as default action message. The action message is used
- on left-column as description for verification action. It may be
+ on left-column as description to action verification. It may be
cases where you need to change default action message with your
- own. In that cases remember to use the `"`gettext "Your message"`"'
- construction in order for `gettext' to know about it. This way
- your action message can be translated to other languages too.
-
- By default `cli_checkFiles' output information about FILE on the
- right column. When OPTIONS is specified, default behaivour is
- modified as specified in OPTIONS. The OPTIONS can take any of the
- following options:
+ own. In those cases remember to use the `"`gettext "Your
+ message"`"' construction in order for `gettext' to know about it.
+ This way your action message can be translated to other languages
+ too. By default `cli_checkFiles' output information about FILE on
+ the right column.
+
+ When OPTIONS is specified, default behaivour is modified as
+ specified in OPTIONS. The OPTIONS can take any of the following
+ options:
`--quiet'
- If this option is specified, `cli_checkFiles' supresses
- verification output. This option is useful if you only want
- to do file verifications but don't want to output any
- information about it.
-
-
+ The `--quiet' option supresses verification output.
cli_checkFiles $FILE 'f' '' '--quiet'
if [[ $? -eq 0 ]];then
- echo "File exists."
+ INFO="`gettext "The file exists."`"
else
- echo "File doesn't exist"
+ INFO="`gettext "The file doesn't exist."`"
fi
+ Use `--quiet' option whenever you want to do file
+ verifications but don't want to output any information about
+ it.
-- Function: cli_getCountryCodes [FILTER]
`cli_getCountryCodes' function outputs a list with country codes
as defined in ISO3166 standard. When FILTER is provided,
- `cli_getCountryCodes' outpus country codes that match FILTER
+ `cli_getCountryCodes' outputs country codes that match FILTER
regular expression pattern.
-- Function: cli_getCountryNames [FILTER]
@@ -2957,10 +2965,27 @@ for you to use inside specific functions:
FILTER, exactly, is returned.
-- Function: cli_getCurrentLocale
- `cli_getCurrentLocale' function checks LANG environment variable
- and returns the current locale from more specific to less
- specific. For example, if the locale `en_GB' is the current one,
- it should be used instead of just `en'.
+ `cli_getCurrentLocale' function uses `LANG' environment variable
+ to build a locale pattern that is later applied to
+ `cli_getLocales' function output in order to return the current
+ locale that `centos-art.sh' script works with.
+
+ The current locale information, returned by
+ `cli_getCurrentLocale', is output from more specific to less
+ specific. For example, if `en_GB' locale exists in
+ `cli_getLocales' function output, the `en_GB' locale would take
+ precedence before `en' locale.
+
+ Locale precedence selection is quite important in order to define
+ the locale type we use for message translations. For example, if
+ `en_GB' is used, we are also saying that no common language
+ specification is used for English language (i.e., `en'). Instead,
+ we are using English non-common country-specific language
+ specifications like `en_AU', `en_BW', `en_GB', `en_US', etc., for
+ message translations.
+
+ Use `cli_getCurrentLocale' function to know what current locale
+ information to use inside `centos-art.sh' script.
-- Function: cli_getLangCodes [FILTER]
`cli_getLangCodes' function outputs a list of language codes as
@@ -2968,37 +2993,77 @@ for you to use inside specific functions:
`cli_getLangCodes' outputs language codes that match FILTER
regular expression pattern.
- -- Function: cli_getLangNames
- `cli_getLangNames' function reads one language locale code in the
+ -- Function: cli_getLangName [FILTER]
+ `cli_getLangName' function reads one language locale code in the
format LL_CC and outputs its language name as defined in ISO639
- standard. If filter is specified, just the language name that
+ standard. If FILTER is specified, just the language name that
matches FILTER, exactly, is returned.
-- Function: cli_getLocales
- `cli_getLocales' function outputs locale codes in LL and LL_CC
- format. Combine both ISO639 and ISO3166 specification in order to
- build the final locale list. The `cli_getLocales' function defines
- which translation locales are supported inside CentOS Artwork
- Repository.
-
- -- Function: cli_getRepoNames
- `cli_getRepoNames' function sets naming convenction inside CentOS
- Artowrk Repository. As convenction, regular files are written in
- lower case and directories are written in CamelCase. Use this
- function to sanitate the name of regular files and directories you
- work with.
+ `cli_getLocales' defines what locale codes does `centos-art.sh'
+ script support.
+
+ Occasionally, you use `cli_getLocales' function to add locale
+ information in non-common country-specific language (`LL_CC')
+ format for those languages (e.g., `bn_IN', `pt_BR', etc.) which
+ locale differences cannot be solved using common language
+ specifications (`LL') into one unique common locale specification
+ (e.g., `bn', `pt', etc.).
+
+ -- Function: cli_getRepoName NAME TYPE
+ `cli_getRepoName' function sets file names convenctions inside
+ `centos-art.sh' script. File name convenctions, as set by
+ `cli_getRepoName', are used by specific functionalities of
+ `centos-art.sh' script that rely on repository file system
+ organization to do the work they were initially conceived to do.
+ Consider `cli_getRepoName' function as a place to manage file name
+ convenction centrally.
+
+ *Warning* `cli_getRepoName' function doesn't verify file or
+ directory existence, for that purpose use `cli_checkFiles'
+ function instead.
+
+ The NAME variable contains the file name or directory name you
+ want to sanitate.
+
+ The TYPE variable can be one of the following values:
+ `d'
+ `directory'
+ Sanitate directory NAMEs.
+
+ `f'
+
+ `regular-file'
+ Sanitate regular file NAMEs.
+
+ Use `cli_getRepoName' function to sanitate file names and
+ directory names before their utilization.
+
+ Use `cli_getRepoName' when you need to change file name
+ convenction inside `centos-art.sh' script. When changing file name
+ convenctions inside `cli_getRepoName' what you are really changing
+ is the way functions interpret repository file system
+ organization. In order to a complete file name convenction change,
+ you also need to change file names and directory names inside
+ repository file system organization, just as you did in
+ `cli_getRepoName' function.
+
+ *Note* *Note trunk Scripts Bash Functions Path::, for more
+ information on how to rename files and directories massively
+ inside repository file system organization.
-- Function: cli_getThemeName
- `cli_getThemeName' function manipulates the current absolute path
- to extract the theme name from it. If there is no theme in the
- path, this function returns an empty string.
+ `cli_getThemeName' function evaluates OPTIONVAL global variable to
+ extract theme name from it. In order for `cli_getThemeName'
+ function to extract theme name correctly, the OPTIONVAL variable
+ must contain a directory path under
+ `trunk/Identity/Themes/Motifs/' directory structure. Otherwise,
+ `cli_getThemeName' returns an empty string.
-- Function: cli_printMessage MESSAGE [FORMAT]
`cli_printMessage' function outputs information in predifined
formats. The `cli_printMessage' function is the standard way to
- output information inside `centos-art.sh' script. Use this
- function whenever you need to output information from
- `centos-art.sh'.
+ output information inside `centos-art.sh' script.
When FORMAT is not specified, `cli_printMessage' outputs
information just as it was passed in MESSAGE variable. Otherwise,
@@ -3121,6 +3186,8 @@ for you to use inside specific functions:
Two-columns format definition is taken from
`trunk/Scripts/Bash/Styles/output_forTwoColumns.awk' file.
+ Use `cli_printMessage' function whenever you need to output
+ information from `centos-art.sh'.
3.35.3.3 Specific functions
...........................
@@ -3196,22 +3263,22 @@ create a portable object file for it, in the location
The CLI_LANG variable discribes the locale language used to output
messages inside `centos-art' command. The locale language used inside
-`centos-art' command is taken from the LANG environment variable. The
-CLI_LANG variable has the `LL_CC' format, where `LL' is a language code
-from the ISO-639 standard, and `CC' a country code from the ISO-3166
-standard.
+`centos-art' command is taken from the `LANG' environment variable.
+The CLI_LANG variable has the `LL_CC' format, where `LL' is a language
+code from the ISO-639 standard, and `CC' a country code from the
+ISO-3166 standard.
- The LANG environment variable is set when you do log in to your
+ The `LANG' environment variable is set when you do log in to your
system. If you are using a graphical session, change language to your
-native language and do login. That would set and exoprt the LANG
+native language and do login. That would set and exoprt the `LANG'
environment variable to the correct value. On the other side, if you
are using a text session edit your `~/.bash_profile' file to set and
-export the LANG environment variable to your native locale as defines
+export the `LANG' environment variable to your native locale as defines
the `locale -a' command output; do logout, and do login again.
- At this point, the LANG environment variable has the appropriate
+ At this point, the `LANG' environment variable has the appropriate
value you need, in order to translate `centos-art.sh' messages to your
-native language (the one set in LANG environment variable).
+native language (the one set in `LANG' environment variable).
With the `$CLI_LANG/$CLI_LANG.po' file up to date, the `centos-art'
opens it for you to update translation strings. The `centos-art'
@@ -3245,7 +3312,7 @@ following files:
`centos-art locale --edit'
Use this command to translate command-line interface output
messages in the current system locale you are using (as specified
- in LANG environment variable).
+ in `LANG' environment variable).
`centos-art locale --list'
Use this command to see the command-line interface locale report.
@@ -3274,15 +3341,13 @@ repository file system syncronized with documentation file system.
This feature is not supported yet.
-`centos-art path 'path/to/dir/' --copy-to='path/to/dir''
-
-`centos-art path 'path/to/dir/' --copy-to='path/to/dir/filename''
-
-`centos-art path 'path/to/dir/' --move-to='path/to/dir''
-
-`centos-art path 'path/to/dir/' --move-to='path/to/dir/filename''
+`centos-art path --rename='old new' --filter='d''
+ Rename all occurences of `old' directory names with `new'
+ directory name, recursively under the current location.
-`centos-art path 'path/to/dir/' --remove'
+`centos-art path --rename='old new' --filter='f''
+ Rename all occurences of `old' file names with `new' file name,
+ recursively under the current location.
3.39.4 See also
---------------
@@ -3656,7 +3721,7 @@ functionality of `centos-art.sh' script doesn't modify your
The `verify' functionality of `centos-art.sh' script evaluates the
following environment variables:
-EDITOR
+`EDITOR'
Default text editor.
If EDITOR environment variable is not set --or it uses one value
@@ -3669,7 +3734,7 @@ EDITOR
messages, translation files, configuration files, script files,
etc.)
-TZ
+`TZ'
Default time zone representation.
Time representation inside repository server is set to Coordinated
@@ -3696,15 +3761,15 @@ TZ
correct time information of your zone, taking UTC
representation as reference.
-TEXTDOMAIN
+`TEXTDOMAIN'
Default domain used to retrieve translated messages. This value is
set in `initFunctions.sh' and shouldn't be changed.
-TEXTDOMAINDIR
+`TEXTDOMAINDIR'
Default directory used to retrieve translated messages. This value
is set in `initFunctions.sh' and shouldn't be changed.
-LANG
+`LANG'
Default locale information. This value is set when you start your
session and can be changed using the "locale" functionality of
`centos-art.sh' script (*note trunk Scripts Bash Functions
@@ -4811,23 +4876,23 @@ Index
*****
branches: See 1. (line 368)
-Common translation files: See 3.48.2.5. (line 4235)
-How to render brands' translation files: See 3.50.3. (line 4540)
-How to render fonts' translation files: See 3.52.3. (line 4617)
-How to render translation files: See 3.48.3. (line 4405)
-Specific translation files: See 3.48.2.6. (line 4260)
+Common translation files: See 3.48.2.5. (line 4300)
+How to render brands' translation files: See 3.50.3. (line 4605)
+How to render fonts' translation files: See 3.52.3. (line 4682)
+How to render translation files: See 3.48.3. (line 4470)
+Specific translation files: See 3.48.2.6. (line 4325)
tags: See 2. (line 371)
-Template translation files: See 3.48.2.4. (line 4065)
-Translation brands file names: See 3.50.2.1. (line 4497)
-Translation configuration scripts: See 3.48.2.8. (line 4294)
-Translation entries: See 3.48.2.1. (line 3881)
-Translation files: See 3.48.2.3. (line 3997)
-Translation markers: See 3.48.2.2. (line 3962)
-Translation paths: See 3.48.2.1. (line 3881)
+Template translation files: See 3.48.2.4. (line 4130)
+Translation brands file names: See 3.50.2.1. (line 4562)
+Translation configuration scripts: See 3.48.2.8. (line 4359)
+Translation entries: See 3.48.2.1. (line 3946)
+Translation files: See 3.48.2.3. (line 4062)
+Translation markers: See 3.48.2.2. (line 4027)
+Translation paths: See 3.48.2.1. (line 3946)
Translation pre-rendering configuration scripts:See 3.48.2.8.
- (line 4294)
-Translation rendering: See 3.48.2.7. (line 4283)
-Translation rendering default functionality: See 3.48.2.9. (line 4380)
+ (line 4359)
+Translation rendering: See 3.48.2.7. (line 4348)
+Translation rendering default functionality: See 3.48.2.9. (line 4445)
trunk: See 3. (line 374)
trunk Identity: See 3.1. (line 377)
trunk Identity Brands: See 3.2. (line 797)
@@ -4870,30 +4935,30 @@ trunk Manuals: See 3.32. (line 2353)
trunk Scripts: See 3.33. (line 2407)
trunk Scripts Bash: See 3.34. (line 2431)
trunk Scripts Bash Functions: See 3.35. (line 2543)
-trunk Scripts Bash Functions Help: See 3.36. (line 3137)
-trunk Scripts Bash Functions Html: See 3.37. (line 3158)
-trunk Scripts Bash Functions Locale: See 3.38. (line 3179)
-trunk Scripts Bash Functions Path: See 3.39. (line 3259)
-trunk Scripts Bash Functions Render: See 3.40. (line 3293)
-trunk Scripts Bash Functions Render Config: See 3.41. (line 3314)
-trunk Scripts Bash Functions Shell: See 3.42. (line 3492)
-trunk Scripts Bash Functions Svg: See 3.43. (line 3513)
-trunk Scripts Bash Functions Verify: See 3.44. (line 3557)
-trunk Scripts Bash Locale: See 3.45. (line 3765)
-trunk Scripts Perl: See 3.46. (line 3794)
-trunk Scripts Python: See 3.47. (line 3811)
-trunk Translations: See 3.48. (line 3832)
-trunk Translations Identity: See 3.49. (line 4435)
-trunk Translations Identity Brands: See 3.50. (line 4456)
-trunk Translations Identity Brands Tpl: See 3.51. (line 4551)
-trunk Translations Identity Fonts: See 3.52. (line 4566)
-trunk Translations Identity Models: See 3.53. (line 4633)
-trunk Translations Identity Release: See 3.54. (line 4648)
-trunk Translations Identity Themes: See 3.55. (line 4663)
-trunk Translations Identity Themes Backgrounds:See 3.56. (line 4678)
+trunk Scripts Bash Functions Help: See 3.36. (line 3204)
+trunk Scripts Bash Functions Html: See 3.37. (line 3225)
+trunk Scripts Bash Functions Locale: See 3.38. (line 3246)
+trunk Scripts Bash Functions Path: See 3.39. (line 3326)
+trunk Scripts Bash Functions Render: See 3.40. (line 3358)
+trunk Scripts Bash Functions Render Config: See 3.41. (line 3379)
+trunk Scripts Bash Functions Shell: See 3.42. (line 3557)
+trunk Scripts Bash Functions Svg: See 3.43. (line 3578)
+trunk Scripts Bash Functions Verify: See 3.44. (line 3622)
+trunk Scripts Bash Locale: See 3.45. (line 3830)
+trunk Scripts Perl: See 3.46. (line 3859)
+trunk Scripts Python: See 3.47. (line 3876)
+trunk Translations: See 3.48. (line 3897)
+trunk Translations Identity: See 3.49. (line 4500)
+trunk Translations Identity Brands: See 3.50. (line 4521)
+trunk Translations Identity Brands Tpl: See 3.51. (line 4616)
+trunk Translations Identity Fonts: See 3.52. (line 4631)
+trunk Translations Identity Models: See 3.53. (line 4698)
+trunk Translations Identity Release: See 3.54. (line 4713)
+trunk Translations Identity Themes: See 3.55. (line 4728)
+trunk Translations Identity Themes Backgrounds:See 3.56. (line 4743)
trunk Translations Identity Themes Distro Anaconda Progress:See 3.57.
- (line 4699)
-trunk Translations Identity Widgets: See 3.58. (line 4792)
+ (line 4764)
+trunk Translations Identity Widgets: See 3.58. (line 4857)
List of Figures
***************
diff --git a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions.texi b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions.texi
index f12535c..564cc63 100644
--- a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions.texi
+++ b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions.texi
@@ -17,7 +17,7 @@ The specific functions of @file{centos-art.sh} script are organized
inside specific directories under @file{trunk/Scripts/Bash/Functions}
location. Each specific function directory should be named as the
function it represents, with the first letter in uppercase. For
-example, if the function name is @samp{render}, the specific function
+example, if the function name is @code{render}, the specific function
directory for it would be @samp{trunk/Scripts/Bash/Functions/Render}.
To better understand how specific functions of @file{centos-art.sh}
@@ -41,11 +41,11 @@ advantage can be taken from them. Global functions are stored
immediatly under @file{trunk/Scripts/Bash/Functions} directory in
files begining with @samp{cli} prefix.
-OK, let's begin with our specific functionality example.
+OK, let's begin with our @code{greet} specific functionality example.
What function name do we use? Well, lets use @code{greet}. Note that
@samp{hello} is not a verb, but an expression, a kind of greeting, an
-interjection specifically. In contrast, @code{greet} is a verb and
+interjection specifically. In contrast, @samp{greet} is a verb and
describes what we do when we say @samp{Hello!}, @samp{Hi!}, and so on.
So far, we've gathered the following function information:
@@ -56,22 +56,15 @@ Path: trunk/Scripts/Bash/Functions/Greet
File: trunk/Scripts/Bash/Functions/Greet/greet.sh
@end verbatim
-@quotation
-@strong{Note} Note how function name is used as reference to define
-function path, function script, and function definition inside
-function script.
-@end quotation
-
-As consistency convenction, files related to @code{greet}
-functionality are stored under its own function path. The
-@file{greet.sh} function script is the first file @file{centos-art.sh}
-script loads when the @code{greet} functionality is called using
-commands like @samp{centos-art greet --hello='World'}.
-
+The @file{greet.sh} function script is the first file
+@file{centos-art.sh} script loads when the @samp{greet} functionality
+is called using commands like @samp{centos-art greet --hello='World'}.
The @file{greet.sh} function script contains the @code{greet} function
-definition. Inside @file{centos-art.sh} script, each function
-definition has its own top commentary, followed by one blank line, and
-then one function defintion below it.
+definition.
+
+Inside @file{centos-art.sh} script, each function definition has its
+own top commentary, followed by one blank line, and then one function
+defintion below it.
The function top commentary contains a brief description about what
the function does, one-line for copyright note ---with your personal
@@ -79,8 +72,10 @@ information---, the license under which the function source code is
released ---the @file{centos-art.sh} script is released as GPL, so do
all its functions---, and the subversion @code{$Id$} keyword---which
is later expanded when we do @command{svn propset} over
-@file{greet.sh} file---. In our function example, the @file{greet.sh}
-top commentary would look like the following:
+@file{greet.sh} file---.
+
+In our @code{greet} function example, the @file{greet.sh} top
+commentary would look like the following:
@verbatim
#!/bin/bash
@@ -111,14 +106,7 @@ top commentary would look like the following:
# ----------------------------------------------------------------------
@end verbatim
-The @code{greet} function defines variables that will be available
-along @code{greet} function execution environment. Later, as final
-definition, the @code{greet} function calls the
-@file{greet_getActions} function defined inside
-@file{greet_getActions.sh} function script.
-
-In our example, the @code{greet} function definition would look as
-follows:
+The @code{greet} function definition would look as follows:
@verbatim
function greet {
@@ -131,16 +119,17 @@ function greet {
}
@end verbatim
-This time we didn't use global variable definitions for @code{greet}
-execution environment, so we left the section empty.
+The first definition inside @code{greet} function, are global
+variables that will be available along @code{greet} function execution
+environment. This time we didn't use global variable definitions for
+@code{greet} function execution environment, so we left that section
+empty.
-The @code{greet_getActions} function defines the command-line
-interface of @code{greet} functionality. The command-line interface
-defines what to do with arguments passed to @file{centos-art.sh}
-script once @code{greet} has been specified as second argument.
-
-In our function example, the @code{greet_getActions} function
-definition would look like the following:
+Later, we call @code{greet_getActions} function to define the
+command-line interface of @code{greet} functionality. The command-line
+interface sets what we can do with arguments passed to
+@file{centos-art.sh} script, once @option{greet} has been specified as
+first argument in the command-line.
@verbatim
function greet_getActions {
@@ -164,26 +153,29 @@ function greet_getActions {
}
@end verbatim
-In the above example, we've defined a selection case based on second
-argument's option name (@var{OPTIONNAM}). In our selection case, we
-defined the @option{--hello} and @option{--bye} options as valid
-options. If no one of them is provided as second command-line
-argument, the @option{*} option is evaluated instead.
-
-The @samp{*} option and the two following lines, should always be
-present in @file{*_getActions.sh} function scripts, no matter what
-specific functionality you are creating. This convenction helps the
-user to find out documentation about the current functionality in use.
-Of course, function documentation needs to be created first
-(@pxref{trunk Scripts Bash Functions Help}, to know how), and that
-task is something you ---as author of specific functions--- probably
-want to do personally.
-
-Following with our example, the @code{greet_doHello}, and
-@code{greet_doBye} function definitions are the core of @code{greet}
-specific functionality. In such function definitions is where we
-define what our function realy does ---output different kinds of
-greetings, in the sake of our example---.
+The @var{OPTIONNAM} global variable is defined in @file{cli.sh}
+function script and contains the value passed before the equal sign
+(i.e., @samp{=}) in the second command-line argument of
+@file{centos-art.sh} script. For example, if the second command-line
+argument is @option{--hello='World'}, the value of @var{OPTIONNAM}
+variable would be @samp{--hello}. Using this configuration let us
+deside which action to perform based on the option name passed to
+@file{centos-art.sh} script as second argument.
+
+The @code{greet} specific function makes available two valid greetings
+through @option{--hello} and @option{--bye} options. If no one of
+them is provided as second command-line argument, the @samp{*} case is
+evaluated instead.
+
+The @samp{*} case and its two further lines should always be present
+in @file{_getActions.sh} function scripts, no matter what specific
+functionality you are creating. This convenction helps the user to
+find out documentation about current functionality in use.
+
+The @code{greet_doHello} and @code{greet_doBye} function definitions
+are the core of @code{greet} specific functionality. In such function
+definitions we set what our @code{greet} function really does: to
+output different kinds of greetings.
@verbatim
function greet_doHello {
@@ -211,16 +203,15 @@ Both @file{greet_doHello.sh} and @file{greet_doBye.sh} function
scripts are stored inside @code{greet}'s function directory path (i.e.
@file{trunk/Scripts/Bash/Functions/Greet}).
-In the examples above, we use the @var{OPTIONVAL} global variable.
-The @var{OPTIONVAL} variable is defined in @file{cli.sh} function
-script and contains the value passed after the equal sign (i.e.,
-@samp{=}) in the second command-line argument of @file{centos-art.sh}
-script. For example, if the second command-line argument is
-@option{--hello='World'}, the value of @var{OPTIONVAL} variable would
-be @samp{World} without quotes.
+The @var{OPTIONVAL} global variable is defined in @file{cli.sh}
+function script and contains the value passed after the equal sign
+(i.e., @samp{=}) in the second command-line argument of
+@file{centos-art.sh} script. For example, if the second command-line
+argument is @option{--hello='World'}, the value of @var{OPTIONVAL}
+variable would be @samp{World} without quotes.
Let's see how @code{greet} specific functionality files are organzied
-under @code{greet}'s function directory. To see file organization, we
+under @code{greet}'s function directory. To see file organization we
use the @command{tree} command:
@verbatim
@@ -231,10 +222,10 @@ trunk/Scripts/Bash/Functions/Greet
`-- greet.sh
@end verbatim
-To try the @code{greet} specific functionality, pass @code{greet}
-string as first argument to @file{centos-art.sh} script, and any of
-the valid options as second argument. Some examples are illustrated
-below:
+To try the @code{greet} specific functionality, pass the function name
+(i.e., @samp{greet}) as first argument to @file{centos-art.sh} script,
+and any of the valid options as second argument. Some examples are
+illustrated below:
@verbatim
[centos@projects ~]$ centos-art greet --hello='World'
@@ -244,12 +235,12 @@ Goodbye World
[centos@projects ~]$
@end verbatim
-The word @samp{World} in the examples above, can be anything. In fact,
-change it to have a little fun :).
+The word @samp{World} in the examples above can be anything. In fact,
+change it to have a little fun.
Now that we have a specific function that works as we expect, it is
time to document it. To document @code{greet} specific functionality,
-we need to use its directory path and the @code{help} functionality
+we use its directory path and the @code{help} functionality
(@pxref{trunk Scripts Bash Functions Help}) of @file{centos-art.sh}
script, just as the following command illustrates:
@@ -257,11 +248,32 @@ script, just as the following command illustrates:
centos-art help --edit=trunk/Scripts/Bash/Functions/Greet
@end verbatim
+Now that we have documented our function, it is time to translate its
+output messages to different languages. To translate specific
+functionality output messages to different languages we use the
+@code{locale} functionality (@pxref{trunk Scripts Bash Functions
+Locale}) of @file{centos-art.sh} script, just as the following command
+illustrates:
+
+@verbatim
+centos-art locale --edit
+@end verbatim
+
+@quotation
+@strong{Warning} To translate output messages in different languages,
+your system locale information ---as in @env{LANG} environment
+variable--- must be set to that locale you want to produce translated
+messages for. For example, if you want to produce translated messages
+for Spanish language, your system locale information must be set to
+@samp{es_ES.UTF-8} or similar.
+@end quotation
+
Well, it seems that our example is rather complete by now.
-In @code{greet} example we've described so far, we only use the
-@command{cli_printMessage} global function in action specific
-functions, but more interesting things can be achieved inside them.
+In @code{greet} function example we've described so far, we only use
+@command{cli_printMessage} global function in action specific function
+definitions in order to print a message simply, but more interesting
+things can be achieved inside action specific function definitions.
For example, if you pass a directory path as second argument option
value, you could retrive a list of files from therein, and process
them. If the list of files turns too long, you could add the third
@@ -274,7 +286,7 @@ some of luck this introduction will also serve you as motivation to
create your own specific functionalities.
By the way, the @code{greet} functionality doesn't exist inside
-@file{centos-art.sh} script. Would you like to create it?
+@file{centos-art.sh} script yet. Would you like to create it?
@subsection Usage
@@ -380,7 +392,7 @@ verification as specified in @var{TYPE}.
When @var{TYPE} is not specified, @code{cli_checkFiles} verifies
@var{FILE} existence, no matter what kind of file it be. If
-@var{TYPE} is specified, it can take one of the following values:
+@var{TYPE} is specified, use one of the following values:
@table @option
@item d
@@ -398,40 +410,39 @@ When @var{FILE} is neither a regular file or a symbolic link,
@code{cli_checkFiles} considers @var{FILE} as unexistent file.
@end table
-When @var{ACTION} is not specified, @code{cli_checkFiles} function uses
-@samp{Checking} as default action message. The action message is used
-on left-column as description for verification action. It may be cases
-where you need to change default action message with your own. In that
-cases remember to use the @code{"`gettext "Your message"`"}
+When @var{ACTION} is not specified, @code{cli_checkFiles} function
+uses @samp{Checking} as default action message. The action message is
+used on left-column as description to action verification. It may be
+cases where you need to change default action message with your own.
+In those cases remember to use the @code{"`gettext "Your message"`"}
construction in order for @command{gettext} to know about it. This way
-your action message can be translated to other languages too.
+your action message can be translated to other languages too. By
+default @code{cli_checkFiles} output information about @var{FILE} on
+the right column.
-By default @code{cli_checkFiles} output information about @var{FILE}
-on the right column. When @var{OPTIONS} is specified, default behaivour
-is modified as specified in @var{OPTIONS}. The @var{OPTIONS} can take
-any of the following options:
-@table @option
+When @var{OPTIONS} is specified, default behaivour is modified as
+specified in @var{OPTIONS}. The @var{OPTIONS} can take any of the
+following options: @table @option
@item --quiet
-If this option is specified, @code{cli_checkFiles} supresses
-verification output. This option is useful if you only want to do
-file verifications but don't want to output any information about it.
-
+The @option{--quiet} option supresses verification output.
@verbatim
cli_checkFiles $FILE 'f' '' '--quiet'
if [[ $? -eq 0 ]];then
- echo "File exists."
+ INFO="`gettext "The file exists."`"
else
- echo "File doesn't exist"
+ INFO="`gettext "The file doesn't exist."`"
fi
@end verbatim
+Use @option{--quiet} option whenever you want to do file verifications
+but don't want to output any information about it.
@end table
@end defun
@defun cli_getCountryCodes [FILTER]
@code{cli_getCountryCodes} function outputs a list with country codes
as defined in ISO3166 standard. When @var{FILTER} is provided,
-@code{cli_getCountryCodes} outpus country codes that match
+@code{cli_getCountryCodes} outputs country codes that match
@var{FILTER} regular expression pattern.
@end defun
@@ -443,10 +454,27 @@ ISO3166. If filter is specified, just the country name that matches
@end defun
@defun cli_getCurrentLocale
-@code{cli_getCurrentLocale} function checks @var{LANG} environment
-variable and returns the current locale from more specific to less
-specific. For example, if the locale @samp{en_GB} is the current one,
-it should be used instead of just @samp{en}.
+@code{cli_getCurrentLocale} function uses @env{LANG} environment
+variable to build a locale pattern that is later applied to
+@code{cli_getLocales} function output in order to return the current
+locale that @file{centos-art.sh} script works with.
+
+The current locale information, returned by
+@code{cli_getCurrentLocale}, is output from more specific to less
+specific. For example, if @samp{en_GB} locale exists in
+@code{cli_getLocales} function output, the @samp{en_GB} locale would
+take precedence before @samp{en} locale.
+
+Locale precedence selection is quite important in order to define the
+locale type we use for message translations. For example, if
+@samp{en_GB} is used, we are also saying that no common language
+specification is used for English language (i.e., @samp{en}). Instead,
+we are using English non-common country-specific language
+specifications like @samp{en_AU}, @samp{en_BW}, @samp{en_GB},
+@samp{en_US}, etc., for message translations.
+
+Use @code{cli_getCurrentLocale} function to know what current locale
+information to use inside @file{centos-art.sh} script.
@end defun
@defun cli_getLangCodes [FILTER]
@@ -456,40 +484,85 @@ defined in ISO639 standard. When @var{FILTER} is provided,
regular expression pattern.
@end defun
-@defun cli_getLangNames
-@code{cli_getLangNames} function reads one language locale code in the
+@defun cli_getLangName [FILTER]
+@code{cli_getLangName} function reads one language locale code in the
format LL_CC and outputs its language name as defined in ISO639
-standard. If filter is specified, just the language name that matches
-@var{FILTER}, exactly, is returned.
+standard. If @var{FILTER} is specified, just the language name that
+matches @var{FILTER}, exactly, is returned.
@end defun
@defun cli_getLocales
-@code{cli_getLocales} function outputs locale codes in LL and LL_CC
-format. Combine both ISO639 and ISO3166 specification in order to
-build the final locale list. The @code{cli_getLocales} function
-defines which translation locales are supported inside CentOS Artwork
-Repository.
+@code{cli_getLocales} defines what locale codes does
+@file{centos-art.sh} script support.
+
+Occasionally, you use @code{cli_getLocales} function to add locale
+information in non-common country-specific language (@samp{LL_CC})
+format for those languages (e.g., @samp{bn_IN}, @samp{pt_BR}, etc.)
+which locale differences cannot be solved using common language
+specifications (@samp{LL}) into one unique common locale specification
+(e.g., @samp{bn}, @samp{pt}, etc.).
@end defun
-@defun cli_getRepoNames
-@code{cli_getRepoNames} function sets naming convenction inside CentOS
-Artowrk Repository. As convenction, regular files are written in lower
-case and directories are written in CamelCase. Use this function to
-sanitate the name of regular files and directories you work with.
+@defun cli_getRepoName NAME TYPE
+@code{cli_getRepoName} function sets file names convenctions inside
+@file{centos-art.sh} script. File name convenctions, as set by
+@code{cli_getRepoName}, are used by specific functionalities of
+@file{centos-art.sh} script that rely on repository file system
+organization to do the work they were initially conceived to do.
+Consider @code{cli_getRepoName} function as a place to manage file
+name convenction centrally.
+
+@quotation
+@strong{Warning} @code{cli_getRepoName} function doesn't verify file
+or directory existence, for that purpose use @code{cli_checkFiles}
+function instead.
+@end quotation
+
+The @var{NAME} variable contains the file name or directory name you
+want to sanitate.
+
+The @var{TYPE} variable can be one of the following values:
+@table @option
+@item d
+@itemx directory
+Sanitate directory @var{NAME}s.
+@item f
+@item regular-file
+Sanitate regular file @var{NAME}s.
+@end table
+
+Use @code{cli_getRepoName} function to sanitate file names and
+directory names before their utilization.
+
+Use @code{cli_getRepoName} when you need to change file name
+convenction inside @file{centos-art.sh} script. When changing file
+name convenctions inside @code{cli_getRepoName} what you are really
+changing is the way functions interpret repository file system
+organization. In order to a complete file name convenction change, you
+also need to change file names and directory names inside repository
+file system organization, just as you did in @code{cli_getRepoName}
+function.
+
+@quotation
+@strong{Note} @xref{trunk Scripts Bash Functions Path}, for more
+information on how to rename files and directories massively inside
+repository file system organization.
+@end quotation
@end defun
@defun cli_getThemeName
-@code{cli_getThemeName} function manipulates the current absolute path
-to extract the theme name from it. If there is no theme in the path,
-this function returns an empty string.
+@code{cli_getThemeName} function evaluates @var{OPTIONVAL} global
+variable to extract theme name from it. In order for
+@code{cli_getThemeName} function to extract theme name correctly, the
+@var{OPTIONVAL} variable must contain a directory path under
+@file{trunk/Identity/Themes/Motifs/} directory structure. Otherwise,
+@code{cli_getThemeName} returns an empty string.
@end defun
@defun cli_printMessage MESSAGE [FORMAT]
@code{cli_printMessage} function outputs information in predifined
formats. The @code{cli_printMessage} function is the standard way to
-output information inside @file{centos-art.sh} script. Use this
-function whenever you need to output information from
-@file{centos-art.sh}.
+output information inside @file{centos-art.sh} script.
When @var{FORMAT} is not specified, @code{cli_printMessage} outputs
information just as it was passed in @var{MESSAGE} variable.
@@ -642,6 +715,8 @@ using two-columns format.
Two-columns format definition is taken from
@file{trunk/Scripts/Bash/Styles/output_forTwoColumns.awk} file.
@end table
+Use @code{cli_printMessage} function whenever you need to output
+information from @file{centos-art.sh}.
@end defun
@subsubsection Specific functions
diff --git a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Locale.texi b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Locale.texi
index 33131a0..2d791eb 100644
--- a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Locale.texi
+++ b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Locale.texi
@@ -20,23 +20,23 @@ location @file{$CLI_LANG/$CLI_LANG.po}.
The @var{CLI_LANG} variable discribes the locale language used to
output messages inside @command{centos-art} command. The locale
language used inside @command{centos-art} command is taken from the
-@var{LANG} environment variable. The @var{CLI_LANG} variable has the
+@env{LANG} environment variable. The @var{CLI_LANG} variable has the
@samp{LL_CC} format, where @samp{LL} is a language code from the
ISO-639 standard, and @samp{CC} a country code from the ISO-3166
standard.
-The @var{LANG} environment variable is set when you do log in to your
+The @env{LANG} environment variable is set when you do log in to your
system. If you are using a graphical session, change language to your
-native language and do login. That would set and exoprt the @var{LANG}
+native language and do login. That would set and exoprt the @env{LANG}
environment variable to the correct value. On the other side, if you
are using a text session edit your @file{~/.bash_profile} file to set
-and export the @var{LANG} environment variable to your native locale
+and export the @env{LANG} environment variable to your native locale
as defines the @command{locale -a} command output; do logout, and do
login again.
-At this point, the @var{LANG} environment variable has the appropriate
+At this point, the @env{LANG} environment variable has the appropriate
value you need, in order to translate @command{centos-art.sh} messages
-to your native language (the one set in @var{LANG} environment
+to your native language (the one set in @env{LANG} environment
variable).
With the @file{$CLI_LANG/$CLI_LANG.po} file up to date, the
@@ -73,7 +73,7 @@ can find such modifications in the following files:
@table @samp
@item centos-art locale --edit
Use this command to translate command-line interface output messages
-in the current system locale you are using (as specified in @var{LANG}
+in the current system locale you are using (as specified in @env{LANG}
environment variable).
@item centos-art locale --list
Use this command to see the command-line interface locale report.
diff --git a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Path.texi b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Path.texi
index e70d4ee..a6009d1 100644
--- a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Path.texi
+++ b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Path.texi
@@ -16,14 +16,17 @@ repository file system syncronized with documentation file system.
This feature is not supported yet.
@table @samp
-@item centos-art path 'path/to/dir/' --copy-to='path/to/dir'
-@item centos-art path 'path/to/dir/' --copy-to='path/to/dir/filename'
-@item centos-art path 'path/to/dir/' --move-to='path/to/dir'
-@item centos-art path 'path/to/dir/' --move-to='path/to/dir/filename'
-@item centos-art path 'path/to/dir/' --remove
+@item centos-art path --rename='old new' --filter='d'
+Rename all occurences of @samp{old} directory names with @samp{new}
+directory name, recursively under the current location.
+
+@item centos-art path --rename='old new' --filter='f'
+Rename all occurences of @samp{old} file names with @samp{new} file
+name, recursively under the current location.
@end table
@subsection See also
@menu
+* trunk Scripts Bash Functions::
@end menu
diff --git a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Verify.texi b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Verify.texi
index ad284ec..3fa1d84 100644
--- a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Verify.texi
+++ b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Verify.texi
@@ -102,7 +102,7 @@ modify your @file{~/.bash_profile} file.
The @option{verify} functionality of @file{centos-art.sh} script
evaluates the following environment variables:
-@table @var
+@table @env
@item EDITOR
Default text editor.