From 0dc09e10295eb99787f1d5f1cadbef27b4273b06 Mon Sep 17 00:00:00 2001 From: Alain Reguera Delgado Date: Jul 21 2012 01:36:58 +0000 Subject: Move the `Tcar-fs' manual from branches to trunk structure. --- diff --git a/Manuals/Tcar-fs/en_US/Branches/chapter-menu.texinfo b/Manuals/Tcar-fs/en_US/Branches/chapter-menu.texinfo new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Branches/chapter-menu.texinfo diff --git a/Manuals/Tcar-fs/en_US/Branches/chapter-nodes.texinfo b/Manuals/Tcar-fs/en_US/Branches/chapter-nodes.texinfo new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Branches/chapter-nodes.texinfo @@ -0,0 +1 @@ + diff --git a/Manuals/Tcar-fs/en_US/Branches/chapter.texinfo b/Manuals/Tcar-fs/en_US/Branches/chapter.texinfo new file mode 100644 index 0000000..05e1ecb --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Branches/chapter.texinfo @@ -0,0 +1,16 @@ +@node Branches +@chapter The @file{branches} Directory +@cindex The @file{branches} Directory + +@c -- Chapter Introduction +This directory implements the Subversion's branches concept in a +trunk, branches, tags repository structure. The @file{branches} +directory structure provides an intermediate space for creating +temporal changes that might be later merged into @file{trunk} +directory structure (@pxref{Trunk}). + +@c -- Chapter Menu +@include Branches/chapter-menu.texinfo + +@c -- Chapter Nodes +@include Branches/chapter-nodes.texinfo diff --git a/Manuals/Tcar-fs/en_US/Licenses/chapter-menu.texinfo b/Manuals/Tcar-fs/en_US/Licenses/chapter-menu.texinfo new file mode 100755 index 0000000..b8240ba --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Licenses/chapter-menu.texinfo @@ -0,0 +1,4 @@ +@menu +* GNU General Public License:: +* GNU Free Documentation License:: +@end menu diff --git a/Manuals/Tcar-fs/en_US/Licenses/chapter-nodes.texinfo b/Manuals/Tcar-fs/en_US/Licenses/chapter-nodes.texinfo new file mode 100755 index 0000000..bd707d6 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Licenses/chapter-nodes.texinfo @@ -0,0 +1,9 @@ +@node GNU General Public License +@section GNU General Public License +@cindex GNU General Public License +@include trunk/Scripts/Bash/Functions/Help/Texinfo/Templates/en_US/Licenses/GPL.texinfo + +@node GNU Free Documentation License +@section GNU Free Documentation License +@cindex GNU Free Documentation License +@include trunk/Scripts/Bash/Functions/Help/Texinfo/Templates/en_US/Licenses/GFDL.texinfo diff --git a/Manuals/Tcar-fs/en_US/Licenses/chapter.texinfo b/Manuals/Tcar-fs/en_US/Licenses/chapter.texinfo new file mode 100755 index 0000000..e5ffcbd --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Licenses/chapter.texinfo @@ -0,0 +1,5 @@ +@node Licenses +@appendix Licenses +@cindex Licenses +@include Licenses/chapter-menu.texinfo +@include Licenses/chapter-nodes.texinfo diff --git a/Manuals/Tcar-fs/en_US/Tags/chapter-menu.texinfo b/Manuals/Tcar-fs/en_US/Tags/chapter-menu.texinfo new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Tags/chapter-menu.texinfo diff --git a/Manuals/Tcar-fs/en_US/Tags/chapter-nodes.texinfo b/Manuals/Tcar-fs/en_US/Tags/chapter-nodes.texinfo new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Tags/chapter-nodes.texinfo @@ -0,0 +1 @@ + diff --git a/Manuals/Tcar-fs/en_US/Tags/chapter.texinfo b/Manuals/Tcar-fs/en_US/Tags/chapter.texinfo new file mode 100644 index 0000000..cfd4897 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Tags/chapter.texinfo @@ -0,0 +1,16 @@ +@node Tags +@chapter The @file{tags} Directory +@cindex The @file{tags} Directory + +@c -- Chapter Introduction +This directory implements the Subversion's tags concept in a trunk, +branches, tags repository structure. The @file{tags/} directory +structure provides frozen branches. Generally, we use frozen branches +to make check-points in time for development lines under +@file{branches/} or @file{trunk/} directory structure. + +@c -- Chapter Menu +@include Tags/chapter-menu.texinfo + +@c -- Chapter Nodes +@include Tags/chapter-nodes.texinfo diff --git a/Manuals/Tcar-fs/en_US/Trunk/chapter-menu.texinfo b/Manuals/Tcar-fs/en_US/Trunk/chapter-menu.texinfo new file mode 100644 index 0000000..fccaa2d --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/chapter-menu.texinfo @@ -0,0 +1,23 @@ +@menu +* Trunk Identity:: +* Trunk Identity Brushes:: +* Trunk Identity Brushes Corporate:: +* Trunk Identity Fonts:: +* Trunk Identity Images:: +* Trunk Identity Images Brands:: +* Trunk Identity Images Brands Logos:: +* Trunk Identity Images Brands Symbols:: +* Trunk Identity Images Brands Types:: +* Trunk Identity Images Themes:: +* Trunk Identity Models:: +* Trunk Identity Models Brands:: +* Trunk Identity Models Brands Logos:: +* Trunk Identity Models Icons:: +* Trunk Identity Models Themes:: +* Trunk Identity Palettes:: +* Trunk Identity Patterns:: +* Trunk Identity Webenv:: +* Trunk Scripts:: +* Trunk Scripts Functions:: +* Trunk Scripts Functions Prepare:: +@end menu diff --git a/Manuals/Tcar-fs/en_US/Trunk/chapter-nodes.texinfo b/Manuals/Tcar-fs/en_US/Trunk/chapter-nodes.texinfo new file mode 100644 index 0000000..1aba12c --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/chapter-nodes.texinfo @@ -0,0 +1,21 @@ +@include Trunk/identity.texinfo +@include Trunk/identity-brushes.texinfo +@include Trunk/identity-brushes-corporate.texinfo +@include Trunk/identity-fonts.texinfo +@include Trunk/identity-images.texinfo +@include Trunk/identity-images-brands.texinfo +@include Trunk/identity-images-brands-logos.texinfo +@include Trunk/identity-images-brands-symbols.texinfo +@include Trunk/identity-images-brands-types.texinfo +@include Trunk/identity-images-themes.texinfo +@include Trunk/identity-models.texinfo +@include Trunk/identity-models-brands.texinfo +@include Trunk/identity-models-brands-logos.texinfo +@include Trunk/identity-models-icons.texinfo +@include Trunk/identity-models-themes.texinfo +@include Trunk/identity-palettes.texinfo +@include Trunk/identity-patterns.texinfo +@include Trunk/identity-webenv.texinfo +@include Trunk/scripts.texinfo +@include Trunk/scripts-functions.texinfo +@include Trunk/scripts-functions-prepare.texinfo diff --git a/Manuals/Tcar-fs/en_US/Trunk/chapter.texinfo b/Manuals/Tcar-fs/en_US/Trunk/chapter.texinfo new file mode 100644 index 0000000..8421fe0 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/chapter.texinfo @@ -0,0 +1,15 @@ +@node Trunk +@chapter The @file{trunk} Directory +@cindex The @file{trunk} Directory + +@c -- Chapter Introduction +The @file{trunk} directory structure implements the Subversion's trunk +concept in a trunk, branches, tags repository structure. It provides +the main development line inside @value{TCAR} and is made of the +following components: + +@c -- Chapter Menu +@include Trunk/chapter-menu.texinfo + +@c -- Chapter Nodes +@include Trunk/chapter-nodes.texinfo diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-brushes-corporate.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-brushes-corporate.texinfo new file mode 100644 index 0000000..265f3fc --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-brushes-corporate.texinfo @@ -0,0 +1,10 @@ +@node Trunk Identity Brushes Corporate +@section @file{trunk/Identity/Brushes/Corporate} +@cindex Trunk identity brushes corporate + +... + +@c -- <[centos-art(SeeAlso) +@itemize +@end itemize +@c -- ]> diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-brushes.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-brushes.texinfo new file mode 100644 index 0000000..ec6d853 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-brushes.texinfo @@ -0,0 +1,80 @@ +@node Trunk Identity Brushes +@section @file{trunk/Identity/Brushes} +@cindex Trunk identity brushes + +The @file{trunk/Identity/Brushes} directory exists to organize GIMP +brushes used inside @value{TCPCVI}. + +A brush is a pixmap or set of pixmaps used for painting through an +image manipulation program like GIMP. Inside the repository, brushes +are initially created in @file{.xcf} format and later exported to any +of the brush formats recognized by GIMP (e.g., @file{.gbr} or +@file{.gih}) using the same name of its source file. + +The @file{trunk/Identity/Brushes} directory is under version control. + +The @file{trunk/Identity/Brushes} directory contains no file, but the +following organizational directories: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Trunk Identity Brushes Corporate} +@end itemize +@c -- ]> + +Content rendition inside @file{trunk/Identity/Brushes} directory is +not supported. + +In order for brushes to be loaded by GIMP, they should be stored in +the @file{~/.gimp-2.2/brushes} directory. This location is out of +@value{TCAR} and doesn't provide version control by itself. To be able +of using version controlled brushes inside GIMP, we store brush +related files inside @file{trunk/Identity/Brushes} directory and +create links to them from @file{~/.gimp-2.2/brushes} directory. + +@float Example,trunk-identity-brushes-1 +@verbatim +trunk/Identity/Brushes +|-- Corporate +| |-- symbol.xcf +| `-- symbol.gbr (file) <-- ~/.gimp-2.2/brushes/corporate-symbol.gbr (link) +|-- TreeFlower +| |-- flower.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-flower.gbr (link) +| |-- flower.xcf +| |-- branch.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-branch.gbr (link) +| |-- branch.xcf +| |-- trunk.gbr (file) <-- ~/.gimp-2.2/brushes/treeflower-trunk.gbr (link) +| `-- trunk.xcf +`-- Others + `-- ... +@end verbatim +@caption{Relation between brushes inside the workstation.} +@end float + +The entire link preparation and maintainance of brushes inside the +working copy is automated by @code{prepare} functionality of +@command{centos-art.sh} script. + +Inside the working copy, brushes might be created individually in +different locations, but they all need to be linked from one unique +location (i.e., @file{~/.gimp-2.2/brushes}). This configuration may +provoke brushes to overlap one another if a consistent name +convenction is not implemented correctly. In that sake, the brushes +file names are build using their directory and file names as reference +in order to build unique names that can be used as identifiers. + +Brushes produced with GIMP has a description field associated that is +shown in the Brushes panel of GIMP. This description is set when the +brush is created as @file{.xcf} file and can be updated when it is +exported either to @file{.gbr} or @file{.gih} format. It wouldn't be +too useful to have two or more brushes using the same description so, +we also make description of brush files unique, too. In that sake, use +the file name as description but without including the file extension +(e.g., if we have the @file{centos-flame-3.gbr} brush, its description +would be @code{centos-flame-3}). + +More information about GIMP brushes can be found in +@url{file:///usr/share/gimp/2.0/help/en/index.html,The Gimp Manual}, +specifically in the section related to +@url{file:///usr/share/gimp/2.0/help/en/gimp-concepts-brushes.html, +Brushes}. diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-fonts.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-fonts.texinfo new file mode 100644 index 0000000..bfa1cc5 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-fonts.texinfo @@ -0,0 +1,58 @@ +@node Trunk Identity Fonts +@section @file{trunk/Identity/Fonts} +@cindex Trunk identity fonts + +The @file{trunk/Identity/Fonts} directory exists to organize +typographies used inside @value{TCPCVI} that aren't packaged inside +@value{TCD}. + +The @file{trunk/Identity/Fonts} directory is under version control. + +Content rendition inside @file{trunk/Identity/Fonts} directory is not +supported. + +@c -- describe, in one paragraph, what a font is. + +In order for fonts to be available inside programs like GIMP and +Inkscape, font files should be stored either in +@file{/usr/share/fonts} or @file{~/.fonts} directory. These locations +are out of @value{TCAR} and doesn't provide version control by +themselves. In order for version controlled typographies to be +available inside programs like GIMP and Inkscape, we store them under +@file{trunk/Identity/Fonts} directory and create links to them from +@file{~/.fonts} directory. + +@float Example, trunk-identity-fonts-1 +@verbatim +trunk/Identity/Fonts +`-- denmark.ttf (file) <-- ~/.fonts/denmark.ttf (link) +@end verbatim +@caption{Relation between fonts inside the workstation.} +@end float + +The creation and maintainance of links related to fonts inside the +working copy are automated by @code{prepare} functionality of +@command{centos-art.sh} script. + +@image{trunk/Identity/Images/Manuals/Fonts/dejavu-lgc,443pt,,,} + +Inside @value{TCPCVI}, the @samp{DejaVu LGC} typography is used as +default typography in all visual manifestations. The @samp{DejaVu LGC} +typography comes with @value{TCD} so there is no need to store it in +@file{trunk/Identity/Fonts} for you to use. + +@image{trunk/Identity/Images/Manuals/Fonts/denmark,443pt,,,} + +Inside @value{TCPCVI}, the @samp{Denmark} typography is used as base +to build The CentOS Logo (i.e., the main graphic design that +connects/identifies all visual manifestations related to The CentOS +Project). The @samp{Denmark} typography doesn't come with @value{TCD} +so it is store in @file{trunk/Identity/Fonts} for you to use. + +The license information of @samp{Denmark} typography isn't very clear, +at least not as clear as the one in @samp{DejaVu LGC} typography is. +Using a typography with a doubtful license might put in risk the +content produced from it. To prevent such issues, it would be better +to move on from @samp{Denmark} typography to another typography (free, +preferably) that retain the same visual style of @samp{Denmark}, but +with a clearer copyright and license notice. diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands-logos.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands-logos.texinfo new file mode 100644 index 0000000..00a2741 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands-logos.texinfo @@ -0,0 +1,42 @@ +@node Trunk Identity Images Brands Logos +@section @file{trunk/Identity/Images/Brands/Logos} +@cindex Trunk identity images brands logos + +The @file{trunk/Identity/Images/Brands/Logos} exists to organize +images related to The CentOS Logos, in different formats (e.g., PNG, +JPG, PDF, TIF, XBM, XPM) and dimensions. + +The CentOS Logo is a construction made of The CentOS Symbol and The +CentOS Type. The CentOS Symbol and The CentOS Logo are the main visual +manifestations of the organization known as @value{TCPROJ}. As The +CentOS Symbol, The CentOS Logo is used to ``brand'' images produced by +@value{TCPROJ} and provide a visual connection between images so they +can be monolithically recognized as part of @value{TCPROJ}. The CentOS +Logo must be exactly the same everytime it is printed out and a route +to reproduce it in such a way must be available so as to avoid +reproduction mistakes when images are branded with it. + +The @file{trunk/Identity/Images/Brands/Logos} directory and the files +inside it aren't under version control. + +The @file{trunk/Identity/Images/Brands/Logos} directory contains files +used by the @file{redhat-logos} package, specifically the files inside +the @file{/usr/share/pixmaps/redhat} directory. + +The @file{trunk/Identity/Images/Brands/Logos} directory organizes +files under directories numerically named (e.g., @file{48}, @file{64}, +@file{128}, etc.). Inside these directories, image files are stored +in specific heights and named as +@file{centos-.}, where @code{} +describes the file content and @code{} sets the file +extension. In all cases, the directory name can be used as reference +to determine the image height of files stored inside. For example, +the directory @file{48} stores image files of 48 pixels height in +different formats. + +Content rendition inside @file{trunk/Identity/Images/Brands/Logos} +directory takes place through the following command: + +@verbatim +centos-art render trunk/Identity/Images/Brands/Logos --dont-commit-changes +@end verbatim diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands-symbols.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands-symbols.texinfo new file mode 100644 index 0000000..3ac5b2f --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands-symbols.texinfo @@ -0,0 +1,40 @@ +@node Trunk Identity Images Brands Symbols +@section @file{trunk/Identity/Images/Brands/Symbols} +@cindex Trunk identity images brands symbols + +The @file{trunk/Identity/Images/Brands/Symbols} exists to organize +images related to The CentOS Symbol, in different formats (e.g., PNG, +JPG, PDF, TIF, XBM, XPM) and dimensions. + +The CentOS Symbol is the graphical part of The CentOS Logo. As The +CentOS Logo, The CentOS Symbol is used to ``brand'' images produced by +@value{TCPROJ} and provide a visual connection between images so they +can be monolithically recognized as part of @value{TCPROJ}. The CentOS +Symbol must be exactly the same everytime it is printed out and a +route to reproduce it in such a way must be available so as to avoid +reproduction mistakes when images are branded with it. + +The @file{trunk/Identity/Images/Brands/Symbols} directory and the files +inside it aren't under version control. + +The @file{trunk/Identity/Images/Brands/Symbols} directory contains +files used by the @file{redhat-logos} package, specifically the files +inside the @file{/usr/share/pixmaps/redhat} directory. + +The @file{trunk/Identity/Images/Brands/Symbols} directory organizes +files under directories numerically named (e.g., @file{48}, @file{64}, +@file{128}, etc.). Inside these directories, image files are stored +in specific heights and named as +@file{centos-.}, where @code{} +describes the file content and @code{} sets the file +extension. In all cases, the directory name can be used as reference +to determine the image height of files stored inside. For example, +the directory @file{48} stores image files of 48 pixels height in +different formats. + +Content rendition inside @file{trunk/Identity/Images/Brands/Symbols} +directory takes place through the following command: + +@verbatim +centos-art render trunk/Identity/Images/Brands/Symbols --dont-commit-changes +@end verbatim diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands-types.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands-types.texinfo new file mode 100644 index 0000000..c1b1f88 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands-types.texinfo @@ -0,0 +1,44 @@ +@node Trunk Identity Images Brands Types +@section @file{trunk/Identity/Images/Brands/Types} +@cindex Trunk identity images brands types + +The @file{trunk/Identity/Images/Brands/Types} exists to organize +images related to The CentOS Symbol, in different formats (e.g., PNG, +JPG, PDF, TIF, XBM, XPM) and dimensions. + +The CentOS Type is the typographical part of The CentOS Logo. +Comparing with both The CentOS Logo and The CentOS Symbol, The CentOS +Type by its own, provides poor visual connection between images that +intend to be recongnized as a monolithic part of @value{TCPROJ} and +shouldn't be used alone. Instead, The CentOS Logo or The CentOS Symbol +are prefered. The CentOS Symbol must be exactly the same everytime it +is printed out and a route to reproduce it in such a way must be +available so as to avoid reproduction mistakes when images are branded +with it. + +The @file{trunk/Identity/Images/Brands/Types} directory and the files +inside it aren't under version control. Files in this location are +mainly used to build The CentOS Logo from combining both The CentOS +Type and The CentOS Symbol in specific situations that might be needed +doing so. + +The @file{trunk/Identity/Images/Brands/Types} directory contains files +used by no package, as far as we've found out. + +The @file{trunk/Identity/Images/Brands/Types} directory organizes +files under directories numerically named (e.g., @file{48}, @file{64}, +@file{128}, etc.). Inside these directories, image files are stored +in specific heights and named as +@file{centos-.}, where @code{} +describes the file content and @code{} sets the file +extension. In all cases, the directory name can be used as reference +to determine the image height of files stored inside. For example, +the directory @file{48} stores image files of 48 pixels height in +different formats. + +Content rendition inside @file{trunk/Identity/Images/Brands/Types} +directory takes place through the following command: + +@verbatim +centos-art render trunk/Identity/Images/Brands/Types --dont-commit-changes +@end verbatim diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands.texinfo new file mode 100644 index 0000000..f2d8270 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-images-brands.texinfo @@ -0,0 +1,27 @@ +@node Trunk Identity Images Brands +@section @file{trunk/Identity/Images/Brands} +@cindex Trunk identity images brands + +The @file{trunk/Identity/Images/Brands} directory exists to organize +brand information related to @value{TCPROJ}. + +The @file{trunk/Identity/Images/Brands} directory isn't under version +control. + +The @file{trunk/Identity/Images/Brands} contains no file, but the +following organizational directories: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Trunk Identity Images Brands Logos} +@item @ref{Trunk Identity Images Brands Symbols} +@item @ref{Trunk Identity Images Brands Types} +@end itemize +@c -- ]> + +Content rendition inside @file{trunk/Identity/Images/Brands} directory +takes place through the following command: + +@verbatim +centos-art render trunk/Identity/Images/Brands --dont-commit-changes +@end verbatim diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-images-themes.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-images-themes.texinfo new file mode 100644 index 0000000..ea7432e --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-images-themes.texinfo @@ -0,0 +1,7 @@ +@node Trunk Identity Images Themes +@section @file{trunk/Identity/Images/Themes} +@cindex Trunk identity images themes +... + +@menu +@end menu diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-images.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-images.texinfo new file mode 100644 index 0000000..2a710e3 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-images.texinfo @@ -0,0 +1,25 @@ +@node Trunk Identity Images +@section @file{trunk/Identity/Images} +@cindex Trunk identity images + +The @file{trunk/Identity/Images} directory exists to store all image +files (e.g., PNG, JPG, PPM, etc.) related to @value{TCPCVI}. + +The @file{trunk/Identity/Images} directory is under version control. + +The @file{trunk/Identity/Images} directory contains no file, but the +following organizational directories: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Trunk Identity Images Brands} +@item @ref{Trunk Identity Images Themes} +@end itemize +@c -- ]> + +Content rendition inside @file{trunk/Identity/Images} directory takes +place through the following command: + +@verbatim +centos-art render trunk/Identity/Images --dont-commit-changes +@end verbatim diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-models-brands-logos.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-models-brands-logos.texinfo new file mode 100644 index 0000000..3e01581 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-models-brands-logos.texinfo @@ -0,0 +1,8 @@ +@node Trunk Identity Models Brands Logos +@section @file{trunk/Identity/Models/Brands/Logos} +@cindex Trunk identity models brands logos + +... + +@menu +@end menu diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-models-brands.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-models-brands.texinfo new file mode 100644 index 0000000..e6bd846 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-models-brands.texinfo @@ -0,0 +1,9 @@ +@node Trunk Identity Models Brands +@section @file{trunk/Identity/Models/Brands} +@cindex Trunk identity models brands + +... + +@menu +* Trunk Identity Models Brands Logos:: +@end menu diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-models-icons.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-models-icons.texinfo new file mode 100644 index 0000000..2c56d59 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-models-icons.texinfo @@ -0,0 +1,10 @@ +@node Trunk Identity Models Icons +@section @file{trunk/Identity/Models/Icons} +@cindex Trunk identity models icons + +... + +@c -- <[centos-art(SeeAlso) +@itemize +@end itemize +@c -- ]> diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-models-themes.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-models-themes.texinfo new file mode 100644 index 0000000..e0c2c6a --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-models-themes.texinfo @@ -0,0 +1,10 @@ +@node Trunk Identity Models Themes +@section @file{trunk/Identity/Models/Themes} +@cindex Trunk identity models themes + +... + +@c -- <[centos-art(SeeAlso) +@itemize +@end itemize +@c -- ]> diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-models.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-models.texinfo new file mode 100644 index 0000000..b725181 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-models.texinfo @@ -0,0 +1,13 @@ +@node Trunk Identity Models +@section @file{trunk/Identity/Models} +@cindex Trunk identity models + +... + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Trunk Identity Models Brands} +@item @ref{Trunk Identity Models Icons} +@item @ref{Trunk Identity Models Themes} +@end itemize +@c -- ]> diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-palettes.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-palettes.texinfo new file mode 100644 index 0000000..1502894 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-palettes.texinfo @@ -0,0 +1,7 @@ +@node Trunk Identity Palettes +@section @file{trunk/Identity/Palettes} +@cindex Trunk identity palettes +... + +@menu +@end menu diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-patterns.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-patterns.texinfo new file mode 100644 index 0000000..d4cf568 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-patterns.texinfo @@ -0,0 +1,7 @@ +@node Trunk Identity Patterns +@section @file{trunk/Identity/Patterns} +@cindex Trunk identity patterns +... + +@menu +@end menu diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity-webenv.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity-webenv.texinfo new file mode 100644 index 0000000..de47fe1 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity-webenv.texinfo @@ -0,0 +1,7 @@ +@node Trunk Identity Webenv +@section @file{trunk/Identity/Webenv} +@cindex Trunk identity webenv +... + +@menu +@end menu diff --git a/Manuals/Tcar-fs/en_US/Trunk/identity.texinfo b/Manuals/Tcar-fs/en_US/Trunk/identity.texinfo new file mode 100644 index 0000000..788f31e --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/identity.texinfo @@ -0,0 +1,33 @@ +@node Trunk Identity +@section @file{trunk/Identity} +@cindex Trunk identity + +The @file{trunk/Identity} directory describes @value{TCPCI}, what it +is and the components it is made of. + +@value{TCPCI} is the ``persona'' of the organization known as The +CentOS Project. The CentOS Project Corporate Identity plays a +significant role in the way The CentOS Project, as organization, +presents itself to both internal and external stakeholders. In general +terms, The CentOS Project Corporate Identity expresses the values and +ambitions of The CentOS Project organization, its business, and its +characteristics. @value{TCPCI} provides visibility, recognizability, +reputation, structure and identification to The CentOS Project by +means of Corporate Design, Corporate Communication, and Corporate +Behaviour. + +From Corporate Design, Corporate Communication and Corporate +Behaviour, it is the Corporate Design the one organized inside +@file{trunk/Identity} directory through the following components: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Trunk Identity Brushes} +@item @ref{Trunk Identity Fonts} +@item @ref{Trunk Identity Images} +@item @ref{Trunk Identity Models} +@item @ref{Trunk Identity Palettes} +@item @ref{Trunk Identity Patterns} +@item @ref{Trunk Identity Webenv} +@end itemize +@c -- ]> diff --git a/Manuals/Tcar-fs/en_US/Trunk/scripts-functions-prepare.texinfo b/Manuals/Tcar-fs/en_US/Trunk/scripts-functions-prepare.texinfo new file mode 100644 index 0000000..2035cf9 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/scripts-functions-prepare.texinfo @@ -0,0 +1,86 @@ +@node Trunk Scripts Functions Prepare +@section @file{trunk/Scripts/Functions/Prepare} +@cindex Trunk scripts functions prepare + +The @file{trunk/Scripts/Functions/Prepare} directory exists to +organize the @code{prepare} functionality of @command{centos-art.sh} +script. The @code{prepare} functionality is written in Bash and its +main goal is to standardize the final configuration stuff your +workstation needs, once the working copy of @value{TCAR} has been +downloaded inside it. + +The @file{trunk/Scripts/Functions/Prepare} directory and all files +inside it are under version control. + +Content rendition inside @file{trunk/Scripts/Functions/Prepare} is not +supported. + +Inside @file{trunk/Scripts/Functions/Prepare} directory, file names +and function names share the same name convenction with the exception +that file names end with a @samp{.sh} suffix while function names +doesn't. Both, file names and function names, begin with +@samp{prepare_} prefix followed by a description of what the function +does. + +Inside @file{trunk/Scripts/Functions/Prepare} directory, you can find +the following functions: + +@defun prepare +The @code{prepare} (initialization) function creates the base +execution environment required to standardize final configuration +stuff needed by your workstation, once the working copy of +@value{TCAR} has been downloaded in it. +@end defun + +@defun prepare_getOptions +The @code{prepare_getOptions} function parses command options provided +to @command{centos-art.sh} script when the first argument in the +command-line is the @samp{prepare} word. This function decides what +action to perform based on options provided. To parse options, this +function makes use of @command{getopt} program. +@end defun + +@defun prepare_updateLinks +The @code{prepare_updateLinks} function updates the symbolic +link relation that connects your workstation with the files inside the +working copy of @value{TCAR}. This function makes brushes, palettes, +patterns and fonts inside the working copy available to programs like +GIMP and Inkscape installed in your workstation. +@end defun + +@defun prepare_updateImages +The @code{prepare_updateImages} function initializes image files +inside the working copy. This function makes a list of all design +models inside the working copy and renders them one by one to produces +the related output images. +@end defun + +@defun prepare_updateManuals +The @code{prepare_updateManuals} function initializes +documentation files inside the working copy. This function makes a +list of all documentation manuals source files inside the working copy +and produces related output for them. +@end defun + +@defun prepare_updatePackages +The @code{prepare_updatePackages} function verifies the required +packages your workstation needs to have installed in order for +@command{centos-art.sh} script to run correctly. If one or +more packages are uninstalled or out of date, the +@command{centos-art.sh} script asks you to confirm their +installation or actualization through the @command{sudo yum} command. +@end defun + +@defun prepare_getEnvars +The @code{prepare_getEnvars} function outputs a brief description of +relevant environment variables the @command{centos-art.sh} script +makes use of. +@end defun + +@defun prepare_getLinkName DIRECTORY, FILE +The @code{prepare_getLinkName} function takes a @var{DIRECTORY} path +as first argument and a @var{FILE} path as second argument to output a +file name with the path information that remains from substracting the +@var{DIRECTORY} path from the @var{FILE} path provided as argument. +@end defun + diff --git a/Manuals/Tcar-fs/en_US/Trunk/scripts-functions.texinfo b/Manuals/Tcar-fs/en_US/Trunk/scripts-functions.texinfo new file mode 100644 index 0000000..d2e0116 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/scripts-functions.texinfo @@ -0,0 +1,69 @@ +@node Trunk Scripts Functions +@section @file{trunk/Scripts/Functions} +@cindex Trunk scripts functions + +The @file{trunk/Scripts/Functions} directory exists to organize common +and spectic functionalities related to the @command{centos-art.sh} +script. Common functionalities are loaded once the +@command{centos-art.sh} script is executed and made available for +sepecific functionalities to reuse. + +The @file{trunk/Scripts/Functions} directory and all files inside it +are under version control. + +Content rendition inside `trunk/Scripts/Functions' directory is not +supported. + +Inside @file{trunk/Scripts/Functions} directory, specific +functionalities are organized in the following directories: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Trunk Scripts Functions Prepare} +@end itemize +@c -- ]> + +Inside @file{trunk/Scripts/Functions} directory, common +functionalities are stored in files prefixed with the @samp{cli} +string as described below: + +@defun cli "$@@" +The @code{cli} functionality initializes the command-line interface +(cli) of @command{centos-art.sh} script. This function evaluates the +first argument provided to @command{centos-art.sh} script and call the +specific functionality that respondes to it. The @code{cli} function +is directly called from @file{centos-art.sh} itself once global +variables are defined, working copy verification performed, common +functionalities exported into the execution environment, and signals +trapped. The @code{cli} function receives all positional parameters +passed to @command{centos-art.sh} as argument. + +The @code{cli} function creates the a new environment inside that one +created by @command{centos-art.sh} script execution. Variables defined +herein will be avaialble to all specific functionalities and common +functionalities used inside specific functionalities. + +@defvar FUNCNAM +The @var{FUNCNAM} variable stores the function name passed as first +argument to @command{centos-art.sh} script using the file convenction +specified by @code{cli_getRepoName} function. +@end defvar + +@defvar FUNCDIR +The @var{FUNCDIR} variable stores the absolute path of directory +holding @command{centos-art.sh} script functions, both common and +specific. +@end defvar + +@defvar FUNCDIRNAM +... +@end defvar + +@defvar FUNCSCRIPT +... +@end defvar + +@defvar ARGUMENTS +... +@end defvar +@end defun diff --git a/Manuals/Tcar-fs/en_US/Trunk/scripts.texinfo b/Manuals/Tcar-fs/en_US/Trunk/scripts.texinfo new file mode 100644 index 0000000..51d2a43 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/Trunk/scripts.texinfo @@ -0,0 +1,73 @@ +@node Trunk Scripts +@section @file{trunk/Scripts} +@cindex Trunk scripts + +The @file{trunk/Scripts} directory exists to organize automation +scripts related to @value{TCPCVI}. Such automation scripts are +implemented through @command{centos-art.sh} script, a bash scripts +designed to automate most frequent tasks performed inside the working +copy of @value{TCAR} (e.g., image rendition, content documentation, +content translation, etc.). + +The @file{trunk/Scripts} directory and all files inside it are under +version control. + +The @file{trunk/Scripts} directory contains just one file, the +@file{centos-art.sh} file. This file is the invocation script the +@command{centos-art} command calls to. In addition to +@file{centos-art.sh} file, the following directories are available: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Trunk Scripts Functions} +@end itemize +@c -- ]> + +Content rendition inside @file{trunk/Scripts} is not supported. + +Once the @command{centos-art.sh} script is executed, the following +variables are available all along the script execution: + +@defvar CLI_PROGRAM +The @var{CLI_PROGRAM} variable is read-only and contains the name of +the script, which is @samp{centos-art}, without extension. +@end defvar + +@defvar CLI_PROGRAM_ID +The @var{CLI_PROGRAM_ID} variable is read-only and contains the +process identification assigned to @command{centos-art.sh} script, +once executed. +@end defvar + +@defvar CLI_VERSION +The @var{CLI_VERSION} variable is read-only and contains the version +number of @command{centos-art.sh} script. +@end defvar + +@defvar CLI_BASEDIR +The @var{CLI_BASEDIR} variable is read-only and contains the absolute +path of directory where @command{centos-art.sh} script is stored in. +@end defvar + +@defvar CLI_TEMPDIR +The @var{CLI_TEMPDIR} variable is read-only and contains the absolute +path of directory where temporal files created by +@command{centos-art.sh} script are stored in. +@end defvar + +@defvar TEXTDOMAIN +The @var{TEXDOMAIN} variable is read-only and contains the name of the +program we are providing localization for (i.e., @samp{centos-art.sh}). +@end defvar + +@defvar TEXTDOMAINDIR +The @var{TEXTDOMAINDIR} variable is read-only and contains the +absolute path of directory holding localization messages for +@command{centos-art.sh}. In order for this variable to take effect, +its value must be set using the +@file{$@{BASEDIR@}/$@{LANG@}/LC_MESSAGES/$@{TEXDOMAIN@}} construction; +where @var{BASEDIR} is an absolute path inside your workstation, +@var{LANG} a language code based on the standards @samp{ISO-639} and +@samp{ISO-3166} (e.g., @samp{es_ES} for Spanish from Spain, +@samp{fr_FR} for French from France, etc.). +@end defvar diff --git a/Manuals/Tcar-fs/en_US/tcar-fs-index.texinfo b/Manuals/Tcar-fs/en_US/tcar-fs-index.texinfo new file mode 100755 index 0000000..b197b13 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/tcar-fs-index.texinfo @@ -0,0 +1,8 @@ +@node Index +@unnumbered Index +@syncodeindex fn cp +@syncodeindex vr cp +@syncodeindex ky cp +@syncodeindex pg cp +@syncodeindex tp cp +@printindex cp diff --git a/Manuals/Tcar-fs/en_US/tcar-fs-menu.texinfo b/Manuals/Tcar-fs/en_US/tcar-fs-menu.texinfo new file mode 100644 index 0000000..2209765 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/tcar-fs-menu.texinfo @@ -0,0 +1,7 @@ +@menu +* Trunk:: +* Branches:: +* Tags:: +* Licenses:: +* Index:: +@end menu diff --git a/Manuals/Tcar-fs/en_US/tcar-fs-nodes.texinfo b/Manuals/Tcar-fs/en_US/tcar-fs-nodes.texinfo new file mode 100644 index 0000000..d30344b --- /dev/null +++ b/Manuals/Tcar-fs/en_US/tcar-fs-nodes.texinfo @@ -0,0 +1,3 @@ +@include Trunk/chapter.texinfo +@include Branches/chapter.texinfo +@include Tags/chapter.texinfo diff --git a/Manuals/Tcar-fs/en_US/tcar-fs.conf b/Manuals/Tcar-fs/en_US/tcar-fs.conf new file mode 100755 index 0000000..789f831 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/tcar-fs.conf @@ -0,0 +1,36 @@ +# This file controls the manual configuration. This file is divided +# in configuration sections (e.g., `main' and `templates') which, in +# turn, are organized in the form `variable = value'. +# ---------------------------------------------------------------------- +# $Id$ +# ---------------------------------------------------------------------- + +[main] + +# Specify documentation backend used by documentation manual. This is +# the format used to write documentation manual source files. +manual_format = "texinfo" + +# Specify title style used by sections inside the manual. Possible +# values to this option are `cap-each-word' to capitalize each word in +# the section title, `cap-first-word' to capitalize the first word in +# the section title only and `directory' to transform each word in the +# section title into a directory path. From all these options, +# `cap-each-word' is the one used as default. +manual_section_style = "directory" + +# Specify the order used by sections inside the manual. By default new +# sections added to the manual are put on the end to follow the +# section `created' order. Other possible values to this option are +# `ordered' and `reversed' to sort the list of sections alphabetically +# from A-Z and Z-A, respectively. +manual_section_order = "ordered" + +[templates] + +# Specify relation between template files and section definition files +# inside the manual. Template definition is set on the left side using +# relative path. The section main definition file is described on the +# right using a regular expression. The first match wins. +Chapters/section-functions.texinfo = "^.+-functions-[[:alnum:]]+\.texinfo$" +Chapters/section.texinfo = "^.+\.texinfo$" diff --git a/Manuals/Tcar-fs/en_US/tcar-fs.texinfo b/Manuals/Tcar-fs/en_US/tcar-fs.texinfo new file mode 100644 index 0000000..e1f6b42 --- /dev/null +++ b/Manuals/Tcar-fs/en_US/tcar-fs.texinfo @@ -0,0 +1,83 @@ +\input texinfo @c -*-texinfo-*- +@c -- Header -------------------------------------------------- + +@setfilename tcar-fs.info +@settitle The CentOS Artwork Repository File System +@documentlanguage en +@afourpaper +@finalout + +@c -- Variables ----------------------------------------------- + +@set TCENTOS The Community Enterprise Operating System +@set TCPROJ @url{http://www.centos.org/, The CentOS Project} +@set TCWIKI @url{http://wiki.centos.org/, The CentOS Wiki} +@set TCMLISTS @url{http://lists.centos.org/, The CentOS Mailing Lists} +@set TCBUGS @url{http://bugs.centos.org/, The CentOS Bugs} +@set TCMIRRORS @url{http://mirrors.centos.org/, The CentOS Mirrors} +@set TCPLANET @url{http://planet.centos.org/, The CentOS Planet} +@set TCFORUMS @url{http://forums.centos.org/, The CentOS Forums} +@set TCINFOML @email{centos-info@@centos.org, The CentOS Information Mailing List} +@set TCDEVSML @email{centos-devel@@centos.org, The CentOS Developers Mailing List} +@set TCDOCSML @email{centos-docs@@centos.org, The CentOS Documentation Mailing List} +@set TCARTWML @email{centos-artwork@@centos.org, The CentOS Artwork Mailing List} +@set TCL10NML @email{centos-l10n@@centos.org, The CentOS Localization Mailing List} +@set TCAR @url{https://projects.centos.org/svn/artwork/, The CentOS Artwork Repository} +@set TCAS @url{https://projects.centos.org/trac/artwork/, The CentOS Artwork SIG} + +@set TCPCVI The CentOS Project Corporate Visual Identity +@set TCPCI The CentOS Project Corporate Identity +@set TCPCVIS The CentOS Project Corporate Visual Identity Structure +@set TCPCMVIS The CentOS Project Monolithic Corporate Visual Identity Structure + +@set TCD The CentOS Distribution + +@c -- Summary description and copyright ----------------------- + +@copying +This manual describes the directories inside @value{TCAR}. You can use +this manual as reference to know where to store or look for +information inside your working copy of @value{TCAR}. + +Copyright @copyright{} 2009, 2010, 2011 The CentOS Project + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no +Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A +copy of the license is included in the section entitled @ref{GNU Free +Documentation License}. +@end copying + +@c -- Titlepage, contents, copyright --------------------------- + +@titlepage +@title The CentOS Artwork Repository +@subtitle File System +@author Alain Reguera Delgado +@page +@vskip 0pt plus 1filll +@insertcopying +@end titlepage +@contents + +@c -- `Top' node and master menu ------------------------------- + +@ifnottex +@node Top +@top The CentOS Artwork Repository File System +@insertcopying +@end ifnottex + +@include tcar-fs-menu.texinfo + +@c -- The body of the document -------------------------------- + +@include tcar-fs-nodes.texinfo + +@c -- The end of the document --------------------------------- + +@include Licenses/chapter.texinfo +@include tcar-fs-index.texinfo + +@bye