r6689 - in trunk/BOOK: . introduction/welcome pst/ps

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sat Mar 24 09:24:27 PDT 2007


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>




More information about the blfs-book mailing list