BlueGreycalmElegant

Català-Valencià - Catalan中文 - Chinese (Simplified)中文 - Chinese (Traditional)Česky - CzechDansk - DanishNederlands - DutchEnglish - EnglishSuomi - FinnishFrançais - FrenchDeutsch - Germanעברית - Hebrewहिंदी - HindiMagyar - HungarianBahasa Indonesia - IndonesianItaliano - Italian日本語 - Japanese한국어 - KoreanМакедонски - Macedonianमराठी - MarathiNorsk - NorwegianPolski - PolishPortuguês - PortuguesePortuguês - Portuguese (Brazil)Русский - RussianSlovenčina - SlovakSlovenščina - SlovenianEspañol - SpanishSvenska - SwedishTürkçe - TurkishУкраїнська - UkrainianOëzbekcha - Uzbek

Compare Revisions

• This comparison shows the changes necessary to convert path

  → /trunk/ @ 720

  → /trunk/ @ 721

  ↔ Reverse comparison

• Compare Path:	Rev

  With Path:	Rev

Ignore whitespace Rev 720 → Rev 721

/trunk/blfs/basicnet/mailnews/nail.xml
File deleted

/trunk/blfs/basicnet/netlibs/wvstreams.xml
File deleted

/trunk/blfs/basicnet/netlibs/libpcap.xml
0,0 → 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 libpcap-download-http "http://www.tcpdump.org/release/libpcap-&libpcap-version;.tar.gz">
<!ENTITY libpcap-download-ftp "ftp://ftp.sunfreeware.com/pub/freeware/SOURCES/libpcap-&libpcap-version;.tar.gz">
<!ENTITY libpcap-md5sum "56a9d4615d8354fcfe8cff8c8443c77b">
<!ENTITY libpcap-size "299 KB">
<!ENTITY libpcap-buildsize "2.4 MB">
<!ENTITY libpcap-time "0.05 SBU">
]>
<sect1 id="libpcap" xreflabel="libpcap-&libpcap-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<?dbhtml filename="libpcap.html"?>
<title><application>libpcap</application>-&libpcap-version;</title>
<sect2>
<title>Introduction à <application>libpcap</application></title>
<para><application>libpcap</application> fournit des fonctions pour la capture
de paquets au niveau utilisateur, utilisé dans la surveillance réseau de
bas-niveau.</para>
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&libpcap-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&libpcap-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &libpcap-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&libpcap-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&libpcap-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&libpcap-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Dépendances de <application>libpcap</application></title>
<sect4><title>Optionnel</title>
<para><ulink url="http://www.endace.com/">DAG</ulink></para>
</sect4>
</sect3>
</sect2>
<sect2>
<title>Installation de <application>libpcap</application></title>
<para>Installez <application>libpcap</application> en exécutant les commandes
suivantes&nbsp;:</para>
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>
<note><para>Quelques applications, incluant <ulink
url="http://www.tcpdump.org/">tcpdump</ulink>, requièrent que
<option>--enable-yydebug</option> soit passé à <command>configure</command>
lors de la construction de <application>libpcap</application> pour activer
le code de débugage de l'analyseur. <application>tcpdump</application> ne
pourra pas être construit si vous ne passez pas ce paramètre.</para></note>
</sect2>
<sect2>
<title>Contenu</title>
<para>Le paquetage <application>libpcap</application> fournit la
bibliothèque <filename class="libraryfile">libpcap</filename>.</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>libpcap</title>
<para><filename class="libraryfile">libpcap</filename> est une bibliothèque
utilisée pour la capture de paquets de bas niveau.</para></sect3>
</sect2>
</sect1>

/trunk/blfs/basicnet/netprogs/samba3-client.xml
0,0 → 1,33
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
<sect1 id="samba3-client">
<?dbhtml filename="samba3-client.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Samba-&samba3-version; Client</title>
<para>The <application>Samba</application> client utilities are used to
transfer files to and from, mount SMB shares located on or use printers
attached to Windows and other SMB servers. If you want to install these
utilities, the instructions can be found in Chapter 21 &ndash;
<xref linkend="samba3"/>. After performing the basic installation,
configure the utilities using the configuration section titled
<quote>Scenario 1: Minimal Standalone Client-Only Installation</quote>.</para>
<para>Note that if you only want to use these client utilities, you do
<emphasis>not</emphasis> need to run the server daemons and so do not need
the startup script and links. In accordance with good practice, only run the
server daemons if you actually need them. You'll find an explanation of the
services provided by the server daemons in the <xref linkend="samba3"/>
instructions.</para>
</sect1>

/trunk/blfs/basicnet/netprogs/wireless-tools.xml
0,0 → 1,234
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY wireless-download-http "http://www.hpl.hp.com/personal/Jean_Tourrilhes/Linux/wireless_tools.28.tar.gz">
<!ENTITY wireless-download-ftp " ">
<!ENTITY wireless-md5sum "599c94497f9c9073c7b052d3dcb7cd16">
<!ENTITY wireless-size "249 KB">
<!ENTITY wireless-buildsize "1.7 MB">
<!ENTITY wireless-time "less than 0.1 SBU">
]>
<sect1 id="wireless_tools" xreflabel="Wireless Tools-&wireless-tools-version;">
<?dbhtml filename="wireless_tools.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Wireless Tools-&wireless-tools-version;</title>
<indexterm zone="wireless_tools">
<primary sortas="a-WirelessTools">Wireless Tools</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Wireless Tools</title>
<para>The Wireless Extension (WE) is a generic API in the Linux kernel
allowing a driver to expose configuration and statistics specific to common
Wireless LANs to user space. A single set of tools can support all the
variations of Wireless LANs, regardless of their type as long as the
driver supports Wireless Extensions. WE parameters may also be changed on
the fly without restarting the driver (or Linux).</para>
<para>The <application>Wireless Tools</application> (WT) package is a set
of tools allowing manipulation of the Wireless Extensions. They use a
textual interface to support the full Wireless Extension.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing='compact'>
<listitem>
<para>Download (HTTP): <ulink url="&wireless-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&wireless-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &wireless-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &wireless-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &wireless-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &wireless-time;</para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes:
<ulink url='&blfs-wiki;/WirelessTools'/></para>
</sect2>
<sect2 role="kernel" id='wireless-kernel'>
<title>Kernel Configuration</title>
<indexterm zone="wireless_tools wireless-kernel">
<primary sortas="d-Wireless-devices">Wireless devices</primary>
</indexterm>
<para>To use <application>Wireless Tools</application>, the kernel must
have the appropriate drivers and other support available. The appropriate
bus must also be available. For many laptops, the PCMCIA bus
(CONFIG_PCCARD) needs to be built. In some cases, this bus support will
also need to be built for embedded wireless cards. The appropriate bridge
support also needs to be built. For many modern laptops, the CardBus host
bridge (CONFIG_YENTA) will be needed.</para>
<para>In addition to the bus, the actual driver for the specific wireless
card must also be available. There are many wireless cards and they don't
all work with Linux. The first place to look for card support is the kernel.
The drivers are located in Device Drivers &rarr; Network Device Support
&rarr; Wireless LAN (non-hamradio). There are also external drivers
available for some very common cards. For more information, look
at the user notes.</para>
<para>After the correct drivers are loaded, the interface will
appear in <filename>/proc/net/wireless</filename>.</para>
</sect2>
<sect2 role="installation">
<title>Installation of Wireless Tools</title>
<para>To install <application>Wireless Tools</application>,
use the following commands:</para>
<screen><userinput>make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make PREFIX=/usr install</userinput></screen>
</sect2>
<!--
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>sed -i -e "s/__GNUC__ == 3/__GNUC__ &gt; 3/"
-e "s/__GNUC_MINOR__ &lt; 4/&amp; || __GNUC__ > 3/" iwlib.h</command>:
This modification is necessary to properly compile inline functions
with GCC4.</para>
</sect2>
-->
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>ifrename, iwconfig, iwevent, iwgetid, iwlist, iwpriv,
and iwspy</seg>
<seg>libiw.so</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="ifrename">
<term><command>ifrename</command></term>
<listitem>
<para>renames network interfaces based on various static criteria.</para>
<indexterm zone="wireless_tools ifrename">
<primary sortas="b-ifrename">ifrename</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="iwconfig">
<term><command>iwconfig</command></term>
<listitem>
<para>configures a wireless network interface.</para>
<indexterm zone="wireless_tools iwconfig">
<primary sortas="b-iwconfig">iwconfig</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="iwevent">
<term><command>iwevent</command></term>
<listitem>
<para>displays wireless events generated by drivers and setting
changes.</para>
<indexterm zone="wireless_tools iwevent">
<primary sortas="b-iwevent">iwevent</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="iwgetid">
<term><command>iwgetid</command></term>
<listitem>
<para>reports ESSID, NWID or AP/Cell Address of wireless networks.</para>
<indexterm zone="wireless_tools iwgetid">
<primary sortas="b-iwgetid">iwgetid</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="iwlist">
<term><command>iwlist</command></term>
<listitem>
<para>gets detailed wireless information from a wireless interface.</para>
<indexterm zone="wireless_tools iwlist">
<primary sortas="b-iwlist">iwlist</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="iwpriv">
<term><command>iwpriv</command></term>
<listitem>
<para>configures optional (private) parameters of a wireless network
interface.</para>
<indexterm zone="wireless_tools iwpriv">
<primary sortas="b-iwpriv">iwpriv</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="iwspy">
<term><command>iwspy</command></term>
<listitem>
<para>gets wireless statistics from specific node.</para>
<indexterm zone="wireless_tools iwspy">
<primary sortas="b-iwspy">iwspy</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libiw">
<term><filename class='libraryfile'>libiw.so</filename></term>
<listitem>
<para>contains functions required by the wireless programs and
provides an API for other programs.</para>
<indexterm zone="wireless_tools libiw">
<primary sortas="c-libiw">libiw.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/basicnet/netprogs/othernetprogs.xml
0,0 → 1,24
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
<sect1 id="basicnet-netprogs-other">
<?dbhtml filename="othernetprogs.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Other Networking Programs</title>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/othernetprogs"/></para>
<para><application>NCPFS</application> contains client and administration
tools for use with Novell networks. See the User Notes for details.</para>
</sect1>

/trunk/blfs/basicnet/netutils/ethereal.xml
File deleted

/trunk/blfs/basicnet/netutils/wireshark.xml
0,0 → 1,401
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY wireshark-download-http "http://www.wireshark.org/download/src/all-versions/wireshark-&wireshark-version;.tar.bz2">
<!ENTITY wireshark-download-ftp "&sources-anduin-ftp;/w/wireshark-&wireshark-version;.tar.bz2">
<!ENTITY wireshark-md5sum "e57a8c8b364c38df3da97e2ee9f0d0bc">
<!ENTITY wireshark-size "11.8 MB">
<!ENTITY wireshark-buildsize "449 MB">
<!ENTITY wireshark-time "6.4 SBU">
]>
<sect1 id="wireshark" xreflabel="Wireshark-&wireshark-version;">
<?dbhtml filename="wireshark.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Wireshark-&wireshark-version;</title>
<indexterm zone="wireshark">
<primary sortas="a-Wireshark">Wireshark</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Wireshark</title>
<para>The <application>Wireshark</application> package contains a network
protocol analyzer, also known as a <quote>sniffer</quote>. This is useful
for analyzing data captured <quote>off the wire</quote> from a live network
connection, or data read from a capture file.
<application>Wireshark</application> provides both a graphical and TTY-mode
front-end for examining captured network packets from over 500 protocols,
as well as the capability to read capture files from many other popular
network analyzers.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&wireshark-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&wireshark-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &wireshark-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &wireshark-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &wireshark-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &wireshark-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Additional Documentation: <ulink
url="http://www.wireshark.org/docs/"/></para>
</listitem>
</itemizedlist>
<para>From this page you can download many different docs in a variety
of formats.</para>
<bridgehead renderas="sect3">Wireshark dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="GLib"/> or <xref linkend="glib2"/>
(to build the TTY-mode front-end only)</para>
<para>Note that if you don't have <application>Gtk+</application>
installed, you will need to pass <option>--disable-wireshark</option>
to the <command>configure</command> command.</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended"><xref linkend="libpcap"/>
(required to capture data)</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="pkgconfig"/>,
<xref linkend="GTK"/> or <xref linkend="gtk2"/> (to build the GUI front-end),
<xref linkend="openssl"/>,
<xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
<xref linkend="python"/>,
<xref linkend="pcre"/>,
<xref linkend="gnutls"/>,
<ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
<ulink url="http://www.gnu.org/software/adns/adns.html">adns</ulink>, and
<ulink url="http://www.lua.org/">Lua</ulink></para>
<!-- Though configure looks for all these, and the developers I'm
sure use them, the doc sources are not included in the release
tarball (they are in SVN, though)
<bridgehead renderas="sect4">Optional (to build additional
documentation)</bridgehead>
<para role="optional"><xref linkend="doxygen"/>,
<xref linkend="libxml"/>,
<xref linkend="libxslt"/>, and
<xref linkend="fop"/></para>
-->
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/wireshark"/></para>
</sect2>
<sect2 role="kernel" id="wireshark-kernel">
<title>Kernel Configuration</title>
<para>The kernel must have the Packet protocol enabled for
<application>Wireshark</application> to capture live packets from the
network. Enable the Packet protocol by choosing <quote>Y</quote> in the
<quote>Networking</quote> &ndash; <quote>Packet socket</quote>
configuration parameter. Alternatively, build the
<filename>af_packet.ko</filename> module by choosing <quote>M</quote> in
this parameter.</para>
<indexterm zone="wireshark wireshark-kernel">
<primary sortas="d-Capturing-network-packets">Capturing network
packets</primary>
</indexterm>
</sect2>
<sect2 role="installation">
<title>Installation of Wireshark</title>
<para>Install <application>Wireshark</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr \
--sysconfdir=/etc \
--enable-threads &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/wireshark-&wireshark-version; &amp;&amp;
install -v -m644 FAQ README{,.linux} doc/README.* doc/*.{pod,txt} \
/usr/share/doc/wireshark-&wireshark-version; &amp;&amp;
pushd /usr/share/doc/wireshark-&wireshark-version; &amp;&amp;
for FILENAME in ../../wireshark/*.html; do \
ln -s -v $FILENAME .
done &amp;&amp;
popd &amp;&amp;
install -v -m644 -D wireshark.desktop \
/usr/share/applications/wireshark.desktop &amp;&amp;
install -v -m644 -D image/wsicon48.png \
/usr/share/pixmaps/wireshark.png &amp;&amp;
install -v -m755 -d /usr/share/pixmaps/wireshark &amp;&amp;
install -v -m644 image/*.{png,ico,xpm,bmp} \
/usr/share/pixmaps/wireshark</userinput></screen>
<para>If you downloaded any of the documentation files from the page
listed in the 'Additional Downloads', install them by issuing the following
commands as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>install -v -m644 <replaceable>&lt;Downloaded_Files&gt;</replaceable> /usr/share/doc/wireshark-&wireshark-version;</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--enable-threads</parameter>: This parameter enables the
use of threads in <command>wireshark</command>.</para>
<para><option>--with-ssl</option>: This parameter is required if you
are linking Kerberos libraries into the build so that the
<application>OpenSSL</application>
<filename class='libraryfile'>libcrypto</filename> library is found.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring Wireshark</title>
<sect3 id="wireshark-config">
<title>Config Files</title>
<para><filename>/etc/wireshark.conf</filename> and
<filename>~/.wireshark/*</filename></para>
<indexterm zone="wireshark wireshark-config">
<primary sortas="e-AA.wireshark-star">~/.wireshark/*</primary>
</indexterm>
<indexterm zone="wireshark wireshark-config">
<primary sortas="e-etc-wireshark.conf">/etc/wireshark.conf</primary>
</indexterm>
</sect3>
<sect3>
<title>Configuration Information</title>
<para>Though the default configuration parameters are very sane,
reference the configuration section of the
<ulink url="http://www.wireshark.org/docs/wsug_html/">Wireshark User's
Guide</ulink> for configuration information. Most of
<application>Wireshark</application>'s configuration can be accomplished
using the menu options of the <command>wireshark</command>
graphical interface.</para>
<note>
<para>If you want to look at packets, make sure you don't filter
them out with <xref linkend="iptables"/>. If you want to exclude
certain classes of packets, it is more efficient to do it with
<application>iptables</application> than it is with
<application>Wireshark</application>.</para>
</note>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>capinfos, dftest, dumpcap, editcap, idl2wrs, mergecap, randpkt,
text2pcap, tshark and wireshark</seg>
<seg>libwireshark.so, libwiretap.so and numerous dissector plugin
modules</seg>
<seg>/usr/lib/wireshark, /usr/share/doc/wireshark-&wireshark-version;,
/usr/share/pixmaps/wireshark and /usr/share/wireshark</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="capinfos">
<term><command>capinfos</command></term>
<listitem>
<para>reads a saved capture file and returns any or all of several
statistics about that file. It is able to detect and read any capture
supported by the <application>Wireshark</application> package.</para>
<indexterm zone="wireshark capinfos">
<primary sortas="b-capinfos">capinfos</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dftest">
<term><command>dftest</command></term>
<listitem>
<para>is a display-filter-compiler test program.</para>
<indexterm zone="wireshark dftest">
<primary sortas="b-dftest">dftest</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dumpcap">
<term><command>dumpcap</command></term>
<listitem>
<para>is a network traffic dump tool. It lets you capture packet data
from a live network and write the packets to a file.</para>
<indexterm zone="wireshark dumpcap">
<primary sortas="b-dumpcap">dumpcap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="editcap">
<term><command>editcap</command></term>
<listitem>
<para>edits and/or translates the format of capture files. It knows
how to read <application>libpcap</application> capture files,
including those of <command>tcpdump</command>,
<application>Wireshark</application> and other tools that write
captures in that format.</para>
<indexterm zone="wireshark editcap">
<primary sortas="b-editcap">editcap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="idl2wrs">
<term><command>idl2wrs</command></term>
<listitem>
<para>takes a user specified CORBA
IDL file and generates <quote>C</quote> source code that
can be used to create an <application>Wireshark</application>
plugin.</para>
<indexterm zone="wireshark idl2wrs">
<primary sortas="b-idl2wrs">idl2wrs</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mergecap">
<term><command>mergecap</command></term>
<listitem>
<para>combines multiple saved capture files into a single output
file.</para>
<indexterm zone="wireshark mergecap">
<primary sortas="b-mergecap">mergecap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="randpkt">
<term><command>randpkt</command></term>
<listitem>
<para>creates random-packet capture files.</para>
<indexterm zone="wireshark randpkt">
<primary sortas="b-randpkt">randpkt</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="text2pcap">
<term><command>text2pcap</command></term>
<listitem>
<para>reads in an ASCII hex dump and writes the
data described into a <application>libpcap</application>-style
capture file.</para>
<indexterm zone="wireshark text2pcap">
<primary sortas="b-text2pcap">text2pcap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="tshark">
<term><command>tshark</command></term>
<listitem>
<para>is a TTY-mode network protocol analyzer. It lets you capture
packet data from a live network or read packets from a
previously saved capture file.</para>
<indexterm zone="wireshark tshark">
<primary sortas="b-tshark">tshark</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="wireshark-prog">
<term><command>wireshark</command></term>
<listitem>
<para>is a GUI network protocol analyzer. It lets you interactively
browse packet data from a live network or from a previously
saved capture file.</para>
<indexterm zone="wireshark wireshark-prog">
<primary sortas="b-wireshark">wireshark</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libwireshark">
<term><filename class='libraryfile'>libwireshark.so</filename></term>
<listitem>
<para>contains functions used by the
<application>Wireshark</application> programs to perform filtering and
packet capturing.</para>
<indexterm zone="wireshark libwireshark">
<primary sortas="c-libwireshark">libwireshark.so</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libwiretap">
<term><filename class='libraryfile'>libwiretap.so</filename></term>
<listitem>
<para>is a library being developed as a future replacement for
<filename class='libraryfile'>libpcap</filename>, the current
standard Unix library for packet capturing. For more information,
see the <filename>README</filename> file in the source
<filename class='directory'>wiretap</filename> directory.</para>
<indexterm zone="wireshark libwiretap">
<primary sortas="c-libwiretap">libwiretap.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/basicnet/connect/dhcpcd.xml
0,0 → 1,211
<?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 dhcpcd-download-http "http://www.phystech.com/ftp/dhcpcd-&dhcpcd-version;.tar.gz">
<!ENTITY dhcpcd-download-ftp "ftp://ftp.phystech.com/pub/dhcpcd-&dhcpcd-version;.tar.gz">
<!ENTITY dhcpcd-md5sum "dd627a121e43835bead3ffef5b1a72fd">
<!ENTITY dhcpcd-size "145 KB">
<!ENTITY dhcpcd-buildsize "944 KB">
<!ENTITY dhcpcd-time "0.04 SBU">
]>
<sect1 id="dhcpcd" xreflabel="dhcpcd-&dhcpcd-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<?dbhtml filename="dhcpcd.html"?>
<title>dhcpcd-&dhcpcd-version;</title>
<indexterm zone="dhcpcd">
<primary sortas="a-Dhcpcd">Dhcpcd</primary></indexterm>
<sect2>
<title>Introduction à <application>dhcpcd</application></title>
<para>Le paquetage <application>dhcpcd</application> contient le client
<command>dhcpcd</command>. Il est utile pour connecter votre ordinateur à un
réseau qui utilise <acronym>DHCP</acronym> pour affecter les adresses réseau.
</para>
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;: <ulink
url="&dhcpcd-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;: <ulink
url="&dhcpcd-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &dhcpcd-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&dhcpcd-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&dhcpcd-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&dhcpcd-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Téléchargements supplémentaires</title>
<itemizedlist spacing='compact'>
<listitem><para>Correctif requis&nbsp;:
<ulink url="&patch-root;/dhcpcd-&dhcpcd-version;-fhs-1.patch"/></para>
</listitem>
</itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Installation de <application>dhcpcd</application></title>
<para>Installez <application>dhcpcd</application> en exécutant les commandes
suivantes&nbsp;:</para>
<screen><userinput><command>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch &amp;&amp;
./configure --prefix="" --sysconfdir=/var/lib \
--mandir=/usr/share/man &amp;&amp;
make</command></userinput></screen>
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen>
</sect2>
<sect2>
<title>Explications des commandes</title>
<para><command>patch -Np1 -i ../dhcpcd-&dhcpcd-version;-fhs-1.patch</command>&nbsp;:
<application>dhcpcd</application>, non corrigé, place tous les fichiers de
configuration et les fichiers temporaires dans <filename
class='directory'>/etc/dhcpc</filename>. Ceci devient très ennuyant quand
<application>dhcpcd</application> vous indique qu'il fonctionne alors que ce
n'est pas le cas. Vous recherchez dans <filename
class="directory">/var/run</filename> le fichier <filename>PID</filename> mais
il ne s'y trouve pas. Le fichier <filename>PID</filename> qui doit être supprimé
est dans <filename class="directory">/etc/dhcpc</filename>. Ce correctif place
ce fichier en concordance avec <acronym>FHS</acronym> mais, plus important, place
les fichiers où vous vous attendez les trouver.</para>
<para><parameter>--prefix=""</parameter>&nbsp;: ceci pourrait être une bonne
raison pour abandonner la convention <acronym>BLFS</acronym> habituelle qui est
d'utiliser ici <parameter>--prefix=/usr</parameter>. Si vous installez
<acronym>DHCP</acronym>, il est probable qu'il sera requis lors du démarrage
alors que <filename class="directory">/usr</filename> pourrait être montée via
le réseau... auquel cas <command>dhcpcd</command> ne serait pas disponible à
cause de sa présence sur le réseau&nbsp;! Du coup, suivant votre situation,
vous pourriez souhaiter l'installer dans <filename
class="directory">/sbin</filename> ou dans <filename
class="directory">/usr/sbin</filename>. Cette commande l'installe dans
<filename class="directory">/sbin</filename>.</para>
<para><parameter>--sysconfdir=/var/lib</parameter>&nbsp;: cette commande installe
les fichiers de configuration dans le répertoire <filename
class="directory">/var/lib</filename>.</para>
<para><parameter>--mandir=/usr/share/man</parameter>&nbsp;: cette commande
installe les pages man dans le répertoire <filename
class="directory">/usr/share/man</filename>.</para>
</sect2>
<sect2>
<title>Configurer <application>dhcpcd</application></title>
<sect3 id="dhcpcd-config"><title>Fichiers de configuration</title>
<para><filename>/var/lib/dhcpc/*</filename></para>
<indexterm zone="dhcpcd dhcpcd-config">
<primary sortas="e-var-lib-dhcpc">/var/lib/dhcpc/*</primary></indexterm>
</sect3>
<sect3 id="dhcpcd-init"><title>Informations de configuration</title>
<para>Pour configurer <command>dhcpcd</command>, vous avez tout d'abord besoin
d'installer le script du service réseau,
<filename>/etc/sysconfig/network-devices/services/dhcpcd</filename> inclus dans
le paquetage <xref linkend="intro-important-bootscripts"/> (comme utilisateur
root).</para>
<indexterm zone="dhcpcd dhcpcd-init">
<primary sortas="f-dhcpcd">dhcpcd (script du service)</primary></indexterm>
<screen><userinput role='root'><command>make install-service-dhcpcd</command></userinput></screen>
<para id="dhcpcd-config2">Enfin, en tant qu'utilisateur root, créez le fichier
de configuration
<filename>/etc/sysconfig/network-devices/ifconfig.eth0/dhcpcd</filename> en
utilisant les commandes suivantes. Ajustez de façon approprié les interfaces
supplémentaires.</para>
<indexterm zone="dhcpcd dhcpcd-config2">
<primary sortas="e-etc-sysconfig-dhcpcd">/etc/sysconfig/.../dhcpcd</primary></indexterm>
<screen><userinput role='root'><command>install -d /etc/sysconfig/network-devices/ifconfig.eth0 &amp;&amp;
cat &gt; /etc/sysconfig/network-devices/ifconfig.eth0/dhcpcd &lt;&lt; "EOF"</command>
ONBOOT="yes"
SERVICE="dhcpcd"
DHCP_START="<replaceable>[insert appropriate start options here]</replaceable>"
DHCP_STOP="-k <replaceable>[insert additional stop options here]</replaceable>"
# Initialisez PRINTIP="yes" pour que le script affiche
# l'adresse IP affectée par le script
PRINTIP="no"
# Initialisez PRINTALL="yes" pour afficher les valeurs DHCP affectées pour
# IP, SM, DG et le premier NS. Ceci requiert PRINTIP="yes".
PRINTALL="no"
<command>EOF</command></userinput></screen>
<para>Pour plus d'informations sur les valeurs appropriées de
<envar>DHCP_START</envar> et <envar>DHCP_STOP</envar>, examinez la page man pour
<command>dhcpcd</command>.</para>
<note><para id="dhcpcd-config3">Le comportement par défaut de
<command>dhcpcd</command> est d'écraser (après avoir fait une sauvegarde)
<filename>/etc/resolv.conf</filename>, <filename>/etc/yp.conf</filename> et
<filename>/etc/ntp.conf</filename> avec de nouveaux fichiers contenant les
informations provenant du serveur <acronym>DHCP</acronym>. Si cela n'est pas
souhaitable, revisitez la page man de <command>dhcpcd</command> pour connaître
les commutateurs à ajouter à la valeur <envar>DHCP_START</envar>.</para></note>
<indexterm zone="dhcpcd dhcpcd-config3">
<primary sortas="e-etc-resolv.conf">/etc/resolv.conf</primary></indexterm>
<indexterm zone="dhcpcd dhcpcd-config3">
<primary sortas="e-etc-yp.conf">/etc/yp.conf</primary></indexterm>
<indexterm zone="dhcpcd dhcpcd-config3">
<primary sortas="e-etc-ntp.conf">/etc/ntp.conf</primary></indexterm>
</sect3>
</sect2>
<sect2>
<title>Contenu</title>
<segmentedlist>
<segtitle>Programme installé</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
<seglistitem>
<seg>dhcpcd</seg>
<seg>None</seg>
<seg>/var/lib/dhcpc</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
<varlistentry id="dhcpcd-prog">
<term><command>dhcpcd</command></term>
<listitem><para>est une implémentation du client <acronym>DHCP</acronym>
spécifiée dans <acronym>RFC</acronym>2131 et <acronym>RFC</acronym>1541
(suivant les options données).</para>
<indexterm zone="dhcpcd dhcpcd-prog">
<primary sortas="b-dhcpcd">dhcpcd</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/basicnet/connect/connect.xml
0,0 → 1,23
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE part 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="connect" xreflabel="Connecting to a Network">
<?dbhtml filename="connect.html" dir="connect"?>
<title>Se connecter à un réseau</title>
<partintro><para>Le livre <acronym>LFS</acronym> couvre la configuration du
réseau en se connectant à un <acronym>LAN</acronym> avec une
<acronym>IP</acronym> statique. Il existe néanmoins d'autres méthodes pour
se connecter à des <acronym>LAN</acronym> et à d'autres réseaux comme Internet.
Nous couvrons les méthodes les plus populaires dans ce chapitre.
</para></partintro>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dialup/dialup.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="dhcp/dhcp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="other/other.xml"/>
</part>

/trunk/blfs/basicnet/connect/dhcp-client.xml
0,0 → 1,84
<?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;
]>
<sect1 id="dhcp-client" xreflabel="DHCP-&dhcp-version; Client">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<?dbhtml filename="dhcpclient.html"?>
<title>DHCP-&dhcp-version; Client</title>
<indexterm zone="dhcp-client">
<primary sortas="b-dhclient">dhclient</primary></indexterm>
<para>Le package <application><acronym>DHCP</acronym></application> fournit à
la fois un programme client (<command>dhclient</command>) et un
programme serveur pour utiliser <acronym>DHCP</acronym>. Si vous voulez
l'installer, les instructions se trouvent sur cette page <xref linkend="dhcp"/>.
Notez que, si vous n'utilisez que le client, vous n'avez
<emphasis>pas</emphasis> besoin de lancer le serveur, et donc vous n'avez
besoin ni du script de démarrage ni des liens associés au démon du serveur.
Notez que pour utiliser le client, vous devez modifier votre script
<filename>ethnet</filename> comme décrit dans la prochaine section.
Néanmoins, vous avez seulement besoin de lancer le serveur DHCP si vous
proposez ce service sur un réseau, et vous devez savoir si c'est le cas;
dans le cas contraire, ne lancez pas le serveur!</para>
<para id="dhclient-service">Pour configurer <command>dhclient</command>, vous
avez tout d'abord besoin du script de service réseau,
<filename>/etc/sysconfig/network-devices/services/dhclient</filename>
inclus dans le paquetage <xref linkend="intro-important-bootscripts"/>
(en tant que root).</para>
<indexterm zone="dhcp-client dhclient-service">
<primary sortas="f-dhclient">dhclient (script du service)</primary></indexterm>
<screen><userinput role='root'><command>make install-service-dhclient</command></userinput></screen>
<para id="dhclient-config1">Ensuite, créez le fichier de configuration
<filename>/etc/sysconfig/network-devices/ifconfig.eth0/dhclient</filename>
avec les commandes suivantes en tant qu'utilisateur root. Ajustez autant que
nécessaire pour les interfaces supplémentaires.</para>
<indexterm zone="dhcp-client dhclient-config1">
<primary
sortas="e-etc-sysconfig-...-dhclient">/etc/sysconfig/.../dhclient</primary>
</indexterm>
<screen><userinput role='root'><command>install -d /etc/sysconfig/network-devices/ifconfig.eth0 &amp;&amp;
cat &gt; /etc/sysconfig/network-devices/ifconfig.eth0/dhclient &lt;&lt; "EOF"</command>
ONBOOT="yes"
SERVICE="dhclient"
DHCP_START="-q <replaceable>[ajoutez ici les paramètres de démarrage supplémentaires]</replaceable>"
DHCP_STOP="-q -r <replaceable>[ajoutez ici les paramètres d'arrêt supplémentaires]</replaceable>"
<command>EOF</command></userinput></screen>
<para>Pour plus d'informations sur les valeurs appropriées
<envar>DHCP_START</envar> et <envar>DHCP_STOP</envar>,
examinez la page main pour dhclient.</para>
<para id="dhclient-config2">Enfin, vous devez créer le fichier
<filename>/etc/dhclient.conf</filename> en utilisant les commandes suivantes en
tant qu'utilisateur root&nbsp;:</para>
<indexterm zone="dhcp-client dhclient-config2">
<primary sortas="e-etc-dhclient.conf">/etc/dhclient.conf</primary></indexterm>
<note><para>Vous aurez besoin d'ajouter une deuxième définition d'interface au
fichier si vous avez plus d'une interface.</para></note>
<screen><userinput role='root'><command>cat &gt; /etc/dhclient.conf &lt;&lt; "EOF"</command>
# dhclient.conf
interface "eth0"{
prepend domain-name-servers 127.0.0.1;
request subnet-mask, broadcast-address, time-offset, routers,
domain-name, domain-name-servers, host-name;
require subnet-mask, domain-name-servers;
}
# end dhclient.conf
<command>EOF</command></userinput></screen>
</sect1>

/trunk/blfs/basicnet/connect/ppp.xml
0,0 → 1,166
<?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 ppp-download-http "http://ccache.samba.org/ftp/ppp/ppp-&ppp-version;.tar.gz">
<!ENTITY ppp-download-ftp "ftp://ftp.samba.org/pub/ppp/ppp-&ppp-version;.tar.gz">
<!ENTITY ppp-md5sum "848f6c3cafeb6074ffeb293c3af79b7c">
<!ENTITY ppp-size "672&nbsp;Ko">
<!ENTITY ppp-buildsize "6,2&nbsp;Mo">
<!ENTITY ppp-time "0,13&nbsp;SBU">
]>
<sect1 id="ppp" xreflabel="PPP-&ppp-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<?dbhtml filename="ppp.html"?>
<title>PPP-&ppp-version;</title>
<indexterm zone="ppp">
<primary sortas="a-PPP">PPP</primary></indexterm>
<sect2>
<title>Introduction à <application><acronym>PPP</acronym></application></title>
<para>Le paquetage <application><acronym>PPP</acronym></application> contient
le démon <command>pppd</command> et le programme <command>chat</command>. Ils
sont utilisés pour la connexion vers d'autres machines&nbsp;; souvent pour se
connecter à Internet via une connexion commutée ou via une connexion
<acronym>PPPoE</acronym> vers un <acronym>FAI</acronym>.</para>
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;: <ulink
url="&ppp-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;: <ulink
url="&ppp-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &ppp-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;: &ppp-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&ppp-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&ppp-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Dépendances de <application>ppp</application></title>
<sect4><title>Requis</title>
<para><xref linkend="libpcap"/></para>
</sect4>
</sect3>
</sect2>
<sect2 id="ppp-kernel">
<title>Installation de <application><acronym>PPP</acronym></application></title>
<note><para>Le support de <application><acronym>PPP</acronym></application>
doit être compilé dans le noyau ou être disponible comme un module du noyau.
</para></note>
<indexterm zone="ppp ppp-kernel">
<primary sortas="d-PPP-support">Support de PPP</primary></indexterm>
<para>Installez <application><acronym>PPP</acronym></application> en lançant les
commandes suivantes&nbsp;:</para>
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>
<para>Maintenant, en tant qu'utilisateur root&nbsp;:</para>
<screen><userinput role='root'><command>make install &amp;&amp;
make install-etcppp</command></userinput></screen>
</sect2>
<sect2>
<title>Explications des commandes</title>
<para><command>make install-etcppp</command>&nbsp;: cette commande place les
fichiers de configuration dans <filename class="directory">/etc/ppp</filename>.</para>
</sect2>
<sect2>
<title>Configurer <application><acronym>PPP</acronym></application></title>
<sect3 id="ppp-config"><title>Fichiers de configuration</title>
<para><filename>/etc/ppp/*</filename></para>
<indexterm zone="ppp ppp-config">
<primary sortas="e-etc-ppp-star">/etc/ppp/*</primary></indexterm>
</sect3>
<sect3><title>Informations de configuration</title>
<para>Le démon <application><acronym>PPP</acronym></application> requiert très
peu de configuration. Le problème principal est de scripter la connexion. Ceci
se fait soit en utilisant le programme <command>chat</command> qui vient avec
ce paquetage soit en utilisant <xref linkend="wvdial"/>.</para>
</sect3>
</sect2>
<sect2>
<title>Contenu</title>
<segmentedlist>
<segtitle>Programmes installés</segtitle>
<segtitle>Bibliothèques installées</segtitle>
<segtitle>Répertoires installés</segtitle>
<seglistitem>
<seg>chat, pppd, pppdump, pppoe-discovery et pppstats</seg>
<seg>Plusieurs modules installés dans
<filename class='directory'>/usr/lib/pppd/2.4.3</filename></seg>
<seg>/etc/ppp, /usr/include/pppd et /usr/lib/pppd</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Descriptions courtes</bridgehead>
<?dbfo list-presentation="list"?>
<varlistentry id="chat">
<term><command>chat</command></term>
<listitem><para>définit un échange de conversations entre l'ordinateur et le
modem. Son but principal est d'établir la connexion entre le démon du protocole
point à point (<acronym>PPPD</acronym>) et le processus <command>pppd</command>
distant.</para>
<indexterm zone="ppp chat">
<primary sortas="b-chat">chat</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="pppd">
<term><command>pppd</command></term>
<listitem><para>est le démon du protocole point à point.</para>
<indexterm zone="ppp pppd">
<primary sortas="b-pppd">pppd</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="pppdump">
<term><command>pppdump</command></term>
<listitem><para>est utilisé pour convertir les fichiers d'enregistrement
<application><acronym>PPP</acronym></application> en un format lisible.
</para>
<indexterm zone="ppp pppdump">
<primary sortas="b-pppdump">pppdump</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="pppstats">
<term><command>pppstats</command></term>
<listitem><para>est utilisé pour afficher les statistiques de
<application><acronym>PPP</acronym></application>.</para>
<indexterm zone="ppp pppstats">
<primary sortas="b-pppstats">pppstats</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/book/organization.xml
0,0 → 1,95
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<sect1 id="organization" xreflabel="Organization">
<?dbhtml filename="organization.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Organization</title>
<para>This book is divided into the following parts.</para>
<bridgehead renderas="sect2">Part I - Introduction</bridgehead>
<para>This part contains information which is essential to
the rest of the book.</para>
<bridgehead renderas="sect2">Part II - Post LFS Configuration and Extra
Software</bridgehead>
<para>Here we introduce basic configuration and security issues. We also
discuss a range of editors, file systems, and shells which aren't covered in
the main LFS book.</para>
<bridgehead renderas="sect2">Part III - General Libraries and Utilities</bridgehead>
<para>In this section we cover libraries which are often needed by the rest
of the book as well as system utilities. Information on Programming
(including recompiling <application>GCC</application> to support its full range
of languages) concludes this part.</para>
<bridgehead renderas="sect2">Part IV - Connecting to a Network</bridgehead>
<para>Here we cover how to connect to a network when you aren't using the
simple static IP setup given in the main LFS book.</para>
<bridgehead renderas="sect2">Part V - Basic Networking</bridgehead>
<para>Networking libraries and command-line networking tools make up the
bulk of this part.</para>
<bridgehead renderas="sect2">Part VI - Major Servers</bridgehead>
<para>Here we deal with setting up mail and other servers (such as
<application>SSH</application>, <application>Apache</application>, etc.).</para>
<bridgehead renderas="sect2">Part VII - X + Window Managers</bridgehead>
<para>This part explains how to set up a basic <application>X Window
System</application> installation along with some generic
<application>X</application> libraries and Window managers.</para>
<bridgehead renderas="sect2">Part VIII - KDE</bridgehead>
<para>For those who want to use the <application>K Desktop
Environment</application> or some parts of it, this part covers it.</para>
<bridgehead renderas="sect2">Part IX - GNOME</bridgehead>
<para><application>GNOME</application> is the main alternative to
<application>KDE</application> in the Desktop Environment arena and
we cover <application>GNOME</application>-&gnome-version; here.</para>
<bridgehead renderas="sect2">Part X - X Software</bridgehead>
<para>Office programs and graphical web browsers are important to most people.
They, along with some generic <application>X</application> software can be
found in this part of the book.</para>
<bridgehead renderas="sect2">Part XI - Multimedia</bridgehead>
<para>Here we cover setting multimedia libraries and drivers along with some
audio, video and CD-writing programs.</para>
<bridgehead renderas="sect2">Part XII - Printing, Scanning and
Typesetting (PST)</bridgehead>
<para>The PST part of the book covers document handling with applications like
<application>Ghostscript</application>, <application>CUPS</application> and
<application>DocBook</application> to installing
<application>teTeX</application>.</para>
<bridgehead renderas="sect2">Appendices</bridgehead>
<para>The Appendices cover information which doesn't belong in the main
book; they are mainly there as a reference.</para>
</sect1>

/trunk/blfs/book/foreword.xml
0,0 → 1,137
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<sect1 id="foreword" xreflabel="Foreword">
<?dbhtml filename="foreword.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Foreword</title>
<!--
<para>Version 6.0 is a major milestone in the evolution of BLFS. This
version provides installation instructions for 357 packages and an additional
21 sections covering configuration and customization of different aspects
of your system.</para>
<para>Changes and upgrades to the individual packages are detailed in the
<xref linkend="changelog"/>. There you will see literally hundreds of
changes made since the last edition. In this change log, one name that you
will see over and over is Randy McMurchy. Without his efforts this
release would not have been possible. I want to take this opportunity to thank
him for the hundreds of hours he has worked to produce this release. I
also want to thank the other editors, both past and present, whose insight
and effort have made this current version possible. Last, but certainly not least,
I want to thank our resident XSL wizard, Manuel Canales Esparcia, whose
ability to format a complicated document such as BLFS is truly amazing.</para>
<para>There are two other areas of change that are worthy of note. First,
the license that BLFS is released under has changed significantly. In
fact, it is now released under two licenses. The first license, the
<xref linkend="CC"/>, covers the descriptive text in the book. The second, the
<xref linkend="AFL"/>, covers the instructions actually used to build and
install the packages. These licenses, along with the book itself, represent
our ongoing commitment to open and free software.</para>
<para>The final area of change is the addition of an Index. This section of
the book is still incomplete, but as the book continues to be developed,
will become an excellent resource for finding programs, libraries,
configuration files, and references to kernel configuration requirements. I
hope you find it useful.</para>
<blockquote>
<literallayout>Bruce Dubbs
March 17, 2005</literallayout>
</blockquote>
<para>Version 6.1 is an incremental update of BLFS. This version
continues the tradition of providing an extensive set of instructions for
extending a basic Linux From Scratch system. The instructions in this
version of BLFS are based on the LFS 6.1 Book. As usual, the list of
packages that have been upgraded or added are in the
<xref linkend="changelog"/>.</para>
<para>One major accomplishment in this
version of the book is the completion of the Index. This section
is now a relatively complete (but not perfect) reference for the components
of the various packages in the book.</para>
<para>In any task as large and complex as this book, there are bound to
be errors. The editors of the book are dedicated to keeping the book up
to date. We appreciate any feedback in helping us to make the book as
accurate as possible. The best place to provide comments is via the
mailing list at <ulink url="mailto:blfs-dev@&lfs-domainname;"/>.</para>
<para>Enjoy!</para>
<blockquote>
<literallayout>Bruce Dubbs
August 1, 2005</literallayout>
</blockquote>
<para>Version 6.2.0 is the complement to the LFS 6.2 book. More time has
elapsed between the release of the previous version (6.1) and this one than
in any other release cycle. Much of this is due to the fact that LFS 6.2
took much longer to be released than was originally anticipated. Many new
packages have been introduced in the 6.2.0 version, as well as many
updates, refinements and additions to the existing packages.</para>
<para>The BLFS book now provides build and configuration instructions for
almost 400 packages. Some of the new packages introduced in this version are:
autotooled XOrg, HAL, D-BUS, GStreamer (now broken out into separate plugin
packages), usbutils, libquicktime, GraphViz, K3b, dvd+rw-tools, NSS, Libidn,
GAIM, Poppler, SeaMonkey, XChat, Audacious, cairo and unixODBC. Major updates
include GNOME-2.14.3 (with several new GNOME packages such as Totem,
gnome-mount and gnome-volume-manager), KDE-3.5.6, Firefox-1.5.x,
Thunderbird-1.5.x, and most of the mainline server packages. As always, the
list of packages that have been upgraded or added as well as configuration
and build command changes are annotated in the
<xref linkend="changelog"/>.</para>
<para>Unfortunately, BLFS activity was semi-stagnant for several months
after (and shortly before) the LFS 6.2 release. Therefore, many of the
packages are somewhat dated (compared to previous BLFS versions). This
brings us to why the versioning scheme has changed. This release is 6.2.0
as we fully anticipate releasing another version (6.2.1) just as soon as
possible. The 6.2.1 release will also be based on the LFS-6.2 book, but
will include updated packages, and fixes for any errors which may be
discovered in 6.2.0.</para>
<para>As always, the main thrust of BLFS development will be to support
the changes in the current LFS development book, but any changes or
updates to the BLFS development book (that are compatible with LFS 6.2)
will also be merged into the BLFS 6.2 branch. This way, a 6.2.1 version
of BLFS should be released fairly soon, and should provide a very current
and stable Linux platform.</para>
<para>Enjoy!</para>
-->
<para>This is the development version of the BLFS book. This version of the
book is intended to be used when building on top of a system built using the
LFS Development book. Though this version of the book is development in
nature, every effort has been made to ensure accuracy and reliability of the
instructions. Many people find that using the instructions in this book after
building the development version of LFS provides a stable and very modern
Linux system.</para>
<para>If you have built LFS using a released version (the most recent being
LFS-6.3), then you probably don't want to use this version of BLFS, as
there could be incompatibilities. Instead, use the matching BLFS version
which should be available on all the mirrors.</para>
<para>Enjoy!</para>
<blockquote>
<literallayout>Randy McMurchy
August 24th, 2008</literallayout>
</blockquote>
</sect1>

/trunk/blfs/book/whoread.xml
0,0 → 1,33
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<sect1 id="whoread" xreflabel="Who Would Want to Read this Book">
<?dbhtml filename="whoread.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Who Would Want to Read this Book</title>
<para>This book is mainly aimed at those who have built a system based
on the LFS book. It will also be useful for those who are using other
distributions, but for one reason or another want to manually build
software and are in need of some assistance. Note that the material
contained in this book, in particular the dependency listings, is based
upon the assumption that you are using a base LFS system with every
package listed in the LFS book already installed and configured. BLFS can
be used to create a range of diverse systems and so the target audience is
probably nearly as wide as that of the LFS book. If you found LFS useful,
you should also like this!</para>
<para>Since Release 5.0, the BLFS book version matches the LFS book version.
This book may be incompatible with a previous or latter release of the LFS
book.</para>
</sect1>

/trunk/blfs/book/errata.xml
0,0 → 1,27
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<sect1 id="errata" xreflabel="Errata">
<?dbhtml filename="errata.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Errata</title>
<para>The software used to create BLFS applications is constantly being
updated and enhanced. Security warnings and bug fixes may become available
after the BLFS book has been released. To check whether the package
versions or instructions in this release of BLFS need any modifications to
accommodate security vulnerabilities or other bug fixes, please visit
<ulink url="&errata;"/> before proceeding with your build. You should note
any changes shown and apply them to the relevant section of the book as you
progress with building the applications in BLFS.</para>
</sect1>

/trunk/blfs/README
1,5 → 1,5
$LastChangedBy: randy $
$Date: 2008-08-30 14:59:27 $
$Date: 2008-11-16 21:27:59 $
How do I convert these XML files to other formats like HTML, PDF,
and TXT? You need to have some software installed that deal with these

/trunk/blfs/general.ent
1,19 → 1,19
<!--
$LastChangedBy: randy $
$Date: 2008-08-30 14:59:27 $
$LastChangedBy: thomas $
$Date: 2008-11-16 21:27:59 $
-->
<!ENTITY day "24"> <!-- Always 2 digits -->
<!ENTITY month "08"> <!-- Always 2 digits -->
<!ENTITY day "14"> <!-- Always 2 digits -->
<!ENTITY month "11"> <!-- Always 2 digits -->
<!ENTITY year "2008">
<!ENTITY copyrightdate "2001-&year;">
<!ENTITY copyholder "The BLFS Development Team">
<!ENTITY version "svn-&year;&month;&day;">
<!ENTITY releasedate "August &day;th, &year;">
<!ENTITY releasedate "November &day;th, &year;">
<!ENTITY pubdate "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
<!ENTITY blfs-version "svn"> <!-- svn|[release #] -->
<!ENTITY lfs-version "development"> <!-- version|testing|unstable|development] -->
<!ENTITY last-commit "$Date: 2008-08-30 14:59:27 $"> <!-- Automatic update -->
<!ENTITY last-commit "$Date: 2008-11-16 21:27:59 $"> <!-- Automatic update -->
<!ENTITY lfs-domainname "linuxfromscratch.org">
31,19 → 31,20
<!ENTITY errata "http://www.&lfs-domainname;/blfs/errata/&blfs-version;/">
<!-- <!ENTITY lfs-root "http://www.&lfs-domainname;/lfs/view/&lfs-version;"> -->
<!ENTITY lfs-root "../../../../lfs/view/&lfs-version;">
<!ENTITY sourceforge-repo "http://downloads.sourceforge.net">
<!ENTITY gentoo-ftp-repo "ftp://ftp.linux.ee/pub/gentoo/distfiles/distfiles">
<!ENTITY publisher "Unknown">
<!-- These entities are used to identify versions of LFS
packages referenced throughout the BLFS book. -->
<!ENTITY lfs-gcc-version "4.2.3">
<!ENTITY lfs-bdb-version "4.6.21">
<!ENTITY lfs-coreutils-version "6.10">
<!ENTITY lfs-perl-version "5.8.8">
<!ENTITY lfs-autoconf-version "2.62">
<!ENTITY lfs-gcc-version "4.3.2">
<!ENTITY lfs-bdb-version "4.7.25">
<!ENTITY lfs-coreutils-version "6.12">
<!ENTITY lfs-perl-version "5.10.0">
<!ENTITY lfs-autoconf-version "2.63">
<!ENTITY lfs-flex-version "2.5.35">
<!ENTITY lfs-shadow-version "4.0.18.1">
<!ENTITY lfs-vim-version "7.1">
<!ENTITY lfs-shadow-version "4.1.2.1">
<!ENTITY lfs-vim-version "7.2">
<!-- End LFS versions -->
<!ENTITY blfs-bootscripts-version "20080816">
59,7 → 60,7
<!ENTITY openssl-version "0.9.8g">
<!ENTITY gnutls-version "1.6.3">
<!ENTITY cracklib-version "2.8.12">
<!ENTITY cracklib-version "2.8.13">
<!ENTITY linux-pam-version "0.99.10.0">
<!ENTITY shadow-version "4.0.18.1">
<!ENTITY iptables-version "1.3.8">
82,7 → 83,7
<!ENTITY emacs-version "22.1">
<!ENTITY nano-version "2.0.7">
<!ENTITY joe-version "3.5">
<!ENTITY ed-version "0.8">
<!ENTITY ed-version "1.1">
<!ENTITY bluefish-version "1.0.7">
<!-- Chapter 7 -->
98,7 → 99,7
<!-- Part III -->
<!-- Chapter 8 -->
<!ENTITY pcre-version "7.6">
<!ENTITY popt-version "1.10.4">
<!ENTITY popt-version "1.14">
<!ENTITY slang-version "2.1.3">
<!ENTITY gamin-version "0.1.9">
<!ENTITY libxml2-version "2.6.31">
186,15 → 187,15
<!ENTITY gperf-version "3.0.3">
<!-- Chapter 11 -->
<!ENTITY gpm-version "1.20.1">
<!ENTITY fcron-version "3.0.3">
<!ENTITY gpm-version "1.20.5">
<!ENTITY fcron-version "3.0.4">
<!ENTITY hdparm-version "7.7">
<!ENTITY which-version "2.19">
<!ENTITY which-version "2.20">
<!ENTITY unzip-version "5.52">
<!ENTITY zip-version "2.32">
<!ENTITY pciutils-version "2.2.3">
<!ENTITY usbutils-version "0.72">
<!ENTITY pkgconfig-version "0.22">
<!ENTITY pkgconfig-version "0.23">
<!ENTITY cpio-version "2.9">
<!ENTITY mc-version "4.6.1">
<!ENTITY sysstat-version "7.0.4">
326,7 → 327,7
<!ENTITY pppoe-version "3.8">
<!-- Chapter 16 -->
<!ENTITY curl-version "7.16.3">
<!ENTITY curl-version "7.19.0">
<!ENTITY wvstreams-version "4.2.2">
<!ENTITY gnet-version "2.0.7">
<!ENTITY libsoup-version "2.2.100">
344,7 → 345,7
<!-- <!ENTITY ncpfs-version "2.2.4"> -->
<!ENTITY net-tools-version "1.60">
<!ENTITY wireless-tools-version "28">
<!ENTITY ntp-version "4.2.4p0">
<!ENTITY ntp-version "4.2.4p5">
<!ENTITY openssh-version "4.7p1">
<!ENTITY portmap-version "6.0">
<!ENTITY rsync-version "3.0.2">
351,12 → 352,12
<!ENTITY samba3-version "3.0.30">
<!ENTITY subversion-version "1.4.4">
<!ENTITY tcpwrappers-version "7.6">
<!ENTITY wget-version "1.10.2">
<!ENTITY wget-version "1.11.4">
<!-- Chapter 19 -->
<!ENTITY traceroute-version "1.4a12">
<!ENTITY nmap-version "4.20">
<!ENTITY whois-version "4.7.26">
<!ENTITY whois-version "4.7.28">
<!ENTITY bind-version "9.4.1-P1">
<!ENTITY wireshark-version "0.99.6">
364,7 → 365,7
<!ENTITY mailx-version "12.2">
<!ENTITY procmail-version "3.22">
<!ENTITY fetchmail-version "6.3.8">
<!ENTITY mutt-version "1.5.17">
<!ENTITY mutt-version "1.5.18">
<!ENTITY pine-version "4.64">
<!ENTITY tin-version "1.8.3">
376,7 → 377,7
<!-- Chapter 21 -->
<!ENTITY apache-version "2.2.8">
<!-- bind (chapter 19) -->
<!ENTITY nfs-utils-version "1.1.2">
<!ENTITY nfs-utils-version "1.1.4">
<!-- openssh (chapter 18) -->
<!ENTITY proftpd-version "1.3.0">
<!-- samba3 (chapter 18) -->

/trunk/blfs/INSTALL
1,5 → 1,5
$LastChangedBy: bdubbs $
$Date: 2008-08-30 14:59:27 $
$Date: 2008-11-16 21:27:59 $
Ok, so you have downloaded the XML source. Now what? You are probably

/trunk/blfs/appendices/ac-free-lic.xml
File deleted

/trunk/blfs/appendices/mit-lic.xml
0,0 → 1,38
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../general.ent">
%general-entities;
]>
<appendix id="MIT" xreflabel="MIT License">
<?dbhtml filename="mit.html" ?>
<appendixinfo>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</appendixinfo>
<title>The MIT License</title>
<para>Copyright &copy; &copyrightdate; &copyholder;</para>
<para>Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:</para>
<para>The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.</para>
<para>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.</para>
</appendix>

/trunk/blfs/general/genlib/libpcap.xml
File deleted

/trunk/blfs/general/genlib/mcs.xml
0,0 → 1,200
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY mcs-download-http "http://distfiles.atheme.org/libmcs-&mcs-version;.tgz">
<!ENTITY mcs-download-ftp " ">
<!ENTITY mcs-md5sum "0f0c779609b3481a79937c2e86660a99">
<!ENTITY mcs-size "103 KB">
<!ENTITY mcs-buildsize "1.3 MB">
<!ENTITY mcs-time "less than 0.1 SBU">
]>
<sect1 id="mcs" xreflabel="mcs-&mcs-version;">
<?dbhtml filename="mcs.html"?>
<sect1info>
<othername>$LastChangedBy: chris $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>mcs-&mcs-version;</title>
<indexterm zone="mcs">
<primary sortas="a-mcs">mcs</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to mcs</title>
<para>The <application>mcs</application> package is a library and set of
tools which abstract the storage of configuration settings away from
userland applications. There are similar projects like this (such as
<application>GConf</application>), but unlike those projects,
<application>mcs</application> strictly handles abstraction. It does not
impose any specific data storage requirement, nor is it tied to any
desktop environment or software suite.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&mcs-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&mcs-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &mcs-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &mcs-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &mcs-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &mcs-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">mcs Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="Mowgli"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="GConf"/> and
<xref linkend="kdelibs"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/mcs"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of mcs</title>
<para>Install <application>mcs</application> by
running the following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m644 -D README /usr/share/doc/mcs-&mcs-version;/README</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><option>--with-qt-path=/usr/share/qt</option>: If you have
<xref linkend="kdelibs"/> installed, you must pass
additional parameters to the <command>configure</command> script to
identify the location of Qt and, possibly, KDE libraries and interface
headers.</para>
<para>For additional information about the various storage backends
(including the default XDG-compliant backend), see the
<filename>README</filename> file in the source tree.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring mcs</title>
<para>There are various ways to configure <application>mcs</application>
to use a specific backend on a site-wide or individual user basis. If the
default file-based storage backend is suitable, no configuration steps are
required. See section 2 of the <filename>README</filename> file in the
source tree for details.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>mcs-getconfval, mcs-info, mcs-query-backends and
mcs-setconfval</seg>
<seg>libmcs.so and backend storage modules</seg>
<seg>/usr/include/mcs, /usr/lib/mcs and
/usr/share/doc/mcs-&mcs-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="mcs-getconfval">
<term><command>mcs-getconfval</command></term>
<listitem>
<para>queries <application>mcs</application> for a configuration
value.</para>
<indexterm zone="mcs mcs-getconfval">
<primary sortas="b-mcs-getconfval">mcs-getconfval</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mcs-info">
<term><command>mcs-info</command></term>
<listitem>
<para>displays information about the current installation and
configuration of <application>mcs</application>.</para>
<indexterm zone="mcs mcs-info">
<primary sortas="b-mcs-info">mcs-info</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mcs-query-backends">
<term><command>mcs-query-backends</command></term>
<listitem>
<para>queries <application>mcs</application> to determine what
backends are available.</para>
<indexterm zone="mcs mcs-query-backends">
<primary sortas="b-mcs-query-backends">mcs-query-backends</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="mcs-setconfval">
<term><command>mcs-setconfval</command></term>
<listitem>
<para>instructs <application>mcs</application> to change a
configuration value.</para>
<indexterm zone="mcs mcs-setconfval">
<primary sortas="b-mcs-setconfval">mcs-setconfval</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libmcs">
<term><filename class='libraryfile'>libmcs.so</filename></term>
<listitem>
<para>contains the API functions required by the
<application>mcs</application> userspace tools.</para>
<indexterm zone="mcs libmcs">
<primary sortas="c-libmcs.so">libmcs.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/libidn.xml
0,0 → 1,197
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY libidn-download-http "&sources-anduin-http;/l/libidn-&libidn-version;.tar.gz">
<!-- <!ENTITY libidn-download-http "http://josefsson.org/libidn/releases/libidn-&libidn-version;.tar.gz"> -->
<!ENTITY libidn-download-ftp "ftp://alpha.gnu.org/pub/gnu/libidn/libidn-&libidn-version;.tar.gz">
<!ENTITY libidn-md5sum "040f012a45feb56168853998bb87ad4d">
<!ENTITY libidn-size "2.3 MB">
<!ENTITY libidn-buildsize "19 MB">
<!ENTITY libidn-time "0.2 SBU">
]>
<sect1 id="libidn" xreflabel="libidn-&libidn-version;">
<?dbhtml filename="libidn.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Libidn-&libidn-version;</title>
<indexterm zone="libidn">
<primary sortas="a-Libidn">Libidn</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Libidn</title>
<para><application>Libidn</application> is a package designed for
internationalized string handling based on the <ulink
url="http://josefsson.org/cgi-bin/rfcmarkup?url=http://www.ietf.org/rfc/rfc3454.txt">
Stringprep</ulink>, <ulink
url="http://josefsson.org/cgi-bin/rfcmarkup?url=http://www.ietf.org/rfc/rfc3492.txt">
Punycode</ulink>, <ulink
url="http://josefsson.org/cgi-bin/rfcmarkup?url=http://www.ietf.org/rfc/rfc3490.txt">
IDNA</ulink> and <ulink
url="http://josefsson.org/cgi-bin/rfcmarkup?url=http://josefsson.org/cgi-bin/viewcvs.cgi/*checkout*/libidn/doc/specifications/draft-hoffman-idn-reg-02.txt">
TLD</ulink> specifications defined by the Internet Engineering Task Force
(IETF) Internationalized Domain Names (IDN) working group, used for
internationalized domain names. This is useful for converting data from the
system's native representation into UTF-8, transforming Unicode strings
into ASCII strings, allowing applications to use certain ASCII name labels
(beginning with a special prefix) to represent non-ASCII name labels, and
converting entire domain names to and from the ASCII Compatible Encoding
(ACE) form.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libidn-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libidn-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libidn-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libidn-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libidn-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libidn-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Libidn Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="emacs"/>,
<xref linkend="pkgconfig"/>,
<xref linkend="gtk-doc"/>,
a Java compiler&mdash;one of (looked for in this order)
<xref linkend="gcc"/> (for <command>gcj</command> and you must also have
the <ulink url="ftp://ftp.gnu.org/gnu/classpath/">gjdoc</ulink> package
installed),
<ulink url="http://jikes.sourceforge.net/">Jikes</ulink> or
<xref linkend="jdk"/>,
and a C# compiler&mdash;<ulink
url="http://www.mono-project.com/Main_Page">Mono</ulink> or
<ulink url="http://www.southern-storm.com.au/portable_net.html">
DotGNU Portable.NET</ulink></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libidn"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Libidn</title>
<para>Install <application>Libidn</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<!-- <para>If you have <xref linkend="tetex"/> installed and wish to create a
text version of the documentation, issue the following commands:</para>
<screen><userinput>cd doc &amp;&amp;
makeinfo (double-dash removed intentionally) -plaintext -o libidn.txt libidn.texi &amp;&amp;
cd ..</userinput></screen> -->
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install &amp;&amp;
find doc -name "Makefile*" -exec rm {} \; &amp;&amp;
install -v -m755 -d \
/usr/share/doc/libidn-&libidn-version;/{api,java,specifications,tld} &amp;&amp;
install -v -m644 doc/components* \
doc/libidn.{pdf,ps,html} \
/usr/share/doc/libidn-&libidn-version; &amp;&amp;
install -v -m644 doc/reference/html/* \
/usr/share/doc/libidn-&libidn-version;/api &amp;&amp;
install -v -m644 doc/specifications/* \
/usr/share/doc/libidn-&libidn-version;/specifications &amp;&amp;
install -v -m644 doc/tld/* /usr/share/doc/libidn-&libidn-version;/tld &amp;&amp;
cp -v -R doc/java/* /usr/share/doc/libidn-&libidn-version;/java</userinput></screen>
<!-- <para>If you created the text documentation, install it using the following
command as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>install -v -m644 doc/libidn.txt /usr/share/doc/libidn-&libidn-version;</userinput></screen> -->
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>idn</seg>
<seg>libidn.{so,a} and optionally, Java and C# modules</seg>
<seg>/usr/share/doc/libidn-&libidn-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="idn">
<term><command>idn</command></term>
<listitem>
<para>is a command line interface to the internationalized domain
name library.</para>
<indexterm zone="libidn idn">
<primary sortas="b-idn">idn</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libidn-lib">
<term><filename class='libraryfile'>libidn.{so,a}</filename></term>
<listitem>
<para> contains a generic Stringprep implementation that does Unicode
3.2 NFKC normalization, mapping and prohibition of characters, and
bidirectional character handling. Profiles for Nameprep, iSCSI, SASL
and XMPP are included as well as support for Punycode and ASCII
Compatible Encoding (ACE) via IDNA. A mechanism to define Top-Level
Domain (TLD) specific validation tables, and to compare strings
against those tables, as well as default tables for some TLDs are
included.</para>
<indexterm zone="libidn libidn-lib">
<primary sortas="c-libidn">libidn.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/libdrm.xml
0,0 → 1,117
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY libdrm-download-http "http://dri.freedesktop.org/libdrm/libdrm-&libdrm-version;.tar.gz">
<!ENTITY libdrm-download-ftp "&gentoo-ftp-repo;/libdrm-&libdrm-version;.tar.gz">
<!ENTITY libdrm-md5sum "f2f5d3186bee51be49e1389bed39a7ed">
<!ENTITY libdrm-size "382 KB">
<!ENTITY libdrm-buildsize "2.7 MB">
<!ENTITY libdrm-time "0.1 SBU">
]>
<sect1 id="libdrm" xreflabel="libdrm-&libdrm-version;">
<?dbhtml filename="libdrm.html"?>
<sect1info>
<othername>$LastChangedBy: bdubbs $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>libdrm-&libdrm-version;</title>
<indexterm zone="libdrm">
<primary sortas="a-libdrm">libdrm</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to libdrm</title>
<para><application>libdrm</application> provides core library routines
for the X Window System to directly interface with video hardware using
the Linux kernel's Direct Rendering Modules.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libdrm-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libdrm-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libdrm-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libdrm-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libdrm-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libdrm-time;</para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libdrm"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of libdrm</title>
<!-- <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../../xincludes/xorg7-only.xml"/> -->
<para>Install <application>libdrm</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=$XORG_PREFIX &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libdrm.{so,a}</seg>
<seg><envar>$XORG_PREFIX</envar>/include/drm</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libdrm-lib">
<term><filename class='libraryfile'>libdrm.{so,a}</filename></term>
<listitem>
<para>contains the Direct Rendering Module library functions.</para>
<indexterm zone="libdrm libdrm-lib">
<primary sortas="c-libdrm">libdrm.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/libpthread-stubs.xml
0,0 → 1,100
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY libpthread-stubs-download-http "http://xcb.freedesktop.org/dist/libpthread-stubs-&libpthread-stubs-version;.tar.bz2">
<!ENTITY libpthread-stubs-download-ftp "ftp://ftp.x.org/pub/individual/lib/libpthread-stubs-&libpthread-stubs-version;.tar.bz2">
<!ENTITY libpthread-stubs-md5sum "774eabaf33440d534efe108ef9130a7d">
<!ENTITY libpthread-stubs-size "190 KB">
<!ENTITY libpthread-stubs-buildsize "1.6 MB">
<!ENTITY libpthread-stubs-time "less than 0.1 SBU">
]>
<sect1 id="libpthread-stubs" xreflabel="libpthread-stubs-&libpthread-stubs-version;">
<?dbhtml filename="libpthread-stubs.html"?>
<sect1info>
<othername>$LastChangedBy: dnicholson $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>libpthread-stubs-&libpthread-stubs-version;</title>
<indexterm zone="libpthread-stubs">
<primary sortas="a-libpthread-stubs">libpthread-stubs</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to libpthread-stubs</title>
<para>The <application>libpthread-stubs</application> package provides
weak aliases for pthread functions not provided in libc or otherwise
available by default. This is useful for libraries that rely on pthread
stubs to use pthreads optionally. On Linux, all necessary pthread
functions are available, so this package is simply a placeholder.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libpthread-stubs-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libpthread-stubs-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libpthread-stubs-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libpthread-stubs-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libpthread-stubs-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libpthread-stubs-time;</para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libpthread-stubs"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of libpthread-stubs</title>
<para>Install <application>libpthread-stubs</application> by running the
following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/libassuan.xml
0,0 → 1,178
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY libassuan-download-http "&sources-anduin-http;/l/libassuan-&libassuan-version;.tar.bz2">
<!-- <!ENTITY libassuan-download-http "http://public.ftp.planetmirror.com/pub/gcrypt/libassuan/libassuan-&libassuan-version;.tar.bz2"> -->
<!ENTITY libassuan-download-ftp "ftp://ftp.gnupg.org/gcrypt/libassuan/libassuan-&libassuan-version;.tar.bz2">
<!ENTITY libassuan-md5sum "ffb95bf2bac23e173f5a83a270f7524a">
<!ENTITY libassuan-size "297 KB">
<!ENTITY libassuan-buildsize "4 MB">
<!ENTITY libassuan-time "0.1 SBU">
]>
<sect1 id="libassuan" xreflabel="Libassuan-&libassuan-version;">
<?dbhtml filename="libassuan.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Libassuan-&libassuan-version;</title>
<indexterm zone="libassuan">
<primary sortas="a-Libassuan">Libassuan</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Libassuan</title>
<para>The <application>Libassuan</application> package contains an IPC
library used by some of the other <application>GnuPG</application> related
packages. <application>Libassuan</application>'s primary use is to allow a
client to interact with a non-persistent server.
<application>Libassuan</application> is not, however, limited to use with
<application>GnuPG</application> servers and clients. It was designed to be
flexible enough to meet the demands of many transaction based environments
with non-persistent servers.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libassuan-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libassuan-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libassuan-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libassuan-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libassuan-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libassuan-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Libassuan Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="pth"/></para>
<para>Other packages (such as <application>GnuPG-2</application>) will
require that the <application>Libassuan</application> library is linked to
the <application>Pth</application> library. Ensure
<application>Pth</application> is installed before beginning the build if
you have any doubts.</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libassuan"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Libassuan</title>
<para>Install <application>Libassuan</application> by running the
following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>Only <command>info</command> documentation is shipped in the package
tarball. If you wish to build alternate formats of the documentation, you
must have <xref linkend="tetex"/> installed, then issue the following
commands:</para>
<screen><userinput>make -k -C doc pdf ps html &amp;&amp;
makeinfo --html --no-split -o doc/assuan_nochunks.html doc/assuan.texi &amp;&amp;
makeinfo --plaintext -o doc/assuan.txt doc/assuan.texi</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m644 -D README /usr/share/doc/libassuan-&libassuan-version;/README</userinput></screen>
<para>If you built the additional documentation, install it by issuing the
following commands as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/libassuan-&libassuan-version;/html &amp;&amp;
install -v -m644 doc/assuan.html/* \
/usr/share/doc/libassuan-&libassuan-version;/html &amp;&amp;
install -v -m644 doc/assuan_*.html \
/usr/share/doc/libassuan-&libassuan-version; &amp;&amp;
install -v -m644 doc/assuan.{pdf,ps,dvi,txt,texi} \
/usr/share/doc/libassuan-&libassuan-version;</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>libassuan-config</seg>
<seg>libassuan.a and libassuan-pth.a</seg>
<seg>/usr/share/doc/libassuan-&libassuan-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libassuan-config">
<term><command>libassuan-config</command></term>
<listitem>
<para>is a utility used to configure and build applications based on
the libassuan(3) library. It can be used to query the C compiler and
linker flags which are required to correctly compile and link the
application against the libassuan(3) library.</para>
<indexterm zone="libassuan libassuan-config">
<primary sortas="b-libassuan-config">libassuan-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libassuan-lib">
<term><filename class='libraryfile'>libassuan.a</filename></term>
<listitem>
<para>is the IPC library.</para>
<indexterm zone="libassuan libassuan-lib">
<primary sortas="c-libassuan">libassuan.a</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libassuan-pth">
<term><filename class='libraryfile'>libassuan-pth.a</filename></term>
<listitem>
<para>is the IPC library linked with the GNU Portable Threads
Library.</para>
<indexterm zone="libassuan libassuan-pth">
<primary sortas="c-libassuan-pth">libassuan-pth.a</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/iso-codes.xml
0,0 → 1,119
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!-- Package Home Page: http://pkg-isocodes.alioth.debian.org -->
<!-- <!ENTITY iso-codes-download-http "&sources-anduin-http;/i/iso-codes_&iso-codes-version;.tar.gz"> -->
<!ENTITY iso-codes-download-http " ">
<!ENTITY iso-codes-download-ftp "ftp://pkg-isocodes.alioth.debian.org/pub/pkg-isocodes/iso-codes-&iso-codes-version;.tar.bz2">
<!ENTITY iso-codes-md5sum "9326469ec0e9e97d604821bd3c132fc6">
<!ENTITY iso-codes-size "6.1 MB">
<!ENTITY iso-codes-buildsize "73 MB">
<!ENTITY iso-codes-time "0.2 SBU">
]>
<sect1 id="iso-codes" xreflabel="ISO Codes-&iso-codes-version;">
<?dbhtml filename="iso-codes.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>ISO Codes-&iso-codes-version;</title>
<indexterm zone="iso-codes">
<primary sortas="a-ISO-Codes">ISO Codes</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to ISO Codes</title>
<para>The <application>ISO Codes</application> package contains a list of
country, language and currency names. This is useful when used as a central
database for accessing this data.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&iso-codes-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&iso-codes-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &iso-codes-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &iso-codes-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &iso-codes-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &iso-codes-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">ISO Codes Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="python"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/iso-codes"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of ISO Codes</title>
<para>Install <application>ISO Codes</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<!--
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>./autogen.sh</command>: This command is a shell script used
to generate the required Autotools files and then executes the
<command>configure</command> script. <parameter>- -prefix=/usr</parameter>
is passed to the script and automatically added as a parameter to the
<command>configure</command> script.</para>
</sect2>
-->
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>None</seg>
<seg>/usr/share/iso-codes, /usr/share/xml/iso-codes and
many directories in the /usr/share/locale hierarchy</seg>
</seglistitem>
</segmentedlist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/dbus-bindings.xml
0,0 → 1,377
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY dbus-glib-download-http "http://dbus.freedesktop.org/releases/dbus-glib/dbus-glib-&dbus-glib-version;.tar.gz">
<!ENTITY dbus-glib-download-ftp " ">
<!ENTITY dbus-glib-md5sum "0923d825a0aff2e4eb23338b630286fb">
<!ENTITY dbus-glib-size "654 KB">
<!ENTITY dbus-glib-buildsize "9 MB">
<!ENTITY dbus-glib-time "0.2 SBU">
<!ENTITY dbus-python-download-http "http://dbus.freedesktop.org/releases/dbus-python/dbus-python-&dbus-python-version;.tar.gz">
<!ENTITY dbus-python-download-ftp " ">
<!ENTITY dbus-python-md5sum "024522ffba612f0d41b64269e925835c">
<!ENTITY dbus-python-size "482 KB">
<!ENTITY dbus-python-buildsize "6 MB">
<!ENTITY dbus-python-time "0.1 SBU">
<!ENTITY dbus-qt3-download-http "&files-anduin;/sources/dbus-qt3-&dbus-qt3-version;.tar.bz2">
<!ENTITY dbus-qt3-download-ftp " ">
<!ENTITY dbus-qt3-md5sum "307e119f501c207a437d1dd087c9af80">
<!ENTITY dbus-qt3-size "390 KB">
<!ENTITY dbus-qt3-buildsize "4 MB">
<!ENTITY dbus-qt3-time "0.1 SBU">
<!-- All the other bindings info should be here as well -->
]>
<sect1 id="dbus-bindings" xreflabel="D-Bus Bindings">
<?dbhtml filename="dbus-bindings.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>D-Bus Bindings</title>
<indexterm zone="dbus-bindings">
<primary sortas="a-dbus-bindings">D-Bus Bindings</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to D-Bus Bindings</title>
<para>The <application>D-Bus Bindings</application> are a group of packages
that contain programming language and platform interfaces to the D-Bus API.
This is useful for programmers to easily interface D-Bus with their
supported platform or language of choice. Some non-D-Bus packages will
require one or more of the Bindings packages in order to build
successfully.</para>
<para>The <application>GLib</application>,
<application>Python</application> and <application>Qt3</application>
Bindings are included on this page. Other language bindings will be added
soon. Until then, see the <ulink
url="http://www.freedesktop.org/wiki/Software/DBusBindings">D-Bus
Bindings</ulink> page for information.</para>
<itemizedlist spacing="compact">
<listitem>
<para><xref linkend="dbus-glib"/></para>
</listitem>
<listitem>
<para><xref linkend="dbus-python"/></para>
</listitem>
<listitem>
<para><xref linkend="dbus-qt3"/></para>
</listitem>
</itemizedlist>
</sect2>
<!-- Below is 111 lines to cut and paste to create a new binding -->
<!-- Begin D-Bus GLib Bindings -->
<sect2 id="dbus-glib" xreflabel="D-Bus GLib Bindings-&dbus-glib-version;">
<title>D-Bus GLib Bindings</title>
<indexterm zone="dbus-glib">
<primary sortas="a-dbus-glib">D-Bus GLib Bindings</primary>
</indexterm>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&dbus-glib-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&dbus-glib-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &dbus-glib-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &dbus-glib-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &dbus-glib-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &dbus-glib-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">D-Bus GLib Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="dbus"/>,
<xref linkend="glib2"/>, and
<xref linkend="expat"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/dbus-glib"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of D-Bus GLib Bindings</title>
<para>Install <application>D-Bus GLib Bindings</application> by
running the following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>dbus-binding-tool</seg>
<seg>libdbus-glib-1.{so,a}</seg>
<seg>/usr/share/gtk-doc/html/dbus-glib</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="glib-dbus-binding-tool">
<term><command>dbus-binding-tool</command></term>
<listitem>
<para>is a tool used to interface with the D-Bus API.</para>
<indexterm zone="dbus-glib glib-dbus-binding-tool">
<primary sortas="b-dbus-binding-tool">dbus-binding-tool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libdbus-glib-1">
<term><filename class='libraryfile'>libdbus-glib-1.{so,a}</filename></term>
<listitem>
<para>contains <application>GLib</application> interface functions
to the D-Bus API.</para>
<indexterm zone="dbus-glib libdbus-glib-1">
<primary sortas="c-libdbus-glib-1">libdbus-glib-1.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!-- Begin D-Bus Python Bindings -->
<sect2 id="dbus-python" xreflabel="D-Bus Python Bindings-&dbus-python-version;">
<title>D-Bus Python Bindings</title>
<indexterm zone="dbus-python">
<primary sortas="a-dbus-python">D-Bus Python Bindings</primary>
</indexterm>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&dbus-python-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&dbus-python-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &dbus-python-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &dbus-python-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &dbus-python-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &dbus-python-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">D-Bus Python Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="python"/> and
<xref linkend="dbus-glib"/></para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="required"><xref linkend="pkgconfig"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><ulink
url="&gnome-download-http;/pygobject"> PyGObject</ulink> (required to run
the test suite)</para>
<bridgehead renderas="sect4">Optional
(Required to build the API Documentation)</bridgehead>
<para role="optional"><ulink
url="http://epydoc.sourceforge.net/">Epydoc</ulink>
and <ulink url="http://docutils.sourceforge.net/">Docutils</ulink></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/dbus-python"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of D-Bus Python Bindings</title>
<para>Install <application>D-Bus Python Bindings</application> by
running the following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>. Note you
must have <application>PyGObject</application> installed.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>None</seg>
<seg><application>Python</application>
<application>D-Bus</application> modules</seg>
<seg>/usr/lib/python&python-majorver;/site-packages/dbus and
/usr/share/doc/dbus-python</seg>
</seglistitem>
</segmentedlist>
</sect2>
<!-- Begin D-Bus Qt3 Bindings -->
<sect2 id="dbus-qt3" xreflabel="D-Bus Qt3 Bindings-&dbus-qt3-version;">
<title>D-Bus Qt3 Bindings</title>
<indexterm zone="dbus-qt3">
<primary sortas="a-dbus-qt3">D-Bus Qt3 Bindings</primary>
</indexterm>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&dbus-qt3-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&dbus-qt3-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &dbus-qt3-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &dbus-qt3-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &dbus-qt3-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &dbus-qt3-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">D-Bus Qt3 Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="dbus"/> and
<xref linkend="qt"/></para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended"><xref linkend="pkgconfig"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/dbus-qt3"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of D-Bus Qt3 Bindings</title>
<para>Install <application>D-Bus Qt3 Bindings</application> by
running the following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libdbus-qt-1.so</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libdbus-qt-1">
<term><filename class='libraryfile'>libdbus-qt-1.{so,a}</filename></term>
<listitem>
<para>contains <application>Qt3</application> interface functions
to the D-Bus API.</para>
<indexterm zone="dbus-qt3 libdbus-qt-1">
<primary sortas="c-libdbus-qt-1">libdbus-qt-1.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/pth.xml
0,0 → 1,142
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY pth-download-http "http://ftp.gnu.org/gnu/pth/pth-&pth-version;.tar.gz">
<!ENTITY pth-download-ftp "ftp://ftp.gnu.org/gnu/pth/pth-&pth-version;.tar.gz">
<!ENTITY pth-md5sum "9cb4a25331a4c4db866a31cbe507c793">
<!ENTITY pth-size "652 KB">
<!ENTITY pth-buildsize "5 MB">
<!ENTITY pth-time "0.2 SBU">
]>
<sect1 id="pth" xreflabel="Pth-&pth-version;">
<?dbhtml filename="pth.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Pth-&pth-version;</title>
<indexterm zone="pth">
<primary sortas="a-Pth">Pth</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Pth</title>
<para>The <application>Pth</application> package contains a very portable
POSIX/ANSI-C based library for Unix platforms which provides non-preemptive
priority-based scheduling for multiple threads of execution (multithreading)
inside event-driven applications. All threads run in the same address space
of the server application, but each thread has its own individual
program-counter, run-time stack, signal mask and errno variable. </para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&pth-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&pth-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &pth-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &pth-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &pth-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &pth-time;</para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/pth"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Pth</title>
<caution>
<para>Don't add the <option>--enable-pthread</option> parameter to the
<command>configure</command> command below else you will overwrite the
pthread library and interface header installed by the
<application>Glibc</application> package in LFS.</para>
</caution>
<para>Install <application>Pth</application> by running the
following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/pth-&pth-version; &amp;&amp;
install -v -m644 README PORTING SUPPORT TESTS \
/usr/share/doc/pth-&pth-version;</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>pth-config</seg>
<seg>libpth.{so,a}</seg>
<seg>/usr/share/doc/pth-&pth-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="pth-config">
<term><command>pth-config</command></term>
<listitem>
<para>is a utility used to configure and build applications based on
the pth(3) library. It can be used to query the C compiler and
linker flags which are required to correctly compile and link the
application against the pth(3) library.</para>
<indexterm zone="pth pth-config">
<primary sortas="b-pth-config">pth-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libpth">
<term><filename class='libraryfile'>libpth.{so,a}</filename></term>
<listitem>
<para>contains the API functions used by the GNU Portable Threads
Library.</para>
<indexterm zone="pth libpth">
<primary sortas="c-libpth">libpth.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/libgpg-error.xml
0,0 → 1,143
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY libgpg-error-download-http "&sources-anduin-http;/l/libgpg-error-&libgpg-error-version;.tar.bz2">
<!ENTITY libgpg-error-download-ftp "ftp://ftp.gnupg.org/gcrypt/libgpg-error/libgpg-error-&libgpg-error-version;.tar.bz2">
<!ENTITY libgpg-error-md5sum "8599b96c911b1df1be24a6ff4ec3c364">
<!ENTITY libgpg-error-size "372 KB">
<!ENTITY libgpg-error-buildsize "5 MB">
<!ENTITY libgpg-error-time "0.1 SBU">
]>
<sect1 id="libgpg-error" xreflabel="Libgpg-error-&libgpg-error-version;">
<?dbhtml filename="libgpg-error.html"?>
<sect1info>
<othername>$LastChangedBy: chris $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Libgpg-error-&libgpg-error-version;</title>
<indexterm zone="libgpg-error">
<primary sortas="a-Libgpg-error">Libgpg-error</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Libgpg-error</title>
<para>The <application>Libgpg-error</application> package contains a
library that defines common error values for all
<application>GnuPG</application> components. Among these are GPG, GPGSM,
GPGME, GPG-Agent, libgcrypt, Libksba, DirMngr, Pinentry, SmartCard Daemon
and more.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libgpg-error-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libgpg-error-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libgpg-error-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libgpg-error-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libgpg-error-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libgpg-error-time;</para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libgpg-error"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Libgpg-error</title>
<para>Install <application>Libgpg-error</application> by running the
following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m644 -D README /usr/share/doc/libgpg-error-&libgpg-error-version;/README</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>gpg-error and gpg-error-config</seg>
<seg>libgpg-error.{so,a}</seg>
<seg>/usr/share/common-lisp</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="gpg-error">
<term><command>gpg-error</command></term>
<listitem>
<para>is used to determine <application>Libgpg-error</application>
error codes.</para>
<indexterm zone="libgpg-error gpg-error">
<primary sortas="b-gpg-error">gpg-error</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gpg-error-config">
<term><command>gpg-error-config</command></term>
<listitem>
<para>is a utility used to configure and build applications based on
the Libgpg-error library. It can be used to query the C compiler and
linker flags which are required to correctly compile and link the
application against the Libgpg-error library.</para>
<indexterm zone="libgpg-error gpg-error-config">
<primary sortas="b-gpg-error-config">gpg-error-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="liblibgpg-error">
<term><filename class='libraryfile'>liblibgpg-error.{so,a}</filename></term>
<listitem>
<para>contains the <application>Libgpg-error</application> API
functions.</para>
<indexterm zone="libgpg-error liblibgpg-error">
<primary sortas="c-liblibgpg-error">liblibgpg-error.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/gamin.xml
0,0 → 1,167
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gamin-download-http "http://www.gnome.org/~veillard/gamin/sources/gamin-&gamin-version;.tar.gz">
<!ENTITY gamin-download-ftp "&gentoo-ftp-repo;/gamin-&gamin-version;.tar.gz">
<!ENTITY gamin-md5sum "2d3a6a70df090ed923238e381e6c2982">
<!ENTITY gamin-size "632 KB">
<!ENTITY gamin-buildsize "6 MB">
<!ENTITY gamin-time "0.1 SBU (up to 3 minutes, processor independent, to run the test suite)">
]>
<sect1 id="gamin" xreflabel="Gamin-&gamin-version;">
<?dbhtml filename="gamin.html"?>
<sect1info>
<othername>$LastChangedBy: dj $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Gamin-&gamin-version;</title>
<sect2 role="package">
<title>Introduction to Gamin</title>
<para>The <application>Gamin</application> package contains a
File Alteration Monitor which is useful for notifying applications of
changes to the file system. Gamin is compatible with <ulink
url="http://oss.sgi.com/projects/fam/">FAM</ulink>.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gamin-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gamin-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &gamin-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &gamin-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gamin-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &gamin-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Gamin Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="glib2"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="python"/></para>
<!-- Though configure mentions these two packages, the build
system can and does absolutely nothing with them. Commenting
them out for now, as they cannot be used
<xref linkend="gtk-doc"/> (for building API documentation),
<xref linkend="doxygen"/> (for building documentation),
-->
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gamin"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Gamin</title>
<para>Install <application>Gamin</application> by running the
following commands:</para>
<screen><userinput>./configure --prefix=/usr --libexecdir=/usr/sbin &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>. Note
that some tests may display errors.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/gamin-&gamin-version; &amp;&amp;
install -v -m644 doc/*.{html,fig,gif,txt} /usr/share/doc/gamin-&gamin-version;</userinput></screen>
</sect2>
<sect2 role="configuration">
<title>Configuring Gamin</title>
<sect3>
<title>Configuration Information</title>
<para>No configuration is generally required and the default options
should work for most users. See
<ulink url="http://www.gnome.org/~veillard/gamin/config.html"/> for
details.</para>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>gam_server</seg>
<seg>libfam.{so,a}, libgamin-1.{so,a}, libgamin_shared.a and
optionally, <application>Python</application> _gamin.{so,a}
module</seg>
<seg>/usr/share/doc/gamin-&gamin-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="gam_server">
<term><command>gam_server</command></term>
<listitem>
<para>is the file alteration monitor daemon that is started on demand
for each user.</para>
<indexterm zone="gamin gam_server">
<primary sortas="b-gam_server">gam_server</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgamin">
<term><filename class='libraryfile'>libgamin.{so,a}</filename></term>
<listitem>
<para>contains functions that support the file allocation monitor.</para>
<indexterm zone="gamin libgamin">
<primary sortas="c-libgamin">libgamin.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libfam">
<term><filename class='libraryfile'>libfam.{so,a}</filename></term>
<listitem>
<para>contains functions that provide compatibility with FAM.</para>
<indexterm zone="gamin libfam">
<primary sortas="c-libfam">libfam.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/mowgli.xml
0,0 → 1,117
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY Mowgli-download-http "http://distfiles.atheme.org/libmowgli-&Mowgli-version;.tgz">
<!ENTITY Mowgli-download-ftp " ">
<!ENTITY Mowgli-md5sum "80f8a27f1b44b0b129215f858ab1ab82">
<!ENTITY Mowgli-size "106 KB">
<!ENTITY Mowgli-buildsize "2.0 MB">
<!ENTITY Mowgli-time "less than 0.1 SBU">
]>
<sect1 id="Mowgli" xreflabel="Mowgli-&Mowgli-version;">
<?dbhtml filename="Mowgli.html"?>
<sect1info>
<othername>$LastChangedBy: alexander $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Mowgli-&Mowgli-version;</title>
<indexterm zone="Mowgli">
<primary sortas="a-Mowgli">Mowgli</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Mowgli</title>
<para>The <application>Mowgli</application> package contains a
development framework for C, similar to <xref linkend="glib2"/>. It
provides high performance and highly flexible algorithms for routine
tasks such as reference-counting, linked lists and spinlocks, and thus
helps programmers write better engineered code.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&Mowgli-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&Mowgli-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &Mowgli-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &Mowgli-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &Mowgli-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &Mowgli-time;</para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/Mowgli"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Mowgli</title>
<para>Install <application>Mowgli</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>This package does not come with a formal test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libmowgli.so</seg>
<seg>/usr/include/libmowgli</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libmowgli">
<term><filename class='libraryfile'>libmowgli.so</filename></term>
<listitem>
<para>libraries contain optimized functions for various common
C programming tasks.</para>
<indexterm zone="Mowgli libmowgli">
<primary sortas="c-libmowgli">libmowgli.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/gmime.xml
0,0 → 1,202
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gmime-download-http "http://spruce.sourceforge.net/gmime/sources/v2.2/gmime-&gmime-version;.tar.gz">
<!ENTITY gmime-download-ftp " ">
<!-- <!ENTITY gmime-download-ftp "&gentoo-ftp-repo;/gmime-&gmime-version;.tar.gz"> -->
<!ENTITY gmime-md5sum "6b5be6a0d4d9380fd0491ad2536c4087">
<!ENTITY gmime-size "947 KB">
<!ENTITY gmime-buildsize "21 MB">
<!ENTITY gmime-time "0.4 SBU (includes building the Mono bindings)">
]>
<sect1 id="gmime" xreflabel="GMime-&gmime-version;">
<?dbhtml filename="gmime.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>GMime-&gmime-version;</title>
<indexterm zone="gmime">
<primary sortas="a-GMime">GMime</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to GMime</title>
<para>The <application>GMime</application> package contains a set of
utilities for parsing and creating messages using the Multipurpose
Internet Mail Extension (MIME) as defined by the applicable RFCs. See the
<ulink url="http://spruce.sourceforge.net/gmime/">GMime web site</ulink>
for the RFCs resourced. This is useful as it provides an API which adheres
to the MIME specification as closely as possible while also providing
programmers with an extremely easy to use interface to the API
functions.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gmime-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gmime-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &gmime-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &gmime-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gmime-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &gmime-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">GMime Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="glib2"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="gtk-doc"/> and
<ulink url="http://go-mono.com/sources/">Gtk#</ulink> (requires
<ulink url="http://www.mono-project.com/Main_Page">Mono</ulink>)</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gmime"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of GMime</title>
<para>Install <application>GMime</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>If you have <xref linkend="docbook-utils"/> installed and you wish
to generate the API tutorials, issue the following commands:</para>
<screen><userinput>cd docs/tutorial &amp;&amp;
docbook2html --nochunks gmime-tut.sgml &amp;&amp;
docbook2pdf gmime-tut.sgml &amp;&amp;
docbook2ps gmime-tut.sgml &amp;&amp;
docbook2txt gmime-tut.sgml &amp;&amp;
cd ../..</userinput></screen>
<para>To test the results, issue <command>make check</command>. Note that
some tests may fail because the corresponding sub-system is not installed
or configured properly.</para>
<para>This package will overwrite the <command>uudecode</command> and
<command>uuencode</command> programs installed by the
<application>sharutils</application> package (or any other package that
may install these programs) if they exist in
<filename class='directory'>/usr/bin</filename>. If you wish to preserve
the existing programs, ensure you rename them before issuing the following
commands.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/gmime-&gmime-version; &amp;&amp;
install -v -m644 README docs{,/tutorial}/gmime* \
/usr/share/doc/gmime-&gmime-version;</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>gmime-config, uudecode and uuencode</seg>
<seg>libgmime-2.0.{so,a} and optionally,
<application>Mono</application> bindings</seg>
<seg>/usr/include/gmime-2.0, /usr/lib/mono/gac/gmime-sharp,
/usr/lib/mono/gmime-sharp,
/usr/share/doc/gmime-&gmime-version; and
/usr/share/gtk-doc/html/gmime</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="gmime-config">
<term><command>gmime-config</command></term>
<listitem>
<para>is used to gather information about how and where
<application>GMime</application> was installed. It is typically
used by other programs seeking to link to the
<application>GMime</application> library.</para>
<indexterm zone="gmime gmime-config">
<primary sortas="b-gmime-config">gmime-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="uudecode">
<term><command>uudecode</command></term>
<listitem>
<para>is used to decode files or data encoded with
<command>uuencode</command>.</para>
<indexterm zone="gmime uudecode">
<primary sortas="b-uudecode">uudecode</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="uuencode">
<term><command>uuencode</command></term>
<listitem>
<para>is a method of encoding binary data into 7-bit ASCII
data.</para>
<indexterm zone="gmime uuencode">
<primary sortas="b-uuencode">uuencode</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgmime-2.0">
<term><filename class='libraryfile'>libgmime-2.0.{so,a}</filename></term>
<listitem>
<para>contains API functions used by programs that need to adhere to
the MIME standards.</para>
<indexterm zone="gmime libgmime-2.0">
<primary sortas="c-libgmime-2.0">libgmime-2.0.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/libgcrypt.xml
0,0 → 1,157
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY libgcrypt-download-http "&sources-anduin-http;/l/libgcrypt-&libgcrypt-version;.tar.bz2">
<!ENTITY libgcrypt-download-ftp "ftp://ftp.gnupg.org/gcrypt/libgcrypt/libgcrypt-&libgcrypt-version;.tar.bz2">
<!ENTITY libgcrypt-md5sum "3675d3e74c3a44aed629d9b12a30bb51">
<!ENTITY libgcrypt-size "799 KB">
<!ENTITY libgcrypt-buildsize "19 MB">
<!ENTITY libgcrypt-time "0.3 SBU">
]>
<sect1 id="libgcrypt" xreflabel="Libgcrypt-&libgcrypt-version;">
<?dbhtml filename="libgcrypt.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Libgcrypt-&libgcrypt-version;</title>
<indexterm zone="libgcrypt">
<primary sortas="a-Libgcrypt">Libgcrypt</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Libgcrypt</title>
<para>The <application>Libgcrypt</application> package contains a general
purpose crypto library based on the code used in
<application>GnuPG</application>. The library provides a high level
interface to cryptographic building blocks using an extendable and flexible
API.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libgcrypt-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libgcrypt-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libgcrypt-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libgcrypt-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libgcrypt-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libgcrypt-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Libgcrypt Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="libgpg-error"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libgcrypt"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Libgcrypt</title>
<para>Install <application>Libgcrypt</application> by running the
following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>Only <command>info</command> documentation is shipped in the package
tarball. If you wish to build alternate formats of the documentation, you
must have <xref linkend="tetex"/> installed, then issue the following
commands:</para>
<screen><userinput>make -C doc pdf ps html &amp;&amp;
makeinfo --html --no-split -o doc/gcrypt_nochunks.html doc/gcrypt.texi &amp;&amp;
makeinfo --plaintext -o doc/gcrypt.txt doc/gcrypt.texi</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m644 -D README /usr/share/doc/libgcrypt-&libgcrypt-version;/README</userinput></screen>
<para>If you built the additional documentation, install it by issuing the
following commands as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/libgcrypt-&libgcrypt-version;/html &amp;&amp;
install -v -m644 doc/gcrypt.html/* \
/usr/share/doc/libgcrypt-&libgcrypt-version;/html &amp;&amp;
install -v -m644 doc/gcrypt_*.html \
/usr/share/doc/libgcrypt-&libgcrypt-version; &amp;&amp;
install -v -m644 doc/gcrypt.{pdf,ps,dvi,txt,texi} \
/usr/share/doc/libgcrypt-&libgcrypt-version;</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>libgcrypt-config</seg>
<seg>libgcrypt.{so,a}</seg>
<seg>/usr/share/doc/libgcrypt-&libgcrypt-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libgcrypt-config">
<term><command>libgcrypt-config</command></term>
<listitem>
<para>is a utility used to configure and build applications based on
the libgcrypt(3) library. It can be used to query the C compiler and
linker flags which are required to correctly compile and link the
application against the libgcrypt(3) library.</para>
<indexterm zone="libgcrypt libgcrypt-config">
<primary sortas="b-libgcrypt-config">libgcrypt-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgcrypt-lib">
<term><filename class='libraryfile'>libgcrypt.{so,a}</filename></term>
<listitem>
<para>contains the cryptographic API functions.</para>
<indexterm zone="libgcrypt libgcrypt-lib">
<primary sortas="c-libgcrypt">libgcrypt.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/libgtkhtml.xml
0,0 → 1,138
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY libgtkhtml-download-http "&gnome-download-http;/libgtkhtml/2.11/libgtkhtml-&libgtkhtml-version;.tar.bz2">
<!ENTITY libgtkhtml-download-ftp "&gnome-download-ftp;/libgtkhtml/2.11/libgtkhtml-&libgtkhtml-version;.tar.bz2">
<!ENTITY libgtkhtml-md5sum "a1d1a197dcff8c4571659deef5495e24">
<!ENTITY libgtkhtml-size "597 KB">
<!ENTITY libgtkhtml-buildsize "36 MB">
<!ENTITY libgtkhtml-time "0.8 SBU">
]>
<sect1 id="libgtkhtml" xreflabel="libgtkhtml-&libgtkhtml-version;">
<?dbhtml filename="libgtkhtml.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>libgtkhtml-&libgtkhtml-version;</title>
<indexterm zone="libgtkhtml">
<primary sortas="a-Libgtkhtml">Libgtkhtml</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to libgtkhtml</title>
<para>The <application>libgtkhtml</application> package contains the
<filename class="libraryfile">libgtkhtml-2</filename> library. This
library provides an API for rendering HTML.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libgtkhtml-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libgtkhtml-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libgtkhtml-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libgtkhtml-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libgtkhtml-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libgtkhtml-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">libgtkhtml Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="gtk2"/> and
<xref linkend="libxml2"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="gail"/> and
<xref linkend="gnome-vfs"/> (only used in the test suite)</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libgtkhtml"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of libgtkhtml</title>
<para>Install <application>libgtkhtml</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr --disable-accessibility &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite. You can run a test
program which includes many test cases; if desired, issue:
<command>( cd tests; ./testgtkhtml )</command></para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--disable-accessibility</parameter>: This forces the
package to build without linking to the
<filename class='libraryfile'>libgailutil</filename> accessibility
library. Remove this switch if you have <application>GAIL</application>
installed.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libgtkhtml-2.{so,a}</seg>
<seg>/usr/include/gtkhtml-2.0</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libgtkhtml-2">
<term><filename class='libraryfile'>libgtkhtml-2.{so,a}</filename></term>
<listitem>
<para>provides the functions necessary to render and/or
edit HTML.</para>
<indexterm zone="libgtkhtml libgtkhtml-2">
<primary sortas="c-libgtkhtml-2">libgtkhtml-2.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genlib/libksba.xml
0,0 → 1,160
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY libksba-download-http "&sources-anduin-http;/l/libksba-&libksba-version;.tar.bz2">
<!ENTITY libksba-download-ftp "ftp://ftp.gnupg.org/gcrypt/libksba/libksba-&libksba-version;.tar.bz2">
<!ENTITY libksba-md5sum "3cccb3ef697e1e69eeceeea0715ff220">
<!ENTITY libksba-size "525 KB">
<!ENTITY libksba-buildsize "13 MB">
<!ENTITY libksba-time "0.2 SBU">
]>
<sect1 id="libksba" xreflabel="Libksba-&libksba-version;">
<?dbhtml filename="libksba.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Libksba-&libksba-version;</title>
<indexterm zone="libksba">
<primary sortas="a-Libksba">Libksba</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Libksba</title>
<para>The <application>Libksba</application> package contains a library
used to make X.509 certificates as well as making the CMS (Cryptographic
Message Syntax) easily accessible by other applications. Both
specifications are building blocks of S/MIME and TLS. The library does not
rely on another cryptographic library but provides hooks for easy
integration with <application>Libgcrypt</application>.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libksba-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libksba-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libksba-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libksba-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libksba-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libksba-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Libksba Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="libgpg-error"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libksba"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Libksba</title>
<para>Install <application>Libksba</application> by running the
following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>Only <command>info</command> documentation is shipped in the package
tarball. If you wish to build alternate formats of the documentation, you
must have <xref linkend="tetex"/> installed, then issue the following
commands:</para>
<screen><userinput>tex --output-directory=doc ksba.texi &amp;&amp;
dvips -o doc/ksba.ps doc/ksba.dvi &amp;&amp;
make -C doc pdf html &amp;&amp;
makeinfo --html --no-split -o doc/ksba_nochunks.html doc/ksba.texi &amp;&amp;
makeinfo --plaintext -o doc/ksba.txt doc/ksba.texi</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m644 -D README /usr/share/doc/libksba-&libksba-version;/README</userinput></screen>
<para>If you built the additional documentation, install it by issuing the
following commands as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>install -v -m755 -d /usr/share/doc/libksba-&libksba-version;/html &amp;&amp;
install -v -m644 doc/ksba.html/* \
/usr/share/doc/libksba-&libksba-version;/html &amp;&amp;
install -v -m644 doc/ksba_*.html \
/usr/share/doc/libksba-&libksba-version; &amp;&amp;
install -v -m644 doc/ksba.{pdf,ps,dvi,txt,texi} \
/usr/share/doc/libksba-&libksba-version;</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>libksba-config</seg>
<seg>libksba.{so,a}</seg>
<seg>/usr/share/doc/libksba-&libksba-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libksba-config">
<term><command>libksba-config</command></term>
<listitem>
<para>is a utility used to configure and build applications based on
the libksba(3) library. It can be used to query the C compiler and
linker flags which are required to correctly compile and link the
application against the libksba(3) library.</para>
<indexterm zone="libksba libksba-config">
<primary sortas="b-libksba-config">libksba-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libksba-lib">
<term><filename class='libraryfile'>libksba.{so,a}</filename></term>
<listitem>
<para>contains the cryptographic API functions.</para>
<indexterm zone="libksba libksba-lib">
<primary sortas="c-libksba">libksba.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/prog/python.xml
File deleted

/trunk/blfs/general/prog/j2sdk.xml
File deleted

/trunk/blfs/general/prog/python-modules.xml
0,0 → 1,870
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY pyxml-download-http "&sourceforge-repo;/pyxml/PyXML-&pyxml-version;.tar.gz">
<!ENTITY pyxml-download-ftp "&gentoo-ftp-repo;/PyXML-&pyxml-version;.tar.gz">
<!ENTITY pyxml-md5sum "1f7655050cebbb664db976405fdba209">
<!ENTITY pyxml-size "734 KB">
<!ENTITY pyxml-buildsize "14.6 MB">
<!ENTITY pyxml-time "less than 0.1 SBU">
<!ENTITY pycairo-download-http "http://cairographics.org/releases/pycairo-&pycairo-version;.tar.gz">
<!ENTITY pycairo-download-ftp " ">
<!ENTITY pycairo-md5sum "e26e77919b606113f565d70036c1f504">
<!ENTITY pycairo-size "468 KB">
<!ENTITY pycairo-buildsize "5.2 MB">
<!ENTITY pycairo-time "0.1 SBU">
<!ENTITY pygobject-download-http "&gnome-download-http;/pygobject/2.12/pygobject-&pygobject-version;.tar.bz2">
<!ENTITY pygobject-download-ftp "&gnome-download-ftp;/pygobject/2.12/pygobject-&pygobject-version;.tar.bz2">
<!ENTITY pygobject-md5sum "009986021225b7ea6e0ba848707785af">
<!ENTITY pygobject-size "331 KB">
<!ENTITY pygobject-buildsize "5.2">
<!ENTITY pygobject-time "0.1 SBU">
<!ENTITY pygtk-download-http "&gnome-download-http;/pygtk/2.10/pygtk-&pygtk-version;.tar.bz2">
<!ENTITY pygtk-download-ftp "&gnome-download-ftp;/pygtk/2.10/pygtk-&pygtk-version;.tar.bz2">
<!ENTITY pygtk-md5sum "f051e25adcbdc1ddcf736fadad3d66f2">
<!ENTITY pygtk-size "1.9 MB">
<!ENTITY pygtk-buildsize "5.2 MB">
<!ENTITY pygtk-time "0.7 SBU">
<!ENTITY pyorbit-download-http "&gnome-download-http;/pyorbit/2.14/pyorbit-&pyorbit-version;.tar.bz2">
<!ENTITY pyorbit-download-ftp "&gnome-download-ftp;/pyorbit/2.14/pyorbit-&pyorbit-version;.tar.bz2">
<!ENTITY pyorbit-md5sum "3c4d42ae1a7303fd85071a842617043f">
<!ENTITY pyorbit-size "0.3 MB">
<!ENTITY pyorbit-buildsize "5.3 MB">
<!ENTITY pyorbit-time "0.1 SBU">
<!ENTITY gnome-python-download-http "&gnome-download-http;/gnome-python/2.18/gnome-python-&gnome-python-version;.tar.bz2">
<!ENTITY gnome-python-download-ftp "&gnome-download-ftp;/gnome-python/2.18/gnome-python-&gnome-python-version;.tar.bz2">
<!ENTITY gnome-python-md5sum "3df58e4354526d4e0be8524c0bf6ddb8">
<!ENTITY gnome-python-size "0.4 MB">
<!ENTITY gnome-python-buildsize "5.4 MB">
<!ENTITY gnome-python-time "0.3 SBU">
<!ENTITY gnome-python-desktop-download-http "&gnome-download-http;/gnome-python-desktop/2.18/gnome-python-desktop-&gnome-python-desktop-version;.tar.bz2">
<!ENTITY gnome-python-desktop-download-ftp "&gnome-download-ftp;/gnome-python-desktop/2.18/gnome-python-desktop-&gnome-python-desktop-version;.tar.bz2">
<!ENTITY gnome-python-desktop-md5sum "ce1b1c095a69c2656177570a2939fabb">
<!ENTITY gnome-python-desktop-size "0.4 MB">
<!ENTITY gnome-python-desktop-buildsize "5.5 MB">
<!ENTITY gnome-python-desktop-time "0.2 SBU">
]>
<sect1 id="python-modules" xreflabel="Python modules">
<?dbhtml filename="python-modules.html" ?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Python Modules</title>
<indexterm zone="python-modules">
<primary sortas="a-Python-modules">Python modules</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Python Modules</title>
<para>The <application>Python</application> module packages add useful
objects to the <application>Python</application> language. Modules utilized
by packages throughout BLFS are listed here, along with their dependencies.
Installation of the modules shown on this page is meant to follow from top
to bottom to handle optional dependencies in each module.</para>
<itemizedlist spacing="compact">
<listitem>
<para><xref linkend="pyxml"/></para>
</listitem>
<listitem>
<para><xref linkend="pycairo"/></para>
</listitem>
<listitem>
<para><xref linkend="pygobject"/></para>
</listitem>
<listitem>
<para><xref linkend="pygtk"/></para>
</listitem>
<listitem>
<para><xref linkend="pyorbit"/></para>
</listitem>
<listitem>
<para><xref linkend="gnome-python"/></para>
</listitem>
<listitem>
<para><xref linkend="gnome-python-desktop"/></para>
</listitem>
</itemizedlist>
</sect2>
<!-- Begin PyXML -->
<sect2 id="pyxml" xreflabel="PyXML-&pyxml-version;">
<title>PyXML-&pyxml-version;</title>
<indexterm zone="pyxml">
<primary sortas="a-PyXML">PyXML</primary>
</indexterm>
<para>The <application>PyXML</application> package contains a validating
XML parser, an implementation of the SAX and DOM programming interfaces,
an interface to the Expat parser, and a C helper module that can speed up
<filename>xmllib.py</filename> by a factor of five. This is useful for
validating, parsing and manipulating XML files using Python
programs.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&pyxml-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&pyxml-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &pyxml-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &pyxml-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &pyxml-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &pyxml-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">PyXML Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="python"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/pyxml"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of PyXML</title>
<para>Install <application>PyXML</application> by running the following
commands:</para>
<screen><userinput>python setup.py build</userinput></screen>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>python setup.py install &amp;&amp;
install -v -m644 doc/man/xmlproc_*.1 /usr/share/man/man1 &amp;&amp;
install -v -m755 -d /usr/share/doc/PyXML-&pyxml-version; &amp;&amp;
cp -v -R doc demo test /usr/share/doc/PyXML-&pyxml-version; &amp;&amp;
install -v -m644 README* /usr/share/doc/PyXML-&pyxml-version;</userinput></screen>
<para>To run the regression tests, the package must first be installed.
Then, as an unprivileged user, issue the following commands:</para>
<screen><userinput>cd test &amp;&amp;
python regrtest.py &amp;&amp;
cd ..</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>python setup.py build</command>: This command copies the
<filename>*.py</filename> files to a staging area and compiles the C
extensions.</para>
<para><command>python setup.py install</command>: This command installs
the package.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>xmlproc_parse and xmlproc_val</seg>
<seg>PyXML Python library modules</seg>
<seg>/usr/lib/python&python-majorver;/site-packages/_xmlplus and
/usr/share/doc/PyXML-&pyxml-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="xmlproc_parse">
<term><command>xmlproc_parse</command></term>
<listitem>
<para>is a simple XML file parser using the xmlproc parser.</para>
<indexterm zone="pyxml xmlproc_parse">
<primary sortas="b-xmlproc_parse">xmlproc_parse</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xmlproc_val">
<term><command>xmlproc_val</command></term>
<listitem>
<para>is a validating XML file parser using the xmlproc parser.</para>
<indexterm zone="pyxml xmlproc_val">
<primary sortas="b-xmlproc_val">xmlproc_val</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!-- End PyXML -->
<!-- Begin Pycairo -->
<sect2 id="pycairo" xreflabel="Pycairo-&pycairo-version;">
<title>Pycairo-&pycairo-version;</title>
<indexterm zone="pycairo">
<primary sortas="a-Pycairo">Pycairo</primary>
</indexterm>
<para>Pycairo provides <application>Python</application> bindings to
<application>Cairo</application>.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&pycairo-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&pycairo-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &pycairo-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &pycairo-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &pycairo-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &pycairo-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Pycairo Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="python"/> and
<xref linkend="cairo"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/pycairo"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Pycairo</title>
<para>Install <application>Pycairo</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
<para>To run the regression tests, the package must first be installed.
Then, as an unprivileged user, issue the following commands:</para>
<screen><userinput>(cd test &amp;&amp; python test.py)</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>Pycairo Python library module</seg>
<seg>/usr/include/pycairo and
/usr/lib/python&python-majorver;/site-packages/cairo</seg>
</seglistitem>
</segmentedlist>
</sect2>
<!-- End Pycairo -->
<!-- Begin PyGObject -->
<sect2 id="pygobject" xreflabel="PyGObject-&pygobject-version;">
<title>PyGObject-&pygobject-version;</title>
<indexterm zone="pygobject">
<primary sortas="a-PyGObject">PyGObject</primary>
</indexterm>
<para>PyGObject provides <application>Python</application> bindings to the
GObject class from <application>GLib</application>.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&pygobject-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&pygobject-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &pygobject-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &pygobject-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &pygobject-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &pygobject-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">PyGObject Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="python"/> and
<xref linkend="glib2"/></para>
<bridgehead renderas="sect4">Optional (to Build Documentation)</bridgehead>
<para role="optional"><xref linkend="libxslt"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/pygobject"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of PyGObject</title>
<para>Install <application>PyGObject</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--disable-docs</parameter>: This option disables the
rebuilding of the html documentation if <xref linkend="libxslt"/> is
installed.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>PyGObject Python library module</seg>
<seg>/usr/include/pygtk-2.0, /usr/share/pygobject and
/usr/lib/python&python-majorver;/site-packages/gtk-2.0</seg>
</seglistitem>
</segmentedlist>
</sect2>
<!-- End PyGObject -->
<!-- Begin PyGTK -->
<sect2 id="pygtk" xreflabel="PyGTK-&pygtk-version;">
<title>PyGTK-&pygtk-version;</title>
<indexterm zone="pygtk">
<primary sortas="a-PyGTK">PyGTK</primary>
</indexterm>
<para>PyGTK lets you to easily create programs with a graphical user
interface using the <application>Python</application> programming
language.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&pygtk-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&pygtk-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &pygtk-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &pygtk-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &pygtk-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &pygtk-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">PyGTK Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="pygobject"/></para>
<bridgehead renderas="sect4">Required (atk module)</bridgehead>
<para role="required"><xref linkend="atk"/></para>
<bridgehead renderas="sect4">Required (pango module)</bridgehead>
<para role="required"><xref linkend="pango"/></para>
<bridgehead renderas="sect4">Required (pangocairo module)</bridgehead>
<para role="required"><xref linkend="pycairo"/> and
<xref linkend="pango"/></para>
<bridgehead renderas="sect4">Required (gtk and gtk.unixprint
modules)</bridgehead>
<para role="required"><xref linkend="pycairo"/> and
<xref linkend="gtk2"/></para>
<bridgehead renderas="sect4">Required (gtk.libglade module)</bridgehead>
<para role="required"><xref linkend="pycairo"/> and
<xref linkend="libglade"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><ulink url="http://numpy.scipy.org/">Numeric
(version 24.2)</ulink></para>
<bridgehead renderas="sect4">Optional (to Build Documentation)</bridgehead>
<para role="optional"><xref linkend="libxslt"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/pygtk"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of PyGTK</title>
<para>Install <application>PyGTK</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>The tests must be run from an active X display. If this is so,
issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--enable-docs</parameter>: This option enables
rebuilding the html documentation if <xref linkend="libxslt"/> is
installed.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>pygtk-codegen-2.0 and pygtk-demo</seg>
<seg>PyGTK Python library modules</seg>
<seg>/usr/lib/pygtk, /usr/share/pygtk and
/usr/lib/python&python-majorver;/site-packages/gtk-2.0</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="pygtk-codegen-2.0">
<term><command>pygtk-codegen-2.0</command></term>
<listitem>
<para>is a wrapper script to run the <application>PyGTK</application>
codegen module.</para>
<indexterm zone="pygtk pygtk-codegen-2.0">
<primary sortas="b-pygtk-codegen-2.0">pygtk-codegen-2.0</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pygtk-demo">
<term><command>pygtk-demo</command></term>
<listitem>
<para>is a Python wrapper to run the <application>PyGTK</application>
demo program.</para>
<indexterm zone="pygtk pygtk-demo">
<primary sortas="b-pygtk-demo">pygtk-demo</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<!-- End PyGTK -->
<!-- Begin PyORBit -->
<sect2 id="pyorbit" xreflabel="PyORBit-&pyorbit-version;">
<title>PyORBit-&pyorbit-version;</title>
<indexterm zone="pyorbit">
<primary sortas="a-PyORBit">PyORBit</primary>
</indexterm>
<para>This is a <application>Python</application> language binding for
the <application>ORBit2</application> CORBA implementation.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&pyorbit-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&pyorbit-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &pyorbit-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &pyorbit-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &pyorbit-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &pyorbit-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">PyORBit Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="python"/> and
<xref linkend="ORBit2"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/pyorbit"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of PyORBit</title>
<para>Install <application>PyORBit</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<!-- There's some test scripts, but I don't know what to run -->
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>PyORBit Python library module</seg>
<seg>/usr/include/pyorbit-2</seg>
</seglistitem>
</segmentedlist>
</sect2>
<!-- End PyORBit -->
<!-- Begin Gnome-Python -->
<sect2 id="gnome-python" xreflabel="Gnome-Python-&gnome-python-version;">
<title>Gnome-Python-&gnome-python-version;</title>
<indexterm zone="gnome-python">
<primary sortas="a-Gnome-Python">Gnome-Python</primary>
</indexterm>
<para>Gnome-Python provides <application>Python</application> modules
for various GNOME libraries.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gnome-python-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gnome-python-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &gnome-python-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &gnome-python-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gnome-python-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &gnome-python-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Gnome-Python Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="pygtk"/> and
<xref linkend="libgnome"/></para>
<!-- Many modules get their deps pulled in through libgnome: libbonobo,
gnome-vfs, GConf -->
<bridgehead renderas="sect4">Required (gnome.ui module)</bridgehead>
<para role="required"><xref linkend="pyorbit"/> and
<xref linkend="libgnomeui"/></para>
<bridgehead renderas="sect4">Required (gnome.canvas module)</bridgehead>
<para role="required"><xref linkend="libgnomecanvas"/></para>
<bridgehead renderas="sect4">Required (gnomevfs module bonobo
support)</bridgehead>
<para role="required"><xref linkend="pyorbit"/></para>
<bridgehead renderas="sect4">Required (bonobo.ui module)</bridgehead>
<para role="required"><xref linkend="libbonoboui"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gnome-python"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Gnome-Python</title>
<para>Install <application>Gnome-Python</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<!-- Tests were crashing on me; need to figure out why -->
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>Gnome-Python library modules</seg>
<seg>/usr/include/gnome-python-2.0</seg>
</seglistitem>
</segmentedlist>
</sect2>
<!-- End Gnome-Python -->
<!-- Begin Gnome-Python-Desktop -->
<sect2 id="gnome-python-desktop" xreflabel="Gnome-Python-Desktop-&gnome-python-desktop-version;">
<title>Gnome-Python-Desktop-&gnome-python-desktop-version;</title>
<indexterm zone="gnome-python-desktop">
<primary sortas="a-Gnome-Python-Desktop">Gnome-Python-Desktop</primary>
</indexterm>
<para>Gnome-Python-Desktop provides additional <application>Python</application>
modules for GNOME libraries.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gnome-python-desktop-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gnome-python-desktop-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &gnome-python-desktop-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &gnome-python-desktop-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gnome-python-desktop-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &gnome-python-desktop-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Gnome-Python-Desktop Dependencies</bridgehead>
<!-- Not strictly true, but needed to find install directories and
by most modules -->
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="gnome-python"/></para>
<bridgehead renderas="sect4">Required (gnomeapplet module)</bridgehead>
<para role="required"><xref linkend="gnome-panel"/></para>
<bridgehead renderas="sect4">Required (gnomeprint module)</bridgehead>
<para role="required"><xref linkend="libgnomeprint"/></para>
<bridgehead renderas="sect4">Required (gnomeprint.ui module)</bridgehead>
<para role="required"><xref linkend="libgnomeprintui"/></para>
<bridgehead renderas="sect4">Required (gtksourceview module)</bridgehead>
<para role="required"><xref linkend="gtksourceview"/></para>
<bridgehead renderas="sect4">Required (wnck module)</bridgehead>
<para role="required"><xref linkend="libwnck"/></para>
<bridgehead renderas="sect4">Required (totem.plparser module)</bridgehead>
<para role="required"><xref linkend="totem"/></para>
<bridgehead renderas="sect4">Required (gtop module)</bridgehead>
<para role="required"><xref linkend="libgtop"/></para>
<bridgehead renderas="sect4">Required (nautilusburn module)</bridgehead>
<para role="required"><xref linkend="nautilus-cd-burner"/></para>
<bridgehead renderas="sect4">Required (mediaprofiles module)</bridgehead>
<para role="required"><xref linkend="gnome-media"/></para>
<bridgehead renderas="sect4">Required (rsvg module)</bridgehead>
<para role="required"><xref linkend="librsvg"/></para>
<bridgehead renderas="sect4">Required (metacity module)</bridgehead>
<para role="required"><xref linkend="metacity"/></para>
<bridgehead renderas="sect4">Required (gnomekeyring module)</bridgehead>
<para role="required"><xref linkend="gnome-keyring"/></para>
<bridgehead renderas="sect4">Required (gnomedesktop module)</bridgehead>
<para role="required"><xref linkend="gnome-desktop"/></para>
<bridgehead renderas="sect4">Required (bugbuddy module)</bridgehead>
<para role="required"><xref linkend="bug-buddy"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gnome-python-desktop"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Gnome-Python-Desktop</title>
<para>Install <application>Gnome-Python-Desktop</application> by running
the following commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<!-- Tests were crashing on me; need to figure out why -->
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--enable-metacity</parameter>: This option enables
building the metacity module if <xref linkend="metacity"/> is
installed.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>Gnome-Python-Desktop library modules</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
</sect2>
<!-- End Gnome-Python-Desktop -->
</sect1>

/trunk/blfs/general/prog/php.xml
0,0 → 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 php-download-http "http://us2.php.net/distributions/php-&php-version;.tar.bz2">
<!ENTITY php-download-ftp "ftp://ftp.isu.edu.tw/pub/Unix/Web/PHP/distributions/php-&php-version;.tar.bz2">
<!ENTITY php-md5sum "fd26455febdddee0977ce226b9108d9c">
<!ENTITY php-size "4.4 MB">
<!ENTITY php-buildsize "101 MB">
<!ENTITY php-time "1.29 SBU">
]>
<sect1 id="php" xreflabel="PHP-&php-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<?dbhtml filename="php.html"?>
<title><acronym>PHP</acronym>-&php-version;</title>
<sect2>
<title>Introduction à <application><acronym>PHP</acronym></application></title>
<para><application><acronym>PHP</acronym></application> est le préprocesseur
hypertexte <acronym>PHP</acronym>. Principalement utilisé pour les sites web
dynamiques, il permet au code d'être directement embarqué dans le codage
<acronym>HTML</acronym>.</para>
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;:
<ulink url="&php-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;:
<ulink url="&php-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &php-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&php-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&php-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&php-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Téléchargements supplémentaires</title>
<itemizedlist spacing="compact">
<listitem><para>Correctif requis pour Berkeley DB&nbsp;: <ulink
url="&patch-root;/php-&php-version;-db43-1.patch"/></para>
</listitem></itemizedlist>
</sect3>
<sect3><title>Dépendances de <application><acronym>PHP</acronym></application></title>
<sect4><title>Requis</title>
<para><xref linkend="apache"/></para>
</sect4>
<sect4><title>Optionnel</title>
<para><xref linkend="libxml2"/>,
<xref linkend="libxslt"/>,
<xref linkend="openssl"/>,
<ulink url="http://www.fastio.com/">ClibPDF</ulink>,
<xref linkend="libjpeg"/>,
<xref linkend="libtiff"/>,
<xref linkend="curl"/>,
<ulink url="http://qdbm.sourceforge.net/">QDBM</ulink>,
<ulink url="http://cr.yp.to/cdb.html">cdb</ulink>,
<xref linkend="gdbm"/>,
<xref linkend="db"/>,
<xref linkend="fam"/>,
<ulink url="http://www.boutell.com/gd/">GD</ulink>,
<xref linkend="libpng"/>,
X (<xref linkend="xorg"/> ou <xref linkend="xfree86"/>),
<xref linkend="freetype2"/>,
<ulink
url="http://gd.tuwien.ac.at/visual/ibiblio/libs/graphics/t1lib-5.0.2.tar.gz">
t1lib</ulink>,
<xref linkend="gmp"/>
<xref linkend="mysql"/>,
<xref linkend="pcre"/>,
<xref linkend="postgresql"/>,
<xref linkend="aspell"/>,
<xref linkend="pkgconfig"/>,
<xref linkend="html-tidy"/>,
<xref linkend="openldap"/>,
<xref linkend="cyrus-sasl"/>,
<xref linkend="mitkrb"/> or <xref linkend="heimdal"/>,
<ulink url="http://mcrypt.hellug.gr/">libmcrypt</ulink>,
<ulink url="http://mhash.sourceforge.net/">mhash</ulink>,
<ulink url="http://www.net-snmp.org/">Net-SNMP</ulink>,
<ulink url="http://www.sqlite.org/">SQLite</ulink>,
<ulink url="http://dmalloc.com/">Dmalloc</ulink>,
<ulink url="http://www.mnogosearch.org/">mnoGoSearch</ulink>,
<ulink url="http://www.hughes.com.au/products/msql/">Mini SQL</ulink>,
<ulink url="http://www.empress.com/">Empress</ulink>,
<ulink url="http://www.birdstep.com/">Birdstep</ulink>,
<ulink url="http://www.dbmaker.com/">DBMaker</ulink>,
<ulink url="http://www.softwareag.com/">Adabas</ulink>,
<ulink url="http://www.frontbase.com/">FrontBase</ulink>,
<ulink url="http://caudium.net/">Caudium</ulink>,
<ulink url="http://www.openwddx.org/">WDDX</ulink>,
<ulink url="http://partners.adobe.com/asn/acrobat/forms.jsp">
FDF Toolkit</ulink>,
<ulink url="http://www.hyperwave.com/">Hyperwave</ulink>,
<ulink url="http://www.mainstreetsoftworks.com/">Monetra</ulink>,
<xref linkend="expat"/> et
<ulink url="../server/mail.html">MTA</ulink></para>
</sect4>
</sect3>
</sect2>
<sect2>
<title>Installation de <application><acronym>PHP</acronym></application></title>
<note><para>Vous pouvez utiliser les scripts côté serveur
en <application><acronym>PHP</acronym></application>, les scripts en ligne
de commande ou les applications <acronym>GUI</acronym> côté client. Ce livre
fournit des instructions pour configurer
<application><acronym>PHP</acronym></application> pour les scripts côté serveur
car il s'agit de sa forme la plus commune.</para></note>
<para>SI vous avez installé Berkeley DB et souhaitez l'utiliser, appliquez le
correctif suivant&nbsp;:</para>
<screen><userinput><command>patch -Np1 -i ../php-&php-version;-db43-1.patch</command></userinput></screen>
<para>Installez <application><acronym>PHP</acronym></application> en exécutant
les commandes suivantes&nbsp;:</para>
<screen><userinput><command>./configure --prefix=/usr \
--sysconfdir=/etc \
--with-apxs2 \
--with-config-file-path=/etc \
--with-zlib \
--enable-bcmath \
--with-bz2 \
--enable-calendar \
--enable-dba \
--enable-exif \
--enable-ftp \
--with-gettext \
--with-iconv \
--with-ncurses \
--with-readline \
--disable-libxml &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
cp php.ini-recommended /etc/php.ini</command></userinput></screen>
<para>Supprimez le commutateur <parameter>--disable-libxml</parameter> si vous
avez installé <xref linkend="libxml2"/>, sinon <command>pear</command> ne sera
pas construit.</para>
<note><para><acronym>PHP</acronym> a beaucoup plus d'options pour configure qui
activeront le support pour certains logiciels. Vous pouvez utiliser
<command>./configure --help</command> pour voir une liste complète des options
disponibles. De plus, l'utilisation du <ulink url="http://www.php.net/">site
web <acronym>PHP</acronym></ulink> est chaudement recommandé car leur
documentation en ligne est excellente.</para></note>
</sect2>
<sect2>
<title>Configurer <application><acronym>PHP</acronym></application></title>
<sect3><title>Fichiers de configuration</title>
<para><filename>/etc/php.ini</filename>,
<filename>/etc/pear.conf</filename></para>
</sect3>
<sect3><title>Informations de configuration</title>
<para>Pour activer le support de <acronym>PHP</acronym> dans le serveur web
<application>Apache</application>, un nouveau LoadModule (celui-ci devrait être
géré automatiquement par la commande <command>make install</command>) et les
directives AddType doivent être ajoutées au fichier
<filename>httpd.conf</filename>&nbsp;:</para>
<screen><userinput>LoadModule php5_module lib/apache/libphp5.so
AddType application/x-httpd-php .php</userinput></screen>
<para>De plus, il peut aussi être utile d'ajouter une entrée pour
<filename>index.php</filename> dans la directive DirectoryIndex du fichier
<filename>httpd.conf</filename>.</para>
</sect3>
</sect2>
<sect2>
<title>Contenu</title>
<para>Le paquetage <application><acronym>PHP</acronym></application> contient
<command>pear</command>,
<command>php</command>,
<command>php-config</command>,
<command>phpextdist</command> et
<command>phpize</command>.
</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>php</title>
<para><command>php</command> est un interface en ligne de commande qui vous
permet d'analyser et d'exécuter du code <acronym>PHP</acronym>.</para></sect3>
<sect3><title>pear</title>
<para><command>pear</command> est le gestionnaire de paquetages compris dans le
dépôt des extensions et des applications <acronym>PHP</acronym>
(<acronym>PEAR</acronym>).</para></sect3>
</sect2>
</sect1>

/trunk/blfs/general/prog/junit.xml
0,0 → 1,135
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY junit-download-http "&sourceforge-repo;/junit/junit&junit-version;.zip">
<!ENTITY junit-download-ftp " ">
<!ENTITY junit-md5sum "6c22e6733f4ba9d755a437375e3d476e">
<!ENTITY junit-size "643 KB">
<!ENTITY junit-buildsize "5.7 MB">
<!ENTITY junit-time "less than 0.1 SBU">
]>
<sect1 id="junit" xreflabel="JUnit-&junit-version;">
<?dbhtml filename="junit.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>JUnit-&junit-version;</title>
<indexterm zone="junit">
<primary sortas="a-JUnit">JUnit</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to JUnit</title>
<para>The <application>JUnit</application> package contains a simple, open
source framework to write and run repeatable tests. It is an instance of
the xUnit architecture for unit testing frameworks. JUnit features include
assertions for testing expected results, test fixtures for sharing common
test data, and test runners for running tests.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&junit-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&junit-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &junit-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &junit-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &junit-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &junit-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">JUnit Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="unzip"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/junit"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of JUnit</title>
<para>Install <application>JUnit</application> by running the following
commands as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>install -v -m755 -d /usr/share/{,doc/}junit-&junit-version; &amp;&amp;
chown -R root:root . &amp;&amp;
cp -v -R junit* org /usr/share/junit-&junit-version; &amp;&amp;
cp -v -R *.html *doc /usr/share/doc/junit-&junit-version;</userinput></screen>
<para>Add the <filename
class='libraryfile'>junit-&junit-version;.jar</filename> and <filename
class='directory'>/usr/share/junit-&junit-version;</filename> directory to
your system <envar>CLASSPATH</envar> environment variable:</para>
<screen><userinput>export CLASSPATH=$CLASSPATH:\
/usr/share/junit-&junit-version;/junit-&junit-version;.jar:/usr/share/junit-&junit-version;</userinput></screen>
<para>To run the <application>JUnit</application> regression self-tests,
you'll need to have <xref linkend="jdk"/> or <ulink
url="http://jikes.sourceforge.net/">Jikes</ulink> installed and the
<envar>CLASSPATH</envar> environment variable updated. Then, as an
unprivileged user, issue:</para>
<screen><userinput>java org.junit.runner.JUnitCore org.junit.tests.AllTests</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>junit-&junit-version;.jar</seg>
<seg>/usr/share/junit-&junit-version;,
/usr/share/doc/junit-&junit-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="junit.jar">
<term><filename class='libraryfile'>junit-&junit-version;.jar</filename></term>
<listitem>
<para>contains java classes to support the xUnit framework testing
architecture.</para>
<indexterm zone="junit junit.jar">
<primary sortas="c-junit.jar">junit-&junit-version;.jar</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/prog/gc.xml
0,0 → 1,158
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gc-download-http "http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc&gc-version;.tar.gz">
<!ENTITY gc-download-ftp "&gentoo-ftp-repo;/gc&gc-version;.tar.gz">
<!ENTITY gc-md5sum "418d38bd9c66398386a372ec0435250e">
<!ENTITY gc-size "739 KB">
<!ENTITY gc-buildsize "7.1 MB">
<!ENTITY gc-time "0.2 SBU">
]>
<sect1 id="gc" xreflabel="GC-&gc-version;">
<?dbhtml filename="gc.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>GC-&gc-version;</title>
<indexterm zone="gc">
<primary sortas="a-GC">GC</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to GC</title>
<para>The <application>GC</application> package contains the
Boehm-Demers-Weiser conservative garbage collector, which can be used as a
garbage collecting replacement for the C malloc function or C++ new
operator. It allows you to allocate memory basically as you normally would,
without explicitly deallocating memory that is no longer useful. The
collector automatically recycles memory when it determines that it can no
longer be otherwise accessed. The collector is also used by a number of
programming language implementations that either use C as intermediate
code, want to facilitate easier interoperation with C libraries, or just
prefer the simple collector interface. Alternatively, the garbage collector
may be used as a leak detector for C or C++ programs, though that is not
its primary goal.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gc-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gc-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &gc-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &gc-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gc-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &gc-time;</para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gc"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of GC</title>
<para>Install <application>GC</application> by running the following
commands:</para>
<screen><userinput>sed -i "s|\$(datadir)/@PACKAGE@|&amp;-&gc-version;|" doc/Makefile.in &amp;&amp;
./configure --prefix=/usr \
--datadir=/usr/share/doc --enable-cplusplus &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m644 doc/gc.man /usr/share/man/man3/gc_malloc.3 &amp;&amp;
ln -v -s gc_malloc.3 /usr/share/man/man3/gc.3</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>sed -i "s|\$(datadir)/@PACKAGE@|&amp;-&gc-version;|" ...</command>:
This command appends <quote>-&gc-version;</quote> to the default documentation
installation path of
<filename class='directory'>/usr/share/doc/gc</filename>.</para>
<para><parameter>--datadir=/usr/share/doc</parameter>: This parameter
changes the installation path of the documentation to
<filename class='directory'>/usr/share/doc/gc</filename> instead of
<filename class='directory'>/usr/share/gc</filename>.</para>
<para><parameter>--enable-cplusplus</parameter>: This parameter forces
the building and installation of the C++ library along with the standard
C library.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libgc.{so,a} and libgccpp.{so,a}</seg>
<seg>/usr/include/gc and /usr/share/doc/gc-&gc-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libgc">
<term><filename class='libraryfile'>libgc.{so,a}</filename></term>
<listitem>
<para>contains a C interface to the conservative garbage collector,
primarily designed to replace the C malloc function.</para>
<indexterm zone="gc libgc">
<primary sortas="c-libgc">libgc.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libgccpp">
<term><filename class='libraryfile'>libgccpp.{so,a}</filename></term>
<listitem>
<para>contains a C++ interface to the conservative garbage
collector.</para>
<indexterm zone="gc libgccpp">
<primary sortas="c-libgccpp">libgccpp.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/prog/guile.xml
0,0 → 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 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-md5sum "99419494fbbcc257be41309c2a9284f0">
<!ENTITY guile-size "3.0 MB">
<!ENTITY guile-buildsize "36.5 MB">
<!ENTITY guile-time "0.87 SBU">
]>
<sect1 id="guile" xreflabel="Guile-&guile-version;">
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<?dbhtml filename="guile.html"?>
<title>Guile-&guile-version;</title>
<sect2>
<title>Introduction à <application>Guile</application></title>
<para>Le paquetage <application>Guile</application> contient le projet de
bibliothèque de langage d'extensions de <acronym>GNU</acronym>.
<application>Guile</application> contient aussi un interpréteur
<application>Scheme</application> autonome.</para>
<sect3><title>Informations sur le paquetage</title>
<itemizedlist spacing='compact'>
<listitem><para>Téléchargement (HTTP)&nbsp;: <ulink
url="&guile-download-http;"/></para></listitem>
<listitem><para>Téléchargement (FTP)&nbsp;: <ulink
url="&guile-download-ftp;"/></para></listitem>
<listitem><para>Téléchargement de la somme MD5&nbsp;: &guile-md5sum;</para></listitem>
<listitem><para>Taille du téléchargement&nbsp;:&guile-size;</para></listitem>
<listitem><para>Estimation de l'espace disque requis&nbsp;:
&guile-buildsize;</para></listitem>
<listitem><para>Estimation du temps de construction&nbsp;:
&guile-time;</para></listitem></itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Installation de <application>Guile</application></title>
<para>Installez <application>Guile</application> en exécutant les commandes
suivantes&nbsp;:</para>
<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
LD_LIBRARY_PATH="$PWD/libguile-ltdl/.libs" make &amp;&amp;
make install</command></userinput></screen>
</sect2>
<sect2>
<title>Explication des commandes</title>
<para><command>LD_LIBRARY_PATH="$PWD/libguile-ltdl/.libs" make</command>&nbsp;:
Quelque chose est cassé dans la chaîne Autotools. Passer cette variable permet
une construction sans erreur.</para>
</sect2>
<sect2>
<title>Contenu</title>
<para>En plus des bibliothèques <filename class='libraryfile'>libguile</filename>,
le paquetage <application>Guile</application> contient
<command>guile</command>,
<command>guile-config</command>,
<command>guile-snarf</command>,
<command>guile-tools</command> et de nombreux scripts
<application>Guile</application>.
</para>
</sect2>
<sect2><title>Description</title>
<sect3><title>guile</title>
<para><command>guile</command> est un interpréteur Scheme autonome pour
<application>Guile</application>.</para></sect3>
<sect3><title>guile-config</title>
<para><command>guile-config</command> est un script <application>Guile</application>
fournissant les informations nécessaires pour lier vos programmes à la bibliothèque
<application>Guile</application>, de la même façon que le fait
<xref linkend="pkgconfig"></xref>.</para></sect3>
<sect3><title>guile-snarf</title>
<para><command>guile-snarf</command> est un script analysant les déclarations
dans votre code <application>Scheme</application> pour trouver des fonctions
<application>C</application> visibles par <application>Scheme</application>,
des objets <application>Scheme</application> utilisables par du code
<application>C</application>, etc.</para></sect3>
<sect3><title>guile-tools</title>
<para><command>guile-tools</command> est un programme d'emballage installé avec
<command>guile</command> et sachant où un module particulier est installé et
l'appelant en lui passant ses arguments.</para></sect3>
</sect2>
</sect1>

/trunk/blfs/general/prog/jdk.SAVE
0,0 → 1,966
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY jdk-download-binary "http://java.sun.com/javase/downloads/index.jsp">
<!ENTITY jdk-bin-md5sum "f7528500c17c09546566e05988beda86">
<!ENTITY jdk-bin-size "67 MB">
<!ENTITY jdk-bin-buildsize "207 MB">
<!ENTITY jdk-bin-version "6u5">
<!ENTITY jdk-source-jrl-md5sum "83390379fb9f3193e93a9d5eed5b31d9">
<!ENTITY jdk-source-bin-md5sum "8b6f1b8d8dec051c18385539111141ec">
<!ENTITY jdk-source-moz-md5sum "6dcaf7af16211617adff5d672a8b79f4">
<!ENTITY jdk-source-jrl-size "111 MB">
<!ENTITY jdk-source-bin-size "2 MB">
<!ENTITY jdk-source-moz-size "8.2 MB">
<!ENTITY jdk-src-buildsize "1.5 GB">
<!ENTITY jdk-time "12.5 SBU (for both installations)">
<!ENTITY jdk-version-string "6u3">
<!ENTITY jdk-bin-version-string "1.6.0_05">
<!ENTITY jdk-download-source-jrl "http://www.java.net/download/jdk6/&jdk-version-string;/promoted/b05/jdk-&jdk-version-string;-fcs-src-b05-jrl-24_sep_2007.jar">
<!ENTITY jdk-download-source-bin "http://www.java.net/download/jdk6/&jdk-version-string;/promoted/b05/jdk-&jdk-version-string;-fcs-bin-b05-jrl-24_sep_2007.jar">
<!ENTITY jdk-download-source-moz "http://www.java.net/download/jdk6/&jdk-version-string;/promoted/b05/jdk-&jdk-version-string;-fcs-mozilla_headers-b05-unix-24_sep_2007.jar">
]>
<sect1 id="jdk" xreflabel="JDK-&jdk-version;">
<?dbhtml filename="jdk.html" ?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>JDK-&jdk-version;</title>
<indexterm zone="jdk">
<primary sortas="a-JDK">JDK</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to JDK</title>
<para>The <application>JDK</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>
<!-- Previously, the plugin included
in the <application>JDK</application> binary package was unusable on LFS
owing to incompatibilities with <application>GCC</application>-3 compiled
browsers. This is not the case anymore.</para> -->
<para>The <application>JDK</application> comes in two flavors, a
precompiled binary and a source package. You will first need to download
and install the binary version of the <application>JDK</application>
(you'll need to click and agree to the <quote>Sun Microsystems, Inc.
Binary Code License Agreement</quote>). To build from the source, you
will need to read, and agree to the Sun
<!--<ulink url="&patch-root;/jdk-Readme.txt">-->Java Research License<!--</ulink>-->.
You will also need to download the additional files and patches to
complete the source build as detailed below. Note that in some countries
you cannot download the source code.</para>
<warning><para>Sun has recently decided not to provide JRL sources for
the latest update versions of the JDK. The source build instructions and
patches are here for reference only, and contain known security
vulnerabilities. For more information, please see Sun Alerts
<ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-231246-1">231246</ulink>,
<ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233321-1">233321</ulink>,
<ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233322-1">233322</ulink>,
<ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233323-1">233323</ulink>,
<ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233324-1">233324</ulink>,
<ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233325-1">233325</ulink>,
<ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233326-1">233326</ulink>, and
<ulink url="http://sunsolve.sun.com/search/document.do?assetkey=1-66-233327-1">233327</ulink>.</para>
<para> Sun is actively working on a GPL'd version of the JDK, titled
<ulink url="http://openjdk.java.net/projects/jdk6/">OpenJDK</ulink>.
This new JDK will be licensed under the
<ulink url="http://openjdk.java.net/legal/gplv2+ce.html">GNU General
Public License, version 2, with the Classpath Exception</ulink>.
A stable OpenJDK was not available at the time of writing.</para></warning>
<bridgehead renderas="sect3">Binary Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Binary download (jdk-&jdk-bin-version;-linux-i586.bin):
<ulink url="&jdk-download-binary;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &jdk-bin-md5sum;</para>
</listitem>
<listitem>
<para>Download size (binary): &jdk-bin-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &jdk-bin-buildsize;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Source Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>JRL Source
<simplelist>
<member><ulink url="&jdk-download-source-jrl;"/></member>
<member>&jdk-source-jrl-md5sum;</member>
<member>&jdk-source-jrl-size;</member>
</simplelist>
</para>
</listitem>
<listitem>
<para>Source Binaries
<simplelist>
<member><ulink url="&jdk-download-source-bin;"/></member>
<member>&jdk-source-bin-md5sum;</member>
<member>&jdk-source-bin-size;</member>
</simplelist>
</para>
</listitem>
<listitem>
<para>Mozilla Headers
<simplelist>
<member><ulink url="&jdk-download-source-moz;"/></member>
<member>&jdk-source-moz-md5sum;</member>
<member>&jdk-source-moz-size;</member>
</simplelist>
</para>
</listitem>
<listitem>
<para>Estimated disk space required: &jdk-src-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &jdk-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<bridgehead renderas="sect4">Required Patches</bridgehead>
<itemizedlist spacing='compact'>
<listitem>
<para><ulink
url="&patch-root;/jdk-&jdk-version-string;-gcc4-1.patch"/></para>
</listitem>
<listitem>
<para><ulink
url="&patch-root;/jdk-&jdk-version-string;-motif_fixes-1.patch"/></para>
</listitem>
<listitem>
<para><ulink
url="&patch-root;/jdk-&jdk-version-string;-remove_fixed_paths-1.patch"/></para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">JDK Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional Runtime Dependencies (for binary
installation)</bridgehead>
<para role="optional">
<xref linkend="alsa-lib"/>,
<xref linkend="cups"/>, and
<xref linkend="gtk2"/></para>
<bridgehead renderas="sect4">Additional Requirements
(for source build, including optional requirements)</bridgehead>
<para role="required">
<xref linkend="cpio"/>,
<xref linkend="ksh"/>,
<xref linkend="unzip"/>,
<xref linkend="which"/>, and
<xref linkend="zip"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/jdk"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of JDK</title>
<para>The instructions below install both the binary and source versions.
You may stop after installing the binary version or continue on installing
the source version. You can choose to keep either or both.</para>
<tip>
<para>The <command>./jdk-&jdk-bin-version;-linux-i586.bin</command>
command below unpacks the distribution into a
<filename class='directory'>jdk&jdk-bin-version-string;</filename>
directory. You will be required to view, and then accept (by entering a
<keycap>y</keycap> keypress), a license agreement before any files are
unpacked. If you are scripting (automating) the build, you'll need to
account for this. There is information about automating build commands
in the <xref linkend="automating-builds"/> section of Chapter 2. Towards
the end of this section, specific information for automating this type of
installation is discussed.</para>
</tip>
<para>Normally in BLFS, the files are unpacked into a subdirectory
and the starting point for the installation procedures is that
location. For this application only, start in the directory where all
the downloaded files are located.</para>
<para>Install the binary <application>JDK</application> with the
following commands:</para>
<screen><userinput>chmod 755 jdk-&jdk-bin-version;-linux-i586.bin &amp;&amp;
./jdk-&jdk-bin-version;-linux-i586.bin</userinput></screen>
<note><para>The installation will end with a message
"./jdk-&jdk-bin-version;-linux-i586.bin: line 43: 20283 Aborted" as
javaprefix is unset in the environment. This is by design as
<application>GTK+</application> may not be installed during the
installation, however, the installation will still exit with a zero error
value if scripting the build.</para></note>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>cd jdk&jdk-bin-version-string; &amp;&amp;
install -v -m755 -d /opt/jdk-bin-&jdk-bin-version; &amp;&amp;
mv -v * /opt/jdk-bin-&jdk-bin-version; &amp;&amp;
chown -v -R root:root /opt/jdk-bin-&jdk-bin-version; &amp;&amp;
ln -v -sf xawt/libmawt.so \
/opt/jdk-bin-&jdk-bin-version;/jre/lib/i386/ &amp;&amp;
cd ..</userinput></screen>
<para>Recent versions of libX11 break libmawt
when used with the Xinerama extension. While still the
<systemitem class="username">root</systemitem> user, apply the
following sed to the installed binary to work around this
problem:</para>
<screen role="root"><userinput>sed -i 's@XINERAMA@FAKEEXTN@g' \
/opt/jdk-bin-&jdk-bin-version;/jre/lib/i386/xawt/libmawt.so</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 position to
download the source owing to license restrictions, skip ahead to the
configuration section.</para>
<para>Save the existing path, and append the recently installed
<application>JDK</application>.</para>
<screen><userinput>export JAVA_HOME=/opt/jdk-bin-&jdk-bin-version; &amp;&amp;
export PATH_HOLD=${PATH} &amp;&amp;
export PATH=${PATH}:${JAVA_HOME}/bin</userinput></screen>
<para>The source code is contained in self-extracting
<filename class='extension'>jar</filename> files. You
will need to be in a windowed environment to extract the sources.
Create a directory to store the extracted sources. Choose the newly
created <filename class="directory">jdk-build</filename> directory
when prompted for the target directory.</para>
<screen><userinput>mkdir jdk-build &amp;&amp;
cd jdk-build &amp;&amp;
for JAR in ../jdk-&jdk-version-string;*.jar
do java -jar ${JAR}
done</userinput></screen>
<para>Apply all the patches downloaded above:</para>
<screen><userinput>for PATCH in ../jdk-&jdk-version-string;*.patch
do patch -Np1 -i ${PATCH}
done</userinput></screen>
<para>Use the following commands to apply some minor changes that
are a little more specific to BLFS, such as lack of a gcc-2.9
compiler, removing a broken demo, and forcing to link to shared
libraries. See the 'Command Explanations' section for more detail:</para>
<screen><userinput>sed -i '/^.*linux)/ { N; /.*/ { N; /.*/d }}' \
deploy/make/plugin/{adapter,nscore}/Makefile &amp;&amp;
sed -i '/.*mtrace.*/ { N; /.*/ s/.*mtrace.*\n.*/\t mtrace/ }' \
j2se/make/mkdemo/jvmti/Makefile &amp;&amp;
sed -i 's/= true/= false/' \
j2se/make/common/shared/Compiler-gcc.gmk</userinput></screen>
<xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
href="../../xincludes/X11R6_symlink.xml"/>
<!-- <para>If your <application>X Window System</application> is installed into
any prefix other than <filename class="directory">/usr/X11R6</filename>,
execute the following commands, replacing
<replaceable>&lt;PREFIX&gt;</replaceable> with the installation prefix of
the <application>X Window System</application>:</para>
<screen><userinput>for file in `find . -name Makefile \
-or -name Imakefile -or -name *.gmk`
do sed -i 's@/usr/X11R6@<replaceable>&lt;PREFIX&gt;</replaceable>@g' $file
done &amp;&amp;
sed -i 's@/usr/X11R6@<replaceable>&lt;PREFIX&gt;</replaceable>@g' \
j2se/src/solaris/native/sun/awt/fontpath.c \
j2se/src/solaris/classes/sun/awt/motif/linux.fontconfig.Sun.properties \
j2se/src/solaris/classes/sun/awt/motif/linux.fontconfig.RedHat.3.properties</userinput></screen> -->
<para>Set/unset some variables which affect the build:</para>
<screen><userinput>export ALT_BOOTDIR=${JAVA_HOME} &amp;&amp;
export CLASSPATH_HOLD=${CLASSPATH} &amp;&amp;
export ALT_CACERTS_FILE=${ALT_BOOTDIR}/jre/lib/security/cacerts &amp;&amp;
export ALT_MOZILLA_HEADERS_PATH=${PWD}/share/plugin &amp;&amp;
export MILESTONE="03-BLFS" &amp;&amp;
export BUILD_NUMBER="b05" &amp;&amp;
export INSANE=true &amp;&amp;
export DEV_ONLY=true &amp;&amp;
export SKIP_FASTDEBUG_BUILD=true &amp;&amp;
unset JAVA_HOME CLASSPATH CFLAGS CXXFLAGS LDFLAGS</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. -O3, even in
OTHER_C{,XX}FLAGS, is known to cause a build failure.</para></warning>
<para>Additionally, if you would like to <command>make</command> in
parallel, add the following:</para>
<screen><userinput>export HOTSPOT_BUILD_JOBS=<replaceable>&lt;3&gt;</replaceable></userinput></screen>
<para>Build the <application>JDK</application> with the following
commands. There will be a few messages about missing files that look like
errors. These are caused by not meeting the expected build environment
(Red Hat). As long as the build doesn't stop, the messages
are harmless.</para>
<screen><userinput>pushd control/make &amp;&amp;
make &amp;&amp;
popd</userinput></screen>
<para>To test the results, you can run one of the provided demo programs
using the newly created <command>java</command> binary. Issue the
following commands:</para>
<screen><userinput>pushd control/build/linux-i586/j2sdk-image/demo/jfc/Java2D &amp;&amp;
../../../bin/java -jar Java2Demo.jar &amp;&amp;
popd</userinput></screen>
<para>Now, as the <systemitem class="username">root</systemitem> user,
install the <application>JDK</application>:</para>
<screen role="root"><userinput>pushd control/build/linux-i586 &amp;&amp;
cp -v -a j2sdk-image /opt/jdk-&jdk-version-string; &amp;&amp;
chown -v -R root:root /opt/jdk-&jdk-version-string; &amp;&amp;
ln -v -sf xawt/libmawt.so /opt/jdk-&jdk-version-string;/jre/lib/i386/ &amp;&amp;
popd</userinput></screen>
<para>Restore the unprivileged user's environment using the following
commands:</para>
<screen><userinput>export JAVA_HOME=${ALT_BOOTDIR} &amp;&amp;
export CLASSPATH=${CLASSPATH_HOLD} &amp;&amp;
export PATH=${PATH_HOLD} &amp;&amp;
unset PATH_HOLD ALT_BOOTDIR CLASSPATH_HOLD \
ALT_CACERTS_FILE ALT_MOZILLA_HEADERS_PATH \
BUILD_NUMBER MILESTONE INSANE DEV_ONLY \
SKIP_FASTDEBUG_BUILD</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>sed -i '/^.*linux)/...</command>: This command disables
the build of a gcc-2.9 compatible browser plugin. LFS does not contain
gcc-2.9, and hasn't in quite a few years.</para>
<para><command>sed -i '/.*mtrace.*/...</command>: This command disables
building of the broken 'waiters' demo.</para>
<para><command>sed -i 's/= true/= false/'...</command>: This command
forces the compiler to link against the standard C libraries
dynamically.</para>
<para><command>export ALT_BOOTDIR=${JAVA_HOME}</command>: This variable sets
the location of the bootstrap <application>JDK</application>.</para>
<para><command>export ALT_CACERTS_FILE...</command>: Specifies the
certificate file to use (from the installed binary
<application>JDK</application>).</para>
<para><command>export ALT_MOZILLA_HEADERS_PATH=${PWD}/share/plugin/</command>:
This tells the build exactly where to find the
<application>Mozilla</application> headers. This has changed since the
previous version and is not mentioned in the installation documentation
included with the package source.</para>
<para><command>export MILESTONE="03-BLFS"</command>: This appends
the string '03-BLFS' to the buld number. 'internal' is
unconditionally added if MILESTONE is unset. This is similar
to the format used by Sun for the official release.</para>
<para><command>export BUILD_NUMBER="b05"</command>:
This will help you identify the compiled version of the runtime
environment and virtual machine by appending this information to
the version string. This is the same build number used by Sun to
identify the official release.</para>
<para><command>export INSANE=true</command>: The certified platform for the
build is Redhat Enterprise Advanced Server 2.1. This variable ensures that
all the errors related to compiling on a non-certified platform will be
displayed as warnings instead of errors.</para>
<para><command>export DEV_ONLY=true</command>: This command
skips compiling the comparison build.</para>
<para><command>export SKIP_FASTDEBUG_BUILD=true</command>: This command
skips building of the debug version. Omit this command if you need
to build the fastdebug target.</para>
<para><command>unset JAVA_HOME CLASSPATH CFLAGS CXXFLAGS LDFLAGS</command>:
These variables cause miscompilation of the build. Never set them.</para>
<para><command>ln -sf xawt/libmawt.so
/opt/jdk-&jdk-version-string;/jre/lib/i386/</command>: This fixes
linking issues with other applications that expect to find the
<application>motif</application> libraries with the other
<application>JDK</application> libraries.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring JDK</title>
<sect3>
<title>Configuration Information</title>
<para>There are now two Java 2 SDKs installed in
<filename>/opt</filename>. You should decide on which one you
would like to use as the default. For example if you decide to use the
precompiled <application>JDK</application>, do the following as the
<systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>ln -v -nsf jdk-bin-&jdk-bin-version; /opt/jdk</userinput></screen>
<para>The information below assumes your system is set up using the
instructions found in
<quote><xref linkend="postlfs-config-profile"/></quote>. You may need to
extract the relevant information below and incorporate it into your
system's startup files if your system is set up differently.</para>
<para>Add the following <filename>jdk.sh</filename> shell startup file to
the <filename>/etc/profile.d</filename> directory with the following
commands as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>cat &gt; /etc/profile.d/jdk.sh &lt;&lt; "EOF"
<literal># Begin /etc/profile.d/jdk.sh
# Set JAVA_HOME directory
JAVA_HOME=/opt/jdk
# Adjust PATH
pathappend ${JAVA_HOME}/bin PATH
# Auto Java CLASSPATH
# Copy jar files to, or create symlinks in this directory
AUTO_CLASSPATH_DIR=/usr/lib/classpath
pathprepend . CLASSPATH
for dir in `find ${AUTO_CLASSPATH_DIR} -type d 2>/dev/null`; do
pathappend $dir CLASSPATH
done
export JAVA_HOME CLASSPATH
unset AUTO_CLASSPATH_DIR
unset dir
# End /etc/profile.d/jdk.sh</literal>
EOF</userinput></screen>
<para>The <application>Java</application> plugin is located in
<filename class="directory">$JAVA_HOME/jre/plugin/i?86/ns7/</filename>.
Make a symbolic link to the file in that directory from your browser(s)
plugins directory.</para>
<important>
<para>The plugin must be a symlink for it to work. If not, the browsers
will crash when you attempt to load a <application>Java</application>
application.</para>
</important>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>appletviewer, apt, extcheck, idlj, HtmlConverter, jar,
jarsigner, java, javac, javadoc, javah, javap, java-rmi.cgi,
javaws, jconsole, jdb, jhat, jinfo, jmap, jps,
jrunscript, jsadebugd, jstack, jstat, jstatd, keytool,
native2ascii, orbd, pack200, policytool, rmic, rmid, rmiregistry,
schemagen, serialver, servertool, tnameserv, unpack200,
wsgen, wsimport, and xjc</seg>
<seg><envar>$JAVA_HOME</envar>/lib/*,
<envar>$JAVA_HOME</envar>/jre/lib/*,
and libjavaplugin_oji.so</seg>
<seg>/opt/jdk-&jdk-version-string;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="appletviewer">
<term><command>appletviewer</command></term>
<listitem>
<para>runs Java applets outside of the context of a browser.</para>
<indexterm zone="jdk appletviewer">
<primary sortas="b-appletviewer">appletviewer</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="apt">
<term><command>apt</command></term>
<listitem>
<para>is an annotation processing tool.</para>
<indexterm zone="jdk apt">
<primary sortas="b-apt">apt</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="extcheck">
<term><command>extcheck</command></term>
<listitem>
<para>checks a specified jar file for title and version conflicts
with any extensions installed in the <application>JDK</application>
software.</para>
<indexterm zone="jdk extcheck">
<primary sortas="b-extcheck">extcheck</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="HtmlConverter">
<term><command>HtmlConverter</command></term>
<listitem>
<para>adds Java auto download to html and asp pages. </para>
<indexterm zone="jdk HtmlConverter">
<primary sortas="b-HtmlConverter">HtmlConverter</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="idlj">
<term><command>idlj</command></term>
<listitem>
<para>generates Java bindings from a given IDL file.</para>
<indexterm zone="jdk idlj">
<primary sortas="b-idlj">idlj</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jar">
<term><command>jar</command></term>
<listitem>
<para>combines multiple files into a single jar archive.</para>
<indexterm zone="jdk jar">
<primary sortas="b-jar">jar</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jarsigner">
<term><command>jarsigner</command></term>
<listitem>
<para>signs jar files and verifies the signatures and integrity
of a signed jar file.</para>
<indexterm zone="jdk jarsigner">
<primary sortas="b-jarsigner">jarsigner</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="java">
<term><command>java</command></term>
<listitem>
<para>launches a Java application by starting a Java runtime
environment, loading a specified class and invoking its main
method.</para>
<indexterm zone="jdk java">
<primary sortas="b-java">java</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javac">
<term><command>javac</command></term>
<listitem>
<para>reads class and interface definitions, written in the
Java programming language, and compiles them into bytecode
class files.</para>
<indexterm zone="jdk javac">
<primary sortas="b-javac">javac</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javadoc">
<term><command>javadoc</command></term>
<listitem>
<para>parses the declarations and documentation comments in a
set of Java source files and produces a corresponding set of
HTML pages describing the classes, interfaces,constructors,
methods, and fields.</para>
<indexterm zone="jdk javadoc">
<primary sortas="b-javadoc">javadoc</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javah">
<term><command>javah</command></term>
<listitem>
<para>generates C header and source files
that are needed to implement native methods.</para>
<indexterm zone="jdk javah">
<primary sortas="b-javah">javah</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javap">
<term><command>javap</command></term>
<listitem>
<para>disassembles a Java class file.</para>
<indexterm zone="jdk javap">
<primary sortas="b-javap">javap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="java-rmi.cgi">
<term><command>java-rmi.cgi</command></term>
<listitem>
<para>is the Java RMI client.</para>
<indexterm zone="jdk java-rmi.cgi">
<primary sortas="b-java-rmi.cgi">java-rmi.cgi</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javaws">
<term><command>javaws</command></term>
<listitem>
<para>launches Java application/applets hosted on a network.</para>
<indexterm zone="jdk javaws">
<primary sortas="b-javaws">javaws</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jconsole">
<term><command>jconsole</command></term>
<listitem>
<para>is a graphical console tool to monitor and manage both
local and remote Java applications and virtual machines.</para>
<indexterm zone="jdk jconsole">
<primary sortas="b-jconsole">jconsole</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jdb">
<term><command>jdb</command></term>
<listitem>
<para>is a simple command-line debugger for Java classes.</para>
<indexterm zone="jdk jdb">
<primary sortas="b-jdb">jdb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jhat">
<term><command>jhat</command></term>
<listitem>
<para>parses a java heap dump file and allows viewing
in a webbrowser.</para>
<indexterm zone="jdk jhat">
<primary sortas="b-jhat">jhat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jinfo">
<term><command>jinfo</command></term>
<listitem>
<para>prints Java configuration information for a given Java
process, core file, or a remote debug server.</para>
<indexterm zone="jdk jinfo">
<primary sortas="b-jinfo">jinfo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jmap">
<term><command>jmap</command></term>
<listitem>
<para>prints shared object memory maps or heap memory details
of a given process, core file, or a remote debug server.</para>
<indexterm zone="jdk jmap">
<primary sortas="b-jmap">jmap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jps">
<term><command>jps</command></term>
<listitem>
<para>lists the instrumented JVMs on the target system.</para>
<indexterm zone="jdk jps">
<primary sortas="b-jps">jps</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jrunscript">
<term><command>jrunscript</command></term>
<listitem>
<para>is a command line script shell.</para>
<indexterm zone="jdk jrunscript">
<primary sortas="b-jrunscript">jrunscript</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jsadebugd">
<term><command>jsadebugd</command></term>
<listitem>
<para>attaches to a Java process or core file and acts as a
debug server.</para>
<indexterm zone="jdk jsadebugd">
<primary sortas="b-jsadebugd">jsadebugd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jstack">
<term><command>jstack</command></term>
<listitem>
<para>prints Java stack traces of Java threads for a given
Java process, core file, or a remote debug server.</para>
<indexterm zone="jdk jstack">
<primary sortas="b-jstack">jstack</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jstat">
<term><command>jstat</command></term>
<listitem>
<para>displays performance statistics for an instrumented JVM.</para>
<indexterm zone="jdk jstat">
<primary sortas="b-jstat">jstat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jstatd">
<term><command>jstatd</command></term>
<listitem>
<para>is an RMI server application that monitors for the creation
and termination of instrumented JVMs.</para>
<indexterm zone="jdk jstatd">
<primary sortas="b-jstatd">jstatd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="keytool">
<term><command>keytool</command></term>
<listitem>
<para>is a key and certificate management utility.</para>
<indexterm zone="jdk keytool">
<primary sortas="b-keytool">keytool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="native2ascii">
<term><command>native2ascii</command></term>
<listitem>
<para> converts files that contain non-supported character encoding
into files containing Latin-1 or Unicode-encoded characters.</para>
<indexterm zone="jdk native2ascii">
<primary sortas="b-native2ascii">native2ascii</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="orbd">
<term><command>orbd</command></term>
<listitem>
<para>is used to enable clients to transparently locate and invoke
persistent objects on servers in the CORBA environment.</para>
<indexterm zone="jdk orbd">
<primary sortas="b-orbd">orbd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pack200">
<term><command>pack200</command></term>
<listitem>
<para>is a Java application that transforms a jar file into a
compressed pack200 file using the Java gzip compressor.</para>
<indexterm zone="jdk pack200">
<primary sortas="b-pack200">pack200</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="policytool">
<term><command>policytool</command></term>
<listitem>
<para>creates and manages a policy file graphically.</para>
<indexterm zone="jdk policytool">
<primary sortas="b-policytool">policytool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="rmic">
<term><command>rmic</command></term>
<listitem>
<para>generates stub and skeleton class files for remote objects
from the names of compiled Java classes that contain remote
object implementations.</para>
<indexterm zone="jdk rmic">
<primary sortas="b-rmic">rmic</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="rmid">
<term><command>rmid</command></term>
<listitem>
<para>starts the activation system daemon.</para>
<indexterm zone="jdk rmid">
<primary sortas="b-rmid">rmid</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="rmiregistry">
<term><command>rmiregistry</command></term>
<listitem>
<para>creates and starts a remote object registry on the specified
port on the current host.</para>
<indexterm zone="jdk rmiregistry">
<primary sortas="b-rmiregistry">rmiregistry</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="schemagen">
<term><command>schemagen</command></term>
<listitem>
<para>is a Java XML binding schema generator.</para>
<indexterm zone="jdk schemagen">
<primary sortas="b-schemagen">schemagen</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="serialver">
<term><command>serialver</command></term>
<listitem>
<para>returns the serialVersionUID for one or more classes in a
form suitable for copying into an evolving class.</para>
<indexterm zone="jdk serialver">
<primary sortas="b-serialver">serialver</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="servertool">
<term><command>servertool</command></term>
<listitem>
<para>provides an ease-of-use interface for application programmers
to register, unregister, startup and shutdown a server.</para>
<indexterm zone="jdk servertool">
<primary sortas="b-servertool">servertool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="tnameserv">
<term><command>tnameserv</command></term>
<listitem>
<para>starts the Java IDL name server.</para>
<indexterm zone="jdk tnameserv">
<primary sortas="b-tnameserv">tnameserv</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="unpack200">
<term><command>unpack200</command></term>
<listitem>
<para>is a native implementation that transforms a packed file
produced by <application>pack200</application> into a jar
file.</para>
<indexterm zone="jdk unpack200">
<primary sortas="b-unpack200">unpack200</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="wsgen">
<term><command>wsgen</command></term>
<listitem>
<para>generates JAX-WS portable artifacts used in JAX-WS
web services.</para>
<indexterm zone="jdk wsgen">
<primary sortas="b-wsgen">wsgen</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="wsimport">
<term><command>wsimport</command></term>
<listitem>
<para>generates JAX-WS portable artifacts.</para>
<indexterm zone="jdk wsimport">
<primary sortas="b-wsimport">wsimport</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xjc">
<term><command>xjc</command></term>
<listitem>
<para>is a Java XML binding compiler.</para>
<indexterm zone="jdk xjc">
<primary sortas="b-xjc">xjc</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/prog/jdk.xml
0,0 → 1,681
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY jdk-download-http "http://java.sun.com/javase/downloads/index.jsp">
<!ENTITY jdk-md5sum "f7528500c17c09546566e05988beda86">
<!ENTITY jdk-size "67 MB">
<!ENTITY jdk-buildsize "207 MB">
<!ENTITY jdk-bin-version "6u5">
<!ENTITY jdk-build-time "0.3 SBU">
<!ENTITY jdk-version-string "1.6.0_05">
]>
<sect1 id="jdk" xreflabel="JDK-&jdk-version;">
<?dbhtml filename="jdk.html" ?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>JDK-&jdk-version;</title>
<indexterm zone="jdk">
<primary sortas="a-JDK">JDK</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to JDK</title>
<para>The <application>JDK</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>
<note><para>Sun has recently decided not to provide JRL sources for
the latest update versions of the JDK. Sun is actively working on a GPL'd
version of the JDK, titled
<ulink url="http://openjdk.java.net/projects/jdk6/">OpenJDK</ulink>.
This new JDK will be licensed under the
<ulink url="http://openjdk.java.net/legal/gplv2+ce.html">GNU General
Public License, version 2, with the Classpath Exception</ulink>.
A stable OpenJDK was not available at the time of writing.</para></note>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (jdk-&jdk-bin-version;-linux-i586.bin):
<ulink url="&jdk-download-http;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &jdk-md5sum;</para>
</listitem>
<listitem>
<para>Download size (binary): &jdk-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &jdk-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &jdk-build-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">JDK Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional Runtime Dependencies</bridgehead>
<para role="optional">
<xref linkend="alsa-lib"/>,
<xref linkend="cups"/>, and
<xref linkend="gtk2"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/jdk"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of JDK</title>
<tip>
<para>The <command>./jdk-&jdk-bin-version;-linux-i586.bin</command>
command below unpacks the distribution into a
<filename class='directory'>jdk&jdk-version-string;</filename>
directory. You will be required to view, and then accept (by entering a
<keycap>y</keycap> keypress), a license agreement before any files are
unpacked. If you are scripting (automating) the build, you'll need to
account for this. There is information about automating build commands
in the <xref linkend="automating-builds"/> section of Chapter 2. Towards
the end of this section, specific information for automating this type of
installation is discussed.</para>
</tip>
<para>Normally in BLFS, the files are unpacked into a subdirectory
and the starting point for the installation procedures is that
location. For this application only, start in the directory where all
the downloaded files are located.</para>
<para>Install the <application>JDK</application> with the
following commands:</para>
<screen><userinput>chmod 755 jdk-&jdk-bin-version;-linux-i586.bin &amp;&amp;
./jdk-&jdk-bin-version;-linux-i586.bin</userinput></screen>
<note><para>The installation will end with a message
"./jdk-&jdk-bin-version;-linux-i586.bin: line 43: 20283 Aborted" as
javaprefix is unset in the environment. This is by design as
<application>GTK+</application> may not be installed during the
installation, however, the installation will still exit with a zero error
value if scripting the build.</para></note>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>cd jdk&jdk-version-string; &amp;&amp;
install -v -m755 -d /opt/jdk-&jdk-bin-version; &amp;&amp;
mv -v * /opt/jdk-&jdk-bin-version; &amp;&amp;
chown -v -R root:root /opt/jdk-&jdk-bin-version; &amp;&amp;
ln -v -sf xawt/libmawt.so \
/opt/jdk-&jdk-bin-version;/jre/lib/i386/ &amp;&amp;
cd ..</userinput></screen>
<para>Recent versions of libX11 break libmawt
when used with the Xinerama extension. While still the
<systemitem class="username">root</systemitem> user, apply the
following sed to work around this problem:</para>
<screen role="root"><userinput>sed -i 's@XINERAMA@FAKEEXTN@g' \
/opt/jdk-&jdk-bin-version;/jre/lib/i386/xawt/libmawt.so</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>ln -sf xawt/libmawt.so
/opt/jdk-&jdk-bin-version;/jre/lib/i386/</command>: This fixes
linking issues with other applications that expect to find the
<application>motif</application> libraries with the other
<application>JDK</application> libraries.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring JDK</title>
<sect3>
<title>Configuration Information</title>
<para>As the <systemitem class="username">root</systemitem> user, create
a symlink to the installation directory:</para>
<screen role="root"><userinput>ln -v -nsf jdk-&jdk-bin-version; /opt/jdk</userinput></screen>
<para>The information below assumes your system is set up using the
instructions found in
<quote><xref linkend="postlfs-config-profile"/></quote>. You may need to
extract the relevant information below and incorporate it into your
system's startup files if your system is set up differently.</para>
<para>Add the following <filename>jdk.sh</filename> shell startup file to
the <filename>/etc/profile.d</filename> directory with the following
commands as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>cat &gt; /etc/profile.d/jdk.sh &lt;&lt; "EOF"
<literal># Begin /etc/profile.d/jdk.sh
# Set JAVA_HOME directory
JAVA_HOME=/opt/jdk
# Adjust PATH
pathappend ${JAVA_HOME}/bin PATH
# Auto Java CLASSPATH
# Copy jar files to, or create symlinks in this directory
AUTO_CLASSPATH_DIR=/usr/lib/classpath
pathprepend . CLASSPATH
for dir in `find ${AUTO_CLASSPATH_DIR} -type d 2>/dev/null`; do
pathappend $dir CLASSPATH
done
export JAVA_HOME CLASSPATH
unset AUTO_CLASSPATH_DIR
unset dir
# End /etc/profile.d/jdk.sh</literal>
EOF</userinput></screen>
<para>The <application>Java</application> plugin is located in
<filename class="directory">$JAVA_HOME/jre/plugin/i?86/ns7/</filename>.
Make a symbolic link to the file in that directory from your browser(s)
plugins directory.</para>
<important>
<para>The plugin must be a symlink for it to work. If not, the browsers
will crash when you attempt to load a <application>Java</application>
application.</para>
</important>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>appletviewer, apt, extcheck, idlj, HtmlConverter, jar,
jarsigner, java, javac, javadoc, javah, javap, java-rmi.cgi,
javaws, jconsole, jdb, jhat, jinfo, jmap, jps,
jrunscript, jsadebugd, jstack, jstat, jstatd, keytool,
native2ascii, orbd, pack200, policytool, rmic, rmid, rmiregistry,
schemagen, serialver, servertool, tnameserv, unpack200,
wsgen, wsimport, and xjc</seg>
<seg><envar>$JAVA_HOME</envar>/lib/*,
<envar>$JAVA_HOME</envar>/jre/lib/*,
and libjavaplugin_oji.so</seg>
<seg>/opt/jdk-&jdk-bin-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="appletviewer">
<term><command>appletviewer</command></term>
<listitem>
<para>runs Java applets outside of the context of a browser.</para>
<indexterm zone="jdk appletviewer">
<primary sortas="b-appletviewer">appletviewer</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="apt">
<term><command>apt</command></term>
<listitem>
<para>is an annotation processing tool.</para>
<indexterm zone="jdk apt">
<primary sortas="b-apt">apt</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="extcheck">
<term><command>extcheck</command></term>
<listitem>
<para>checks a specified jar file for title and version conflicts
with any extensions installed in the <application>JDK</application>
software.</para>
<indexterm zone="jdk extcheck">
<primary sortas="b-extcheck">extcheck</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="HtmlConverter">
<term><command>HtmlConverter</command></term>
<listitem>
<para>adds Java auto download to html and asp pages. </para>
<indexterm zone="jdk HtmlConverter">
<primary sortas="b-HtmlConverter">HtmlConverter</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="idlj">
<term><command>idlj</command></term>
<listitem>
<para>generates Java bindings from a given IDL file.</para>
<indexterm zone="jdk idlj">
<primary sortas="b-idlj">idlj</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jar">
<term><command>jar</command></term>
<listitem>
<para>combines multiple files into a single jar archive.</para>
<indexterm zone="jdk jar">
<primary sortas="b-jar">jar</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jarsigner">
<term><command>jarsigner</command></term>
<listitem>
<para>signs jar files and verifies the signatures and integrity
of a signed jar file.</para>
<indexterm zone="jdk jarsigner">
<primary sortas="b-jarsigner">jarsigner</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="java">
<term><command>java</command></term>
<listitem>
<para>launches a Java application by starting a Java runtime
environment, loading a specified class and invoking its main
method.</para>
<indexterm zone="jdk java">
<primary sortas="b-java">java</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javac">
<term><command>javac</command></term>
<listitem>
<para>reads class and interface definitions, written in the
Java programming language, and compiles them into bytecode
class files.</para>
<indexterm zone="jdk javac">
<primary sortas="b-javac">javac</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javadoc">
<term><command>javadoc</command></term>
<listitem>
<para>parses the declarations and documentation comments in a
set of Java source files and produces a corresponding set of
HTML pages describing the classes, interfaces,constructors,
methods, and fields.</para>
<indexterm zone="jdk javadoc">
<primary sortas="b-javadoc">javadoc</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javah">
<term><command>javah</command></term>
<listitem>
<para>generates C header and source files
that are needed to implement native methods.</para>
<indexterm zone="jdk javah">
<primary sortas="b-javah">javah</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javap">
<term><command>javap</command></term>
<listitem>
<para>disassembles a Java class file.</para>
<indexterm zone="jdk javap">
<primary sortas="b-javap">javap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="java-rmi.cgi">
<term><command>java-rmi.cgi</command></term>
<listitem>
<para>is the Java RMI client.</para>
<indexterm zone="jdk java-rmi.cgi">
<primary sortas="b-java-rmi.cgi">java-rmi.cgi</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="javaws">
<term><command>javaws</command></term>
<listitem>
<para>launches Java application/applets hosted on a network.</para>
<indexterm zone="jdk javaws">
<primary sortas="b-javaws">javaws</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jconsole">
<term><command>jconsole</command></term>
<listitem>
<para>is a graphical console tool to monitor and manage both
local and remote Java applications and virtual machines.</para>
<indexterm zone="jdk jconsole">
<primary sortas="b-jconsole">jconsole</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jdb">
<term><command>jdb</command></term>
<listitem>
<para>is a simple command-line debugger for Java classes.</para>
<indexterm zone="jdk jdb">
<primary sortas="b-jdb">jdb</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jhat">
<term><command>jhat</command></term>
<listitem>
<para>parses a java heap dump file and allows viewing
in a webbrowser.</para>
<indexterm zone="jdk jhat">
<primary sortas="b-jhat">jhat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jinfo">
<term><command>jinfo</command></term>
<listitem>
<para>prints Java configuration information for a given Java
process, core file, or a remote debug server.</para>
<indexterm zone="jdk jinfo">
<primary sortas="b-jinfo">jinfo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jmap">
<term><command>jmap</command></term>
<listitem>
<para>prints shared object memory maps or heap memory details
of a given process, core file, or a remote debug server.</para>
<indexterm zone="jdk jmap">
<primary sortas="b-jmap">jmap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jps">
<term><command>jps</command></term>
<listitem>
<para>lists the instrumented JVMs on the target system.</para>
<indexterm zone="jdk jps">
<primary sortas="b-jps">jps</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jrunscript">
<term><command>jrunscript</command></term>
<listitem>
<para>is a command line script shell.</para>
<indexterm zone="jdk jrunscript">
<primary sortas="b-jrunscript">jrunscript</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jsadebugd">
<term><command>jsadebugd</command></term>
<listitem>
<para>attaches to a Java process or core file and acts as a
debug server.</para>
<indexterm zone="jdk jsadebugd">
<primary sortas="b-jsadebugd">jsadebugd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jstack">
<term><command>jstack</command></term>
<listitem>
<para>prints Java stack traces of Java threads for a given
Java process, core file, or a remote debug server.</para>
<indexterm zone="jdk jstack">
<primary sortas="b-jstack">jstack</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jstat">
<term><command>jstat</command></term>
<listitem>
<para>displays performance statistics for an instrumented JVM.</para>
<indexterm zone="jdk jstat">
<primary sortas="b-jstat">jstat</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="jstatd">
<term><command>jstatd</command></term>
<listitem>
<para>is an RMI server application that monitors for the creation
and termination of instrumented JVMs.</para>
<indexterm zone="jdk jstatd">
<primary sortas="b-jstatd">jstatd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="keytool">
<term><command>keytool</command></term>
<listitem>
<para>is a key and certificate management utility.</para>
<indexterm zone="jdk keytool">
<primary sortas="b-keytool">keytool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="native2ascii">
<term><command>native2ascii</command></term>
<listitem>
<para> converts files that contain non-supported character encoding
into files containing Latin-1 or Unicode-encoded characters.</para>
<indexterm zone="jdk native2ascii">
<primary sortas="b-native2ascii">native2ascii</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="orbd">
<term><command>orbd</command></term>
<listitem>
<para>is used to enable clients to transparently locate and invoke
persistent objects on servers in the CORBA environment.</para>
<indexterm zone="jdk orbd">
<primary sortas="b-orbd">orbd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="pack200">
<term><command>pack200</command></term>
<listitem>
<para>is a Java application that transforms a jar file into a
compressed pack200 file using the Java gzip compressor.</para>
<indexterm zone="jdk pack200">
<primary sortas="b-pack200">pack200</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="policytool">
<term><command>policytool</command></term>
<listitem>
<para>creates and manages a policy file graphically.</para>
<indexterm zone="jdk policytool">
<primary sortas="b-policytool">policytool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="rmic">
<term><command>rmic</command></term>
<listitem>
<para>generates stub and skeleton class files for remote objects
from the names of compiled Java classes that contain remote
object implementations.</para>
<indexterm zone="jdk rmic">
<primary sortas="b-rmic">rmic</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="rmid">
<term><command>rmid</command></term>
<listitem>
<para>starts the activation system daemon.</para>
<indexterm zone="jdk rmid">
<primary sortas="b-rmid">rmid</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="rmiregistry">
<term><command>rmiregistry</command></term>
<listitem>
<para>creates and starts a remote object registry on the specified
port on the current host.</para>
<indexterm zone="jdk rmiregistry">
<primary sortas="b-rmiregistry">rmiregistry</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="schemagen">
<term><command>schemagen</command></term>
<listitem>
<para>is a Java XML binding schema generator.</para>
<indexterm zone="jdk schemagen">
<primary sortas="b-schemagen">schemagen</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="serialver">
<term><command>serialver</command></term>
<listitem>
<para>returns the serialVersionUID for one or more classes in a
form suitable for copying into an evolving class.</para>
<indexterm zone="jdk serialver">
<primary sortas="b-serialver">serialver</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="servertool">
<term><command>servertool</command></term>
<listitem>
<para>provides an ease-of-use interface for application programmers
to register, unregister, startup and shutdown a server.</para>
<indexterm zone="jdk servertool">
<primary sortas="b-servertool">servertool</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="tnameserv">
<term><command>tnameserv</command></term>
<listitem>
<para>starts the Java IDL name server.</para>
<indexterm zone="jdk tnameserv">
<primary sortas="b-tnameserv">tnameserv</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="unpack200">
<term><command>unpack200</command></term>
<listitem>
<para>is a native implementation that transforms a packed file
produced by <application>pack200</application> into a jar
file.</para>
<indexterm zone="jdk unpack200">
<primary sortas="b-unpack200">unpack200</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="wsgen">
<term><command>wsgen</command></term>
<listitem>
<para>generates JAX-WS portable artifacts used in JAX-WS
web services.</para>
<indexterm zone="jdk wsgen">
<primary sortas="b-wsgen">wsgen</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="wsimport">
<term><command>wsimport</command></term>
<listitem>
<para>generates JAX-WS portable artifacts.</para>
<indexterm zone="jdk wsimport">
<primary sortas="b-wsimport">wsimport</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="xjc">
<term><command>xjc</command></term>
<listitem>
<para>is a Java XML binding compiler.</para>
<indexterm zone="jdk xjc">
<primary sortas="b-xjc">xjc</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/prog/other-tools.xml
0,0 → 1,2456
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
]>
<sect1 id="other-tools" xreflabel="Other Programming Tools">
<?dbhtml filename="other-tools.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Other Programming Tools</title>
<indexterm zone="other-tools">
<primary sortas="a-Other-Programming-Tools">Other Programming Tools</primary>
</indexterm>
<sect2 role="introduction">
<title>Introduction</title>
<para>This section is provided to show you some additional programming
tools for which instructions have not yet been created in the book or for
those that are not appropriate for the book. Note that these packages may
not have been tested by the BLFS team, but their mention here is meant to
be a convenient source of additional information.</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/OtherProgrammingTools"/></para>
</sect2>
<sect2>
<title>Programming Frameworks, Languages and Compilers</title>
<!-- This is a template for additions to this page. Cut 18 lines and
paste them in alphabetical order for the new package. '18dd' and
move down to the alpha order and 'p' works great (using vi).
<sect3 role="package">
<title></title>
<para><application></application> This is the description.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url=""/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url=""/></para>
</listitem>
</itemizedlist>
</sect3>
-->
<sect3 role="package">
<title>A+</title>
<para><application>A+</application> is a powerful and efficient
programming language. It is freely available under the GNU General
Public License. It embodies a rich set of functions and operators, a
modern graphical user interface with many widgets and automatic
synchronization of widgets and variables, asynchronous execution of
functions associated with variables and events, dynamic loading of user
compiled subroutines, and many other features. Execution is by a rather
efficient interpreter. <application>A+</application> was created at
Morgan Stanley. Primarily used in a computationally-intensive business
environment, many critical applications written in
<application>A+</application> have withstood the demands of real world
developers over many years. Written in an interpreted language,
<application>A+</application> applications tend to be portable.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.aplusdev.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.aplusdev.org/Download/index.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>ABC</title>
<para><application>ABC</application> is an interactive programming
language and environment for personal computing, originally intended as a
good replacement for BASIC. It was designed by first doing a task
analysis of the programming task. <application>ABC</application> is easy
to learn (an hour or so for someone who has already programmed), and yet
easy to use. Originally intended as a language for beginners, it has
evolved into a powerful tool for beginners and experts alike. Some
features of the language include: a powerful collection of only five data
types that easily combines strong typing, yet without declarations,
no limitations (such as max int), apart from sheer exhaustion of memory
refinements to support top-down programming, nesting by indentation and
programs typically are one fourth or one fifth the size of the equivalent
Pascal or C program. </para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://homepages.cwi.nl/~steven/abc/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://homepages.cwi.nl/~steven/abc/implementations.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>ALF</title>
<para><application>ALF</application> is a language which combines
functional and logic programming techniques. The foundation of
<application>ALF</application> is Horn clause logic with equality which
consists of predicates and Horn clauses for logic programming, and
functions and equations for functional programming. The
<application>ALF</application> system is an efficient implementation of
the combination of resolution, narrowing, rewriting and rejection.
Similarly to Prolog, <application>ALF</application> uses a backtracking
strategy corresponding to a depth-first search in the derivation
tree.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.informatik.uni-kiel.de/~mh/systems/ALF.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.informatik.uni-kiel.de/~mh/systems/ALF/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>ASM</title>
<para><application>ASM</application> is a Java bytecode manipulation
framework. It can be used to dynamically generate stub classes or other
proxy classes, directly in binary form, or to dynamically modify
classes at load time, i.e., just before they are loaded into the Java
Virtual Machine. <application>ASM</application> offers similar
functionalities as BCEL or SERP, but is much smaller (33KB instead of
350KB for BCEL and 150KB for SERP) and faster than these tools (the
overhead of a load time class transformation is of the order of 60% with
<application>ASM</application>, 700% or more with BCEL, and 1100% or
more with SERP). Indeed <application>ASM</application> was designed to be
used in a dynamic way (though it works statically as well) and was
therefore designed and implemented to be as small and as fast as
possible.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://asm.objectweb.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://forge.objectweb.org/projects/asm/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>BCPL</title>
<para><application>BCPL</application> is a simple typeless language that
was designed in 1966 by Martin Richards and implemented for the first
time at MIT in the Spring of 1967.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cl.cam.ac.uk/users/mr/BCPL.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.cl.cam.ac.uk/users/mr/BCPL/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>BETA</title>
<para><application>BETA</application> is developed within the
Scandinavian School of object-orientation, where the first
object-oriented language, Simula, was developed.
<application>BETA</application> is a modern language in the Simula
tradition. The resulting language is smaller than Simula in spite of
being considerably more expressive. <application>BETA</application> is a
strongly typed language like Simula, Eiffel and C++, with most type
checking being carried out at compile-time. It is well known that it is
not possible to obtain all type checking at compile time without
sacrificing the expressiveness of the language.
<application>BETA</application> has optimum balance between compile-time
type checking and run-time type checking.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.daimi.au.dk/~beta/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="ftp://ftp.daimi.au.dk/pub/beta/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>&lt;bigwig&gt;</title>
<para><application>&lt;bigwig&gt;</application> is a high-level
programming language for developing interactive Web services. Programs
are compiled into a conglomerate of lower-level technologies such as C
code, HTTP, HTML, JavaScript, and SSL, all running on top of a runtime
system based on an Apache Web server module. It is a descendant of the
Mawl project but is a completely new design and implementation with
vastly expanded ambitions. The <application>&lt;bigwig&gt;</application>
language is really a collection of tiny domain-specific languages
focusing on different aspects of interactive Web services. These
contributing languages are held together by a C-like skeleton language.
Thus, <application>&lt;bigwig&gt;</application> has the look and feel of
C-programs but with special data and control structures.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.brics.dk/bigwig/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.brics.dk/bigwig/download/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Bigloo</title>
<para><application>Bigloo</application> is a Scheme implementation
devoted to one goal: enabling Scheme based programming style where C(++)
is usually required. <application>Bigloo</application> attempts to make
Scheme practical by offering features usually presented by traditional
programming languages but not offered by Scheme and functional
programming. Bigloo compiles Scheme modules and delivers small and fast
stand-alone binary executables. It enables full connections between
Scheme and C programs, between Scheme and Java programs, and between
Scheme and C# programs.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www-sop.inria.fr/mimosa/fp/Bigloo/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="ftp://ftp-sop.inria.fr/mimosa/fp/Bigloo/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>C--</title>
<para><application>C--</application> is a portable assembly language that
can be generated by a front end and implemented by any of several code
generators. It serves as an interface between high-level compilers and
retargetable, optimizing code generators. Authors of front ends and code
generators can cooperate easily.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cminusminus.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.cminusminus.org/code.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Caml</title>
<para><application>Caml</application> is a general-purpose programming
language, designed with program safety and reliability in mind. It is
very expressive, yet easy to learn and use.
<application>Caml</application> supports functional, imperative, and
object-oriented programming styles. It has been developed and distributed
by INRIA, France's national research institute for computer science,
since 1985. The Objective Caml system is the main implementation of the
<application>Caml</application> language. It features a powerful module
system and a full-fledged object-oriented layer. It comes with a
native-code compiler that supports numerous architectures, for high
performance; a bytecode compiler, for increased portability; and an
interactive loop, for experimentation and rapid development.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://caml.inria.fr/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://caml.inria.fr/pub/distrib/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Cayenne</title>
<para><application>Cayenne</application> is a simple(?) functional
language with a powerful type system. The basic types are functions,
products, and sums. Functions and products use dependent types to gain
additional power. There are very few building blocks in the language, but
a lot of <quote>syntactic sugar</quote> to make it more readable. There
is no separate module language in <application>Cayenne</application>
since the dependent types allow the normal expression language to be used
at the module level as well. The design of
<application>Cayenne</application> has been heavily influenced by
<application>Haskell</application> and constructive type theory and with
some things borrowed from Java. The drawback of such a powerful type
system is that the type checking becomes undecidable.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cs.chalmers.se/~augustss/cayenne/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.cs.chalmers.se/~augustss/cayenne/get.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Ch</title>
<para><application>Ch</application> is an embeddable C/C++ interpreter
for cross-platform scripting, shell programming, 2D/3D plotting,
numerical computing, and embedded scripting.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.softintegration.com/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.softintegration.com/products/chstandard/download/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Clean</title>
<para><application>Clean</application> is a general purpose,
state-of-the-art, pure and lazy functional programming language designed
for making real-world applications. <application>Clean</application> is
the only functional language in the world which offers uniqueness typing.
This type system makes it possible in a pure functional language to
incorporate destructive updates of arbitrary data structures (including
arrays) and to make direct interfaces to the outside imperative world.
The type system makes it possible to develop efficient
applications.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cs.ru.nl/~clean/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.cs.ru.nl/~clean/Download/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>CORN</title>
<para><application>CORN</application> is designed for modeling
concurrency and advanced computation. It provides lazy evaluation between
concurrently worked threads, with object-oriented and functional style of
semantic. This language can be also used for parallel computation.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://corn.telefonia.pl/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://corn.telefonia.pl/download/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Cyclone</title>
<para><application>Cyclone</application> is a programming language based
on C that is safe, meaning that it rules out programs that have buffer
overflows, dangling pointers, format string attacks, and so on.
High-level, type-safe languages, such as Java, Scheme, or ML also provide
safety, but they don't give the same control over data representations
and memory management that C does (witness the fact that the run-time
systems for these languages are usually written in C.) Furthermore,
porting legacy C code to these languages or interfacing with legacy C
libraries is a difficult and error-prone process. The goal of
<application>Cyclone</application> is to give programmers the same
low-level control and performance of C without sacrificing safety, and to
make it easy to port or interface with legacy C code.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.research.att.com/projects/cyclone/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.eecs.harvard.edu/~greg/cyclone/software/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>D</title>
<para><application>D</application> is a general purpose systems and
applications programming language. It is a higher level language than
C++, but retains the ability to write high performance code and interface
directly with the operating system APIs and with hardware.
<application>D</application> is well suited to writing medium to large
scale million line programs with teams of developers. It is easy to
learn, provides many capabilities to aid the programmer, and is well
suited to aggressive compiler optimization technology.
<application>D</application> is not a scripting language, nor an
interpreted language. It doesn't come with a VM, a religion, or an
overriding philosophy. It's a practical language for practical
programmers who need to get the job done quickly, reliably, and leave
behind maintainable, easy to understand code.
<application>D</application> is the culmination of decades of experience
implementing compilers for many diverse languages, and attempting to
construct large projects using those languages. It draws inspiration from
those other languages (most especially C++) and tempers it with
experience and real world practicality.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.digitalmars.com/d/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="ftp://ftp.digitalmars.com/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>DMDScript</title>
<para><application>DMDScript</application> is Digital Mars'
implementation of the ECMA 262 scripting language. Netscape's
implementation is called JavaScript, Microsoft's implementation is
called JScript. <application>DMDScript</application> is much faster
than other implementations, which you can verify with the included
benchmark.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.digitalmars.com/dscript/index.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="ftp://ftp.digitalmars.com/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>DotGNU Portable.NET</title>
<para><application>DotGNU Portable.NET</application> goal is to build a
suite of free software tools to build and execute .NET applications,
including a C# compiler, assembler, disassembler, and runtime engine.
While the initial target platform was GNU/Linux, it is also known to run
under Windows, Solaris, NetBSD, FreeBSD, and MacOS X. The runtime engine
has been tested on the x86, PowerPC, ARM, Sparc, PARISC, s390, Alpha, and
IA-64 processors. <application>DotGNU Portable.NET</application> is part
of the DotGNU project, built in accordance with the requirements of the
GNU Project. DotGNU Portable.NET is focused on compatibility with the
ECMA specifications for CLI. There are other projects under the DotGNU
meta-project to build other necessary pieces of infrastructure, and to
explore non-CLI approaches to virtual machine implementation.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.southern-storm.com.au/portable_net.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.southern-storm.com.au/portable_net.html#download"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Dylan</title>
<para><application>Dylan</application> is an advanced, object-oriented,
dynamic language which supports rapid program development. When needed,
programs can be optimized for more efficient execution by supplying more
type information to the compiler. Nearly all entities in
<application>Dylan</application> (including functions, classes, and basic
data types such as integers) are first class objects. Additionally,
<application>Dylan</application> supports multiple inheritance,
polymorphism, multiple dispatch, keyword arguments, object introspection,
macros, and many other advanced features... --Peter Hinely.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.gwydiondylan.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.gwydiondylan.org/downloading.phtml"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>E</title>
<para><application>E</application> is a secure distributed Java-based
pure-object platform and p2p scripting language. It has two parts: ELib
and the <application>E</application> Language. Elib provides the stuff
that goes on between objects. As a pure-Java library, ELib provides for
inter-process capability-secure distributed programming. Its
cryptographic capability protocol enables mutually suspicious Java
processes to cooperate safely, and its event-loop concurrency and promise
pipelining enable high performance deadlock free distributed pure-object
computing. The <application>E</application> Language can be used to
express what happens within an object. It provides a convenient and
familiar notation for the ELib computational model, so you can program
in one model rather than two. Under the covers, this notation expands
into Kernel-E, a minimalist lambda-language much like Scheme or
Smalltalk. Objects written in the <application>E</application> language
are only able to interact with other objects according to ELib's
semantics, enabling object granularity intra-process security, including
the ability to safely run untrusted mobile code (such as caplets).</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.erights.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.erights.org/download/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>elastiC</title>
<para><application>elastiC</application> is a portable high-level
object-oriented interpreted language with a C like syntax. Its main
characteristics are: open source, interpreted, has portable bytecode
compilation, dynamic typing, automatic real very fast garbage collection,
object oriented with meta-programming support (a la Smalltalk),
functional programming support (Scheme-like closures with lexical
scoping, and eval-like functionality), hierarchical namespaces, a rich
set of useful built-in types (dynamic arrays, dictionaries, symbols,
...), extensibile with C (you can add functions, types, classes, methods,
packages, ...), embeddable in C. <application>elastiC</application> has
been strongly influenced by C, Smalltalk, Scheme and Python and tries to
merge the best characteristics of all these languages, while still
coherently maintaining its unique personality.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.elasticworld.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.elasticworld.org/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Erlang/OTP</title>
<para><application>Erlang/OTP</application> is a development environment
based on Erlang. Erlang is a programming language which has many features
more commonly associated with an operating system than with a programming
language: concurrent processes, scheduling, memory management,
distribution, networking, etc. The initial open-source Erlang release
contains the implementation of Erlang, as well as a large part of
Ericsson's middleware for building distributed high-availability systems.
Erlang is characterized by the following features: robustness, soft
real-time, hot code upgrades and incremental code loading.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.erlang.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.erlang.org/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Euphoria</title>
<para><application>Euphoria</application> is a simple, flexible, and
easy-to-learn programming language. It lets you quickly and easily
develop programs for Windows, DOS, Linux and FreeBSD. Euphoria was first
released in 1993. Since then Rapid Deployment Software has been steadily
improving it with the help of a growing number of enthusiastic users.
Although <application>Euphoria</application> provides subscript checking,
uninitialized variable checking and numerous other run-time checks, it is
extremely fast. People have used it to develop high-speed DOS games,
Windows GUI programs, and Linux X Windows programs. It is also very
useful for CGI (Web-based) programming.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.rapideuphoria.com/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.rapideuphoria.com/v20.htm"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Felix</title>
<para><application>Felix</application> is an advanced Algol like
procedural programming language with a strong functional subsystem. It
features ML style static typing, first class functions, pattern matching,
garbage collection, polymorphism, and has built in support for high
performance microthreading, regular expressions and context free parsing.
The system provides a scripting harness so the language can be used like
other scripting languages such as Python and Perl, but underneath it
generates native code to obtain high performance. A key feature of the
system is that it uses the C/C++ object model, and provides an advanced
binding sublanguage to support integration with C/C++ at both the source
and object levels, both for embedding C/C++ data types and functions into
<application>Felix</application>, and for embedding
<application>Felix</application> into exitsing C++ architectures. The
<application>Felix</application> compiler is written in Objective Caml,
and generates ISO C++ which should compile on any platform.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://felix.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://felix.sourceforge.net/current/www/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>ferite</title>
<para><application>ferite</application> is a scripting language and
engine all in one manageable chunk. It is designed to be easily extended
in terms of API, and to be used within other applications making them
more configurable and useful to the end user. It has a syntax similar to
a number of other languages but remains clean and its own
language.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.ferite.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.ferite.org/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Forth</title>
<para><application>Forth</application> is a stack-based, extensible
language without type-checking. It is probably best known for its
"reverse Polish" (postfix) arithmetic notation, familiar to users of
Hewlett-Packard calculators. <application>Forth</application> is a
real-time programming language originally developed to control
telescopes. <application>Forth</application> has many unique features
and applications: it can compile itself into a new compiler,
reverse-polish coding, edit time error checking and compiling (similar
to BASIC), extremely efficient thread based language, can be used to
debug itself, extensible; thus can become what ever you need it to be.
The links below lead to the website of the Forth Interest Group (FIG),
a world-wide, non-profit organization for education in and the promotion
of the <application>Forth</application> computer language. Another
worthwhile website dedicated to the <application>Forth</application>
community is <ulink url="http://wiki.forthfreak.net/"/>.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.forth.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.forth.org/compilers.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>GNU Smalltalk</title>
<para><application>GNU Smalltalk</application> is a free implementation
of the Smalltalk-80 language which runs on most versions on Unix and, in
general, everywhere you can find a POSIX-compliance library. An uncommon
feature of it is that it is well-versed to scripting tasks and headless
processing. See <ulink
url="http://www.gnu.org/software/smalltalk/gst-manual/gst_1.html#SEC1"/>
for a more detailed explanation of
<application>GNU Smalltalk</application>.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.gnu.org/software/smalltalk/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://ftp.gnu.org/gnu/smalltalk/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Haskell</title>
<para>Haskell is a computer programming language. In particular, it is a
polymorphicly typed, lazy, purely functional language, quite different
from most other programming languages. The language is named for Haskell
Brooks Curry, whose work in mathematical logic serves as a foundation for
functional languages. Haskell is based on lambda calculus. There are many
implementations of Haskell, among them:</para>
<itemizedlist spacing="compact">
<listitem>
<para>GHC: <ulink
url="http://www.haskell.org/ghc/"/></para>
</listitem>
<listitem>
<para>HBC: <ulink
url="http://www.cs.chalmers.se/~augustss/hbc/hbc.html"/></para>
</listitem>
<listitem>
<para>Helium: <ulink
url="http://www.cs.uu.nl/helium/"/></para>
</listitem>
<listitem>
<para>Hugs: <ulink
url="http://www.haskell.org/hugs/"/></para>
</listitem>
<listitem>
<para>nhc98: <ulink
url="http://www.haskell.org/nhc98/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>HLA (High Level Assembly)</title>
<para>The <application>HLA</application> language was developed as a tool
to help teach assembly language programming and machine organization to
University students at the University of California, Riverside. The basic
idea was to teach students assembly language programming by leveraging
their knowledge of high level languages like C/C++ and Pascal/Delphi. At
the same time, <application>HLA</application> was designed to allow
advanced assembly language programmers write more readable and more
powerful assembly language code.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://webster.cs.ucr.edu/AsmTools/HLA/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://webster.cs.ucr.edu/AsmTools/HLA/dnld.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Icon</title>
<para><application>Icon</application> is a high-level, general-purpose
programming language with a large repertoire of features for processing
data structures and character strings. It is an imperative, procedural
language with a syntax reminiscent of C and Pascal, but with semantics at
a much higher level.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cs.arizona.edu/icon/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="ftp://ftp.cs.arizona.edu/icon/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Io</title>
<para><application>Io</application> is a small, prototype-based
programming language. The ideas in <application>Io</application> are
mostly inspired by <application>Smalltalk</application> (all values are
objects), <application>Self</application> (prototype-based),
<application>NewtonScript</application> (differential inheritance),
<application>Act1</application> (actors and futures for concurrency),
<application>LISP</application> (code is a runtime inspectable/modifiable
tree) and <application>Lua</application> (small, embeddable).</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.iolanguage.com/about/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.iolanguage.com/downloads/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>J</title>
<para><application>J</application> is a modern, high-level,
general-purpose, high-performance programming language. It is portable
and runs on Windows, Unix, Mac, and PocketPC handhelds, both as a GUI
and in a console. True 64-bit <application>J</application> systems are
available for XP64 or Linux64, on AMD64 or Intel EM64T platforms.
<application>J</application> systems can be installed and distributed
for free.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.jsoftware.com/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.jsoftware.com/download/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Jamaica</title>
<para><application>Jamaica</application>, the JVM Macro Assembler, is an
easy-to-learn and easy-to-use assembly language for JVM bytecode
programming. It uses Java syntax to define a JVM class except for the
method body that takes bytecode instructions, including
<application>Jamaica</application>'s built-in macros. In
<application>Jamaica</application>, bytecode instructions use mnemonics
and symbolic names for all variables, parameters, data fields, constants
and labels.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.judoscript.com/jamaica.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.judoscript.com/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Joy</title>
<para><application>Joy</application> is a purely functional programming
language. Whereas all other functional programming languages are based on
the application of functions to arguments, <application>Joy</application>
is based on the composition of functions. All such functions take a stack
as an argument and produce a stack as a value. Consequently much of
<application>Joy</application> looks like ordinary postfix notation.
However, in <application>Joy</application> a function can consume any
number of parameters from the stack and leave any number of results on
the stack. The concatenation of appropriate programs denotes the
composition of the functions which the programs denote.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.latrobe.edu.au/philosophy/phimvt/joy.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Judo</title>
<para><application>Judo</application> is a practical, functional
scripting language. It is designed to cover the use cases of not only
algorithmic/object-oriented/multi-threaded programming and Java scripting
but also a number of major application domain tasks, such as scripting
for JDBC, WSDL, ActiveX, OS, multiple file/data formats, etc. Despite its
rich functionality, the base language is extremely simple, and domain
support syntax is totally intuitive to domain experts, so that even
though you have never programmed in <application>Judo</application>, you
would have little trouble figuring out what the code does.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.judoscript.com/home.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.judoscript.com/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>JWIG</title>
<para><application>JWIG</application> is a Java-based high-level
programming language for development of interactive Web services. It
contains an advanced session model, a flexible mechanism for dynamic
construction of XML documents, in particular XHTML, and a powerful API
for simplifying use of the HTTP protocol and many other aspects of Web
service programming. To support program development,
<application>JWIG</application> provides a unique suite of highly
specialized program analyses that at compile time verify for a given
program that no runtime errors can occur while building documents or
receiving form input, and that all documents being shown are valid
according to the document type definition for XHTML 1.0. The main goal of
the <application>JWIG</application> project is to simplify development of
complex Web services, compared to alternatives, such as, Servlets, JSP,
ASP, and PHP. <application>JWIG</application> is a descendant of the
<application>&lt;bigwig&gt;</application> research language.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.brics.dk/JWIG/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.brics.dk/JWIG/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Lava</title>
<para><application>Lava</application> is a name unfortunately chosen for
several unrelated software development languages/projects. So it doesn't
appear as though BLFS has a preference for one over another, the project
web sites are listed below, without descriptions of the capabilities or
features for any of them.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://lavape.sourceforge.net/index.htm"/></para>
</listitem>
<listitem>
<para>Project Home Page: <ulink
url="http://javalab.cs.uni-bonn.de/research/darwin/#The%20Lava%20Language"/></para>
</listitem>
<listitem>
<para>Project Home Page: <ulink
url="http://www.md.chalmers.se/~koen/Lava/"/></para>
</listitem>
<listitem>
<para>Project Home Page: <ulink
url="http://members.tripod.com/mathias/IavaHomepage.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Lua</title>
<para><application>Lua</application> is a powerful light-weight
programming language designed for extending applications. It is also
frequently used as a general-purpose, stand-alone language. It is free
software. <application>Lua</application> combines simple procedural
syntax with powerful data description constructs based on associative
arrays and extensible semantics. It is dynamically typed, interpreted
from bytecodes, and has automatic memory management with garbage
collection, making it ideal for configuration, scripting, and rapid
prototyping. A fundamental concept in the design of
<application>Lua</application> is to provide meta-mechanisms for
implementing features, instead of providing a host of features directly
in the language. For example, although <application>Lua</application> is
not a pure object-oriented language, it does provide meta-mechanisms for
implementing classes and inheritance. <application>Lua</application>'s
meta-mechanisms bring an economy of concepts and keep the language small,
while allowing the semantics to be extended in unconventional ways.
Extensible semantics is a distinguishing feature of
<application>Lua</application>. <application>Lua</application> is a
language engine that you can embed into your application. This means
that, besides syntax and semantics, it has an API that allows the
application to exchange data with <application>Lua</application> programs
and also to extend <application>Lua</application> with C functions. In
this sense, it can be regarded as a language framework for building
domain-specific languages. <application>Lua</application> is implemented
as a small library of C functions, written in ANSI C, and compiles
unmodified in all known platforms. The implementation goals are
simplicity, efficiency, portability, and low embedding cost. The result
is a fast language engine with small footprint, making it ideal in
embedded systems too.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.lua.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.lua.org/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Mercury</title>
<para><application>Mercury</application> is a new logic/functional
programming language, which combines the clarity and expressiveness of
declarative programming with advanced static analysis and error detection
features. Its highly optimized execution algorithm delivers efficiency
far in excess of existing logic programming systems, and close to
conventional programming systems. <application>Mercury</application>
addresses the problems of large-scale program development, allowing
modularity, separate compilation, and numerous optimization/time
trade-offs.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cs.mu.oz.au/research/mercury/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.cs.mu.oz.au/research/mercury/download/release.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Mono</title>
<para><application>Mono</application> provides the necessary software to
develop and run .NET client and server applications on Linux, Solaris,
Mac OS X, Windows, and Unix. Sponsored by Novell, the
<application>Mono</application> open source project has an active and
enthusiastic contributing community and is positioned to become the
leading choice for development of Linux applications.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.mono-project.com/Main_Page"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://go-mono.com/sources/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>MPD</title>
<para><application>MPD</application> is a variant of the
<application>SR</application> programming language.
<application>SR</application> has a Pascal-like syntax and uses guarded
commands for control statements. <application>MPD</application> has a
C-like syntax and C-like control statements. However, the main components
of the two languages are the same: resources, globals, operations, procs,
procedures, processes, and virtual machines. Moreover,
<application>MPD</application> supports the same variety of concurrent
programming mechanisms as <application>SR</application>: co statements,
semaphores, call/send/forward invocations, and receive and input
statements.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cs.arizona.edu/mpd/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.cs.arizona.edu/mpd/download/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Nemerle</title>
<para><application>Nemerle</application> is a high-level statically-typed
programming language for the .NET platform. It offers functional,
object-oriented and imperative features. It has a simple C#-like syntax
and a powerful meta-programming system. Features that come from the
functional land are variants, pattern matching, type inference and
parameter polymorphism (aka generics). The meta-programming system allows
great compiler extensibility, embedding domain specific languages,
partial evaluation and aspect-oriented programming.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://nemerle.org/Main_Page"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://nemerle.org/Download"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Octave</title>
<para>GNU <application>Octave</application> is a high-level language,
primarily intended for numerical computations. It provides a convenient
command line interface for solving linear and nonlinear problems
numerically, and for performing other numerical experiments using a
language that is mostly compatible with Matlab. It may also be used as
a batch-oriented language. <application>Octave</application> has
extensive tools for solving common numerical linear algebra problems,
finding the roots of nonlinear equations, integrating ordinary functions,
manipulating polynomials, and integrating ordinary differential and
differential-algebraic equations. It is easily extensible and
customizable via user-defined functions written in
<application>Octave</application>'s own language, or using dynamically
loaded modules written in C++, C, Fortran, or other languages.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.octave.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.octave.org/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>OO2C (Optimizing Oberon-2 Compiler)</title>
<para><application>OO2C</application> is an Oberon-2 development
platform. It consists of an optimizing compiler, a number of related
tools, a set of standard library modules and a reference manual.
Oberon-2 is a general-purpose programming language in the tradition of
Pascal and Modula-2. Its most important features are block structure,
modularity, separate compilation, static typing with strong type checking
(also across module boundaries) and type extension with type-bound
procedures. Type extension makes Oberon-2 an object-oriented
language.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://ooc.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/ooc/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Ordered Graph Data Language (OGDL)</title>
<para><application>OGDL</application> is a structured textual format that
represents information in the form of graphs, where the nodes are strings
and the arcs or edges are spaces or indentation.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://ogdl.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/ogdl/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Pike</title>
<para><application>Pike</application> is a dynamic programming language
with a syntax similar to Java and C. It is simple to learn, does not
require long compilation passes and has powerful built-in data types
allowing simple and really fast data manipulation. Pike is released under
the GNU GPL, GNU LGPL and MPL.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://pike.ida.liu.se/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://pike.ida.liu.se/download/pub/pike"/></para>
</listitem>
</itemizedlist>
</sect3>
<!-- Broken link
<sect3 role="package">
<title>pyc</title>
<para><application>pyc</application> is a compiler that compiles
<application>Python</application> source code to bytecode (from
<filename class='extension'>.py</filename> to
<filename class='extension'>.pyc</filename>), written entirely in
<application>Python</application> (based on code from the <quote>compiler
package</quote>). It can compile itself and pass a 3-stage bootstrap.
<application>pyc</application> performs advanced optimizations which
results in better (smaller) bytecode.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://students.ceid.upatras.gr/~sxanth/pyc/"/></para>
</listitem>
</itemizedlist>
</sect3>
-->
<sect3 role="package">
<title>Pyrex</title>
<para><application>Pyrex</application> is a language specially designed
for writing Python extension modules. It's designed to bridge the gap
between the nice, high-level, easy-to-use world of
<application>Python</application> and the messy, low-level world of C.
<application>Pyrex</application> lets you write code that mixes
<application>Python</application> and C data types any way you want, and
compiles it into a C extension for
<application>Python</application>.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cosc.canterbury.ac.nz/~greg/python/Pyrex/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Q</title>
<para><application>Q</application> is a functional programming language
based on term rewriting. Thus, a <application>Q</application> program or
<quote>script</quote> is simply a collection of equations which are used
to evaluate expressions in a symbolic fashion. The equations establish
algebraic identities and are interpreted as rewriting rules in order to
reduce expressions to <quote>normal forms</quote>.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://q-lang.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/q-lang/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>R</title>
<para><application>R</application> is a language and environment for
statistical computing and graphics. It is a GNU project similar to the
<application>S</application> language and environment which was developed
at Bell Laboratories (formerly AT&amp;T, now Lucent Technologies) by
John Chambers and colleagues. <application>R</application> can be
considered as a different implementation of <application>S</application>.
There are some important differences, but much code written for
<application>S</application> runs unaltered under
<application>R</application>. <application>R</application> provides a
wide variety of statistical (linear and nonlinear modelling, classical
statistical tests, time-series analysis, classification, clustering, ...)
and graphical techniques, and is highly extensible. The
<application>S</application> language is often the vehicle of choice for
research in statistical methodology, and <application>R</application>
provides an Open Source route to participation in that activity.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.r-project.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://cran.r-project.org/mirrors.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Regina Rexx</title>
<para><application>Regina</application> is a Rexx interpreter that has
been ported to most Unix platforms (Linux, FreeBSD, Solaris, AIX, HP-UX,
etc.) and also to OS/2, eCS, DOS, Win9x/Me/NT/2k/XP, Amiga, AROS, QNX4.x,
QNX6.x BeOS, MacOS X, EPOC32, AtheOS, OpenVMS, SkyOS and OpenEdition.
Rexx is a programming language that was designed to be easy to use for
inexperienced programmers yet powerful enough for experienced users. It
is also a language ideally suited as a macro language for other
applications.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://regina-rexx.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/regina-rexx"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Serp</title>
<para><application>Serp</application> is an open source framework for
manipulating Java bytecode. The goal of the
<application>Serp</application> bytecode framework is to tap the full
power of bytecode modification while lowering its associated costs. The
framework provides a set of high-level APIs for manipulating all aspects
of bytecode, from large-scale structures like class member fields to the
individual instructions that comprise the code of methods. While in order
to perform any advanced manipulation, some understanding of the class
file format and especially of the JVM instruction set is necessary, the
framework makes it as easy as possible to enter the world of bytecode
development.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://serp.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://serp.sourceforge.net/files/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Small Device C Compiler (SDCC)</title>
<para><application>SDCC</application> is a Freeware, retargetable,
optimizing ANSI-C compiler that targets the Intel 8051, Maxim 80DS390
and the Zilog Z80 based MCUs. Work is in progress on supporting the
Motorola 68HC08 as well as Microchip PIC16 and PIC18 series. The entire
source code for the compiler is distributed under GPL.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://sdcc.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://sdcc.sourceforge.net/snap.php#Source"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>SmartEiffel (The GNU Eiffel Compiler)</title>
<para><application>SmartEiffel</application> claims to be <quote>the
fastest and the slimmest multi-platform Eiffel compiler on Earth</quote>.
Eiffel is an object-oriented programming language which emphasizes the
production of robust software. Its syntax is keyword-oriented in the
ALGOL and Pascal tradition. Eiffel is strongly statically typed, with
automatic memory management (typically implemented by garbage
collection). Distinguishing characteristics of Eiffel include Design by
contract (DbC), liberal use of inheritance including multiple
inheritance, a type system handling both value and reference semantics,
and generic classes. Eiffel has a unified type system&mdash;all types in
Eiffel are classes, so it is possible to create subclasses of the basic
classes such as INTEGER. Eiffel has operator overloading, including the
ability to define new operators, but does not have method
overloading.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://smarteiffel.loria.fr/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="ftp://ftp.loria.fr/pub/loria/SmartEiffel/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Squeak</title>
<para><application>Squeak</application> is an open, highly-portable
Smalltalk implementation whose virtual machine is written entirely in
Smalltalk, making it easy to debug, analyze, and change. To achieve
practical performance, a translator produces an equivalent C program
whose performance is comparable to commercial Smalltalks. Other
noteworthy aspects of <application>Squeak</application> include:
real-time sound and music synthesis written entirely in Smalltalk,
extensions of BitBlt to handle color of any depth and anti-aliased
image rotation and scaling, network access support that allows simple
construction of servers and other useful facilities, it runs
bit-identical on many platforms (Windows, Mac, Unix, and others), a
compact object format that typically requires only a single word of
overhead per object and a simple yet efficient incremental garbage
collector for 32-bit direct pointers efficient bulk-mutation of
objects.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.squeak.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.squeak.org/Download/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>SR (Synchronizing Resources)</title>
<para><application>SR</application> is a language for writing concurrent
programs. The main language constructs are resources and operations.
Resources encapsulate processes and variables they share; operations
provide the primary mechanism for process interaction.
<application>SR</application> provides a novel integration of the
mechanisms for invoking and servicing operations. Consequently, all of
local and remote procedure call, rendezvous, message passing, dynamic
process creation, multicast, and semaphores are supported.
<application>SR</application> also supports shared global variables and
operations.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cs.arizona.edu/sr/index.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="ftp://ftp.cs.arizona.edu/sr/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Standard ML</title>
<para>Standard ML is a safe, modular, strict, functional, polymorphic
programming language with compile-time type checking and type inference,
garbage collection, exception handling, immutable data types and
updatable references, abstract data types, and parametric modules. It has
efficient implementations and a formal definition with a proof of
soundness. There are many implementations of Standard ML, among them:</para>
<itemizedlist spacing="compact">
<listitem>
<para>ML Kit: <ulink
url="http://www.it-c.dk/research/mlkit/"/></para>
</listitem>
<listitem>
<para>MLton: <ulink
url="http://mlton.org/"/></para>
</listitem>
<listitem>
<para>Moscow ML: <ulink
url="http://www.dina.kvl.dk/~sestoft/mosml.html"/></para>
</listitem>
<listitem>
<para>Poly/ML: <ulink
url="http://www.polyml.org/"/></para>
</listitem>
<listitem>
<para>Standard ML of New Jersey: <ulink
url="http://www.smlnj.org/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Steel Bank Common Lisp (SBCL)</title>
<para><application>SBCL</application> is an open source (free software)
compiler and runtime system for ANSI Common Lisp. It provides an
interactive environment including an integrated native compiler, a
debugger, and many extensions. <application>SBCL</application> runs on a
number of platforms.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.sbcl.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/sbcl/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Tiny C Compiler (TCC)</title>
<para><application>Tiny C Compiler</application> is a small C compiler
that can be used to compile and execute C code everywhere, for example
on rescue disks (about 100KB for x86 TCC executable, including C
preprocessor, C compiler, assembler and linker).
<application>TCC</application> is fast. It generates optimized x86 code,
has no byte code overhead and compiles, assembles and links several times
faster than <application>GCC</application>.
<application>TCC</application> is versatile, any C dynamic library can be
used directly. It is heading toward full ISOC99 compliance and can
compile itself. The compiler is safe as it includes an optional memory
and bound checker. Bound checked code can be mixed freely with standard
code. <application>TCC</application> compiles and executes C source
directly. No linking or assembly necessary. A full C preprocessor and
GNU-like assembler is included. It is C script supported; just add
<quote>#!/usr/local/bin/tcc -run</quote> on the first line of your C
source, and execute it directly from the command line. With libtcc, you
can use <application>TCC</application> as a backend for dynamic code
generation.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.tinycc.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://fabrice.bellard.free.fr/tcc/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>TinyCOBOL</title>
<para><application>TinyCOBOL</application> is a COBOL compiler being
developed by members of the free software community. The mission is to
produce a COBOL compiler based on the COBOL 85 standards.
<application>TinyCOBOL</application> is available for the Intel
architecture (IA32) and compatible processors on the following platforms:
BeOS, FreeBSD, Linux and MinGW on Windows.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://tinycobol.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/tiny-cobol/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Yorick</title>
<para><application>Yorick</application> is an interpreted programming
language, designed for postprocessing or steering large scientific
simulation codes. Smaller scientific simulations or calculations, such as
the flow past an airfoil or the motion of a drumhead, can be written as
standalone yorick programs. The language features a compact syntax for
many common array operations, so it processes large arrays of numbers
very efficiently. Unlike most interpreters, which are several hundred
times slower than compiled code for number crunching,
<application>Yorick</application> can approach to within a factor of four
or five of compiled speed for many common tasks. Superficially,
<application>Yorick</application> code resembles C code, but
<application>Yorick</application> variables are never explicitly declared
and have a dynamic scoping similar to many Lisp dialects. The
<quote>unofficial</quote> home page for <application>Yorick</application>
can be found at <ulink url="http://www.maumae.net/yorick"/>.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="ftp://ftp-icf.llnl.gov/pub/Yorick/doc/index.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="ftp://ftp-icf.llnl.gov/pub/Yorick/doc/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>ZPL</title>
<para><application>ZPL</application> is an array programming language
designed from first principles for fast execution on both sequential
and parallel computers. It provides a convenient high-level programming
medium for supercomputers and large-scale clusters with efficiency
comparable to hand-coded message passing. It is the perfect alternative
to using a sequential language like C or Fortran and a message passing
library like MPI.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.cs.washington.edu/research/zpl/home/index.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.cs.washington.edu/research/zpl/download/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Programming Libraries and Bindings</title>
<sect3 role="package">
<title>Boost</title>
<para><application>Boost</application> provides free peer-reviewed
portable C++ source libraries. The emphasis is on libraries which work
well with the C++ Standard Library. The libraries are intended to be
widely useful, and are in regular use by thousands of programmers across
a broad spectrum of applications, platforms and programming
environments.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.boost.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/boost/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Byte Code Engineering Library (BCEL)</title>
<para><application>BECL</application> is intended to give users a
convenient possibility to analyze, create, and manipulate (binary) Java
class files (those ending with
<filename class='extension'>.class</filename>). Classes are represented
by objects which contain all the symbolic information of the given class:
methods, fields and byte code instructions, in particular. Such objects
can be read from an existing file, be transformed by a program (e.g., a
class loader at run-time) and dumped to a file again. An even more
interesting application is the creation of classes from scratch at
run-time. The Byte Code Engineering Library may be also useful if you
want to learn about the Java Virtual Machine (JVM) and the format of Java
<filename class='extension'>.class</filename> files.
<application>BCEL</application> is already being used successfully in
several projects such as compilers, optimizers, obsfuscators, code
generators and analysis tools.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://jakarta.apache.org/bcel/index.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://jakarta.apache.org/site/downloads/downloads_bcel.cgi/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Choco</title>
<para><application>Choco</application> is a Java library for constraint
satisfaction problems (CSP), constraint programming (CP) and
explanation-based constraint solving (e-CP). It is built on a event-based
propagation mechanism with backtrackable structures.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://choco.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://choco.sourceforge.net/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>FFTW (Fastest Fourier Transform in the West)</title>
<para><application>FFTW</application> is a C subroutine library for
computing the discrete Fourier transform (DFT) in one or more dimensions,
of arbitrary input size, and of both real and complex data (as well as of
even/odd data, i.e., the discrete cosine/sine transforms or DCT/DST).</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.fftw.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.fftw.org/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>GOB (GObject Builder)</title>
<para><application>GOB</application> (<application>GOB2</application>
anyway) is a preprocessor for making GObjects with inline C code so that
generated files are not edited. Syntax is inspired by
<application>Java</application> and <application>Yacc</application> or
<application>Lex</application>. The implementation is intentionally kept
simple, and no C actual code parsing is done.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.5z.com/jirka/gob.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://ftp.5z.com/pub/gob/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>GTK+/GNOME Language Bindings (wrappers)</title>
<para><application>GTK+</application>/<application>GNOME</application>
language bindings allow <application>GTK+</application> to be used from
other programming languages, in the style of those languages.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.gtk.org/bindings.html"/></para>
</listitem>
</itemizedlist>
<sect4 role="package">
<title>gtkmm</title>
<para><application>gtkmm</application> is the official C++ interface
for the popular GUI library <application>GTK+</application>. Highlights
include typesafe callbacks, widgets extensible via inheritance and a
comprehensive set of widgets. You can create user interfaces either in
code or with the Glade designer, using
<application>libglademm</application>.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.gtkmm.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.gtkmm.org/download.shtml"/></para>
</listitem>
</itemizedlist>
</sect4>
<sect4 role="package">
<title>Java-GNOME</title>
<para><application>Java-GNOME</application> is a set of Java bindings
for the <application>GNOME</application> and
<application>GTK+</application> libraries that allow
<application>GNOME</application> and <application>GTK+</application>
applications to be written in Java. The
<application>Java-GNOME</application> API has been carefully designed
to be easy to use, maintaining a good OO paradigm, yet still wrapping
the entire functionality of the underlying libraries.
<application>Java-GNOME</application> can be used with the
<application>Eclipse</application> development environment and Glade
user interface designer to create applications with ease.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://java-gnome.sourceforge.net/cgi-bin/bin/view"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://java-gnome.sourceforge.net/cgi-bin/bin/view/Main/GetJavaGnome#Source_Code"/></para>
</listitem>
</itemizedlist>
</sect4>
<sect4 role="package">
<title>gtk2-perl</title>
<para><application>gtk2-perl</application> is the collective name for
a set of perl bindings for <application>GTK+</application> 2.x and
various related libraries. These modules make it easy to write
<application>GTK</application> and <application>GNOME</application>
applications using a natural, perlish, object-oriented syntax.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://gtk2-perl.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/gtk2-perl"/></para>
</listitem>
</itemizedlist>
</sect4>
<sect4 role="package">
<title>PyGTK</title>
<para><application>PyGTK</application> provides a convenient wrapper
for the <application>GTK</application> library for use in
<application>Python</application> programs, and takes care of many of
the boring details such as managing memory and type casting. When
combined with <application>PyORBit</application> and
<application>gnome-python</application>, it can be used to write full
featured <application>GNOME</application> applications.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.pygtk.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.pygtk.org/downloads.html"/></para>
</listitem>
</itemizedlist>
</sect4>
</sect3>
<sect3 role="package">
<title>KDE Language Bindings</title>
<para><application>KDE</application> and most
<application>KDE</application> applications are implemented using the
C++ programming language, however there are number of bindings to other
languages are available. These include scripting languages like
<application>Perl</application>, <application>Python</application> and
<application>Ruby</application>, and systems programming languages such
as Java and C#.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://developer.kde.org/language-bindings/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Numerical Python (Numpy)</title>
<para><application>Numerical Python</application> adds a fast array
facility to the <application>Python</application> language.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://numeric.scipy.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/numpy/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Perl Scripts and Additional Modules</title>
<para>There are many <application>Perl</application> scripts and
additional modules located on the Comprehensive Perl Archive Network
(CPAN) web site. Here you will find
<quote>All Things Perl</quote>.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://cpan.org/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>SWIG</title>
<para><application>SWIG</application> is a software development tool
that connects programs written in C and C++ with a variety of high-level
programming languages. <application>SWIG</application> is used with
different types of languages including common scripting languages such as
<application>Perl</application>, <application>Python</application>,
<application>Tcl</application>/<application>Tk</application> and
<application>Ruby</application>. The list of supported languages also
includes non-scripting languages such as <application>C#</application>,
<application>Common Lisp</application> (Allegro CL),
<application>Java</application>, <application>Modula-3</application>
and <application>OCAML</application>. Also several interpreted and
compiled Scheme implementations (<application>Chicken</application>,
<application>Guile</application>, <application>MzScheme</application>)
are supported. <application>SWIG</application> is most commonly used to
create high-level interpreted or compiled programming environments, user
interfaces, and as a tool for testing and prototyping C/C++ software.
<application>SWIG</application> can also export its parse tree in the
form of XML and Lisp s-expressions.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.swig.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/swig/"/></para>
</listitem>
</itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Integrated Development Environments</title>
<sect3 role="package">
<title>A-A-P</title>
<para><application>A-A-P</application> makes it easy to locate, download,
build and install software. It also supports browsing source code,
developing programs, managing different versions and distribution of
software and documentation. This means that
<application> A-A-P</application> is useful both for users and for
developers.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.a-a-p.org/index.html"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.a-a-p.org/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Anjuta</title>
<para><application>Anujuta</application> is a versatile Integrated
Development Environment (IDE) for C and C++ on GNU/Linux. It has been
written for <application>GTK</application>/GNOME and features a number
of advanced programming facilities. These include project management,
application wizards, an on-board interactive debugger, and a powerful
source editor with source browsing and syntax highlighting.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.anjuta.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.anjuta.org/downloads"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Eclipse</title>
<para><application>Eclipse</application> is an open source community
whose projects are focused on providing an extensible development
platform and application frameworks for building software.
<application>Eclipse</application> contains many projects, including an
Integrated Development Environment (IDE) for Java.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.eclipse.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.eclipse.org/downloads/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Mozart</title>
<para>The <application>Mozart</application> Programming System is an
advanced development platform for intelligent, distributed applications.
<application>Mozart</application> is based on the Oz language, which
supports declarative programming, object-oriented programming, constraint
programming, and concurrency as part of a coherent whole. For
distribution, <application>Mozart</application> provides a true network
transparent implementation with support for network awareness, openness,
and fault tolerance. Security is upcoming. It is an ideal platform for
both general-purpose distributed applications as well as for hard
problems requiring sophisticated optimization and inferencing
abilities.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.mozart-oz.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://www.mozart-oz.org/download/view.cgi"/></para>
</listitem>
</itemizedlist>
</sect3>
</sect2>
<sect2>
<title>Other Development Tools</title>
<sect3 role="package">
<title>cachecc1</title>
<para><application>cachecc1</application> is a
<application>GCC</application> cache. It can be compared with the well
known <application>ccache</application> package. It has some unique
features including the use of an LD_PRELOADed shared object to catch
invocations to <command>cc1</command>, <command>cc1plus</command> and
<command>as</command>, it transparently supports all build methods, it
can cache <application>GCC</application> bootstraps and it can be
combined with <application>distcc</application> to transparently
distribute compilations.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://cachecc1.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/cachecc1"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>ccache</title>
<para><application>ccache</application> is a compiler cache. It acts as
a caching pre-processor to C/C++ compilers, using the <option>-E</option>
compiler switch and a hash to detect when a compilation can be satisfied
from cache. This often results in 5 to 10 times faster speeds in common
compilations.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://ccache.samba.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://samba.org/ftp/ccache/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>DDD (GNU Data Display Debugger)</title>
<para><application>GNU DDD</application> is a graphical front-end for
command-line debuggers such as <application>GDB</application>,
<application>DBX</application>, <application>WDB</application>,
<application>Ladebug</application>, <application>JDB</application>,
<application>XDB</application>, the <application>Perl</application>
debugger, the <application>Bash</application> debugger, or the
<application>Python</application> debugger. Besides <quote>usual</quote>
front-end features such as viewing source texts,
<application>DDD</application> has an interactive graphical data display,
where data structures are displayed as graphs..</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.gnu.org/software/ddd/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://ftp.gnu.org/gnu/ddd/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>distcc</title>
<para><application>distcc</application> is a program to distribute builds
of C, C++, Objective C or Objective C++ code across several machines on a
network. <application>distcc</application> should always generate the
same results as a local build, is simple to install and use, and is
usually much faster than a local compile.
<application>distcc</application> does not require all machines to share
a filesystem, have synchronized clocks, or to have the same libraries or
header files installed. They can even have different processors or
operating systems, if cross-compilers are installed.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://distcc.samba.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://distcc.samba.org/download.html"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Exuberant Ctags</title>
<para><application>Exuberant Ctags</application> generates an index (or
tag) file of language objects found in source files that allows these
items to be quickly and easily located by a text editor or other utility.
A tag signifies a language object for which an index entry is available
(or, alternatively, the index entry created for that object). Tag
generation is supported for the following languages: Assembler, AWK, ASP,
BETA, Bourne/Korn/Zsh Shell, C, C++, COBOL, Eiffel, Fortran, Java, Lisp,
Lua, Make, Pascal, Perl, PHP, Python, REXX, Ruby, S-Lang, Scheme, Tcl,
Vim, and YACC. A list of editors and tools utilizing tag files may be
found at <ulink url="http://ctags.sourceforge.net/tools.html"/>.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://ctags.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/ctags/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>GDB (GNU Debugger)</title>
<para><application>GDB</application> is the GNU Project debugger. It
allows you to see what is going on <quote>inside</quote> another program
while it executes. It also allows you to see what another program was
doing at the moment it crashed.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.gnu.org/software/gdb/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="ftp://ftp.gnu.org/gnu/gdb/"/></para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes and Installation
Instructions: <ulink url="&blfs-wiki;/OtherProgrammingTools"/></para>
</sect3>
<sect3 role="package">
<title>gocache (GNU Object Cache)</title>
<para><application>ccache</application> is a clone of
<application>ccache</application>, with the goal of supporting
compilers other than <application>GCC</application> and adding additional
features. Embedded compilers will especially be in focus.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://sourceforge.net/projects/gocache/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/gocache/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>OProfile</title>
<para><application>OProfile</application> is a system-wide profiler for
Linux systems, capable of profiling all running code at low overhead.
<application>OProfile</application> is released under the GNU GPL. It
consists of a kernel driver and a daemon for collecting sample data, and
several post-profiling tools for turning data into information.
<application>OProfile</application> leverages the hardware performance
counters of the CPU to enable profiling of a wide variety of interesting
statistics, which can also be used for basic time-spent profiling. All
code is profiled: hardware and software interrupt handlers, kernel
modules, the kernel, shared libraries, and applications.
<application>OProfile</application> is currently in alpha status; however
it has proven stable over a large number of differing configurations. It
is being used on machines ranging from laptops to 16-way NUMA-Q
boxes.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://oprofile.sourceforge.net/news/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://oprofile.sourceforge.net/download/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>SCons</title>
<para><application>SCons</application> is an Open Source software
construction tool, i.e, a next-generation build tool. Think of
<application>SCons</application> as an improved, cross-platform
substitute for the classic <command>make</command> utility with
integrated functionality similar to
<application>Autoconf</application>/<application>Automake</application>
and compiler caches such as <command>ccache</command>.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://scons.sourceforge.net/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/scons/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>strace</title>
<para><application>strace</application> is a system call tracer, i.e., a
debugging tool which prints out a trace of all the system calls made by
another process or program.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://www.liacs.nl/~wichert/strace/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="&sourceforge-repo;/strace/"/></para>
</listitem>
</itemizedlist>
</sect3>
<sect3 role="package">
<title>Valgrind</title>
<para><application>Valgrind</application> is a collection of five tools:
two memory error detectors, a thread error detector, a cache profiler and
a heap profiler used for debugging and profiling Linux programs. Features
include automatic detection of many memory management and threading bugs
as well as detailed profiling to speed up and reduce memory use of your
programs.</para>
<itemizedlist spacing="compact">
<listitem>
<para>Project Home Page: <ulink
url="http://valgrind.org/"/></para>
</listitem>
<listitem>
<para>Download Location: <ulink
url="http://valgrind.org/downloads/source_code.html"/></para>
</listitem>
</itemizedlist>
</sect3>
</sect2>
</sect1>

/trunk/blfs/general/graphlib/poppler.xml
0,0 → 1,253
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY poppler-download-http "http://poppler.freedesktop.org/poppler-&poppler-version;.tar.gz">
<!ENTITY poppler-download-ftp " ">
<!ENTITY poppler-md5sum "053fdfd70533ecce1a06353fa945f061">
<!ENTITY poppler-size "1.0 MB">
<!ENTITY poppler-buildsize "49 MB (additional 15 MB to install the encoding data package)">
<!ENTITY poppler-time "1.0 SBU (includes building with all dependencies)">
<!ENTITY poppler-data-version "0.1">
]>
<sect1 id="poppler" xreflabel="Poppler-&poppler-version;">
<?dbhtml filename="poppler.html"?>
<sect1info>
<othername>$LastChangedBy: ken $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Poppler-&poppler-version;</title>
<indexterm zone="poppler">
<primary sortas="a-Poppler">Poppler</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Poppler</title>
<para>The <application>Poppler</application> package contains a PDF
rendering library and command line tools used to manipulate PDF files.
This is useful for providing PDF rendering functionality as a shared
library.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&poppler-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&poppler-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &poppler-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &poppler-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &poppler-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &poppler-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Required patch: <ulink
url="&patch-root;/poppler-&poppler-version;-security_fixes-2.patch"/></para>
</listitem>
<listitem>
<para>Poppler Encoding Data: <ulink
url="http://poppler.freedesktop.org/poppler-data-&poppler-data-version;.tar.gz"/></para>
</listitem>
</itemizedlist>
<para>The additional package consists of encoding files for use with
Poppler. The encoding files are optional and poppler will automatically
read them if they are present. When installed, they enable Poppler to
render CJK and Cyrillic properly.</para>
<bridgehead renderas="sect3">Poppler Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="pkgconfig"/> and
<xref linkend="fontconfig"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="libjpeg"/>,
<xref linkend="cairo"/>,
<xref linkend="gtk2"/>,
<xref linkend="qt"/>, and
<ulink url="http://www.trolltech.com/download/opensource.html">Qt-4.x.x</ulink></para>
<para>If you're installing <application>Poppler</application> to support
<xref linkend="kdegraphics"/>, you will need to have <xref linkend="qt"/>
installed so that the <filename class='libraryfile'>libpoppler-qt</filename>
library is built.</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/poppler"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Poppler</title>
<caution>
<para><application>Poppler</application> will overwrite command-line
utilities and man pages previously installed by the
<application>Xpdf</application> package. If you prefer to keep the
<application>Xpdf</application> versions of these files, pass the
<option>--disable-utils</option> parameter to the
<command>configure</command> command below.</para>
</caution>
<para>The <command>configure</command> command below includes three
parameters which disable various rendering back-ends. Ensure you remove
any of the parameters for which you have the corresponding dependency
installed. Install <application>Poppler</application> by running the
following commands:</para>
<screen><userinput>patch -Np1 -i ../poppler-&poppler-version;-security_fixes-1.patch &amp;&amp;
./configure --prefix=/usr \
--sysconfdir=/etc \
--enable-zlib \
--disable-cairo-output \
--disable-poppler-glib \
--disable-gtk-test &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/poppler-&poppler-version; &amp;&amp;
install -v -m644 README* /usr/share/doc/poppler-&poppler-version;</userinput></screen>
<para>If you downloaded the additional encoding data package, install
it by issuing the following command after unpacking the tarball and
changing into the newly-created package source directory (as the
<systemitem class="username">root</systemitem> user):</para>
<screen role="root"><userinput>make prefix=/usr install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--enable-zlib</parameter>: This parameter forces the build
to link with the system-installed
<filename class='libraryfile'>libz</filename> library to enable compressed
PDF functionality.</para>
<para><parameter>--disable-cairo-output</parameter>: This parameter
disables building the <application>cairo</application> graphics backend.
Remove this parameter if you have <application>cairo</application>
installed.</para>
<para><parameter>--disable-poppler-glib</parameter> and
<parameter>--disable-gtk-test</parameter>: These parameters disable
building the <application>GLib</application> wrapper and
<application>GTK+</application> test program. Remove these parameters if
you have <application>GTK+</application>-2 installed. Note that if you
plan on building <xref linkend="evince"/>, you must build the
<application>GLib</application> wrapper.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring Poppler</title>
<sect3 id="poppler-config">
<title>Config Files</title>
<para><filename>/etc/xpdfrc</filename></para>
<indexterm zone="poppler poppler-config">
<primary sortas="e-etc-xpdfrc">/etc/xpdfrc</primary>
</indexterm>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg><xref linkend="xpdf-content"/></seg>
<seg>libpoppler.{so,a}, libpoppler-glib.{so,a},
libpoppler-qt.{so,a} and libpoppler-qt4.{so,a}</seg>
<seg>/usr/include/poppler,
/usr/share/doc/poppler-&poppler-version;,
/usr/share/gtk-doc/html/poppler and
/usr/share/poppler</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libpoppler">
<term><filename class='libraryfile'>libpoppler.{so,a}</filename></term>
<listitem>
<para>contains the API functions to render PDF files.</para>
<indexterm zone="poppler libpoppler">
<primary sortas="c-libpoppler">libpoppler.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libpoppler-glib">
<term><filename class='libraryfile'>libpoppler-glib.{so,a}</filename></term>
<listitem>
<para>is a wrapper library used to interface the PDF rendering
functions with <application>GTK+</application>.</para>
<indexterm zone="poppler libpoppler-glib">
<primary sortas="c-libpoppler-glib">libpoppler-glib.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libpoppler-qt">
<term><filename class='libraryfile'>libpoppler-qt.{so,a}</filename></term>
<listitem>
<para>is a wrapper library used to interface the PDF rendering
functions with <application>Qt</application>.</para>
<indexterm zone="poppler libpoppler-qt">
<primary sortas="c-libpoppler-qt">libpoppler-qt.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libpoppler-qt4">
<term><filename class='libraryfile'>libpoppler-qt4.{so,a}</filename></term>
<listitem>
<para>is a wrapper library used to interface the PDF rendering
functions with <application>Qt</application>-4.</para>
<indexterm zone="poppler libpoppler-qt4">
<primary sortas="c-libpoppler-qt4">libpoppler-qt4.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/graphlib/libexif.xml
0,0 → 1,141
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY libexif-download-http "&sourceforge-repo;/libexif/libexif-&libexif-version;.tar.bz2">
<!ENTITY libexif-download-ftp " ">
<!ENTITY libexif-md5sum "deee153b1ded5a944ea05d041d959eca">
<!ENTITY libexif-size "691 KB">
<!ENTITY libexif-buildsize "10 MB">
<!ENTITY libexif-time "0.1 SBU">
]>
<sect1 id="libexif" xreflabel="libexif-&libexif-version;">
<?dbhtml filename="libexif.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>libexif-&libexif-version;</title>
<indexterm zone="libexif">
<primary sortas="a-Libexif">Libexif</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to libexif</title>
<para>The <application>libexif</application> package contains a library
for parsing, editing, and saving EXIF data. Most digital cameras produce
EXIF files, which are JPEG files with extra tags that contain information
about the image. All EXIF tags described in EXIF standard 2.1 are
supported.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libexif-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libexif-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &libexif-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &libexif-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libexif-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &libexif-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">libexif Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional (to Build Documentation)</bridgehead>
<para role="optional"><xref linkend="doxygen"/> and
<xref linkend="graphviz"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libexif"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of libexif</title>
<para>Install <application>libexif</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr \
--with-doc-dir=/usr/share/doc/libexif-&libexif-version; &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
<para>Documentation was built and installed if you have the dependencies
shown above installed. If you don't have the dependencies installed, there
is a compressed tarball in the source tree
<filename class='directory'>doc</filename> directory that can be unpacked
into /usr/share/doc/libexif-&libexif-version;.</para>
</sect2>
<!-- <sect2 role="commands">
<title>Command Explanations</title>
<para><command>sed -i ... doc/Makefile.in</command>:
Installation of <application>libexif</application> will fail if
<application>Doxygen</application> is not present on the system due to
a packaging bug. The command does not affect the situation where
<application>Doxygen</application> is installed.</para>
</sect2> -->
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libexif.{so,a}</seg>
<seg>/usr/include/libexif and
/usr/share/doc/libexif-&libexif-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="libexif-lib">
<term><filename class='libraryfile'>libexif.{so,a}</filename></term>
<listitem>
<para>contains functions used for parsing, editing, and saving
EXIF data.</para>
<indexterm zone="libexif libexif-lib">
<primary sortas="c-libexif">libexif.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/graphlib/fribidi.xml
0,0 → 1,149
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY fribidi-download-http "http://fribidi.org/download/fribidi-&fribidi-version;.tar.gz">
<!ENTITY fribidi-download-ftp " ">
<!ENTITY fribidi-md5sum "fe6a1e370353e330bbe043bb1697d04e">
<!ENTITY fribidi-size "619 KB">
<!ENTITY fribidi-buildsize "5 MB">
<!ENTITY fribidi-time "0.2 SBU">
]>
<sect1 id="fribidi" xreflabel="FriBidi-&fribidi-version;">
<?dbhtml filename="fribidi.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>FriBidi-&fribidi-version;</title>
<indexterm zone="fribidi">
<primary sortas="a-FriBidi">FriBidi</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to FriBidi</title>
<para>The <application>FriBidi</application> package is an implementation
of the <ulink url="http://www.unicode.org/reports/tr9/">Unicode
Bidirectional Algorithm (bidi)</ulink>. This is useful for supporting
Arabic and Hebrew alphabets in other packages.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&fribidi-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&fribidi-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &fribidi-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &fribidi-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &fribidi-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &fribidi-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Required patch: <ulink
url="&patch-root;/fribidi-&fribidi-version;-test_fixes-1.patch"/></para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/fribidi"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of FriBidi</title>
<para>Install <application>FriBidi</application> by running the following
commands:</para>
<screen><userinput>patch -Np1 -i ../fribidi-&fribidi-version;-test_fixes-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>fribidi and fribidi-config</seg>
<seg>libfribidi.{so,a}</seg>
<seg>/usr/include/fribidi</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="fribidi-prog">
<term><command>fribidi</command></term>
<listitem>
<para>is a command-line interface to the
<filename class='libraryfile'>libfribidi</filename> library and can
be used to convert a logical string to visual output.</para>
<indexterm zone="fribidi fribidi-prog">
<primary sortas="b-fribidi">fribidi</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="fribidi-config">
<term><command>fribidi-config</command></term>
<listitem>
<para>is used to acquire information about the installed
<filename class='libraryfile'>libfribidi</filename> library.</para>
<indexterm zone="fribidi fribidi-config">
<primary sortas="b-fribidi-config">fribidi-config</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libfribidi">
<term><filename class='libraryfile'>libfribidi.{so,a}</filename></term>
<listitem>
<para>contains functions used to implement the <ulink
url="http://www.unicode.org/reports/tr9/"> Unicode Bidirectional
Algorithm</ulink>.</para>
<indexterm zone="fribidi libfribidi">
<primary sortas="c-libfribidi">libfribidi.{so,a}</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genutils/rxvt-unicode.xml
0,0 → 1,215
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY rxvt-unicode-download-http "http://dist.schmorp.de/rxvt-unicode/Attic/rxvt-unicode-&rxvt-unicode-version;.tar.bz2">
<!ENTITY rxvt-unicode-download-ftp " ">
<!ENTITY rxvt-unicode-md5sum "f3c4fea3d544a340fa5a1d601ff5f204">
<!ENTITY rxvt-unicode-size "860 KB">
<!ENTITY rxvt-unicode-buildsize "27 MB">
<!ENTITY rxvt-unicode-time "0.2 SBU">
]>
<sect1 id="rxvt-unicode" xreflabel="rxvt-unicode-&rxvt-unicode-version;">
<?dbhtml filename="rxvt-unicode.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>rxvt-unicode-&rxvt-unicode-version;</title>
<indexterm zone="rxvt-unicode">
<primary sortas="a-rxvt-unicode">rxvt-unicode</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to rxvt-unicode</title>
<para><application>rxvt-unicode</application> is a clone of the terminal
emulator <application>rxvt</application>, an X Window System terminal
emulator which includes support for XFT and Unicode.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&rxvt-unicode-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&rxvt-unicode-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &rxvt-unicode-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &rxvt-unicode-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &rxvt-unicode-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &rxvt-unicode-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Required patch: <ulink
url="&patch-root;/rxvt-unicode-&rxvt-unicode-version;-DISPLAY_fix-1.patch"/></para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">rxvt-unicode Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="x-window-system"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><ulink
url="http://sourceforge.net/projects/afterstep">libAfterImage</ulink>
(adds support for transparency and background images)</para>
<para condition="html" role="usernotes">User Notes:
<ulink url='&blfs-wiki;/rxvt-unicode'/></para>
</sect2>
<sect2 role="installation">
<title>Installation of rxvt-unicode</title>
<para>Install <application>rxvt-unicode</application> by running the
following commands:</para>
<screen><userinput>patch -Np1 -i ../rxvt-unicode-&rxvt-unicode-version;-DISPLAY_fix-1.patch &amp;&amp;
./configure --prefix=/usr --enable-everything &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--enable-everything</parameter>: Add support for all
non-multichoice options. Details about the different options can be found in
the file <filename>README.configure</filename>.</para>
<para><option>--disable-xft</option>: Remove support for Xft fonts.</para>
<para><option>--disable-perl</option>: Disable the embedded
<application>Perl</application> interpreter.</para>
<para><option>--disable-afterimage</option>: Remove support for
libAfterImage.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring rxvt-unicode</title>
<para>The <application>rxvt-unicode</application> terminal emulator
uses the resource class <classname>URxvt</classname> and the resource name
<classname>urxvt</classname>. You can add X resource definitions to a
user's <filename>~/.Xresources</filename> file or to the system-wide
<filename>/etc/X11/app-defaults/URxvt</filename> file. The following
example will load the <classname>matcher</classname>
<application>Perl</application> extension (assuming
<application>Perl</application> support wasn't disabled), which enables a
middle button click to open an underlined URL in the specified browser,
sets a background and foreground color and loads an Xft font:</para>
<screen><userinput>cat &gt;&gt; /etc/X11/app-defaults/URxvt &lt;&lt; "EOF"
<literal>URxvt*perl-ext: matcher
URxvt*urlLauncher: firefox
URxvt.background: black
URxvt.foreground: yellow
URxvt*font: xft:Monospace:pixelsize=12</literal>
EOF</userinput></screen>
<para>The <application>rxvt-unicode</application> application can also run
in a daemon mode, which makes it possible to open multiple terminal windows
within the same process. The <command>urxvtc</command> client then connects
to the <command>urxvtd</command> daemon and requests a new terminal window.
Use this option with caution. If the daemon crashes, all the running
processes in the terminal windows are terminated.</para>
<para>You can start the <command>urxvtd</command> daemon in the system or
personal startup <command>X</command> session script (e.g.,
<filename>~/.xinitrc</filename>) by adding the following lines near the top
of the script:</para>
<screen><userinput><literal># Start the urxvtd daemon
urxvtd -q -f -o &amp;</literal></userinput></screen>
<para>For more information, examine the <command>urxvt</command>,
<command>urxvtd</command>, <command>urxvtc</command>, and
<filename>urxvtperl</filename> man pages.</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>urxvt, urxvtd, and urxvtc</seg>
<seg>Many <application>Perl</application> extensions located under
<filename class='directory'>/usr/lib/urxvt/perl</filename></seg>
<seg>/usr/lib/urxvt</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="urxvt-bin">
<term><command>urxvt</command></term>
<listitem>
<para>is a terminal emulator for the X Window System.</para>
<indexterm zone="rxvt-unicode urxvt-bin">
<primary sortas="b-urxvt-bin">urxvt</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="urxvtd">
<term><command>urxvtd</command></term>
<listitem>
<para>is the <command>urxvt</command> terminal daemon.</para>
<indexterm zone="rxvt-unicode urxvtd">
<primary sortas="b-urxvtd">urxvtd</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="urxvtc">
<term><command>urxvtc</command></term>
<listitem>
<para>controls the <command>urxvtd</command> daemon.</para>
<indexterm zone="rxvt-unicode urxvtc">
<primary sortas="b-urxvtc">xterm</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genutils/scrollkeeper.xml
0,0 → 1,201
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY scrollkeeper-download-http "&gnome-download-http;/scrollkeeper/0.3/scrollkeeper-&scrollkeeper-version;.tar.bz2">
<!ENTITY scrollkeeper-download-ftp "&gnome-download-ftp;/scrollkeeper/0.3/scrollkeeper-&scrollkeeper-version;.tar.bz2">
<!ENTITY scrollkeeper-md5sum "b175e582a6cec3e50a9de73a5bb7455a">
<!ENTITY scrollkeeper-size "546 KB">
<!ENTITY scrollkeeper-buildsize "12 MB">
<!ENTITY scrollkeeper-time "0.1 SBU">
]>
<sect1 id="scrollkeeper" xreflabel="ScrollKeeper-&scrollkeeper-version;">
<?dbhtml filename="scrollkeeper.html"?>
<sect1info>
<othername>$LastChangedBy: randy $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>ScrollKeeper-&scrollkeeper-version;</title>
<indexterm zone="scrollkeeper">
<primary sortas="a-ScrollKeeper">ScrollKeeper</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to ScrollKeeper</title>
<para>The <application>ScrollKeeper</application> package contains a
cataloging system for documentation. This is useful for managing
documentation metadata and providing an API to help browsers find, sort
and search the document catalog.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&scrollkeeper-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&scrollkeeper-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &scrollkeeper-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &scrollkeeper-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &scrollkeeper-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &scrollkeeper-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">ScrollKeeper Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="libxslt"/>,
<xref linkend="DocBook"/>, and
<xref linkend="perl-xml-parser"/></para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="intltool"/></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/scrollkeeper"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of ScrollKeeper</title>
<para>Install <application>ScrollKeeper</application> by running the
following commands:</para>
<screen><userinput>./configure --prefix=/usr \
--sysconfdir=/etc \
--localstatedir=/var \
--disable-static \
--with-omfdirs=/usr/share/omf:\
/opt/kde-&kde-version;/share/omf:\
/opt/gnome-&gnome-version;&gnome-minor-version;/share/omf &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--sysconfdir=/etc</parameter>: This switch puts the
configuration files in <filename class="directory">/etc</filename>
instead of <filename class='directory'>/usr/etc</filename>.</para>
<para><parameter>--localstatedir=/var</parameter>: This switch puts
<application>ScrollKeeper</application>'s database directory in
<filename class="directory">/var/lib/scrollkeeper</filename>.</para>
<para><parameter>--disable-static</parameter>: This switch prevents
the static library from being built.</para>
<para><parameter>--with-omfdirs=...</parameter>: This switch defines the
locations of <filename>OMF</filename> files for
<application>ScrollKeeper</application>. Change the locations if you have
<application>KDE</application> and/or <application>GNOME</application>-2
installed in a prefix other than the ones shown. This information is stored
in <filename>/etc/scrollkeeper.conf</filename> and can be updated manually,
if necessary.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring ScrollKeeper</title>
<sect3 id="scrollkeeper-config">
<title>Config Files</title>
<para><filename>/etc/scrollkeeper.conf</filename></para>
<indexterm zone="scrollkeeper scrollkeeper-config">
<primary sortas="e-etc-scrollkeeper.conf">/etc/scrollkeeper.conf</primary>
</indexterm>
</sect3>
<sect3>
<title>Configuration Information</title>
<para>The configuration file sets the <envar>OMF_DIR</envar> variable
to the location of all of the <filename class="directory">omf</filename>
directories in the system. This was set in the
<command>configure</command> command so no further action is needed until
another <filename>OMF</filename> directory is created.</para>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>scrollkeeper-config, scrollkeeper-extract, scrollkeeper-gen-seriesid,
scrollkeeper-get-cl, scrollkeeper-get-content-list,
scrollkeeper-get-extended-content-list, scrollkeeper-get-index-from-docpath,
scrollkeeper-get-toc-from-docpath, scrollkeeper-get-toc-from-id,
scrollkeeper-install, scrollkeeper-preinstall, scrollkeeper-rebuilddb,
scrollkeeper-uninstall, and scrollkeeper-update</seg>
<seg>libscrollkeeper.so</seg>
<seg>/usr/share/doc/scrollkeeper-&scrollkeeper-version;,
/usr/share/{omf, {,xml/}scrollkeeper}, and
/var/lib/scrollkeeper</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry>
<term><command>ScrollKeeper utility programs</command></term>
<listitem>
<para>The <application>ScrollKeeper</application> utility programs
and scripts listed above are for performing installation, building,
getting and updating table of contents files.</para>
</listitem>
</varlistentry>
<varlistentry id="libscrollkeeper">
<term><filename class='libraryfile'>libscrollkeeper.so</filename></term>
<listitem>
<para>provides the API necessary for help
browsers to interact with documentation written to utilize
<application>ScrollKeeper</application>.</para>
<indexterm zone="scrollkeeper libscrollkeeper">
<primary sortas="c-libscrollkeeper">libscrollkeeper.so</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

/trunk/blfs/general/genutils/graphviz.xml
0,0 → 1,612
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY graphviz-download-http "http://www.graphviz.org/pub/graphviz/ARCHIVE/graphviz-&graphviz-version;.tar.gz">
<!ENTITY graphviz-download-ftp "&gentoo-ftp-repo;/graphviz-&graphviz-version;.tar.gz">
<!ENTITY graphviz-md5sum "e5547bc0ec47943c72f5c3e2b5dff58f">
<!ENTITY graphviz-size "4.6 MB">
<!ENTITY graphviz-buildsize "102 MB">
<!ENTITY graphviz-time "1.8 SBU">
]>
<sect1 id="graphviz" xreflabel="Graphviz-&graphviz-version;">
<?dbhtml filename="graphviz.html"?>
<sect1info>
<othername>$LastChangedBy: dj $</othername>
<date>$Date: 2008-11-16 21:28:00 $</date>
</sect1info>
<title>Graphviz-&graphviz-version;</title>
<indexterm zone="graphviz">
<primary sortas="a-Graphviz">Graphviz</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Graphviz</title>
<para>The <application>Graphviz</application> package contains graph
visualization software. Graph visualization is a way of representing
structural information as diagrams of abstract graphs and networks.
<application>Graphviz</application> has several main graph layout
programs. It also has web and interactive graphical interfaces, auxiliary
tools, libraries, and language bindings.</para>
<para>The <application>Graphviz</application> layout programs take
descriptions of graphs in a simple text language, and creates diagrams in
several useful formats such as images and SVG for web pages, Postscript for
inclusion in PDF or other documents, or as objects displayed in an
interactive graph browser. (Graphviz also supports GXL, an XML dialect.) In
practice, graphs are usually generated from external data sources, but they
can also be created and edited manually, either as raw text files or within
a graphical editor. (Graphviz was not intended to be a
<application>Visio</application> replacement, so it would probably be
frustrating to try to use it that way.)</para>
<para>This package is useful for automatic graph drawing which has many
important applications in software engineering, database and web design,
networking, and in visual interfaces for many other domains. Graphviz has
many useful features for concrete diagrams, such as options for colors,
fonts, tabular node layouts, line styles, hyperlinks, and custom
shapes.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&graphviz-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&graphviz-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &graphviz-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &graphviz-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &graphviz-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &graphviz-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Required patch: <ulink
url="&patch-root;/graphviz-&graphviz-version;-gd_fixes-1.patch"/></para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Graphviz Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><xref linkend="pkgconfig"/>,
<xref linkend="expat"/>,
<xref linkend="libpng"/>,
<xref linkend="libjpeg"/>,
<xref linkend="freetype2"/>,
<xref linkend="fontconfig"/>,
<xref linkend="x-window-system"/>,
<xref linkend="pango"/> (built with <application>cairo</application> support),
<xref linkend="gtk2"/>,
<xref linkend="libgnomeui"/>,
<xref linkend="libglade"/>,
<xref linkend="tcl"/>,
<xref linkend="tk"/>,
<ulink url="http://www.boutell.com/gd/">GD Library</ulink>, and
<ulink url="http://www.perens.com/FreeSoftware/ElectricFence/">Electric Fence</ulink></para>
<bridgehead renderas="sect4">Optional
(to Build Language Bindings)</bridgehead>
<para role="optional"><ulink url="http://www.swig.org/">SWIG</ulink>
(<application>SWIG</application> must be installed or no bindings will be
built),
<xref linkend="guile"/>,
<xref linkend="jdk"/>,
<xref linkend="php"/>,
<xref linkend="python"/>,
<xref linkend="ruby"/>,
<xref linkend="tcl"/>,
C# (<ulink url="http://www.southern-storm.com.au/portable_net.html">DotGNU Portable.NET</ulink>
or <ulink url="http://www.mono-project.com/Main_Page">Mono</ulink>),
<ulink url="http://www.iolanguage.com/about/">Io</ulink>,
<ulink url="http://www.lua.org/">Lua</ulink>, and
<ulink url="http://caml.inria.fr/ocaml/index.en.html">Objective Caml</ulink></para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/graphviz"/></para>
</sect2>
<sect2 role="installation">
<title>Installation of Graphviz</title>
<para>If you wish to compile the <application>Java</application> language
bindings, you will need to supply the path to the
<application>Java</application> headers with the following command:</para>
<screen><userinput>export CPPFLAGS="$CPPFLAGS -I$JAVA_HOME/include -I$JAVA_HOME/include/linux"</userinput></screen>
<para>Install <application>Graphviz</application> by running the following
commands:</para>
<screen><userinput>patch -Np1 -i ../graphviz-&graphviz-version;-gd_fixes-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite that provides
meaningful results.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
<para>If desired, create a symbolic link in the system documents directory
to the documentation installed in
<filename class='directory'>/usr/share/graphviz/doc</filename> using the
following command as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>ln -v -s /usr/share/graphviz/doc \
/usr/share/doc/graphviz-&graphviz-version;</userinput></screen>
</sect2>
<sect2 role="configuration">
<title>Configuring Graphviz</title>
<sect3 id="graphviz-config">
<title>Config Files</title>
<para><filename>/usr/lib/graphviz/config</filename></para>
<indexterm zone="graphviz graphviz-config">
<primary sortas="e-usr-share-graphviz-config">/usr/share/graphviz/config</primary>
</indexterm>
</sect3>
<sect3><title>Configuration Information</title>
<para>There are no specific configuration requirements for
<application>Graphviz</application>. You may consider installing the
additional plugins and tools available from the download page at
<ulink url="http://www.graphviz.org/Download_source.php"/> for additional
capabilities. If additional plugins are installed, you can run
<command>dot_static -c</command> (as the
<systemitem class="username">root</systemitem> user) to update the
<filename>config</filename> file in
<filename class='directory'>/usr/lib/graphviz</filename>.</para>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>acyclic, bcomps, ccomps, circo, dijkstra, dot, dot2gxl,
dot_static, dotty, fdp, gc, gvcolor, gvpack, gvpr, gxl2dot, lefty,
lneato, nop, prune, sccmap, tred, twopi and unflatten</seg>
<seg>libagraph.{so,a}, libcdt.{so,a}, libexpr.{so,a}, libgraph.{so,a},
libpack.{so,a}, libpathplan.{so,a}, additional support libraries
and language bindings</seg>
<seg>/usr/include/graphviz, /usr/lib/graphviz and
/usr/share/graphviz</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="acyclic">
<term><command>acyclic</command></term>
<listitem>
<para>is a filter that takes a directed graph as input and outputs a
copy of the graph with sufficient edges reversed to make the graph
acyclic. The reversed edge inherits all of the attributes of the
original edge.</para>
<indexterm zone="graphviz acyclic">
<primary sortas="b-acyclic">acyclic</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="bcomps">
<term><command>bcomps</command></term>
<listitem>
<para>decomposes graphs into their biconnected components, printing
the components to standard output.</para>
<indexterm zone="graphviz bcomps">
<primary sortas="b-bcomps">bcomps</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="ccomps">
<term><command>ccomps</command></term>
<listitem>
<para>decomposes graphs into their connected components, printing the
components to standard output.</para>
<indexterm zone="graphviz ccomps">
<primary sortas="b-ccomps">ccomps</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="circo">
<term><command>circo</command></term>
<listitem>
<para>draws graphs using a circular layout. The tool identifies
biconnected components and draws the nodes of the component on a
circle. The block-cutpoint tree is then laid out using a recursive
radial algorithm. Edge crossings within a circle are minimized by
placing as many edges on the circle's perimeter as possible. In
particular, if the component is outerplanar, the component will have
a planar layout.</para>
<indexterm zone="graphviz circo">
<primary sortas="b-circo">circo</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dijkstra">
<term><command>dijkstra</command></term>
<listitem>
<para>reads a stream of graphs and for each computes the distance of
every node from sourcenode.</para>
<indexterm zone="graphviz dijkstra">
<primary sortas="b-dijkstra">dijkstra</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dot">
<term><command>dot</command></term>
<listitem>
<para>draws directed graphs. It works well on DAGs and other graphs
that can be drawn as hierarchies. It reads attributed graph files and
writes drawings. By default, the output format dot is the input file
with layout coordinates appended.</para>
<indexterm zone="graphviz dot">
<primary sortas="b-dot">dot</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dot2gxl">
<term><command>dot2gxl</command></term>
<listitem>
<para>converts between graphs represented in GXL and in the DOT
language. Unless a conversion type is specified using a flag,
<command>gxl2dot</command> will deduce the type of conversion from
the suffix of the input file, a
<filename class='extension'>.dot</filename> suffix causing a
conversion from DOT to GXL, and a
<filename class='extension'>.gxl</filename> suffix causing a
conversion from GXL to DOT.</para>
<indexterm zone="graphviz dot2gxl">
<primary sortas="b-dot2gxl">dot2gxl</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dot_static">
<term><command>dot_static</command></term>
<listitem>
<para>is a version of <command>dot</command>that has all the
<application>Graphviz</application> libraries compiled
statically.</para>
<indexterm zone="graphviz dot_static">
<primary sortas="b-dot_static">dot_static</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="dotty">
<term><command>dotty</command></term>
<listitem>
<para>is a graph editor for the X Window System. It may be run as a
standalone editor, or as a front end for applications that use
graphs. It can control multiple windows viewing different
graphs.</para>
<indexterm zone="graphviz dotty">
<primary sortas="b-dotty">dotty</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="fdp">
<term><command>fdp</command></term>
<listitem>
<para>draws undirected graphs using a <quote>spring</quote> model. It
relies on a force-directed approach in the spirit of Fruchterman and
Reingold.</para>
<indexterm zone="graphviz fdp">
<primary sortas="b-fdp">fdp</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gc-graphviz">
<term><command>gc</command></term>
<listitem>
<para>is a graph analogue to <command>wc</command> in that it prints
to standard output the number of nodes, edges, connected components
or clusters contained in the input files. It also prints a total
count for all graphs if more than one graph is given.</para>
<indexterm zone="graphviz gc-graphviz">
<primary sortas="b-gc">gc</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gvcolor">
<term><command>gvcolor</command></term>
<listitem>
<para>is a filter that sets node colors from initial seed values.
Colors flow along edges from tail to head, and are averaged (as HSB
vectors) at nodes. The graph must already have been processed by
<command>dot</command>.</para>
<indexterm zone="graphviz gvcolor">
<primary sortas="b-gvcolor">gvcolor</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gvpack">
<term><command>gvpack</command></term>
<listitem>
<para>reads in a stream of graphs, combines the graphs into a single
layout, and produces a single graph serving as the union of the input
graphs. The input graphs must be in <command>dot</command> format, and
must have all necessary layout information.</para>
<indexterm zone="graphviz gvpack">
<primary sortas="b-gvpack">gvpack</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gvpr">
<term><command>gvpr</command></term>
<listitem>
<para>is a graph stream editor inspired by <command>awk</command>. It
copies input graphs to its output, possibly transforming their
structure and attributes, creating new graphs, or printing arbitrary
information.</para>
<indexterm zone="graphviz gvpr">
<primary sortas="b-gvpr">gvpr</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="gxl2dot">
<term><command>gxl2dot</command></term>
<listitem>
<para>converts between graphs represented in GXL and in the DOT
language. Unless a conversion type is specified using a flag,
<command>gxl2dot</command> will deduce the type of conversion from
the suffix of the input file, a
<filename class='extension'>.dot</filename> suffix causing a
conversion from DOT to GXL, and a
<filename class='extension'>.gxl</filename> suffix causing a
conversion from GXL to DOT.</para>
<indexterm zone="graphviz gxl2dot">
<primary sortas="b-gxl2dot">gxl2dot</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="lefty">
<term><command>lefty</command></term>
<listitem>
<para>is a two-view graphics editor for technical pictures.</para>
<indexterm zone="graphviz lefty">
<primary sortas="b-lefty">lefty</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="lneato">
<term><command>lneato</command></term>
<listitem>
<para>is a graph editor for the X Window System. It may be run as a
standalone editor, or as a front end for applications that use
graphs. It can control multiple windows viewing different
graphs.</para>
<indexterm zone="graphviz lneato">
<primary sortas="b-lneato">lneato</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="nop">
<term><command>nop</command></term>
<listitem>
<para>reads a stream of graphs and prints each in pretty-printed
(canonical) format on stdout. If no files are given, it reads from
stdin.</para>
<indexterm zone="graphviz nop">
<primary sortas="b-nop">nop</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="prune">
<term><command>prune</command></term>
<listitem>
<para>reads directed graphs in the same format used by
<command>dot</command> and removes subgraphs rooted at nodes
specified on the command line via options. These nodes themselves
will not be removed, but can be given attributes so that they can be
easily located by a graph stream editor such as
<command>gpr</command>. <command>prune</command> correctly handles
cycles, loops and multi-edges.</para>
<indexterm zone="graphviz prune">
<primary sortas="b-prune">prune</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="sccmap">
<term><command>sccmap</command></term>
<listitem>
<para>decomposes digraphs into strongly connected components and an
auxiliary map of the relationship between components. In this map,
each component is collapsed into a node. The resulting graphs are
printed to standard out. The number of nodes, edges and strongly
connected components are printed to standard error.
<command>sccmap</command> is a way of partitioning large graphs into
more manageable pieces.</para>
<indexterm zone="graphviz sccmap">
<primary sortas="b-sccmap">sccmap</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="tred">
<term><command>tred</command></term>
<listitem>
<para>computes the transitive reduction of directed graphs, and
prints the resulting graphs to standard output. This removes edges
implied by transitivity. Nodes and subgraphs are not otherwise
affected. The <quote>meaning</quote> and validity of the reduced
graphs is application dependent. <command>tred</command> is
particularly useful as a preprocessor to <command>dot</command> to
reduce clutter in dense layouts.</para>
<indexterm zone="graphviz tred">
<primary sortas="b-tred">tred</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="twopi">
<term><command>twopi</command></term>
<listitem>
<para>draws graphs using a radial layout. Basically, one node is
chosen as the center and put at the origin. The remaining nodes are
placed on a sequence of concentric circles centered about the origin,
each a fixed radial distance from the previous circle.</para>
<indexterm zone="graphviz twopi">
<primary sortas="b-twopi">twopk</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="unflatten">
<term><command>unflatten</command></term>
<listitem>
<para>is a preprocessor to <command>dot</command> that is used to
improve the aspect ratio of graphs having many leaves or disconnected