Changeset 514ef84d
- Timestamp:
- 05/06/2005 07:15:52 PM (19 years ago)
- Branches:
- 10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
- Children:
- 35f3cb4
- Parents:
- 2c24d1e
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
general/sysutils/apache-ant.xml
r2c24d1e r514ef84d 14 14 15 15 <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 && 93 ln -sf /etc/ant /opt/ant-&apache-ant-version;/etc && 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 && 106 ln -v -sf /etc/ant /opt/ant-&apache-ant-version;/etc && 107 ln -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 165 export 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> 252 295 253 296 </sect1>
Note:
See TracChangeset
for help on using the changeset viewer.