Changeset 514ef84d


Ignore:
Timestamp:
05/06/2005 07:15:52 PM (17 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, ken/refactor-virt, krejzi/svn, lazarus, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
Children:
35f3cb4
Parents:
2c24d1e
Message:

Tagged apache-ant.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3995 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed
  • general/sysutils/apache-ant.xml

    r2c24d1e r514ef84d  
    1414
    1515<sect1 id="apache-ant" xreflabel="Apache Ant-&apache-ant-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="apache-ant.html"?>
    21 <title>Apache Ant-&apache-ant-version;</title>
    22 <indexterm zone="apache-ant">
    23 <primary sortas="a-Apache-Ant">Apache Ant</primary></indexterm>
    24 
    25 <sect2>
    26 <title>Introduction to <application>Apache Ant</application></title>
    27 
    28 <para>The <application>Apache Ant</application> package is a
    29 <application>Java</application>-based build tool. In theory, it is kind of
    30 like <command>make</command>, but without <command>make</command>'s wrinkles.
    31 Ant is different. Instead of a model where it is extended with shell-based
    32 commands, Ant is extended using <application>Java</application> classes.
    33 Instead of writing shell commands, the configuration files are
    34 <acronym>XML</acronym>-based, calling out a target tree where various tasks
    35 get executed. Each task is run by an object that implements a particular task
    36 interface.</para>
    37 
    38 <sect3><title>Package information</title>
    39 <itemizedlist spacing="compact">
    40 <listitem><para>Download (HTTP):
    41 <ulink url="&apache-ant-download-http;"/></para></listitem>
    42 <listitem><para>Download (FTP):
    43 <ulink url="&apache-ant-download-ftp;"/></para></listitem>
    44 <listitem><para>Download MD5 sum: &apache-ant-md5sum;</para></listitem>
    45 <listitem><para>Download size: &apache-ant-size;</para></listitem>
    46 <listitem><para>Estimated disk space required:
    47 &apache-ant-buildsize;</para></listitem>
    48 <listitem><para>Estimated build time:
    49 &apache-ant-time;</para></listitem></itemizedlist>
    50 </sect3>
    51 
    52 <sect3><title>Additional downloads</title>
    53 <itemizedlist spacing="compact">
    54 <listitem><para>Required Patch: <ulink
    55 url="&patch-root;/apache-ant-&apache-ant-version;-blfs_install-1.patch"/></para>
    56 </listitem></itemizedlist>
    57 </sect3>
    58 
    59 <sect3><title><application>Apache Ant</application> dependencies</title>
    60 <sect4><title>Required</title>
    61 <para><xref linkend="jdk"/></para>
    62 </sect4>
    63 </sect3>
    64 
    65 </sect2>
    66 
    67 <sect2>
    68 <title>Installation of <application>Apache Ant</application></title>
    69 
    70 <para>Note: you may need additional libraries to satisify the build
    71 requirements of various packages installed using
    72 <application>Apache Ant</application>. Review the table at
    73 <ulink url="http://ant.apache.org/manual/install.html#librarydependencies"/>
    74 for any prerequisite libraries you may need. One such library is the
    75 <application>JUnit</application> testing framework library. Many Ant-installed
    76 packages will use this library to perform the unit tests during the build
    77 process. To install the JUnit library along with the
    78 <application>Apache Ant</application> package, download it from
    79 <ulink url="http://www.junit.org/"/>, unzip the distribution file (requires
    80 <xref linkend="unzip"/>) and copy the <filename>junit.jar</filename> file
    81 into the <filename class='directory'>lib</filename> subdirectory of the
    82 <application>Apache Ant</application> source tree before beginning the
    83 <application>Apache Ant</application> build.</para>
    84 
    85 <para>Install <application>Apache Ant</application> by running the following
    86 commands:</para>
    87 
    88 <screen><userinput><command>patch -Np1 -i ../apache-ant-&apache-ant-version;-blfs_install-1.patch</command></userinput></screen>
    89 
    90 <para>Now, as the root user:</para>
    91 
    92 <screen><userinput role='root'><command>./build.sh -Ddist.dir=/opt/ant-&apache-ant-version; dist &amp;&amp;
    93 ln -sf /etc/ant /opt/ant-&apache-ant-version;/etc &amp;&amp;
    94 ln -sf ant-&apache-ant-version; /opt/ant</command></userinput></screen>
    95 
    96 </sect2>
    97 
    98 <sect2>
    99 <title>Command explanations</title>
    100 
    101 <para><command>./build.sh -Ddist.dir=/opt/ant-&apache-ant-version;
    102 dist</command>: This command does everything. It builds the package, then
    103 installs the package into
    104 <filename class='directory'>/opt/ant-&apache-ant-version;</filename>.</para>
    105 
    106 <para><command>ln -sf /etc/ant /opt/ant-&apache-ant-version;/etc</command>:
    107 The patch changes the configuration directory to
    108 <filename class='directory'>/etc/ant</filename> to conform with
    109 <acronym>FHS</acronym> guidelines. This command creates a symlink from the
    110 configuration directory back to the installation directory as the package is
    111 expecting to find the files there.</para>
    112 
    113 <para><command>ln -sf ant-&apache-ant-version; /opt/ant</command>: This
    114 command is optional, and creates a convenience symlink.</para>
    115 
    116 </sect2>
    117 
    118 <sect2>
    119 <title>Configuring <application>Apache Ant</application></title>
    120 
    121 <sect3 id="apache-ant-config"><title>Config files</title>
    122 <para><filename>/etc/ant/ant.conf</filename>,
    123 <filename>~/.ant/ant.conf</filename> and
    124 <filename>~/.antrc</filename></para>
    125 <indexterm zone="apache-ant apache-ant-config">
    126 <primary sortas="e-AA.ant-ant.conf">~/.ant/ant.conf</primary></indexterm>
    127 <indexterm zone="apache-ant apache-ant-config">
    128 <primary sortas="e-AA.antrc">~/.antrc</primary></indexterm>
    129 <indexterm zone="apache-ant apache-ant-config">
    130 <primary sortas="e-etc-ant-ant.conf">/etc/ant/ant.conf</primary></indexterm>
    131 </sect3>
    132 
    133 <sect3><title>Configuration Information</title>
    134 <para>Some packages will require <command>ant</command> to be in the search
    135 path and the <envar>$ANT_HOME</envar> environment variable defined.
    136 Satisfy these requirements by adding the following lines to
    137 <filename>/etc/profile</filename> or to individual user's
    138 <filename>~/.profile</filename> or <filename>~/.bashrc</filename> files:</para>
    139 
    140 <screen><userinput>export PATH=$PATH:/opt/ant/bin
    141 export ANT_HOME=/opt/ant</userinput></screen>
    142 </sect3>
    143 
    144 </sect2>
    145 
    146 <sect2>
    147 <title>Contents</title>
    148 
    149 <segmentedlist>
    150 <segtitle>Installed Programs</segtitle>
    151 <segtitle>Installed Libraries</segtitle>
    152 <segtitle>Installed Directories</segtitle>
    153 
    154 <seglistitem>
    155 <seg>ant, antRun, antRun.pl, complete-ant-cmd.pl, runant.pl and runant.py</seg>
    156 <seg>ant-*.jar, xercesImpl.jar and xml-apis.jar</seg>
    157 <seg>/etc/ant and /opt/ant-&apache-ant-version;</seg>
    158 </seglistitem>
    159 </segmentedlist>
    160 
    161 <variablelist>
    162 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    163 <?dbfo list-presentation="list"?>
    164 
    165 <varlistentry id="ant">
    166 <term><command>ant</command></term>
    167 <listitem><para>is a <application>Java</application> based build tool used by
    168 many packages instead of the conventional <command>make</command>
    169 program.</para>
    170 <indexterm zone="apache-ant ant">
    171 <primary sortas="b-ant">ant</primary>
    172 </indexterm></listitem>
    173 </varlistentry>
    174 
    175 <varlistentry id="antRun">
    176 <term><command>antRun</command></term>
    177 <listitem><para>is a support script used to start <command>ant</command>
    178 build scripts in a given directory.</para>
    179 <indexterm zone="apache-ant antRun">
    180 <primary sortas="b-antRun">antRun</primary>
    181 </indexterm></listitem>
    182 </varlistentry>
    183 
    184 <varlistentry id="antRun.pl">
    185 <term><command>antRun.pl</command></term>
    186 <listitem><para>is a <application>Perl</application> script that provides
    187 similar functionality offered by the <command>antRun</command> script.</para>
    188 <indexterm zone="apache-ant antRun.pl">
    189 <primary sortas="b-antRun.pl">antRun.pl</primary>
    190 </indexterm></listitem>
    191 </varlistentry>
    192 
    193 <varlistentry id="complete-ant-cmd.pl">
    194 <term><command>complete-ant-cmd.pl</command></term>
    195 <listitem><para>is a <application>Perl</application> script that allows
    196 <application>Bash</application> to complete an <command>ant</command>
    197 command-line.</para>
    198 <indexterm zone="apache-ant complete-ant-cmd.pl">
    199 <primary sortas="b-complete-ant-cmd.pl">complete-ant-cmd.pl</primary>
    200 </indexterm></listitem>
    201 </varlistentry>
    202 
    203 <varlistentry id="runant.pl">
    204 <term><command>runant.pl</command></term>
    205 <listitem><para>is a <application>Perl</application> wrapper script used to
    206 invoke <command>ant</command>.</para>
    207 <indexterm zone="apache-ant runant.pl">
    208 <primary sortas="b-runant.pl">runant.pl</primary>
    209 </indexterm></listitem>
    210 </varlistentry>
    211 
    212 <varlistentry id="runant.py">
    213 <term><command>runant.py</command></term>
    214 <listitem><para>is a <application>Python</application> wrapper script used to
    215 invoke <command>ant</command>.</para>
    216 <indexterm zone="apache-ant runant.py">
    217 <primary sortas="b-runant.py">runant.py</primary>
    218 </indexterm></listitem>
    219 </varlistentry>
    220 
    221 <varlistentry id="ant-star">
    222 <term><filename class='libraryfile'>ant-*.jar</filename></term>
    223 <listitem><para>files are the <application>Apache Ant</application>
    224 <application>Java</application> class libraries.</para>
    225 <indexterm zone="apache-ant ant-star">
    226 <primary sortas="c-ant-star">ant-*.jar</primary>
    227 </indexterm></listitem>
    228 </varlistentry>
    229 
    230 <varlistentry id="xercesImpl">
    231 <term><filename class='libraryfile'>xercesImpl.jar</filename></term>
    232 <listitem><para>is a <application>Java</application> class library used by
    233 <application>Apache Ant</application> to perform <acronym>XML</acronym>
    234 parsing.</para>
    235 <indexterm zone="apache-ant xercesImpl">
    236 <primary sortas="c-xercesImpl">xercesImpl.jar</primary>
    237 </indexterm></listitem>
    238 </varlistentry>
    239 
    240 <varlistentry id="xml-apis">
    241 <term><filename class='libraryfile'>xml-apis.jar</filename></term>
    242 <listitem><para>contains the <acronym>DOM</acronym>
    243 <application>Java</application> classes required by the
    244 <application>Apache Ant</application> <acronym>XML</acronym> formatter.</para>
    245 <indexterm zone="apache-ant xml-apis">
    246 <primary sortas="c-xml-apis">xml-apis.jar</primary>
    247 </indexterm></listitem>
    248 </varlistentry>
    249 </variablelist>
    250 
    251 </sect2>
     16  <?dbhtml filename="apache-ant.html"?>
     17
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22
     23  <title>Apache Ant-&apache-ant-version;</title>
     24
     25  <indexterm zone="apache-ant">
     26   <primary sortas="a-Apache-Ant">Apache Ant</primary>
     27  </indexterm>
     28
     29  <sect2 role="package">
     30    <title>Introduction to Apache Ant</title>
     31
     32    <para>The <application>Apache Ant</application> package is a
     33    <application>Java</application>-based build tool. In theory, it is kind of like
     34    <command>make</command>, but without <command>make</command>'s wrinkles.
     35    Ant is different. Instead of a model where it is extended with shell-based commands,
     36    Ant is extended using <application>Java</application> classes. Instead of writing
     37    shell commands, the configuration files are XML-based, calling out a target tree where
     38    various tasks get executed. Each task is run by an object that implements a
     39    particular task interface.</para>
     40
     41    <bridgehead renderas="sect3">Package Information</bridgehead>
     42    <itemizedlist spacing="compact">
     43      <listitem>
     44        <para>Download (HTTP): <ulink url="&apache-ant-download-http;"/></para>
     45      </listitem>
     46      <listitem>
     47        <para>Download (FTP): <ulink url="&apache-ant-download-ftp;"/></para>
     48      </listitem>
     49      <listitem>
     50        <para>Download MD5 sum: &apache-ant-md5sum;</para>
     51      </listitem>
     52      <listitem>
     53        <para>Download size: &apache-ant-size;</para>
     54      </listitem>
     55      <listitem>
     56        <para>Estimated disk space required: &apache-ant-buildsize;</para>
     57      </listitem>
     58      <listitem>
     59        <para>Estimated build time: &apache-ant-time;</para>
     60      </listitem>
     61    </itemizedlist>
     62
     63    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     64    <itemizedlist spacing="compact">
     65      <listitem>
     66        <para>Required Patch: <ulink
     67        url="&patch-root;/apache-ant-&apache-ant-version;-blfs_install-1.patch"/></para>
     68      </listitem>
     69    </itemizedlist>
     70
     71    <bridgehead renderas="sect3">Apache Ant Dependencies</bridgehead>
     72
     73    <bridgehead renderas="sect4">Required</bridgehead>
     74    <para><xref linkend="jdk"/></para>
     75
     76  </sect2>
     77
     78  <sect2 role="installation">
     79    <title>Installation of Apache Ant</title>
     80
     81    <note>
     82      <para>You may need additional libraries to satisify the build
     83      requirements of various packages installed using
     84      <application>Apache Ant</application>. Review the table at
     85      <ulink url="http://ant.apache.org/manual/install.html#librarydependencies"/>
     86      for any prerequisite libraries you may need. One such library is the
     87      <application>JUnit</application> testing framework library. Many Ant-installed
     88      packages will use this library to perform the unit tests during the build
     89      process. To install the JUnit library along with the
     90      <application>Apache Ant</application> package, download it from
     91      <ulink url="http://www.junit.org/"/>, unzip the distribution file (requires
     92      <xref linkend="unzip"/>) and copy the <filename>junit.jar</filename> file
     93      into the <filename class='directory'>lib</filename> subdirectory of the
     94      <application>Apache Ant</application> source tree before beginning the
     95      <application>Apache Ant</application> build.</para>
     96    </note>
     97
     98    <para>Install <application>Apache Ant</application> by running the following
     99    commands:</para>
     100
     101<screen><userinput>patch -Np1 -i ../apache-ant-&apache-ant-version;-blfs_install-1.patch</userinput></screen>
     102
     103    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     104
     105<screen role="root"><userinput>./build.sh -Ddist.dir=/opt/ant-&apache-ant-version; dist &amp;&amp;
     106ln -v -sf /etc/ant /opt/ant-&apache-ant-version;/etc &amp;&amp;
     107ln -v -sf ant-&apache-ant-version; /opt/ant</userinput></screen>
     108
     109  </sect2>
     110
     111  <sect2 role="commands">
     112    <title>Command Explanations</title>
     113
     114    <para><command>./build.sh -Ddist.dir=/opt/ant-&apache-ant-version;
     115    dist</command>: This command does everything. It builds the package, then
     116    installs the package into
     117    <filename class='directory'>/opt/ant-&apache-ant-version;</filename>.</para>
     118
     119    <para><command>ln -v -sf /etc/ant /opt/ant-&apache-ant-version;/etc</command>:
     120    The patch changes the configuration directory to
     121    <filename class='directory'>/etc/ant</filename> to conform with
     122    FHS guidelines. This command creates a symlink from the
     123    configuration directory back to the installation directory as the package is
     124    expecting to find the files there.</para>
     125
     126    <para><command>ln -v -sf ant-&apache-ant-version; /opt/ant</command>: This
     127    command is optional, and creates a convenience symlink.</para>
     128
     129  </sect2>
     130
     131  <sect2 role="configuration">
     132    <title>Configuring Apache Ant</title>
     133
     134    <sect3 id="apache-ant-config">
     135      <title>Config files</title>
     136
     137      <para><filename>/etc/ant/ant.conf</filename>,
     138      <filename>~/.ant/ant.conf</filename>, and
     139      <filename>~/.antrc</filename></para>
     140
     141      <indexterm zone="apache-ant apache-ant-config">
     142        <primary sortas="e-AA.ant-ant.conf">~/.ant/ant.conf</primary>
     143      </indexterm>
     144
     145      <indexterm zone="apache-ant apache-ant-config">
     146        <primary sortas="e-AA.antrc">~/.antrc</primary>
     147      </indexterm>
     148
     149      <indexterm zone="apache-ant apache-ant-config">
     150        <primary sortas="e-etc-ant-ant.conf">/etc/ant/ant.conf</primary>
     151      </indexterm>
     152
     153    </sect3>
     154
     155    <sect3>
     156      <title>Configuration Information</title>
     157
     158      <para>Some packages will require <command>ant</command> to be in the search
     159      path and the <envar>$ANT_HOME</envar> environment variable defined.
     160      Satisfy these requirements by adding the following lines to
     161      <filename>/etc/profile</filename> or to individual user's
     162      <filename>~/.profile</filename> or <filename>~/.bashrc</filename> files:</para>
     163
     164<screen><literal>export PATH=$PATH:/opt/ant/bin
     165export ANT_HOME=/opt/ant</literal></screen>
     166
     167    </sect3>
     168
     169  </sect2>
     170
     171  <sect2 role="content">
     172    <title>Contents</title>
     173
     174    <segmentedlist>
     175      <segtitle>Installed Programs</segtitle>
     176      <segtitle>Installed Libraries</segtitle>
     177      <segtitle>Installed Directories</segtitle>
     178
     179      <seglistitem>
     180        <seg>ant, antRun, antRun.pl, complete-ant-cmd.pl, runant.pl, and runant.py</seg>
     181        <seg>ant-*.jar, xercesImpl.jar, and xml-apis.jar</seg>
     182        <seg>/etc/ant and /opt/ant-&apache-ant-version;</seg>
     183      </seglistitem>
     184    </segmentedlist>
     185
     186    <variablelist>
     187      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     188      <?dbfo list-presentation="list"?>
     189      <?dbhtml list-presentation="table"?>
     190
     191      <varlistentry id="ant">
     192        <term><command>ant</command></term>
     193        <listitem>
     194          <para>is a <application>Java</application> based build tool used by
     195          many packages instead of the conventional <command>make</command>
     196          program.</para>
     197          <indexterm zone="apache-ant ant">
     198            <primary sortas="b-ant">ant</primary>
     199          </indexterm>
     200        </listitem>
     201      </varlistentry>
     202
     203      <varlistentry id="antRun">
     204        <term><command>antRun</command></term>
     205        <listitem>
     206          <para>is a support script used to start <command>ant</command>
     207          build scripts in a given directory.</para>
     208          <indexterm zone="apache-ant antRun">
     209            <primary sortas="b-antRun">antRun</primary>
     210          </indexterm>
     211        </listitem>
     212      </varlistentry>
     213
     214      <varlistentry id="antRun.pl">
     215        <term><command>antRun.pl</command></term>
     216        <listitem>
     217          <para>is a <application>Perl</application> script that provides
     218          similar functionality offered by the <command>antRun</command> script.</para>
     219          <indexterm zone="apache-ant antRun.pl">
     220            <primary sortas="b-antRun.pl">antRun.pl</primary>
     221          </indexterm>
     222        </listitem>
     223      </varlistentry>
     224
     225      <varlistentry id="complete-ant-cmd.pl">
     226        <term><command>complete-ant-cmd.pl</command></term>
     227        <listitem>
     228          <para>is a <application>Perl</application> script that allows
     229          <application>Bash</application> to complete an <command>ant</command>
     230          command-line.</para>
     231          <indexterm zone="apache-ant complete-ant-cmd.pl">
     232            <primary sortas="b-complete-ant-cmd.pl">complete-ant-cmd.pl</primary>
     233          </indexterm>
     234        </listitem>
     235      </varlistentry>
     236
     237      <varlistentry id="runant.pl">
     238        <term><command>runant.pl</command></term>
     239        <listitem>
     240          <para>is a <application>Perl</application> wrapper script used to
     241          invoke <command>ant</command>.</para>
     242          <indexterm zone="apache-ant runant.pl">
     243            <primary sortas="b-runant.pl">runant.pl</primary>
     244          </indexterm>
     245        </listitem>
     246      </varlistentry>
     247
     248      <varlistentry id="runant.py">
     249        <term><command>runant.py</command></term>
     250        <listitem>
     251          <para>is a <application>Python</application> wrapper script used to
     252          invoke <command>ant</command>.</para>
     253          <indexterm zone="apache-ant runant.py">
     254            <primary sortas="b-runant.py">runant.py</primary>
     255          </indexterm>
     256        </listitem>
     257      </varlistentry>
     258
     259      <varlistentry id="ant-star">
     260        <term><filename class='libraryfile'>ant-*.jar</filename></term>
     261        <listitem>
     262          <para>files are the <application>Apache Ant</application>
     263          <application>Java</application> class libraries.</para>
     264          <indexterm zone="apache-ant ant-star">
     265            <primary sortas="c-ant-star">ant-*.jar</primary>
     266          </indexterm>
     267        </listitem>
     268      </varlistentry>
     269
     270      <varlistentry id="xercesImpl">
     271        <term><filename class='libraryfile'>xercesImpl.jar</filename></term>
     272        <listitem>
     273          <para>is a <application>Java</application> class library used by
     274          <application>Apache Ant</application> to perform XML parsing.</para>
     275          <indexterm zone="apache-ant xercesImpl">
     276            <primary sortas="c-xercesImpl">xercesImpl.jar</primary>
     277          </indexterm>
     278        </listitem>
     279      </varlistentry>
     280
     281      <varlistentry id="xml-apis">
     282        <term><filename class='libraryfile'>xml-apis.jar</filename></term>
     283        <listitem>
     284          <para>contains the DOM <application>Java</application> classes required
     285          by the <application>Apache Ant</application> XML formatter.</para>
     286          <indexterm zone="apache-ant xml-apis">
     287            <primary sortas="c-xml-apis">xml-apis.jar</primary>
     288          </indexterm>
     289        </listitem>
     290      </varlistentry>
     291
     292    </variablelist>
     293
     294  </sect2>
    252295
    253296</sect1>
Note: See TracChangeset for help on using the changeset viewer.