diff --git a/Manuals/Tcar-ug/Scripts/Bash/prepare.docbook b/Manuals/Tcar-ug/Scripts/Bash/prepare.docbook index e48e83d..fdc9d5e 100644 --- a/Manuals/Tcar-ug/Scripts/Bash/prepare.docbook +++ b/Manuals/Tcar-ug/Scripts/Bash/prepare.docbook @@ -5,9 +5,8 @@ The prepare functionality is the interface the centos-art.sh script provides - to standardize the final configuration stuff your workstation - needs, once the working copy of &TCAR; has been downloaded - inside it already. + to standardize the content production tasks inside the working + copy. @@ -15,26 +14,27 @@ Assuming this is the very first time you run the - centos-art.sh script, you'll find that - it isn't found in your workstation. This is correct because - you haven't created the symbolic link that make it available - in the execution path, yet. In order to make the - centos-art.sh script available in the - execution path of your workstation, you need to run it using - its absolute path first: + centos-art command, you'll find that there + isn't such a command in your workstation. This is correct + because you haven't created the symbolic link that makes it + available in your execution path, yet. In order to make the + centos-art command available in the + execution path of your workstation, you need to run the + centos-art.sh script using its absolute + path first: ~/artwork/trunk/Scripts/Bash/centos-art.sh prepare [OPTIONS] - Later, once the centos-art.sh script is - available in the execution path of your system, there is no - need for you to use the absolute path again. From this time - on, you can use the centos-art command-line - interface directly, as the following example describes: + Later, once the centos-art command is + available in your execution path, there is no need for you to + use any absolute path again. From this time on, you can use + the centos-art command-line interface + directly, as the following example describes: - centos-art prepare [OPTIONS] + centos-env prepare [OPTIONS] @@ -42,8 +42,9 @@ Options - The prepare functionality accepts the - following options: + When the centos-art command is executed + with the prepare functionality, it + accepts the following options: @@ -72,16 +73,15 @@ - This option verifies packeges required by - centos-art.sh script. installs or updates - required packages. When required packages aren't installed, - this option uses sudo yum install command - to perform the installation task. When required packages are - installed, this option uses sudo yum update - to update them, if there is any related actualization to be - applied on. In both cases, it is required that you configure - the /etc/sudoers configuration file - first, as discribed in . + This option verifies packeges required by automation scripts + and installs or updates them as required. When required + packages aren't installed or need to be updated, the + centos-art uses the sudo + and yum to perform either installations or + actualizations tasks. In both cases, it is required that you + configure the /etc/sudoers configuration + file first, as discribed in . @@ -91,12 +91,12 @@ - This option creates or updates the machine object (MO) file - used by gettext to retrive - translated strings when centos-art.sh - script is running. This option is a call to the - option of - locale functionality, as described in + This option creates or updates the portable objects (PO) and + machine object (MO) used by gettext + to retrive translated strings related to + centos-art.sh script. This option calls + the locale functionality of centos-art.sh + with the option, as described in . @@ -109,7 +109,7 @@ This option maintains the file relation between your working copy and configuration files inside your workstation through symbolic links. When you provide this option, the - centos-art.sh puts itself into your + centos-art.sh script puts itself into your system's execution path through its command line interface centos-art and makes common brushes, patterns, palettes and fonts inside the working copy, @@ -133,10 +133,10 @@ This option initializes image files inside the working copy. When you provide this option, the - centos-art.sh scripts renders image files - from all design models available in the working copy. This - step is required in order to satisfy file dependencies among - different components inside the working copy. + centos-art.sh calls the + render functionality to create images + related to each design model available in your working copy, + as described in . @@ -147,9 +147,10 @@ This option initializes documentation files inside the working copy. When you provide this option, the - centos-art.sh script renders all - documentation manuals from their related source files to - different output formats, so you can read them nicely. + centos-art.sh script calls both the + render and help + functionality to produce DocBook and Texinfo manuals, + respectively. @@ -159,7 +160,7 @@ Print the name and value of some of the environment variables - used by centos-art.sh scripts as described + used by centos-art.sh script as described in . @@ -187,11 +188,11 @@ uses the , , , and - options as default behaviour. - Otherwise, if you provide any option, the + options, in that order, as default + behaviour. Otherwise, if you provide any option, the centos-art.sh script avoids its default behaviour and executes the prepare - functionality as specified by the options you provides. + functionality as specified by the options you provided.