Author: randy
Date: 2007-03-24 10:24:26 -0600 (Sat, 24 Mar 2007)
New Revision: 6689
Modified:
trunk/BOOK/general.ent
trunk/BOOK/introduction/welcome/changelog.xml
trunk/BOOK/pst/ps/fop.xml
Log:
Updated to FOP-0.93
Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent 2007-03-24 02:47:20 UTC (rev 6688)
+++ trunk/BOOK/general.ent 2007-03-24 16:24:26 UTC (rev 6689)
@@ -3,11 +3,11 @@
$Date$
-->
-<!ENTITY day "23"> <!-- Always 2 digits -->
+<!ENTITY day "24"> <!-- Always 2 digits -->
<!ENTITY month "03"> <!-- Always 2 digits -->
<!ENTITY year "2007">
<!ENTITY version "svn-&year;&month;&day;">
-<!ENTITY releasedate "March &day;rd, &year;">
+<!ENTITY releasedate "March &day;th, &year;">
<!ENTITY pubdate "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
<!ENTITY blfs-version "svn"> <!-- svn|[release #] -->
<!ENTITY lfs-version "development"> <!--
version|testing|unstable|development] -->
@@ -648,7 +648,7 @@
<!ENTITY psutils-version "p17">
<!ENTITY gsview-version "4.8">
<!ENTITY xpdf-version "3.01">
-<!ENTITY fop-version "0.20.5">
+<!ENTITY fop-version "0.93">
<!ENTITY paps-version "0.6.6">
<!-- Chapter 47 -->
Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml 2007-03-24 02:47:20 UTC
(rev 6688)
+++ trunk/BOOK/introduction/welcome/changelog.xml 2007-03-24 16:24:26 UTC
(rev 6689)
@@ -42,6 +42,15 @@
-->
<listitem>
+ <para>March 24th, 2007</para>
+ <itemizedlist>
+ <listitem>
+ <para>[randy] - Updated to FOP-0.93.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
<para>March 23rd, 2007</para>
<itemizedlist>
<listitem>
Modified: trunk/BOOK/pst/ps/fop.xml
===================================================================
--- trunk/BOOK/pst/ps/fop.xml 2007-03-24 02:47:20 UTC (rev 6688)
+++ trunk/BOOK/pst/ps/fop.xml 2007-03-24 16:24:26 UTC (rev 6689)
@@ -4,28 +4,20 @@
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
- <!-- Inserted as a reminder to do this. The mention of a test suite
- is usually right before the root user installation commands. Please
- delete these 12 (including one blank) lines after you are done.-->
+ <!ENTITY fop-download-http
"http://apache.mirrors.pair.com/xmlgraphics/fop/fop-&fop-version;-src.tar.gz";>
+ <!ENTITY fop-download-ftp
"ftp://apache.mirrors.pair.com/xmlgraphics/fop/fop-&fop-version;-src.tar.gz";>
+ <!ENTITY fop-md5sum "184c578a6269a8287ed150e0fc12868d">
+ <!ENTITY fop-size "11.7 MB">
+ <!ENTITY fop-buildsize "216 MB">
+ <!ENTITY fop-time "0.9 SBU">
- <!-- Use one of the two mentions below about a test suite,
- delete the line that is not applicable. Of course, if the
- test suite uses syntax other than "make check", revise the
- line to reflect the actual syntax to run the test suite -->
-
- <!-- <para>This package does not come with a test suite.</para> -->
- <!-- <para>To test the results, issue: <command>make
check</command>.</para> -->
-
- <!ENTITY fop-download-http
"http://apache.mirrors.pair.com/xml/fop/source/fop-&fop-version;-src.tar.gz";>
- <!ENTITY fop-download-ftp
"ftp://apache.mirrors.pair.com/xml/fop/source/fop-&fop-version;-src.tar.gz";>
- <!ENTITY fop-md5sum "1a31eb1357e5d4b8d32d4cb3edae2da2">
- <!ENTITY fop-size "7.8 MB">
- <!ENTITY fop-buildsize "47.9 MB">
- <!ENTITY fop-time "0.25 SBU">
-
<!ENTITY jai-download
"http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=jai-1_1_2_01-oth-JPR&SiteId=JSC&TransactionId=noreg";>
<!ENTITY jai-md5sum "f2be3619a8d002eff3874355e96327eb">
<!ENTITY jai-size "2.6 MB">
+
+ <!ENTITY offo-download
"http://downloads.sourceforge.net/offo/offo-hyphenation.zip";>
+ <!ENTITY offo-md5sum "0b8c1657ef70285ad7fd514061b08c3e">
+ <!ENTITY offo-size "359 KB">
]>
<sect1 id="fop" xreflabel="FOP-&fop-version;">
@@ -78,44 +70,50 @@
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
- <title>Required package</title>
+ <title>Required packages</title>
<listitem>
- <para><application>Java</application> Advanced Imaging (JAI) API
- components: <ulink url="&jai-download;">
- http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&</ulink>
- <ulink url="&jai-download;">
-
PartDetailId=jai-1_1_2_01-oth-JPR&SiteId=JSC&TransactionId=noreg</ulink>
+ <para>Objects for Formatting Objects (OFFO) hyphenation patterns:
+ <simplelist>
+ <member><ulink url="&offo-download;"/></member>
+ <member>&offo-md5sum;</member>
+ <member>&offo-size;</member>
+ </simplelist>
</para>
</listitem>
<listitem>
- <para>Download MD5 sum: &jai-md5sum;</para>
+ <para>Java Advanced Imaging (JAI) API components:
+ <simplelist>
+ <member>
+ <ulink url="&jai-download;">
+
http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&</ulink>
+ <ulink url="&jai-download;">
+
PartDetailId=jai-1_1_2_01-oth-JPR&SiteId=JSC&TransactionId=noreg</ulink>
+ </member>
+ <member>&jai-md5sum;</member>
+ <member>&jai-size;</member>
+ <member>Choose the <quote>Linux JDK Install</quote> file after
+ accepting the license agreement.</member>
+ </simplelist>
+ </para>
</listitem>
- <listitem>
- <para>Download size: &jai-size;</para>
- </listitem>
</itemizedlist>
- <para>Choose the <quote><application>Linux</application>
- <application>JDK</application> Install</quote> file after
- accepting the license agreement.</para>
-
- <itemizedlist spacing='compact'>
+ <!-- <itemizedlist spacing='compact'>
<title>Required patch</title>
<listitem>
<para><ulink
url="&patch-root;/fop-&fop-version;-jdk_1.5.0-1.patch"/></para>
</listitem>
- </itemizedlist>
+ </itemizedlist> -->
<bridgehead renderas="sect3">FOP Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
- <para role="required"><xref linkend="jdk"/></para>
+ <para role="required"><xref linkend="apache-ant"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
- <para role="optional"><xref linkend="libxslt"/>,
- <ulink url="http://java.sun.com/products/jimi/";>JIMI SDK</ulink>,
- <ulink url="http://xml.apache.org/batik/";>Batik</ulink> and
+ <para role="optional"><ulink url="http://java.sun.com/products/jimi/";>JIMI
SDK</ulink>,
+ <ulink url="http://xmlunit.sourceforge.net/";>XMLUnit</ulink>, and
<ulink url="http://forrest.apache.org/";>Forrest</ulink> (only used to
rebuild
the documentation)</para>
@@ -127,21 +125,36 @@
<sect2 role="installation">
<title>Installation of FOP</title>
- <note>
- <para>Ensure <envar>$JAVA_HOME</envar> is set correctly before beginning
- the build.</para>
- </note>
+ <para>Ensure <envar>$JAVA_HOME</envar> is set correctly before beginning
+ the build. To build the <application>JIMI SDK</application> and/or
+ <application>XMLUnit</application> extension classes, ensure the
+ corresponding <filename class='extension'>.jar</filename> files are
+ identified in the <envar>CLASSPATH</envar> environment variable.</para>
- <para>Some versions of tar will display a message similar to
+ <!-- <para>Some versions of tar will display a message similar to
<quote><computeroutput>tar: A lone zero block at
33476</computeroutput></quote>
- when unpacking the source tarball. You may safely ignore this
message.</para>
+ when unpacking the source tarball. You may safely ignore this
message.</para> -->
<sect3>
+ <title>Installing OFFO Hyphenation Patterns</title>
+
+ <para>Before beginning the build, unpack the
+ <application>FOP</application> source tarball and the hyphenation zipfile
+ from the same directory, then change directories into the root of the
+ <application>FOP</application> source tree. The XML Hyphenation patterns
+ will be copied into the <application>FOP</application> source tree by
+ running the following commands:</para>
+
+<screen><userinput>cp ../offo-hyphenation/hyph/* hyph &&
+rm -rf ../offo-hyphenation</userinput></screen>
+
+ </sect3>
+
+ <sect3>
<title>Installing JAI</title>
<tip>
- <para>The
- <command>$FOP_BUILD_DIR/jai-1_1_2_01-lib-linux-i586-jdk.bin</command>
+ <para>The <command>$FOP_BUILD_DIR/JAI.bin</command>
command below installs the JAI components in the JDK tree. You will be
required to view, and then accept (by entering a <keycap>y</keycap>
keypress), a license agreement before the installation will continue.
@@ -156,45 +169,40 @@
the <systemitem class="username">root</systemitem> user while in the
root of the <application>FOP</application> source tree:</para>
-<screen role="root"><userinput>cp ../jai-1_1_2_01-lib-linux-i586-jdk.bin .
&&
-sed -i 's/tail +122/tail -n +122/' \
- jai-1_1_2_01-lib-linux-i586-jdk.bin &&
-chmod 755 jai-1_1_2_01-lib-linux-i586-jdk.bin &&
+<screen role="root"><userinput>install -m755
../jai-1_1_2_01-lib-linux-i586-jdk.bin JAI.bin &&
+sed -i 's/tail +122/tail -n +122/' JAI.bin &&
+
FOP_BUILD_DIR=$(pwd) &&
cd $JAVA_HOME &&
-$FOP_BUILD_DIR/jai-1_1_2_01-lib-linux-i586-jdk.bin &&
-cd $FOP_BUILD_DIR</userinput></screen>
+$FOP_BUILD_DIR/JAI.bin &&
+
+cd $FOP_BUILD_DIR &&
+rm JAI.bin</userinput></screen>
+
</sect3>
<sect3>
- <title>Installing FOP required components</title>
+ <title>Installing FOP Components</title>
<para>Install <application>FOP</application> by running the
following commands:</para>
-<screen><userinput>patch -Np1 -i ../fop-&fop-version;-jdk_1.5.0-1.patch
&&
-./build.sh &&
-sed -i "s/build/lib/" fop.sh</userinput></screen>
+<screen><userinput>ant &&
+ant javadocs</userinput></screen>
+ <para>The unit regression tests were performed in the build step
+ above.</para>
+
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
-<screen role="root"><userinput>install -v -d -m755 \
- /opt/fop-&fop-version;/{bin,lib,docs/{general,lib,site}} &&
-install -v -m755 fop.sh /opt/fop-&fop-version;/bin &&
-install -v -m644 build/fop.jar lib/avalon-framework-cvs-20020806.jar \
- /opt/fop-&fop-version;/lib &&
-install -v -m644 docs/* /opt/fop-&fop-version;/docs &&
-install -v -m644 CHANGES LICENSE README ReleaseNotes.html STATUS \
- /opt/fop-&fop-version;/docs/general &&
-install -v -m644 lib/{avalon.LICENSE.txt,readme} \
- /opt/fop-&fop-version;/docs/lib &&
-cp -v -R build/site/* /opt/fop-&fop-version;/docs/site &&
-ln -svf fop-&fop-version; /opt/fop</userinput></screen>
+<screen role="root"><userinput>install -v -d -m755 /opt/fop-&fop-version;
&&
+cp -v -R * /opt/fop-&fop-version; &&
+ln -v -sf fop-&fop-version; /opt/fop</userinput></screen>
</sect3>
- <sect3>
+ <!-- <sect3>
<title>Installing the Batik JAR</title>
<para>You'll need to install one additional
<application>Java</application>
@@ -261,7 +269,7 @@
support), ensure you also install this JAR file into
<filename class='directory'>/opt/fop-&fop-version;/lib</filename>.</para>
- </sect3>
+ </sect3> -->
</sect2>
@@ -271,28 +279,35 @@
<para><command>sed -i 's/tail +122/tail -n +122/' ...</command>:
The <application>JAI</application> binary file has a
<command>tail</command>
command imbedded in the file which uses obsolete syntax and causes the
- file to not unpack correctly. This command fixes the obsolete
+ file to unpack incorrectly. This command fixes the obsolete
syntax.</para>
- <para><command>$FOP_BUILD_DIR/../jai-...-jdk.bin</command>: This
+ <para><command>$FOP_BUILD_DIR/JAI.bin</command>: This
command installs the <application>JAI</application> components
into the <application>JDK</application> file structure.
<envar>$FOP_BUILD_DIR</envar> is used as a reference point to the source
executable and as a method to return back to the
<application>FOP</application> source tree.</para>
- <para><command>sed -i "s/build/lib/" ...</command>: These commands modify
+ <!-- <para><command>sed -i "s/build/lib/" ...</command>: These commands
modify
the installed shell scripts so that the location of the installed
- <filename>fop.jar</filename> file is correctly identified.</para>
+ <filename>fop.jar</filename> file is correctly identified.</para> -->
- <para><command>install -v ...; cp -v ...</command>: There is no
installation
+ <!-- <para><command>install -v ...; cp -v ...</command>: There is no
installation
script provided by the <application>FOP</application>
- package. These commands install the package.</para>
+ package. These commands install the package.</para> -->
- <para><command>ln -svf fop-&fop-version; /opt/fop</command>: This creates a
- convenience symlink so that <envar>$FOP_HOME</envar> doesn't have to be
- changed each time there's a package version change.</para>
+ <para><command>ant</command>: This reads the <filename>build.xml</filename>
+ file and performs the default <option>all</option> target which builds the
+ package and runs the unit regression tests.</para>
+ <para><command>ant javadocs</command>: This builds the Java API
+ documentation. Omit this step if desired.</para>
+
+ <para><command>ln -v -sf fop-&fop-version; /opt/fop</command>: This is
+ optional and creates a convenience symlink so that <envar>$FOP_HOME</envar>
+ doesn't have to be changed each time there's a package version
change.</para>
+
</sect2>
<sect2 role="configuration">
@@ -315,20 +330,20 @@
<para>Using <application>FOP</application> to process some large FO's
(including the FO derived from the BLFS XML sources), can lead to memory
errors. Unless you add a parameter to the <command>java</command> command
- used in the <command>fop.sh</command> script you may receive messages
+ used in the <command>fop</command> script you may receive messages
similar to the one shown below:</para>
<para><computeroutput>Exception in thread "main"
java.lang.OutOfMemoryError:
Java heap space</computeroutput></para>
<para>To avoid errors like this, you need to pass an extra parameter to
- the <command>java</command> command used in the <command>fop.sh</command>
+ the <command>java</command> command used in the <command>fop</command>
script. This can be accomplished by creating a
<filename>~/.foprc</filename> (which is sourced by the
- <command>fop.sh</command> script) and adding the parameter to the
+ <command>fop</command> script) and adding the parameter to the
<envar>FOP_OPTS</envar> environment variable.</para>
- <para>The <command>fop.sh</command> script looks for a
+ <para>The <command>fop</command> script looks for a
<envar>FOP_HOME</envar> environment variable to locate the
<application>FOP</application> class libraries. You can create this
variable using the <filename>~/.foprc</filename> file as well. Create
@@ -347,10 +362,10 @@
memory issues running <application>FOP</application>, see
<ulink url="http://xml.apache.org/fop/running.html#memory"/>.</para>
- <para>To include the <command>fop.sh</command> script in your path,
+ <para>To include the <command>fop</command> script in your path,
update your personal or system-wide profile with the following:</para>
-<screen><literal>PATH=$PATH:/opt/fop/bin</literal></screen>
+<screen><literal>PATH=$PATH:/opt/fop</literal></screen>
</sect3>
@@ -365,10 +380,10 @@
<segtitle>Installed Directory</segtitle>
<seglistitem>
- <seg>fop.sh and xalan.sh</seg>
- <seg>avalon-framework-cvs-20020806.jar, batik.jar, fop.jar,
- xalan-2.4.1.jar, xercesImpl-2.2.1.jar, and xml-apis.jar. JAI components
- include libmlib_jai.so, jai_codec.jar, jai_core.jar, and
+ <seg>fop</seg>
+ <seg>fop.jar and numerous support library classes located in
+ <filename class='directory'>/opt/fop/{build,lib}</filename>; JAI
+ components include libmlib_jai.so, jai_codec.jar, jai_core.jar, and
mlibwrapper_jai.jar</seg>
<seg>/opt/fop-&fop-version;</seg>
</seglistitem>
@@ -379,14 +394,14 @@
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
- <varlistentry id="fop.sh">
- <term><command>fop.sh</command></term>
+ <varlistentry id="fop-prog">
+ <term><command>fop</command></term>
<listitem>
<para>is a wrapper script to the <command>java</command> command
which sets up the <application>FOP</application>
environment and passes the required parameters.</para>
- <indexterm zone="fop fop.sh">
- <primary sortas="b-fop.sh">fop.sh</primary>
+ <indexterm zone="fop fop-prog">
+ <primary sortas="b-fop">fop</primary>
</indexterm>
</listitem>
</varlistentry>
--
http://linuxfromscratch.org/mailman/listinfo/blfs-book
FAQ: http://www.linuxfromscratch.org/blfs/faq.html
Unsubscribe: See the above information page
