renamed patches in package instructions to conform with the guidelines

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2374 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Randy McMurchy 2004-06-24 18:44:11 +00:00
parent c230e053b3
commit 014d11ad36
9 changed files with 293 additions and 282 deletions

View File

@ -42,14 +42,13 @@ url="&rep-gtk-download-ftp;"/></para></listitem>
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink
url="&patch-root;/rep-gtk-&rep-gtk-version;-gtk2.4.patch"/></para></listitem>
url="&patch-root;/rep-gtk-&rep-gtk-version;-gtk2.4-1.patch"/></para></listitem>
</itemizedlist></sect3>
<sect3><title><application>rep-gtk</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="GTK2"/>, <xref linkend="libglade"/> and <xref
linkend="librep"/></para></sect4>
<para><xref linkend="GTK2"/>, <xref linkend="libglade"/> and
<xref linkend="librep"/></para></sect4>
</sect3>
</sect2>
@ -60,28 +59,28 @@ linkend="librep"/></para></sect4>
<para>Install <application>rep-gtk</application> by running the following
commands:</para>
<screen><userinput><command>patch -Np1 -i ../rep-gtk-&rep-gtk-version;-gtk2.4.patch &amp;&amp;
<screen><userinput><command>patch -Np1 -i ../rep-gtk-&rep-gtk-version;-gtk2.4-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
</sect2>
<sect2>
<title>Contents</title>
<para>The <application>rep-gtk</application> package contains Lisp bindings.
</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>Lisp bindings</title>
<para>Lisp bindings are libraries stored in <filename>
/usr/lib/rep/i686-pc-linux-gnu/gui/</filename> that assist communications
between Lisp and the GTK libraries.</para></sect3>
</sect2>
</sect1>

View File

@ -18,10 +18,10 @@
<sect2>
<title>Introduction to <application>libpng</application></title>
<para>The <application>libpng</application> package contains libraries used
by other programs for reading and writing <acronym>PNG</acronym> files.</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
@ -34,34 +34,36 @@ url="&libpng-download-ftp;"/></para></listitem>
<listitem><para>Estimated build time:
&libpng-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch to explicitly link libpng against system libraries: <ulink
url="&patch-root;/libpng-&libpng-version;-link-to-proper-libs.patch"/></para></listitem>
url="&patch-root;/libpng-&libpng-version;-link_to_proper_libs-1.patch"/></para></listitem>
</itemizedlist></sect3>
</sect2>
<sect2>
<title>Installation of <application>libpng</application></title>
<para>Install <application>libpng</application> by running the following commands:</para>
<screen><userinput><command>patch -Np1 -i ../libpng-&libpng-version;-link-to-proper-libs.patch &amp;&amp;
<para>Install <application>libpng</application> by running the following
commands:</para>
<screen><userinput><command>patch -Np1 -i ../libpng-&libpng-version;-link_to_proper_libs-1.patch &amp;&amp;
make prefix=/usr ZLIBINC=/usr/include \
ZLIBLIB=/usr/lib -f scripts/makefile.linux &amp;&amp;
make prefix=/usr install -f scripts/makefile.linux</command></userinput></screen>
</sect2>
<sect2>
<title>Command explanations</title>
<para><parameter>ZLIBINC=/usr/include ZLIBLIB=/usr/lib</parameter>: This
forces <application>libpng</application> to look for the
<application>zlib</application> includes and libraries where we have them installed.</para>
<application>zlib</application> includes and libraries where we have them
installed.</para>
<para><parameter>-f scripts/makefile.linux</parameter>: This points make at the
Linux version of the makefile as <application>libpng</application> doesn't use
an autoconf routine. Instead it has various makefiles for different
@ -71,25 +73,26 @@ platforms.</para>
<sect2>
<title>Configuring <application>libpng</application></title>
<sect3><title>Configuration Information</title>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
</sect3>
</sect2>
<sect2>
<title>Contents</title>
<para>The <application>libpng</application> package contains <filename class="libraryfile">
libpng</filename> libraries and <command>libpng-config</command>.</para>
<para>The <application>libpng</application> package contains
<filename class="libraryfile"> libpng</filename> libraries and
<command>libpng-config</command>.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>png libraries</title>
<para>The <acronym>PNG</acronym> library is a collection of routines used to
create and manipulate <acronym>PNG</acronym> format graphics files. The
@ -97,11 +100,11 @@ create and manipulate <acronym>PNG</acronym> format graphics files. The
replacement for <acronym>GIF</acronym> and, to a lesser extent,
<acronym>TIFF</acronym>, with many improvements and extensions and lack of
patent problems.</para></sect3>
<sect3><title>libpng-config</title>
<para><command>libpng-config</command> provides configuration info for
<application>libpng</application>.</para></sect3>
</sect2>
</sect1>

View File

@ -18,24 +18,24 @@
<sect2>
<title>Introduction to <application>libungif</application></title>
<para>The libungif package contains libraries for reading all
<acronym>GIF</acronym>s and writing non-compressed ones as well as programs for
<acronym>GIF</acronym>s and writing non-compressed ones as well as programs for
converting and working with <acronym>GIF</acronym> files. The libraries are
useful for any graphics program wishing to deal with <acronym>GIF</acronym>
files while the programs are useful for conversion purposes as well as cleaning
files while the programs are useful for conversion purposes as well as cleaning
up images.</para>
<para>The reason libungif only writes non-compressed <acronym>GIF</acronym>s
is due to a legal issue with <acronym>LZW</acronym> compression (which Unisys
claims a patent on). Reading <acronym>GIF</acronym>s is not a problem as the
decompression routines do not seem to be limited in this way. Note that this
has in the past been disputed. The best way to avoid this whole mess is to
simply use libungif for looking at <acronym>GIF</acronym> images on the web,
while in any pages which you design, use the open source <acronym>PNG</acronym>
while in any pages which you design, use the open source <acronym>PNG</acronym>
format instead (which uses, not surprisingly, the libpng library) which has no
patent issues at all.</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&libungif-download-http;"/></para></listitem>
@ -44,39 +44,39 @@ patent issues at all.</para>
<listitem><para>Estimated Disk space required: &libungif-buildsize;</para></listitem>
<listitem><para>Estimated build time: &libungif-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required patch: <ulink
url="&patch-root;/libungif-4.1.0b1-va_start.patch"/></para></listitem>
url="&patch-root;/libungif-4.1.0b1-va_start-1.patch"/></para></listitem>
</itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Installation of <application>libungif</application></title>
<para>Install <application>libungif</application> by running the following
commands:</para>
<screen><userinput><command>patch -Np1 -i ../libungif-4.1.0b1-va_start.patch &amp;&amp;
<screen><userinput><command>patch -Np1 -i ../libungif-4.1.0b1-va_start-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
<!--
<note><para>If you get an error during the make portion compiling
<filename>lib/qprintf.c</filename>,
edit the file and comment out or remove line 14: #include &lt;config.h&gt;
</para></note>
-->
</sect2>
<sect2>
<title>Contents</title>
<para>The libungif package contains <command>gif2epsn</command>,
<command>gif2ps</command>, <command>gif2rgb</command>,
<command>gifasm</command>, <command>gifbg</command>,
@ -93,52 +93,54 @@ edit the file and comment out or remove line 14: #include &lt;config.h&gt;
<command>icon2gif</command>, <command>raw2gif</command>,
<command>rgb2gif</command>, <command>text2gif</command> and
<filename>libungif</filename> libraries.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>gif2epsn</title>
<para>Dumps images saved as <acronym>GIF</acronym> files on Epson type printers.</para></sect3>
<para>Dumps images saved as <acronym>GIF</acronym> files on Epson type
printers.</para></sect3>
<sect3><title>gif2ps</title>
<para>Print <acronym>GIF</acronym> files on laser printers supporting PostScript.
</para></sect3>
<sect3><title>gif2rgb</title>
<para>Convert images saved as <acronym>GIF</acronym> to 24-bit <acronym>RGB
</acronym> image(s).</para></sect3>
<sect3><title>gifasm</title>
<para>Assemble multiple <acronym>GIF</acronym>s into one, or burst a
multiple-image <acronym>GIF</acronym>.</para></sect3>
<sect3><title>gifbg</title>
<para>Generate a single-color test pattern <acronym>GIF</acronym>.</para>
</sect3>
<sect3><title>gifburst</title>
<para>Burst a <acronym>GIF</acronym> image into subrectangles.</para></sect3>
<sect3><title>gifclip</title>
<para>Clip or crop a <acronym>GIF</acronym> image.</para></sect3>
<sect3><title>gifclrmp</title>
<para>Modify <acronym>GIF</acronym> image colormaps.</para></sect3>
<sect3><title>gifcolor</title>
<para>Generate color test patterns.</para></sect3>
<sect3><title>gifcomb</title>
<para>Combine 2 <acronym>GIF</acronym> images of exactly the same size into one.
</para></sect3>
<sect3><title>gifcompose</title>
<para>Use (un)giflib tools to compose images.</para></sect3>
<sect3><title>giffiltr</title>
<para>Template code for filtering a <acronym>GIF</acronym> sequentially.</para></sect3>
<para>Template code for filtering a <acronym>GIF</acronym>
sequentially.</para></sect3>
<sect3><title>giffix</title>
<para>Clumsily attempts to fix truncated <acronym>GIF</acronym> images.</para>
</sect3>
@ -146,60 +148,62 @@ multiple-image <acronym>GIF</acronym>.</para></sect3>
<sect3><title>gifflip</title>
<para>Flip <acronym>GIF</acronym> image along X or Y axis or rotate by 90
degrees.</para></sect3>
<sect3><title>gifhisto</title>
<para>Generate color-frequency histogram from a <acronym>GIF</acronym>.</para>
</sect3>
<sect3><title>gifinfo</title>
<para>Gives information on a <acronym>GIF</acronym> file.</para></sect3>
<sect3><title>gifinter</title>
<para>Convert between interlaced and non-interlaced images.</para></sect3>
<sect3><title>gifinto</title>
<para>End-of-pipe fitting for <acronym>GIF</acronym>-processing pipelines.</para></sect3>
<para>End-of-pipe fitting for <acronym>GIF</acronym>-processing
pipelines.</para></sect3>
<sect3><title>gifovly</title>
<para>Generate one composite <acronym>GIF</acronym> from a multiple-image
<acronym>GIF</acronym>.</para></sect3>
<sect3><title>gifpos</title>
<para>Change a GIF's screen size or recondition it.</para></sect3>
<sect3><title>gifrotat</title>
<para>Rotate a <acronym>GIF</acronym> through any desired angle.</para></sect3>
<para>Rotate a <acronym>GIF</acronym> through any desired angle.</para></sect3>
<sect3><title>gifrsize</title>
<para>Resize a <acronym>GIF</acronym> by deletion or duplication of bits.</para>
</sect3>
<sect3><title>gifspnge</title>
<para>Template code for filtering a <acronym>GIF</acronym> with in-core
operations.</para></sect3>
<sect3><title>giftext</title>
<para>Print (text only) general information about a <acronym>GIF</acronym>.
</para></sect3>
<sect3><title>gifwedge</title>
<para>Create a test <acronym>GIF</acronym> image resembling a color monitor
test pattern.</para></sect3>
<sect3><title>icon2gif</title>
<para>Converter/deconverter to/from an editable text format.</para></sect3>
<sect3><title>raw2gif</title>
<para>Convert raw 8-bit image data into <acronym>GIF</acronym> files.</para>
</sect3>
<sect3><title>rgb2gif</title>
<para>Convert 24 bit images to a <acronym>GIF</acronym> image using color
quantization.</para></sect3>
<sect3><title>text2gif</title>
<para>Generate <acronym>GIF</acronym> images out of regular text in 8x8 font.
</para></sect3>
</sect2>
</sect1>

View File

@ -18,39 +18,40 @@
<sect2>
<title>Introduction to j2sdk</title>
<para>The <application>J2SDK</application> package contains Sun's
<application>Java</application> development environment. This is useful for
developing <application>Java</application> programs and provides the runtime
environment necessary to run <application>Java</application> programs. It also
environment necessary to run <application>Java</application> programs. It also
includes a plug-in for browsers so that they can be <application>Java
</application> aware.</para>
<para>
The <acronym>JDK</acronym> comes in two flavors, a precompiled binary and a
source package. Previously, the plugin included in the <acronym>JDK</acronym> binary
package was unusable on <acronym>LFS</acronym>
owing to incompatibilities with <acronym>GCC</acronym>-3 compiled browsers.
This is not the case anymore.</para>
<para>The source package requires registration at the Sun
developer site and accepting the Sun Community Source License.
The source code cannot be downloaded from some countries, so for users
from those countries, the binary may be the only option.</para>
<para>Even if you plan on compiling the <acronym>JDK</acronym> source, you will
<para>Even if you plan on compiling the <acronym>JDK</acronym> source, you will
need to download the binary version to bootstrap the <acronym>JDK</acronym>
build. Follow the link below to download both source and binary packages. When
downloading the source also download the <application>Mozilla</application>
headers package available at the same location.</para>
<!--
<para>For users who cannot download the <application>J2SDK</application> source owing to license restrictions, <application>blackdown
<para>For users who cannot download the <application>J2SDK</application>
source owing to license restrictions, <application>blackdown
</application> has an <acronym>GCC</acronym>-3 based precompiled version.
Check out <ulink url="http://www.blackdown.org/"/> for more
information.</para>
-->
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
@ -69,40 +70,39 @@ url="&j2sdk-download-ftp;"/></para></listitem>
<listitem><para>Estimated build time:
&j2sdk-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-fix-inline-asm-1.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-fix_inline_asm-1.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-gcc33-1.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-motif-mkmsgcat.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-remove-debug-image.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-remove-fixed-paths-1.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-static_cxx.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-ash.patch"/> (Only required if /bin/sh is symlinked to <xref linkend="ash"/>)</para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-motif_mkmsgcat-1.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-remove_debug_image-1.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-remove_fixed_paths-1.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-static_cxx-1.patch"/></para></listitem>
<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-ash-1.patch"/> (Only required if /bin/sh is symlinked to <xref linkend="ash"/>)</para></listitem>
</itemizedlist>
</sect3>
<sect3><title><application>J2SDK</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>), <xref linkend="zip"/>, <xref
linkend="unzip"/>, <xref linkend="cpio"/>, <xref linkend="alsa"/>,
and <xref linkend="tcsh"/>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
<xref linkend="zip"/>, <xref linkend="unzip"/>, <xref linkend="cpio"/>,
<xref linkend="alsa"/>, and <xref linkend="tcsh"/>
</para></sect4>
</sect3>
</sect2>
<sect2>
<title>Installation of <application>J2SDK</application></title>
<para>Both versions will be installed in parallel. You may choose to keep
either or both.</para>
<para>Installation of the precompiled <acronym>JDK</acronym> is easy:
create a directory to install from, copy the .bin there, and run the
following commands:</para>
<screen><userinput><command>VERSION=&j2sdk-bin-version; &amp;&amp;
MV=`echo $VERSION | cut -d "_" -f 1,1` &amp;&amp;
V=`echo ${VERSION} | sed -e "s/\./_/g"` &amp;&amp;
@ -114,34 +114,35 @@ yes | PATH=$PWD/bin:$PATH ./j2sdk-${V}-linux-i?86.bin &amp;&amp;
cd j2sdk${VERSION} &amp;&amp;
install -d /opt/j2sdk/j2sdk-precompiled-${MV} &amp;&amp;
mv * /opt/j2sdk/j2sdk-precompiled-${MV}</command></userinput></screen>
<para>The binary version is now installed. </para>
<para>If you don't want to compile the source or are not in a postition to download the source
owing to license restrictions, skip ahead to the configuration
section.</para>
<para>The binary version is now installed.</para>
<para>If you don't want to compile the source or are not in a position to
download the source owing to license restrictions, skip ahead to the
configuration section.</para>
<para>Add the recently compiled <acronym>JDK</acronym> to the path.</para>
<screen><userinput><command>export JAVA_HOME=/opt/j2sdk/j2sdk-precompiled-${MV} &amp;&amp;
export PATH=$PATH:${JAVA_HOME}/bin</command></userinput></screen>
<para>Unzip the source:</para>
<screen><userinput><command>VERSION=&j2sdk-src-version; &amp;&amp;
V=`echo $VERSION | sed -e "s/\./_/g"` &amp;&amp;
unzip j2sdk-${V}-src-scsl.zip &amp;&amp;
unzip j2sdk-${V}-mozilla_headers-unix.zip &amp;&amp;
unzip j2sdk-${V}-bin-scsl.zip</command></userinput></screen>
<para>Apply all the patches downloaded above.</para>
<screen><userinput><command>for PATCH in fix-inline-asm-1 gcc33-1 motif-mkmsgcat \
remove-debug-image remove-fixed-paths-1 \
static_cxx
<screen><userinput><command>for PATCH in fix_inline_asm-1 gcc33-1 \
motif_mkmsgcat-1 remove_debug_image-1 remove_fixed_paths-1 \
static_cxx-1
do
patch -Np1 -i j2sdk-1.4.2-$PATCH.patch
done</command></userinput></screen>
<para>Set/unset some variables which affect the build:</para>
<screen><userinput><command>export ALT_BOOTDIR="$JAVA_HOME" &amp;&amp;
unset JAVA_HOME &amp;&amp;
@ -156,121 +157,120 @@ export ALT_MOZILLA_PATH=$PWD &amp;&amp;
export INSANE=true &amp;&amp;
export MAKE_VERBOSE=true &amp;&amp;
export ALT_CACERTS_FILE=${ALT_BOOTDIR}/jre/lib/security/cacerts</command></userinput></screen>
<warning><para>Setting CFLAGS/CXXFLAGS/LDFLAGS is guaranteed to make the build fail.
If you are interested in optimizing the build, set OTHER_CFLAGS/OTHER_CXXFLAGS/OTHER_LDFLAGS
instead.</para></warning>
<warning><para>Setting CFLAGS/CXXFLAGS/LDFLAGS is guaranteed to make the build
fail. If you are interested in optimizing the build, set
OTHER_CFLAGS/OTHER_CXXFLAGS/OTHER_LDFLAGS instead.</para></warning>
<para>Additionally, if you would like to make in parallel, add the following
(adjust <envar>MAKE_PARALLEL</envar> to your liking):</para>
<screen><userinput><command>export HOTSPOT_BUILD_JOBS=$MAKE_PARALLEL</command></userinput></screen>
<para>If the included <application>Motif</application> doesn't build properly, the
error is noticed much later in the build.
A solution is to build the <application>Motif</application>
library before compiling the <application>J2SDK</application>.</para>
<para>If the included <application>Motif</application> doesn't build properly,
the error is noticed much later in the build. A solution is to build the
<application>Motif</application> library before compiling the
<application>J2SDK</application>.</para>
<screen><userinput><command>cd motif/lib/Xm &amp;&amp;
make &amp;&amp;
cd ../../..</command></userinput></screen>
<para>Make and Install <application>J2SDK</application> with the following
commands. There will be a lot of messages about missing files that look like
errors. As long as the build doesn't stop, the messages are harmless, so ignore
errors. As long as the build doesn't stop, the messages are harmless, so ignore
them.</para>
<screen><userinput><command>cd control/make &amp;&amp;
make &amp;&amp;
cd ../.. &amp;&amp;
cd control/build/linux-i?86 &amp;&amp;
cp -a j2sdk-image /opt/j2sdk/j2sdk-&j2sdk-src-version;</command></userinput></screen>
</sect2>
<sect2>
<title>Command explanations</title>
<para><command>export ALT_BOOTDIR="$JAVA_HOME"</command>: This var sets
location of the bootstrap <acronym>JDK</acronym>.
</para>
location of the bootstrap <acronym>JDK</acronym>.</para>
<para><command>export ALT_MOZILLA_PATH=$PWD</command>: This sets the
variable that points to where you unzipped the <application>Mozilla
</application> headers.</para>
<para><command>export ALT_DEVTOOLS_PATH="/usr/bin"</command>: This
changes the location where the build finds the needed executables.
</para>
changes the location where the build finds the needed executables.</para>
<para><command>export BUILD_NUMBER="blfs-`date +%s`"</command>: This will
help you identify this compiled version of the runtime environment and
virtual machine by appending this information to the version in the
output to <command>java -version</command>.</para>
<para><command>export DEV_ONLY=true</command>: This command
eliminates compiling the documentation and eliminates a dependency for
<application>rpm</application>. </para>
<application>rpm</application>.</para>
<para><command>unset JAVA_HOME</command>: This clears the
<envar>JAVA_HOME</envar>
variable as recommended by the build instructions.</para>
<envar>JAVA_HOME</envar> variable as recommended by the build
instructions.</para>
<para><command>unset CLASSPATH</command>: This clears the
<envar>CLASSPATH</envar> variable as per the recommendations in the build instructions.
</para>
<envar>CLASSPATH</envar> variable as per the recommendations in the build
instructions.</para>
<para><command>unset CFLAGS...</command>: These flags cause miscompilation
of the build. Never set these.</para>
<para><command>export INSANE=true</command>: Unless you specify that you
are insane the build will not proceed. The certified platform for the build is
Redhat 6.1. The above variable ensures that all the errors related to
compiling on a non-certified platform will be converted to warnings.</para>
<para><command>export MAKE_VERBOSE=true</command>: Allows the current
compilation command to be displayed on the console.</para>
<para><command>export ALT_CACERTS_FILE...</command>: Specifies the
certificate file to use.</para>
</sect2>
<sect2>
<title>Configuring <application>J2SDK</application></title>
<sect3><title>Configuration Information</title>
<para>We have two Java 2 <acronym>SDK</acronym>'s installed in
<filename>/opt/j2sdk</filename>. Decide on which one you
would like to use as the default. For example if you decide to use the source
compiled <application>J2SDK</application>, do the following:</para>
<screen><userinput><command>ln -nsf j2sdk-&j2sdk-src-version; /opt/j2sdk/j2sdk</command></userinput></screen>
<para>Add the following lines to your shell startup file (e.g.,
<filename>/etc/profile</filename>).</para>
<screen><userinput>export JAVA_HOME=/opt/j2sdk/j2sdk
export PATH=$PATH:$JAVA_HOME/bin</userinput></screen>
<para>Add <filename>$JAVA_HOME/man</filename> to your
<envar>MANPATH</envar> variable or to
<filename>/etc/man.conf</filename></para>
<para>The <application>Java</application> plugin is in the directory
<filename class="directory">$JAVA_HOME/jre/plugin/i?86/ns610/</filename>.
Make a symbolic link to the file in that directory from your plugins directory.</para>
</sect3>
<sect3><title>Handling CLASSPATH</title>
<para>When compiling packages, the <envar>CLASSPATH</envar> environment variable
is used by JDK to locate classes at compile-time and run-time. It is tedious toadd all the classes used to the <envar>CLASSPATH</envar> manually. You may add
is used by JDK to locate classes at compile-time and run-time. It is tedious to
add all the classes used to the <envar>CLASSPATH</envar> manually. You may add
the following lines to your shell startup file to set <envar>CLASSPATH</envar>
automatically to include all JAR files in a specified directory, which in
the example below is <filename>/usr/lib/auto-java-classpath</filename>.</para>
<screen><userinput>AUTO_CLASSPATH_DIR=/usr/lib/auto-java-classpath
if [ -z $CLASSPATH ]
then
@ -282,14 +282,14 @@ for i in $(ls $AUTO_CLASSPATH_DIR/*.jar 2>/dev/null)
do
CLASSPATH=$CLASSPATH:$i
done</userinput></screen>
</sect3>
</sect2>
<sect2>
<title>Contents</title>
<para>The <application>J2SDK</application> package contains
<command>appletviewer</command>,
<command>extcheck</command>, <command>idlj</command>,
@ -303,101 +303,103 @@ done</userinput></screen>
<command>rmiregistry</command>, <command>rmiregistry</command>,
<command>serialver</command>, <command>servertool</command> and
<command>tnameserv</command>.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>appletviewer</title>
<para><command>appletviewer</command> runs
<application>Java</application> applets outside of the context of a
browser.</para></sect3>
<para><command>appletviewer</command> runs <application>Java</application>
applets outside of the context of a browser.</para></sect3>
<sect3><title>extcheck</title>
<para><command>extcheck</command> checks a specified <filename>JAR</filename>
file for title and version conflicts with any extensions installed in the
<acronym>JDK</acronym> software.</para></sect3>
<sect3><title>idlj</title>
<para><command>idlj</command> generates <application>Java</application>
bindings from a given <acronym>IDL</acronym> file.</para></sect3>
<sect3><title>jar</title>
<para><command>jar</command> combines multiple files into a single
<acronym>JAR</acronym> archive file.</para></sect3>
<sect3><title>jarsigner</title>
<para><command>jarsigner</command> signs <filename>JAR</filename>
(Java ARchive) files and verifies the signatures and integrity of a signed
<filename>JAR</filename>.</para></sect3>
<sect3><title>java</title>
<para><command>java</command> launches a <application>Java</application>
application by starting a <application>Java</application> runtime
environment, loading a specified class and invoking its main
method.</para></sect3>
<sect3><title>javac</title>
<para><command>javac</command> reads class and interface definitions, written
in the <application>Java</application> programming language, and compiles them
into bytecode class files.</para></sect3>
<sect3><title>javadoc</title>
<para><command>javadoc</command> parses the declarations and documentation
comments in a set of <application>Java</application> source files and produces
a corresponding set of <acronym>HTML</acronym> pages describing the classes,
interfaces, constructors, methods, and fields.</para></sect3>
<sect3><title>javah</title>
<para><command>javah</command> generates <application>C</application> header
and source files that are needed to implement native methods.</para></sect3>
<sect3><title>javap</title>
<para><command>javap</command> disassembles a
<application>Java</application> class file.</para></sect3>
<sect3><title>jdb</title>
<para><command>jdb</command> is a simple command-line debugger for
<application>Java</application> classes.</para></sect3>
<sect3><title>keytool</title>
<para><command>keytool</command> is a key and certificate management utility.</para></sect3>
<para><command>keytool</command> is a key and certificate management
utility.</para></sect3>
<sect3><title>native2ascii</title>
<para><command>native2ascii</command> converts files that contain non-supported
character encoding into files containing Latin-1 or Unicode-encoded characters.</para></sect3>
character encoding into files containing Latin-1 or Unicode-encoded
characters.</para></sect3>
<sect3><title>orbd</title>
<para><command>orbd</command> is used to enable clients to transparently locate
and invoke persistent objects on servers in the <acronym>CORBA</acronym>
environment.</para></sect3>
<sect3><title>policytool</title>
<para><command>policytool</command> creates and manages a policy file
graphically.</para></sect3>
<sect3><title>rmic</title>
<para><command>rmic</command> generates stub and skeleton class files for
remote objects from the names of compiled <application>Java</application>
classes that contain remote object implementations.</para></sect3>
<sect3><title>rmid</title>
<para><command>rmid</command> starts the activation system daemon.</para>
</sect3>
<sect3><title>rmiregistry</title>
<para><command>rmiregistry</command> creates and starts a remote object
registry on the specified port on the current host.</para></sect3>
<sect3><title>serialver</title>
<para><command>serialver</command> returns the serialVersionUID for one or
more classes in a form suitable for copying into an evolving class.</para>
</sect3>
<sect3><title>servertool</title>
<para><command>servertool</command> provides an ease-of-use interface for
application programmers to register, unregister, startup and shutdown a server.</para></sect3>
application programmers to register, unregister, startup and shutdown a
server.</para></sect3>
<sect3><title>tnameserv</title>
<para><command>tnameserv</command> starts the <application>Java</application>
<acronym>IDL</acronym> name server.</para></sect3>

View File

@ -18,7 +18,7 @@
<sect2>
<title>Introduction to <application><acronym>GPM</acronym></application></title>
<para>The <application><acronym>GPM</acronym></application> (General
Purpose Mouse daemon) package contains a mouse server for the console
and <command>xterm</command>. It not only provides cut and paste support
@ -28,7 +28,7 @@ application. It is useful on desktops, especially if following
(Beyond) Linux From Scratch instructions; it's often much easier (and
less error prone) to cut and paste between two console windows than to
type everything by hand!</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
@ -41,26 +41,27 @@ url="&gpm-download-ftp;"/></para></listitem>
<listitem><para>Estimated build time:
&gpm-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Recommended patch: <ulink
url="&patch-root;/gpm-1.20.1-segfault.patch"/></para></listitem>
url="&patch-root;/gpm-1.20.1-segfault-1.patch"/></para></listitem>
<listitem><para>Recommended patch: <ulink
url="&patch-root;/gpm-1.20.1-silent.patch"/></para></listitem>
url="&patch-root;/gpm-1.20.1-silent-1.patch"/></para></listitem>
</itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Installation of <application><acronym>GPM</acronym></application></title>
<para>Install <application><acronym>GPM</acronym></application> by running the following commands:
<para>Install <application><acronym>GPM</acronym></application> by running
the following commands:
</para>
<screen><userinput><command>patch -Np1 -i ../gpm-1.20.1-segfault.patch &amp;&amp;
patch -Np1 -i ../gpm-1.20.1-silent.patch &amp;&amp;
<screen><userinput><command>patch -Np1 -i ../gpm-1.20.1-segfault-1.patch &amp;&amp;
patch -Np1 -i ../gpm-1.20.1-silent-1.patch &amp;&amp;
LDFLAGS="-lm" ./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
@ -70,53 +71,53 @@ ldconfig -n -l /usr/lib/libgpm.so.1.19.0</command></userinput></screen>
<sect2>
<title>Command explanations</title>
<para><command>LDFLAGS="-lm"</command>: The math library
must be linked with <command>gpm</command>, as ceil() is used in some cursor
<para><command>LDFLAGS="-lm"</command>: The math library
must be linked with <command>gpm</command>, as ceil() is used in some cursor
scrolling logic.</para>
<para><command>ldconfig -n -l </command>: During installation, gpm outputs a
message to run the above command to create the proper library links.</para>
</sect2>
<sect2>
<title>Configuring <application><acronym>GPM</acronym></application></title>
<sect3><title>gpm init.d script</title>
<para>Install the <filename>/etc/rc.d/init.d/gpm</filename>
init script included in the
<xref linkend="intro-important-bootscripts"/> package.</para>
<screen><userinput><command>make install-gpm</command></userinput></screen>
</sect3>
<sect3><title>Config files</title>
<para><filename>/etc/sysconfig/mouse</filename>
This file contains the name of your mouse device and the protocol which
it uses. To create this file, run the following:</para>
<screen><userinput><command>cat &gt; /etc/sysconfig/mouse &lt;&lt; "EOF"</command>
# Begin /etc/sysconfig/mouse
MDEVICE="<replaceable>[yourdevice]</replaceable>"
PROTOCOL="<replaceable>[yourprotocol]</replaceable>"
GPMOPTS="<replaceable>[additional options]</replaceable>"
# End /etc/sysconfig/mouse
<command>EOF</command></userinput></screen>
</sect3>
<sect3><title>Configuration Information</title>
<para>Examples of values to set <envar>MDEVICE</envar>,
<envar>PROTOCOL</envar>, and <envar>GPMOPTS</envar> to are:</para>
<screen><userinput>MDEVICE="/dev/psaux"
PROTOCOL="imps2"
GPMOPTS=""</userinput></screen>
<para>A list of which protocol values are known can be found by running
<command>gpm -t -help</command>. The <envar>MDEVICE</envar> setting
depends on which type of mouse you have. For example,
@ -125,38 +126,37 @@ COM1), <filename>/dev/input/mice</filename> is often used for
<acronym>USB</acronym> mice and <filename>/dev/psaux</filename> for PS2
mice. <envar>GPMOPTS</envar> is the 'catch all' for any
additional options that are needed for your hardware.</para>
</sect3>
</sect2>
<sect2>
<title>Contents</title>
<para>The <application><acronym>GPM</acronym></application> package contains
<command>gpm</command>,
<command>gpm-root</command>, <command>disable-paste</command>
and <command>mev</command>.</para>
<command>gpm</command>, <command>gpm-root</command>,
<command>disable-paste</command> and <command>mev</command>.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>gpm</title>
<para><command>gpm</command> is a cut and paste utility and mouse server for
virtual consoles.</para></sect3>
<sect3><title>gpm-root</title>
<para><command>gpm-root</command> is a default handler for
<command>gpm</command>. It is used to draw menus on the
root window.</para></sect3>
<sect3><title>disable-paste</title>
<para>No description available.</para></sect3>
<sect3><title>mev</title>
<para><command>mev</command> is a program to report mouse events.</para></sect3>
</sect2>
</sect1>

View File

@ -18,14 +18,14 @@
<sect2>
<title>Introduction to <application>UnZip</application></title>
<para>The <application>UnZip</application> package contains <filename>ZIP
</filename> extraction utilities. These are useful for extracting files from
<filename>ZIP</filename> archives. <filename>ZIP</filename> archives are
created with <application>PKZIP</application> or <application>Info-ZIP
</application> utilities primarily in a <acronym>DOS</acronym> environment.
</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink
@ -38,90 +38,90 @@ url="&unzip-download-ftp;"/></para></listitem>
<listitem><para>Estimated build time:
&unzip-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required patch: <ulink
url="&patch-root;/unzip-&unzip-version;-fix-Makefile.patch"/></para></listitem><listitem><para>Required patch: <ulink
url="&patch-root;/unzip-&unzip-version;-fix-libz.patch"/></para></listitem>
url="&patch-root;/unzip-&unzip-version;-fix_Makefile-1.patch"/></para></listitem><listitem><para>Required patch: <ulink
url="&patch-root;/unzip-&unzip-version;-fix_libz-1.patch"/></para></listitem>
<listitem><para>Recommended patch: <ulink
url="&patch-root;/unzip-&unzip-version;-dont-make-noise.patch"/></para></listitem></itemizedlist>
url="&patch-root;/unzip-&unzip-version;-dont_make_noise-1.patch"/></para></listitem></itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Installation of <application>UnZip</application></title>
<para>By default, <application>UnZip</application> does not support shrink
decompression. To enable it or to obtain more information, check out the
<application>UnZip</application> <acronym>FAQ</acronym> at
<ulink url="http://www.info-zip.org/pub/infozip/FAQ.html#unshrink"/>.</para>
<para>Install <application>UnZip</application> by running the following
commands:</para>
<screen><userinput><command>patch -Np1 -i ../unzip-&unzip-version;-fix-Makefile.patch &amp;&amp;
patch -Np1 -i ../unzip-&unzip-version;-fix-libz.patch &amp;&amp;
patch -Np1 -i ../unzip-&unzip-version;-dont-make-noise.patch &amp;&amp;
<screen><userinput><command>patch -Np1 -i ../unzip-&unzip-version;-fix_Makefile-1.patch &amp;&amp;
patch -Np1 -i ../unzip-&unzip-version;-fix_libz-1.patch &amp;&amp;
patch -Np1 -i ../unzip-&unzip-version;-dont_make_noise-1.patch &amp;&amp;
cp unix/Makefile . &amp;&amp;
make prefix=/usr linux &amp;&amp;
make prefix=/usr linux_shlibz &amp;&amp;
make prefix=/usr install &amp;&amp;
cp -a libunzip.so* /usr/lib</command></userinput></screen>
</sect2>
<sect2>
<title>Command explanations</title>
<para><command>make prefix=/usr linux</command>: This command
overrides the prefix variable that is set to
<filename class='directory'>/usr/local</filename> in the
<filename>Makefile</filename>
and builds the executables for a linux system. The alternatives to
'linux' can be seen with a 'make list' command.</para>
<para><command>make prefix=/usr linux_shlibz</command>: Build shared
<filename>libunzip</filename> and link <application>UnZip</application> against
<filename>libunzip</filename> and link <application>UnZip</application> against
it and <application>zlib</application>.</para>
</sect2>
<sect2>
<title>Contents</title>
<para>The <application>UnZip</application> package contains <command>unzip
</command>, <command>funzip</command>, <command>unzipfsx</command>,
<command>zipgrep</command> and <command>zipinfo</command>.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>unzip</title>
<para><command>unzip</command> lists, tests or extracts files from a
<filename>ZIP</filename> archive.</para></sect3>
<sect3><title>funzip</title>
<para><command>funzip</command> allows the output of <command>unzip</command>
commands to be redirected.</para></sect3>
<sect3><title>unzipfsx</title>
<para><command>unzipfsx</command> is the self-extracting stub that can be
prepended to a <filename>ZIP</filename> archive. Files in this format allow
the recipient to decompress the archive without installing
<application>UnZip</application>.</para></sect3>
<sect3><title>zipgrep</title>
<para><command>zipgrep</command> is a grep for <filename>ZIP</filename>
archives.</para></sect3>
<sect3><title>zipinfo</title>
<para><command>zipinfo</command> produces technical information about the files
<para><command>zipinfo</command> produces technical information about the files
in a <filename>ZIP</filename> archive, including file access permissions,
encryption status, type of compression, etc.</para></sect3>
</sect2>
</sect1>

View File

@ -39,9 +39,9 @@ url="&gnome-print-download-ftp;"/></para></listitem>
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink
url="&patch-root;/gnome-print-&gnome-print-version;-ft217-fixes.patch"/></para></listitem>
url="&patch-root;/gnome-print-&gnome-print-version;-ft217_fixes-1.patch"/></para></listitem>
</itemizedlist></sect3>
<sect3><title><application><acronym>GNOME</acronym> Print</application> dependencies</title>
<sect4><title>Required</title>
<para><xref linkend="gdk"/></para></sect4>
@ -63,10 +63,10 @@ XML_INCLUDEDIR="-I/usr/include/gnome-xml"
MODULE_VERSION=xml-&libxml-version;
<command>EOF</command></userinput></screen>
<para>Install <application><acronym>GNOME</acronym> Print</application> by running the following
commands:</para>
<para>Install <application><acronym>GNOME</acronym> Print</application> by
running the following commands:</para>
<screen><userinput><command>patch -Np1 -i ../gnome-print-&gnome-print-version;-ft217-fixes.patch &amp;&amp;
<screen><userinput><command>patch -Np1 -i ../gnome-print-&gnome-print-version;-ft217_fixes-1.patch &amp;&amp;
./configure --prefix=/opt/gnome --with-zlib=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

View File

@ -18,6 +18,9 @@ who wrote what.</para>
<itemizedlist>
<listitem><para>June 24th, 2004 [randy]: Renamed several package's patch names
to conform with the patch naming guidelines.</para></listitem>
<listitem><para>June 24th, 2004 [randy]: Fixed gcc-2.95.3 instructions.</para></listitem>
<listitem><para>June 23rd, 2004 [bdubbs]: Updated to mozilla 1.7.</para></listitem>

View File

@ -40,7 +40,7 @@ and Shadow packages. </para>
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required patch: <ulink
url="&patch-root;/heimdal-&heimdal-version;-fhs-compliance-1.patch"/></para>
url="&patch-root;/heimdal-&heimdal-version;-fhs_compliance-1.patch"/></para>
</listitem>
<listitem><para>Required patch for cracklib: <ulink
url="&patch-root;/heimdal-&heimdal-version;-cracklib-1.patch"/></para>
@ -99,7 +99,7 @@ you must apply a patch:
<para>Install <application>Heimdal</application> by running the following commands:</para>
<screen><userinput><command>patch -Np1 -i ../heimdal-&heimdal-version;-fhs-compliance-1.patch &amp;&amp;
<screen><userinput><command>patch -Np1 -i ../heimdal-&heimdal-version;-fhs_compliance-1.patch &amp;&amp;
./configure --prefix=/usr --sysconfdir=/etc/heimdal \
--datadir=/var/lib/heimdal --libexecdir=/usr/sbin \
--sharedstatedir=/usr/share --localstatedir=/var/lib/heimdal \
@ -196,7 +196,7 @@ Create the Kerberos configuration file with the following command:
<screen><userinput><command>install -d /etc/heimdal &amp;&amp;
cat &gt; /etc/heimdal/krb5.conf &lt;&lt; "EOF"</command>
# Begin /etc/heimdal/krb5.conf
[libdefaults]
default_realm = <replaceable>[LFS.ORG]</replaceable>
encrypt = true