r3357 - in trunk/BOOK: general/sysutils introduction/welcome

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sat Jan 29 10:00:28 PST 2005


Author: randy
Date: 2005-01-29 11:00:27 -0700 (Sat, 29 Jan 2005)
New Revision: 3357

Modified:
   trunk/BOOK/general/sysutils/apache-ant.xml
   trunk/BOOK/introduction/welcome/changelog.xml
Log:
Added program/library descriptions and indexing tags to Apache Ant

Modified: trunk/BOOK/general/sysutils/apache-ant.xml
===================================================================
--- trunk/BOOK/general/sysutils/apache-ant.xml	2005-01-29 16:43:47 UTC (rev 3356)
+++ trunk/BOOK/general/sysutils/apache-ant.xml	2005-01-29 18:00:27 UTC (rev 3357)
@@ -19,6 +19,8 @@
 </sect1info>
 <?dbhtml filename="apache-ant.html"?>
 <title>Apache Ant-&apache-ant-version;</title>
+<indexterm zone="apache-ant">
+<primary sortas="a-Apache-Ant">Apache Ant</primary></indexterm>
 
 <sect2>
 <title>Introduction to <application>Apache Ant</application></title>
@@ -66,7 +68,8 @@
 <title>Installation of <application>Apache Ant</application></title>
 
 <para>Note: you may need additional libraries to satisify the build 
-requirements of various packages. Review the table at 
+requirements of various packages installed using 
+<application>Apache Ant</application>. Review the table at 
 <ulink url="http://ant.apache.org/manual/install.html#librarydependencies"/> 
 for any prerequisite libraries you may need. One such library is the 
 <application>JUnit</application> testing framework library. Many Ant-installed 
@@ -82,8 +85,11 @@
 <para>Install <application>Apache Ant</application> by running the following 
 commands:</para>
 
-<screen><userinput><command>patch -Np1 -i ../apache-ant-&apache-ant-version;-blfs_install-1.patch &&
-./build.sh -Ddist.dir=/opt/ant-&apache-ant-version; dist &&
+<screen><userinput><command>patch -Np1 -i ../apache-ant-&apache-ant-version;-blfs_install-1.patch</command></userinput></screen>
+
+<para>Now, as the root user:</para>
+
+<screen><userinput role='root'><command>./build.sh -Ddist.dir=/opt/ant-&apache-ant-version; dist &&
 ln -sf /etc/ant /opt/ant-&apache-ant-version;/etc &&
 ln -sf ant-&apache-ant-version; /opt/ant</command></userinput></screen>
 
@@ -112,10 +118,16 @@
 <sect2>
 <title>Configuring <application>Apache Ant</application></title>
 
-<sect3><title>Config files</title>
+<sect3 id="apache-ant-config"><title>Config files</title>
 <para><filename>/etc/ant/ant.conf</filename>, 
 <filename>~/.ant/ant.conf</filename> and 
 <filename>~/.antrc</filename></para>
+<indexterm zone="apache-ant apache-ant-config">
+<primary sortas="e-AA.ant-ant.conf">~/.ant/ant.conf</primary></indexterm>
+<indexterm zone="apache-ant apache-ant-config">
+<primary sortas="e-AA.antrc">~/.antrc</primary></indexterm>
+<indexterm zone="apache-ant apache-ant-config">
+<primary sortas="e-etc-ant-ant.conf">/etc/ant/ant.conf</primary></indexterm>
 </sect3>
 
 <sect3><title>Configuration Information</title>
@@ -127,7 +139,6 @@
 
 <screen><userinput>export PATH=$PATH:/opt/ant/bin
 export ANT_HOME=/opt/ant</userinput></screen>
-
 </sect3>
 
 </sect2>
@@ -135,25 +146,109 @@
 <sect2>
 <title>Contents</title>
 
-<para>The <application>Apache Ant</application> package contains 
-<command>ant</command>, 
-<command>antRun</command>, 
-<command>antRun.pl</command>, 
-<command>complete-ant-cmd.pl</command>, 
-<command>runant.pl</command>, 
-<command>runant.py</command> and 
-<filename>*.jar</filename> files.</para>
+<segmentedlist>
+<segtitle>Installed Programs</segtitle>
+<segtitle>Installed Libraries</segtitle>
+<segtitle>Installed Directories</segtitle>
 
-</sect2>
+<seglistitem>
+<seg>ant, antRun, antRun.pl, complete-ant-cmd.pl, runant.pl and runant.py</seg>
+<seg>ant-*.jar, xercesImpl.jar and xml-apis.jar</seg>
+<seg>/etc/ant and /opt/ant-&apache-ant-version;</seg>
+</seglistitem>
+</segmentedlist>
 
-<sect2><title>Description</title>
+<variablelist>
+<bridgehead renderas="sect3">Short Descriptions</bridgehead>
+<?dbfo list-presentation="list"?>
 
-<sect3><title>ant</title>
-<para><command>ant</command> is a <application>Java</application> based 
-build tool used by many packages instead of the conventional 
-<command>make</command> program.</para>
-</sect3>
+<varlistentry id="ant">
+<term><command>ant</command></term>
+<listitem><para>is a <application>Java</application> based build tool used by 
+many packages instead of the conventional <command>make</command> 
+program.</para>
+<indexterm zone="apache-ant ant">
+<primary sortas="b-ant">ant</primary>
+</indexterm></listitem>
+</varlistentry>
 
+<varlistentry id="antRun">
+<term><command>antRun</command></term>
+<listitem><para>is a support script used to start <command>ant</command> 
+build scripts in a given directory.</para>
+<indexterm zone="apache-ant antRun">
+<primary sortas="b-antRun">antRun</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="antRun.pl">
+<term><command>antRun.pl</command></term>
+<listitem><para>is a <application>Perl</application> script that provides 
+similar functionality offered by the <command>antRun</command> script.</para>
+<indexterm zone="apache-ant antRun.pl">
+<primary sortas="b-antRun.pl">antRun.pl</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="complete-ant-cmd.pl">
+<term><command>complete-ant-cmd.pl</command></term>
+<listitem><para>is a <application>Perl</application> script that allows 
+<application>Bash</application> to complete an <command>ant</command> 
+command-line.</para>
+<indexterm zone="apache-ant complete-ant-cmd.pl">
+<primary sortas="b-complete-ant-cmd.pl">complete-ant-cmd.pl</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="runant.pl">
+<term><command>runant.pl</command></term>
+<listitem><para>is a <application>Perl</application> wrapper script used to 
+invoke <command>ant</command>.</para>
+<indexterm zone="apache-ant runant.pl">
+<primary sortas="b-runant.pl">runant.pl</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="runant.py">
+<term><command>runant.py</command></term>
+<listitem><para>is a <application>Python</application> wrapper script used to 
+invoke <command>ant</command>.</para>
+<indexterm zone="apache-ant runant.py">
+<primary sortas="b-runant.py">runant.py</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="ant-star">
+<term><filename class='libraryfile'>ant-*.jar</filename></term>
+<listitem><para>files are the <application>Apache Ant</application> 
+<application>Java</application> class libraries.</para>
+<indexterm zone="apache-ant ant-star">
+<primary sortas="c-ant-star">ant-*.jar</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="xercesImpl">
+<term><filename class='libraryfile'>xercesImpl.jar</filename></term>
+<listitem><para>is a <application>Java</application> class library used by 
+<application>Apache Ant</application> to perform <acronym>XML</acronym> 
+parsing.</para>
+<indexterm zone="apache-ant xercesImpl">
+<primary sortas="c-xercesImpl">xercesImpl.jar</primary>
+</indexterm></listitem>
+</varlistentry>
+
+<varlistentry id="xml-apis">
+<term><filename class='libraryfile'>xml-apis.jar</filename></term>
+<listitem><para>contains the <acronym>DOM</acronym> 
+<application>Java</application> classes required by the 
+<application>Apache Ant</application> <acronym>XML</acronym> formatter.</para>
+<indexterm zone="apache-ant xml-apis">
+<primary sortas="c-xml-apis">xml-apis.jar</primary>
+</indexterm></listitem>
+</varlistentry>
+
+</variablelist>
+
 </sect2>
 
 </sect1>

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2005-01-29 16:43:47 UTC (rev 3356)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2005-01-29 18:00:27 UTC (rev 3357)
@@ -24,7 +24,8 @@
 
 <listitem><para>January 29th, 2005 [randy]: Added vulnerability fix patch to 
 Bind instructions and bumped version entities to 9.3.0p1; added MD5 sum to
-DocBook-utils instructions.</para></listitem>
+DocBook-utils instructions; added program and library descriptions to 
+Apache Ant.</para></listitem>
 
 <listitem><para>January 28th, 2005 [randy]: Updated to hdparm-5.8, 
 Mozilla-1.7.5 and Nail-11.20; updated Enigmail version in Thunderbird 




More information about the blfs-book mailing list