linux-from-scratch/glfs
1
0
Fork 0
mirror of https://github.com/Zeckmathederg/glfs.git synced 2025-01-23 22:42:14 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

XML Updates to Part III from DJ

Browse Source 
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2304 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Bruce Dubbs 2004-06-12 22:56:28 +00:00
parent bfe245f017
commit 52d29f7a42
70 changed files with 6346 additions and 289 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

78
general.ent
View File

@ -47,6 +47,82 @@
<!ENTITY zsh-version "4.2.0">
<!-- Part III -->
<!-- Chapter 8 -->
<!ENTITY openssl-version "0.9.7d">
<!ENTITY pcre-version "4.5">
<!ENTITY popt-version "1.7">
<!ENTITY slang-version "1.4.9">
<!ENTITY fam-version "2.7.0">
<!ENTITY libxml-version "1.8.17">
<!ENTITY libxml2-version "2.6.9">
<!ENTITY libxslt-version "1.1.6">
<!ENTITY readline-version "4.3">
<!ENTITY gmp-version "4.1.3">
<!ENTITY gdbm-version "1.8.3">
<!ENTITY GLib-version "1.2.10">
<!ENTITY GLib2-version "2.4.1">
<!ENTITY expat-version "1.95.7">
<!ENTITY libesmtp-version "1.0.2">
<!ENTITY aspell-version "0.50.5">
<!ENTITY ispell-version "3.2.06.epa7">
<!ENTITY guile-version "1.6.4">
<!ENTITY slib-version "2d6">
<!ENTITY gwrap-version "1.3.4">
<!ENTITY LZO-version "1.08">
<!ENTITY libpcap-version "0.8.3">
<!ENTITY libusb-version "0.1.8">
<!-- Chapter 9 -->
<!ENTITY libjpeg-version "6b">
<!ENTITY libpng-version "1.2.5">
<!ENTITY libtiff-version "3.6.1">
<!ENTITY libungif-version "4.1.0b1">
<!ENTITY libmng-version "1.0.7">
<!ENTITY lcms-version "1.12">
<!ENTITY freetype2-version "2.1.7">
<!ENTITY fontconfig-version "2.2.2">
<!ENTITY imlib-version "1.9.14">
<!ENTITY aalib-version "1.4rc5">
<!ENTITY SVGAlib-version "1.4.3">
<!ENTITY DirectFB-version "0.9.20">
<!ENTITY imlib2-version "1.1.0">
<!-- Chapter 10 -->
<!ENTITY bc-version "1.06">
<!ENTITY rep-gtk-version "0.18">
<!ENTITY compface-version "1.4">
<!ENTITY imagemagick-version "5.5.7">
<!ENTITY hd2u-version "0.9.0">
<!-- Chapter 11 -->
<!ENTITY gpm-version "1.20.1">
<!ENTITY fcron-version "2.9.4">
<!ENTITY hdparm-version "5.5">
<!ENTITY which-version "2.16">
<!ENTITY unzip-version "5.51">
<!ENTITY zip-version "2.3">
<!ENTITY pciutils-version "2.1.11">
<!ENTITY pkgconfig-version "0.15.0">
<!ENTITY cpio-version "2.5">
<!ENTITY mc-version "4.6.0">
<!-- Chapter 12 -->
<!ENTITY Python-version "2.3.3">
<!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">
<!ENTITY librep-version "0.17">
<!ENTITY j2sdk-bin-version "1.4.2_03">
<!ENTITY j2sdk-src-version "1.4.2">
<!ENTITY ruby-version "1.8.1">
<!ENTITY gcc-version "3.3.3">
<!ENTITY tcl-version "8.4.6">
<!ENTITY tk-version "8.4.6">
<!ENTITY gcc2-version "2.95.3">
<!ENTITY NASM-version "0.98.38">
<!-- Part IV -->
@ -102,3 +178,5 @@
<!ENTITY gnome-version "2.6">
<!ENTITY docbook-dsssl-version "1.78">

17
general/general.xml
View File

@ -1,11 +1,18 @@
<?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>

87
general/genlib/aspell.xml
View File

@ -1,11 +1,90 @@
<?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>

60
general/genlib/expat.xml
View File

@ -1,9 +1,63 @@
<?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>

157
general/genlib/fam.xml
View File

@ -1,11 +1,158 @@
<?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>

86
general/genlib/gdbm.xml
View File

@ -1,11 +1,89 @@
<?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>

54
general/genlib/genlib.xml
View File

@ -1,3 +1,10 @@
<?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"?>
<title>General Libraries</title>
@ -30,27 +37,28 @@ program's requirements.</para>
will need at some point. In this chapter we list these and some others and
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>

62
general/genlib/glib.xml
View File

@ -1,10 +1,66 @@
<?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>

87
general/genlib/glib2.xml
View File

@ -1,11 +1,90 @@
<?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>

74
general/genlib/gmp.xml
View File

@ -1,9 +1,77 @@
<?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>

90
general/genlib/guile.xml
View File

@ -1,10 +1,94 @@
<?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>

75
general/genlib/gwrap.xml
View File

@ -1,10 +1,79 @@
<?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>

63
general/genlib/ispell.xml
View File

@ -1,10 +1,67 @@
<?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>

77
general/genlib/libesmtp.xml
View File

@ -1,10 +1,81 @@
<?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>

63
general/genlib/libpcap.xml
View File

@ -1,9 +1,66 @@
<?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>

111
general/genlib/libusb.xml
View File

@ -1,11 +1,112 @@
<?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>

67
general/genlib/libxml.xml
View File

@ -1,9 +1,70 @@
<?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>

88
general/genlib/libxml2.xml
View File

@ -1,11 +1,91 @@
<?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>

81
general/genlib/libxslt.xml
View File

@ -1,10 +1,85 @@
<?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>

63
general/genlib/lzo.xml
View File

@ -1,9 +1,66 @@
<?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>

175
general/genlib/openssl.xml
View File

@ -1,11 +1,176 @@
<?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>

96
general/genlib/pcre.xml
View File

@ -1,10 +1,98 @@
<?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>

62
general/genlib/popt.xml
View File

@ -1,10 +1,66 @@
<?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>

85
general/genlib/readline.xml
View File

@ -1,11 +1,86 @@
<?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>

68
general/genlib/slang.xml
View File

@ -1,10 +1,70 @@
<?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>

62
general/genlib/slib.xml
View File

@ -1,10 +1,66 @@
<?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>

89
general/genutils/bc.xml
View File

@ -1,3 +1,90 @@
<?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"?>
<title>bc-&bc-version;</title>
@ -7,4 +94,4 @@
&bc-desc;
</sect1>
-->

86
general/genutils/compface.xml
View File

@ -1,3 +1,88 @@
<?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"?>
<title>Compface-&compface-version;</title>
@ -7,3 +92,4 @@
&compface-desc;
</sect1>
-->

17
general/genutils/genutils.xml
View File

@ -1,11 +1,18 @@
<?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>

69
general/genutils/hd2u.xml
View File

@ -1,10 +1,73 @@
<?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>

134
general/genutils/imagemagick.xml
View File

@ -1,9 +1,137 @@
<?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>

84
general/genutils/rep-gtk.xml
View File

@ -1,10 +1,88 @@
<?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>

93
general/graphlib/aalib.xml
View File

@ -1,10 +1,97 @@
<?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>

149
general/graphlib/directfb.xml
View File

@ -1,10 +1,151 @@
<?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>

125
general/graphlib/fontconfig.xml
View File

@ -1,10 +1,127 @@
<?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>

74
general/graphlib/freetype2.xml
View File

@ -1,10 +1,78 @@
<?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>

33
general/graphlib/graphlib.xml
View File

@ -1,3 +1,10 @@
<?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"?>
<title>Graphics and Font Libraries</title>
@ -7,18 +14,18 @@ may not require the graphics and font libraries. Most desktop machines will
want them for use with graphical applications. Most servers on the
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>

87
general/graphlib/imlib.xml
View File

@ -1,11 +1,90 @@
<?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>

74
general/graphlib/imlib2.xml
View File

@ -1,9 +1,77 @@
<?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>

96
general/graphlib/lcms.xml
View File

@ -1,10 +1,98 @@
<?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>

111
general/graphlib/libjpeg.xml
View File

@ -1,12 +1,113 @@
<?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>

91
general/graphlib/libmng.xml
View File

@ -1,11 +1,94 @@
<?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>

106
general/graphlib/libpng.xml
View File

@ -1,12 +1,108 @@
<?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>

214
general/graphlib/libtiff.xml
View File

@ -1,12 +1,216 @@
<?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>

202
general/graphlib/libungif.xml
View File

@ -1,10 +1,206 @@
<?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>

139
general/graphlib/svgalib.xml
View File

@ -1,11 +1,140 @@
<?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>

298
general/prog/gcc.xml
View File

@ -1,11 +1,301 @@
<?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>

85
general/prog/gcc2.xml
View File

@ -1,11 +1,88 @@
<?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>

406
general/prog/j2sdk.xml
View File

@ -1,12 +1,408 @@
<?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>

95
general/prog/librep.xml
View File

@ -1,11 +1,98 @@
<?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>

63
general/prog/nasm.xml
View File

@ -1,9 +1,66 @@
<?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>

88
general/prog/perl-modules.xml
View File

@ -1,9 +1,93 @@
<?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>

27
general/prog/prog.xml
View File

@ -1,3 +1,10 @@
<?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" ?>
<title>Programming</title>
@ -9,15 +16,15 @@ platform, however the base system only includes language support for
build many popular programming environments to greatly expand your
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>

81
general/prog/python.xml
View File

@ -1,10 +1,85 @@
<?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>

70
general/prog/ruby.xml
View File

@ -1,10 +1,74 @@
<?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>

89
general/prog/tcl.xml
View File

@ -1,9 +1,92 @@
<?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>

85
general/prog/tk.xml
View File

@ -1,9 +1,88 @@
<?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>

92
general/sysutils/cpio.xml
View File

@ -1,11 +1,95 @@
<?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>

166
general/sysutils/fcron.xml
View File

@ -1,12 +1,168 @@
<?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>

158
general/sysutils/gpm.xml
View File

@ -1,11 +1,159 @@
<?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>

88
general/sysutils/hdparm.xml
View File

@ -1,10 +1,92 @@
<?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>

110
general/sysutils/mc.xml
View File

@ -1,10 +1,112 @@
<?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>

78
general/sysutils/pciutils.xml
View File

@ -1,9 +1,81 @@
<?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>

75
general/sysutils/pkgconfig.xml
View File

@ -1,11 +1,78 @@
<?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>

27
general/sysutils/sysutils.xml
View File

@ -1,3 +1,10 @@
<?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"?>
<title>System Utilities</title>
@ -6,15 +13,15 @@
some applications used by other applications in the book for
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>

125
general/sysutils/unzip.xml
View File

@ -1,10 +1,127 @@
<?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>

65
general/sysutils/which.xml
View File

@ -1,3 +1,16 @@
<?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"?>
<title>which-&which-version; and alternatives</title>
@ -12,11 +25,55 @@ is for you to decide.</para>
<para>The first option is to install the actual <acronym>GNU</acronym> program
<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>
<screen><userinput><command>cat &gt; /usr/bin/which &lt;&lt; "EOF"</command>

95
general/sysutils/zip.xml
View File

@ -1,10 +1,97 @@
<?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>

1
gnome/core/scrollkeeper/scrollkeeper-intro.xml
View File

@ -1,4 +1,5 @@
<sect2>
<title>Introduction to <application>ScrollKeeper</application></title>
<para>The <application>ScrollKeeper</application> package contains a cataloging system for

7
index.xml
View File

@ -30,8 +30,8 @@
%introduction;
%postlfs; -->
%general;
<!-- %connect; -->
<!-- %basicnet; -->
<!-- %connect;
%basicnet; -->
%server;
%content;
%x;
@ -55,8 +55,7 @@
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="introduction/introduction.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="postlfs/postlfs.xml"/>
&general;
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="general/general.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="connect/connect.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="basicnet/basicnet.xml"/>
&server;