| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd"> |
| <html> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <head> |
| <title>CentOS Artwork Repository: 3.34 trunk/Scripts/Bash</title> |
| |
| <meta name="description" content="CentOS Artwork Repository: 3.34 trunk/Scripts/Bash"> |
| <meta name="keywords" content="CentOS Artwork Repository: 3.34 trunk/Scripts/Bash"> |
| <meta name="resource-type" content="document"> |
| <meta name="distribution" content="global"> |
| <meta name="Generator" content="texi2html 1.76"> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| <style type="text/css"> |
| <!-- |
| @import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css"; |
| |
| a.summary-letter {text-decoration: none} |
| pre.display {font-family: serif} |
| pre.format {font-family: serif} |
| pre.menu-comment {font-family: serif} |
| pre.menu-preformatted {font-family: serif} |
| pre.smalldisplay {font-family: serif; font-size: smaller} |
| pre.smallexample {font-size: smaller} |
| pre.smallformat {font-family: serif; font-size: smaller} |
| pre.smalllisp {font-size: smaller} |
| span.sansserif {font-family:sans-serif; font-weight:normal;} |
| ul.toc {list-style: none} |
| --> |
| </style> |
| |
| |
| </head> |
| |
| <body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> |
| |
| <table cellpadding="1" cellspacing="1" border="0"> |
| <tr><td valign="middle" align="left">[<a href="repository_36.html#SEC194" title="Previous section in reading order"> < </a>]</td> |
| <td valign="middle" align="left">[<a href="#SEC196" title="Next section in reading order"> > </a>]</td> |
| <td valign="middle" align="left"> </td> |
| <td valign="middle" align="left">[<a href="repository_3.html#SEC3" title="Beginning of this chapter or previous chapter"> << </a>]</td> |
| <td valign="middle" align="left">[<a href="repository_3.html#SEC3" title="Up section"> Up </a>]</td> |
| <td valign="middle" align="left">[<a href="repository_62.html#SEC346" title="Next chapter"> >> </a>]</td> |
| <td valign="middle" align="left"> </td> |
| <td valign="middle" align="left"> </td> |
| <td valign="middle" align="left"> </td> |
| <td valign="middle" align="left"> </td> |
| <td valign="middle" align="left">[<a href="repository.html#SEC_Top" title="Cover (top) of document">Top</a>]</td> |
| <td valign="middle" align="left">[<a href="repository_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td> |
| <td valign="middle" align="left">[<a href="repository_62.html#SEC346" title="Index">Index</a>]</td> |
| <td valign="middle" align="left">[<a href="repository_abt.html#SEC_About" title="About (help)"> ? </a>]</td> |
| </tr></table> |
| <a name="trunk-Scripts-Bash"></a> |
| <a name="SEC195"></a> |
| <h2 class="section"> 3.34 trunk/Scripts/Bash </h2> |
| |
| |
| <a name="SEC196"></a> |
| <h3 class="subsection"> 3.34.1 Goals </h3> |
| |
| <p>The <tt>`trunk/Scripts/Bash'</tt> directory exists to organize the |
| "trunk" development line of <code>centos-art.sh</code> automation |
| script. The <code>centos-art.sh</code> script standardize frequent tasks |
| inside your working copy of CentOS Artwork Repository. |
| </p> |
| |
| <a name="SEC197"></a> |
| <h3 class="subsection"> 3.34.2 Description </h3> |
| |
| <p>The best way to understand <code>centos-art.sh</code> automation script |
| is studying its source code. The <code>centos-art.sh</code> script is |
| splited in several configuration and function files which are loaded |
| when the <code>centos-art.sh</code> script is executed. This section |
| describes the order in which <code>centos-art.sh</code> loads its |
| configuration and function files. |
| </p> |
| <p>When you type the <code>centos-art</code> command in your terminal, the |
| operating system trys to execute that command. In order to execute the |
| command, the operating system needs to know where it is, so the |
| operating system uses the <var>PATH</var> environment variable to look for |
| that command's location. If your system was prepared to use CentOS |
| Artwork Repository correctly (see usage section above), you should |
| have a symbolic link inside <tt>`~/bin/'</tt> directory that points to the |
| <code>centos-art.sh</code> script file. As <tt>`~/bin/'</tt> directory is, by |
| default, inside <var>PATH</var> environment variable, the execution of |
| <code>centos-art</code> command runs the <tt>`centos-art.sh'</tt> script. |
| </p> |
| <p>When <code>centos-art.sh</code> script is executed, the first it does is |
| execute the <tt>`trunk/Scripts/Bash/initFunctions.sh'</tt> file to |
| initialize <code>gettext</code> variables and all function scripts inside |
| <tt>`trunk/Scripts/Bash/Functions'</tt> directory. |
| </p> |
| <p>Once <code>gettext</code> variables and all function scripts have been |
| initialized, the <code>centos-art.sh</code> script initializes its |
| environment variables using the <code>cli_getVariables</code> function. |
| At this point the <code>centos-art.sh</code> script calls the |
| <code>cli_getActions</code> function from <code>cli_getVariables</code> |
| function's bottom. |
| </p> |
| <p>The <code>cli_getActions</code> function defines which actions the |
| <code>centos-art.sh</code> script is able to perform. Inside |
| <code>cli_getActions</code> function, actions are defined combining |
| positional arguments and function calls. |
| </p> |
| <div class="float"><a name="fig_003atrunk_002fScripts_002fBash_003aInitialization"></a> |
| <pre class="verbatim">+------------------------------------------------------------------+ |
| | [centos@host]$ centos-art action 'path/to/dir' --option='value' | |
| +------------------------------------------------------------------+ |
| | ~/bin/centos-art --> ~/artwork/trunk/Scripts/Bash/centos-art.sh | |
| +---v-----------------------------------------v--------------------+ |
| | centos-art.sh | |
| +---v---------------------------------v---+ |
| . | initFunctions.sh | . |
| . +---------------------------------+ . |
| . | cli_getVariables $@ | . |
| . +---v-------------------------v---+ . |
| . . | cli_getActions | . . |
| . . +---v-----------------v---+ . . |
| . . . | function call 1 | . . . |
| . . . | function call 2 | . . . |
| . . . | function call n | . . . |
| . . . +-----------------+ . . . |
| . . ........................... . . |
| . ................................... . |
| ........................................... |
| </pre> |
| </div><p><strong>Figure 3.5: The <code>centos-art.sh</code> initialization environment. |
| </strong> |
| </p> |
| |
| <a name="SEC198"></a> |
| <h4 class="subsubsection"> 3.34.2.1 The identity matching list </h4> |
| |
| <p>The identity matching list is used by identity rendering functions to |
| define the relation between translation files and identity design |
| templates. |
| </p> |
| |
| <a name="SEC199"></a> |
| <h4 class="subsubsection"> 3.34.2.2 Adding new features </h4> |
| |
| <p>To add new features inside <code>centos-art.sh</code> script, you need to |
| set positional arguments and function calls inside |
| <code>cli_getActions</code> function for the new function or functions |
| required by the new feature you want to add. |
| </p> |
| |
| <a name="SEC200"></a> |
| <h3 class="subsection"> 3.34.3 Usage </h3> |
| |
| |
| <a name="SEC201"></a> |
| <h4 class="subsubsection"> 3.34.3.1 The <code>centos-art</code> <samp>`search'</samp> action </h4> |
| |
| <p>This feature is not supported yet. |
| </p> |
| <dl compact="compact"> |
| <dt> <samp>`centos-art search 'pattern''</samp> </dt> |
| <dd> |
| <p>Use this command to find directories and files that match exactly the |
| posix-regular expression set in <samp>`pattern'</samp> as in <samp>`^pattern$'</samp>. |
| </p> |
| </dd> |
| <dt> <samp>`centos-art search 'pattern1 pattern2 patternN''</samp> </dt> |
| <dd> |
| <p>Use this command to search repository entries that match pattern1 |
| <em>or</em> patter2 <em>or</em> patternN as in |
| <samp>`'^.*(pattern1|pattern2|patternN).*$''</samp>. |
| </p> |
| </dd> |
| <dt> <samp>`centos-art search 'path/to/dir1 path/to/dir2 path/to/dirN''</samp> </dt> |
| <dd> |
| <p>Use this command to search repository entries that match |
| <samp>`path/to/dir1'</samp> <em>or</em> <samp>`path/to/dir2'</samp>, <em>or</em> |
| <samp>`path/to/dirN'</samp> as in |
| <samp>`^.*(path/to/dir1|path/to/dir2|path/to/dirN).*$''</samp>. |
| </p></dd> |
| </dl> |
| |
| |
| <a name="SEC202"></a> |
| <h4 class="subsubsection"> 3.34.3.2 The <code>centos-art</code> <samp>`locale-art'</samp> action </h4> |
| |
| <p>This feature is not supported yet. |
| </p> |
| <dl compact="compact"> |
| <dt> <samp>`centos-art locale-art 'path/to/dir' --edit'</samp></dt> |
| <dt> <samp>`centos-art locale-art 'path/to/dir' --edit='filename''</samp></dt> |
| <dt> <samp>`centos-art locale-art 'path/to/dir' --list'</samp></dt> |
| <dt> <samp>`centos-art locale-art 'path/to/dir' --list='filename''</samp></dt> |
| </dl> |
| |
| |
| <a name="SEC203"></a> |
| <h4 class="subsubsection"> 3.34.3.3 The <code>centos-art</code> <samp>`license'</samp> action </h4> |
| |
| <p>This feature is supported through the following command: |
| </p> |
| <dl compact="compact"> |
| <dt> <samp>`centos-art license'</samp></dt> |
| <dd><p>Use this command to see a brief description of <code>centos-art</code> |
| command its copyright and its license notes. |
| </p></dd> |
| </dl> |
| |
| |
| <a name="SEC204"></a> |
| <h3 class="subsection"> 3.34.4 See also </h3> |
| |
| <table class="menu" border="0" cellspacing="0"> |
| <tr><td align="left" valign="top"><a href="repository_38.html#SEC205">3.35 trunk/Scripts/Bash/Functions</a></td><td> </td><td align="left" valign="top"> |
| </td></tr> |
| <tr><td align="left" valign="top"><a href="repository_48.html#SEC261">3.45 trunk/Scripts/Bash/Locale</a></td><td> </td><td align="left" valign="top"> |
| </td></tr> |
| <tr><td align="left" valign="top"><a href="repository_36.html#SEC190">3.33 trunk/Scripts</a></td><td> </td><td align="left" valign="top"> |
| </td></tr> |
| </table> |
| |
| |
| <table cellpadding="1" cellspacing="1" border="0"> |
| <tr><td valign="middle" align="left">[<a href="#SEC203" title="Previous section in reading order"> < </a>]</td> |
| <td valign="middle" align="left">[<a href="repository_38.html#SEC205" title="Next section in reading order"> > </a>]</td> |
| <td valign="middle" align="left"> </td> |
| <td valign="middle" align="left">[<a href="repository_3.html#SEC3" title="Beginning of this chapter or previous chapter"> << </a>]</td> |
| <td valign="middle" align="left">[<a href="#SEC195" title="Up section"> Up </a>]</td> |
| <td valign="middle" align="left">[<a href="repository_62.html#SEC346" title="Next chapter"> >> </a>]</td> |
| </tr></table> |
| <p> |
| <font size="-1"> |
| This document was generated on <i>November, 1 2010</i> using <a href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>. |
| </font> |
| <br> |
| |
| </p> |
| </body> |
| </html> |