r3062 - in trunk: BOOK BOOK/general/sysutils BOOK/introduction/welcome patches

randy at linuxfromscratch.org randy at linuxfromscratch.org
Tue Nov 30 00:07:05 PST 2004


Author: randy
Date: 2004-11-30 01:07:04 -0700 (Tue, 30 Nov 2004)
New Revision: 3062

Added:
   trunk/BOOK/general/sysutils/apache-ant.xml
   trunk/patches/apache-ant-1.6.2-blfs_install-1.patch
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/sysutils/sysutils.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/introduction/welcome/credits.xml
Log:
Added new package Apache Ant-1.6.2

Added: trunk/BOOK/general/sysutils/apache-ant.xml
===================================================================
--- trunk/BOOK/general/sysutils/apache-ant.xml	2004-11-29 20:36:39 UTC (rev 3061)
+++ trunk/BOOK/general/sysutils/apache-ant.xml	2004-11-30 08:07:04 UTC (rev 3062)
@@ -0,0 +1,154 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+
+  <!ENTITY apache-ant-download-http "http://www.apache.org/dist/ant/source/apache-ant-&apache-ant-version;-src.tar.bz2">
+  <!ENTITY apache-ant-download-ftp  "ftp://ftp.oregonstate.edu/pub/apache/ant/source/apache-ant-&apache-ant-version;-src.tar.bz2">
+  <!ENTITY apache-ant-md5sum        "83c3adefdbf90bcbc4b804d4c55c0778">
+  <!ENTITY apache-ant-size          "6.2 MB">
+  <!ENTITY apache-ant-buildsize     "90 MB">
+  <!ENTITY apache-ant-time          "0.47 SBU">
+]>
+
+<sect1 id="apache-ant" xreflabel="Apache Ant-&apache-ant-version;">
+<sect1info>
+<othername>$LastChangedBy$</othername>
+<date>$Date$</date>
+</sect1info>
+<?dbhtml filename="apache-ant.html"?>
+<title>Apache Ant-&apache-ant-version;</title>
+
+<sect2>
+<title>Introduction to <application>Apache Ant</application></title>
+
+<para>The <application>Apache Ant</application> package is a 
+<application>Java</application>-based build tool. In theory, it is kind of 
+like <command>make</command>, but without <command>make</command>'s wrinkles. 
+Ant is different. Instead of a model where it is extended with shell-based 
+commands, Ant is extended using <application>Java</application> classes. 
+Instead of writing shell commands, the configuration files are 
+<acronym>XML</acronym>-based, calling out a target tree where various tasks 
+get executed. Each task is run by an object that implements a particular task 
+interface.</para>
+
+<sect3><title>Package information</title>
+<itemizedlist spacing="compact">
+<listitem><para>Download (HTTP): 
+<ulink url="&apache-ant-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): 
+<ulink url="&apache-ant-download-ftp;"/></para></listitem>
+<listitem><para>Download MD5 sum: &apache-ant-md5sum;</para></listitem>
+<listitem><para>Download size: &apache-ant-size;</para></listitem>
+<listitem><para>Estimated disk space required: 
+&apache-ant-buildsize;</para></listitem>
+<listitem><para>Estimated build time: 
+&apache-ant-time;</para></listitem></itemizedlist>
+</sect3>
+
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing="compact">
+<listitem><para>Required Patch: <ulink 
+url="&patch-root;/apache-ant-&apache-ant-version;-blfs_install-1.patch"/></para>
+</listitem></itemizedlist>
+</sect3>
+
+<sect3><title><application>Apache Ant</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="j2sdk"/></para>
+</sect4>
+</sect3>
+
+</sect2>
+
+<sect2>
+<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 
+<ulink url="http://ant.apache.org/manual/install.html#librarydependencies"/> 
+for any prerequisite libraries you may need.</para>
+
+<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 &&
+ln -sf /etc/ant /opt/ant-&apache-ant-version;/etc &&
+ln -sf ant-&apache-ant-version; /opt/ant</command></userinput></screen>
+
+</sect2>
+
+<sect2>
+<title>Command explanations</title>
+
+<para><command>./build.sh -Ddist.dir=/opt/ant-&apache-ant-version; 
+dist</command>: This command does everything. It builds the package, then 
+installs the package into 
+<filename class='directory'>/opt/ant-&apache-ant-version;</filename>.</para>
+
+<para><command>ln -sf /etc/ant /opt/ant-&apache-ant-version;/etc</command>: 
+The patch changes the configuration directory to 
+<filename class='directory'>/etc/ant</filename> to conform with 
+<acronym>FHS</acronym> guidelines. This command creates a symlink from the 
+configuration directory back to the installation directory as the package is 
+expecting to find the files there.</para>
+
+<para><command>ln -sf ant-&apache-ant-version; /opt/ant</command>: This 
+command is optional, and creates a convenience symlink.</para>
+
+</sect2>
+
+<sect2>
+<title>Configuring <application>Apache Ant</application></title>
+
+<sect3><title>Config files</title>
+<para><filename>/etc/ant/ant.conf</filename>, 
+<filename>~/.ant/ant.conf</filename> and 
+<filename>~/.antrc</filename></para>
+</sect3>
+
+<sect3><title>Configuration Information</title>
+<para>Some packages will require <command>ant</command> to be in the search
+path. Satisfy this requirement by adding the following line to 
+<filename>/etc/profile</filename> or to individual user's 
+<filename>~/.profile</filename> or <filename>.bashrc</filename> files:</para>
+
+<screen><userinput>export PATH=$PATH:/opt/ant/bin</userinput></screen>
+
+<para>You may also need to create an environment variable for 
+<envar>$ANT_HOME</envar>. Add the following to one of the files mentioned 
+above:</para>
+
+<screen><userinput>export ANT_HOME=/opt/ant</userinput></screen>
+</sect3>
+
+</sect2>
+
+<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>
+
+</sect2>
+
+<sect2><title>Description</title>
+
+<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>
+
+</sect2>
+
+</sect1>
+


Property changes on: trunk/BOOK/general/sysutils/apache-ant.xml
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date

Modified: trunk/BOOK/general/sysutils/sysutils.xml
===================================================================
--- trunk/BOOK/general/sysutils/sysutils.xml	2004-11-29 20:36:39 UTC (rev 3061)
+++ trunk/BOOK/general/sysutils/sysutils.xml	2004-11-30 08:07:04 UTC (rev 3062)
@@ -24,5 +24,6 @@
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="cpio.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mc.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sysstat.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="apache-ant.xml"/>
 
 </chapter>

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2004-11-29 20:36:39 UTC (rev 3061)
+++ trunk/BOOK/general.ent	2004-11-30 08:07:04 UTC (rev 3062)
@@ -1,4 +1,4 @@
-<!ENTITY day          "29">
+<!ENTITY day          "30">
 <!ENTITY month        "11">
 <!ENTITY year         "2004">
 <!ENTITY version      "svn-&year;&month;&day;">
@@ -126,6 +126,7 @@
 <!ENTITY cpio-version                 "2.5">
 <!ENTITY mc-version                   "4.6.0">
 <!ENTITY sysstat-version              "5.0.6">
+<!ENTITY apache-ant-version           "1.6.2">
                                      
 <!-- Chapter 12 -->                  
 <!ENTITY Python-version               "2.3.4">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2004-11-29 20:36:39 UTC (rev 3061)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2004-11-30 08:07:04 UTC (rev 3062)
@@ -22,6 +22,9 @@
 
 <itemizedlist>
 
+<listitem><para>November 30th, 2004 [randy]: Added new package 
+Apache Ant-1.6.2.</para></listitem>
+
 <listitem><para>November 29th, 2004 [randy]: Added command to AbiWord 
 instructions to fix incorrect permissions on help file directories; 
 added --localstatedir parameter to libgnome instructions to sync with GNOME 

Modified: trunk/BOOK/introduction/welcome/credits.xml
===================================================================
--- trunk/BOOK/introduction/welcome/credits.xml	2004-11-29 20:36:39 UTC (rev 3061)
+++ trunk/BOOK/introduction/welcome/credits.xml	2004-11-30 08:07:04 UTC (rev 3062)
@@ -150,10 +150,10 @@
 <listitem><para>ESP Ghostscript: <emphasis>Matt Rogers</emphasis></para>
 </listitem>
 
-<listitem><para>Cyrus-SASL, DejaGnu, desktop-file-utils, DocBook-utils, 
-Ethereal, Evolution Data Server, Expect, GNOME Doc Utils, Heimdal, HTML Tidy, 
-JadeTeX, libgnomecups, pilot-link, SANE (original instructions by Alex Kloss), 
-SGMLSpm Perl module, SLIB, Stunnel and Sysstat: 
+<listitem><para>Apache Ant, Cyrus-SASL, DejaGnu, desktop-file-utils, 
+DocBook-utils, Ethereal, Evolution Data Server, Expect, GNOME Doc Utils, 
+Heimdal, HTML Tidy, JadeTeX, libgnomecups, pilot-link, SANE (original 
+instructions by Alex Kloss), SGMLSpm Perl module, SLIB, Stunnel and Sysstat: 
 <emphasis>Randy McMurchy</emphasis></para></listitem>
 
 <listitem><para>Screen: <emphasis>Andreas Pedersen</emphasis></para></listitem>

Added: trunk/patches/apache-ant-1.6.2-blfs_install-1.patch
===================================================================
--- trunk/patches/apache-ant-1.6.2-blfs_install-1.patch	2004-11-29 20:36:39 UTC (rev 3061)
+++ trunk/patches/apache-ant-1.6.2-blfs_install-1.patch	2004-11-30 08:07:04 UTC (rev 3062)
@@ -0,0 +1,65 @@
+Submitted By:            Randy McMurchy <randy_at_linuxfromscratch_dot_org>
+Date:                    2004-11-29
+Initial Package Version: 1.6.2
+Upstream Status:         Not submitted (LFS/FHS specific)
+Origin:                  Randy McMurchy
+Description:             Modifies the installation layout to conform with 
+                         LFS and FHS Guidelines
+
+$LastChangedBy$
+$Date$
+
+diff -Naur apache-ant-1.6.2-orig/build.xml apache-ant-1.6.2/build.xml
+--- apache-ant-1.6.2-orig/build.xml	2004-07-16 07:57:30.000000000 +0000
++++ apache-ant-1.6.2/build.xml	2004-11-30 04:13:56.360978512 +0000
+@@ -121,7 +121,8 @@
+   <property name="dist.bin" value="${dist.dir}/bin"/>
+   <property name="dist.lib" value="${dist.dir}/lib"/>
+   <property name="dist.docs" value="${dist.dir}/docs"/>
+-  <property name="dist.etc" value="${dist.dir}/etc"/>
++  <property name="dist.readme" value="${dist.dir}/readme"/>
++  <property name="dist.etc" value="/etc/ant"/>
+   <property name="dist.javadocs" value="${dist.dir}/docs/manual/api"/>
+ 
+   <property name="src.dist.dir" value="dist-src"/>
+@@ -921,6 +922,7 @@
+     <mkdir dir="${dist.dir}"/>
+     <mkdir dir="${dist.bin}"/>
+     <mkdir dir="${dist.lib}"/>
++    <mkdir dir="${dist.readme}"/>
+ 
+     <copy todir="${dist.lib}">
+       <fileset dir="${build.lib}">
+@@ -999,7 +1001,7 @@
+       </fileset>
+     </copy>
+ 
+-    <copy todir="${dist.dir}">
++    <copy todir="${dist.readme}">
+       <fileset dir=".">
+         <include name="README"/>
+         <include name="LICENSE"/>
+
+diff -Naur apache-ant-1.6.2-orig/src/script/ant apache-ant-1.6.2/src/script/ant
+--- apache-ant-1.6.2-orig/src/script/ant        2004-07-16 07:56:50.000000000 +0000
++++ apache-ant-1.6.2/src/script/ant     2004-11-30 07:12:48.328471464 +0000
+@@ -44,8 +44,8 @@
+   usejikes=$use_jikes_default
+ else
+   # load system-wide ant configuration
+-  if [ -f "/etc/ant.conf" ] ; then
+-    . /etc/ant.conf
++  if [ -f "/etc/ant/ant.conf" ] ; then
++    . /etc/ant/ant.conf
+   fi
+
+   # load user ant configuration
+@@ -244,7 +244,7 @@
+   echo $0 '[script options] [options] [target [target2 [target3] ..]]'
+   echo 'Script Options:'
+   echo '  --help, --h            print this message and ant help'
+-  echo '  --noconfig             suppress sourcing of /etc/ant.conf,'
++  echo '  --noconfig             suppress sourcing of /etc/ant/ant.conf,'
+   echo '                         $HOME/.ant/ant.conf, and $HOME/.antrc'
+   echo '                         configuration files'
+   echo '  --usejikes             enable use of jikes by default, unless'


Property changes on: trunk/patches/apache-ant-1.6.2-blfs_install-1.patch
___________________________________________________________________
Name: svn:keywords
   + LastChangedBy Date




More information about the blfs-book mailing list