trunk/Scripts/Functions/Prepare
===============================

The trunk/Scripts/Functions/Prepare directory exists to organize the prepare functionality of centos-art.sh script.  The 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 TCAR has been downloaded inside it.

The trunk/Scripts/Functions/Prepare directory and all files inside it are under version control.

Content rendition inside trunk/Scripts/Functions/Prepare is not supported.

Inside trunk/Scripts/Functions/Prepare directory, file names and function names share the same name convenction with the exception that file names end with a .sh suffix while function names doesn't. Both, file names and function names, begin with prepare_ prefix followed by a description of what the function does.

Inside trunk/Scripts/Functions/Prepare directory, you can find the following functions:

 -- Function: prepare
     The prepare (initialization) function creates the base execution environment required to standardize final configuration stuff needed by your workstation, once the working copy of TCAR has been downloaded in it.

 -- Function: prepare_getOptions
     The prepare_getOptions function parses command options provided to centos-art.sh script when the first argument in the command-line is the prepare word. This function decides what action to perform based on options provided. To parse options, this function makes use of getopt program.

 -- Function: prepare_updateLinks
     The prepare_updateLinks function updates the symbolic link relation that connects your workstation with the files inside the working copy of TCAR. This function makes brushes, palettes, patterns and fonts inside the working copy available to programs like GIMP and Inkscape installed in your workstation.

 -- Function: prepare_updateImages
     The 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.

 -- Function: prepare_updateManuals
     The 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.

 -- Function: prepare_updatePackages
     The prepare_updatePackages function verifies the required packages your workstation needs to have installed in order for centos-art.sh script to run correctly. If one or more packages are uninstalled or out of date, the centos-art.sh script asks you to confirm their installation or actualization through the sudo yum command.

 -- Function: prepare_getEnvars
     The prepare_getEnvars function outputs a brief description of relevant environment variables the centos-art.sh script makes use of.

 -- Function: prepare_getLinkName DIRECTORY, FILE
     The prepare_getLinkName function takes a DIRECTORY path as first argument and a FILE path as second argument to output a file name with the path information that remains from substracting the DIRECTORY path from the FILE path provided as argument.