From 4c9448724e20949240ff88068762ebb063482e6a Mon Sep 17 00:00:00 2001 From: Alain Reguera Delgado Date: Dec 12 2012 23:27:08 +0000 Subject: Remove Trunk, Branches and Tags chapters from Tcar-fs. Previous to this commit, the texinfo documentation models for Tcar-fs documentation manual were organized using Trunk, Branches and Tags as chapters and all directories inside it as sections. This was fine for a conventional trunk, branches, tags layout. But it isn't for a Git layout where such structure isn't required. In this commit, I remove the Trunk, Branches and Tags chapters and start using Identity/ and Scripts/ as chapters instead. This to reflect the same structure provided by Git. The Locales/ and Documentation/ directories hadn't information at time of this commit so I didn't added now. --- diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Branches/chapter-menu.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Branches/chapter-menu.texinfo deleted file mode 100644 index e69de29..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Branches/chapter-menu.texinfo +++ /dev/null diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Branches/chapter-nodes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Branches/chapter-nodes.texinfo deleted file mode 100644 index 8b13789..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Branches/chapter-nodes.texinfo +++ /dev/null @@ -1 +0,0 @@ - diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Branches/chapter.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Branches/chapter.texinfo deleted file mode 100644 index 05e1ecb..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Branches/chapter.texinfo +++ /dev/null @@ -1,16 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/Fonts.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/Fonts.texinfo new file mode 100644 index 0000000..a77a537 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/Fonts.texinfo @@ -0,0 +1,54 @@ +@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. + +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. + +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/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/brushes-corporate.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/brushes-corporate.texinfo new file mode 100644 index 0000000..8a72508 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/brushes-corporate.texinfo @@ -0,0 +1,10 @@ +@node Identity Brushes Corporate +@section @file{Identity/Brushes/Corporate} +@cindex identity brushes corporate + +... + +@c -- <[centos-art(SeeAlso) +@itemize +@end itemize +@c -- ]> diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/brushes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/brushes.texinfo new file mode 100644 index 0000000..05c7990 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/brushes.texinfo @@ -0,0 +1,80 @@ +@node Identity Brushes +@section @file{Identity/Brushes} +@cindex identity brushes + +The @file{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{Identity/Brushes} directory is under version control. + +The @file{Identity/Brushes} directory contains no file, but the +following organizational directories: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Identity Brushes Corporate} +@end itemize +@c -- ]> + +Content rendition inside @file{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{Identity/Brushes} directory and +create links to them from @file{~/.gimp-2.2/brushes} directory. + +@float Example,trunk-identity-brushes-1 +@verbatim +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/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/chapter-menu.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/chapter-menu.texinfo new file mode 100644 index 0000000..c055a60 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/chapter-menu.texinfo @@ -0,0 +1,19 @@ +@menu +* Identity Brushes:: +* Identity Brushes Corporate:: +* Identity Fonts:: +* Identity Images:: +* Identity Images Brands:: +* Identity Images Brands Logos:: +* Identity Images Brands Symbols:: +* Identity Images Brands Types:: +* Identity Images Themes:: +* Identity Models:: +* Identity Models Brands:: +* Identity Models Brands Logos:: +* Identity Models Icons:: +* Identity Models Themes:: +* Identity Palettes:: +* Identity Patterns:: +* Identity Webenv:: +@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/chapter-nodes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/chapter-nodes.texinfo new file mode 100644 index 0000000..d95885c --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/chapter-nodes.texinfo @@ -0,0 +1,17 @@ +@include Identity/brushes.texinfo +@include Identity/brushes-corporate.texinfo +@include Identity/fonts.texinfo +@include Identity/images.texinfo +@include Identity/images-brands.texinfo +@include Identity/images-brands-logos.texinfo +@include Identity/images-brands-symbols.texinfo +@include Identity/images-brands-types.texinfo +@include Identity/images-themes.texinfo +@include Identity/models.texinfo +@include Identity/models-brands.texinfo +@include Identity/models-brands-logos.texinfo +@include Identity/models-icons.texinfo +@include Identity/models-themes.texinfo +@include Identity/palettes.texinfo +@include Identity/patterns.texinfo +@include Identity/webenv.texinfo diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/chapter.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/chapter.texinfo new file mode 100644 index 0000000..1d735a8 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/chapter.texinfo @@ -0,0 +1,28 @@ +@node Identity +@chapter The @file{Identity} Directory +@cindex The @file{Identity} Directory + +@c -- Chapter Introduction +The @file{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{Identity} directory through the following components: + +@c -- Chapter Menu +@include Identity/chapter-menu.texinfo + +@c -- Chapter Nodes +@include Identity/chapter-nodes.texinfo diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/fonts.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/fonts.texinfo new file mode 100644 index 0000000..524df6f --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/fonts.texinfo @@ -0,0 +1,54 @@ +@node Identity Fonts +@section @file{Identity/Fonts} +@cindex identity fonts + +The @file{Identity/Fonts} directory exists to organize +typographies used inside @value{TCPCVI} that aren't packaged inside +@value{TCD}. + +The @file{Identity/Fonts} directory is under version control. + +Content rendition inside @file{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{Identity/Fonts} directory and create links to them from +@file{~/.fonts} directory. + +@float Example, trunk-identity-fonts-1 +@verbatim +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. + +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{Identity/Fonts} for you to use. + +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{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/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/identity.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/identity.texinfo new file mode 100644 index 0000000..788f31e --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/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/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands-logos.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands-logos.texinfo new file mode 100644 index 0000000..d0fcddb --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands-logos.texinfo @@ -0,0 +1,42 @@ +@node Identity Images Brands Logos +@section @file{Identity/Images/Brands/Logos} +@cindex identity images brands logos + +The @file{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{Identity/Images/Brands/Logos} directory and the files +inside it aren't under version control. + +The @file{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{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{Identity/Images/Brands/Logos} +directory takes place through the following command: + +@verbatim +centos-art render Identity/Images/Brands/Logos --dont-commit-changes +@end verbatim diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands-symbols.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands-symbols.texinfo new file mode 100644 index 0000000..6e78e1f --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands-symbols.texinfo @@ -0,0 +1,40 @@ +@node Identity Images Brands Symbols +@section @file{Identity/Images/Brands/Symbols} +@cindex Identity images brands symbols + +The @file{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 every time 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{Identity/Images/Brands/Symbols} directory and the files +inside it aren't under version control. + +The @file{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{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{Identity/Images/Brands/Symbols} +directory takes place through the following command: + +@verbatim +centos-art render Identity/Images/Brands/Symbols --dont-commit-changes +@end verbatim diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands-types.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands-types.texinfo new file mode 100644 index 0000000..e01fc79 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands-types.texinfo @@ -0,0 +1,44 @@ +@node Identity Images Brands Types +@section @file{Identity/Images/Brands/Types} +@cindex identity images brands types + +The @file{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{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{Identity/Images/Brands/Types} directory contains files +used by no package, as far as we've found out. + +The @file{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{Identity/Images/Brands/Types} +directory takes place through the following command: + +@verbatim +centos-art render Identity/Images/Brands/Types --dont-commit-changes +@end verbatim diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands.texinfo new file mode 100644 index 0000000..5584f10 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-brands.texinfo @@ -0,0 +1,27 @@ +@node Identity Images Brands +@section @file{Identity/Images/Brands} +@cindex identity images brands + +The @file{Identity/Images/Brands} directory exists to organize +brand information related to @value{TCPROJ}. + +The @file{Identity/Images/Brands} directory isn't under version +control. + +The @file{Identity/Images/Brands} contains no file, but the +following organizational directories: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Identity Images Brands Logos} +@item @ref{Identity Images Brands Symbols} +@item @ref{Identity Images Brands Types} +@end itemize +@c -- ]> + +Content rendition inside @file{Identity/Images/Brands} directory +takes place through the following command: + +@verbatim +centos-art render Identity/Images/Brands --dont-commit-changes +@end verbatim diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-icons.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-icons.texinfo new file mode 100644 index 0000000..4ab48dd --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-icons.texinfo @@ -0,0 +1,10 @@ +@node Identity Models Icons +@section @file{Identity/Models/Icons} +@cindex identity models icons + +... + +@c -- <[centos-art(SeeAlso) +@itemize +@end itemize +@c -- ]> diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-themes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-themes.texinfo new file mode 100644 index 0000000..e9d12da --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images-themes.texinfo @@ -0,0 +1,7 @@ +@node Identity Images Themes +@section @file{Identity/Images/Themes} +@cindex identity images themes +... + +@menu +@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images.texinfo new file mode 100644 index 0000000..81cdfa8 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/images.texinfo @@ -0,0 +1,25 @@ +@node Identity Images +@section @file{Identity/Images} +@cindex identity images + +The @file{Identity/Images} directory exists to store all image +files (e.g., PNG, JPG, PPM, etc.) related to @value{TCPCVI}. + +The @file{Identity/Images} directory is under version control. + +The @file{Identity/Images} directory contains no file, but the +following organizational directories: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Identity Images Brands} +@item @ref{Identity Images Themes} +@end itemize +@c -- ]> + +Content rendition inside @file{Identity/Images} directory takes +place through the following command: + +@verbatim +centos-art render Identity/Images --dont-commit-changes +@end verbatim diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models-brands-logos.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models-brands-logos.texinfo new file mode 100644 index 0000000..db72930 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models-brands-logos.texinfo @@ -0,0 +1,8 @@ +@node Identity Models Brands Logos +@section @file{Identity/Models/Brands/Logos} +@cindex identity models brands logos + +... + +@menu +@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models-brands.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models-brands.texinfo new file mode 100644 index 0000000..220e368 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models-brands.texinfo @@ -0,0 +1,9 @@ +@node Identity Models Brands +@section @file{Identity/Models/Brands} +@cindex identity models brands + +... + +@menu +* Identity Models Brands Logos:: +@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models-themes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models-themes.texinfo new file mode 100644 index 0000000..c0561ba --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models-themes.texinfo @@ -0,0 +1,10 @@ +@node Identity Models Themes +@section @file{Identity/Models/Themes} +@cindex identity models themes + +... + +@c -- <[centos-art(SeeAlso) +@itemize +@end itemize +@c -- ]> diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models.texinfo new file mode 100644 index 0000000..4b12b4b --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/models.texinfo @@ -0,0 +1,13 @@ +@node Identity Models +@section @file{Identity/Models} +@cindex identity models + +... + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Identity Models Brands} +@item @ref{Identity Models Icons} +@item @ref{Identity Models Themes} +@end itemize +@c -- ]> diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/palettes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/palettes.texinfo new file mode 100644 index 0000000..b618c74 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/palettes.texinfo @@ -0,0 +1,7 @@ +@node Identity Palettes +@section @file{Identity/Palettes} +@cindex identity palettes +... + +@menu +@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/patterns.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/patterns.texinfo new file mode 100644 index 0000000..c6d5a69 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/patterns.texinfo @@ -0,0 +1,7 @@ +@node Identity Patterns +@section @file{Identity/Patterns} +@cindex identity patterns +... + +@menu +@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/webenv.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/webenv.texinfo new file mode 100644 index 0000000..1f23537 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Identity/webenv.texinfo @@ -0,0 +1,7 @@ +@node Identity Webenv +@section @file{Identity/Webenv} +@cindex identity webenv +... + +@menu +@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Licenses/chapter-nodes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Licenses/chapter-nodes.texinfo index 5db19a5..62f1f60 100755 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Licenses/chapter-nodes.texinfo +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Licenses/chapter-nodes.texinfo @@ -1,9 +1,9 @@ @node GNU General Public License @section GNU General Public License @cindex GNU General Public License -@include trunk/Documentation/Models/Texinfo/Default/en_US/Licenses/GPL.texinfo +@include Documentation/Models/Texinfo/Default/en_US/Licenses/GPL.texinfo @node GNU Free Documentation License @section GNU Free Documentation License @cindex GNU Free Documentation License -@include trunk/Documentation/Models/Texinfo/Default/en_US/Licenses/GFDL.texinfo +@include Documentation/Models/Texinfo/Default/en_US/Licenses/GFDL.texinfo diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/chapter-menu.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/chapter-menu.texinfo new file mode 100644 index 0000000..d5de2d3 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/chapter-menu.texinfo @@ -0,0 +1,4 @@ +@menu +* Scripts Functions:: +* Scripts Functions Prepare:: +@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/chapter-nodes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/chapter-nodes.texinfo new file mode 100644 index 0000000..89f5123 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/chapter-nodes.texinfo @@ -0,0 +1,2 @@ +@include Scripts/functions.texinfo +@include Scripts/functions-prepare.texinfo diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/chapter.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/chapter.texinfo new file mode 100644 index 0000000..9a5e227 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/chapter.texinfo @@ -0,0 +1,75 @@ +@node Scripts +@chapter The @file{Scripts} Directory +@cindex The @file{Scripts} Directory + +@c -- Chapter Introduction + +The @file{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{Scripts} directory and all files inside it are under +version control. + +The @file{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: + +Content rendition inside @file{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 + +@c -- Chapter Menu +@include Identity/chapter-menu.texinfo + +@c -- Chapter Nodes +@include Identity/chapter-nodes.texinfo diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/functions-prepare.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/functions-prepare.texinfo new file mode 100644 index 0000000..43d0fc3 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/functions-prepare.texinfo @@ -0,0 +1,86 @@ +@node Scripts Functions Prepare +@section @file{Scripts/Functions/Prepare} +@cindex Scripts functions prepare + +The @file{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{Scripts/Functions/Prepare} directory and all files +inside it are under version control. + +Content rendition inside @file{Scripts/Functions/Prepare} is not +supported. + +Inside @file{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{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/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/functions.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/functions.texinfo new file mode 100644 index 0000000..eeae3a6 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/functions.texinfo @@ -0,0 +1,69 @@ +@node Scripts Functions +@section @file{Scripts/Functions} +@cindex Scripts functions + +The @file{Scripts/Functions} directory exists to organize common and +specific 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 +specific functionalities to reuse. + +The @file{Scripts/Functions} directory and all files inside it +are under version control. + +Content rendition inside `Scripts/Functions' directory is not +supported. + +Inside @file{Scripts/Functions} directory, specific +functionalities are organized in the following directories: + +@c -- <[centos-art(SeeAlso) +@itemize +@item @ref{Scripts Functions Prepare} +@end itemize +@c -- ]> + +Inside @file{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/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/scripts.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/scripts.texinfo new file mode 100644 index 0000000..e69de29 --- /dev/null +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/Scripts/scripts.texinfo diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Tags/chapter-menu.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Tags/chapter-menu.texinfo deleted file mode 100644 index e69de29..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Tags/chapter-menu.texinfo +++ /dev/null diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Tags/chapter-nodes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Tags/chapter-nodes.texinfo deleted file mode 100644 index 8b13789..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Tags/chapter-nodes.texinfo +++ /dev/null @@ -1 +0,0 @@ - diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Tags/chapter.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Tags/chapter.texinfo deleted file mode 100644 index cfd4897..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Tags/chapter.texinfo +++ /dev/null @@ -1,16 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/chapter-menu.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/chapter-menu.texinfo deleted file mode 100644 index fccaa2d..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/chapter-menu.texinfo +++ /dev/null @@ -1,23 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/chapter-nodes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/chapter-nodes.texinfo deleted file mode 100644 index 1aba12c..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/chapter-nodes.texinfo +++ /dev/null @@ -1,21 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/chapter.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/chapter.texinfo deleted file mode 100644 index 8421fe0..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/chapter.texinfo +++ /dev/null @@ -1,15 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-brushes-corporate.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-brushes-corporate.texinfo deleted file mode 100644 index 265f3fc..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-brushes-corporate.texinfo +++ /dev/null @@ -1,10 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-brushes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-brushes.texinfo deleted file mode 100644 index ec6d853..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-brushes.texinfo +++ /dev/null @@ -1,80 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-fonts.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-fonts.texinfo deleted file mode 100644 index a77a537..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-fonts.texinfo +++ /dev/null @@ -1,54 +0,0 @@ -@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. - -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. - -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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands-logos.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands-logos.texinfo deleted file mode 100644 index 00a2741..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands-logos.texinfo +++ /dev/null @@ -1,42 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands-symbols.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands-symbols.texinfo deleted file mode 100644 index 3ac5b2f..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands-symbols.texinfo +++ /dev/null @@ -1,40 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands-types.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands-types.texinfo deleted file mode 100644 index c1b1f88..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands-types.texinfo +++ /dev/null @@ -1,44 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands.texinfo deleted file mode 100644 index f2d8270..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-brands.texinfo +++ /dev/null @@ -1,27 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-themes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-themes.texinfo deleted file mode 100644 index ea7432e..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images-themes.texinfo +++ /dev/null @@ -1,7 +0,0 @@ -@node Trunk Identity Images Themes -@section @file{trunk/Identity/Images/Themes} -@cindex Trunk identity images themes -... - -@menu -@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images.texinfo deleted file mode 100644 index 2a710e3..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-images.texinfo +++ /dev/null @@ -1,25 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-brands-logos.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-brands-logos.texinfo deleted file mode 100644 index 3e01581..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-brands-logos.texinfo +++ /dev/null @@ -1,8 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-brands.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-brands.texinfo deleted file mode 100644 index e6bd846..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-brands.texinfo +++ /dev/null @@ -1,9 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-icons.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-icons.texinfo deleted file mode 100644 index 2c56d59..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-icons.texinfo +++ /dev/null @@ -1,10 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-themes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-themes.texinfo deleted file mode 100644 index e0c2c6a..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models-themes.texinfo +++ /dev/null @@ -1,10 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models.texinfo deleted file mode 100644 index b725181..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-models.texinfo +++ /dev/null @@ -1,13 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-palettes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-palettes.texinfo deleted file mode 100644 index 1502894..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-palettes.texinfo +++ /dev/null @@ -1,7 +0,0 @@ -@node Trunk Identity Palettes -@section @file{trunk/Identity/Palettes} -@cindex Trunk identity palettes -... - -@menu -@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-patterns.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-patterns.texinfo deleted file mode 100644 index d4cf568..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-patterns.texinfo +++ /dev/null @@ -1,7 +0,0 @@ -@node Trunk Identity Patterns -@section @file{trunk/Identity/Patterns} -@cindex Trunk identity patterns -... - -@menu -@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-webenv.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-webenv.texinfo deleted file mode 100644 index de47fe1..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity-webenv.texinfo +++ /dev/null @@ -1,7 +0,0 @@ -@node Trunk Identity Webenv -@section @file{trunk/Identity/Webenv} -@cindex Trunk identity webenv -... - -@menu -@end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity.texinfo deleted file mode 100644 index 788f31e..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/identity.texinfo +++ /dev/null @@ -1,33 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/scripts-functions-prepare.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/scripts-functions-prepare.texinfo deleted file mode 100644 index 2035cf9..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/scripts-functions-prepare.texinfo +++ /dev/null @@ -1,86 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/scripts-functions.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/scripts-functions.texinfo deleted file mode 100644 index d2e0116..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/scripts-functions.texinfo +++ /dev/null @@ -1,69 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/scripts.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/scripts.texinfo deleted file mode 100644 index 51d2a43..0000000 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/Trunk/scripts.texinfo +++ /dev/null @@ -1,73 +0,0 @@ -@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/Documentation/Models/Texinfo/Tcar-fs/en_US/tcar-fs-menu.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/tcar-fs-menu.texinfo index 2209765..3f09b90 100644 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/tcar-fs-menu.texinfo +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/tcar-fs-menu.texinfo @@ -1,7 +1,6 @@ @menu -* Trunk:: -* Branches:: -* Tags:: +* Identity:: +* Scripts:: * Licenses:: * Index:: @end menu diff --git a/Documentation/Models/Texinfo/Tcar-fs/en_US/tcar-fs-nodes.texinfo b/Documentation/Models/Texinfo/Tcar-fs/en_US/tcar-fs-nodes.texinfo index d30344b..22cefc1 100644 --- a/Documentation/Models/Texinfo/Tcar-fs/en_US/tcar-fs-nodes.texinfo +++ b/Documentation/Models/Texinfo/Tcar-fs/en_US/tcar-fs-nodes.texinfo @@ -1,3 +1,2 @@ -@include Trunk/chapter.texinfo -@include Branches/chapter.texinfo -@include Tags/chapter.texinfo +@include Identity/chapter.texinfo +@include Scripts/chapter.texinfo