diff --git a/Manuals/Tcar-ug/Scripts/Bash/prepare.docbook b/Manuals/Tcar-ug/Scripts/Bash/prepare.docbook index 40c4295..88cf009 100644 --- a/Manuals/Tcar-ug/Scripts/Bash/prepare.docbook +++ b/Manuals/Tcar-ug/Scripts/Bash/prepare.docbook @@ -21,7 +21,7 @@ its absolute path first: - ~/Projects/artwork/trunk/Scripts/centos-art.sh prepare [OPTIONS] + ~/Projects/artwork/trunk/Scripts/Bash/centos-art.sh prepare [OPTIONS] Later, once the centos-art.sh script is @@ -72,8 +72,7 @@ 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 sudo command first, - as described in . + that you configure the sudo command first. @@ -136,7 +135,7 @@ Print the name and value of some of the environment variables used by centos-art.sh scripts as described - in . + in . @@ -170,4 +169,127 @@ patterns and palettes. + + Environment Variables + + + There are some environment variables that you can customize to + fit your personal needs (e.g., default text editor, default + locale information, default time zone representation, etc.). + To customize these variables you need to edit your personal + profile (i.e., ~/.bash_profile) and set the + redefinition there. Notice that you may need to logout and + then do login again in order for the new variable values to + take effect. + + + + Default text editor + + The default text editor information is controlled by the + EDITOR environment variable. The + centos-art.sh script uses the default text + editor to edit subversion pre-commit messages, translation + files, documentation files, script files, and similar + text-based files. + + + + If EDITOR environment variable is not set, + centos-art.sh script uses /usr/bin/vim as default text + editor. Otherwise, the following values are recognized by + centos-art.sh script: + + + + + /usr/bin/vim + + + + + + /usr/bin/emacs + + + + + + /usr/bin/nano + + + + + + + + If no one of these values is set in the EDITOR + environment variable, the centos-art.sh + script uses /usr/bin/vim text editor, the one + installed by default in &TCD;. + + + + + Default locale information + + The default locale information is controlled by the + LANG environment variable. This variable is + initially set in the installation process of &TCD;, + specifically in the Language step. + Generally, there is no need to customize this variable in your + personal profile. If you need to change the value of this + environment variable do it through the login screen of GNOME + Desktop Environment or the + system-config-language command. + + + + The centos-art.sh script uses the + LANG environment variable to determine what + language to use for printing output messages from the script + itself, as well as the portable objects locations that need to + be updated or edited when you localize directory structures + inside the working copy of &TCAR;. + + + + + Default time zone representation + + The time zone representation is a time correction applied to + the system time (stored in the BIOS clock) based on your + country location. This correction is specially useful to + distributed computers around the world that work together and + need to be syncronized in time to know when things happened. + + + &TCAR; is made of one server and several workstations spread + around the world. In order for all these workstations to know + when changes in the server took place, it is required that + they all set their system clocks to use the same time + information (e.g., through UTC (Coordinated Universal Time)) + and set the time correction for their specific countries in + the operating system. Otherwise, it would be difficult to + know when something exactly happened. + + + Generally, setting the time information is a straight-forward + task and configuration tools provided by &TCD; do cover time + correction for most of the countries around the world. + However, if you need a time precision not provided by any of + the date and time configuration tools provided by &TCD; then, + you need to customize the TZ environment + variable in your personal profile to correct the time + information by yourself. The format of TZ + environment variable is described in tzset(3) + manual page. + + + + +