Changeset 75d53372 for pst/ps/fop.xml


Ignore:
Timestamp:
05/08/2012 05:21:33 AM (12 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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:
b822871
Parents:
e7fc5cf
Message:

Updated fop instructions to properly install
Java Advanced Imaging (JAI) API components.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10118 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • pst/ps/fop.xml

    re7fc5cf r75d53372  
    66
    77  <!ENTITY fop-download-http "http://archive.apache.org/dist/xmlgraphics/fop/source/fop-&fop-version;-src.tar.gz">
    8   <!-- <!ENTITY fop-download-ftp  "ftp://apache.mirrors.pair.com/xmlgraphics/fop/fop-&fop-version;-src.tar.gz"> -->
    9   <!ENTITY fop-download-ftp  "&sources-anduin-ftp;/f/fop-&fop-version;-src.tar.gz">
     8  <!ENTITY fop-download-ftp  " ">
    109  <!ENTITY fop-md5sum        "95dcc4c2dd08b4bc88ce9ce1ee88c439">
    1110  <!ENTITY fop-size          "16.1 MB">
    … …  
    1413
    1514  <!ENTITY jai-version       "1_1_3">
    16   <!ENTITY jai-download      "http://download.java.net/media/jai/builds/release/&jai-version;/jai-&jai-version;-lib-linux-i586-jdk.bin">
    17   <!ENTITY jai-md5sum        "a63b661c4940582aa1679233e5f518b2">
     15  <!ENTITY jai-download      "http://download.java.net/media/jai/builds/release/&jai-version;/jai-&jai-version;-lib-linux-i586.tar.gz">
     16  <!ENTITY jai-md5sum        "a2cbc155ef3899bcde9c74a8035764b3">
    1817  <!ENTITY jai-size          "3.4 MB">
     18
     19  <!ENTITY jai64-download    "http://download.java.net/media/jai/builds/release/&jai-version;/jai-&jai-version;-lib-linux-amd64.tar.gz">
     20  <!ENTITY jai64-md5sum      "4a906db35612f668aeef2c0606d7075b">
     21  <!ENTITY jai64-size        "3.4 MB">
    1922
    2023  <!ENTITY offo-download     "&sourceforge-repo;/offo/offo-hyphenation_v2.0.zip">
    … …  
    2326]>
    2427
    25 <sect1 id="fop" xreflabel="FOP-&fop-version;">
     28<sect1 id="fop" xreflabel="fop-&fop-version;">
    2629  <?dbhtml filename="fop.html"?>
    2730
    … …  
    3134  </sect1info>
    3235
    33   <title>FOP-&fop-version;</title>
     36  <title>fop-&fop-version;</title>
    3437
    3538  <indexterm zone="fop">
    36     <primary sortas="a-FOP">FOP</primary>
     39    <primary sortas="a-fop">fop</primary>
    3740  </indexterm>
    3841
    3942  <sect2 role="package">
    40     <title>Introduction to FOP</title>
     43    <title>Introduction to fop</title>
    4144
    4245    <para>The <application>FOP</application> (Formatting Objects Processor)
    … …  
    4851    primary output target is PDF.</para>
    4952
    50     <para>&lfssvn_checked;20101029&lfssvn_checked2;</para>
     53    &lfs70_checked;
    5154
    5255    <bridgehead renderas="sect3">Package Information</bridgehead>
    … …  
    8689      </listitem>
    8790      <listitem>
    88         <para>Java Advanced Imaging (JAI) API components:
     91        <para>Java Advanced Imaging (JAI) API components (architecture dependent):
    8992          <simplelist>
    9093            <member><ulink url="&jai-download;"/></member>
    … …  
    9295            <member>&jai-size;</member>
    9396          </simplelist>
     97          <simplelist>
     98            <member><ulink url="&jai64-download;"/></member>
     99            <member>&jai64-md5sum;</member>
     100            <member>&jai64-size;</member>
     101          </simplelist>
    94102        </para>
    95103      </listitem>
    96104    </itemizedlist>
    97105
    98     <!-- <itemizedlist spacing='compact'>
    99       <title>Required patch</title>
    100       <listitem>
    101         <para><ulink
    102         url="&patch-root;/fop-&fop-version;-jdk_1.5.0-1.patch"/></para>
    103       </listitem>
    104     </itemizedlist> -->
    105 
    106     <bridgehead renderas="sect3">FOP Dependencies</bridgehead>
     106    <bridgehead renderas="sect3">fop Dependencies</bridgehead>
    107107
    108108    <bridgehead renderas="sect4">Required</bridgehead>
    109     <para role="required"><xref linkend="xorg7"/>,
    110     <xref linkend="apache-ant"/>, and
    111     <ulink url="http://java.sun.com/javase/technologies/desktop/media/jai/">Java
    112     Advanced Imaging (JAI) API components</ulink></para>
     109    <para role="required">
     110      <xref linkend="xorg7"/> and
     111      <xref linkend="apache-ant"/>
     112    </para>
    113113
    114114    <bridgehead renderas="sect4">Optional</bridgehead>
    115     <para role="optional"><ulink url="http://java.sun.com/products/jimi/">JIMI SDK</ulink>,
    116     <ulink url="http://xmlunit.sourceforge.net/">XMLUnit</ulink>,
    117     <ulink url="https://jai-imageio.dev.java.net/">JAI Image I/O Tools</ulink>,
    118     <ulink url="http://jeuclid.sourceforge.net/">JEuclid</ulink>,
    119     <ulink url="http://pmd.sourceforge.net">PMD</ulink>
    120     (requires <ulink url="http://jaxen.codehaus.org/">Jaxen</ulink>), and
    121     <ulink url="http://forrest.apache.org/">Forrest</ulink> (Forrest used only
    122     to rebuild the documentation)</para>
     115    <para role="optional">
     116      <ulink url="http://java.sun.com/products/jimi/">JIMI SDK</ulink>,
     117      <ulink url="http://xmlunit.sourceforge.net/">XMLUnit</ulink>,
     118      <ulink url="https://jai-imageio.dev.java.net/">JAI Image I/O Tools</ulink>,
     119      <ulink url="http://jeuclid.sourceforge.net/">JEuclid</ulink>,
     120      <ulink url="http://pmd.sourceforge.net">PMD</ulink>
     121          (requires <ulink url="http://jaxen.codehaus.org/">Jaxen</ulink>), and
     122      <ulink url="http://forrest.apache.org/">Forrest</ulink> (Forrest used only
     123      to rebuild the documentation)
     124    </para>
    123125
    124126    <para condition="html" role="usernotes">User Notes:
    … …  
    128130
    129131  <sect2 role="installation">
    130     <title>Installation of FOP</title>
     132    <title>Installation of fop</title>
    131133
    132134    <important>
    133135      <para>You must run this installation from an X-window using a GL-aware
    134136      <application>Xorg</application> server or some of the
    135       <application>JUnit</application> tests will hang. Using an X-window from
    136       the console is the preferred method.</para>
     137      <application>JUnit</application> tests will hang.</para>
    137138    </important>
    138139
    … …  
    140141    the build. To build the <application>JIMI SDK</application> and/or
    141142    <application>XMLUnit</application> extension classes, ensure the
    142     corresponding <filename class='extension'>.jar</filename> files are
    143     identified in the <envar>CLASSPATH</envar> environment variable.</para>
     143    corresponding <filename class='extension'>.jar</filename> files can be
     144    found via the <envar>CLASSPATH</envar> environment variable.</para>
    144145
    145146    <sect3>
    146147      <title>Installing OFFO Hyphenation Patterns</title>
    147148
    148       <para>Before beginning the build, unpack the
    149       <application>FOP</application> source tarball and the hyphenation zipfile
    150       from the same directory, then change directories into the root of the
    151       <application>FOP</application> source tree. Copy the XML hyphenation
    152       patterns into the <application>FOP</application> source tree by
    153       running the following commands:</para>
     149      <para>First, unpack the <application>fop</application> source tarball and
     150      the hyphenation zipfile from the same directory, then change directories
     151      into the root of the <application>fop</application> source tree. Copy the
     152      XML hyphenation patterns into the <application>fop</application> source
     153      tree by running the following commands:</para>
    154154
    155155<screen><userinput>cp ../offo-hyphenation/hyph/* hyph &amp;&amp;
    … …  
    159159
    160160    <sect3>
    161       <title>Installing JAI</title>
    162 
    163       <tip>
    164         <para>The <command>$FOP_PKG_DIR/jai-&jai-version;-lib-linux-i586-jdk.bin</command>
    165         command below installs the JAI components in the JDK tree. You will be
    166         required to view, and then accept (by entering a <keycap>y</keycap>
    167         keypress), a license agreement before the installation will continue.
    168         If you are scripting (automating) the build, you'll need to account for
    169         this. There is information about automating build commands in the
    170         <xref linkend="automating-builds"/> section of Chapter 2. Towards the
    171         end of this section, specific information for automating this type of
    172         installation is discussed.</para>
    173       </tip>
    174 
    175       <para>Install the JAI components by running the following commands as
    176       the <systemitem class="username">root</systemitem> user while in the
    177       root of the <application>FOP</application> source tree:</para>
    178 
    179 <!-- JAI make tail +nnn only for SunOS now
    180 <screen role="root"><userinput>install -m755 ../jai-&jai-version;-lib-linux-i586-jdk.bin JAI.bin &amp;&amp;
    181 sed -i 's/tail +122/tail -n +122/' JAI.bin &amp;&amp;
    182 -->
    183 <screen role="root"><userinput>FOP_PKG_DIR=$(pwd)/.. &amp;&amp;
    184 pushd $JAVA_HOME &amp;&amp;
    185 sh $FOP_PKG_DIR/jai-&jai-version;-lib-linux-i586-jdk.bin &amp;&amp;
    186 popd</userinput></screen>
     161      <title>Installing Java Advanced Imaging (JAI) API components</title>
     162
     163      <para>Next install the JAI API components. As the <systemitem
     164      class="username">root</systemitem> user:</para>
     165
     166<screen><userinput>case `uname -m` in
     167  i?86)   
     168    tar -xf ../jai-&jai-version;-lib-linux-i586.tar.gz 
     169    cp -v jai-&jai-version;/lib/{jai*,mlibwrapper_jai.jar} $JAVA_HOME/jre/lib/ext/
     170    cp -v jai-&jai-version;/lib/libmlib_jai.so             $JAVA_HOME/jre/lib/i386/
     171    ;;
     172
     173  x86_64)
     174    tar -xf ../jai-&jai-version;-lib-linux-amd64.tar.gz
     175    cp -v jai-&jai-version;/lib/{jai*,mlibwrapper_jai.jar} $JAVA_HOME/jre/lib/ext/
     176    cp -v jai-&jai-version;/lib/libmlib_jai.so             $JAVA_HOME/jre/lib/amd64/
     177    ;;
     178esac</userinput></screen>
    187179
    188180    </sect3>
    189181
    190182    <sect3>
    191       <title>Installing FOP Components</title>
     183      <title>Installing fop Components</title>
    192184
    193185      <para>If <application>Forrest</application> is not installed, remove
    … …  
    197189       -e '\#${dist.bin.result.dir}/docs#,\#&lt;/copy&gt;#d' build.xml</userinput></screen>
    198190
    199       <para>Compile <application>FOP</application> by running the
     191      <para>Compile <application>fop</application> by running the
    200192      following commands:</para>
    201193
    … …  
    218210  <sect2 role="commands">
    219211    <title>Command Explanations</title>
    220 
    221     <para><command>FOP_PKG_DIR=$(pwd)/..</command>: This assumes that the
    222     source packages are stored one level above the current working directory.
    223     This is always the default; but may be different because of personal
    224     taste. If necessary, change this to match the directory where the
    225     <application>FOP</application> tarball can be found.</para>
    226 
    227     <para><command>sh
    228     $FOP_PKG_DIR/jai-&jai-version;-lib-linux-i586-jdk.bin</command>: This
    229     command installs the <application>JAI</application> components
    230     into the <application>JDK</application> file structure.
    231     <envar>$FOP_PKG_DIR</envar> is used as a reference point to the source
    232     executable.</para>
    233212
    234213    <para><command>ant dist</command>: This reads the
    … …  
    236215    builds the package and runs the unit regression tests. It also creates the
    237216    Java API documentation and a directory where the newly created binaries
    238     are placed. This directory is used to install <application>FOP</application>
     217    are placed. This directory is used to install <application>fop</application>
    239218    into its final place.</para>
    240219
    … …  
    246225
    247226  <sect2 role="configuration">
    248     <title>Configuring FOP</title>
     227    <title>Configuring fop</title>
    249228
    250229    <sect3 id="fop-config">
    … …  
    262241      <title>Configuration Information</title>
    263242
    264       <para>Using <application>FOP</application> to process some large FO's
     243      <para>Using <application>fop</application> to process some large FO's
    265244      (including the FO derived from the BLFS XML sources), can lead to memory
    266245      errors. Unless you add a parameter to the <command>java</command> command
    … …  
    280259      <para>The <command>fop</command> script looks for a
    281260      <envar>FOP_HOME</envar> environment variable to locate the
    282       <application>FOP</application> class libraries. You can create this
     261      <application>fop</application> class libraries. You can create this
    283262      variable using the <filename>~/.foprc</filename> file as well. Create
    284263      a <filename>~/.foprc</filename> file using the following commands:</para>
    … …  
    294273      megabytes). An example would be
    295274      <userinput>FOP_OPTS="-Xmx768m"</userinput>. For more information about
    296       memory issues running <application>FOP</application>, see
     275      memory issues running <application>fop</application>, see
    297276      <ulink url="http://xml.apache.org/fop/running.html#memory"/>.</para>
    298277
    … …  
    333312        <listitem>
    334313          <para>is a wrapper script to the <command>java</command> command
    335           which sets up the <application>FOP</application>
     314          which sets up the <application>fop</application>
    336315          environment and passes the required parameters.</para>
    337316          <indexterm zone="fop fop-prog">
    … …  
    344323        <term><filename class='libraryfile'>fop.jar</filename></term>
    345324        <listitem>
    346           <para>contains all the <application>FOP</application>
     325          <para>contains all the <application>fop</application>
    347326          <application>Java</application> classes.</para>
    348327          <indexterm zone="fop fop.jar">
Note: See TracChangeset for help on using the changeset viewer.