Blame Manuals/Tcar-ug/Scripts/Bash/prepare.docbook

e68d9f
<sect1 id="scripts-bash-prepare">
d2638e
271f91
    <title>Standardizing Configuration Tasks</title>
eebdc3
eebdc3
    <para>
d2638e
        The <function>prepare</function> functionality is the
d2638e
        interface the <command>centos-art.sh</command> script provides
d2638e
        to standardize the final configuration stuff your workstation
d2638e
        needs, once the working copy of &TCAR; has been downloaded
d2638e
        inside it already.
d2638e
    </para>
d2638e
d2638e
    <para>
eebdc3
        Assuming this is the very first time you run the
eebdc3
        <command>centos-art.sh</command> script, you'll find that
eebdc3
        it isn't found in your workstation.  This is correct because
a714a6
        you haven't created the symbolic link that make it available
a714a6
        in the execution path, yet. In order to make the
a714a6
        <command>centos-art.sh</command> script available in the
a714a6
        execution path of your workstation, you need to run it using
a714a6
        its absolute path first:
eebdc3
    </para>
eebdc3
eebdc3
    <screen>~/artwork/trunk/Scripts/centos-art.sh prepare [OPTIONS]</screen>
eebdc3
eebdc3
    <para>
eebdc3
        Later, once the <command>centos-art.sh</command> script is
eebdc3
        available in the execution path of your system, there is no
eebdc3
        need for you to use the absolute path again.  From this time
eebdc3
        on, you can use the <command>centos-art</command> command-line
eebdc3
        interface directly, as the following example describes:
eebdc3
    </para>
eebdc3
eebdc3
    <screen>centos-art prepare [OPTIONS]</screen>
eebdc3
eebdc3
    <para>
d2638e
        The <function>prepare</function> functionality accepts the
d2638e
        following options: 
d2638e
    </para>
d2638e
d2638e
    <variablelist>
d2638e
    <varlistentry>
d2638e
    <term><option>--quiet</option></term>
d2638e
    <listitem>
d2638e
    <para>
d2638e
        Supress all output messages except error messages.  When this
d2638e
        option is passed, all confirmation requests are supressed and
d2638e
        a possitive answer is assumed for them, just as if the
a714a6
        <option>--answer-yes</option> option whould have been provided.
d2638e
    </para>
d2638e
    </listitem>
d2638e
    </varlistentry>
d2638e
d2638e
    <varlistentry>
d2638e
    <term><option>--answer-yes</option></term>
d2638e
    <listitem>
d2638e
    <para>
d2638e
       Assume <emphasis>yes</emphasis> to all confirmation requests.
d2638e
    </para>
d2638e
    </listitem>
d2638e
    </varlistentry>
d2638e
d2638e
    <varlistentry>
d2638e
    <term><option>--packages</option></term>
d2638e
    <listitem>
d2638e
    <para>
a714a6
        This option verifies packeges required by
a714a6
        <command>centos-art.sh</command> script. installs or updates
a714a6
        required packages. When required packages aren't installed,
a714a6
        this option uses <command>sudo yum install</command>
a714a6
        command to perform the installation task. When required
a714a6
        packages are installed, this option uses <command>sudo yum
a714a6
        update</command> to update them, if there is any related
a714a6
        actualization to be applied on. In both cases, it is required
a714a6
        that you configure the <command>sudo</command> command first,
a714a6
        as described in <xref linkend="repo-ws-config-sudo" />.
d2638e
    </para>
d2638e
    </listitem>
d2638e
    </varlistentry>
d2638e
d2638e
    <varlistentry>
d2638e
    <term><option>--links</option></term>
d2638e
    <listitem>
d2638e
    <para>
a714a6
        This option maintains the file relation between your working
a714a6
        copy and configuration files inside your workstation through
a714a6
        symbolic links. When you provide this option, the
a714a6
        <command>centos-art.sh</command> puts itself into your
a714a6
        system's execution path through its command line interface
a714a6
        <command>centos-art</command> and makes common brushes,
a714a6
        patterns, palettes and fonts inside the working copy,
a714a6
        available to applications like GIMP in order for you to make
a714a6
        use of them without loosing version control over them.
d2638e
    </para>
a2d108
    <caution>
a2d108
    <para>
a2d108
        This option removes all common fonts, brushes, patterns, and
a714a6
        palettes currently installed in your home directory, in order
a714a6
        to create a fresh installation of them all again, using the
a2d108
        working copy as reference.
a2d108
    </para>
a2d108
    </caution>
d2638e
    </listitem>
d2638e
    </varlistentry>
d2638e
    
d2638e
    <varlistentry>
d2638e
    <term><option>--images</option></term>
d2638e
    <listitem>
d2638e
    <para>
d2638e
        This option initializes image files inside the working copy.
d2638e
        When you provide this option, the
d2638e
        <command>centos-art.sh</command> scripts renders image files
d2638e
        from all design models available in the working copy. This
a714a6
        step is required in order to satisfy file dependencies among
d2638e
        different components inside the working copy.
d2638e
    </para>
d2638e
    </listitem>
d2638e
    </varlistentry>
d2638e
d2638e
    <varlistentry>
d2638e
    <term><option>--manuals</option></term>
d2638e
    <listitem>
d2638e
    <para>
d2638e
       This option initializes documentation files inside the working
d2638e
       copy. When you provide this option, the
d2638e
       <command>centos-art.sh</command> script renders all
a714a6
       documentation manuals from their related source files to
a714a6
       different output formats, so you can read them nicely.
eebdc3
    </para>
d2638e
    </listitem>
d2638e
    </varlistentry>
d2638e
d2638e
    <varlistentry>
d2638e
    <term><option>--environment</option></term>
d2638e
    <listitem>
d2638e
    <para>
d2638e
       Print the name and value of some of the environment variables
a714a6
       used by <command>centos-art.sh</command> scripts as described
a714a6
       in <xref linkend="repo-ws-config-envar" />.  
d2638e
    </para>
d2638e
    </listitem>
d2638e
    </varlistentry>
d2638e
    </variablelist>
d2638e
d2638e
    <para>
a714a6
        When no option is provided to <function>prepare</function>
a714a6
        functionality, the <command>centos-art.sh</command> script
a714a6
        uses the <option>--packages</option>,
a714a6
        <option>--links</option>, <option>--images</option> and
a714a6
        <option>--manuals</option> options as default behaviour.
a714a6
        Otherwise, if you provide any option, the
a714a6
        <command>centos-art.sh</command> script avoids its default
a714a6
        behaviour and executes the <function>prepare</function>
a714a6
        functionality as specified by the options you provides.
d2638e
    </para>
d2638e
d2638e
    <para>
a714a6
        Notice that it is possible for you to execute the
d2638e
        <function>prepare</function> functionality as much times as
d2638e
        you need to.  This is specially useful when you need to keep
d2638e
        syncronized the relation between content produced inside your
d2638e
        working copy and the applications you use outside it. For
d2638e
        example, considering you've added new brushes to or removed
d2638e
        old brushes from your working copy of &TCAR;, the link
d2638e
        information related to those files need to be updated in the
d2638e
        <filename class="directory">~/.gimp-2.2/brushes</filename>
d2638e
        directory too, in a way the addition/deletion change that took
d2638e
        place in your working copy can be reflected there, as well.
d2638e
        The same is true for other similar components like fonts,
d2638e
        patterns and palettes.
d2638e
    </para>
d2638e
e68d9f
</sect1>