Changeset 52d29f7 for general

general/general.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+ <!ENTITY % general-entities SYSTEM "../general.ent">
+ %general-entities;
+]>
 <part id="general" xreflabel="General Libraries and Utilities">
 <?dbhtml filename="general.html" dir="general"?>
 <title>General Libraries and Utilities</title>
+&general-genlib;
+&general-graphlib;
+&general-genutils;
+&general-sysutils;
+&general-prog;
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="genlib/genlib.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="graphlib/graphlib.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="genutils/genutils.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sysutils/sysutils.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="prog/prog.xml"/>
 </part>

general/genlib/aspell.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY aspell-download-http " ">
+<!ENTITY aspell-download-ftp "ftp://ftp.gnu.org/gnu/aspell/aspell-&aspell-version;.tar.gz">
+<!ENTITY aspell-size "917 KB">
+<!ENTITY aspell-buildsize "9.8 MB">
+<!ENTITY aspell-time "0.97 SBU">
+]>
 <sect1 id="aspell" xreflabel="aspell-&aspell-version;">
 <?dbhtml filename="aspell.html"?>
 <title>aspell-&aspell-version;</title>
+&aspell-intro;
+&aspell-inst;
+&aspell-config;
+&aspell-desc;
+<sect2>
+<title>Introduction to <application>aspell</application></title>
+<para>The <application>aspell</application> package contains the aspell
+library, used to interface to spell checking libraries.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&aspell-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&aspell-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &aspell-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&aspell-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&aspell-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>aspell</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="which"/>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>aspell</application></title>
+<para>Install <application>aspell</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Configuring <application>aspell</application></title>
+<sect3><title>Configuration Information</title>
+<para>After <application>Aspell</application> is installed, at least one
+dictionary needs to be set up. You can find them at <ulink url="http://aspell.net/"/>.</para>
+<para>Install your dictionary or dictionaries by running the following commands:</para>
+<screen><userinput><command>./configure &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>aspell</application> package contains the <filename>libaspell</filename>
+libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>aspell library</title>
+<para>The <filename>libaspell</filename> library is a spell checking library interface.</para></sect3>
+</sect2>
 </sect1>

general/genlib/expat.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY expat-download-http "http://prdownloads.sourceforge.net/expat/expat-&expat-version;.tar.gz">
+<!ENTITY expat-download-ftp " ">
+<!ENTITY expat-size "290 KB">
+<!ENTITY expat-buildsize "3.2 MB">
+<!ENTITY expat-time "0.11 SBU">
+]>
 <sect1 id="expat" xreflabel="expat-&expat-version;">
 <?dbhtml filename="expat.html"?>
 <title>expat-&expat-version;</title>
+&expat-intro;
+&expat-inst;
+&expat-desc;
+<sect2>
+<title>Introduction to expat</title>
+<para>The expat package contains a stream oriented C library for
+parsing XML.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&expat-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&expat-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &expat-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &expat-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &expat-time;</para></listitem></itemizedlist></sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>expat</application></title>
+<para>Install <application>expat</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>expat</application> package contains the <filename>libexpat</filename> libraries and
+<command>xmlwf</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>xmlwf</title>
+<para><command>xmlwf</command> is a non-validating utility to check whether or
+not XML documents are well formed.</para></sect3>
+</sect2>
 </sect1>

general/genlib/fam.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY fam-download-http " ">
+<!ENTITY fam-download-ftp "ftp://oss.sgi.com/projects/fam/download/stable/fam-&fam-version;.tar.gz">
+<!ENTITY fam-size "320 KB">
+<!ENTITY fam-buildsize "6.9 MB">
+<!ENTITY fam-time "0.68 SBU">
+]>
 <sect1 id="fam" xreflabel="FAM-&fam-version;">
 <?dbhtml filename="fam.html"?>
 <title>FAM-&fam-version;</title>
+&fam-intro;
+&fam-inst;
+&fam-exp;
+&fam-config;
+&fam-desc;
+<sect2>
+<title>Introduction to <application><acronym>FAM</acronym></application></title>
+<para>The <application><acronym>FAM</acronym></application> package contains a
+File Alteration Monitor which is useful for notifying applications of
+changes to the file system.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&fam-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&fam-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &fam-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&fam-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&fam-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Dnotify patch (Recommended): <ulink
+url="&patch-root;/fam-&fam-version;-dnotify-1.patch"/></para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application><acronym>FAM</acronym></application> dependencies
+</title>
+<sect4><title>Required</title>
+<para><xref linkend="portmap"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>FAM</acronym></application></title>
+<para>Install <application><acronym>FAM</acronym></application> by running the
+following commands:</para>
+<screen><userinput><command>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch &amp;&amp;
+autoreconf -f -i &amp;&amp;
+./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><command>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch</command>: This patch enables
+<application><acronym>FAM</acronym></application> to use the Linux kernel
+dnotify mechanism to inform the calling process of
+file modifications, rather than polling the file system for
+modifications.</para>
+<para><command>autoreconf -f -i</command>
+This command is necessary since the dnotify patch affects the
+<filename>configure.ac</filename> and <filename>Makefile.am</filename>.</para>
+</sect2>
+<sect2>
+<title>Configuring <application><acronym>FAM</acronym></application></title>
+<sect3><title>Config files</title>
+<para><filename>/etc/rpc</filename>,
+ <filename>/etc/fam.conf</filename>,
+ <filename>/etc/inetd.conf</filename>,
+ <filename>/etc/xinetd.d/fam</filename>
+ or <filename>/etc/xinetd.conf</filename>
+ </para>
+</sect3>
+<sect3><title>Configuration Information</title>
+<para>Configuring the file alteration monitor.</para>
+<para>If you use <application>inetd</application>, add the
+<application><acronym>FAM</acronym></application> entry to
+<filename>/etc/inetd.conf</filename> with the
+following command: </para>
+<screen><userinput><command>echo "sgi_fam/1-2 stream  rpc/tcp wait root /usr/sbin/famd fam" &gt;&gt; /etc/inetd.conf</command></userinput></screen>
+<para>If you use <application>xinetd</application>, add an entry to
+<filename>/etc/xinetd.conf</filename> with the following command (be
+sure the "nogroup" group exists):</para>
+<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
+    # description: FAM - file alteration monitor
+    service sgi_fam
+    {
+        type            = RPC UNLISTED
+        socket_type     = stream
+        user            = root
+        group           = nogroup
+        server          = /usr/sbin/famd
+        wait            = yes
+        protocol        = tcp
+        rpc_version     = 2
+        rpc_number      = 391002
+    }
+<command>EOF</command></userinput></screen>
+<para>If you do not have any inetd daemon installed and have no
+wish to install one, you can also start fam during system startup
+by installing <filename>/etc/rc.d/init.d/fam</filename>
+init script included in the
+<xref linkend="intro-important-bootscripts"/> package.</para>
+<screen><userinput><command>make install-fam</command></userinput></screen>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application><acronym>FAM</acronym></application> package contains
+the <command>famd</command> executable and <filename>libfam</filename>
+libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>famd</title>
+<para><command>famd</command> is the file alteration monitor.</para>
+</sect3>
+</sect2>
 </sect1>

general/genlib/gdbm.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY gdbm-download-http "http://ftp.gnu.org/gnu/gdbm/gdbm-&gdbm-version;.tar.gz">
+<!ENTITY gdbm-download-ftp "ftp://ftp.gnu.org/gnu/gdbm/gdbm-&gdbm-version;.tar.gz">
+<!ENTITY gdbm-size "223 KB">
+<!ENTITY gdbm-buildsize "4.1 MB">
+<!ENTITY gdbm-time "0.08 SBU">
+]>
 <sect1 id="gdbm" xreflabel="GDBM-&gdbm-version;">
 <?dbhtml filename="gdbm.html"?>
 <title>GDBM-&gdbm-version;</title>
+&gdbm-intro;
+&gdbm-inst;
+&gdbm-exp;
+&gdbm-desc;
+<sect2>
+<title>Introduction to <application><acronym>GDBM</acronym></application></title>
+<para>The <application><acronym>GDBM</acronym></application> package
+contains the <acronym>GNU</acronym> Database Manager. This
+is a disk file format database which stores key/data-pairs in single
+files. The actual data of any record being stored is indexed by a unique
+key, which can be retrieved in less time than if it was stored in a text
+file.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&gdbm-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&gdbm-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &gdbm-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&gdbm-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&gdbm-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>GDBM</acronym></application></title>
+<para>Install <application><acronym>GDBM</acronym></application> by running the following commands:
+</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make BINOWN=root BINGRP=root install</command></userinput></screen>
+<para>In addition, you may need to install the <application>DBM</application>
+and <application>NDBM</application> compatibility headers since some
+applications look for these older dbm routines.</para>
+<screen><userinput><command>make BINOWN=root BINGRP=root install-compat</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><parameter>BINOWN=root BINGRP=root</parameter>: This command
+changes the file ownership to root instead of the bin user.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application><acronym>GDBM</acronym></application> package
+contains <filename class="libraryfile">libgdbm</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>gdbm libraries</title>
+<para><filename class="libraryfile">libgdbm</filename> libraries contain functions that perform
+database routines using extendible hashing.</para></sect3>
+</sect2>
 </sect1>

general/genlib/genlib.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+ <!ENTITY % general-entities SYSTEM "../../general.ent">
+ %general-entities;
+]>
 <chapter id="general-genlib">
 <?dbhtml filename="genlib.html"?>
 …
 explain why you may want to install them.</para>
+&openssl;
+&pcre;
+&popt;
+&slang;
+&fam;
+&libxml;
+&libxml2;
+&libxslt;
+&readline;
+&gmp;
+&gdbm;
+&GLib;
+&GLib2;
+&expat;
+&libesmtp;
+&aspell;
+&ispell;
+&guile;
+&slib;
+&gwrap;
+&LZO;
+&libpcap;
+&libusb;
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="openssl.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pcre.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="popt.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="slang.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fam.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxml.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxml2.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxslt.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="readline.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gmp.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gdbm.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="glib.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="glib2.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="expat.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libesmtp.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="aspell.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ispell.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="guile.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="slib.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gwrap.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lzo.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libpcap.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libusb.xml"/>
 </chapter>

general/genlib/glib.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY GLib-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v1.2/glib-&GLib-version;.tar.gz">
+<!ENTITY GLib-download-ftp "ftp://ftp.gtk.org/pub/gtk/v1.2/glib-&GLib-version;.tar.gz">
+<!ENTITY GLib-size "412 KB">
+<!ENTITY GLib-buildsize "7 MB">
+<!ENTITY GLib-time "0.26 SBU">
+]>
 <sect1 id="GLib" xreflabel="GLib-&GLib-version;">
 <?dbhtml filename="glib.html"?>
 <title>GLib-&GLib-version;</title>
+&GLib-intro;
+&GLib-inst;
+&GLib-desc;
+<sect2>
+<title>Introduction to <application>GLib</application></title>
+<para>The <application>glib</application> package contains a low-level core
+library. This is useful for providing data structure handling for C,
+portability wrappers and interfaces for such runtime functionality as an event
+loop, threads, dynamic loading, and an object system.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&GLib-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&GLib-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &GLib-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &GLib-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &GLib-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>GLib</application></title>
+<para>Install <application>glib</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>glib</application> package contains <filename>libglib-1.2</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>GLib libraries</title>
+<para><application>GLib</application> libraries contain a low-level core
+library for the <application><acronym>GIMP</acronym></application> Toolkit.</para></sect3>
+</sect2>
 </sect1>

general/genlib/glib2.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY GLib2-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v2.4/glib-&GLib2-version;.tar.bz2">
+<!ENTITY GLib2-download-ftp "ftp://ftp.gtk.org/pub/gtk/v2.4/glib-&GLib2-version;.tar.bz2">
+<!ENTITY GLib2-size "2.0 MB">
+<!ENTITY GLib2-buildsize "30 MB">
+<!ENTITY GLib2-time "0.49 SBU">
+]>
 <sect1 id="GLib2" xreflabel="GLib-&GLib2-version;">
 <?dbhtml filename="glib2.html"?>
 <title>GLib-&GLib2-version;</title>
+&GLib2-intro;
+&GLib2-inst;
+<!-- &GLib2-exp; -->
+&GLib2-desc;
+<sect2>
+<title>Introduction to <application>GLib</application></title>
+<para>The <application>glib</application> package contains a low-level core
+library. This is useful for providing data structure handling for C,
+portability wrappers and interfaces for such runtime functionality as an
+event loop, threads, dynamic loading, and an object system.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&GLib2-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&GLib2-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &GLib2-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&GLib2-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&GLib2-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>GLib</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="pkgconfig"/></para></sect4>
+<sect4><title>Optional</title>
+<para><xref linkend="gtk-doc"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>GLib</application></title>
+<para>Install <application>glib</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><option>--enable-gtk-doc</option>: This switch will rebuild
+the <acronym>API</acronym> documentation during the
+<command>make</command> command.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>glib</application> package contains
+<filename class="libraryfile">libglib-2.0</filename>,
+<filename class="libraryfile">libgobject-2.0</filename>,
+<filename class="libraryfile">libgmodule-2.0</filename> and
+<filename class="libraryfile">libgthread-2.0</filename>
+libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>GLib libraries</title>
+<para>GLib libraries contain a low-level core library for the
+<application><acronym>GIMP</acronym></application> Toolkit.</para></sect3>
+</sect2>
 </sect1>

general/genlib/gmp.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY gmp-download-http " ">
+<!ENTITY gmp-download-ftp "ftp://ftp.gnu.org/gnu/gmp/gmp-&gmp-version;.tar.gz">
+<!ENTITY gmp-size "1.7 MB">
+<!ENTITY gmp-buildsize "29 MB">
+<!ENTITY gmp-time "0.74 SBU">
+]>
 <sect1 id="gmp" xreflabel="GMP-&gmp-version;">
 <?dbhtml filename="gmp.html"?>
 <title>GMP-&gmp-version;</title>
+&gmp-intro;
+&gmp-inst;
+&gmp-desc;
+<sect2>
+<title>Introduction to <application><acronym>GMP</acronym></application></title>
+<para>The <application><acronym>GMP</acronym></application> package
+contains a math library. This has useful functions for arbitrary precision
+arithmetic.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&gmp-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&gmp-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &gmp-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&gmp-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&gmp-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application><acronym>GMP</acronym></application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="readline"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>GMP</acronym></application></title>
+<para>Install <application><acronym>GMP</acronym></application> by running the following commands:
+</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application><acronym>GMP</acronym></application> package contains <filename>libgmp
+</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>gmp libraries</title>
+<para><filename>libgmp</filename> libraries contain the functions to operate
+on signed integers, rational numbers, and floating point numbers.</para></sect3>
+</sect2>
 </sect1>

general/genlib/guile.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY guile-download-http "http://ftp.gnu.org/pub/gnu/guile/guile-&guile-version;.tar.gz">
+<!ENTITY guile-download-ftp "ftp://ftp.gnu.org/pub/gnu/guile/guile-&guile-version;.tar.gz">
+<!ENTITY guile-size "2.7 MB">
+<!ENTITY guile-buildsize "30 MB">
+<!ENTITY guile-time "0.79 SBU">
+]>
 <sect1 id="guile" xreflabel="Guile-&guile-version;">
 <?dbhtml filename="guile.html"?>
 <title>Guile-&guile-version;</title>
+&guile-intro;
+&guile-inst;
+&guile-desc;
+<sect2>
+<title>Introduction to <application>Guile</application></title>
+<para>The <application>Guile</application> package contains the Project
+<acronym>GNU</acronym>'s extension language library.  <application>Guile
+</application> also contains a stand alone <application>Scheme</application>
+interpreter.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&guile-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&guile-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &guile-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&guile-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&guile-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>Guile</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="readline"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Guile</application></title>
+<para>Install <application>Guile</application> by running the following
+commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>In addition to the <filename>libguile</filename> libraries, the
+<application>Guile</application> package contains
+<command>guile</command>,
+<command>guile-config</command> and
+<command>guile-snarf</command>.
+</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>guile</title>
+<para><command>guile</command> is a stand-alone Scheme interpreter for
+<application>Guile</application>.</para></sect3>
+<sect3><title>guile-config</title>
+<para><command>guile-config</command> is a <application>Guile</application>
+script which provides the information necessary to link your programs against
+the <application>Guile</application> library, in much the same way <xref
+linkend="pkgconfig"></xref> does.</para></sect3>
+<sect3><title>guile-snarf</title>
+<para><command>guile-snarf</command> is a script to parse declarations in
+your <application>C</application> code for <application>Scheme</application>
+visible <application>C</application> functions, <application>Scheme
+</application> objects to be used by <application>C</application> code,
+etc.</para></sect3>
+</sect2>
 </sect1>

general/genlib/gwrap.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY gwrap-download-http "http://www.gnucash.org/pub/g-wrap/source/g-wrap-&gwrap-version;.tar.gz">
+<!ENTITY gwrap-download-ftp " ">
+<!ENTITY gwrap-size "400 KB">
+<!ENTITY gwrap-buildsize "4.6 MB">
+<!ENTITY gwrap-time "0.09 SBU">
+]>
 <sect1 id="gwrap" xreflabel="gwrap-&gwrap-version;">
 <?dbhtml filename="gwrap.html"?>
 <title>G-Wrap-&gwrap-version;</title>
+&gwrap-intro;
+&gwrap-inst;
+&gwrap-desc;
+<sect2>
+<title>Introduction to <application>G-Wrap</application></title>
+<para>The <application>G-Wrap</application> package contains tools for
+exporting <application>C</application> libraries into <application>Scheme
+</application> interpreters.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&gwrap-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&gwrap-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &gwrap-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&gwrap-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&gwrap-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>G-wrap</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="guile"/> and <xref linkend="slib"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>G-Wrap</application></title>
+<para>Install <application>G-Wrap</application> by running the following
+commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>In addition to the <application>Scheme</application> libraries, the
+<application>G-Wrap</application> package contains
+<command>g-wrap-config</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>g-wrap-config</title>
+<para><command>g-wrap-config</command> is a tool to generate <envar>CFLAGS
+</envar> for linking <application>C</application> code to the
+<application>Scheme</application> runtime libraries.</para></sect3>
+</sect2>
 </sect1>

general/genlib/ispell.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY ispell-download-http "http://membled.com/work/patches/ispell/ispell-&ispell-version;.tar.bz2">
+<!ENTITY ispell-download-ftp " ">
+<!ENTITY ispell-size "1.2 MB">
+<!ENTITY ispell-buildsize "11 MB">
+<!ENTITY ispell-time "0.03 SBU">
+]>
 <sect1 id="ispell" xreflabel="ispell-&ispell-version;">
 <?dbhtml filename="ispell.html"?>
 <title>ispell-&ispell-version;</title>
+&ispell-intro;
+&ispell-inst;
+&ispell-desc;
+<sect2>
+<title>Introduction to <application>ispell</application></title>
+<para>The <application>ispell</application> package contains a spell
+checker that can handle international languages.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&ispell-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&ispell-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &ispell-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&ispell-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&ispell-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>ispell</application></title>
+<para>The first step is to create <filename>local.h</filename>.</para>
+<screen><userinput><command>sed -e "s:/usr/local:/usr:g" local.h.linux > local.h</command></userinput></screen>
+<para>By default, <application>ispell</application> only installs an American
+English dictionary. To set up other languages, check out the <filename>config.X</filename> file
+for the #define entry to append to <filename>local.h</filename>.</para>
+<para>Compile and install <application>ispell</application> using the
+following commands:</para>
+<screen><userinput><command>make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>ispell</application> package contains the
+<command>ispell</command> program used for spell checking.</para>
+</sect2>
 </sect1>

general/genlib/libesmtp.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+  <!ENTITY libesmtp-download-http "http://www.stafford.uklinux.net/libesmtp/libesmtp-&libesmtp-version;.tar.bz2">
+  <!ENTITY libesmtp-download-ftp  " ">
+  <!ENTITY libesmtp-size          "263 KB">
+  <!ENTITY libesmtp-buildsize     "5.4 MB">
+  <!ENTITY libesmtp-time          "0.16 SBU">
+]>
 <sect1 id="libesmtp" xreflabel="libesmtp-&libesmtp-version;">
 <?dbhtml filename="libesmtp.html"?>
 <title>libesmtp-&libesmtp-version;</title>
+&libesmtp-intro;
+&libesmtp-inst;
+&libesmtp-desc;
+<sect2>
+<title>Introduction to <application>libesmtp</application></title>
+<para>The <application>libesmtp</application> package contains the libesmtp
+libraries which are used by some programs to manage email submission to a
+mail transport layer.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&libesmtp-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libesmtp-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libesmtp-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&libesmtp-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&libesmtp-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3>
+<title><application>libesmtp</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="openssl"/></para>
+</sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>libesmtp</application></title>
+<para>Install <application>libesmtp</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>libesmtp</application> package contains the <filename>libesmtp</filename>
+library.</para>
+</sect2>
+<sect2>
+<title>Description</title>
+<sect3>
+<title>libesmtp library</title>
+<para>The <filename>libesmtp</filename> library is used to manage submission of
+electronic mail to a Mail Transport Agent.</para>
+</sect3>
+</sect2>
 </sect1>

general/genlib/libpcap.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libpcap-download-http "http://www.tcpdump.org/release/libpcap-&libpcap-version;.tar.gz">
+<!ENTITY libpcap-download-ftp " ">
+<!ENTITY libpcap-size "299 KB">
+<!ENTITY libpcap-buildsize "1.9 MB">
+<!ENTITY libpcap-time "0.05 SBU">
+]>
 <sect1 id="libpcap" xreflabel="libpcap-&libpcap-version;">
 <?dbhtml filename="libpcap.html"?>
 <title><acronym>libpcap</acronym>-&libpcap-version;</title>
+&libpcap-intro;
+&libpcap-inst;
+&libpcap-desc;
+<sect2>
+<title>Introduction to <application><acronym>libpcap</acronym></application></title>
+<para><application><acronym>libpcap</acronym></application> provides
+functions for user-level packet capture, used in low-level network
+monitoring.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libpcap-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libpcap-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libpcap-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libpcap-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libpcap-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>libpcap</acronym></application></title>
+<para>Install <application><acronym>libpcap</acronym></application> by running the
+following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para><application><acronym>libpcap</acronym></application> package provides
+the <filename class="libraryfile">libpcap</filename> library.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>libpcap</title>
+<para><filename class="libraryfile">libpcap</filename>
+is a library for user-level packet capture.</para></sect3>
+</sect2>
 </sect1>

general/genlib/libusb.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libusb-download-http "http://prdownloads.sourceforge.net/libusb/libusb-&libusb-version;.tar.gz">
+<!ENTITY libusb-download-ftp " ">
+<!ENTITY libusb-size "314 KB">
+<!ENTITY libusb-buildsize "2.1 MB">
+<!ENTITY libusb-time "0.03 SBU">
+]>
 <sect1 id="libusb" xreflabel="libusb-&libusb-version;">
 <?dbhtml filename="libusb.html"?>
 <title>libusb-&libusb-version;</title>
+&libusb-intro;
+&libusb-inst;
+&libusb-exp;
+&libusb-config;
+&libusb-desc;
+<sect2>
+<title>Introduction to <application>libusb</application></title>
+<para>The <application>libusb</application> package contains a library
+used by some applications for <acronym>USB</acronym> device access.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libusb-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libusb-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libusb-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libusb-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libusb-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>libusb</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="openjade"/> and <xref linkend="sgml-dtd-3"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>libusb</application></title>
+<para>Install <application>libusb</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr --disable-build-docs &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><parameter>--disable-build-docs</parameter>: This switch turns off
+the default enabled building of documentation since it requires
+<application>OpenJade</application>.</para>
+</sect2>
+<sect2>
+<title>Configuring <application>libusb</application></title>
+<!-- To be reviewed when hotplug enters the LFS book -->
+<para>libusb requires the usbfs kernel filesystem to be mounted on
+<filename class="directory">/proc/bus/usb</filename>. Applications
+require the files in this directory to be accessible to the user,
+sometimes for both reading and writing.</para>
+<para>To restrict access to <acronym>USB</acronym> devices, create the
+usb group:</para>
+<screen><userinput><command>groupadd -g 15 usb</command></userinput></screen>
+<para>To get usbfs mounted on boot, we will create a special init script,
+because just putting an extra line into
+<filename>/etc/fstab</filename> does not work for those who compiled
+"USB device filesystem" as a kernel module.
+Install <filename>/etc/rc.d/init.d/usb</filename>
+init script included in the
+<xref linkend="intro-important-bootscripts"/> package.</para>
+<screen><userinput><command>make install-usb</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>libusb</application> package contains
+<filename class="libraryfile">libusb</filename> libraries,
+the <filename>/usr/include/usb.h</filename> header,
+and a <command>usb-config</command> script.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>libusb libraries</title>
+<para><filename class="libraryfile">libusb</filename> libraries contain C functions for
+accessing <acronym>USB</acronym> hardware.</para></sect3>
+<sect3><title>usb-config</title>
+<para>The <command>usb-config</command> script provides the right
+compiler and linker flags for programs using
+this library.</para></sect3>
+</sect2>
 </sect1>

general/genlib/libxml.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libxml-download-http "http://ftp.gnome.org/pub/GNOME/sources/libxml/1.8/libxml-&libxml-version;.tar.bz2">
+<!ENTITY libxml-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/libxml/1.8/libxml-&libxml-version;.tar.bz2">
+<!ENTITY libxml-size "973 KB">
+<!ENTITY libxml-buildsize "11 MB">
+<!ENTITY libxml-time "0.41 SBU">
+]>
 <sect1 id="libxml" xreflabel="libxml-&libxml-version;">
 <?dbhtml filename="libxml.html"?>
 <title>libxml-&libxml-version;</title>
+&libxml-intro;
+&libxml-inst;
+&libxml-desc;
+<sect2>
+<title>Introduction to <application>libxml</application></title>
+<para>The <application>libxml</application> package contains the libxml
+libraries. These are useful for parsing <acronym>XML</acronym> files.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&libxml-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libxml-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libxml-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&libxml-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&libxml-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>libxml</application></title>
+<para>Install <application>libxml</application> by running the following
+commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>libxml</application> package contains
+<filename>libxml</filename> libraries, <command>xmllint</command> and
+<command>xmlcatalog</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>libxml libraries</title>
+<para><filename>libxml</filename> libraries provide the functions for programs
+to parse files that use the <acronym>XML</acronym> format.</para></sect3>
+</sect2>
 </sect1>

general/genlib/libxml2.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libxml2-download-http "http://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/libxml2-&libxml2-version;.tar.bz2">
+<!ENTITY libxml2-download-ftp "ftp://xmlsoft.org/libxml2-&libxml2-version;.tar.gz">
+<!ENTITY libxml2-size "2.6 MB">
+<!ENTITY libxml2-buildsize "56 MB">
+<!ENTITY libxml2-time "1.10 SBU">
+]>
 <sect1 id="libxml2" xreflabel="libxml2-&libxml2-version;">
 <?dbhtml filename="libxml2.html"?>
 <title>libxml2-&libxml2-version;</title>
+&libxml2-intro;
+&libxml2-inst;
+&libxml2-exp;
+&libxml2-desc;
+<sect2>
+<title>Introduction to <application>libxml2</application></title>
+<para>The <application>libxml2</application> package contains
+<acronym>XML</acronym> libraries. These are useful for parsing
+<acronym>XML</acronym> files.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&libxml2-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libxml2-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libxml2-size;</para></listitem>
+<listitem><para>Estimated Disk space
+required: &libxml2-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&libxml2-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>libxml2</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="Python"/> and <xref linkend="readline"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>libxml2</application></title>
+<para>Install <application>libxml2</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><option>--with-history</option>: Enables readline support.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>libxml2</application> package contains <filename
+class='libraryfile'>libxml2</filename> libraries, <command>xmllint</command>,
+<command>xmlcatalog</command> and <command>xml2-config</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>libxml2 libraries</title>
+<para><filename class='libraryfile'>libxml2</filename> libraries provide
+the functions for programs to parse files that use the <acronym>XML</acronym>
+format.</para></sect3>
+<sect3><title>xmllint</title>
+<para><command>xmllint</command> parses XML files and outputs reports (based
+upon options) to detect errors in <acronym>XML</acronym> coding.</para></sect3>
+<sect3><title>xmlcatalog</title>
+<para><command>xmlcatalog</command> allows users to monitor and manipulate
+<acronym>XML</acronym> and <acronym>SGML</acronym> catalogs.</para></sect3>
+</sect2>
 </sect1>

general/genlib/libxslt.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libxslt-download-http "http://ftp.gnome.org/pub/GNOME/sources/libxslt/1.1/libxslt-&libxslt-version;.tar.bz2">
+<!ENTITY libxslt-download-ftp "ftp://xmlsoft.org/libxslt-&libxslt-version;.tar.gz">
+<!ENTITY libxslt-size "1.7 MB">
+<!ENTITY libxslt-buildsize "34 MB">
+<!ENTITY libxslt-time "0.40 SBU">
+]>
 <sect1 id="libxslt" xreflabel="libxslt-&libxslt-version;">
 <?dbhtml filename="libxslt.html"?>
 <title>libxslt-&libxslt-version;</title>
+&libxslt-intro;
+&libxslt-inst;
+&libxslt-desc;
+<sect2>
+<title>Introduction to <application>libxslt</application></title>
+<para>The <application>libxslt</application> package contains
+<acronym>XSLT</acronym> libraries. These are useful
+for extending <filename>libxml2</filename> libraries to support
+<acronym>XSLT</acronym> files.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&libxslt-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libxslt-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libxslt-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&libxslt-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&libxslt-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>libxslt</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="libxml2"/></para></sect4>
+<sect4><title>Optional</title>
+<para><xref linkend="Python"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>libxslt</application></title>
+<para>Install <application>libxslt</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>libxslt</application> package contains <filename>
+libxslt</filename> libraries, <filename>libexslt</filename> libraries,
+<command>xsltproc</command> and <command>xslt-config</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>libxslt libraries</title>
+<para><filename>libxslt</filename> libraries provide extensions to the
+<filename>libxml2</filename> libraries to parse files that use the
+<acronym>XSLT</acronym> format.</para></sect3>
+<sect3><title>xsltproc</title>
+<para><command>xsltproc</command> is used to apply
+<acronym>XSLT</acronym> stylesheets to <acronym>XML</acronym>
+documents.</para></sect3>
+</sect2>
 </sect1>

general/genlib/lzo.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY LZO-download-http "http://www.oberhumer.com/opensource/lzo/download/lzo-&LZO-version;.tar.gz">
+<!ENTITY LZO-download-ftp "http://ftp.uni-koeln.de/util/arc/lzo-&LZO-version;.tar.gz">
+<!ENTITY LZO-size "421 KB">
+<!ENTITY LZO-buildsize "5.4 MB">
+<!ENTITY LZO-time "0.22 SBU">
+]>
 <sect1 id="LZO" xreflabel="LZO-&LZO-version;">
 <?dbhtml filename="LZO.html"?>
 <title><acronym>LZO</acronym>-&LZO-version;</title>
+&LZO-intro;
+&LZO-inst;
+&LZO-desc;
+<sect2>
+<title>Introduction to <application><acronym>LZO</acronym></application></title>
+<para><application><acronym>LZO</acronym></application> is a data compression
+library which is suitable for data decompression and compression in real-time.
+This means it favors speed over compression ratio.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&LZO-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&LZO-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &LZO-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &LZO-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &LZO-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>LZO</acronym></application></title>
+<para>Install <application><acronym>LZO</acronym></application> by running the
+following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr --enable-shared &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para><application><acronym>LZO</acronym></application> package provides
+<filename class="libraryfile">liblzo</filename> library.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>liblzo</title>
+<para><filename class="libraryfile">liblzo</filename>
+is a data compression and decompression library.</para></sect3>
+</sect2>
 </sect1>

general/genlib/openssl.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY openssl-download-http "http://www.openssl.org/source/openssl-&openssl-version;.tar.gz">
+<!ENTITY openssl-download-ftp "ftp://ftp.openssl.org/source/openssl-&openssl-version;.tar.gz">
+<!ENTITY openssl-size "2.7 MB">
+<!ENTITY openssl-buildsize "25 MB">
+<!ENTITY openssl-time "1.16 SBU">
+]>
 <sect1 id="openssl" xreflabel="OpenSSL-&openssl-version;">
 <?dbhtml filename="openssl.html"?>
 <title>OpenSSL-&openssl-version;</title>
+&openssl-intro;
+&openssl-inst;
+&openssl-exp;
+&openssl-config;
+&openssl-desc;
+<sect2>
+<title>Introduction to <application>OpenSSL</application></title>
+<para>The <application>OpenSSL</application> package contains management tools
+and libraries relating to cryptography.  These are useful for providing
+cryptography functions to other packages, notably <application>OpenSSH
+</application> and web browsers (for accessing secure https sites).</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&openssl-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&openssl-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &openssl-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &openssl-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &openssl-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>OpenSSL</application></title>
+<para>Install <application>OpenSSL</application> by running the following commands:</para>
+<screen><userinput><command>sed 's/^passwd/openssl-passwd/' doc/apps/passwd.pod \
+    > doc/apps/openssl-passwd.pod &amp;&amp;
+rm doc/apps/passwd.pod &amp;&amp;
+mv doc/crypto/{,openssl_}threads.pod &amp;&amp;
+sed -i -e 's/-m486/-march=i486/' Configure &amp;&amp;
+./config --openssldir=/etc/ssl --prefix=/usr shared &amp;&amp;
+make MANDIR=/usr/share/man &amp;&amp;
+make MANDIR=/usr/share/man install &amp;&amp;
+cp -r certs /etc/ssl &amp;&amp;
+rmdir /etc/ssl/lib</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><option>no-rc5 no-idea</option>: When added to the
+<command>./config</command> command, this will eliminate the building of those
+encryption methods. Patent licenses may be needed for you to utilize either of
+those methods in your projects.</para>
+<para><command>rm doc/apps/passwd.pod</command>: This command prevents
+<application>Open<acronym>SSL</acronym></application> from installing its
+passwd man page over an existing man page with the same name.</para>
+<para><command>mv doc/crypto/{,openssl_}threads.pod</command>: This
+commands prevents <application>Open<acronym>SSL</acronym></application> from
+overwriting an existing man page from <application>Perl</application>.</para>
+<para><command>sed -i -e 's/-m486/-march=i486/' Configure</command>:
+<application>GCC</application> issues a warning on every
+compilation because the <command>Configure</command>
+command uses deprecated <parameter>-m486</parameter> instead of
+<parameter>-march=i486</parameter>.</para>
+<para><screen><command>make MANDIR=/usr/share/man
+make MANDIR=/usr/share/man install</command></screen> These
+commands install <application>OpenSSL</application> with the man pages
+in <filename class='directory'>/usr/share/man</filename> instead of the
+default which is <filename class='directory'>/etc/ssl/man</filename>.</para>
+<para><command>cp -r certs /etc/ssl</command>: The certificates
+must be copied manually since the install script
+skips this step.</para>
+<para><command>rmdir /etc/ssl/lib</command>: This is simply a tidy-up command.
+For some reason, the <application>openssl</application> install routine creates
+the <filename class='directory'>/etc/ssl/lib</filename> directory even though
+the libraries have been installed in
+<filename class='directory'>/usr/lib</filename>.  We remove it to keep things
+nice and tidy!</para>
+</sect2>
+<sect2>
+<title>Configuring <application>OpenSSL</application></title>
+<sect3><title>Config files</title>
+<para><filename>/etc/ssl/openssl.cnf</filename></para>
+</sect3>
+<sect3><title>Configuration Information</title>
+<para>Most people who just want to use
+<application>openssl</application> for providing functions
+to other programs such as <application>OpenSSH</application> and web browsers won't need to worry
+about configuring <application>OpenSSL</application>.  Configuring
+<application>OpenSSL</application> is an advanced topic and
+so those who do would normally be expected to either know how to do it
+or to be able to find out how to do it.</para>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>Open<acronym>SSL</acronym></application> package contains <command>
+c_rehash</command>, <command>openssl</command>, <filename
+class='libraryfile'>libcrypto</filename> libraries and <filename
+class='libraryfile'>libssl</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>c_rehash</title>
+<para><command>c_rehash</command> is a <application>Perl</application> script
+that scans all files in a directory and adds symbolic links to their hash
+values.</para>
+</sect3>
+<sect3><title>openssl</title>
+<para>The <command>openssl</command> program is a command-line tool for using
+the various cryptography functions of
+<application>Open<acronym>SSL</acronym></application>'s
+crypto library from the shell. It can be used for various functions which are
+documented in <command>man 1 openssl</command>.</para>
+</sect3>
+<sect3><title>libcrypto</title>
+<para>The <application>Open<acronym>SSL</acronym></application> crypto library implements a wide
+range of cryptographic  algorithms used in various Internet standards. The
+services provided by  this library are used by the
+<application>Open<acronym>SSL</acronym>
+</application> implementations of <acronym>SSL</acronym>, <acronym>TLS
+</acronym> and <acronym>S/MIME</acronym>, and they have also been used to
+implement <application>Open<acronym>SSH</acronym></application>,
+<application>Open<acronym>PGP</acronym>
+</application>, and other cryptographic standards.</para>
+</sect3>
+<sect3><title>libssl</title>
+<para>The <application>Open<acronym>SSL</acronym></application> <acronym>SSL</acronym> library
+implements the Secure Sockets Layer (<acronym>SSL</acronym> v2/v3) and
+Transport Layer Security (<acronym>TLS</acronym> v1) protocols. It provides a
+rich <acronym>API</acronym>, documentation on which can be found by running
+<command>man 3 ssl</command>.</para>
+</sect3>
+</sect2>
 </sect1>

general/genlib/pcre.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY pcre-download-http " ">
+<!ENTITY pcre-download-ftp "ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-&pcre-version;.tar.bz2">
+<!ENTITY pcre-size "344 KB">
+<!ENTITY pcre-buildsize "3.5 MB">
+<!ENTITY pcre-time "0.08 SBU">
+]>
 <sect1 id="pcre" xreflabel="PCRE-&pcre-version;">
 <?dbhtml filename="pcre.html"?>
 <title>PCRE-&pcre-version;</title>
+&pcre-intro;
+&pcre-inst;
+&pcre-exp;
+&pcre-desc;
+<sect2>
+<title>Introduction to <application><acronym>PCRE</acronym></application></title>
+<para>The <application><acronym>PCRE</acronym></application> package contains
+<application>Perl</application> Compatible Regular Expression
+libraries. These are useful for implementing regular expression pattern
+matching using the same syntax and semantics as
+<application>Perl</application> 5.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&pcre-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&pcre-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &pcre-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&pcre-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&pcre-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>PCRE</acronym></application></title>
+<para>Install <application><acronym>PCRE</acronym></application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr --enable-utf8 &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+<para>If you reinstall <application>grep</application> after installing <application>pcre</application>,
+<application>grep</application> will get linked against <application>pcre</application> and
+may cause problems if <filename>/usr</filename> is a separate mount point. To avoid this,
+either pass the option <emphasis>--disable-perl-regexp</emphasis> when executing <command>./configure</command>
+for <application>grep</application> or move <filename>libpcre</filename> to <filename>/lib</filename>
+as follows.</para>
+<screen><userinput><command>mv /usr/lib/libpcre.so.* /lib/ &amp;&amp;
+ln -sf ../../lib/libpcre.so.0 /usr/lib/libpcre.so</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><parameter>--enable-utf8</parameter>: This switch includes the
+code for handling <acronym>UTF</acronym>-8 character strings in the
+library.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application><acronym>PCRE</acronym></application> package contains
+the <filename class='libraryfile'>libpcre</filename> libraries,
+<command>pcregrep</command>, <command>pcretest</command> and
+<command>pcre-config</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>pcregrep</title>
+<para><command>pcregrep</command> is a <command>grep</command> that understands
+<application>Perl</application> compatible regular expressions.</para></sect3>
+<sect3><title>pcretest</title>
+<para><command>pcretest</command> can test your
+<application>Perl</application> compatible regular expression.</para></sect3>
+<sect3><title>pcre-config</title>
+<para><command>pcre-config</command> is used during the compile process of
+programs linking to this library.</para></sect3>
+</sect2>
 </sect1>

general/genlib/popt.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY popt-download-http "http://gd.tuwien.ac.at/utils/rpm.org/dist/rpm-4.1.x/popt-&popt-version;.tar.gz">
+<!ENTITY popt-download-ftp "ftp://ftp.rpm.org/pub/rpm/dist/rpm-4.1.x/popt-&popt-version;.tar.gz">
+<!ENTITY popt-size "564 KB">
+<!ENTITY popt-buildsize "17.4 MB">
+<!ENTITY popt-time "0.06 SBU">
+]>
 <sect1 id="popt" xreflabel="popt-&popt-version;">
 <?dbhtml filename="popt.html"?>
 <title>popt-&popt-version;</title>
+&popt-intro;
+&popt-inst;
+&popt-desc;
+<sect2>
+<title>Introduction to <application>popt</application></title>
+<para>The popt package contains the popt libraries which are used by
+some programs to parse command-line options.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&popt-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&popt-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &popt-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &popt-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &popt-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>popt</application></title>
+<para>Install <application>popt</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>popt</application> package contains the
+<filename class="libraryfile">libpopt</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>popt library</title>
+<para>The <filename class="libraryfile">libpopt</filename> library is used to
+parse command-line options.</para></sect3>
+</sect2>
 </sect1>

general/genlib/readline.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY readline-download-http "http://ftp.gnu.org/gnu/readline/readline-&readline-version;.tar.gz">
+<!ENTITY readline-download-ftp "ftp://ftp.gnu.org/gnu/readline/readline-&readline-version;.tar.gz">
+<!ENTITY readline-size "944 KB">
+<!ENTITY readline-buildsize "9.2 MB">
+<!ENTITY readline-time "0.10 SBU">
+]>
 <sect1 id="readline" xreflabel="readline-&readline-version;">
 <?dbhtml filename="readline.html"?>
 <title>readline-&readline-version;</title>
+&readline-intro;
+&readline-inst;
+&readline-exp;
+&readline-config;
+&readline-desc;
+<sect2>
+<title>Introduction to <application>readline</application></title>
+<para>The <application>readline</application> library provides a set of
+functions for use by applications that allow users to edit command-lines as
+they are typed in.  Both <application>Emacs</application> and
+<application>vi</application> editing modes are available.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&readline-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&readline-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &readline-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&readline-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&readline-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>readline</application></title>
+<para>Install <application>readline</application> by running the following
+commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make SHLIB_LIBS=-lcurses &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><command>make SHLIB_LIBS=-lcurses</command>: This command makes the
+proper symbols available for applications that assume
+<application>readline</application> is compiled with
+<application>ncurses</application> links.</para>
+</sect2>
+<sect2>
+<title>Configuring <application>readline</application></title>
+<sect3><title>Configuration Information</title>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>readline</application> package contains the <filename>
+libreadline</filename> libraries and <filename>libhistory</filename> libraries.
+</para>
+</sect2>
 </sect1>

general/genlib/slang.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY slang-download-http "http://gd.tuwien.ac.at/editors/davis/slang/v1.4/slang-&slang-version;.tar.bz2">
+<!ENTITY slang-download-ftp "ftp://space.mit.edu/pub/davis/slang/v1.4/slang-&slang-version;.tar.bz2">
+<!ENTITY slang-size "624 KB">
+<!ENTITY slang-buildsize "9.6 MB">
+<!ENTITY slang-time "0.16 SBU">
+]>
 <sect1 id="slang" xreflabel="slang-&slang-version;">
 <?dbhtml filename="slang.html"?>
 <title>slang-&slang-version;</title>
+&slang-intro;
+&slang-inst;
+&slang-config;
+&slang-desc;
+<sect2>
+<title>Introduction to <application>slang</application></title>
+<para>The slang package contains the slang library, which
+provides facilities such as display/screen management, keyboard input, and keymaps.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&slang-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&slang-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &slang-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &slang-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &slang-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>slang</application></title>
+<para>Install <application>slang</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install &amp;&amp;
+make elf &amp;&amp;
+make install-elf &amp;&amp;
+make install-links &amp;&amp;
+chmod 755 /usr/lib/libslang.so.&slang-version;</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Configuring <application>slang</application></title>
+<sect3><title>Configuration Information</title>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>slang</application> package contains the <filename>libslang</filename> libraries.</para>
+</sect2>
 </sect1>

general/genlib/slib.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY slib-download-http "http://www.swiss.ai.mit.edu/ftpdir/scm/OLD/slib&slib-version;.tar.gz">
+<!ENTITY slib-download-ftp " ">
+<!ENTITY slib-size "636 KB">
+<!ENTITY slib-buildsize "2.9 MB">
+<!ENTITY slib-time "0.00 SBU">
+]>
 <sect1 id="slib" xreflabel="slib-&slib-version;">
 <?dbhtml filename="slib.html"?>
 <title>slib-&slib-version;</title>
+&slib-intro;
+&slib-inst;
+&slib-desc;
+<sect2>
+<title>Introduction to <application>slib</application></title>
+<para>The <application>slib</application> package is a <application>Scheme
+</application> library used with <application>Guile</application>.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&slib-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&slib-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &slib-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&slib-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&slib-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>slib</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="guile"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>slib</application></title>
+<para>Installation of  <application>slib</application> is merely a copy command:
+</para>
+<screen><userinput><command>cp -R slib /usr/share/guile</command></userinput>
+</screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>slib</application> package contains a <application>
+Scheme</application> library.</para>
+</sect2>
 </sect1>

general/genutils/bc.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY bc-download-http "http://ftp.gnu.org/gnu/bc/bc-&bc-version;.tar.gz">
+<!ENTITY bc-download-ftp "ftp://ftp.gnu.org/gnu/bc/bc-&bc-version;.tar.gz">
+<!ENTITY bc-size "280 KB">
+<!ENTITY bc-buildsize "1.6 MB">
+<!ENTITY bc-time "0.07 SBU">
+]>
+<sect1 id="bc" xreflabel="bc-&bc-version;">
+<?dbhtml filename="bc.html"?>
+<title>bc-&bc-version;</title>
+<sect2>
+<title>Introduction to <application>bc</application></title>
+<para>The <application>bc</application> package contains
+an arbitrary precision numeric processing language.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&bc-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&bc-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &bc-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&bc-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&bc-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Required Patch: <ulink
+url="&patch-root;/bc-1.06-flex_invocation-1.patch"/></para></listitem>
+<listitem><para>Required Patch: <ulink
+url="&patch-root;/bc-1.06-readline-1.patch"/></para></listitem>
+</itemizedlist></sect3>
+<sect3><title><application>bc</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="readline"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <command>bc</command></title>
+<para>Install <command>bc</command> by running the following commands:</para>
+<screen><userinput><command>patch -Np1 -i ../bc-1.06-flex_invocation-1.patch &amp;&amp;
+patch -Np1 -i ../bc-1.06-readline-1.patch &amp;&amp;
+./configure --prefix=/usr --with-readline &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>bc</application> package contains
+<command>bc</command> and
+<command>dc</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>bc</title>
+<para><command>bc</command> is a calculator.</para></sect3>
+<sect3><title>dc</title>
+<para><command>dc</command> is a reverse-polish calculator.</para></sect3>
+</sect2>
+</sect1>
+<!-- Old Stuff
 <sect1 id="bc" xreflabel="bc-&bc-version;">
 <?dbhtml filename="bc.html"?>
 …
 </sect1>
+-->

general/genutils/compface.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY compface-download-http "http://www.ibiblio.org/pub/Linux/apps/graphics/convert/compface-&compface-version;.tar.gz">
+<!ENTITY compface-download-ftp " ">
+<!ENTITY compface-size "28 KB">
+<!ENTITY compface-buildsize "520 KB">
+<!ENTITY compface-time "0.01 SBU">
+]>
+<sect1 id="compface" xreflabel="Compface-&compface-version;">
+<?dbhtml filename="compface.html"?>
+<title>Compface-&compface-version;</title>
+<sect2>
+<title>Introduction to <application>Compface</application></title>
+<para><application>Compface</application> provides utilities and a library to
+convert from/to X-Face format, a 48x48 bitmap format used to carry thumbnails
+of email authors in a mail header.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&compface-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&compface-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &compface-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &compface-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &compface-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Required patch: <ulink
+url="&patch-root;/compface-1.4-errno-2.patch"/></para></listitem>
+</itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Compface</application></title>
+<para>Install <application>Compface</application> by running the
+following commands:</para>
+<screen><userinput><command>patch -Np1 -i ../compface-1.4-errno-2.patch &amp;&amp;
+./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>This package contains <command>compface</command>,
+<command>uncompface</command> and
+<filename class="libraryfile">libcompface</filename>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>compface</title>
+<para><command>compface</command> is a filter for generating highly compressed
+representations of 48x48x1 face image files.</para></sect3>
+<sect3><title>uncompface</title>
+<para><command>uncompface</command> is an inverse filter which performs an inverse
+transformation with no loss of data.</para></sect3>
+<sect3><title>libcompface</title>
+<para><filename class="libraryfile">libcompface</filename> allows the compression
+and decompression algorithms to be used in other programs such as
+<acronym>MTA</acronym>s.</para></sect3>
+</sect2>
+</sect1>
+<!-- Old Stuff
 <sect1 id="compface" xreflabel="Compface-&compface-version;">
 <?dbhtml filename="compface.html"?>
 …
 </sect1>
+-->

general/genutils/genutils.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+ <!ENTITY % general-entities SYSTEM "../../general.ent">
+ %general-entities;
+]>
 <chapter id="general-genutils">
 <?dbhtml filename="genutils.html"?>
 <title>General Utilities</title>
+&bc;
+&rep-gtk;
+&compface;
+&imagemagick;
+&hd2u;
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bc.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="rep-gtk.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="compface.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="imagemagick.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hd2u.xml"/>
 </chapter>

general/genutils/hd2u.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY hd2u-download-http "http://www.megaloman.com/~hany/_data/hd2u/hd2u-&hd2u-version;.tgz">
+<!ENTITY hd2u-download-ftp " ">
+<!ENTITY hd2u-size "11 KB">
+<!ENTITY hd2u-buildsize "280 KB">
+<!ENTITY hd2u-time "0.1 SBU">
+]>
 <sect1 id="hd2u" xreflabel="hd2u-&hd2u-version;">
 <?dbhtml filename="hd2u.html"?>
 <title>hd2u-&hd2u-version;</title>
+&hd2u-intro;
+&hd2u-inst;
+&hd2u-desc;
+<sect2>
+<title>Introduction to <application>hd2u</application></title>
+<para>The <application>hd2u</application> contains
+any to any text format converter.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&hd2u-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&hd2u-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &hd2u-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&hd2u-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&hd2u-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>hd2u</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="popt"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>hd2u</application></title>
+<para>Install <application>hd2u</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>hd2u</application> package contains
+<command>dos2unix</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>dos2unix</title>
+<para><command>dos2unix</command> converts text between various OS formats
+(such as converting from DOS format to Unix).</para></sect3>
+</sect2>
 </sect1>

general/genutils/imagemagick.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+  <!ENTITY imagemagick-patch-version "16">
+  <!ENTITY imagemagick-download-http "http://prdownloads.sourceforge.net/imagemagick/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.bz2">
+  <!ENTITY imagemagick-download-ftp  " ">
+  <!ENTITY imagemagick-size          "4.1 MB">
+  <!ENTITY imagemagick-buildsize     "107 MB">
+  <!ENTITY imagemagick-time          "3.80 SBU">
+]>
 <sect1 id="imagemagick" xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
 <?dbhtml filename="imagemagick.html"?>
 <title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>
+&imagemagick-intro;
+&imagemagick-inst;
+&imagemagick-desc;
+<sect2>
+<title>Introduction to <application>ImageMagick</application></title>
+<para><application>ImageMagick</application> is a collection of tools and libraries
+to read, write, and
+manipulate an image in various image formats. Image processing operations are
+available from the command line. Bindings to various programming languages
+are also available.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&imagemagick-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&imagemagick-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &imagemagick-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&imagemagick-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&imagemagick-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>ImageMagick</application> dependencies</title>
+<sect4><title>Recommended</title>
+<para>
+X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and
+<xref linkend="espgs"/>
+</para></sect4>
+<sect4><title>Optional (Install based on the format support needed)</title>
+<para>
+<xref linkend="lcms"/>,
+<xref linkend="libjpeg"/>,
+<xref linkend="libpng"/>,
+<xref linkend="libtiff"/>,
+<xref linkend="libxml2"/>,
+<ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
+<ulink url="http://sourceforge.net/projects/libexif/">libexif</ulink>,
+<ulink url="http://www.i3a.org/i_flashpix.html">FlashPIX</ulink>,
+<ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG</ulink>,
+<ulink url="http://www.ece.uvic.ca/~mdadams/jasper/">Jasper</ulink> and
+<ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Imagemagick</application></title>
+<para>Install <application>Imagemagick</application> by running the following
+commands:</para>
+<screen><userinput><command>./configure --prefix=/usr --enable-shared --with-modules &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Additional Configure Options</title>
+<para>There are additional switches that can be passed to <application>ImageMagick</application>
+to customize the installation to your need. Check out the <application>ImageMagick</application>
+installation instructions at <ulink url="http://www.imagemagick.org/www/Install-unix.html"/>.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para><application>ImageMagick</application> contains <command>animate</command>,
+<command>composite</command>,
+<command>conjure</command>,
+<command>convert</command>,
+<command>display</command>,
+<command>identify</command>,
+<command>import</command>,
+<command>mogrify</command>,
+<command>montage</command>, and the
+<filename class="libraryfile">libMagick</filename> and
+<filename class="libraryfile">libMagick++</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>animate</title>
+<para>Animates a sequence of images.</para></sect3>
+<sect3><title>composite</title>
+<para>Composites various images into the given base image.</para></sect3>
+<sect3><title>conjure</title>
+<para>Processes a Magick Scripting Language (MSL) script to create
+an image.</para></sect3>
+<sect3><title>convert</title>
+<para>Convert image(s) from one format to another.</para></sect3>
+<sect3><title>display</title>
+<para>Display the image.</para></sect3>
+<sect3><title>identify</title>
+<para>Describes the format and characteristics of an image file.</para></sect3>
+<sect3><title>import</title>
+<para>Captures an X window.</para></sect3>
+<sect3><title>mogrify</title>
+<para>Transforms an image.</para></sect3>
+<sect3><title>montage</title>
+<para>Composites various images into a new image.</para></sect3>
+</sect2>
 </sect1>

general/genutils/rep-gtk.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+  <!ENTITY rep-gtk-download-http "http://prdownloads.sourceforge.net/rep-gtk/rep-gtk-&rep-gtk-version;.tar.gz">
+  <!ENTITY rep-gtk-download-ftp  " ">
+  <!ENTITY rep-gtk-size          "152 KB">
+  <!ENTITY rep-gtk-buildsize     "7.7 MB">
+  <!ENTITY rep-gtk-time          "0.18 SBU">
+]>
 <sect1 id="rep-gtk" xreflabel="rep-gtk-&rep-gtk-version;">
 <?dbhtml filename="rep-gtk.html"?>
 <title>rep-gtk-&rep-gtk-version;</title>
+&rep-gtk-intro;
+&rep-gtk-inst;
+&rep-gtk-desc;
+<sect2>
+<title>Introduction to <application>rep-gtk</application></title>
+<para>The <application>rep-gtk</application> package contains a <application>
+Lisp</application> and <application>GTK</application> binding. This is useful
+for extending <application>GTK-2</application> and <application>GDK
+</application> libraries with <application>Lisp</application>. Starting at
+<application>rep-gtk</application>-0.15, the package contains the bindings to
+<application>GTK</application> and uses the same instructions. Both
+can be installed, if needed. </para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&rep-gtk-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&rep-gtk-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &rep-gtk-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&rep-gtk-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&rep-gtk-time;</para></listitem></itemizedlist>
+</sect3>
+<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>
+</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>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>rep-gtk</application></title>
+<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;
+./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>

general/graphlib/aalib.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY aalib-download-http "http://prdownloads.sourceforge.net/aa-project/aalib-&aalib-version;.tar.gz">
+<!ENTITY aalib-download-ftp " ">
+<!ENTITY aalib-size "388 KB">
+<!ENTITY aalib-buildsize "6.5 MB">
+<!ENTITY aalib-time "0.15 SBU">
+]>
 <sect1 id="aalib" xreflabel="AAlib-&aalib-version;">
 <?dbhtml filename="aalib.html"?>
 <title>AAlib-&aalib-version;</title>
+&aalib-intro;
+&aalib-inst;
+&aalib-desc;
+<sect2>
+<title>Introduction to <application>AAlib</application></title>
+<para><application>AAlib</application> is a library to render any graphic into
+<acronym>ASCII</acronym> Art.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&aalib-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&aalib-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &aalib-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&aalib-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&aalib-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>AAlib</application> dependencies</title>
+<sect4><title>Optional</title>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and <xref linkend="slang"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>AAlib</application></title>
+<para>Install <application>AAlib</application> by running the following
+commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>AAlib</application> package contains the <filename>libaa</filename> libraries, <command>aalib-config</command>,
+<command>aainfo</command>, <command>aatest</command> and
+<command>aasavefont</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>ASCII Art libraries</title>
+<para>The ASCII Art library is a collection of routines to render any
+graphical input in portable format to ASCII Art. It can be used through
+many programs and has a very well documented <acronym>API</acronym>, so you
+can easily put it into your own programs.</para></sect3>
+<sect3><title>aalib-config</title>
+<para><command>aalib-config</command> provides configuration info for
+<application>AAlib</application>.
+</para></sect3>
+<sect3><title>aainfo</title>
+<para><command>aainfo</command> provides information for your current settings
+related to <application>AAlib</application>.</para></sect3>
+<sect3><title>aatest</title>
+<para><command>aatest</command> shows the abilities of <application>AAlib
+</application> in a little test.</para></sect3>
+<sect3><title>aafire</title>
+<para><command>aafire</command> is another little toy of <application>AAlib
+</application>, rendering an animated fire in ASCII Art.</para></sect3>
+<sect3><title>aasavefont</title>
+<para>Currently no information available.</para></sect3>
+</sect2>
 </sect1>

general/graphlib/directfb.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY DirectFB-download-http "http://www.directfb.org/download/DirectFB/DirectFB-&DirectFB-version;.tar.gz">
+<!ENTITY DirectFB-download-ftp " ">
+<!ENTITY DirectFB-size "1.3 MB">
+<!ENTITY DirectFB-buildsize "13 MB">
+<!ENTITY DirectFB-time "0.65 SBU">
+]>
 <sect1 id="DirectFB" xreflabel="DirectFB-&DirectFB-version;">
 <?dbhtml filename="DirectFB.html"?>
 <title>DirectFB-&DirectFB-version;</title>
+&DirectFB-intro;
+&DirectFB-inst;
+&DirectFB-config;
+&DirectFB-desc;
+<sect2>
+<title>Introduction to <application>DirectFB</application></title>
+<para><application>DirectFB</application> is a graphics library on top of the Linux frame buffer
+device. It offers maximum hardware accelerated performance at a
+minimum of resource usage and overhead.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&DirectFB-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&DirectFB-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &DirectFB-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &DirectFB-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &DirectFB-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Optional image and video providers: <ulink
+url="http://www.directfb.org/download/DirectFB-extra/DirectFB-extra-0.9.16.tar.gz"/>
+</para></listitem>
+</itemizedlist></sect3>
+<sect3><title><application>DirectFB</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="freetype2"/>, <xref linkend="libjpeg"/> and
+<xref linkend="libpng"/>
+</para></sect4>
+<sect4><title>Optional</title>
+<para><xref linkend="SDL"/>, <xref linkend="libmpeg3"/>
+<xref linkend="pkgconfig"/>, <xref linkend="imlib2"/>, <xref
+linkend="openquicktime"/> and <xref linkend="avifile"/>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>DirectFB</application></title>
+<note><para>DirectFB needs a Linux kernel with frame buffer support. Check
+the documentation in the kernel tree
+(<filename class="directory">/usr/src/linux/Documentation/fb/</filename>)
+on how to enable the frame buffer device for your graphics
+card.</para></note>
+<para>Install <application>DirectFB</application> by running the
+following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+<para>If you decided to add any optional image and video providers, then you
+have to install the DirectFB-extra package too:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+<note><para>The current version of avifile does not work with DirectFB.
+You have to use the avifile version which can be found at
+<ulink url="http://www.directfb.org/download/contrib/"/> or alternatively disable the
+avifile video provider by calling configure with
+<command>--disable-avifile</command>.</para></note>
+</sect2>
+<sect2>
+<title>Configuring DirectFB</title>
+<sect3><title>Config files</title>
+<para><filename>/etc/directfbrc</filename>,
+<filename>~/.directfbrc</filename></para>
+</sect3>
+<sect3><title>Configuration information</title>
+<para>DirectFB is shipped with reasonable defaults but you might have to
+tweak things. There are several ways to do this. You may edit the
+system-wide configuration file <filename>/etc/directfbrc</filename>, the user-specific
+<filename>~/.directfbrc</filename> or you may configure the DirectFB application via the
+command-line. Consult the directfbrc(5) manual page for details.</para>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The DirectFB package provides <command>dfbdump</command>,
+<command>dfbg</command>, <command>dfbinfo</command>,
+<command>dfblayer</command>, <command>directfb-config</command>,
+<command>directfb-csource</command> and <filename
+class="libraryfile">libdirectfb</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>dfbdump</title>
+<para> This is a simple debugging tool for DirectFB that shows a list
+of surfaces and windows.</para></sect3>
+<sect3><title>dfbg</title>
+<para><command>dfbg</command> is a background configuration
+tool.</para></sect3>
+<sect3><title>dfbinfo</title>
+<para>This tool enumerates input devices.</para></sect3>
+<sect3><title>dfblayer</title>
+<para><command>dfblayer</command> is a display layer configuration
+tool.</para></sect3>
+<sect3><title>directfb-config</title>
+<para><command>directfb-config</command> provides all flags to link static binaries with
+selectable drivers and other modules built in.</para></sect3>
+<sect3><title>directfb-csource</title>
+<para>This is a C code generation utility for DirectFB
+surfaces.</para></sect3>
+<sect3><title>libdirectfb libraries</title>
+<para>They provide hardware graphics acceleration, input device handling
+and abstraction, integrated windowing system with support for
+translucent windows and multiple display layers on top of the Linux
+frame buffer device.</para></sect3>
+</sect2>
 </sect1>

general/graphlib/fontconfig.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY fontconfig-download-http "http://freedesktop.org/~fontconfig/release/fontconfig-&fontconfig-version;.tar.gz">
+<!ENTITY fontconfig-download-ftp "ftp://ftp.us.sinuspl.net/pub/src/fontconfig-&fontconfig-version;.tar.gz">
+<!ENTITY fontconfig-size "727 KB">
+<!ENTITY fontconfig-buildsize "11 MB">
+<!ENTITY fontconfig-time "0.18 SBU">
+]>
 <sect1 id="fontconfig" xreflabel="Fontconfig-&fontconfig-version;">
 <?dbhtml filename="fontconfig.html"?>
 <title>Fontconfig-&fontconfig-version;</title>
+&fontconfig-intro;
+&fontconfig-inst;
+&fontconfig-config;
+&fontconfig-desc;
+<sect2>
+<title>Introduction to <application>Fontconfig</application></title>
+<para>The <application>Fontconfig</application> package is a library
+for configuring and customizing font access.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&fontconfig-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&fontconfig-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &fontconfig-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&fontconfig-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&fontconfig-time;</para></listitem></itemizedlist>
+<note><para>The numbering system of
+<application>Fontconfig</application> is unusual.  The beta versions of the
+package are numbered with a 9x in the last portion of the release number.  This
+means that 2.2.90 is a beta release and the most current release is of the
+form 2.2.1</para></note>
+</sect3>
+<sect3><title><application>Fontconfig</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="freetype2"/> and <xref linkend="expat"/></para></sect4>
+<sect4><title>Optional</title>
+<para>
+<ulink url="http://sources.redhat.com/docbook-tools/">docbook-utils</ulink>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Fontconfig</application></title>
+<para>Install <application>Fontconfig</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Configuring <application>Fontconfig</application></title>
+<sect3><title>Config files</title>
+<para><filename>/etc/fonts/*</filename></para>
+</sect3>
+<sect3><title>Configuration Information</title>
+<para>The configuration file for <application>Fontconfig</application> is <filename>/etc/fonts/fonts.conf</filename>.
+Generally you do not want to edit this file.  To put a new font directory
+in the configuration, update the <filename>/etc/fonts/local.conf</filename> file with your local
+information.  The default location of fonts in
+<application>Fontconfig</application> is:</para>
+<itemizedlist spacing='compact'>
+<listitem><para>/usr/share/fonts</para></listitem>
+<listitem><para>~/.fonts</para></listitem>
+</itemizedlist>
+<para>Because we have not built <application>XFree86</application> yet, put the following directory entries
+into <filename>/etc/fonts/local.conf</filename>, inside the fontconfig
+tags:</para>
+<screen><userinput><command>sed -i -e '/^&lt;\/fontconfig&gt;/i\
+&lt;dir&gt;/usr/X11R6/lib/X11/fonts/TTF&lt;/dir&gt;\
+&lt;dir&gt;/usr/X11R6/lib/X11/fonts/Type1&lt;/dir&gt;\
+&lt;dir&gt;/usr/X11R6/lib/X11/fonts/truetype&lt;/dir&gt;' /etc/fonts/local.conf</command></userinput></screen>
+<para>The <application>Fontconfig</application> program will automatically search the above directories
+and all subdirectories for needed fonts.</para>
+<note><para><application>X</application> also includes an internal (and
+older) version of <application>Fontconfig</application>
+and unless it is explicitly disabled when building
+<application>XFree86</application>, the internal
+version is created leaving two slightly incompatible libraries on your system.
+It is recommended that you only install one version.</para></note>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>Fontconfig</application> package contains the
+<filename class='libraryfile'>libfontconfig</filename> library,
+<command>fc-cache</command>, and <command>fc-list</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>fc-cache</title>
+<para><command>fc-cache</command> is a command to create font information
+caches.</para></sect3>
+<sect3><title>fc-list</title>
+<para><command>fc-list</command> is a command to list fonts.</para></sect3>
+</sect2>
 </sect1>

general/graphlib/freetype2.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY freetype2-download-http "http://prdownloads.sourceforge.net/freetype/freetype-&freetype2-version;.tar.bz2">
+<!ENTITY freetype2-download-ftp " ">
+<!ENTITY freetype2-size "954 KB">
+<!ENTITY freetype2-buildsize "18 MB">
+<!ENTITY freetype2-time "0.32 SBU">
+]>
 <sect1 id="freetype2" xreflabel="FreeType-&freetype2-version;">
 <?dbhtml filename="freetype2.html"?>
 <title>FreeType-&freetype2-version;</title>
+&freetype2-intro;
+&freetype2-inst;
+&freetype2-desc;
+<sect2>
+<title>Introduction to <application>FreeType2</application></title>
+<para>The <application>FreeType2</application> package contains a library to
+allow applications to properly render
+<application>TrueType</application> fonts.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&freetype2-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&freetype2-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &freetype2-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&freetype2-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&freetype2-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Recommended Patch: <ulink
+url="&patch-root;/freetype-&freetype2-version;-bytecode-interpreter.patch"/></para></listitem>
+</itemizedlist></sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>FreeType2</application></title>
+<para>Install <application>FreeType2</application> by running the following
+commands:</para>
+<screen><userinput><command>patch -Np1 -i ../freetype-&freetype2-version;-bytecode-interpreter.patch &amp;&amp;
+./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>FreeType2</application> package contains
+<filename class="libraryfile">
+libfreetype</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>FreeType2 libraries</title>
+<para><application>FreeType2</application> libraries add
+<application>TrueType</application> font
+capabilities to <application>XFree86</application>.</para></sect3>
+</sect2>
 </sect1>

general/graphlib/graphlib.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+ <!ENTITY % general-entities SYSTEM "../../general.ent">
+ %general-entities;
+]>
 <chapter id="general-graphlib">
 <?dbhtml filename="graphlib.html"?>
 …
 other hand, will not require them.</para>
+&libjpeg;
+&libpng;
+&libtiff;
+&libungif;
+&libmng;
+&lcms;
+&freetype2;
+&fontconfig;
+&imlib;
+&aalib;
+&SVGAlib;
+&DirectFB;
+&imlib2;
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libjpeg.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libpng.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libtiff.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libungif.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libmng.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lcms.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="freetype2.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fontconfig.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="imlib.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="aalib.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="svgalib.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="directfb.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="imlib2.xml"/>
 </chapter>

general/graphlib/imlib.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY imlib-download-http "http://ftp.gnome.org/pub/GNOME/sources/imlib/1.9/imlib-&imlib-version;.tar.bz2">
+<!ENTITY imlib-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/imlib/1.9/imlib-&imlib-version;.tar.bz2">
+<!ENTITY imlib-size "580 KB">
+<!ENTITY imlib-buildsize "16.4 MB">
+<!ENTITY imlib-time "0.43 SBU">
+]>
 <sect1 id="imlib" xreflabel="Imlib-&imlib-version;">
 <?dbhtml filename="imlib.html"?>
 <title>Imlib-&imlib-version;</title>
+&imlib-intro;
+&imlib-inst;
+&imlib-exp;
+&imlib-desc;
+<sect2>
+<title>Introduction to <application>Imlib</application></title>
+<para>The <application>Imlib</application> package contains image libraries.
+These are useful for loading, rendering and dithering a wide variety of image
+data formats.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&imlib-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&imlib-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &imlib-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&imlib-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&imlib-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>Imlib</application> dependencies</title>
+<sect4><title>Required</title>
+<para>
+<xref linkend="GTK"/> and
+<xref linkend="libungif"/>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Imlib</application></title>
+<para>Install <application>Imlib</application> by running the following
+commands:</para>
+<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc/imlib &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<!--<para><userinput>CPPFLAGS=-w</userinput>: This disables gcc-&gcc-version;
+warnings that confuse configure.</para>-->
+<para><parameter>--sysconfdir=/etc/imlib</parameter>: This installs and
+combines the configurations files into <filename class="directory">/etc</filename> instead
+of <filename class="directory">/usr/etc</filename>.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>Imlib</application> package contains <filename>libimlib</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>imlib libraries</title>
+<para><filename>libimlib</filename> libraries provide the functions for
+programs to display and edit a wide variety of image data formats.</para>
+</sect3>
+</sect2>
 </sect1>

general/graphlib/imlib2.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY imlib2-download-http "http://prdownloads.sourceforge.net/enlightenment/imlib2-&imlib2-version;.tar.gz">
+<!ENTITY imlib2-download-ftp "ftp://ftp.tux.org/X-Windows/enlightenment/ftp/enlightenment/imlib2-&imlib2-version;.tar.gz">
+<!ENTITY imlib2-size "796 KB">
+<!ENTITY imlib2-buildsize "20 MB">
+<!ENTITY imlib2-time "0.53 SBU">
+]>
 <sect1 id="imlib2" xreflabel="Imlib2-&imlib2-version;">
 <?dbhtml filename="imlib2.html"?>
 <title>Imlib2-&imlib2-version;</title>
+&imlib2-intro;
+&imlib2-inst;
+&imlib2-desc;
+<sect2>
+<title>Introduction to <application>Imlib2</application></title>
+<para><application>Imlib2</application> is a graphics library for fast file
+loading, saving, rendering and manipulation.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&imlib2-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&imlib2-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &imlib2-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &imlib2-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &imlib2-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>Imlib2</application> dependencies</title>
+<sect4><title>Required</title>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and <xref linkend="libjpeg"/>
+</para></sect4>
+<sect4><title>Optional</title>
+<para><xref linkend="libtiff"/> and <xref
+linkend="libungif"/>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Imlib2</application></title>
+<para>Install <application>Imlib2</application> by running the
+following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>
+This package contains <filename class="libraryfile">libImlib2</filename> library
+as well as various filters and image loader libraries.
+</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>libImlib2</title>
+<para><filename class="libraryfile">libImlib2</filename>
+provides the functions for programs to deal with various image data formats.
+</para></sect3>
+</sect2>
 </sect1>

general/graphlib/lcms.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY lcms-download-http "http://www.littlecms.com/lcms-&lcms-version;.tar.gz">
+<!ENTITY lcms-download-ftp " ">
+<!ENTITY lcms-size "555 KB">
+<!ENTITY lcms-buildsize "17 MB">
+<!ENTITY lcms-time "0.32 SBU">
+]>
 <sect1 id="lcms" xreflabel="lcms-&lcms-version;">
 <?dbhtml filename="lcms.html"?>
 <title>lcms-&lcms-version;</title>
+&lcms-intro;
+&lcms-inst;
+<!-- &lcms-exp; -->
+&lcms-desc;
+<sect2>
+<title>Introduction to <application>lcms</application></title>
+<para>The lcms library is used by other programs to provide
+color management facilities.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&lcms-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&lcms-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &lcms-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&lcms-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&lcms-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>lcms</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="libtiff"/>, <xref linkend="libjpeg"/>, <xref
+linkend="Python"/> and <ulink
+url="http://www.swig.org/">SWIG</ulink></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>lcms</application></title>
+<para>Install <application>lcms</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The lcms package contains the <filename class="libraryfile">liblcms</filename>
+libraries, <command>icc2ps</command>, <command>icclink</command>,
+<command>icctrans</command>, <command>wtpt</command> and optionally, <command>tifficc</command>,
+<command>jpegicc</command> and <filename
+class="libraryfile">lcms</filename> Python module.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>liblcms library</title>
+<para>The <filename class="libraryfile">liblcms</filename> libraries are used by other programs to provide color
+management facilities.</para></sect3>
+<sect3><title>icc2ps</title>
+<para><command>icc2ps</command> generates PostScript
+<acronym>CRD</acronym> or <acronym>CSA</acronym> from
+<acronym>ICC</acronym> profiles.</para></sect3>
+<sect3><title>icclink</title>
+<para><command>icclink</command> links two or more profiles into a
+single device link profile.</para></sect3>
+<sect3><title>icctrans</title>
+<para><command>icctrans</command> is a Color Space conversion
+calculator.</para></sect3>
+<sect3><title>tifficc</title>
+<para><command>tifficc</command> is an <acronym>ICC</acronym> profile
+applier for <acronym>TIFF</acronym> files.</para></sect3>
+<sect3><title>jpegicc</title>
+<para><command>jpegicc</command> is an <acronym>ICC</acronym> profile
+applier for <acronym>JPEG</acronym> files.</para></sect3>
+</sect2>
 </sect1>

general/graphlib/libjpeg.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libjpeg-download-http "http://www.ijg.org/files/jpegsrc.v&libjpeg-version;.tar.gz">
+<!ENTITY libjpeg-download-ftp "ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v&libjpeg-version;.tar.gz">
+<!ENTITY libjpeg-size "599 KB">
+<!ENTITY libjpeg-buildsize "3.7 MB">
+<!ENTITY libjpeg-time "0.26 SBU">
+]>
 <sect1 id="libjpeg" xreflabel="libjpeg-&libjpeg-version;">
 <?dbhtml filename="libjpeg.html"?>
 <title>libjpeg-&libjpeg-version;</title>
+&libjpeg-intro;
+&libjpeg-inst;
+&libjpeg-exp;
+&libjpeg-config;
+&libjpeg-desc;
+<sect2>
+<title>Introduction to <application>libjpeg</application></title>
+<para>The <application>libjpeg</application> package contains libraries
+that allow compression of image files based on the Joint Photographic Experts
+Group standard. It is a "lossy" compression algorithm.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libjpeg-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libjpeg-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libjpeg-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libjpeg-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libjpeg-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>libjpeg</application></title>
+<para>Install <application>libjpeg</application> by running the following commands:</para>
+<screen><userinput><command>./configure --enable-static --enable-shared --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><command>./configure --enable-static --enable-shared --prefix=/usr</command>: This command tells libjpeg to build both shared and static libraries and
+to install them with a base of <filename>/usr</filename>.</para>
+</sect2>
+<sect2>
+<title>Configuring <application>libjpeg</application></title>
+<sect3><title>Configuration Information</title>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The libjpeg package contains <command>cjpeg</command>,
+<command>djpeg</command>, <command>jpegtran</command>,
+<command>rdjpgcom</command>, <command>wrjpgcom</command> and
+<filename>libjpeg</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>cjpeg</title>
+<para><command>cjpeg</command> compresses image files to produce a
+<acronym>JPEG</acronym>/<acronym>JFIF</acronym> file on the standard
+output.  Currently supported input file formats are:
+<acronym>PPM</acronym> (PBMPLUS color
+format), <acronym>PGM</acronym> (PBMPLUS gray-scale
+format), <acronym>BMP</acronym>, and Targa.</para></sect3>
+<sect3><title>djpeg</title>
+<para><command>djpeg</command> decompresses image files from
+<acronym>JPEG/JFIF</acronym> format to either <acronym>PPM</acronym>
+(PBMPLUS color format), <acronym>PGM</acronym> (PBMPLUS gray-scale
+format), <acronym>BMP</acronym>, or Targa
+format.</para></sect3>
+<sect3><title>jpegtran</title>
+<para><command>jpegtran</command> is used for lossless transformation of
+<acronym>JPEG</acronym> files.</para></sect3>
+<sect3><title>rdjpgcom</title>
+<para><command>rdjpgcom</command> displays text comments from within a
+<acronym>JPEG</acronym> file.</para></sect3>
+<sect3><title>wrjpgcom</title>
+<para><command>wrjpgcom</command> inserts text comments into a
+<acronym>JPEG</acronym> file.</para></sect3>
+<sect3><title>jpeg libraries</title>
+<para>These libraries are used by many programs for reading and writing
+jpeg format files.</para></sect3>
+</sect2>
 </sect1>

general/graphlib/libmng.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libmng-download-http "http://prdownloads.sourceforge.net/libmng/libmng-&libmng-version;.tar.gz">
+<!ENTITY libmng-download-ftp " ">
+<!ENTITY libmng-size "492 KB">
+<!ENTITY libmng-buildsize "13.7 MB">
+<!ENTITY libmng-time "0.41 SBU">
+]>
 <sect1 id="libmng" xreflabel="libmng-&libmng-version;">
 <?dbhtml filename="libmng.html"?>
 <title>libmng-&libmng-version;</title>
+&libmng-intro;
+&libmng-inst;
+&libmng-exp;
+&libmng-desc;
+<sect2>
+<title>Introduction to <application>libmng</application></title>
+<para>The <application>libmng</application> libraries are used by programs
+wanting to read and write Multiple-image Network Graphics (<acronym>MNG</acronym>)
+files which are the animation
+equivalents to <acronym>PNG</acronym> files.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&libmng-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libmng-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libmng-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&libmng-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&libmng-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>libmng</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="libjpeg"/> and <xref linkend="lcms"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>libmng</application></title>
+<para>Install <application>libmng</application> by running the following
+commands:</para>
+<screen><userinput><command>./autogen.sh &amp;&amp;
+./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install &amp;&amp;
+cp doc/man/*.3 /usr/share/man/man3 &amp;&amp;
+cp doc/man/*.5 /usr/share/man/man5</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><command>./autogen.sh</command>: This package does not ship
+with the configure script. The autotool files need to be generated
+before configuring the package.</para>
+<para><command>cp doc/man/*.X /usr/share/man/manX</command>: The
+install procedure doesn't properly install the man pages so we do it
+manually.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>libmng</application> package contains <filename>libmng
+</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>MNG libraries</title>
+<para><filename>libmng</filename> provides functions for programs wishing to
+read and write <acronym>MNG</acronym> files which are animation files without
+the patent problems associated with certain other formats.</para></sect3>
+</sect2>
 </sect1>

general/graphlib/libpng.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libpng-download-http "http://prdownloads.sourceforge.net/libpng/libpng-&libpng-version;.tar.bz2">
+<!ENTITY libpng-download-ftp "ftp://ftp.iasi.roedu.net/pub/mirrors/ftp.gimp.org/gimp/libs/libpng-&libpng-version;.tar.bz2">
+<!ENTITY libpng-size "376 KB">
+<!ENTITY libpng-buildsize "4.1 MB">
+<!ENTITY libpng-time "0.16 SBU">
+]>
 <sect1 id="libpng" xreflabel="libpng-&libpng-version;">
 <?dbhtml filename="libpng.html"?>
 <title>libpng-&libpng-version;</title>
+&libpng-intro;
+&libpng-inst;
+&libpng-exp;
+&libpng-config;
+&libpng-desc;
+<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
+url="&libpng-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&libpng-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libpng-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&libpng-buildsize;</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>
+</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;
+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>
+<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
+platforms.</para>
+</sect2>
+<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"/>
+</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>
+</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
+<acronym>PNG</acronym> format was designed as a
+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>

general/graphlib/libtiff.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libtiff-download-http "http://libtiff.maptools.org/dl/tiff-v&libtiff-version;.tar.gz">
+<!ENTITY libtiff-download-ftp " ">
+<!ENTITY libtiff-size "1.1 MB">
+<!ENTITY libtiff-buildsize "11 MB">
+<!ENTITY libtiff-time "0.16 SBU">
+]>
 <sect1 id="libtiff" xreflabel="libtiff-&libtiff-version;">
 <?dbhtml filename="libtiff.html"?>
 <title>libtiff-&libtiff-version;</title>
+&libtiff-intro;
+&libtiff-inst;
+&libtiff-exp;
+&libtiff-config;
+&libtiff-desc;
+<sect2>
+<title>Introduction to <application>libtiff</application></title>
+<para>The <application>libtiff</application> package contains the tiff libraries and associated
+utilities.  The libraries are used by many programs for reading and
+writing tiff files and the utilities are useful for general work with
+tiff files.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&libtiff-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&libtiff-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libtiff-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &libtiff-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &libtiff-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>libtiff</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="libjpeg"/>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>libtiff</application></title>
+<para>Install <application>libtiff</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr --noninteractive \
+    --with-DIR_MAN=/usr/share/man \
+    --with-ZIP=yes --with-DIR_GZLIB=/usr/lib &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+<note><para>configure prints false error messages that it is unable to find thelibrary directories for ZIP (and JPEG) support. Ignore them. To verify that
+<filename>libtiff</filename> is indeed linked to these libraries, use the
+<command>ldd</command> command.</para></note>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><option>--noninteractive</option>: This switch is used to
+avoid the configuration routine asking for confirmation of the
+installation directories (which we pass to configure).</para>
+<para><parameter>--with-DIR_MAN=/usr/share/man</parameter>: This is used
+because despite the fact we pass <parameter>--prefix=/usr</parameter>, the
+configure routine tries to install the man pages in <filename
+class="directory">/usr/local/man</filename> instead of the correct
+place.</para>
+<para><parameter>--with-ZIP=yes --with-DIR_GZLIB=/usr/lib</parameter>: This
+enables support for the handling of <acronym>TIFF</acronym> images with
+deflate-encoded data.</para>
+<para><parameter>--with-JPEG=yes --with-DIR_JPEGLIB=/usr/lib</parameter>: Use
+these switches to enable support for the handling of <acronym>TIFF</acronym>
+images with <acronym>JPEG</acronym>-encoded data.</para>
+</sect2>
+<sect2>
+<title>Configuring <application>libtiff</application></title>
+<sect3><title>Configuration Information</title>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The libtiff package contains
+<command>fax2ps</command>,
+<command>fax2tiff</command>,
+<command>gif2tiff</command>,
+<command>pal2rgb</command>,
+<command>ppm2tiff</command>,
+<command>ras2tiff</command>,
+<command>raw2tiff</command>,
+<command>rgb2ycbcr</command>,
+<command>thumbnail</command>,
+<command>tiff2bw</command>,
+<command>tiff2pdf</command>,
+<command>tiff2ps</command>,
+<command>tiff2rgba</command>,
+<command>tiffcmp</command>,
+<command>tiffcp</command>,
+<command>tiffdither</command>,
+<command>tiffdump</command>,
+<command>tiffinfo</command>,
+<command>tiffmedian</command>,
+<command>tiffset</command>,
+<command>tiffsplit</command> and
+<filename class="libraryfile">libtiff</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>fax2ps</title>
+<para><command>fac2ps</command> converts a <acronym>TIFF</acronym>
+facsimile to compressed PostScript file.</para></sect3>
+<sect3><title>fax2tiff</title>
+<para><command>fax2tiff</command> creates a <acronym>TIFF</acronym>
+Class F fax file from raw fax data.</para></sect3>
+<sect3><title>gif2tiff</title>
+<para><command>gif2tiff</command> creates a <acronym>TIFF</acronym> file
+from a <acronym>GIF87</acronym> format image file.</para></sect3>
+<sect3><title>pal2rgb</title>
+<para><command>pal2rgb</command> converts a palette color
+<acronym>TIFF</acronym> image to a full color image.</para></sect3>
+<sect3><title>ppm2tiff</title>
+<para><command>ppm2tiff</command> creates a <acronym>TIFF</acronym> file
+from a <acronym>PPM</acronym> image file.</para></sect3>
+<sect3><title>ras2tiff</title>
+<para><command>ras2tiff</command> creates a <acronym>TIFF</acronym> file
+from a Sun rasterfile.</para></sect3>
+<sect3><title>raw2tiff</title>
+<para><command>raw2tiff</command> converts a raw byte sequence into
+<acronym>TIFF</acronym>.</para></sect3>
+<sect3><title>rgb2ycbcr</title>
+<para><command>rgb2ycbcr</command> converts non-YCbCr
+<acronym>TIFF</acronym> images to a YCbCr <acronym>TIFF</acronym>
+image.</para></sect3>
+<sect3><title>thumbnail</title>
+<para><command>thumbnail</command> creates a <acronym>TIFF</acronym>
+file with thumbnail images.</para></sect3>
+<sect3><title>tiff2bw</title>
+<para><command>tiff2bw</command> converts a color
+<acronym>TIFF</acronym> image to grayscale.</para></sect3>
+<sect3><title>tiff2pdf</title>
+<para><command>tiff2pdf</command> converts a <acronym>TIFF</acronym>
+image to a <acronym>PDF</acronym> document.</para></sect3>
+<sect3><title>tiff2ps</title>
+<para><command>tiff2ps</command> converts a <acronym>TIFF</acronym>
+image to a PostScript file.</para></sect3>
+<sect3><title>tiff2rgba</title>
+<para><command>tiff2rgba</command> converts a wide variety of
+<acronym>TIFF</acronym> images into an <acronym>RGBA</acronym>
+<acronym>TIFF</acronym> image.</para></sect3>
+<sect3><title>tiffcmp</title>
+<para><command>tiffcmp</command> compares two <acronym>TIFF</acronym>
+files.</para></sect3>
+<sect3><title>tiffcp</title>
+<para><command>tiffcp</command> copies (and possibly converts) a
+<acronym>TIFF</acronym> file.</para></sect3>
+<sect3><title>tiffdither</title>
+<para><command>tiffdither</command> converts a grayscale image to
+bilevel using dithering.</para></sect3>
+<sect3><title>tiffdump</title>
+<para><command>tiffdump</command> prints verbatim information about
+<acronym>TIFF</acronym> files.</para></sect3>
+<sect3><title>tiffinfo</title>
+<para><command>tiffinfo</command> prints information about
+<acronym>TIFF</acronym> files.</para></sect3>
+<sect3><title>tiffmedian</title>
+<para><command>tiffmedian</command> applies the median cut algorithm to
+data in a <acronym>TIFF</acronym> file.</para></sect3>
+<sect3><title>tiffsplit</title>
+<para><command>tiffsplit</command> splits a multi-image
+<acronym>TIFF</acronym> into single-image <acronym>TIFF</acronym>
+files.</para></sect3>
+<sect3><title>tiff libraries</title>
+<para>The tiff libraries are used by many programs to read and write
+tiff files.</para></sect3>
+</sect2>
 </sect1>

general/graphlib/libungif.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY libungif-download-http "http://ftp.sunfreeware.com/ftp/pub/freeware/SOURCES/libungif-&libungif-version;.tar.gz">
+<!ENTITY libungif-download-ftp "ftp://sunfreeware.secsup.org/pub/solaris/freeware/SOURCES/libungif-&libungif-version;.tar.gz">
+<!ENTITY libungif-size "343 KB">
+<!ENTITY libungif-buildsize "3.1 MB">
+<!ENTITY libungif-time "0.11 SBU">
+]>
 <sect1 id="libungif" xreflabel="libungif-&libungif-version;">
 <?dbhtml filename="libungif.html"?>
 <title>libungif-&libungif-version;</title>
+&libungif-intro;
+&libungif-inst;
+&libungif-desc;
+<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
+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
+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>
+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>
+<listitem><para>Download (FTP): <ulink url="&libungif-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &libungif-size;</para></listitem>
+<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>
+</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;
+./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>,
+<command>gifburst</command>, <command>gifclip</command>,
+<command>gifclrmp</command>, <command>gifcolor</command>,
+<command>gifcomb</command>, <command>gifcompose</command>,
+<command>giffiltr</command>, <command>giffix</command>,
+<command>gifflip</command>, <command>gifhisto</command>,
+<command>gifinfo</command>, <command>gifinter</command>,
+<command>gifinto</command>, <command>gifovly</command>,
+<command>gifpos</command>, <command>gifrotat</command>,
+<command>gifrsize</command>, <command>gifspnge</command>,
+<command>giftext</command>, <command>gifwedge</command>,
+<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>
+<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>
+<sect3><title>giffix</title>
+<para>Clumsily attempts to fix truncated <acronym>GIF</acronym> images.</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>
+<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>
+<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>

general/graphlib/svgalib.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY SVGAlib-download-http "http://www.svgalib.org/svgalib-&SVGAlib-version;.tar.gz">
+<!ENTITY SVGAlib-download-ftp " ">
+<!ENTITY SVGAlib-size "827 KB">
+<!ENTITY SVGAlib-buildsize "9.7 MB">
+<!ENTITY SVGAlib-time "0.20 SBU">
+]>
 <sect1 id="SVGAlib" xreflabel="SVGAlib-&SVGAlib-version;">
 <?dbhtml filename="SVGAlib.html"?>
 <title>SVGAlib-&SVGAlib-version;</title>
+&SVGAlib-intro;
+&SVGAlib-inst;
+&SVGAlib-exp;
+&SVGAlib-config;
+&SVGAlib-desc;
+<sect2>
+<title>Introduction to <application>SVGAlib</application></title>
+<para><application>SVGAlib</application> is a low-level graphics library
+that provides <acronym>VGA</acronym> and <acronym>SVGA</acronym>
+modes in a console. This is useful for programs running on a console
+that require graphics capabilities.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&SVGAlib-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&SVGAlib-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &SVGAlib-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &SVGAlib-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &SVGAlib-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&patch-root;/svgalib-1.4.3-gcc3-1.patch"/></para></listitem>
+</itemizedlist></sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>SVGAlib</application></title>
+<note><para>You must compile and install as root. If you don't, certain tools
+won't be able to become <acronym>SUID</acronym> root which is required for
+proper operation. However, this raises a risk of exposing your system to any
+holes in those tools that might be used to gain root access, so use with
+caution.</para></note>
+<para>Install <application>SVGAlib</application> by running the following commands:</para>
+<screen><userinput><command>patch -Np1 -i ../svgalib-1.4.3-gcc3-1.patch &amp;&amp;
+make prefix=/usr install &amp;&amp;
+cd doc &amp;&amp;
+for dir in man?; do for file in $dir/*; do \
+gunzip /usr/share/man/$file; done; done</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><command>cd doc &amp;&amp; for dir in man?; do for file in $dir/*; do
+gunzip /usr/share/man/$file; done; done</command>:
+<application>SVGAlib</application> installs its man pages in compressed format
+so we uncompress them.</para>
+</sect2>
+<sect2>
+<title>Configuring SVGAlib</title>
+<sect3><title>Config files</title>
+<para><filename>/etc/vga/libvga.config</filename>, <filename>~/.svgalibrc</filename></para>
+</sect3>
+<sect3><title>Configuration information</title>
+<para>You must edit the config file to set the monitor and mouse type.
+Depending on your hardware, other setup might be required.</para>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The SVGAlib package contains <filename class="libraryfile">libvga</filename>
+and <filename class="libraryfile">libvgagl</filename> libraries,
+<command>dumpreg</command>, <command>mode3</command>, <command>restorefont</command>,
+<command>restorepalette</command>, <command>restoretextmode</command>,
+<command>savetextmode</command>, <command>textmode</command> and
+<command>svgakeymap</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>libvga library</title>
+<para><filename class="libraryfile">libvga</filename> is a low-level
+graphics library.</para></sect3>
+<sect3><title>libvgagl library</title>
+<para><filename class="libraryfile">libvgagl</filename> is a fast
+frame buffer level graphics library based on libvga.</para></sect3>
+<sect3><title>dumpreg</title>
+<para><command>dumpreg</command> dumps the state of the card as the
+svgalib chipset driver sees it.</para></sect3>
+<sect3><title>mode3</title>
+<para><command>mode3</command> sets a <acronym>VESA</acronym> mode.</para></sect3>
+<sect3><title>restorefont</title>
+<para><command>restorefont</command> saves or restores the
+<acronym>SVGA</acronym> font for textmode.</para></sect3>
+<sect3><title>restorepalette</title>
+<para><command>restorepalette</command> sets the color palette for
+textmode.</para></sect3>
+<sect3><title>restoretextmode</title>
+<para><command>restoretextmode</command> saves or restores the
+<acronym>SVGA</acronym> registers for textmode.</para></sect3>
+<sect3><title>savetextmode, textmode</title>
+<para><command>savetextmode</command> and <command>textmode</command> save or
+restore the complete <acronym>SVGA</acronym> status for textmode.</para></sect3>
+<sect3><title>svgakeymap</title>
+<para><command>svgakeymap</command> generates keymaps for svgalib.</para></sect3>
+</sect2>
 </sect1>

general/prog/gcc.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+  <!ENTITY gcc-download-http  "http://mirrors.rcn.net/pub/sourceware/gcc/releases/gcc-&gcc-version;/gcc-&gcc-version;.tar.bz2">
+  <!ENTITY gcc-download-ftp   "ftp://mirrors.rcn.net/pub/sourceware/gcc/releases/gcc-&gcc-version;/gcc-&gcc-version;.tar.bz2">
+  <!ENTITY gcc-size           "23 MB">
+  <!ENTITY gcc-buildsize      "889 MB">
+  <!ENTITY gcc-time           "29.3 SBU">
+  <!ENTITY gnat-download-http " ">
+  <!ENTITY gnat-download-ftp  "ftp://cs.nyu.edu/pub/gnat/3.15p/gnat-3.15p-i686-pc-redhat71-gnu-bin.tar.gz">
+  <!ENTITY gnat-size          "13.2 MB">
+  <!ENTITY gnat-buildsize     "48.9 MB">
+  <!ENTITY gnat-time          "0.01 SBU">
+]>
 <sect1 id="gcc" xreflabel="GCC-&gcc-version;">
 <?dbhtml filename="gcc.html" ?>
 <title>GCC-&gcc-version;</title>
+&gcc-intro;
+&gcc-inst;
+&gcc-exp;
+&gcc-desc;
+<sect2>
+<title>Introduction to <application><acronym>GCC</acronym></application></title>
+<para>The  <application><acronym>GCC</acronym></application> package
+contains <acronym>GNU</acronym> compilers. This is useful for
+compiling programs written in <application>Ada</application>,
+<application>C</application>, <application>C++</application>,
+<application>Fortran</application>, <application>Java</application> and
+<application>Objective C</application>.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&gcc-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&gcc-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &gcc-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&gcc-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&gcc-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional Downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Required patch: <ulink url="&patch-root;/gcc-&gcc-version;-no_fixincludes-1.patch"/></para></listitem>
+</itemizedlist></sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>GCC</acronym></application></title>
+<para>If you plan to compile Ada, you will need to install
+<application><acronym>GNAT</acronym></application> temporarily to
+satisfy the circular dependency when you recompile
+<application><acronym>
+GCC</acronym></application> to include
+<application>Ada</application>.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&gnat-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&gnat-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &gnat-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&gnat-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&gnat-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application><acronym>GNAT</acronym></application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="tcsh"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>GNAT</acronym></application></title>
+<para>Install <application><acronym>GNAT</acronym></application> by running the
+following commands:</para>
+<screen><userinput><command>./doconfig</command></userinput></screen>
+<para>The above script will ask you how and where you would like to install
+<application><acronym>GNAT</acronym></application>. To avoid conflicts with the
+system <command>gcc</command>, the package will be installed in a separate
+directory, that can later be removed from the system.</para>
+<para>In response to the questions asked by the
+<command>doconfig</command> script, enter
+<userinput>3</userinput> in response to the first question
+and <userinput>/opt/gnat</userinput> in response to the
+second question.</para>
+<para>To finish the install, run:</para>
+<screen><userinput><command>./doinstall</command></userinput></screen>
+<para>The <application><acronym>GNAT</acronym></application> compiler can be
+invoked by executing the <command>gcc</command> binary installed by the above
+script.</para>
+</sect2>
+<sect2><title>Return to Installation of <application><acronym>GCC</acronym></application></title>
+<para>Patch the source files with the following command:</para>
+<screen><userinput><command>patch -Np1 -i ../gcc-&gcc-version;-no_fixincludes-1.patch &amp;&amp;
+sed -i 's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in</command></userinput></screen>
+<para>Install <application><acronym>GCC</acronym></application> by running the
+following commands:</para>
+<screen><userinput><command>PATH_HOLD=$PATH &amp;&amp;
+export PATH=/opt/gnat/bin:$PATH &amp;&amp;
+cd gcc/ada &amp;&amp;
+touch treeprs.ads [es]info.h nmake.ad[bs] &amp;&amp;
+cd ../.. &amp;&amp;
+mkdir ../gcc-build &amp;&amp;
+cd ../gcc-build &amp;&amp;
+CC=/usr/bin/gcc ../gcc-&gcc-version;/configure --prefix=/usr --enable-shared \
+    --enable-languages=c,c++,objc,f77,ada,java --enable-threads=posix \
+    --enable-__cxa_atexit --enable-clocale=gnu &amp;&amp;
+make bootstrap &amp;&amp;
+make -C gcc gnatlib_and_tools &amp;&amp;
+make -k check &amp;&amp;
+make install &amp;&amp;
+ln -sf ../usr/bin/cpp /lib &amp;&amp;
+ln -sf gcc /usr/bin/cc &amp;&amp;
+ln -sf g77 /usr/bin/f77 &amp;&amp;
+export PATH=$PATH_HOLD</command></userinput></screen>
+<para>You may remove the <application><acronym>GNAT</acronym></application>
+installation:</para>
+<screen><userinput><command>rm -rf /opt/gnat</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><command>PATH_HOLD=$PATH</command>: This command
+stores your current path before it's modified so that it can be restored after
+installation.</para>
+<para><command>export PATH=/opt/gnat/bin:$PATH</command>: This
+command allows the build to find
+<application><acronym>GNAT</acronym></application>'s
+<application>Ada</application> compiler to build
+<application>Ada</application>.</para>
+<para><command>touch treeprs.ads [es]info.h nmake.ad[bs]</command>:
+This command creates necessary files for the
+<application>Ada</application> build. This step
+may be skipped if you don't want to compile the
+<application>Ada</application> front end.</para>
+<para><parameter>CC=/usr/bin/gcc</parameter>: This command works around the
+new <envar>PATH</envar> which puts <application><acronym>GNAT</acronym>
+</application>'s <command>gcc</command> as the primary compiler.</para>
+<para><parameter>--enable-languages=c,c++,objc,f77,ada,java</parameter>: This command builds all available languages in the
+<application><acronym>GCC</acronym></application> package.
+You may modify this command to remove unwanted languages.</para>
+<para><parameter>--enable-shared --enable-threads=posix
+--enable-__cxa_atexit</parameter>: These commands are required to build
+the <application>C++</application> libraries to published standards.</para>
+<para><parameter>--enable-clocale=gnu</parameter>: This command is a
+failsafe for incomplete locale data.</para>
+<para><command>make gnatlib_and tools</command>: This command
+completes the <application>Ada</application> build process. Skip this step if
+you have not enabled <application>Ada</application> as one of the languages.
+</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application><acronym>GCC</acronym></application> package contains
+<command>c++</command>,
+<command>c++filt</command>, <command>cpp</command>,
+<command>g++</command>, <command>g77</command>,
+<command>gcc</command>, <command>gccbug</command>,
+<command>gcov</command>, <command>glob</command>,
+<command>gnat</command>, <command>gnatbind</command>,
+<command>gnatbl</command>, <command>gnatchop</command>,
+<command>gnatfind</command>, <command>gnatkr</command>,
+<command>gnatlink</command>, <command>gnatls</command>,
+<command>gnatmake</command>, <command>gnatprep</command>,
+<command>gnatpsta</command>, <command>gnatpsys</command>,
+<command>gnatxref</command> and
+<application><acronym>GCC</acronym></application> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<para>The programs and libraries whose descriptions are missing here
+have been described in the <acronym>LFS</acronym>
+<acronym>GCC</acronym>-&gcc-version; page.</para>
+<sect3><title>g77</title>
+<para><command>g77</command> is the <application>Fortran</application> compiler
+invoked by <command>gcc</command>.</para></sect3>
+<sect3><title>add2line</title>
+<para><command>add2line</command> converts the <acronym>ASCII</acronym> form of
+the 2-line orbital elements in a file to binary form and appends them to the
+orbdata files. </para></sect3>
+<sect3><title>gcov</title>
+<para><command>gcov</command> is a test coverage program.</para></sect3>
+<sect3><title>gdb</title>
+<para><command>gdb</command> is the
+<application><acronym>GNAT</acronym></application> debugger.</para></sect3>
+<sect3><title>gnatbind</title>
+<para><command>gnatbind</command> is used to bind compiled objects.</para>
+</sect3>
+<sect3><title>gnatbl</title>
+<para><command>gnatbl</command> is the <application>Ada</application> linker.
+</para></sect3>
+<sect3><title>gnatchop</title>
+<para><command>gnatchop</command> is useful for renaming files to meet the
+standard <application>Ada</application> default file naming conventions.</para></sect3>
+<sect3><title>gnatelim</title>
+<para><command>gnatelim</command> is used to detect and eliminate unused
+subprograms in an <application>Ada</application> partition.</para></sect3>
+<sect3><title>gnatfind</title>
+<para><command>gnatfind</command> is the <application><acronym>GNAT</acronym>
+</application> definition/use finder.</para></sect3>
+<sect3><title>gnatgcc</title>
+<para><command>gnatgcc</command> is the compiler.</para></sect3>
+<sect3><title>gnathtml.pl</title>
+<para><command>gnathtml.pl</command> converts
+<application>Ada</application> source files to <acronym>HTML</acronym> for
+viewing in Web browsers.</para></sect3>
+<sect3><title>gnatkr</title>
+<para><command>gnatkr</command> is used to determine the crunched name for a
+given file, when crunched to a specified maximum length.</para></sect3>
+<sect3><title>gnatlink</title>
+<para><command>gnatlink</command> is used to link programs and build an
+executable file.</para></sect3>
+<sect3><title>gnatls</title>
+<para><command>gnatls</command> is the compiled unit browser.</para></sect3>
+<sect3><title>gnatemake</title>
+<para><command>gnatmake</command> is an automatic make facility.</para></sect3>
+<sect3><title>gnatmem</title>
+<para><command>gnatmem</command> is the <application><acronym>GNAT</acronym>
+</application> utility that monitors dynamic allocation and
+deallocation activity in a program.</para></sect3>
+<sect3><title>gnatprep</title>
+<para><command>gnatprep</command> is the
+<application><acronym>GNAT</acronym></application> external preprocessor.</para>
+</sect3>
+<sect3><title>gnatpsta</title>
+<para><command>gnatpsta</command> determines the values of all the relevant
+parameters in Standard and outputs to stdout.</para></sect3>
+<sect3><title>gnatpsys</title>
+<para><command>gnatpsys</command> determines the values of all the relevant
+parameters in System and outputs to stdout.</para></sect3>
+<sect3><title>gnatstub</title>
+<para><command>gnatstub</command> is a generator of body stubs.</para></sect3>
+<sect3><title>gnatxref</title>
+<para><command>gnatxref</command> is the <application><acronym>GNAT</acronym></application> cross-referencer.</para></sect3>
+<sect3><title>gvd</title>
+<para><command>gvd</command> is the <acronym>GNU</acronym> Visual Debugger.
+</para></sect3>
+</sect2>
 </sect1>

general/prog/gcc2.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+  <!ENTITY gcc2-download-http "http://ftp.gnu.org/gnu/gcc/gcc-&gcc2-version;.tar.gz">
+  <!ENTITY gcc2-download-ftp  "ftp://ftp.gnu.org/gnu/gcc/gcc-&gcc2-version;.tar.gz">
+  <!ENTITY gcc2-size          "9.4 MB">
+  <!ENTITY gcc2-buildsize     "150 MB">
+  <!ENTITY gcc2-time          "2.60 SBU">
+]>
 <sect1 id="gcc2" xreflabel="GCC-&gcc2-version;">
 <?dbhtml filename="gcc2.html" ?>
 <title>GCC-&gcc2-version;</title>
+&gcc2-intro;
+&gcc2-inst;
+&gcc2-config;
+&gcc2-desc;
+<sect2>
+<title>Introduction to <application><acronym>GCC</acronym></application>-&gcc2-version;</title>
+<para>There are two reasons for installing
+<acronym>GCC</acronym>-&gcc2-version;. The first is that the kernel
+developers have certified <acronym>GCC</acronym>-&gcc2-version; as the
+preferred compiler for compiling the kernel. The other (and more compelling
+reason) is that some commercial closed-source packages (such as Netscape
+Navigator, Yahoo Pager) and precompiled packages (such as Mozilla)
+are linked against <acronym>GCC</acronym>-&gcc2-version; libs.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&gcc2-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&gcc2-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &gcc2-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&gcc2-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&gcc2-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para><ulink url="&patch-root;/gcc-2.95.3-2.patch"/></para></listitem>
+<listitem><para><ulink url="&patch-root;/gcc-2.95.3-no-fixinc.patch"/></para></listitem>
+<listitem><para><ulink url="&patch-root;/gcc-2.95.3-returntype-fix.patch"/></para></listitem>
+</itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Configuring <application><acronym>GCC</acronym></application></title>
+<sect3><title>Configuration Information</title>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
+<para>The instructions given above make compatibility symlinks that pre-compiled
+packages in <acronym>BLFS</acronym> require. You may create additional
+compatibility links based on your requirements.</para>
+<para>If you only need the GCC-&gcc2-version; libraries, you may delete
+<filename>/opt/gcc-&gcc2-version;</filename>.</para>
+<para>Whenever you need to use GCC-&gcc2-version; instead of your system
+installed compiler, add
+<filename class="directory">/opt/gcc-&gcc2-version;/bin</filename> to the front of your <envar>PATH</envar> or (preferably) set the <envar>CC</envar>
+environment variable before compiling the concerned package.</para>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The GCC-&gcc2-version; package contains the
+<command>gcc</command>-&gcc2-version; <application>C</application> and
+<application>C++</application> compilers and GCC-&gcc2-version;
+<filename>libstdc++.so</filename> that is required by some commercial and
+pre-compiled packages.</para>
+</sect2>
 </sect1>

general/prog/j2sdk.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+  <!ENTITY j2sdk-download-http "http://freshmeat.net/projects/sunjdk">
+  <!ENTITY j2sdk-download-ftp  " ">
+  <!ENTITY j2sdk-bin-size      "35 MB">
+  <!ENTITY j2sdk-src-size      "77 MB">
+  <!ENTITY j2sdk-src-buildsize "1810 MB">
+  <!ENTITY j2sdk-time          "85 SBU">
+]>
 <sect1 id="j2sdk" xreflabel="J2SDK-&j2sdk-src-version;">
 <?dbhtml filename="j2sdk.html" ?>
 <title>J2SDK-&j2sdk-src-version;</title>
+&j2sdk-intro;
+&j2sdk-inst;
+&j2sdk-exp;
+&j2sdk-config;
+&j2sdk-desc;
+<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
+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
+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
+</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
+url="&j2sdk-download-http;"/></para></listitem>
+<!--
+<listitem><para>Download (FTP): <ulink
+url="&j2sdk-download-ftp;"/></para></listitem>
+-->
+<listitem><para>Version used (binary):
+&j2sdk-bin-version;</para></listitem>
+<listitem><para>Download size (binary): &j2sdk-bin-size;</para></listitem>
+<listitem><para>Download size (source): &j2sdk-src-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&j2sdk-src-buildsize;</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-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>
+</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></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;
+sed -i "s:^PATH=.*::" j2sdk-${V}-linux-i?86.bin &amp;&amp;
+chmod +x j2sdk-${V}-linux-i?86.bin &amp;&amp;
+mkdir -p bin &amp;&amp;
+ln -sf /bin/true bin/more &amp;&amp;
+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>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
+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;
+unset CLASSPATH
+unset CFLAGS
+unset CXXFLAGS
+unset LDFLAGS
+export ALT_DEVTOOLS_PATH="/usr/bin" &amp;&amp;
+export BUILD_NUMBER="blfs-`date +%s`" &amp;&amp;
+export DEV_ONLY=true &amp;&amp;
+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>
+<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>
+<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
+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>
+<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>
+<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>
+<para><command>unset JAVA_HOME</command>: This clears the
+<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>
+<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
+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
+  CLASSPATH=.:$AUTO_CLASSPATH_DIR
+else
+  CLASSPATH=$CLASSPATH:.:$AUTO_CLASSPATH_DIR
+fi
+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>,
+<command>jar</command>, <command>jarsigner</command>,
+<command>java</command>, <command>javac</command>,
+<command>javadoc</command>, <command>javah</command>,
+<command>javap</command>, <command>jdb</command>,
+<command>keytool</command>, <command>native2ascii</command>,
+<command>orbd</command>, <command>policytool</command>,
+<command>rmic</command>, <command>rmid</command>,
+<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>
+<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>
+<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>
+<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>
+<sect3><title>tnameserv</title>
+<para><command>tnameserv</command> starts the <application>Java</application>
+<acronym>IDL</acronym> name server.</para></sect3>
+</sect2>
 </sect1>

general/prog/librep.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY librep-download-http "http://prdownloads.sourceforge.net/librep/librep-&librep-version;.tar.gz">
+<!ENTITY librep-download-ftp " ">
+<!ENTITY librep-size "1.2 MB">
+<!ENTITY librep-buildsize "11 MB">
+<!ENTITY librep-time "0.64 SBU">
+]>
 <sect1 id="librep" xreflabel="librep-&librep-version;">
 <?dbhtml filename="librep.html" ?>
 <title>librep-&librep-version;</title>
+&librep-intro;
+&librep-inst;
+&librep-exp;
+&librep-desc;
+<sect2>
+<title>Introduction to <application>librep</application></title>
+<para>The <application>librep</application> package contains a Lisp system.
+This is useful for scripting or for applications that may use the Lisp
+interpreter as an extension language.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&librep-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&librep-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &librep-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&librep-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&librep-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>librep</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="gdbm"/></para></sect4>
+<sect4><title>Optional</title>
+<para><xref linkend="gmp"/>, and <xref linkend="readline"/></para></sect4>
+<!--
+<ulink url="http://sources.redhat.com/libffi/">libffi</ulink>
+-->
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>librep</application></title>
+<para>Install <application>librep</application> by running the following
+commands:</para>
+<screen><userinput><command>./configure --prefix=/usr --libexecdir=/usr/lib &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><parameter>--libexecdir=/usr/lib</parameter>: This command installs
+files to <filename class="directory">/usr/lib/rep</filename> instead of
+<filename class="directory">/usr/libexec/rep</filename>.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>librep</application> package contains
+<command>rep</command>,
+<command>rep-config</command>,
+<command>rep-remote</command>,
+<command>rep-xgettext</command>,
+<command>repdoc</command> and
+<filename class="libraryfile">librep</filename> libraries.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>rep</title>
+<para><command>rep</command> is the Lisp interpreter.</para></sect3>
+<sect3><title>librep libraries</title>
+<para><filename class="libraryfile">librep</filename> libraries contain
+the functions necessary for the Lisp interpreter.</para></sect3>
+</sect2>
 </sect1>

general/prog/nasm.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY NASM-download-http "http://prdownloads.sourceforge.net/nasm/nasm-&NASM-version;.tar.bz2">
+<!ENTITY NASM-download-ftp " ">
+<!ENTITY NASM-size "536 KB">
+<!ENTITY NASM-buildsize "6.3 MB">
+<!ENTITY NASM-time "0.14 SBU">
+]>
 <sect1 id="NASM" xreflabel="NASM-&NASM-version;">
 <?dbhtml filename="NASM.html" ?>
 <title>NASM-&NASM-version;</title>
+&NASM-intro;
+&NASM-inst;
+&NASM-desc;
+<sect2>
+<title>Introduction to <application><acronym>NASM</acronym></application></title>
+<para><application><acronym>NASM</acronym></application> (Netwide Assembler) is
+an 80x86 assembler designed for portability and modularity. It includes a
+disassembler as well.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&NASM-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&NASM-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &NASM-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &NASM-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &NASM-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>NASM</acronym></application></title>
+<para>Install <application><acronym>NASM</acronym></application> by running thefollowing commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application><acronym>NASM</acronym></application> package contains <command>nasm
+</command> and <command>ndisasm</command> programs.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>nasm</title>
+<para><command>nasm</command> is a portable 80x86 assembler.</para></sect3>
+<sect3><title>ndisasm</title>
+<para><command>ndisasm</command> is an 80x86 binary file disassembler.</para></sect3>
+</sect2>
 </sect1>

general/prog/perl-modules.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY Gtk-Perl-version          "0.7009">
+<!ENTITY PDL-version               "2.4.0">
+<!ENTITY XML-Parser-version        "2.34">
+<!ENTITY XML-Writer-version        "0.4.1">
+<!ENTITY Astro-FITS-Header-version "2.8.1">
+<!ENTITY Parse-RecDescent-version  "1.94">
+]>
 <sect1 id="perl-modules" xreflabel="Perl modules">
 <?dbhtml filename="perl-modules.html" ?>
 <title>Perl modules</title>
+&perl-modules-intro;
+&perl-modules-inst;
+<sect2>
+<title>Introduction to <application>Perl</application> modules</title>
+<para>The <application>Perl</application> module packages add useful objects
+to the <application>Perl</application> language.  Modules utilized by packages
+throughout <acronym>BLFS</acronym> are listed here, along with their
+dependencies.</para>
+<sect3><title>Perl Packages</title>
+<itemizedlist spacing='compact'>
+<listitem><para><ulink
+url="http://search.cpan.org/CPAN/authors/id/C/CS/CSOE/PDL-&PDL-version;.tar.gz">PDL-&PDL-version;</ulink></para><itemizedlist spacing='compact'>
+<listitem><para><ulink
+url="http://search.cpan.org/CPAN/authors/id/A/AA/AALLAN/Astro-FITS-Header-&Astro-FITS-Header-version;.tar.gz">Astro-FITS-Header-&Astro-FITS-Header-version;</ulink></para></listitem></itemizedlist></listitem>
+<listitem><para><ulink
+url="http://search.cpan.org/CPAN/authors/id/M/ML/MLEHMANN/Gtk-Perl-&Gtk-Perl-version;.tar.gz">Gtk-Perl-&Gtk-Perl-version;</ulink></para><itemizedlist spacing='compact'>
+<listitem><para><ulink
+url="http://search.cpan.org/CPAN/authors/id/E/ED/EDAVIS/XML-Writer-&XML-Writer-version;.tar.gz">XML-Writer-&XML-Writer-version;</ulink></para></listitem>
+<listitem><para><ulink
+url="http://search.cpan.org/CPAN/authors/id/M/MS/MSERGEANT/XML-Parser-&XML-Parser-version;.tar.gz">XML-Parser-&XML-Parser-version;</ulink>
+</para></listitem></itemizedlist></listitem>
+<listitem><para><ulink
+url="http://search.cpan.org/CPAN/authors/id/D/DC/DCONWAY/Parse-RecDescent-&Parse-RecDescent-version;.tar.gz">Parse-RecDescent-&Parse-RecDescent-version;</ulink></para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Perl</application> modules</title>
+<para>Install <application>Perl</application> modules by running the following
+commands:</para>
+<screen><userinput><command>perl Makefile.PL &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+<para>The module listed below requires a modification in order to install
+successfully.</para>
+<para>Gtk-Perl-&Gtk-Perl-version;:</para>
+<screen><userinput><command>perl Makefile.PL --without-guessing &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2><title>(Alternate) Auto installation of <application>Perl</application>
+modules.</title>
+<para>There is an alternate way of installing the modules using
+<application>Perl</application>'s built-in <command>install</command> command.
+The command automatically downloads the source from the <acronym>CPAN</acronym>archive, extracts it, runs the commands mentioned above, and removes
+the build tree.</para>
+<para>Start the perl shell with the commands:</para>
+<screen><userinput><command>perl -MCPAN -e shell</command></userinput></screen>
+<para>Each module may now be installed from this shell with the command:</para>
+<screen><userinput><command>install &lt;moduleName&gt;</command></userinput></screen>
+<para>For additional commands and help, type <command>help</command>.</para>
+</sect2>
 </sect1>

general/prog/prog.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+ <!ENTITY % general-entities SYSTEM "../../general.ent">
+ %general-entities;
+]>
 <chapter id="general-prog">
 <?dbhtml filename="prog.html" ?>
 …
 system's development capabilities.</para>
+&Python;
+&perl-modules;
+&librep;
+&j2sdk;
+&ruby;
+&gcc;
+&tcl;
+&tk;
+&gcc2;
+&NASM;
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="python.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="perl-modules.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="librep.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="j2sdk.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ruby.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tcl.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="tk.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gcc2.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="nasm.xml"/>
 </chapter>

general/prog/python.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY Python-download-http "http://www.python.org/ftp/python/&Python-version;/Python-&Python-version;.tar.bz2">
+<!ENTITY Python-download-ftp "ftp://ftp.python.org/pub/python/&Python-version;/Python-&Python-version;.tar.bz2">
+<!ENTITY Python-size "6.9 MB">
+<!ENTITY Python-buildsize "69 MB">
+<!ENTITY Python-time "1.25 SBU">
+]>
 <sect1 id="Python" xreflabel="Python-&Python-version;">
 <?dbhtml filename="Python.html" ?>
 <title>Python-&Python-version;</title>
+&Python-intro;
+&Python-inst;
+&Python-desc;
+<sect2>
+<title>Introduction to <application>Python</application></title>
+<para>The <application>Python</application> package contains the
+<application>Python</application> development environment.
+This is useful for object-oriented programming, writing scripts,
+prototyping large programs or developing entire applications.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&Python-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&Python-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &Python-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &Python-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &Python-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Required patch (HTTP): <ulink
+url="&patch-root;/Python-&Python-version;-gdbm-2.patch"/></para></listitem>
+</itemizedlist>
+</sect3>
+<sect3><title><application>Python</application> dependencies</title>
+<sect4><title>Optional</title>
+<para><xref linkend="expat"/>, <xref linkend="tk"/>, <xref
+linkend="gdbm"/>, <xref linkend="db"/>, <xref linkend="gmp"/> and
+<xref linkend="readline"/>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Python</application></title>
+<para>Install <application>Python</application> by running the following commands:</para>
+<screen><userinput><command>patch -Np1 -i ../Python-&Python-version;-gdbm-2.patch &amp;&amp;
+./configure --prefix=/usr --enable-shared &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>Python</application> package contains <command>python</command> and
+<command>pydoc</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>python</title>
+<para><command>python</command> is an interpreted, interactive, object-oriented programming
+language.</para></sect3>
+<sect3><title>pydoc</title>
+<para><command>pydoc</command> is the <application>Python</application> documentation tool.</para></sect3>
+</sect2>
 </sect1>

general/prog/ruby.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY ruby-download-http "http://rubyforge.org/download.php/262/ruby-&ruby-version;.tar.gz">
+<!ENTITY ruby-download-ftp " ">
+<!ENTITY ruby-size "2.6 MB">
+<!ENTITY ruby-buildsize "31 MB">
+<!ENTITY ruby-time "0.71 SBU">
+]>
 <sect1 id="ruby" xreflabel="Ruby-&ruby-version;">
 <?dbhtml filename="ruby.html"?>
 <title>Ruby-&ruby-version;</title>
+&ruby-intro;
+&ruby-inst;
+&ruby-desc;
+<sect2>
+<title>Introduction to <application>Ruby</application></title>
+<para>The <application>Ruby</application> package contains the
+<application>Ruby</application> development environment. This
+is useful for object-oriented scripting.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&ruby-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&ruby-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &ruby-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &ruby-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &ruby-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Ruby</application></title>
+<para>Install <application>Ruby</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>Ruby</application> package contains
+<command>ruby</command>,
+<command>irb</command>,
+<command>erb</command>,
+<command>rdoc</command>,
+<command>ri</command> and
+<command>testrb</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>ruby</title>
+<para><command>ruby</command> is an interpreted scripting language for quick
+and easy object-oriented programming.</para></sect3>
+<sect3><title>irb</title>
+<para><command>irb</command> is the interactive interface for ruby.</para>
+</sect3>
+</sect2>
 </sect1>

general/prog/tcl.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY tcl-download-http "http://prdownloads.sourceforge.net/tcl/tcl&tcl-version;-src.tar.gz">
+<!ENTITY tcl-download-ftp "ftp://ftp.us.xemacs.org/pub/tcl/tcl8_4/tcl&tcl-version;-src.tar.gz">
+<!ENTITY tcl-size "3.3 MB">
+<!ENTITY tcl-buildsize "17.1 MB">
+<!ENTITY tcl-time "0.27 SBU">
+]>
 <sect1 id="tcl" xreflabel="Tcl-&tcl-version;">
 <?dbhtml filename="tcl.html"?>
 <title>Tcl-&tcl-version;</title>
+&tcl-intro;
+&tcl-inst;
+&tcl-exp;
+<sect2>
+<title>Introduction to <application>Tcl</application></title>
+<para>The <application>Tcl</application> package contains Tool Command Language.  </para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&tcl-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&tcl-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &tcl-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&tcl-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&tcl-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Tcl</application></title>
+<note><para>This package is also installed in <acronym>LFS</acronym>
+during the bootstrap phase. The significant difference between the
+two installations (other than installing to <filename class="directory">/usr</filename>) is to install
+the package in such a way that there is no need to keep the build
+directory around after installation.</para></note>
+<para>Install <application>Tcl</application> by running the following commands:</para>
+<screen><userinput><command>VERSION=&tcl-version; &amp;&amp;
+V=`echo $VERSION | cut -d "." -f 1,2` &amp;&amp;
+DIR=$PWD &amp;&amp;
+cd unix &amp;&amp;
+./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+sed -i "s:${DIR}/unix:/usr/lib:" tclConfig.sh &amp;&amp;
+sed -i "s:${DIR}:/usr/include/tcl${V}:" tclConfig.sh &amp;&amp;
+sed -i "s,^TCL_LIB_FILE='libtcl${V}..TCL_DBGX..so',TCL_LIB_FILE=\"libtcl${V}\$\{TCL_DBGX\}.so\"," \
+    tclConfig.sh &amp;&amp;
+mv ../doc/{,Tcl_}Thread.3 &amp;&amp;
+sed -i 's/ Thread.3/ Tcl_Thread.3/' mkLinks &amp;&amp;
+make install &amp;&amp;
+install -d /usr/include/tcl${V}/unix &amp;&amp;
+install -m644 *.h /usr/include/tcl${V}/unix/ &amp;&amp;
+install -d /usr/include/tcl${V}/generic &amp;&amp;
+install -c -m644 ../generic/*.h /usr/include/tcl${V}/generic/ &amp;&amp;
+rm -f /usr/include/tcl${V}/generic/{tcl,tclDecls,tclPlatDecls}.h &amp;&amp;
+ln -nsf /usr/include/tcl${V} /usr/lib/tcl${V}/include &amp;&amp;
+ln -sf libtcl${V}.so /usr/lib/libtcl.so &amp;&amp;
+ln -sf tclsh${V} /usr/bin/tclsh</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><command>sed -i ...</command>: The <application>Tcl</application>
+package assumes that the source that is used to build <application>Tcl
+</application> is always kept around for compiling packages that depend on
+<application>Tcl</application>. These <command>sed</command>'s remove the
+reference to the build directory and replace them by saner system wide
+locations.</para>
+<para><command>install ...</command>: These commands install the internal
+headers into a system-wide location.</para>
+<para><command>ln -sf ...</command>: These commands create compatibility
+symbolic links.</para>
+</sect2>
 </sect1>

general/prog/tk.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY tk-download-http "http://prdownloads.sourceforge.net/tcl/tk&tk-version;-src.tar.gz">
+<!ENTITY tk-download-ftp "ftp://ftp.us.xemacs.org/pub/tcl/tcl8_4/tk&tk-version;-src.tar.gz">
+<!ENTITY tk-size "3.1 MB">
+<!ENTITY tk-buildsize "17.4 MB">
+<!ENTITY tk-time "0.41 SBU">
+]>
 <sect1 id="tk" xreflabel="Tk-&tk-version;">
 <?dbhtml filename="tk.html"?>
 <title>Tk-&tk-version;</title>
+&tk-intro;
+&tk-inst;
+&tk-exp;
+<sect2>
+<title>Introduction to <application>Tk</application></title>
+<para>The <application>Tk</application> package contains
+<acronym>TCL</acronym> <acronym>GUI</acronym> Toolkit.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&tk-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&tk-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &tk-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&tk-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&tk-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>Tk</application> dependencies</title>
+<sect4><title>Required</title>
+<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and <xref linkend="tcl"/></para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Tk</application></title>
+<para>Install <application>Tk</application> by running the following commands:</para>
+<screen><userinput><command>VERSION=&tk-version; &amp;&amp;
+V=`echo $VERSION | cut -d "." -f 1,2` &amp;&amp;
+DIR=$PWD &amp;&amp;
+cd unix &amp;&amp;
+./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+sed -i "s:${DIR}/unix:/usr/lib:" tkConfig.sh &amp;&amp;
+sed -i "s:${DIR}:/usr/include/tk${V}:" tkConfig.sh &amp;&amp;
+make install &amp;&amp;
+install -d /usr/include/tk${V}/unix &amp;&amp;
+install -m644 *.h /usr/include/tk${V}/unix/ &amp;&amp;
+install -d /usr/include/tk${V}/generic &amp;&amp;
+install -m644 ../generic/*.h /usr/include/tk${V}/generic/ &amp;&amp;
+rm -f /usr/include/tk${V}/generic/{tk,tkDecls,tkPlatDecls}.h &amp;&amp;
+ln -nsf /usr/include/tk${V} /usr/lib/tk${V}/include &amp;&amp;
+ln -sf libtk${V}.so /usr/lib/libtk.so &amp;&amp;
+ln -sf wish${V} /usr/bin/wish</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><command>sed -i ...</command>: The <application>Tk</application> package
+assumes that the source that is used to build <application>Tk</application> is
+always kept around for compiling packages that depend on
+<application>Tk</application>. These <command>sed</command>'s remove the
+reference to the build directory and replace them by saner system wide
+locations.</para>
+<para><command>install ...</command>: These commands install the internal
+headers into a system-wide location.</para>
+<para><command>ln -sf ...</command>: These commands create compatibility
+symbolic links.</para>
+</sect2>
 </sect1>

general/sysutils/cpio.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY cpio-download-http "http://ftp.gnu.org/pub/gnu/cpio/cpio-&cpio-version;.tar.gz">
+<!ENTITY cpio-download-ftp "ftp://ftp.gnu.org/pub/gnu/cpio/cpio-&cpio-version;.tar.gz">
+<!ENTITY cpio-size "188 KB">
+<!ENTITY cpio-buildsize "1 MB">
+<!ENTITY cpio-time "0.06 SBU">
+]>
 <sect1 id="cpio" xreflabel="cpio-&cpio-version;">
 <?dbhtml filename="cpio.html"?>
 <title>cpio-&cpio-version;</title>
+&cpio-intro;
+&cpio-inst;
+&cpio-exp;
+&cpio-desc;
+<sect2>
+<title>Introduction to <application>cpio</application></title>
+<para>The <application>cpio</application> package contains
+tools for archiving.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&cpio-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&cpio-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &cpio-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&cpio-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&cpio-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>cpio</application></title>
+<para>Install <application>cpio</application> by running the following commands:
+</para>
+<screen><userinput><command>./configure --prefix=/usr --libexecdir=/tmp/cpio \
+    --bindir=/bin &amp;&amp;
+make &amp;&amp;
+make install &amp;&amp;
+rm -rf /tmp/cpio</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><parameter>--libexec=/tmp/cpio</parameter>: This command installs
+<command>rmt</command> to <filename class="directory">/tmp/cpio</filename> so
+that it can be removed. The <command>rmt</command> executable is already
+installed by the <application>tar</application> package in
+<acronym>LFS</acronym>.</para>
+<para><parameter>--bindir=/bin</parameter>: This command installs
+<command>cpio</command> to <filename class="directory">/bin</filename> instead
+of <filename class="directory">/usr/bin</filename> as per
+<acronym>FHS</acronym> guidelines.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>cpio</application> package contains <command>cpio
+</command> and <command>mt</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>cpio</title>
+<para><command>cpio</command> copies files to and from archives.</para></sect3>
+<sect3><title>mt</title>
+<para><command>mt</command> controls magnetic tape drive operations.</para></sect3>
+<!--
+<sect3><title>rmt</title>
+<para><command>rmt</command> controls remote magnetic tape drive operations.</para></sect3>
+-->
+</sect2>
 </sect1>

general/sysutils/fcron.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY fcron-download-http "http://fcron.free.fr/fcron-&fcron-version;.src.tar.gz">
+<!ENTITY fcron-download-ftp "ftp://ftp.seul.org/pub/fcron/fcron-&fcron-version;.src.tar.gz">
+<!ENTITY fcron-size "371 KB">
+<!ENTITY fcron-buildsize "2.7 MB">
+<!ENTITY fcron-time "0.10 SBU">
+]>
 <sect1 id="fcron" xreflabel="Fcron-&fcron-version;">
 <?dbhtml filename="fcron.html"?>
 <title>Fcron-&fcron-version;</title>
+&fcron-intro;
+&fcron-inst;
+&fcron-exp;
+&fcron-config;
+&fcron-desc;
+<sect2>
+<title>Introduction to <application>Fcron</application></title>
+<para>The <application>Fcron</application> package contains a periodical
+command scheduler which aims at replacing <application>Vixie
+Cron</application>.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&fcron-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&fcron-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &fcron-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &fcron-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &fcron-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application>Fcron</application> dependencies</title>
+<sect4><title>Optional</title>
+<para>
+<ulink url="../server/mail.html">MTA</ulink>,
+<xref linkend="Linux_PAM"/>,
+<ulink url="http://www.nsa.gov/selinux/">SELinux</ulink>,
+<xref linkend="openjade"/> and
+<xref linkend="docbook-dsssl"/>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Fcron</application></title>
+<para><application>Fcron</application> uses the cron facility of
+<command>syslog</command>
+to log all messages. Since <acronym>LFS</acronym> does not set up this
+facility in <filename>/etc/syslog.conf</filename>, it needs to be done
+prior to installing <application>Fcron</application>. This command will append
+the necessary line to the current <filename>/etc/syslog.conf</filename>:</para>
+<screen><userinput><command>cat &gt;&gt; /etc/syslog.conf &lt;&lt; "EOF"
+# Begin fcron addition to /etc/syslog.conf
+cron.* -/var/log/cron.log
+# End fcron addition
+EOF</command></userinput></screen>
+<para>The configuration file has been modified, so reloading the
+<command>sysklogd</command> daemon will activate the changes.</para>
+<screen><userinput><command>/etc/rc.d/init.d/sysklogd reload</command></userinput></screen>
+<para>For security reasons, we need to create an unprivileged user and
+group for <application>fcron</application>:</para>
+<screen><userinput><command>groupadd fcron &amp;&amp;
+useradd -d /dev/null -g fcron -s /bin/false fcron</command></userinput></screen>
+<para>Install <application>Fcron</application> by running the following commands:</para>
+<screen><userinput><command>./configure --without-sendmail --with-answer-all=no &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><option>--without-sendmail</option>: <application>Fcron</application>
+will use an iinstalled <acronym>MTA</acronym> to email you the results of the
+<command>fcron</command> script. If you wish to utilize this feature, change
+the switch to <parameter>--with-sendmail=<replaceable>[path to your
+MTA]</replaceable> </parameter>.</para>
+<para><parameter>--with-answer-all=no</parameter>: After the files are
+installed, the <command>make install</command> script enters into a
+configuration routine.  The first test will be whether to install a boot scriptin the <filename class="directory">/etc/rc.d/init.d</filename> directory with
+the appropriate symbolic links in run levels 2, 3, 4, and 5. The second is to
+stop any current fcron processes and start a new one. Since this is probably
+your first install and we want a boot script based upon the
+<acronym>BLFS</acronym> template, we answer 'n' to both tests.</para>
+<para><parameter>--with-dsssl-dir=/usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version;
+</parameter>: This switch can be added if you have installed
+<application>OpenJade</application> and dsssl-stylesheets to generate the
+documentation from the DocBook source files.</para>
+</sect2>
+<sect2>
+<title>Configuring <application>Fcron</application></title>
+<sect3><title>Config files</title>
+<para><filename>/etc/fcron.conf</filename>,
+<filename>/etc/fcron.allow</filename>,
+<filename>/etc/fcron.deny</filename></para>
+</sect3>
+<sect3><title>Configuration Information</title>
+<para>There are no required changes in any of the config files.
+Configuration information can be found in the man page for
+<filename>fcron.conf</filename>.</para>
+<para><command>fcron</command> scripts are written using <command>fcrontab</command>.
+Refer to the fcrontab man page for proper parameters to address your situation.</para>
+<para>Install the <filename>/etc/rc.d/init.d/fcron</filename>
+init script from the <xref linkend="intro-important-bootscripts"/> package.</para>
+<screen><userinput><command>make install-fcron</command></userinput></screen>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>Fcron</application> package contains
+<command>fcron</command>, <command>fcrontab</command>, <command>fcronsighup
+</command> and <command>fcrondyn.</command></para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>fcron</title>
+<para><command>fcron</command> is the scheduling daemon.
+</para></sect3>
+<sect3><title>fcrontab</title>
+<para><command>fcrontab</command> is the program used to install, edit, list
+and remove the tables used by <command>fcron</command>.</para></sect3>
+<sect3><title>fcronsighup</title>
+<para><command>fcronsighup</command> instructs <command>fcron</command> to
+reread the fcron tables.</para></sect3>
+<sect3><title>fcrondyn</title>
+<para><command>fcrondyn</command> is a user tool intended to interact with a
+running <command>fcron</command> daemon.</para></sect3>
+</sect2>
 </sect1>

general/sysutils/gpm.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY gpm-download-http " ">
+<!ENTITY gpm-download-ftp "ftp://arcana.linux.it/pub/gpm/gpm-&gpm-version;.tar.bz2">
+<!ENTITY gpm-size "556 KB">
+<!ENTITY gpm-buildsize "5.3 MB">
+<!ENTITY gpm-time "0.09 SBU">
+]>
 <sect1 id="gpm" xreflabel="GPM-&gpm-version;">
 <?dbhtml filename="gpm.html"?>
 <title><acronym>GPM</acronym>-&gpm-version;</title>
+&gpm-intro;
+&gpm-inst;
+&gpm-exp;
+&gpm-config;
+&gpm-desc;
+<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
+generally, but its library component is used by various software such as
+<application>Links</application> to provide mouse support to the
+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
+url="&gpm-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&gpm-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &gpm-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&gpm-buildsize;</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>
+<listitem><para>Recommended patch: <ulink
+url="&patch-root;/gpm-1.20.1-silent.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>
+<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;
+LDFLAGS="-lm" ./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
+make &amp;&amp;
+make install &amp;&amp;
+cp conf/gpm-root.conf /etc &amp;&amp;
+ldconfig -n -l /usr/lib/libgpm.so.1.19.0</command></userinput></screen>
+</sect2>
+<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
+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>
+# End /etc/sysconfig/mouse
+<command>EOF</command></userinput></screen>
+</sect3>
+<sect3><title>Configuration Information</title>
+<para>Examples of values to set <envar>MDEVICE</envar> and
+<envar>PROTOCOL</envar> to are:</para>
+<screen><userinput>MDEVICE=/dev/psaux
+PROTOCOL=imps2</userinput></screen>
+<para>A list of which protocol values are known can be found by running
+<command>gpm -t -help</command>.  Your <envar>MDEVICE</envar> setting depends on
+which type of mouse you have.  For example,
+<filename>/dev/ttyS0</filename> for a serial mouse (on Windows this is
+COM1), <filename>/dev/input/mice</filename> is often used for
+<acronym>USB</acronym> mice
+and <filename>/dev/psaux</filename> for PS2 mice.</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>
+</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>

general/sysutils/hdparm.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY hdparm-download-http "http://www.ibiblio.org/pub/Linux/system/hardware/hdparm-&hdparm-version;.tar.gz">
+<!ENTITY hdparm-download-ftp " ">
+<!ENTITY hdparm-size "33 KB">
+<!ENTITY hdparm-buildsize "257 KB">
+<!ENTITY hdparm-time "0.01 SBU">
+]>
 <sect1 id="hdparm" xreflabel="hdparm-&hdparm-version;">
 <?dbhtml filename="hdparm.html"?>
 <title>hdparm-&hdparm-version;</title>
+&hdparm-intro;
+&hdparm-inst;
+&hdparm-desc;
+<sect2>
+<title>Introduction to <application>hdparm</application></title>
+<para>The <application>hdparm</application> package contains a
+utility that is useful for controlling <acronym>ATA</acronym>/<acronym>IDE
+</acronym> controllers and hard drives both to increase
+performance and sometimes to increase stability.</para>
+<warning><para>As well as being useful, incorrect usage of
+<application>hdparm</application> can destroy your information and in
+rare cases, drives. Use with caution and make sure you know what you are
+doing. If in doubt, we recommend you leave the default kernel parameters
+alone.</para></warning>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&hdparm-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&hdparm-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &hdparm-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &hdparm-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &hdparm-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title>Additional downloads</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Required Patch: <ulink
+url="&patch-root;/hdparm-&hdparm-version;-glibc_CVS-1.patch"/></para></listitem>
+</itemizedlist></sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>hdparm</application></title>
+<para>First apply the required patch:</para>
+<screen><userinput><command>patch -Np1 -i ../hdparm-&hdparm-version;-glibc_CVS-1.patch</command></userinput></screen>
+<para>Install <application>hdparm</application> by running the following commands:</para>
+<screen><userinput><command>make &amp;&amp;
+make install</command></userinput></screen>
+<para>Note that by default, <command>hdparm</command> is installed in
+<filename class="directory">/sbin</filename> as some systems may require it
+during the boot process before <filename class="directory">/usr</filename>
+is mounted.  If you wish to install <command>hdparm</command> under the
+<filename class="directory">/usr</filename> hierarchy, then replace the above
+commands with the following:</para>
+<screen><userinput><command>make &amp;&amp;
+make binprefix=/usr install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>hdparm</application> package contains <command>hdparm</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>hdparm</title>
+<para><command>hdparm</command> provides a command-line interface to various hard disk
+ioctls supported by the stock Linux
+<acronym>ATA</acronym>/<acronym>IDE</acronym> device driver
+subsystem.</para></sect3>
+</sect2>
 </sect1>

general/sysutils/mc.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY mc-download-http "http://www.ibiblio.org/pub/Linux/utils/file/managers/mc/mc-&mc-version;.tar.gz">
+<!ENTITY mc-download-ftp "ftp://ftp.uni-koeln.de/util/shell/mc-&mc-version;.tar.gz">
+<!ENTITY mc-size "3.6 MB">
+<!ENTITY mc-buildsize "31 MB">
+<!ENTITY mc-time "0.45 SBU">
+]>
 <sect1 id="mc" xreflabel="MC-&mc-version;">
 <?dbhtml filename="mc.html"?>
 <title><acronym>MC</acronym>-&mc-version;</title>
+&mc-intro;
+&mc-inst;
+&mc-config;
+&mc-desc;
+<sect2>
+<title>Introduction to
+<application><acronym>MC</acronym></application></title>
+<para><application><acronym>MC</acronym></application>
+(Midnight Commander) is a text-mode full-screen file manager and visual
+shell. It provides a clear, user-friendly, and somewhat protected
+interface to a Unix system while making many frequent file operations
+more efficient and preserving the full power of the command
+prompt.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&mc-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&mc-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &mc-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &mc-buildsize;</para></listitem><listitem><para>Estimated build time: &mc-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application><acronym>MC</acronym></application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="GLib"/> or <xref linkend="GLib2"/>
+</para></sect4>
+<sect4><title>Optional</title>
+<para>
+<xref linkend="gpm"/>,
+X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
+<xref linkend="samba3"/>,
+<xref linkend="slang"/>,
+<xref linkend="zip"/>,
+<xref linkend="unzip"/> and
+<xref linkend="gnome-libs"/>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of
+<application><acronym>MC</acronym></application></title>
+<para>Install <application><acronym>MC</acronym></application> by
+running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Configuring <application><acronym>MC</acronym></application></title>
+<sect3><title>Config files</title>
+<para><filename>~/.mc/*</filename></para>
+</sect3>
+<sect3><title>Configuration Information</title>
+<para>The <filename class="directory">~/.mc</filename> directory and
+its contents are created when you start <command>mc</command> for the
+first time. Then you can edit the main <filename>~/.mc/ini</filename> configuration
+file manually or through the <application><acronym>MC</acronym></application> shell.
+Consult the mc(1) man page for details.</para>
+</sect3>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application><acronym>MC</acronym></application> package
+contains <command>mc</command>, <command>mcedit</command>,
+<command>mcmfmt</command> and <command>mcview</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>mc</title>
+<para><command>mc</command> is a visual shell.</para></sect3>
+<sect3><title>mcedit</title>
+<para><command>mcedit</command> is an internal file
+editor.</para></sect3>
+<sect3><title>mcview</title>
+<para><command>mcview</command> is an internal file
+viewer.</para></sect3>
+</sect2>
 </sect1>

general/sysutils/pciutils.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY pciutils-download-http "http://www.kernel.org/pub/software/utils/pciutils/pciutils-&pciutils-version;.tar.bz2">
+<!ENTITY pciutils-download-ftp "ftp://ftp.kernel.org/pub/software/utils/pciutils/pciutils-&pciutils-version;.tar.bz2">
+<!ENTITY pciutils-size "107 KB">
+<!ENTITY pciutils-buildsize "1.1 MB">
+<!ENTITY pciutils-time "0.02 SBU">
+]>
 <sect1 id="pciutils" xreflabel="PCI Utilities-&pciutils-version;">
 <?dbhtml filename="pciutils.html"?>
 <title>PCI Utilities-&pciutils-version;</title>
+&pciutils-intro;
+&pciutils-inst;
+&pciutils-desc;
+<sect2>
+<title>Introduction to <application><acronym>PCI</acronym> Utilities</application></title>
+<para>The <application><acronym>PCI</acronym> Utilities</application> package is a set of programs
+for listing <acronym>PCI</acronym> devices, inspecting their status and
+setting their configuration registers.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&pciutils-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&pciutils-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &pciutils-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &pciutils-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &pciutils-time;</para></listitem></itemizedlist>
+</sect3>
+<sect3><title><application><acronym>PCI</acronym> Utilities</application> dependencies</title>
+<sect4><title>Required</title>
+<para><xref linkend="which"/>
+</para></sect4>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application><acronym>PCI</acronym> Utilities</application></title>
+<para>Install <application><acronym>PCI</acronym> Utilities</application> by
+running the following commands:</para>
+<screen><userinput><command>make PREFIX=/usr &amp;&amp;
+make PREFIX=/usr install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application><acronym>PCI</acronym> Utilities</application> package
+contains <command>lspci</command>,
+<command>setpci</command> and <command>update-pciids</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>lspci</title>
+<para><command>lspci</command> is a utility for displaying information
+about all <acronym>PCI</acronym> buses in the system and all devices
+connected to them.</para></sect3>
+<sect3><title>setpci</title>
+<para><command>setpci</command> is a utility for querying and
+configuring <acronym>PCI</acronym> devices.</para></sect3>
+<sect3><title>update-pciids</title>
+<para><command>update-pciids</command> fetches the current version of
+the <acronym>PCI</acronym> ID list. Requires <xref
+linkend="wget"/> or <xref linkend="lynx"/></para></sect3>
+</sect2>
 </sect1>

general/sysutils/pkgconfig.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY pkgconfig-download-http "http://www.freedesktop.org/software/pkgconfig/releases/pkgconfig-&pkgconfig-version;.tar.gz">
+<!ENTITY pkgconfig-download-ftp " ">
+<!ENTITY pkgconfig-size "604 KB">
+<!ENTITY pkgconfig-buildsize "5.2 MB">
+<!ENTITY pkgconfig-time "0.22 SBU">
+]>
 <sect1 id="pkgconfig" xreflabel="pkgconfig-&pkgconfig-version;">
 <?dbhtml filename="pkgconfig.html"?>
 <title>pkgconfig-&pkgconfig-version;</title>
+&pkgconfig-intro;
+&pkgconfig-inst;
+&pkgconfig-config;
+&pkgconfig-desc;
+<sect2>
+<title>Introduction to <application>pkgconfig</application></title>
+<para>The <application>pkgconfig</application> package contains
+tools for passing the include path and/or library paths to build tools during
+the make file execution.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink url="&pkgconfig-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink url="&pkgconfig-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &pkgconfig-size;</para></listitem>
+<listitem><para>Estimated Disk space required: &pkgconfig-buildsize;</para></listitem>
+<listitem><para>Estimated build time: &pkgconfig-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>pkgconfig</application></title>
+<para>Install <application>pkgconfig</application> by running the following commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Configuring <application>pkgconfig</application></title>
+<para>The default setting for <envar>PKG_CONFIG_PATH</envar> is
+<filename>/usr/lib/pkgconfig</filename> because of the prefix we use to
+install pkgconfig.  You may add to <envar>PKG_CONFIG_PATH</envar> by exporting
+additional paths on your system where pkgconfig files are installed. Note
+that <envar>PKG_CONFIG_PATH</envar> is only needed when compiling packages,
+not during run-time.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>pkgconfig</application> package contains
+<command>pkg-config</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>pkg-config</title>
+<para><command>pkg-config</command> is a function that returns meta information for the
+specified library.</para></sect3>
+</sect2>
 </sect1>

general/sysutils/sysutils.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+ <!ENTITY % general-entities SYSTEM "../../general.ent">
+ %general-entities;
+]>
 <chapter id="general-sysutils">
 <?dbhtml filename="sysutils.html"?>
 …
 installation purposes.</para>
+&gpm;
+&fcron;
+&hdparm;
+&which;
+&unzip;
+&zip;
+&pciutils;
+&pkgconfig;
+&cpio;
+&mc;
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gpm.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fcron.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hdparm.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="which.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="unzip.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="zip.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pciutils.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pkgconfig.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="cpio.xml"/>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="mc.xml"/>
 </chapter>

general/sysutils/unzip.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY unzip-download-http "http://www.mirror.ac.uk/sites/ftp.info-zip.org/pub/infozip/src/unzip551.tar.gz">
+<!ENTITY unzip-download-ftp "ftp://ftp.info-zip.org/pub/infozip/src/unzip551.tar.gz">
+<!ENTITY unzip-size "1.1 MB">
+<!ENTITY unzip-buildsize "6.5 MB">
+<!ENTITY unzip-time "0.11 SBU">
+]>
 <sect1 id="unzip" xreflabel="UnZip-&unzip-version;">
 <?dbhtml filename="unzip.html"?>
 <title>UnZip-&unzip-version;</title>
+&unzip-intro;
+&unzip-inst;
+&unzip-exp;
+&unzip-desc;
+<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
+url="&unzip-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&unzip-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &unzip-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&unzip-buildsize;</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>
+<listitem><para>Recommended patch: <ulink
+url="&patch-root;/unzip-&unzip-version;-dont-make-noise.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;
+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
+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
+in a <filename>ZIP</filename> archive, including file access permissions,
+encryption status, type of compression, etc.</para></sect3>
+</sect2>
 </sect1>

general/sysutils/which.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+  <!ENTITY which-download-http "http://www.xs4all.nl/~carlo17/which/which-&which-version;.tar.gz">
+  <!ENTITY which-download-ftp  "ftp://ftp.gnu.org/gnu/which/which-&which-version;.tar.gz">
+  <!ENTITY which-size          "123 KB">
+  <!ENTITY which-buildsize     "940 KB">
+  <!ENTITY which-time          "0.03 SBU">
+]>
 <sect1 id="which" xreflabel="which-&which-version;">
 <?dbhtml filename="which.html"?>
 …
 <emphasis>which</emphasis>.</para>
+&which-intro;
+&which-inst;
+&which-desc;
+<sect2>
+<title>Introduction to <application>which</application></title>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&which-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&which-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &which-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&which-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&which-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2><title>The 'which' script</title>
+<sect2>
+<title>Installation of <application>which</application></title>
+<para>Install <application>which</application> by running the following
+commands:</para>
+<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
+make &amp;&amp;
+make install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>which</application> package contains <command>which</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>which</title>
+<para><command>which</command> shows the full path of (shell) commands.</para>
+</sect3>
+</sect2>
+<sect2>
+<title>The 'which' script</title>
 <para>The second option (for those who don't want to install the program)
 is to create a simple script:</para>

general/sysutils/zip.xml

-              rbfe245f
+              r52d29f7
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+  <!ENTITY % general-entities SYSTEM "../../general.ent">
+  %general-entities;
+<!ENTITY zip-download-http "http://www.mirror.ac.uk/sites/ftp.info-zip.org/pub/infozip/src/zip23.tar.gz">
+<!ENTITY zip-download-ftp "ftp://ftp.info-zip.org/pub/infozip/src/zip23.tar.gz">
+<!ENTITY zip-size "839 KB">
+<!ENTITY zip-buildsize "3.6 MB">
+<!ENTITY zip-time "0.05 SBU">
+]>
 <sect1 id="zip" xreflabel="Zip-&zip-version;">
 <?dbhtml filename="zip.html"?>
 <title>Zip-&zip-version;</title>
+&zip-intro;
+&zip-inst;
+&zip-exp;
+&zip-desc;
+<sect2>
+<title>Introduction to <application>Zip</application></title>
+<para>The <application>Zip</application> package contains
+<application>Zip</application> utilities. These
+are useful for compressing files into <filename>ZIP</filename> archives.</para>
+<sect3><title>Package information</title>
+<itemizedlist spacing='compact'>
+<listitem><para>Download (HTTP): <ulink
+url="&zip-download-http;"/></para></listitem>
+<listitem><para>Download (FTP): <ulink
+url="&zip-download-ftp;"/></para></listitem>
+<listitem><para>Download size: &zip-size;</para></listitem>
+<listitem><para>Estimated Disk space required:
+&zip-buildsize;</para></listitem>
+<listitem><para>Estimated build time:
+&zip-time;</para></listitem></itemizedlist>
+</sect3>
+</sect2>
+<sect2>
+<title>Installation of <application>Zip</application></title>
+<para>Install <application>Zip</application> by running the following commands:</para>
+<screen><userinput><command>cp unix/Makefile . &amp;&amp;
+make prefix=/usr generic_gcc &amp;&amp;
+make prefix=/usr install</command></userinput></screen>
+</sect2>
+<sect2>
+<title>Command explanations</title>
+<para><command>make prefix=/usr generic_gcc</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
+'generic_gcc' can be seen with a <command>make list</command> command.</para>
+</sect2>
+<sect2>
+<title>Contents</title>
+<para>The <application>Zip</application> package contains <command>zip
+</command>, <command>zipcloak</command>, <command>zipnote</command> and
+<command>zipsplit</command>.</para>
+</sect2>
+<sect2><title>Description</title>
+<sect3><title>zip</title>
+<para><command>zip</command> compresses files into a
+<filename>ZIP</filename> archive.</para></sect3>
+<sect3><title>zipcloak</title>
+<para><command>zipcloak</command> is disabled in this version of
+<application>Zip</application>.  It will
+display a message about how to support encryption by recompiling with
+<filename>zcrypt27.zip</filename>.</para></sect3>
+<sect3><title>zipnote</title>
+<para><command>zipnote</command> reads or writes comments stored in a
+<filename>ZIP</filename> file.</para></sect3>
+<sect3><title>zipsplit</title>
+<para><command>zipsplit</command> is a utility to split
+<filename>ZIP</filename> files into smaller files.</para></sect3>
+</sect2>
 </sect1>

Context Navigation

Legend:

Download in other formats: