Changeset 52d29f7


Ignore:
Timestamp:
06/12/2004 10:56:28 PM (17 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 6.0, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, ken/refactor-virt, krejzi/svn, lazarus, nosym, perl-modules, qt5new, systemd-11177, systemd-13485, trunk, upgradedb, xry111/git-date, xry111/git-date-for-trunk, xry111/git-date-test
Children:
d3edf27
Parents:
bfe245f
Message:

XML Updates to Part III from DJ

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

Files:
70 edited

Legend:

Unmodified
Added
Removed
  • general.ent

    rbfe245f r52d29f7  
    4848                           
    4949<!-- Part III -->           
     50<!-- Chapter 8 -->
     51<!ENTITY openssl-version           "0.9.7d">
     52<!ENTITY pcre-version              "4.5">
     53<!ENTITY popt-version              "1.7">
     54<!ENTITY slang-version             "1.4.9">
     55<!ENTITY fam-version               "2.7.0">
     56<!ENTITY libxml-version            "1.8.17">
     57<!ENTITY libxml2-version           "2.6.9">
     58<!ENTITY libxslt-version           "1.1.6">
     59<!ENTITY readline-version          "4.3">
     60<!ENTITY gmp-version               "4.1.3">
     61<!ENTITY gdbm-version              "1.8.3">
     62<!ENTITY GLib-version              "1.2.10">
     63<!ENTITY GLib2-version             "2.4.1">
     64<!ENTITY expat-version             "1.95.7">
     65<!ENTITY libesmtp-version          "1.0.2">
     66<!ENTITY aspell-version            "0.50.5">
     67<!ENTITY ispell-version            "3.2.06.epa7">
     68<!ENTITY guile-version             "1.6.4">
     69<!ENTITY slib-version              "2d6">
     70<!ENTITY gwrap-version             "1.3.4">
     71<!ENTITY LZO-version               "1.08">
     72<!ENTITY libpcap-version           "0.8.3">
     73<!ENTITY libusb-version            "0.1.8">
     74
     75<!-- Chapter 9 -->
     76<!ENTITY libjpeg-version           "6b">
     77<!ENTITY libpng-version            "1.2.5">
     78<!ENTITY libtiff-version           "3.6.1">
     79<!ENTITY libungif-version          "4.1.0b1">
     80<!ENTITY libmng-version            "1.0.7">
     81<!ENTITY lcms-version              "1.12">
     82<!ENTITY freetype2-version         "2.1.7">
     83<!ENTITY fontconfig-version        "2.2.2">
     84<!ENTITY imlib-version             "1.9.14">
     85<!ENTITY aalib-version             "1.4rc5">
     86<!ENTITY SVGAlib-version           "1.4.3">
     87<!ENTITY DirectFB-version          "0.9.20">
     88<!ENTITY imlib2-version            "1.1.0">
     89                                                                                   
     90<!-- Chapter 10 -->
     91<!ENTITY bc-version                "1.06">
     92<!ENTITY rep-gtk-version           "0.18">
     93<!ENTITY compface-version          "1.4">
     94<!ENTITY imagemagick-version       "5.5.7">
     95<!ENTITY hd2u-version              "0.9.0">
     96                                                                                   
     97<!-- Chapter 11 -->
     98<!ENTITY gpm-version               "1.20.1">
     99<!ENTITY fcron-version             "2.9.4">
     100<!ENTITY hdparm-version            "5.5">
     101<!ENTITY which-version             "2.16">
     102<!ENTITY unzip-version             "5.51">
     103<!ENTITY zip-version               "2.3">
     104<!ENTITY pciutils-version          "2.1.11">
     105<!ENTITY pkgconfig-version         "0.15.0">
     106<!ENTITY cpio-version              "2.5">
     107<!ENTITY mc-version                "4.6.0">
     108
     109<!-- Chapter 12 -->
     110<!ENTITY Python-version            "2.3.3">
     111<!ENTITY Gtk-Perl-version          "0.7009">
     112<!ENTITY PDL-version               "2.4.0">
     113<!ENTITY XML-Parser-version        "2.34">
     114<!ENTITY XML-Writer-version        "0.4.1">
     115<!ENTITY Astro-FITS-Header-version "2.8.1">
     116<!ENTITY Parse-RecDescent-version  "1.94">
     117<!ENTITY librep-version            "0.17">
     118<!ENTITY j2sdk-bin-version         "1.4.2_03">
     119<!ENTITY j2sdk-src-version         "1.4.2">
     120<!ENTITY ruby-version              "1.8.1">
     121<!ENTITY gcc-version               "3.3.3">
     122<!ENTITY tcl-version               "8.4.6">
     123<!ENTITY tk-version                "8.4.6">
     124<!ENTITY gcc2-version              "2.95.3">
     125<!ENTITY NASM-version              "0.98.38">
    50126                           
    51127<!-- Part IV -->           
     
    103179
    104180<!ENTITY gnome-version     "2.6">
     181<!ENTITY docbook-dsssl-version "1.78">
     182
  • general/general.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4 <!ENTITY % general-entities SYSTEM "../general.ent">
     5 %general-entities;
     6]>
     7
    18<part id="general" xreflabel="General Libraries and Utilities">
    29<?dbhtml filename="general.html" dir="general"?>
    310<title>General Libraries and Utilities</title>
    411
    5 &general-genlib;
    6 &general-graphlib;
    7 &general-genutils;
    8 &general-sysutils;
    9 &general-prog;
     12<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="genlib/genlib.xml"/>
     13<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="graphlib/graphlib.xml"/>
     14<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="genutils/genutils.xml"/>
     15<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="sysutils/sysutils.xml"/>
     16<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="prog/prog.xml"/>
    1017
    1118</part>
  • general/genlib/aspell.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY aspell-download-http " ">
     8<!ENTITY aspell-download-ftp "ftp://ftp.gnu.org/gnu/aspell/aspell-&aspell-version;.tar.gz">
     9<!ENTITY aspell-size "917 KB">
     10<!ENTITY aspell-buildsize "9.8 MB">
     11<!ENTITY aspell-time "0.97 SBU">
     12
     13]>
     14
    115<sect1 id="aspell" xreflabel="aspell-&aspell-version;">
    216<?dbhtml filename="aspell.html"?>
    317<title>aspell-&aspell-version;</title>
    418
    5 &aspell-intro;
    6 &aspell-inst;
    7 &aspell-config;
    8 &aspell-desc;
     19<sect2>
     20<title>Introduction to <application>aspell</application></title>
     21                                                                               
     22<para>The <application>aspell</application> package contains the aspell
     23library, used to interface to spell checking libraries.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&aspell-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&aspell-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &aspell-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&aspell-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&aspell-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38<sect3><title><application>aspell</application> dependencies</title>
     39<sect4><title>Required</title>
     40<para><xref linkend="which"/>
     41</para></sect4>
     42</sect3>
     43                                                                               
     44</sect2>
     45
     46<sect2>
     47<title>Installation of <application>aspell</application></title>
     48                                                                               
     49<para>Install <application>aspell</application> by running the following commands:</para>
     50                                                                               
     51<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     52make &amp;&amp;
     53make install</command></userinput></screen>
     54                                                                               
     55</sect2>
     56
     57<sect2>
     58<title>Configuring <application>aspell</application></title>
     59                                                                               
     60<sect3><title>Configuration Information</title>
     61                                                                               
     62<para>After <application>Aspell</application> is installed, at least one
     63dictionary needs to be set up. You can find them at <ulink url="http://aspell.net/"/>.</para>
     64                                                                               
     65<para>Install your dictionary or dictionaries by running the following commands:</para>
     66<screen><userinput><command>./configure &amp;&amp;
     67make &amp;&amp;
     68make install</command></userinput></screen>
     69                                                                               
     70</sect3>
     71                                                                               
     72</sect2>
     73
     74<sect2>
     75<title>Contents</title>
     76                                                                               
     77<para>The <application>aspell</application> package contains the <filename>libaspell</filename>
     78libraries.</para>
     79                                                                               
     80</sect2>
     81                                                                               
     82<sect2><title>Description</title>
     83                                                                               
     84<sect3><title>aspell library</title>
     85<para>The <filename>libaspell</filename> library is a spell checking library interface.</para></sect3>
     86                                                                               
     87</sect2>
    988
    1089</sect1>
  • general/genlib/expat.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY expat-download-http "http://prdownloads.sourceforge.net/expat/expat-&expat-version;.tar.gz">
     8<!ENTITY expat-download-ftp " ">
     9<!ENTITY expat-size "290 KB">
     10<!ENTITY expat-buildsize "3.2 MB">
     11<!ENTITY expat-time "0.11 SBU">
     12
     13]>
     14
    115<sect1 id="expat" xreflabel="expat-&expat-version;">
    216<?dbhtml filename="expat.html"?>
    317<title>expat-&expat-version;</title>
    418
    5 &expat-intro;
    6 &expat-inst;
    7 &expat-desc;
     19<sect2>
     20<title>Introduction to expat</title>
     21                                                                               
     22<para>The expat package contains a stream oriented C library for
     23parsing XML.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&expat-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&expat-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &expat-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &expat-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &expat-time;</para></listitem></itemizedlist></sect3>
     32                                                                               
     33</sect2>
     34
     35<sect2>
     36<title>Installation of <application>expat</application></title>
     37                                                                               
     38<para>Install <application>expat</application> by running the following commands:</para>
     39                                                                               
     40<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     41make &amp;&amp;
     42make install</command></userinput></screen>
     43                                                                               
     44</sect2>
     45
     46<sect2>
     47<title>Contents</title>
     48                                                                               
     49<para>The <application>expat</application> package contains the <filename>libexpat</filename> libraries and
     50<command>xmlwf</command>.</para>
     51                                                                               
     52</sect2>
     53                                                                               
     54<sect2><title>Description</title>
     55                                                                               
     56<sect3><title>xmlwf</title>
     57<para><command>xmlwf</command> is a non-validating utility to check whether or
     58not XML documents are well formed.</para></sect3>
     59                                                                               
     60</sect2>
    861
    962</sect1>
     63
  • general/genlib/fam.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY fam-download-http " ">
     8<!ENTITY fam-download-ftp "ftp://oss.sgi.com/projects/fam/download/stable/fam-&fam-version;.tar.gz">
     9<!ENTITY fam-size "320 KB">
     10<!ENTITY fam-buildsize "6.9 MB">
     11<!ENTITY fam-time "0.68 SBU">
     12
     13]>
     14
    115<sect1 id="fam" xreflabel="FAM-&fam-version;">
    216<?dbhtml filename="fam.html"?>
    317<title>FAM-&fam-version;</title>
    418
    5 &fam-intro;
    6 &fam-inst;
    7 &fam-exp;
    8 &fam-config;
    9 &fam-desc;
     19<sect2>
     20<title>Introduction to <application><acronym>FAM</acronym></application></title>                                                                               
     21<para>The <application><acronym>FAM</acronym></application> package contains a
     22File Alteration Monitor which is useful for notifying applications of
     23changes to the file system.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&fam-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&fam-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &fam-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&fam-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&fam-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38<sect3><title>Additional downloads</title>
     39<itemizedlist spacing='compact'>
     40<listitem><para>Dnotify patch (Recommended): <ulink
     41url="&patch-root;/fam-&fam-version;-dnotify-1.patch"/></para></listitem></itemizedlist>
     42</sect3>
     43                                                                               
     44                                                                               
     45<sect3><title><application><acronym>FAM</acronym></application> dependencies
     46</title>
     47<sect4><title>Required</title>
     48<para><xref linkend="portmap"/></para></sect4>
     49</sect3>
     50                                                                               
     51</sect2>
     52                                                                               
     53<sect2>
     54<title>Installation of <application><acronym>FAM</acronym></application></title>                                                                               
     55<para>Install <application><acronym>FAM</acronym></application> by running the
     56following commands:</para>
     57                                                                               
     58<screen><userinput><command>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch &amp;&amp;
     59autoreconf -f -i &amp;&amp;
     60./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     61make &amp;&amp;
     62make install</command></userinput></screen>
     63                                                                               
     64</sect2>
     65
     66<sect2>
     67<title>Command explanations</title>
     68                                                                               
     69<para><command>patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch</command>: This patch enables
     70<application><acronym>FAM</acronym></application> to use the Linux kernel
     71dnotify mechanism to inform the calling process of
     72file modifications, rather than polling the file system for
     73modifications.</para>
     74                                                                               
     75<para><command>autoreconf -f -i</command>
     76This command is necessary since the dnotify patch affects the
     77<filename>configure.ac</filename> and <filename>Makefile.am</filename>.</para>
     78                                                                               
     79</sect2>
     80
     81<sect2>
     82<title>Configuring <application><acronym>FAM</acronym></application></title>
     83                                                                               
     84<sect3><title>Config files</title>
     85                                                                               
     86<para><filename>/etc/rpc</filename>,
     87 <filename>/etc/fam.conf</filename>,
     88 <filename>/etc/inetd.conf</filename>,
     89 <filename>/etc/xinetd.d/fam</filename>
     90 or <filename>/etc/xinetd.conf</filename>
     91 </para>
     92</sect3>
     93                                                                               
     94<sect3><title>Configuration Information</title>
     95                                                                               
     96<para>Configuring the file alteration monitor.</para>
     97                                                                               
     98<para>If you use <application>inetd</application>, add the
     99<application><acronym>FAM</acronym></application> entry to
     100<filename>/etc/inetd.conf</filename> with the
     101following command: </para>
     102                                                                               
     103<screen><userinput><command>echo "sgi_fam/1-2 stream  rpc/tcp wait root /usr/sbin/famd fam" &gt;&gt; /etc/inetd.conf</command></userinput></screen>
     104                                                                               
     105<para>If you use <application>xinetd</application>, add an entry to
     106<filename>/etc/xinetd.conf</filename> with the following command (be
     107sure the "nogroup" group exists):</para>
     108                                                                               
     109<screen><userinput><command>cat &gt;&gt; /etc/xinetd.conf &lt;&lt; "EOF"</command>
     110    # description: FAM - file alteration monitor
     111    service sgi_fam
     112    {
     113        type            = RPC UNLISTED
     114        socket_type     = stream
     115        user            = root
     116        group           = nogroup
     117        server          = /usr/sbin/famd
     118        wait            = yes
     119        protocol        = tcp
     120        rpc_version     = 2
     121        rpc_number      = 391002
     122    }
     123<command>EOF</command></userinput></screen>
     124                                                                               
     125<para>If you do not have any inetd daemon installed and have no
     126wish to install one, you can also start fam during system startup
     127by installing <filename>/etc/rc.d/init.d/fam</filename>
     128init script included in the
     129<xref linkend="intro-important-bootscripts"/> package.</para>
     130                                                                               
     131                                                                               
     132<screen><userinput><command>make install-fam</command></userinput></screen>
     133                                                                               
     134</sect3>
     135                                                                               
     136</sect2>
     137
     138<sect2>
     139<title>Contents</title>
     140                                                                               
     141<para>The <application><acronym>FAM</acronym></application> package contains
     142the <command>famd</command> executable and <filename>libfam</filename>
     143libraries.</para>
     144                                                                               
     145</sect2>
     146                                                                               
     147<sect2><title>Description</title>
     148                                                                               
     149<sect3><title>famd</title>
     150                                                                               
     151<para><command>famd</command> is the file alteration monitor.</para>
     152                                                                               
     153</sect3>
     154                                                                               
     155</sect2>
    10156
    11157</sect1>
     158
  • general/genlib/gdbm.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY gdbm-download-http "http://ftp.gnu.org/gnu/gdbm/gdbm-&gdbm-version;.tar.gz">
     8<!ENTITY gdbm-download-ftp "ftp://ftp.gnu.org/gnu/gdbm/gdbm-&gdbm-version;.tar.gz">
     9<!ENTITY gdbm-size "223 KB">
     10<!ENTITY gdbm-buildsize "4.1 MB">
     11<!ENTITY gdbm-time "0.08 SBU">
     12
     13]>
     14
    115<sect1 id="gdbm" xreflabel="GDBM-&gdbm-version;">
    216<?dbhtml filename="gdbm.html"?>
    317<title>GDBM-&gdbm-version;</title>
    418
    5 &gdbm-intro;
    6 &gdbm-inst;
    7 &gdbm-exp;
    8 &gdbm-desc;
     19<sect2>
     20<title>Introduction to <application><acronym>GDBM</acronym></application></title>
     21                                                                             
     22<para>The <application><acronym>GDBM</acronym></application> package
     23contains the <acronym>GNU</acronym> Database Manager. This
     24is a disk file format database which stores key/data-pairs in single
     25files. The actual data of any record being stored is indexed by a unique
     26key, which can be retrieved in less time than if it was stored in a text
     27file.</para>
     28                                                                             
     29<sect3><title>Package information</title>
     30<itemizedlist spacing='compact'>
     31<listitem><para>Download (HTTP): <ulink
     32url="&gdbm-download-http;"/></para></listitem>
     33<listitem><para>Download (FTP): <ulink
     34url="&gdbm-download-ftp;"/></para></listitem>
     35<listitem><para>Download size: &gdbm-size;</para></listitem>
     36<listitem><para>Estimated Disk space required:
     37&gdbm-buildsize;</para></listitem>
     38<listitem><para>Estimated build time:
     39&gdbm-time;</para></listitem></itemizedlist>
     40</sect3>
     41                                                                             
     42                                                                             
     43</sect2>
     44
     45<sect2>
     46<title>Installation of <application><acronym>GDBM</acronym></application></title>
     47                                                                             
     48<para>Install <application><acronym>GDBM</acronym></application> by running the following commands:
     49</para>
     50                                                                             
     51<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     52make &amp;&amp;
     53make BINOWN=root BINGRP=root install</command></userinput></screen>
     54                                                                             
     55<para>In addition, you may need to install the <application>DBM</application>
     56and <application>NDBM</application> compatibility headers since some
     57applications look for these older dbm routines.</para>
     58                                                                             
     59<screen><userinput><command>make BINOWN=root BINGRP=root install-compat</command></userinput></screen>
     60                                                                             
     61</sect2>
     62
     63<sect2>
     64<title>Command explanations</title>
     65                                                                             
     66<para><parameter>BINOWN=root BINGRP=root</parameter>: This command
     67changes the file ownership to root instead of the bin user.</para>
     68                                                                             
     69</sect2>
     70
     71<sect2>
     72<title>Contents</title>
     73                                                                             
     74<para>The <application><acronym>GDBM</acronym></application> package
     75contains <filename class="libraryfile">libgdbm</filename> libraries.</para>
     76                                                                             
     77</sect2>
     78                                                                             
     79<sect2><title>Description</title>
     80                                                                             
     81<sect3><title>gdbm libraries</title>
     82<para><filename class="libraryfile">libgdbm</filename> libraries contain functions that perform
     83database routines using extendible hashing.</para></sect3>
     84                                                                             
     85                                                                             
     86</sect2>
    987
    1088</sect1>
  • general/genlib/genlib.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4 <!ENTITY % general-entities SYSTEM "../../general.ent">
     5 %general-entities;
     6]>
     7
    18<chapter id="general-genlib">
    29<?dbhtml filename="genlib.html"?>
     
    3138explain why you may want to install them.</para>
    3239
    33 &openssl;
    34 &pcre;
    35 &popt;
    36 &slang;
    37 &fam;
    38 &libxml;
    39 &libxml2;
    40 &libxslt;
    41 &readline;
    42 &gmp;
    43 &gdbm;
    44 &GLib;
    45 &GLib2;
    46 &expat;
    47 &libesmtp;
    48 &aspell;
    49 &ispell;
    50 &guile;
    51 &slib;
    52 &gwrap;
    53 &LZO;
    54 &libpcap;
    55 &libusb;
     40<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="openssl.xml"/>
     41<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="pcre.xml"/>
     42<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="popt.xml"/>
     43<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="slang.xml"/>
     44<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fam.xml"/>
     45<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxml.xml"/>
     46<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxml2.xml"/>
     47<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libxslt.xml"/>
     48<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="readline.xml"/>
     49<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gmp.xml"/>
     50<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gdbm.xml"/>
     51<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="glib.xml"/>
     52<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="glib2.xml"/>
     53<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="expat.xml"/>
     54<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libesmtp.xml"/>
     55<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="aspell.xml"/>
     56<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="ispell.xml"/>
     57<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="guile.xml"/>
     58<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="slib.xml"/>
     59<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="gwrap.xml"/>
     60<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lzo.xml"/>
     61<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libpcap.xml"/>
     62<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libusb.xml"/>
     63
    5664</chapter>
  • general/genlib/glib.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY GLib-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v1.2/glib-&GLib-version;.tar.gz">
     8<!ENTITY GLib-download-ftp "ftp://ftp.gtk.org/pub/gtk/v1.2/glib-&GLib-version;.tar.gz">
     9<!ENTITY GLib-size "412 KB">
     10<!ENTITY GLib-buildsize "7 MB">
     11<!ENTITY GLib-time "0.26 SBU">
     12
     13]>
     14
    115<sect1 id="GLib" xreflabel="GLib-&GLib-version;">
    216<?dbhtml filename="glib.html"?>
    317<title>GLib-&GLib-version;</title>
    418
    5 &GLib-intro;
    6 &GLib-inst;
    7 &GLib-desc;
     19<sect2>
     20<title>Introduction to <application>GLib</application></title>
     21                                                                               
     22<para>The <application>glib</application> package contains a low-level core
     23library. This is useful for providing data structure handling for C,
     24portability wrappers and interfaces for such runtime functionality as an event
     25loop, threads, dynamic loading, and an object system.</para>
     26                                                                               
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink url="&GLib-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink url="&GLib-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &GLib-size;</para></listitem>
     32<listitem><para>Estimated Disk space required: &GLib-buildsize;</para></listitem>
     33<listitem><para>Estimated build time: &GLib-time;</para></listitem></itemizedlist>
     34</sect3>
     35                                                                               
     36</sect2>
     37
     38<sect2>
     39<title>Installation of <application>GLib</application></title>
     40                                                                               
     41<para>Install <application>glib</application> by running the following commands:</para>
     42                                                                               
     43<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     44make &amp;&amp;
     45make install</command></userinput></screen>
     46                                                                               
     47</sect2>
     48
     49<sect2>
     50<title>Contents</title>
     51                                                                               
     52<para>The <application>glib</application> package contains <filename>libglib-1.2</filename> libraries.</para>
     53                                                                               
     54</sect2>
     55                                                                               
     56<sect2><title>Description</title>
     57                                                                               
     58<sect3><title>GLib libraries</title>
     59<para><application>GLib</application> libraries contain a low-level core
     60library for the <application><acronym>GIMP</acronym></application> Toolkit.</para></sect3>
     61                                                                               
     62                                                                               
     63</sect2>
    864
    965</sect1>
  • general/genlib/glib2.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY GLib2-download-http "http://gd.tuwien.ac.at/graphics/gimp/gtk/v2.4/glib-&GLib2-version;.tar.bz2">
     8<!ENTITY GLib2-download-ftp "ftp://ftp.gtk.org/pub/gtk/v2.4/glib-&GLib2-version;.tar.bz2">
     9<!ENTITY GLib2-size "2.0 MB">
     10<!ENTITY GLib2-buildsize "30 MB">
     11<!ENTITY GLib2-time "0.49 SBU">
     12
     13]>
     14
    115<sect1 id="GLib2" xreflabel="GLib-&GLib2-version;">
    216<?dbhtml filename="glib2.html"?>
    317<title>GLib-&GLib2-version;</title>
    418
    5 &GLib2-intro;
    6 &GLib2-inst;
    7 <!-- &GLib2-exp; -->
    8 &GLib2-desc;
     19<sect2>
     20<title>Introduction to <application>GLib</application></title>
     21                                                                               
     22<para>The <application>glib</application> package contains a low-level core
     23library. This is useful for providing data structure handling for C,
     24portability wrappers and interfaces for such runtime functionality as an
     25event loop, threads, dynamic loading, and an object system.</para>
     26                                                                               
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink
     30url="&GLib2-download-http;"/></para></listitem>
     31<listitem><para>Download (FTP): <ulink
     32url="&GLib2-download-ftp;"/></para></listitem>
     33<listitem><para>Download size: &GLib2-size;</para></listitem>
     34<listitem><para>Estimated Disk space required:
     35&GLib2-buildsize;</para></listitem>
     36<listitem><para>Estimated build time:
     37&GLib2-time;</para></listitem></itemizedlist>
     38</sect3>
     39                                                                               
     40<sect3><title><application>GLib</application> dependencies</title>
     41<sect4><title>Required</title>
     42<para><xref linkend="pkgconfig"/></para></sect4>
     43<sect4><title>Optional</title>
     44<para><xref linkend="gtk-doc"/></para></sect4>
     45</sect3>
     46                                                                               
     47</sect2>
     48
     49<sect2>
     50<title>Installation of <application>GLib</application></title>
     51                                                                               
     52<para>Install <application>glib</application> by running the following commands:</para>
     53                                                                               
     54<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     55make &amp;&amp;
     56make install</command></userinput></screen>
     57                                                                               
     58</sect2>
     59
     60<sect2>
     61<title>Command explanations</title>
     62                                                                               
     63<para><option>--enable-gtk-doc</option>: This switch will rebuild
     64the <acronym>API</acronym> documentation during the
     65<command>make</command> command.</para>
     66                                                                               
     67</sect2>
     68
     69<sect2>
     70<title>Contents</title>
     71                                                                               
     72<para>The <application>glib</application> package contains
     73<filename class="libraryfile">libglib-2.0</filename>,
     74<filename class="libraryfile">libgobject-2.0</filename>,
     75<filename class="libraryfile">libgmodule-2.0</filename> and
     76<filename class="libraryfile">libgthread-2.0</filename>
     77libraries.</para>
     78                                                                               
     79</sect2>
     80                                                                               
     81<sect2><title>Description</title>
     82                                                                               
     83<sect3><title>GLib libraries</title>
     84<para>GLib libraries contain a low-level core library for the
     85<application><acronym>GIMP</acronym></application> Toolkit.</para></sect3>
     86                                                                               
     87</sect2>
    988
    1089</sect1>
  • general/genlib/gmp.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY gmp-download-http " ">
     8<!ENTITY gmp-download-ftp "ftp://ftp.gnu.org/gnu/gmp/gmp-&gmp-version;.tar.gz">
     9<!ENTITY gmp-size "1.7 MB">
     10<!ENTITY gmp-buildsize "29 MB">
     11<!ENTITY gmp-time "0.74 SBU">
     12
     13]>
     14
    115<sect1 id="gmp" xreflabel="GMP-&gmp-version;">
    216<?dbhtml filename="gmp.html"?>
    317<title>GMP-&gmp-version;</title>
    418
    5 &gmp-intro;
    6 &gmp-inst;
    7 &gmp-desc;
     19<sect2>
     20<title>Introduction to <application><acronym>GMP</acronym></application></title>
     21                                                                             
     22<para>The <application><acronym>GMP</acronym></application> package
     23contains a math library. This has useful functions for arbitrary precision
     24arithmetic.</para>
     25                                                                             
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&gmp-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&gmp-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &gmp-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&gmp-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&gmp-time;</para></listitem></itemizedlist>
     37</sect3>
     38                                                                             
     39                                                                             
     40<sect3><title><application><acronym>GMP</acronym></application> dependencies</title>
     41<sect4><title>Optional</title>
     42<para><xref linkend="readline"/></para></sect4>
     43</sect3>
     44                                                                             
     45</sect2>
     46
     47<sect2>
     48<title>Installation of <application><acronym>GMP</acronym></application></title>
     49                                                                             
     50<para>Install <application><acronym>GMP</acronym></application> by running the following commands:
     51</para>
     52                                                                             
     53<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     54make &amp;&amp;
     55make install</command></userinput></screen>
     56                                                                             
     57</sect2>
     58
     59<sect2>
     60<title>Contents</title>
     61                                                                             
     62<para>The <application><acronym>GMP</acronym></application> package contains <filename>libgmp
     63</filename> libraries.</para>
     64                                                                             
     65</sect2>
     66                                                                             
     67<sect2><title>Description</title>
     68                                                                             
     69<sect3><title>gmp libraries</title>
     70<para><filename>libgmp</filename> libraries contain the functions to operate
     71on signed integers, rational numbers, and floating point numbers.</para></sect3>
     72                                                                             
     73                                                                             
     74</sect2>
    875
    976</sect1>
     77
  • general/genlib/guile.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY guile-download-http "http://ftp.gnu.org/pub/gnu/guile/guile-&guile-version;.tar.gz">
     8<!ENTITY guile-download-ftp "ftp://ftp.gnu.org/pub/gnu/guile/guile-&guile-version;.tar.gz">
     9<!ENTITY guile-size "2.7 MB">
     10<!ENTITY guile-buildsize "30 MB">
     11<!ENTITY guile-time "0.79 SBU">
     12
     13]>
     14
    115<sect1 id="guile" xreflabel="Guile-&guile-version;">
    216<?dbhtml filename="guile.html"?>
    317<title>Guile-&guile-version;</title>
    418
    5 &guile-intro;
    6 &guile-inst;
    7 &guile-desc;
     19<sect2>
     20<title>Introduction to <application>Guile</application></title>
     21                                                                               
     22<para>The <application>Guile</application> package contains the Project
     23<acronym>GNU</acronym>'s extension language library.  <application>Guile
     24</application> also contains a stand alone <application>Scheme</application>
     25interpreter.</para>
     26                                                                               
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink
     30url="&guile-download-http;"/></para></listitem>
     31<listitem><para>Download (FTP): <ulink
     32url="&guile-download-ftp;"/></para></listitem>
     33<listitem><para>Download size: &guile-size;</para></listitem>
     34<listitem><para>Estimated Disk space required:
     35&guile-buildsize;</para></listitem>
     36<listitem><para>Estimated build time:
     37&guile-time;</para></listitem></itemizedlist>
     38</sect3>
     39                                                                               
     40                                                                               
     41<sect3><title><application>Guile</application> dependencies</title>
     42<sect4><title>Optional</title>
     43<para><xref linkend="readline"/></para></sect4>
     44</sect3>
     45                                                                               
     46</sect2>
     47
     48<sect2>
     49<title>Installation of <application>Guile</application></title>
     50                                                                               
     51<para>Install <application>Guile</application> by running the following
     52commands:</para>
     53                                                                               
     54<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     55make &amp;&amp;
     56make install</command></userinput></screen>
     57                                                                               
     58</sect2>
     59
     60<sect2>
     61<title>Contents</title>
     62                                                                               
     63<para>In addition to the <filename>libguile</filename> libraries, the
     64<application>Guile</application> package contains
     65<command>guile</command>,
     66<command>guile-config</command> and
     67<command>guile-snarf</command>.
     68</para>
     69                                                                               
     70</sect2>
     71                                                                               
     72<sect2><title>Description</title>
     73                                                                               
     74<sect3><title>guile</title>
     75<para><command>guile</command> is a stand-alone Scheme interpreter for
     76<application>Guile</application>.</para></sect3>
     77                                                                               
     78<sect3><title>guile-config</title>
     79<para><command>guile-config</command> is a <application>Guile</application>
     80script which provides the information necessary to link your programs against
     81the <application>Guile</application> library, in much the same way <xref
     82linkend="pkgconfig"></xref> does.</para></sect3>
     83                                                                               
     84<sect3><title>guile-snarf</title>
     85<para><command>guile-snarf</command> is a script to parse declarations in
     86your <application>C</application> code for <application>Scheme</application>
     87visible <application>C</application> functions, <application>Scheme
     88</application> objects to be used by <application>C</application> code,
     89etc.</para></sect3>
     90                                                                               
     91</sect2>
    892
    993</sect1>
  • general/genlib/gwrap.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY gwrap-download-http "http://www.gnucash.org/pub/g-wrap/source/g-wrap-&gwrap-version;.tar.gz">
     8<!ENTITY gwrap-download-ftp " ">
     9<!ENTITY gwrap-size "400 KB">
     10<!ENTITY gwrap-buildsize "4.6 MB">
     11<!ENTITY gwrap-time "0.09 SBU">
     12
     13]>
     14
    115<sect1 id="gwrap" xreflabel="gwrap-&gwrap-version;">
    216<?dbhtml filename="gwrap.html"?>
    317<title>G-Wrap-&gwrap-version;</title>
    418
    5 &gwrap-intro;
    6 &gwrap-inst;
    7 &gwrap-desc;
     19<sect2>
     20<title>Introduction to <application>G-Wrap</application></title>
     21                                                                               
     22<para>The <application>G-Wrap</application> package contains tools for
     23exporting <application>C</application> libraries into <application>Scheme
     24</application> interpreters.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&gwrap-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&gwrap-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &gwrap-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&gwrap-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&gwrap-time;</para></listitem></itemizedlist>
     37</sect3>
     38                                                                               
     39                                                                               
     40<sect3><title><application>G-wrap</application> dependencies</title>
     41<sect4><title>Required</title>
     42<para><xref linkend="guile"/> and <xref linkend="slib"/></para></sect4>
     43</sect3>
     44                                                                               
     45                                                                               
     46</sect2>
     47
     48<sect2>
     49<title>Installation of <application>G-Wrap</application></title>
     50                                                                               
     51<para>Install <application>G-Wrap</application> by running the following
     52commands:</para>
     53                                                                               
     54<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     55make &amp;&amp;
     56make install</command></userinput></screen>
     57                                                                               
     58</sect2>
     59
     60<sect2>
     61<title>Contents</title>
     62                                                                               
     63<para>In addition to the <application>Scheme</application> libraries, the
     64<application>G-Wrap</application> package contains
     65<command>g-wrap-config</command>.</para>
     66                                                                               
     67</sect2>
     68                                                                               
     69<sect2><title>Description</title>
     70                                                                               
     71<sect3><title>g-wrap-config</title>
     72<para><command>g-wrap-config</command> is a tool to generate <envar>CFLAGS
     73</envar> for linking <application>C</application> code to the
     74<application>Scheme</application> runtime libraries.</para></sect3>
     75                                                                               
     76</sect2>
    877
    978</sect1>
  • general/genlib/ispell.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY ispell-download-http "http://membled.com/work/patches/ispell/ispell-&ispell-version;.tar.bz2">
     8<!ENTITY ispell-download-ftp " ">
     9<!ENTITY ispell-size "1.2 MB">
     10<!ENTITY ispell-buildsize "11 MB">
     11<!ENTITY ispell-time "0.03 SBU">
     12
     13]>
     14
    115<sect1 id="ispell" xreflabel="ispell-&ispell-version;">
    216<?dbhtml filename="ispell.html"?>
    317<title>ispell-&ispell-version;</title>
    418
    5 &ispell-intro;
    6 &ispell-inst;
    7 &ispell-desc;
     19<sect2>
     20<title>Introduction to <application>ispell</application></title>
     21                                                                               
     22<para>The <application>ispell</application> package contains a spell
     23checker that can handle international languages.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&ispell-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&ispell-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &ispell-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&ispell-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&ispell-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38</sect2>
     39
     40<sect2>
     41<title>Installation of <application>ispell</application></title>
     42                                                                               
     43<para>The first step is to create <filename>local.h</filename>.</para>
     44                                                                               
     45<screen><userinput><command>sed -e "s:/usr/local:/usr:g" local.h.linux > local.h</command></userinput></screen>
     46                                                                               
     47<para>By default, <application>ispell</application> only installs an American
     48English dictionary. To set up other languages, check out the <filename>config.X</filename> file
     49for the #define entry to append to <filename>local.h</filename>.</para>
     50                                                                               
     51<para>Compile and install <application>ispell</application> using the
     52following commands:</para>
     53<screen><userinput><command>make &amp;&amp;
     54make install</command></userinput></screen>
     55                                                                               
     56</sect2>
     57
     58<sect2>
     59<title>Contents</title>
     60                                                                               
     61<para>The <application>ispell</application> package contains the
     62<command>ispell</command> program used for spell checking.</para>
     63                                                                               
     64</sect2>
    865
    966</sect1>
  • general/genlib/libesmtp.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY libesmtp-download-http "http://www.stafford.uklinux.net/libesmtp/libesmtp-&libesmtp-version;.tar.bz2">
     8  <!ENTITY libesmtp-download-ftp  " ">
     9  <!ENTITY libesmtp-size          "263 KB">
     10  <!ENTITY libesmtp-buildsize     "5.4 MB">
     11  <!ENTITY libesmtp-time          "0.16 SBU">
     12]>
     13
    114<sect1 id="libesmtp" xreflabel="libesmtp-&libesmtp-version;">
    215<?dbhtml filename="libesmtp.html"?>
    316<title>libesmtp-&libesmtp-version;</title>
    417
    5 &libesmtp-intro;
    6 &libesmtp-inst;
    7 &libesmtp-desc;
     18<sect2>
     19<title>Introduction to <application>libesmtp</application></title>
     20                                                                               
     21<para>The <application>libesmtp</application> package contains the libesmtp
     22libraries which are used by some programs to manage email submission to a
     23mail transport layer.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&libesmtp-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&libesmtp-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &libesmtp-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&libesmtp-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&libesmtp-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38<sect3>
     39<title><application>libesmtp</application> dependencies</title>
     40
     41<sect4><title>Optional</title>
     42<para><xref linkend="openssl"/></para>
     43</sect4>
     44
     45</sect3>
     46                                                                               
     47</sect2>
     48
     49<sect2>
     50<title>Installation of <application>libesmtp</application></title>
     51                                                                               
     52<para>Install <application>libesmtp</application> by running the following commands:</para>
     53                                                                               
     54<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     55make &amp;&amp;
     56make install</command></userinput></screen>
     57                                                                               
     58</sect2>
     59
     60<sect2>
     61<title>Contents</title>
     62                                                                               
     63<para>The <application>libesmtp</application> package contains the <filename>libesmtp</filename>
     64library.</para>
     65                                                                               
     66</sect2>
     67                                                                               
     68<sect2>
     69<title>Description</title>
     70                                                                               
     71<sect3>
     72<title>libesmtp library</title>
     73
     74<para>The <filename>libesmtp</filename> library is used to manage submission of
     75electronic mail to a Mail Transport Agent.</para>
     76</sect3>
     77                                                                               
     78</sect2>
    879
    980</sect1>
  • general/genlib/libpcap.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libpcap-download-http "http://www.tcpdump.org/release/libpcap-&libpcap-version;.tar.gz">
     8<!ENTITY libpcap-download-ftp " ">
     9<!ENTITY libpcap-size "299 KB">
     10<!ENTITY libpcap-buildsize "1.9 MB">
     11<!ENTITY libpcap-time "0.05 SBU">
     12
     13]>
     14
    115<sect1 id="libpcap" xreflabel="libpcap-&libpcap-version;">
    216<?dbhtml filename="libpcap.html"?>
    317<title><acronym>libpcap</acronym>-&libpcap-version;</title>
    418
    5 &libpcap-intro;
    6 &libpcap-inst;
    7 &libpcap-desc;
     19<sect2>
     20<title>Introduction to <application><acronym>libpcap</acronym></application></title>
     21                                                                               
     22<para><application><acronym>libpcap</acronym></application> provides
     23functions for user-level packet capture, used in low-level network
     24monitoring.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&libpcap-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&libpcap-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &libpcap-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &libpcap-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &libpcap-time;</para></listitem></itemizedlist>
     33</sect3>
     34                                                                               
     35</sect2>
     36
     37<sect2>
     38<title>Installation of <application><acronym>libpcap</acronym></application></title>
     39                                                                               
     40<para>Install <application><acronym>libpcap</acronym></application> by running the
     41following commands:</para>
     42                                                                               
     43<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     44make &amp;&amp;
     45make install</command></userinput></screen>
     46                                                                               
     47</sect2>
     48
     49<sect2>
     50<title>Contents</title>
     51                                                                               
     52<para><application><acronym>libpcap</acronym></application> package provides
     53the <filename class="libraryfile">libpcap</filename> library.</para>
     54                                                                               
     55</sect2>
     56                                                                               
     57<sect2><title>Description</title>
     58                                                                               
     59<sect3><title>libpcap</title>
     60<para><filename class="libraryfile">libpcap</filename>
     61is a library for user-level packet capture.</para></sect3>
     62                                                                               
     63</sect2>
    864
    965</sect1>
     66
  • general/genlib/libusb.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libusb-download-http "http://prdownloads.sourceforge.net/libusb/libusb-&libusb-version;.tar.gz">
     8<!ENTITY libusb-download-ftp " ">
     9<!ENTITY libusb-size "314 KB">
     10<!ENTITY libusb-buildsize "2.1 MB">
     11<!ENTITY libusb-time "0.03 SBU">
     12
     13]>
     14
    115<sect1 id="libusb" xreflabel="libusb-&libusb-version;">
    216<?dbhtml filename="libusb.html"?>
    317<title>libusb-&libusb-version;</title>
    418
    5 &libusb-intro;
    6 &libusb-inst;
    7 &libusb-exp;
    8 &libusb-config;
    9 &libusb-desc;
     19<sect2>
     20<title>Introduction to <application>libusb</application></title>
     21                                                                               
     22<para>The <application>libusb</application> package contains a library
     23used by some applications for <acronym>USB</acronym> device access.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&libusb-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&libusb-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &libusb-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &libusb-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &libusb-time;</para></listitem></itemizedlist>
     32</sect3>
     33                                                                               
     34<sect3><title><application>libusb</application> dependencies</title>
     35<sect4><title>Optional</title>
     36<para><xref linkend="openjade"/> and <xref linkend="sgml-dtd-3"/></para></sect4>
     37</sect3>
     38                                                                               
     39</sect2>
     40
     41<sect2>
     42<title>Installation of <application>libusb</application></title>
     43                                                                               
     44<para>Install <application>libusb</application> by running the following commands:</para>
     45                                                                               
     46<screen><userinput><command>./configure --prefix=/usr --disable-build-docs &amp;&amp;
     47make &amp;&amp;
     48make install</command></userinput></screen>
     49                                                                               
     50</sect2>
     51
     52<sect2>
     53<title>Command explanations</title>
     54                                                                               
     55<para><parameter>--disable-build-docs</parameter>: This switch turns off
     56the default enabled building of documentation since it requires
     57<application>OpenJade</application>.</para>
     58</sect2>
     59
     60<sect2>
     61<title>Configuring <application>libusb</application></title>
     62                                                                               
     63<!-- To be reviewed when hotplug enters the LFS book -->
     64                                                                               
     65<para>libusb requires the usbfs kernel filesystem to be mounted on
     66<filename class="directory">/proc/bus/usb</filename>. Applications
     67require the files in this directory to be accessible to the user,
     68sometimes for both reading and writing.</para>
     69                                                                               
     70<para>To restrict access to <acronym>USB</acronym> devices, create the
     71usb group:</para>
     72                                                                               
     73<screen><userinput><command>groupadd -g 15 usb</command></userinput></screen>
     74                                                                               
     75<para>To get usbfs mounted on boot, we will create a special init script,
     76because just putting an extra line into
     77<filename>/etc/fstab</filename> does not work for those who compiled
     78"USB device filesystem" as a kernel module.
     79Install <filename>/etc/rc.d/init.d/usb</filename>
     80init script included in the
     81<xref linkend="intro-important-bootscripts"/> package.</para>
     82                                                                               
     83                                                                               
     84<screen><userinput><command>make install-usb</command></userinput></screen>
     85                                                                               
     86</sect2>
     87
     88<sect2>
     89<title>Contents</title>
     90                                                                               
     91<para>The <application>libusb</application> package contains
     92<filename class="libraryfile">libusb</filename> libraries,
     93the <filename>/usr/include/usb.h</filename> header,
     94and a <command>usb-config</command> script.</para>
     95                                                                               
     96</sect2>
     97                                                                               
     98<sect2><title>Description</title>
     99                                                                               
     100<sect3><title>libusb libraries</title>
     101<para><filename class="libraryfile">libusb</filename> libraries contain C functions for
     102accessing <acronym>USB</acronym> hardware.</para></sect3>
     103                                                                               
     104<sect3><title>usb-config</title>
     105<para>The <command>usb-config</command> script provides the right
     106compiler and linker flags for programs using
     107this library.</para></sect3>
     108                                                                               
     109</sect2>
    10110
    11111</sect1>
     112
  • general/genlib/libxml.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libxml-download-http "http://ftp.gnome.org/pub/GNOME/sources/libxml/1.8/libxml-&libxml-version;.tar.bz2">
     8<!ENTITY libxml-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/libxml/1.8/libxml-&libxml-version;.tar.bz2">
     9<!ENTITY libxml-size "973 KB">
     10<!ENTITY libxml-buildsize "11 MB">
     11<!ENTITY libxml-time "0.41 SBU">
     12
     13]>
     14
    115<sect1 id="libxml" xreflabel="libxml-&libxml-version;">
    216<?dbhtml filename="libxml.html"?>
    317<title>libxml-&libxml-version;</title>
    418
    5 &libxml-intro;
    6 &libxml-inst;
    7 &libxml-desc;
     19<sect2>
     20<title>Introduction to <application>libxml</application></title>
     21                                                                               
     22<para>The <application>libxml</application> package contains the libxml
     23libraries. These are useful for parsing <acronym>XML</acronym> files.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&libxml-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&libxml-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &libxml-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&libxml-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&libxml-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38</sect2>
     39
     40<sect2>
     41<title>Installation of <application>libxml</application></title>
     42                                                                               
     43<para>Install <application>libxml</application> by running the following
     44commands:</para>
     45                                                                               
     46<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     47make &amp;&amp;
     48make install</command></userinput></screen>
     49                                                                               
     50</sect2>
     51
     52<sect2>
     53<title>Contents</title>
     54                                                                               
     55<para>The <application>libxml</application> package contains
     56<filename>libxml</filename> libraries, <command>xmllint</command> and
     57<command>xmlcatalog</command>.</para>
     58                                                                               
     59</sect2>
     60                                                                               
     61<sect2><title>Description</title>
     62                                                                               
     63<sect3><title>libxml libraries</title>
     64<para><filename>libxml</filename> libraries provide the functions for programs
     65to parse files that use the <acronym>XML</acronym> format.</para></sect3>
     66                                                                               
     67</sect2>
    868
    969</sect1>
     70
  • general/genlib/libxml2.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libxml2-download-http "http://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/libxml2-&libxml2-version;.tar.bz2">
     8<!ENTITY libxml2-download-ftp "ftp://xmlsoft.org/libxml2-&libxml2-version;.tar.gz">
     9<!ENTITY libxml2-size "2.6 MB">
     10<!ENTITY libxml2-buildsize "56 MB">
     11<!ENTITY libxml2-time "1.10 SBU">
     12
     13]>
     14
    115<sect1 id="libxml2" xreflabel="libxml2-&libxml2-version;">
    216<?dbhtml filename="libxml2.html"?>
    317<title>libxml2-&libxml2-version;</title>
    418
    5 &libxml2-intro;
    6 &libxml2-inst;
    7 &libxml2-exp;
    8 &libxml2-desc;
     19<sect2>
     20<title>Introduction to <application>libxml2</application></title>
     21                                                                               
     22<para>The <application>libxml2</application> package contains
     23<acronym>XML</acronym> libraries. These are useful for parsing
     24<acronym>XML</acronym> files.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&libxml2-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&libxml2-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &libxml2-size;</para></listitem>
     33<listitem><para>Estimated Disk space
     34required: &libxml2-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&libxml2-time;</para></listitem></itemizedlist>
     37</sect3>
     38                                                                               
     39<sect3><title><application>libxml2</application> dependencies</title>
     40<sect4><title>Optional</title>
     41<para><xref linkend="Python"/> and <xref linkend="readline"/></para></sect4>
     42</sect3>
     43                                                                               
     44</sect2>
     45
     46<sect2>
     47<title>Installation of <application>libxml2</application></title>
     48                                                                               
     49<para>Install <application>libxml2</application> by running the following commands:</para>
     50                                                                               
     51<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     52make &amp;&amp;
     53make install</command></userinput></screen>
     54                                                                               
     55</sect2>
     56
     57<sect2>
     58<title>Command explanations</title>
     59                                                                               
     60<para><option>--with-history</option>: Enables readline support.</para>
     61                                                                               
     62</sect2>
     63
     64<sect2>
     65<title>Contents</title>
     66                                                                             
     67<para>The <application>libxml2</application> package contains <filename
     68class='libraryfile'>libxml2</filename> libraries, <command>xmllint</command>,
     69<command>xmlcatalog</command> and <command>xml2-config</command>.</para>
     70                                                                             
     71</sect2>
     72                                                                             
     73<sect2><title>Description</title>
     74                                                                             
     75<sect3><title>libxml2 libraries</title>
     76<para><filename class='libraryfile'>libxml2</filename> libraries provide
     77the functions for programs to parse files that use the <acronym>XML</acronym>
     78format.</para></sect3>
     79                                                                             
     80<sect3><title>xmllint</title>
     81<para><command>xmllint</command> parses XML files and outputs reports (based
     82upon options) to detect errors in <acronym>XML</acronym> coding.</para></sect3>
     83                                                                             
     84<sect3><title>xmlcatalog</title>
     85<para><command>xmlcatalog</command> allows users to monitor and manipulate
     86<acronym>XML</acronym> and <acronym>SGML</acronym> catalogs.</para></sect3>
     87                                                                             
     88</sect2>
    989
    1090</sect1>
  • general/genlib/libxslt.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libxslt-download-http "http://ftp.gnome.org/pub/GNOME/sources/libxslt/1.1/libxslt-&libxslt-version;.tar.bz2">
     8<!ENTITY libxslt-download-ftp "ftp://xmlsoft.org/libxslt-&libxslt-version;.tar.gz">
     9<!ENTITY libxslt-size "1.7 MB">
     10<!ENTITY libxslt-buildsize "34 MB">
     11<!ENTITY libxslt-time "0.40 SBU">
     12
     13]>
     14
    115<sect1 id="libxslt" xreflabel="libxslt-&libxslt-version;">
    216<?dbhtml filename="libxslt.html"?>
    317<title>libxslt-&libxslt-version;</title>
    418
    5 &libxslt-intro;
    6 &libxslt-inst;
    7 &libxslt-desc;
     19<sect2>
     20<title>Introduction to <application>libxslt</application></title>
     21                                                                             
     22<para>The <application>libxslt</application> package contains
     23<acronym>XSLT</acronym> libraries. These are useful
     24for extending <filename>libxml2</filename> libraries to support
     25<acronym>XSLT</acronym> files.</para>
     26                                                                             
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink
     30url="&libxslt-download-http;"/></para></listitem>
     31<listitem><para>Download (FTP): <ulink
     32url="&libxslt-download-ftp;"/></para></listitem>
     33<listitem><para>Download size: &libxslt-size;</para></listitem>
     34<listitem><para>Estimated Disk space required:
     35&libxslt-buildsize;</para></listitem>
     36<listitem><para>Estimated build time:
     37&libxslt-time;</para></listitem></itemizedlist>
     38</sect3>
     39                                                                             
     40<sect3><title><application>libxslt</application> dependencies</title>
     41<sect4><title>Required</title>
     42<para><xref linkend="libxml2"/></para></sect4>
     43<sect4><title>Optional</title>
     44<para><xref linkend="Python"/></para></sect4>
     45</sect3>
     46                                                                             
     47</sect2>
     48
     49<sect2>
     50<title>Installation of <application>libxslt</application></title>
     51                                                                             
     52<para>Install <application>libxslt</application> by running the following commands:</para>
     53                                                                             
     54<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     55make &amp;&amp;
     56make install</command></userinput></screen>
     57                                                                             
     58</sect2>
     59
     60<sect2>
     61<title>Contents</title>
     62                                                                             
     63<para>The <application>libxslt</application> package contains <filename>
     64libxslt</filename> libraries, <filename>libexslt</filename> libraries,
     65<command>xsltproc</command> and <command>xslt-config</command>.</para>
     66                                                                             
     67</sect2>
     68                                                                             
     69<sect2><title>Description</title>
     70                                                                             
     71<sect3><title>libxslt libraries</title>
     72<para><filename>libxslt</filename> libraries provide extensions to the
     73<filename>libxml2</filename> libraries to parse files that use the
     74<acronym>XSLT</acronym> format.</para></sect3>
     75                                                                             
     76<sect3><title>xsltproc</title>
     77<para><command>xsltproc</command> is used to apply
     78<acronym>XSLT</acronym> stylesheets to <acronym>XML</acronym>
     79documents.</para></sect3>
     80                                                                             
     81                                                                             
     82</sect2>
    883
    984</sect1>
  • general/genlib/lzo.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY LZO-download-http "http://www.oberhumer.com/opensource/lzo/download/lzo-&LZO-version;.tar.gz">
     8<!ENTITY LZO-download-ftp "http://ftp.uni-koeln.de/util/arc/lzo-&LZO-version;.tar.gz">
     9<!ENTITY LZO-size "421 KB">
     10<!ENTITY LZO-buildsize "5.4 MB">
     11<!ENTITY LZO-time "0.22 SBU">
     12
     13]>
     14
    115<sect1 id="LZO" xreflabel="LZO-&LZO-version;">
    216<?dbhtml filename="LZO.html"?>
    317<title><acronym>LZO</acronym>-&LZO-version;</title>
    418
    5 &LZO-intro;
    6 &LZO-inst;
    7 &LZO-desc;
     19<sect2>
     20<title>Introduction to <application><acronym>LZO</acronym></application></title>
     21                                                                               
     22<para><application><acronym>LZO</acronym></application> is a data compression
     23library which is suitable for data decompression and compression in real-time.
     24This means it favors speed over compression ratio.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&LZO-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&LZO-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &LZO-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &LZO-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &LZO-time;</para></listitem></itemizedlist>
     33</sect3>
     34                                                                               
     35</sect2>
     36
     37<sect2>
     38<title>Installation of <application><acronym>LZO</acronym></application></title>
     39                                                                               
     40<para>Install <application><acronym>LZO</acronym></application> by running the
     41following commands:</para>
     42                                                                               
     43<screen><userinput><command>./configure --prefix=/usr --enable-shared &amp;&amp;
     44make &amp;&amp;
     45make install</command></userinput></screen>
     46                                                                               
     47</sect2>
     48
     49<sect2>
     50<title>Contents</title>
     51                                                                               
     52<para><application><acronym>LZO</acronym></application> package provides
     53<filename class="libraryfile">liblzo</filename> library.</para>
     54                                                                               
     55</sect2>
     56                                                                               
     57<sect2><title>Description</title>
     58                                                                               
     59<sect3><title>liblzo</title>
     60<para><filename class="libraryfile">liblzo</filename>
     61is a data compression and decompression library.</para></sect3>
     62                                                                               
     63</sect2>
    864
    965</sect1>
     66
  • general/genlib/openssl.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7
     8<!ENTITY openssl-download-http "http://www.openssl.org/source/openssl-&openssl-version;.tar.gz">
     9<!ENTITY openssl-download-ftp "ftp://ftp.openssl.org/source/openssl-&openssl-version;.tar.gz">
     10<!ENTITY openssl-size "2.7 MB">
     11<!ENTITY openssl-buildsize "25 MB">
     12<!ENTITY openssl-time "1.16 SBU">
     13
     14]>
     15
     16
    117<sect1 id="openssl" xreflabel="OpenSSL-&openssl-version;">
    218<?dbhtml filename="openssl.html"?>
    319<title>OpenSSL-&openssl-version;</title>
    420
    5 &openssl-intro;
    6 &openssl-inst;
    7 &openssl-exp;
    8 &openssl-config;
    9 &openssl-desc;
     21
     22<sect2>
     23<title>Introduction to <application>OpenSSL</application></title>
     24                                                                               
     25<para>The <application>OpenSSL</application> package contains management tools
     26and libraries relating to cryptography.  These are useful for providing
     27cryptography functions to other packages, notably <application>OpenSSH
     28</application> and web browsers (for accessing secure https sites).</para>
     29                                                                               
     30<sect3><title>Package information</title>
     31<itemizedlist spacing='compact'>
     32<listitem><para>Download (HTTP): <ulink url="&openssl-download-http;"/></para></listitem>
     33<listitem><para>Download (FTP): <ulink url="&openssl-download-ftp;"/></para></listitem>
     34<listitem><para>Download size: &openssl-size;</para></listitem>
     35<listitem><para>Estimated Disk space required: &openssl-buildsize;</para></listitem>
     36<listitem><para>Estimated build time: &openssl-time;</para></listitem></itemizedlist>
     37</sect3>
     38</sect2>
     39
     40<sect2>
     41<title>Installation of <application>OpenSSL</application></title>
     42                                                                               
     43<para>Install <application>OpenSSL</application> by running the following commands:</para>
     44
     45<screen><userinput><command>sed 's/^passwd/openssl-passwd/' doc/apps/passwd.pod \
     46    > doc/apps/openssl-passwd.pod &amp;&amp;
     47rm doc/apps/passwd.pod &amp;&amp;
     48mv doc/crypto/{,openssl_}threads.pod &amp;&amp;
     49sed -i -e 's/-m486/-march=i486/' Configure &amp;&amp;
     50./config --openssldir=/etc/ssl --prefix=/usr shared &amp;&amp;
     51make MANDIR=/usr/share/man &amp;&amp;
     52make MANDIR=/usr/share/man install &amp;&amp;
     53cp -r certs /etc/ssl &amp;&amp;
     54rmdir /etc/ssl/lib</command></userinput></screen>
     55                                                                               
     56</sect2>
     57
     58<sect2>
     59<title>Command explanations</title>
     60                                                                               
     61<para><option>no-rc5 no-idea</option>: When added to the
     62<command>./config</command> command, this will eliminate the building of those
     63encryption methods. Patent licenses may be needed for you to utilize either of
     64those methods in your projects.</para>
     65                                                                               
     66<para><command>rm doc/apps/passwd.pod</command>: This command prevents
     67<application>Open<acronym>SSL</acronym></application> from installing its
     68passwd man page over an existing man page with the same name.</para>
     69                                                                               
     70<para><command>mv doc/crypto/{,openssl_}threads.pod</command>: This
     71commands prevents <application>Open<acronym>SSL</acronym></application> from
     72overwriting an existing man page from <application>Perl</application>.</para>
     73                                                                               
     74<para><command>sed -i -e 's/-m486/-march=i486/' Configure</command>:
     75<application>GCC</application> issues a warning on every
     76compilation because the <command>Configure</command>
     77command uses deprecated <parameter>-m486</parameter> instead of
     78<parameter>-march=i486</parameter>.</para>
     79
     80<para><screen><command>make MANDIR=/usr/share/man
     81make MANDIR=/usr/share/man install</command></screen> These
     82commands install <application>OpenSSL</application> with the man pages
     83in <filename class='directory'>/usr/share/man</filename> instead of the
     84default which is <filename class='directory'>/etc/ssl/man</filename>.</para>
     85                                                                               
     86<para><command>cp -r certs /etc/ssl</command>: The certificates
     87must be copied manually since the install script
     88skips this step.</para>
     89                                                                               
     90<para><command>rmdir /etc/ssl/lib</command>: This is simply a tidy-up command.
     91For some reason, the <application>openssl</application> install routine creates
     92the <filename class='directory'>/etc/ssl/lib</filename> directory even though
     93the libraries have been installed in
     94<filename class='directory'>/usr/lib</filename>.  We remove it to keep things
     95nice and tidy!</para>
     96                                                                               
     97</sect2>
     98
     99<sect2>
     100<title>Configuring <application>OpenSSL</application></title>
     101                                                                               
     102<sect3><title>Config files</title>
     103<para><filename>/etc/ssl/openssl.cnf</filename></para>
     104</sect3>
     105                                                                               
     106<sect3><title>Configuration Information</title>
     107                                                                               
     108<para>Most people who just want to use
     109<application>openssl</application> for providing functions
     110to other programs such as <application>OpenSSH</application> and web browsers won't need to worry
     111about configuring <application>OpenSSL</application>.  Configuring
     112<application>OpenSSL</application> is an advanced topic and
     113so those who do would normally be expected to either know how to do it
     114or to be able to find out how to do it.</para>
     115</sect3>
     116                                                                               
     117</sect2>
     118
     119<sect2>
     120<title>Contents</title>
     121                                                                               
     122<para>The <application>Open<acronym>SSL</acronym></application> package contains <command>
     123c_rehash</command>, <command>openssl</command>, <filename
     124class='libraryfile'>libcrypto</filename> libraries and <filename
     125class='libraryfile'>libssl</filename> libraries.</para>
     126                                                                               
     127</sect2>
     128                                                                               
     129<sect2><title>Description</title>
     130                                                                               
     131<sect3><title>c_rehash</title>
     132                                                                               
     133<para><command>c_rehash</command> is a <application>Perl</application> script
     134that scans all files in a directory and adds symbolic links to their hash
     135values.</para>
     136                                                                               
     137</sect3>
     138
     139<sect3><title>openssl</title>
     140                                                                               
     141<para>The <command>openssl</command> program is a command-line tool for using
     142the various cryptography functions of
     143<application>Open<acronym>SSL</acronym></application>'s
     144crypto library from the shell. It can be used for various functions which are
     145documented in <command>man 1 openssl</command>.</para>
     146                                                                               
     147</sect3>
     148                                                                               
     149<sect3><title>libcrypto</title>
     150                                                                               
     151<para>The <application>Open<acronym>SSL</acronym></application> crypto library implements a wide
     152range of cryptographic  algorithms used in various Internet standards. The
     153services provided by  this library are used by the
     154<application>Open<acronym>SSL</acronym>
     155</application> implementations of <acronym>SSL</acronym>, <acronym>TLS
     156</acronym> and <acronym>S/MIME</acronym>, and they have also been used to
     157implement <application>Open<acronym>SSH</acronym></application>,
     158<application>Open<acronym>PGP</acronym>
     159</application>, and other cryptographic standards.</para>
     160                                                                               
     161</sect3>
     162                                                                               
     163<sect3><title>libssl</title>
     164                                                                               
     165<para>The <application>Open<acronym>SSL</acronym></application> <acronym>SSL</acronym> library
     166implements the Secure Sockets Layer (<acronym>SSL</acronym> v2/v3) and
     167Transport Layer Security (<acronym>TLS</acronym> v1) protocols. It provides a
     168rich <acronym>API</acronym>, documentation on which can be found by running
     169<command>man 3 ssl</command>.</para>
     170                                                                               
     171</sect3>
     172                                                                               
     173</sect2>
    10174
    11175</sect1>
     176
  • general/genlib/pcre.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY pcre-download-http " ">
     8<!ENTITY pcre-download-ftp "ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-&pcre-version;.tar.bz2">
     9<!ENTITY pcre-size "344 KB">
     10<!ENTITY pcre-buildsize "3.5 MB">
     11<!ENTITY pcre-time "0.08 SBU">
     12
     13]>
     14
    115<sect1 id="pcre" xreflabel="PCRE-&pcre-version;">
    216<?dbhtml filename="pcre.html"?>
    317<title>PCRE-&pcre-version;</title>
    418
    5 &pcre-intro;
    6 &pcre-inst;
    7 &pcre-exp;
    8 &pcre-desc;
     19<sect2>
     20<title>Introduction to <application><acronym>PCRE</acronym></application></title>
     21                                                                               
     22<para>The <application><acronym>PCRE</acronym></application> package contains
     23<application>Perl</application> Compatible Regular Expression
     24libraries. These are useful for implementing regular expression pattern
     25matching using the same syntax and semantics as
     26<application>Perl</application> 5.</para>
     27                                                                               
     28<sect3><title>Package information</title>
     29<itemizedlist spacing='compact'>
     30<listitem><para>Download (HTTP): <ulink
     31url="&pcre-download-http;"/></para></listitem>
     32<listitem><para>Download (FTP): <ulink
     33url="&pcre-download-ftp;"/></para></listitem>
     34<listitem><para>Download size: &pcre-size;</para></listitem>
     35<listitem><para>Estimated Disk space required:
     36&pcre-buildsize;</para></listitem>
     37<listitem><para>Estimated build time:
     38&pcre-time;</para></listitem></itemizedlist>
     39</sect3>
     40</sect2>
     41
     42<sect2>
     43<title>Installation of <application><acronym>PCRE</acronym></application></title>
     44                                                                               
     45<para>Install <application><acronym>PCRE</acronym></application> by running the following commands:</para>
     46                                                                               
     47<screen><userinput><command>./configure --prefix=/usr --enable-utf8 &amp;&amp;
     48make &amp;&amp;
     49make install</command></userinput></screen>
     50                                                                               
     51<para>If you reinstall <application>grep</application> after installing <application>pcre</application>,
     52<application>grep</application> will get linked against <application>pcre</application> and
     53may cause problems if <filename>/usr</filename> is a separate mount point. To avoid this,
     54either pass the option <emphasis>--disable-perl-regexp</emphasis> when executing <command>./configure</command>
     55for <application>grep</application> or move <filename>libpcre</filename> to <filename>/lib</filename>
     56as follows.</para>
     57                                                                               
     58<screen><userinput><command>mv /usr/lib/libpcre.so.* /lib/ &amp;&amp;
     59ln -sf ../../lib/libpcre.so.0 /usr/lib/libpcre.so</command></userinput></screen>                                                                               
     60</sect2>
     61                                                                               
     62<sect2>
     63<title>Command explanations</title>
     64                                                                               
     65<para><parameter>--enable-utf8</parameter>: This switch includes the
     66code for handling <acronym>UTF</acronym>-8 character strings in the
     67library.</para>
     68                                                                               
     69</sect2>
     70
     71<sect2>
     72<title>Contents</title>
     73                                                                               
     74<para>The <application><acronym>PCRE</acronym></application> package contains
     75the <filename class='libraryfile'>libpcre</filename> libraries,
     76<command>pcregrep</command>, <command>pcretest</command> and
     77<command>pcre-config</command>.</para>
     78                                                                               
     79</sect2>
     80                                                                               
     81<sect2><title>Description</title>
     82                                                                               
     83<sect3><title>pcregrep</title>
     84<para><command>pcregrep</command> is a <command>grep</command> that understands
     85<application>Perl</application> compatible regular expressions.</para></sect3>
     86                                                                               
     87<sect3><title>pcretest</title>
     88<para><command>pcretest</command> can test your
     89<application>Perl</application> compatible regular expression.</para></sect3>
     90                                                                               
     91<sect3><title>pcre-config</title>
     92<para><command>pcre-config</command> is used during the compile process of
     93programs linking to this library.</para></sect3>
     94                                                                               
     95</sect2>
    996
    1097</sect1>
     98
  • general/genlib/popt.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7
     8<!ENTITY popt-download-http "http://gd.tuwien.ac.at/utils/rpm.org/dist/rpm-4.1.x/popt-&popt-version;.tar.gz">
     9<!ENTITY popt-download-ftp "ftp://ftp.rpm.org/pub/rpm/dist/rpm-4.1.x/popt-&popt-version;.tar.gz">
     10<!ENTITY popt-size "564 KB">
     11<!ENTITY popt-buildsize "17.4 MB">
     12<!ENTITY popt-time "0.06 SBU">
     13
     14]>
     15
    116<sect1 id="popt" xreflabel="popt-&popt-version;">
    217<?dbhtml filename="popt.html"?>
    318<title>popt-&popt-version;</title>
    419
    5 &popt-intro;
    6 &popt-inst;
    7 &popt-desc;
     20<sect2>
     21<title>Introduction to <application>popt</application></title>
     22                                                                               
     23<para>The popt package contains the popt libraries which are used by
     24some programs to parse command-line options.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&popt-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink url="&popt-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &popt-size;</para></listitem>
     32<listitem><para>Estimated Disk space required: &popt-buildsize;</para></listitem>
     33<listitem><para>Estimated build time: &popt-time;</para></listitem></itemizedlist>
     34</sect3>
     35                                                                               
     36</sect2>
     37
     38<sect2>
     39<title>Installation of <application>popt</application></title>
     40                                                                               
     41<para>Install <application>popt</application> by running the following commands:</para>
     42                                                                               
     43<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     44make &amp;&amp;
     45make install</command></userinput></screen>
     46                                                                               
     47</sect2>
     48
     49<sect2>
     50<title>Contents</title>
     51                                                                               
     52<para>The <application>popt</application> package contains the
     53<filename class="libraryfile">libpopt</filename> libraries.</para>
     54                                                                               
     55</sect2>
     56                                                                               
     57<sect2><title>Description</title>
     58                                                                               
     59<sect3><title>popt library</title>
     60<para>The <filename class="libraryfile">libpopt</filename> library is used to
     61parse command-line options.</para></sect3>
     62                                                                               
     63</sect2>
    864
    965</sect1>
  • general/genlib/readline.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY readline-download-http "http://ftp.gnu.org/gnu/readline/readline-&readline-version;.tar.gz">
     8<!ENTITY readline-download-ftp "ftp://ftp.gnu.org/gnu/readline/readline-&readline-version;.tar.gz">
     9<!ENTITY readline-size "944 KB">
     10<!ENTITY readline-buildsize "9.2 MB">
     11<!ENTITY readline-time "0.10 SBU">
     12
     13]>
     14
    115<sect1 id="readline" xreflabel="readline-&readline-version;">
    216<?dbhtml filename="readline.html"?>
    317<title>readline-&readline-version;</title>
    418
    5 &readline-intro;
    6 &readline-inst;
    7 &readline-exp;
    8 &readline-config;
    9 &readline-desc;
     19<sect2>
     20<title>Introduction to <application>readline</application></title>
     21                                                                             
     22<para>The <application>readline</application> library provides a set of
     23functions for use by applications that allow users to edit command-lines as
     24they are typed in.  Both <application>Emacs</application> and
     25<application>vi</application> editing modes are available.</para>
     26                                                                             
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink
     30url="&readline-download-http;"/></para></listitem>
     31<listitem><para>Download (FTP): <ulink
     32url="&readline-download-ftp;"/></para></listitem>
     33<listitem><para>Download size: &readline-size;</para></listitem>
     34<listitem><para>Estimated Disk space required:
     35&readline-buildsize;</para></listitem>
     36<listitem><para>Estimated build time:
     37&readline-time;</para></listitem></itemizedlist>
     38</sect3>
     39                                                                             
     40                                                                             
     41</sect2>
     42
     43<sect2>
     44<title>Installation of <application>readline</application></title>
     45                                                                             
     46<para>Install <application>readline</application> by running the following
     47commands:</para>
     48                                                                             
     49<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     50make SHLIB_LIBS=-lcurses &amp;&amp;
     51make install</command></userinput></screen>
     52                                                                             
     53</sect2>
     54
     55<sect2>
     56<title>Command explanations</title>
     57                                                                             
     58<para><command>make SHLIB_LIBS=-lcurses</command>: This command makes the
     59proper symbols available for applications that assume
     60<application>readline</application> is compiled with
     61<application>ncurses</application> links.</para>
     62                                                                             
     63</sect2>
     64
     65<sect2>
     66<title>Configuring <application>readline</application></title>
     67                                                                             
     68<sect3><title>Configuration Information</title>
     69                                                                             
     70<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>       
     71                                                                             
     72</sect3>
     73                                                                             
     74</sect2>
     75
     76<sect2>
     77<title>Contents</title>
     78                                                                             
     79<para>The <application>readline</application> package contains the <filename>
     80libreadline</filename> libraries and <filename>libhistory</filename> libraries.
     81</para>
     82                                                                             
     83</sect2>
    1084
    1185</sect1>
     86
  • general/genlib/slang.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY slang-download-http "http://gd.tuwien.ac.at/editors/davis/slang/v1.4/slang-&slang-version;.tar.bz2">
     8<!ENTITY slang-download-ftp "ftp://space.mit.edu/pub/davis/slang/v1.4/slang-&slang-version;.tar.bz2">
     9<!ENTITY slang-size "624 KB">
     10<!ENTITY slang-buildsize "9.6 MB">
     11<!ENTITY slang-time "0.16 SBU">
     12
     13]>
     14
    115<sect1 id="slang" xreflabel="slang-&slang-version;">
    216<?dbhtml filename="slang.html"?>
    317<title>slang-&slang-version;</title>
    418
    5 &slang-intro;
    6 &slang-inst;
    7 &slang-config;
    8 &slang-desc;
     19<sect2>
     20<title>Introduction to <application>slang</application></title>
     21                                                                               
     22<para>The slang package contains the slang library, which
     23provides facilities such as display/screen management, keyboard input, and keymaps.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&slang-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&slang-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &slang-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &slang-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &slang-time;</para></listitem></itemizedlist>
     32</sect3>
     33                                                                               
     34</sect2>
     35
     36<sect2>
     37<title>Installation of <application>slang</application></title>
     38                                                                               
     39<para>Install <application>slang</application> by running the following commands:</para>
     40                                                                               
     41<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     42make &amp;&amp;
     43make install &amp;&amp;
     44make elf &amp;&amp;
     45make install-elf &amp;&amp;
     46make install-links &amp;&amp;
     47chmod 755 /usr/lib/libslang.so.&slang-version;</command></userinput></screen>
     48                                                                               
     49</sect2>
     50
     51<sect2>
     52<title>Configuring <application>slang</application></title>
     53                                                                               
     54<sect3><title>Configuration Information</title>
     55                                                                               
     56<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
     57                                                                               
     58</sect3>
     59                                                                               
     60</sect2>
     61
     62<sect2>
     63<title>Contents</title>
     64                                                                               
     65<para>The <application>slang</application> package contains the <filename>libslang</filename> libraries.</para>
     66                                                                               
     67</sect2>
    968
    1069</sect1>
     70
  • general/genlib/slib.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY slib-download-http "http://www.swiss.ai.mit.edu/ftpdir/scm/OLD/slib&slib-version;.tar.gz">
     8<!ENTITY slib-download-ftp " ">
     9<!ENTITY slib-size "636 KB">
     10<!ENTITY slib-buildsize "2.9 MB">
     11<!ENTITY slib-time "0.00 SBU">
     12
     13]>
     14
    115<sect1 id="slib" xreflabel="slib-&slib-version;">
    216<?dbhtml filename="slib.html"?>
    317<title>slib-&slib-version;</title>
    418
    5 &slib-intro;
    6 &slib-inst;
    7 &slib-desc;
     19<sect2>
     20<title>Introduction to <application>slib</application></title>
     21                                                                               
     22<para>The <application>slib</application> package is a <application>Scheme
     23</application> library used with <application>Guile</application>.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&slib-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&slib-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &slib-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&slib-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&slib-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38                                                                               
     39<sect3><title><application>slib</application> dependencies</title>
     40<sect4><title>Required</title>
     41<para><xref linkend="guile"/></para></sect4>
     42</sect3>
     43                                                                               
     44</sect2>
     45
     46<sect2>
     47<title>Installation of <application>slib</application></title>
     48                                                                               
     49<para>Installation of  <application>slib</application> is merely a copy command:
     50</para>
     51                                                                               
     52<screen><userinput><command>cp -R slib /usr/share/guile</command></userinput>
     53</screen>
     54                                                                               
     55</sect2>
     56
     57<sect2>
     58<title>Contents</title>
     59                                                                               
     60<para>The <application>slib</application> package contains a <application>
     61Scheme</application> library.</para>
     62                                                                               
     63</sect2>
    864
    965</sect1>
  • general/genutils/bc.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY bc-download-http "http://ftp.gnu.org/gnu/bc/bc-&bc-version;.tar.gz">
     8<!ENTITY bc-download-ftp "ftp://ftp.gnu.org/gnu/bc/bc-&bc-version;.tar.gz">
     9<!ENTITY bc-size "280 KB">
     10<!ENTITY bc-buildsize "1.6 MB">
     11<!ENTITY bc-time "0.07 SBU">
     12
     13]>
     14
     15<sect1 id="bc" xreflabel="bc-&bc-version;">
     16<?dbhtml filename="bc.html"?>
     17<title>bc-&bc-version;</title>
     18
     19<sect2>
     20<title>Introduction to <application>bc</application></title>
     21                                                                               
     22<para>The <application>bc</application> package contains
     23an arbitrary precision numeric processing language.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&bc-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&bc-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &bc-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&bc-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&bc-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38<sect3><title>Additional downloads</title>
     39<itemizedlist spacing='compact'>
     40<listitem><para>Required Patch: <ulink
     41url="&patch-root;/bc-1.06-flex_invocation-1.patch"/></para></listitem>
     42<listitem><para>Required Patch: <ulink
     43url="&patch-root;/bc-1.06-readline-1.patch"/></para></listitem>
     44</itemizedlist></sect3>
     45                                                                               
     46<sect3><title><application>bc</application> dependencies</title>
     47<sect4><title>Required</title>
     48<para><xref linkend="readline"/></para></sect4>
     49</sect3>
     50                                                                               
     51</sect2>
     52
     53<sect2>
     54<title>Installation of <command>bc</command></title>
     55                                                                               
     56<para>Install <command>bc</command> by running the following commands:</para>
     57                                                                               
     58<screen><userinput><command>patch -Np1 -i ../bc-1.06-flex_invocation-1.patch &amp;&amp;
     59patch -Np1 -i ../bc-1.06-readline-1.patch &amp;&amp;
     60./configure --prefix=/usr --with-readline &amp;&amp;
     61make &amp;&amp;
     62make install</command></userinput></screen>
     63                                                                               
     64</sect2>
     65
     66<sect2>
     67<title>Contents</title>
     68                                                                               
     69<para>The <application>bc</application> package contains
     70<command>bc</command> and
     71<command>dc</command>.</para>
     72                                                                               
     73</sect2>
     74                                                                               
     75<sect2><title>Description</title>
     76                                                                               
     77<sect3><title>bc</title>
     78<para><command>bc</command> is a calculator.</para></sect3>
     79                                                                               
     80<sect3><title>dc</title>
     81<para><command>dc</command> is a reverse-polish calculator.</para></sect3>
     82                                                                               
     83</sect2>
     84
     85</sect1>
     86
     87<!-- Old Stuff
    188<sect1 id="bc" xreflabel="bc-&bc-version;">
    289<?dbhtml filename="bc.html"?>
     
    895
    996</sect1>
    10 
     97-->
  • general/genutils/compface.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY compface-download-http "http://www.ibiblio.org/pub/Linux/apps/graphics/convert/compface-&compface-version;.tar.gz">
     8<!ENTITY compface-download-ftp " ">
     9<!ENTITY compface-size "28 KB">
     10<!ENTITY compface-buildsize "520 KB">
     11<!ENTITY compface-time "0.01 SBU">
     12
     13]>
     14
     15<sect1 id="compface" xreflabel="Compface-&compface-version;">
     16<?dbhtml filename="compface.html"?>
     17<title>Compface-&compface-version;</title>
     18
     19<sect2>
     20<title>Introduction to <application>Compface</application></title>
     21                                                                               
     22<para><application>Compface</application> provides utilities and a library to
     23convert from/to X-Face format, a 48x48 bitmap format used to carry thumbnails
     24of email authors in a mail header.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&compface-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&compface-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &compface-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &compface-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &compface-time;</para></listitem></itemizedlist>
     33</sect3>
     34                                                                               
     35<sect3><title>Additional downloads</title>
     36<itemizedlist spacing='compact'>
     37<listitem><para>Required patch: <ulink
     38url="&patch-root;/compface-1.4-errno-2.patch"/></para></listitem>
     39</itemizedlist>
     40</sect3>
     41                                                                               
     42</sect2>
     43
     44<sect2>
     45<title>Installation of <application>Compface</application></title>
     46                                                                               
     47<para>Install <application>Compface</application> by running the
     48following commands:</para>
     49                                                                               
     50<screen><userinput><command>patch -Np1 -i ../compface-1.4-errno-2.patch &amp;&amp;
     51./configure --prefix=/usr &amp;&amp;
     52make &amp;&amp;
     53make install</command></userinput></screen>
     54                                                                               
     55</sect2>
     56
     57<sect2>
     58<title>Contents</title>
     59                                                                               
     60<para>This package contains <command>compface</command>,
     61<command>uncompface</command> and
     62<filename class="libraryfile">libcompface</filename>.</para>
     63                                                                               
     64</sect2>
     65                                                                               
     66<sect2><title>Description</title>
     67                                                                               
     68<sect3><title>compface</title>
     69<para><command>compface</command> is a filter for generating highly compressed
     70representations of 48x48x1 face image files.</para></sect3>
     71                                                                               
     72<sect3><title>uncompface</title>
     73<para><command>uncompface</command> is an inverse filter which performs an inverse
     74transformation with no loss of data.</para></sect3>
     75                                                                               
     76<sect3><title>libcompface</title>
     77<para><filename class="libraryfile">libcompface</filename> allows the compression
     78and decompression algorithms to be used in other programs such as
     79<acronym>MTA</acronym>s.</para></sect3>
     80                                                                               
     81</sect2>
     82
     83</sect1>
     84
     85<!-- Old Stuff
    186<sect1 id="compface" xreflabel="Compface-&compface-version;">
    287<?dbhtml filename="compface.html"?>
     
    893
    994</sect1>
     95-->
  • general/genutils/genutils.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4 <!ENTITY % general-entities SYSTEM "../../general.ent">
     5 %general-entities;
     6]>
     7
    18<chapter id="general-genutils">
    29<?dbhtml filename="genutils.html"?>
    310<title>General Utilities</title>
    411
    5 &bc;
    6 &rep-gtk;
    7 &compface;
    8 &imagemagick;
    9 &hd2u;
     12<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="bc.xml"/>
     13<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="rep-gtk.xml"/>
     14<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="compface.xml"/>
     15<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="imagemagick.xml"/>
     16<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="hd2u.xml"/>
    1017
    1118</chapter>
  • general/genutils/hd2u.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY hd2u-download-http "http://www.megaloman.com/~hany/_data/hd2u/hd2u-&hd2u-version;.tgz">
     8<!ENTITY hd2u-download-ftp " ">
     9<!ENTITY hd2u-size "11 KB">
     10<!ENTITY hd2u-buildsize "280 KB">
     11<!ENTITY hd2u-time "0.1 SBU">
     12
     13]>
     14
    115<sect1 id="hd2u" xreflabel="hd2u-&hd2u-version;">
    216<?dbhtml filename="hd2u.html"?>
    317<title>hd2u-&hd2u-version;</title>
    418
    5 &hd2u-intro;
    6 &hd2u-inst;
    7 &hd2u-desc;
     19<sect2>
     20<title>Introduction to <application>hd2u</application></title>
     21                                                                               
     22<para>The <application>hd2u</application> contains
     23any to any text format converter.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&hd2u-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&hd2u-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &hd2u-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&hd2u-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&hd2u-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38<sect3><title><application>hd2u</application> dependencies</title>
     39<sect4><title>Required</title>
     40<para><xref linkend="popt"/></para></sect4>
     41</sect3>
     42                                                                               
     43</sect2>
     44
     45<sect2>
     46<title>Installation of <application>hd2u</application></title>
     47                                                                               
     48<para>Install <application>hd2u</application> by running the following commands:</para>
     49                                                                               
     50<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     51make &amp;&amp;
     52make install</command></userinput></screen>
     53                                                                               
     54</sect2>
     55
     56<sect2>
     57<title>Contents</title>
     58                                                                               
     59<para>The <application>hd2u</application> package contains
     60<command>dos2unix</command>.</para>
     61                                                                               
     62</sect2>
     63                                                                               
     64<sect2><title>Description</title>
     65                                                                               
     66<sect3><title>dos2unix</title>
     67<para><command>dos2unix</command> converts text between various OS formats
     68(such as converting from DOS format to Unix).</para></sect3>
     69                                                                               
     70</sect2>
    871
    972</sect1>
  • general/genutils/imagemagick.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY imagemagick-patch-version "16">
     8  <!ENTITY imagemagick-download-http "http://prdownloads.sourceforge.net/imagemagick/ImageMagick-&imagemagick-version;-&imagemagick-patch-version;.tar.bz2">
     9  <!ENTITY imagemagick-download-ftp  " ">
     10  <!ENTITY imagemagick-size          "4.1 MB">
     11  <!ENTITY imagemagick-buildsize     "107 MB">
     12  <!ENTITY imagemagick-time          "3.80 SBU">
     13]>
     14
    115<sect1 id="imagemagick" xreflabel="ImageMagick-&imagemagick-version;-&imagemagick-patch-version;">
    216<?dbhtml filename="imagemagick.html"?>
    317<title>ImageMagick-&imagemagick-version;-&imagemagick-patch-version;</title>
    418
    5 &imagemagick-intro;
    6 &imagemagick-inst;
    7 &imagemagick-desc;
     19<sect2>
     20<title>Introduction to <application>ImageMagick</application></title>
     21                                                                               
     22<para><application>ImageMagick</application> is a collection of tools and libraries
     23to read, write, and
     24manipulate an image in various image formats. Image processing operations are
     25available from the command line. Bindings to various programming languages
     26are also available.</para>
     27                                                                               
     28<sect3><title>Package information</title>
     29<itemizedlist spacing='compact'>
     30<listitem><para>Download (HTTP): <ulink
     31url="&imagemagick-download-http;"/></para></listitem>
     32<listitem><para>Download (FTP): <ulink
     33url="&imagemagick-download-ftp;"/></para></listitem>
     34<listitem><para>Download size: &imagemagick-size;</para></listitem>
     35<listitem><para>Estimated Disk space required:
     36&imagemagick-buildsize;</para></listitem>
     37<listitem><para>Estimated build time:
     38&imagemagick-time;</para></listitem></itemizedlist>
     39</sect3>
     40
     41<sect3><title><application>ImageMagick</application> dependencies</title>
     42                                                                               
     43<sect4><title>Recommended</title>
     44<para>
     45X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and
     46<xref linkend="espgs"/>
     47</para></sect4>
     48                                                                               
     49<sect4><title>Optional (Install based on the format support needed)</title>
     50<para>
     51<xref linkend="lcms"/>,
     52<xref linkend="libjpeg"/>,
     53<xref linkend="libpng"/>,
     54<xref linkend="libtiff"/>,
     55<xref linkend="libxml2"/>,
     56<ulink url="http://wvware.sourceforge.net/">libwmf</ulink>,
     57<ulink url="http://sourceforge.net/projects/libexif/">libexif</ulink>,
     58<ulink url="http://www.i3a.org/i_flashpix.html">FlashPIX</ulink>,
     59<ulink url="http://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG</ulink>,
     60<ulink url="http://www.ece.uvic.ca/~mdadams/jasper/">Jasper</ulink> and
     61<ulink url="http://corefonts.sourceforge.net/">corefonts</ulink>
     62</para></sect4>
     63                                                                               
     64</sect3>
     65                                                                               
     66</sect2>
     67
     68<sect2>
     69<title>Installation of <application>Imagemagick</application></title>
     70                                                                               
     71<para>Install <application>Imagemagick</application> by running the following
     72commands:</para>
     73                                                                               
     74<screen><userinput><command>./configure --prefix=/usr --enable-shared --with-modules &amp;&amp;
     75make &amp;&amp;
     76make install</command></userinput></screen>
     77                                                                               
     78</sect2>
     79                                                                               
     80<sect2>
     81<title>Additional Configure Options</title>
     82                                                                               
     83<para>There are additional switches that can be passed to <application>ImageMagick</application>
     84to customize the installation to your need. Check out the <application>ImageMagick</application>
     85installation instructions at <ulink url="http://www.imagemagick.org/www/Install-unix.html"/>.</para>
     86                                                                               
     87</sect2>
     88
     89<sect2>
     90<title>Contents</title>
     91                                                                               
     92<para><application>ImageMagick</application> contains <command>animate</command>,
     93<command>composite</command>,
     94<command>conjure</command>,
     95<command>convert</command>,
     96<command>display</command>,
     97<command>identify</command>,
     98<command>import</command>,
     99<command>mogrify</command>,
     100<command>montage</command>, and the
     101<filename class="libraryfile">libMagick</filename> and
     102<filename class="libraryfile">libMagick++</filename> libraries.</para>
     103                                                                               
     104</sect2>
     105                                                                               
     106<sect2><title>Description</title>
     107                                                                               
     108<sect3><title>animate</title>
     109<para>Animates a sequence of images.</para></sect3>
     110                                                                               
     111<sect3><title>composite</title>
     112<para>Composites various images into the given base image.</para></sect3>
     113                                                                               
     114<sect3><title>conjure</title>
     115<para>Processes a Magick Scripting Language (MSL) script to create
     116an image.</para></sect3>
     117                                                                               
     118<sect3><title>convert</title>
     119<para>Convert image(s) from one format to another.</para></sect3>
     120                                                                               
     121<sect3><title>display</title>
     122<para>Display the image.</para></sect3>
     123                                                                               
     124<sect3><title>identify</title>
     125<para>Describes the format and characteristics of an image file.</para></sect3>                                                                               
     126<sect3><title>import</title>
     127<para>Captures an X window.</para></sect3>
     128                                                                               
     129<sect3><title>mogrify</title>
     130<para>Transforms an image.</para></sect3>
     131                                                                               
     132<sect3><title>montage</title>
     133<para>Composites various images into a new image.</para></sect3>
     134                                                                               
     135</sect2>
    8136
    9137</sect1>
  • general/genutils/rep-gtk.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY rep-gtk-download-http "http://prdownloads.sourceforge.net/rep-gtk/rep-gtk-&rep-gtk-version;.tar.gz">
     8  <!ENTITY rep-gtk-download-ftp  " ">
     9  <!ENTITY rep-gtk-size          "152 KB">
     10  <!ENTITY rep-gtk-buildsize     "7.7 MB">
     11  <!ENTITY rep-gtk-time          "0.18 SBU">
     12]>
     13
    114<sect1 id="rep-gtk" xreflabel="rep-gtk-&rep-gtk-version;">
    215<?dbhtml filename="rep-gtk.html"?>
    316<title>rep-gtk-&rep-gtk-version;</title>
    417
    5 &rep-gtk-intro;
    6 &rep-gtk-inst;
    7 &rep-gtk-desc;
     18<sect2>
     19<title>Introduction to <application>rep-gtk</application></title>
     20
     21<para>The <application>rep-gtk</application> package contains a <application>
     22Lisp</application> and <application>GTK</application> binding. This is useful
     23for extending <application>GTK-2</application> and <application>GDK
     24</application> libraries with <application>Lisp</application>. Starting at
     25<application>rep-gtk</application>-0.15, the package contains the bindings to
     26<application>GTK</application> and uses the same instructions. Both
     27can be installed, if needed. </para>
     28
     29<sect3><title>Package information</title>
     30<itemizedlist spacing='compact'>
     31<listitem><para>Download (HTTP): <ulink
     32url="&rep-gtk-download-http;"/></para></listitem>
     33<listitem><para>Download (FTP): <ulink
     34url="&rep-gtk-download-ftp;"/></para></listitem>
     35<listitem><para>Download size: &rep-gtk-size;</para></listitem>
     36<listitem><para>Estimated Disk space required:
     37&rep-gtk-buildsize;</para></listitem>
     38<listitem><para>Estimated build time:
     39&rep-gtk-time;</para></listitem></itemizedlist>
     40</sect3>
     41
     42<sect3><title>Additional downloads</title>
     43<itemizedlist spacing='compact'>
     44<listitem><para>Required Patch: <ulink
     45url="&patch-root;/rep-gtk-&rep-gtk-version;-gtk2.4.patch"/></para></listitem>
     46</itemizedlist></sect3>
     47
     48
     49<sect3><title><application>rep-gtk</application> dependencies</title>
     50<sect4><title>Required</title>
     51<para><xref linkend="GTK2"/>, <xref linkend="libglade"/> and <xref
     52linkend="librep"/></para></sect4>
     53</sect3>
     54
     55</sect2>
     56
     57<sect2>
     58<title>Installation of <application>rep-gtk</application></title>
     59
     60<para>Install <application>rep-gtk</application> by running the following
     61commands:</para>
     62
     63<screen><userinput><command>patch -Np1 -i ../rep-gtk-&rep-gtk-version;-gtk2.4.patch &amp;&amp;
     64./configure --prefix=/usr &amp;&amp;
     65make &amp;&amp;
     66make install</command></userinput></screen>
     67                                                                               
     68</sect2>
     69
     70<sect2>
     71<title>Contents</title>
     72                                                                               
     73<para>The <application>rep-gtk</application> package contains Lisp bindings.
     74</para>
     75                                                                               
     76</sect2>
     77                                                                               
     78<sect2><title>Description</title>
     79                                                                               
     80<sect3><title>Lisp bindings</title>
     81<para>Lisp bindings are libraries stored in <filename>
     82/usr/lib/rep/i686-pc-linux-gnu/gui/</filename> that assist communications
     83between Lisp and the GTK libraries.</para></sect3>
     84                                                                               
     85</sect2>
    886
    987</sect1>
  • general/graphlib/aalib.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY aalib-download-http "http://prdownloads.sourceforge.net/aa-project/aalib-&aalib-version;.tar.gz">
     8<!ENTITY aalib-download-ftp " ">
     9<!ENTITY aalib-size "388 KB">
     10<!ENTITY aalib-buildsize "6.5 MB">
     11<!ENTITY aalib-time "0.15 SBU">
     12
     13]>
     14
    115<sect1 id="aalib" xreflabel="AAlib-&aalib-version;">
    216<?dbhtml filename="aalib.html"?>
    317<title>AAlib-&aalib-version;</title>
    418
    5 &aalib-intro;
    6 &aalib-inst;
    7 &aalib-desc;
     19<sect2>
     20<title>Introduction to <application>AAlib</application></title>
     21                                                                               
     22<para><application>AAlib</application> is a library to render any graphic into
     23<acronym>ASCII</acronym> Art.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&aalib-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&aalib-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &aalib-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&aalib-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&aalib-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38                                                                               
     39<sect3><title><application>AAlib</application> dependencies</title>
     40<sect4><title>Optional</title>
     41<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and <xref linkend="slang"/></para></sect4>
     42</sect3>
     43                                                                               
     44</sect2>
     45
     46<sect2>
     47<title>Installation of <application>AAlib</application></title>
     48                                                                               
     49<para>Install <application>AAlib</application> by running the following
     50commands:</para>
     51                                                                               
     52<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     53make &amp;&amp;
     54make install</command></userinput></screen>
     55                                                                               
     56</sect2>
     57
     58<sect2>
     59<title>Contents</title>
     60                                                                               
     61<para>The <application>AAlib</application> package contains the <filename>libaa</filename> libraries, <command>aalib-config</command>,
     62<command>aainfo</command>, <command>aatest</command> and
     63<command>aasavefont</command>.</para>
     64                                                                               
     65</sect2>
     66                                                                               
     67<sect2><title>Description</title>
     68                                                                               
     69<sect3><title>ASCII Art libraries</title>
     70<para>The ASCII Art library is a collection of routines to render any
     71graphical input in portable format to ASCII Art. It can be used through
     72many programs and has a very well documented <acronym>API</acronym>, so you
     73can easily put it into your own programs.</para></sect3>
     74                                                                               
     75<sect3><title>aalib-config</title>
     76<para><command>aalib-config</command> provides configuration info for
     77<application>AAlib</application>.
     78</para></sect3>
     79<sect3><title>aainfo</title>
     80<para><command>aainfo</command> provides information for your current settings
     81related to <application>AAlib</application>.</para></sect3>
     82                                                                               
     83<sect3><title>aatest</title>
     84<para><command>aatest</command> shows the abilities of <application>AAlib
     85</application> in a little test.</para></sect3>
     86                                                                               
     87<sect3><title>aafire</title>
     88<para><command>aafire</command> is another little toy of <application>AAlib
     89</application>, rendering an animated fire in ASCII Art.</para></sect3>
     90                                                                               
     91<sect3><title>aasavefont</title>
     92<para>Currently no information available.</para></sect3>
     93                                                                               
     94</sect2>
    895
    996</sect1>
  • general/graphlib/directfb.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY DirectFB-download-http "http://www.directfb.org/download/DirectFB/DirectFB-&DirectFB-version;.tar.gz">
     8<!ENTITY DirectFB-download-ftp " ">
     9<!ENTITY DirectFB-size "1.3 MB">
     10<!ENTITY DirectFB-buildsize "13 MB">
     11<!ENTITY DirectFB-time "0.65 SBU">
     12
     13]>
     14
    115<sect1 id="DirectFB" xreflabel="DirectFB-&DirectFB-version;">
    216<?dbhtml filename="DirectFB.html"?>
    317<title>DirectFB-&DirectFB-version;</title>
    418
    5 &DirectFB-intro;
    6 &DirectFB-inst;
    7 &DirectFB-config;
    8 &DirectFB-desc;
     19<sect2>
     20<title>Introduction to <application>DirectFB</application></title>
     21                                                                               
     22<para><application>DirectFB</application> is a graphics library on top of the Linux frame buffer
     23device. It offers maximum hardware accelerated performance at a
     24minimum of resource usage and overhead.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&DirectFB-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&DirectFB-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &DirectFB-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &DirectFB-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &DirectFB-time;</para></listitem></itemizedlist>
     33</sect3>
     34                                                                               
     35<sect3><title>Additional downloads</title>
     36<itemizedlist spacing='compact'>
     37<listitem><para>Optional image and video providers: <ulink
     38url="http://www.directfb.org/download/DirectFB-extra/DirectFB-extra-0.9.16.tar.gz"/>
     39</para></listitem>
     40</itemizedlist></sect3>
     41                                                                               
     42<sect3><title><application>DirectFB</application> dependencies</title>
     43<sect4><title>Required</title>
     44<para><xref linkend="freetype2"/>, <xref linkend="libjpeg"/> and
     45<xref linkend="libpng"/>
     46</para></sect4>
     47<sect4><title>Optional</title>
     48<para><xref linkend="SDL"/>, <xref linkend="libmpeg3"/>
     49<xref linkend="pkgconfig"/>, <xref linkend="imlib2"/>, <xref
     50linkend="openquicktime"/> and <xref linkend="avifile"/>
     51</para></sect4>
     52</sect3>
     53                                                                               
     54</sect2>
     55
     56<sect2>
     57<title>Installation of <application>DirectFB</application></title>
     58                                                                               
     59<note><para>DirectFB needs a Linux kernel with frame buffer support. Check
     60the documentation in the kernel tree
     61(<filename class="directory">/usr/src/linux/Documentation/fb/</filename>)
     62on how to enable the frame buffer device for your graphics
     63card.</para></note>
     64                                                                               
     65<para>Install <application>DirectFB</application> by running the
     66following commands:</para>
     67                                                                               
     68<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     69make &amp;&amp;
     70make install</command></userinput></screen>
     71                                                                               
     72<para>If you decided to add any optional image and video providers, then you
     73have to install the DirectFB-extra package too:</para>
     74                                                                               
     75<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     76make &amp;&amp;
     77make install</command></userinput></screen>
     78                                                                               
     79<note><para>The current version of avifile does not work with DirectFB.
     80You have to use the avifile version which can be found at
     81<ulink url="http://www.directfb.org/download/contrib/"/> or alternatively disable the
     82avifile video provider by calling configure with
     83<command>--disable-avifile</command>.</para></note>
     84                                                                               
     85</sect2>
     86
     87<sect2>
     88<title>Configuring DirectFB</title>
     89                                                                               
     90<sect3><title>Config files</title>
     91                                                                               
     92<para><filename>/etc/directfbrc</filename>,
     93<filename>~/.directfbrc</filename></para>
     94</sect3>
     95                                                                               
     96<sect3><title>Configuration information</title>
     97                                                                               
     98<para>DirectFB is shipped with reasonable defaults but you might have to
     99tweak things. There are several ways to do this. You may edit the
     100system-wide configuration file <filename>/etc/directfbrc</filename>, the user-specific
     101<filename>~/.directfbrc</filename> or you may configure the DirectFB application via the
     102command-line. Consult the directfbrc(5) manual page for details.</para>
     103</sect3>
     104                                                                               
     105</sect2>
     106
     107<sect2>
     108<title>Contents</title>
     109                                                                               
     110<para>The DirectFB package provides <command>dfbdump</command>,
     111<command>dfbg</command>, <command>dfbinfo</command>,
     112<command>dfblayer</command>, <command>directfb-config</command>,
     113<command>directfb-csource</command> and <filename
     114class="libraryfile">libdirectfb</filename> libraries.</para>
     115                                                                               
     116</sect2>
     117                                                                               
     118<sect2><title>Description</title>
     119                                                                               
     120<sect3><title>dfbdump</title>
     121<para> This is a simple debugging tool for DirectFB that shows a list
     122of surfaces and windows.</para></sect3>
     123                                                                               
     124<sect3><title>dfbg</title>
     125<para><command>dfbg</command> is a background configuration
     126tool.</para></sect3>
     127                                                                               
     128<sect3><title>dfbinfo</title>
     129<para>This tool enumerates input devices.</para></sect3>
     130                                                                               
     131<sect3><title>dfblayer</title>
     132<para><command>dfblayer</command> is a display layer configuration
     133tool.</para></sect3>
     134                                                                               
     135<sect3><title>directfb-config</title>
     136<para><command>directfb-config</command> provides all flags to link static binaries with
     137selectable drivers and other modules built in.</para></sect3>
     138                                                                               
     139<sect3><title>directfb-csource</title>
     140<para>This is a C code generation utility for DirectFB
     141surfaces.</para></sect3>
     142                                                                               
     143<sect3><title>libdirectfb libraries</title>
     144<para>They provide hardware graphics acceleration, input device handling
     145and abstraction, integrated windowing system with support for
     146translucent windows and multiple display layers on top of the Linux
     147frame buffer device.</para></sect3>
     148                                                                               
     149</sect2>
    9150
    10151</sect1>
  • general/graphlib/fontconfig.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY fontconfig-download-http "http://freedesktop.org/~fontconfig/release/fontconfig-&fontconfig-version;.tar.gz">
     8<!ENTITY fontconfig-download-ftp "ftp://ftp.us.sinuspl.net/pub/src/fontconfig-&fontconfig-version;.tar.gz">
     9<!ENTITY fontconfig-size "727 KB">
     10<!ENTITY fontconfig-buildsize "11 MB">
     11<!ENTITY fontconfig-time "0.18 SBU">
     12
     13]>
     14
    115<sect1 id="fontconfig" xreflabel="Fontconfig-&fontconfig-version;">
    216<?dbhtml filename="fontconfig.html"?>
    317<title>Fontconfig-&fontconfig-version;</title>
    418
    5 &fontconfig-intro;
    6 &fontconfig-inst;
    7 &fontconfig-config;
    8 &fontconfig-desc;
     19<sect2>
     20<title>Introduction to <application>Fontconfig</application></title>
     21                                                                               
     22<para>The <application>Fontconfig</application> package is a library
     23for configuring and customizing font access.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&fontconfig-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&fontconfig-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &fontconfig-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&fontconfig-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&fontconfig-time;</para></listitem></itemizedlist>
     36                                                                               
     37<note><para>The numbering system of
     38<application>Fontconfig</application> is unusual.  The beta versions of the
     39package are numbered with a 9x in the last portion of the release number.  This
     40means that 2.2.90 is a beta release and the most current release is of the
     41form 2.2.1</para></note>
     42                                                                               
     43</sect3>
     44
     45<sect3><title><application>Fontconfig</application> dependencies</title>
     46<sect4><title>Required</title>
     47<para><xref linkend="freetype2"/> and <xref linkend="expat"/></para></sect4>
     48<sect4><title>Optional</title>
     49<para>
     50<ulink url="http://sources.redhat.com/docbook-tools/">docbook-utils</ulink>
     51</para></sect4>
     52</sect3>
     53</sect2>
     54
     55<sect2>
     56<title>Installation of <application>Fontconfig</application></title>
     57                                                                               
     58<para>Install <application>Fontconfig</application> by running the following commands:</para>
     59                                                                               
     60<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc &amp;&amp;
     61make &amp;&amp;
     62make install</command></userinput></screen>
     63</sect2>
     64
     65<sect2>
     66<title>Configuring <application>Fontconfig</application></title>
     67                                                                               
     68<sect3><title>Config files</title>
     69<para><filename>/etc/fonts/*</filename></para>
     70</sect3>
     71                                                                               
     72<sect3><title>Configuration Information</title>
     73                                                                               
     74<para>The configuration file for <application>Fontconfig</application> is <filename>/etc/fonts/fonts.conf</filename>.
     75Generally you do not want to edit this file.  To put a new font directory
     76in the configuration, update the <filename>/etc/fonts/local.conf</filename> file with your local
     77information.  The default location of fonts in
     78<application>Fontconfig</application> is:</para>
     79<itemizedlist spacing='compact'>
     80<listitem><para>/usr/share/fonts</para></listitem>
     81<listitem><para>~/.fonts</para></listitem>
     82</itemizedlist>
     83                                                                               
     84<para>Because we have not built <application>XFree86</application> yet, put the following directory entries
     85into <filename>/etc/fonts/local.conf</filename>, inside the fontconfig
     86tags:</para>
     87                                                                               
     88<screen><userinput><command>sed -i -e '/^&lt;\/fontconfig&gt;/i\
     89&lt;dir&gt;/usr/X11R6/lib/X11/fonts/TTF&lt;/dir&gt;\
     90&lt;dir&gt;/usr/X11R6/lib/X11/fonts/Type1&lt;/dir&gt;\
     91&lt;dir&gt;/usr/X11R6/lib/X11/fonts/truetype&lt;/dir&gt;' /etc/fonts/local.conf</command></userinput></screen>
     92                                                                               
     93<para>The <application>Fontconfig</application> program will automatically search the above directories
     94and all subdirectories for needed fonts.</para>
     95                                                                               
     96<note><para><application>X</application> also includes an internal (and
     97older) version of <application>Fontconfig</application>
     98and unless it is explicitly disabled when building
     99<application>XFree86</application>, the internal
     100version is created leaving two slightly incompatible libraries on your system.
     101It is recommended that you only install one version.</para></note>
     102                                                                               
     103</sect3>
     104                                                                               
     105</sect2>
     106
     107<sect2>
     108<title>Contents</title>
     109                                                                               
     110<para>The <application>Fontconfig</application> package contains the
     111<filename class='libraryfile'>libfontconfig</filename> library,
     112<command>fc-cache</command>, and <command>fc-list</command>.</para>
     113                                                                               
     114</sect2>
     115                                                                               
     116<sect2><title>Description</title>
     117                                                                               
     118<sect3><title>fc-cache</title>
     119<para><command>fc-cache</command> is a command to create font information
     120caches.</para></sect3>
     121                                                                               
     122<sect3><title>fc-list</title>
     123<para><command>fc-list</command> is a command to list fonts.</para></sect3>
     124                                                                               
     125</sect2>
    9126
    10127</sect1>
  • general/graphlib/freetype2.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY freetype2-download-http "http://prdownloads.sourceforge.net/freetype/freetype-&freetype2-version;.tar.bz2">
     8<!ENTITY freetype2-download-ftp " ">
     9<!ENTITY freetype2-size "954 KB">
     10<!ENTITY freetype2-buildsize "18 MB">
     11<!ENTITY freetype2-time "0.32 SBU">
     12
     13]>
     14
    115<sect1 id="freetype2" xreflabel="FreeType-&freetype2-version;">
    216<?dbhtml filename="freetype2.html"?>
    317<title>FreeType-&freetype2-version;</title>
    418
    5 &freetype2-intro;
    6 &freetype2-inst;
    7 &freetype2-desc;
     19<sect2>
     20<title>Introduction to <application>FreeType2</application></title>
     21                                                                               
     22<para>The <application>FreeType2</application> package contains a library to
     23allow applications to properly render
     24<application>TrueType</application> fonts.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&freetype2-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&freetype2-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &freetype2-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&freetype2-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&freetype2-time;</para></listitem></itemizedlist>
     37</sect3>
     38                                                                               
     39<sect3><title>Additional downloads</title>
     40<itemizedlist spacing='compact'>
     41<listitem><para>Recommended Patch: <ulink
     42url="&patch-root;/freetype-&freetype2-version;-bytecode-interpreter.patch"/></para></listitem>
     43</itemizedlist></sect3>
     44                                                                               
     45</sect2>
     46
     47<sect2>
     48<title>Installation of <application>FreeType2</application></title>
     49                                                                               
     50<para>Install <application>FreeType2</application> by running the following
     51commands:</para>
     52                                                                               
     53<screen><userinput><command>patch -Np1 -i ../freetype-&freetype2-version;-bytecode-interpreter.patch &amp;&amp;
     54./configure --prefix=/usr &amp;&amp;
     55make &amp;&amp;
     56make install</command></userinput></screen>
     57                                                                               
     58</sect2>
     59
     60<sect2>
     61<title>Contents</title>
     62                                                                               
     63<para>The <application>FreeType2</application> package contains
     64<filename class="libraryfile">
     65libfreetype</filename> libraries.</para>
     66</sect2>
     67                                                                               
     68<sect2><title>Description</title>
     69                                                                               
     70<sect3><title>FreeType2 libraries</title>
     71<para><application>FreeType2</application> libraries add
     72<application>TrueType</application> font
     73capabilities to <application>XFree86</application>.</para></sect3>
     74                                                                               
     75</sect2>
    876
    977</sect1>
  • general/graphlib/graphlib.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4 <!ENTITY % general-entities SYSTEM "../../general.ent">
     5 %general-entities;
     6]>
     7
    18<chapter id="general-graphlib">
    29<?dbhtml filename="graphlib.html"?>
     
    815other hand, will not require them.</para>
    916
    10 &libjpeg;
    11 &libpng;
    12 &libtiff;
    13 &libungif;
    14 &libmng;
    15 &lcms;
    16 &freetype2;
    17 &fontconfig;
    18 &imlib;
    19 &aalib;
    20 &SVGAlib;
    21 &DirectFB;
    22 &imlib2;
     17<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libjpeg.xml"/>
     18<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libpng.xml"/>
     19<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libtiff.xml"/>
     20<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libungif.xml"/>
     21<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="libmng.xml"/>
     22<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="lcms.xml"/>
     23<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="freetype2.xml"/>
     24<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="fontconfig.xml"/>
     25<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="imlib.xml"/>
     26<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="aalib.xml"/>
     27<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="svgalib.xml"/>
     28<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="directfb.xml"/>
     29<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="imlib2.xml"/>
    2330
    2431</chapter>
  • general/graphlib/imlib.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY imlib-download-http "http://ftp.gnome.org/pub/GNOME/sources/imlib/1.9/imlib-&imlib-version;.tar.bz2">
     8<!ENTITY imlib-download-ftp "ftp://ftp.gnome.org/pub/GNOME/sources/imlib/1.9/imlib-&imlib-version;.tar.bz2">
     9<!ENTITY imlib-size "580 KB">
     10<!ENTITY imlib-buildsize "16.4 MB">
     11<!ENTITY imlib-time "0.43 SBU">
     12
     13]>
     14
    115<sect1 id="imlib" xreflabel="Imlib-&imlib-version;">
    216<?dbhtml filename="imlib.html"?>
    317<title>Imlib-&imlib-version;</title>
    418
    5 &imlib-intro;
    6 &imlib-inst;
    7 &imlib-exp;
    8 &imlib-desc;
     19<sect2>
     20<title>Introduction to <application>Imlib</application></title>
     21                                                                               
     22<para>The <application>Imlib</application> package contains image libraries.
     23These are useful for loading, rendering and dithering a wide variety of image
     24data formats.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink
     29url="&imlib-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink
     31url="&imlib-download-ftp;"/></para></listitem>
     32<listitem><para>Download size: &imlib-size;</para></listitem>
     33<listitem><para>Estimated Disk space required:
     34&imlib-buildsize;</para></listitem>
     35<listitem><para>Estimated build time:
     36&imlib-time;</para></listitem></itemizedlist>
     37</sect3>
     38                                                                               
     39                                                                               
     40<sect3><title><application>Imlib</application> dependencies</title>
     41<sect4><title>Required</title>
     42<para>
     43<xref linkend="GTK"/> and
     44<xref linkend="libungif"/>
     45</para></sect4>
     46</sect3>
     47                                                                               
     48</sect2>
     49
     50<sect2>
     51<title>Installation of <application>Imlib</application></title>
     52                                                                               
     53<para>Install <application>Imlib</application> by running the following
     54commands:</para>
     55                                                                               
     56<screen><userinput><command>./configure --prefix=/usr --sysconfdir=/etc/imlib &amp;&amp;
     57make &amp;&amp;
     58make install</command></userinput></screen>
     59                                                                               
     60</sect2>
     61
     62<sect2>
     63<title>Command explanations</title>
     64                                                                               
     65<!--<para><userinput>CPPFLAGS=-w</userinput>: This disables gcc-&gcc-version;
     66warnings that confuse configure.</para>-->
     67                                                                               
     68<para><parameter>--sysconfdir=/etc/imlib</parameter>: This installs and
     69combines the configurations files into <filename class="directory">/etc</filename> instead
     70of <filename class="directory">/usr/etc</filename>.</para>
     71</sect2>
     72
     73<sect2>
     74<title>Contents</title>
     75                                                                               
     76<para>The <application>Imlib</application> package contains <filename>libimlib</filename> libraries.</para>
     77                                                                               
     78</sect2>
     79                                                                               
     80<sect2><title>Description</title>
     81                                                                               
     82<sect3><title>imlib libraries</title>
     83<para><filename>libimlib</filename> libraries provide the functions for
     84programs to display and edit a wide variety of image data formats.</para>
     85</sect3>
     86
     87</sect2>
    988
    1089</sect1>
  • general/graphlib/imlib2.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY imlib2-download-http "http://prdownloads.sourceforge.net/enlightenment/imlib2-&imlib2-version;.tar.gz">
     8<!ENTITY imlib2-download-ftp "ftp://ftp.tux.org/X-Windows/enlightenment/ftp/enlightenment/imlib2-&imlib2-version;.tar.gz">
     9<!ENTITY imlib2-size "796 KB">
     10<!ENTITY imlib2-buildsize "20 MB">
     11<!ENTITY imlib2-time "0.53 SBU">
     12
     13]>
     14
    115<sect1 id="imlib2" xreflabel="Imlib2-&imlib2-version;">
    216<?dbhtml filename="imlib2.html"?>
    317<title>Imlib2-&imlib2-version;</title>
    418
    5 &imlib2-intro;
    6 &imlib2-inst;
    7 &imlib2-desc;
     19<sect2>
     20<title>Introduction to <application>Imlib2</application></title>
     21                                                                               
     22<para><application>Imlib2</application> is a graphics library for fast file
     23loading, saving, rendering and manipulation.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&imlib2-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&imlib2-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &imlib2-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &imlib2-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &imlib2-time;</para></listitem></itemizedlist>
     32</sect3>
     33                                                                               
     34<sect3><title><application>Imlib2</application> dependencies</title>
     35<sect4><title>Required</title>
     36<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and <xref linkend="libjpeg"/>
     37</para></sect4>
     38<sect4><title>Optional</title>
     39<para><xref linkend="libtiff"/> and <xref
     40linkend="libungif"/>
     41</para></sect4>
     42</sect3>
     43                                                                               
     44</sect2>
     45
     46<sect2>
     47<title>Installation of <application>Imlib2</application></title>
     48                                                                               
     49<para>Install <application>Imlib2</application> by running the
     50following commands:</para>
     51                                                                               
     52<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     53make &amp;&amp;
     54make install</command></userinput></screen>
     55                                                                               
     56</sect2>
     57
     58<sect2>
     59<title>Contents</title>
     60                                                                               
     61<para>
     62This package contains <filename class="libraryfile">libImlib2</filename> library
     63as well as various filters and image loader libraries.
     64</para>
     65                                                                               
     66</sect2>
     67                                                                               
     68<sect2><title>Description</title>
     69                                                                               
     70<sect3><title>libImlib2</title>
     71<para><filename class="libraryfile">libImlib2</filename>
     72provides the functions for programs to deal with various image data formats.
     73</para></sect3>
     74                                                                               
     75</sect2>
    876
    977</sect1>
  • general/graphlib/lcms.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY lcms-download-http "http://www.littlecms.com/lcms-&lcms-version;.tar.gz">
     8<!ENTITY lcms-download-ftp " ">
     9<!ENTITY lcms-size "555 KB">
     10<!ENTITY lcms-buildsize "17 MB">
     11<!ENTITY lcms-time "0.32 SBU">
     12
     13]>
     14
    115<sect1 id="lcms" xreflabel="lcms-&lcms-version;">
    216<?dbhtml filename="lcms.html"?>
    317<title>lcms-&lcms-version;</title>
    418
    5 &lcms-intro;
    6 &lcms-inst;
    7 <!-- &lcms-exp; -->
    8 &lcms-desc;
     19<sect2>
     20<title>Introduction to <application>lcms</application></title>
     21                                                                               
     22<para>The lcms library is used by other programs to provide
     23color management facilities.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&lcms-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&lcms-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &lcms-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&lcms-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&lcms-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38<sect3><title><application>lcms</application> dependencies</title>
     39<sect4><title>Optional</title>
     40<para><xref linkend="libtiff"/>, <xref linkend="libjpeg"/>, <xref
     41linkend="Python"/> and <ulink
     42url="http://www.swig.org/">SWIG</ulink></para></sect4>
     43</sect3>
     44                                                                               
     45</sect2>
     46
     47<sect2>
     48<title>Installation of <application>lcms</application></title>
     49                                                                               
     50<para>Install <application>lcms</application> by running the following commands:</para>
     51                                                                               
     52<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
     53make &amp;&amp;
     54make install</command></userinput></screen>
     55
     56</sect2>
     57
     58<sect2>
     59<title>Contents</title>
     60                                                                               
     61<para>The lcms package contains the <filename class="libraryfile">liblcms</filename>
     62libraries, <command>icc2ps</command>, <command>icclink</command>,
     63<command>icctrans</command>, <command>wtpt</command> and optionally, <command>tifficc</command>,
     64<command>jpegicc</command> and <filename
     65class="libraryfile">lcms</filename> Python module.</para>
     66                                                                               
     67</sect2>
     68                                                                               
     69<sect2><title>Description</title>
     70                                                                               
     71<sect3><title>liblcms library</title>
     72<para>The <filename class="libraryfile">liblcms</filename> libraries are used by other programs to provide color
     73management facilities.</para></sect3>
     74                                                                               
     75<sect3><title>icc2ps</title>
     76<para><command>icc2ps</command> generates PostScript
     77<acronym>CRD</acronym> or <acronym>CSA</acronym> from
     78<acronym>ICC</acronym> profiles.</para></sect3>
     79                                                                               
     80<sect3><title>icclink</title>
     81<para><command>icclink</command> links two or more profiles into a
     82single device link profile.</para></sect3>
     83                                                                               
     84<sect3><title>icctrans</title>
     85<para><command>icctrans</command> is a Color Space conversion
     86calculator.</para></sect3>
     87                                                                               
     88<sect3><title>tifficc</title>
     89<para><command>tifficc</command> is an <acronym>ICC</acronym> profile
     90applier for <acronym>TIFF</acronym> files.</para></sect3>
     91                                                                               
     92<sect3><title>jpegicc</title>
     93<para><command>jpegicc</command> is an <acronym>ICC</acronym> profile
     94applier for <acronym>JPEG</acronym> files.</para></sect3>
     95                                                                               
     96</sect2>
    997
    1098</sect1>
  • general/graphlib/libjpeg.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libjpeg-download-http "http://www.ijg.org/files/jpegsrc.v&libjpeg-version;.tar.gz">
     8<!ENTITY libjpeg-download-ftp "ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v&libjpeg-version;.tar.gz">
     9<!ENTITY libjpeg-size "599 KB">
     10<!ENTITY libjpeg-buildsize "3.7 MB">
     11<!ENTITY libjpeg-time "0.26 SBU">
     12
     13]>
     14
    115<sect1 id="libjpeg" xreflabel="libjpeg-&libjpeg-version;">
    216<?dbhtml filename="libjpeg.html"?>
    317<title>libjpeg-&libjpeg-version;</title>
    418
    5 &libjpeg-intro;
    6 &libjpeg-inst;
    7 &libjpeg-exp;
    8 &libjpeg-config;
    9 &libjpeg-desc;
     19<sect2>
     20<title>Introduction to <application>libjpeg</application></title>
     21                                                                               
     22<para>The <application>libjpeg</application> package contains libraries
     23that allow compression of image files based on the Joint Photographic Experts
     24Group standard. It is a "lossy" compression algorithm.</para>
     25                                                                               
     26<sect3><title>Package information</title>
     27<itemizedlist spacing='compact'>
     28<listitem><para>Download (HTTP): <ulink url="&libjpeg-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink url="&libjpeg-download-ftp;"/></para></listitem>
     30<listitem><para>Download size: &libjpeg-size;</para></listitem>
     31<listitem><para>Estimated Disk space required: &libjpeg-buildsize;</para></listitem>
     32<listitem><para>Estimated build time: &libjpeg-time;</para></listitem></itemizedlist>
     33</sect3>
     34                                                                               
     35</sect2>
     36
     37<sect2>
     38<title>Installation of <application>libjpeg</application></title>
     39                                                                               
     40<para>Install <application>libjpeg</application> by running the following commands:</para>
     41                                                                               
     42<screen><userinput><command>./configure --enable-static --enable-shared --prefix=/usr &amp;&amp;
     43make &amp;&amp;
     44make install</command></userinput></screen>
     45                                                                               
     46</sect2>
     47
     48<sect2>
     49<title>Command explanations</title>
     50                                                                               
     51<para><command>./configure --enable-static --enable-shared --prefix=/usr</command>: This command tells libjpeg to build both shared and static libraries and
     52to install them with a base of <filename>/usr</filename>.</para>
     53                                                                               
     54</sect2>
     55
     56<sect2>
     57<title>Configuring <application>libjpeg</application></title>
     58                                                                               
     59<sect3><title>Configuration Information</title>
     60                                                                               
     61<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
     62                                                                               
     63</sect3>
     64                                                                               
     65</sect2>
     66
     67<sect2>
     68<title>Contents</title>
     69                                                                               
     70<para>The libjpeg package contains <command>cjpeg</command>,
     71<command>djpeg</command>, <command>jpegtran</command>,
     72<command>rdjpgcom</command>, <command>wrjpgcom</command> and
     73<filename>libjpeg</filename> libraries.</para>
     74                                                                               
     75</sect2>
     76                                                                               
     77<sect2><title>Description</title>
     78                                                                               
     79<sect3><title>cjpeg</title>
     80<para><command>cjpeg</command> compresses image files to produce a
     81<acronym>JPEG</acronym>/<acronym>JFIF</acronym> file on the standard
     82output.  Currently supported input file formats are:
     83<acronym>PPM</acronym> (PBMPLUS color
     84format), <acronym>PGM</acronym> (PBMPLUS gray-scale
     85format), <acronym>BMP</acronym>, and Targa.</para></sect3>
     86                                                                               
     87<sect3><title>djpeg</title>
     88<para><command>djpeg</command> decompresses image files from
     89<acronym>JPEG/JFIF</acronym> format to either <acronym>PPM</acronym>
     90(PBMPLUS color format), <acronym>PGM</acronym> (PBMPLUS gray-scale
     91format), <acronym>BMP</acronym>, or Targa
     92format.</para></sect3>
     93                                                                               
     94<sect3><title>jpegtran</title>
     95<para><command>jpegtran</command> is used for lossless transformation of
     96<acronym>JPEG</acronym> files.</para></sect3>
     97                                                                               
     98<sect3><title>rdjpgcom</title>
     99<para><command>rdjpgcom</command> displays text comments from within a
     100<acronym>JPEG</acronym> file.</para></sect3>
     101                                                                               
     102<sect3><title>wrjpgcom</title>
     103<para><command>wrjpgcom</command> inserts text comments into a
     104<acronym>JPEG</acronym> file.</para></sect3>
     105                                                                               
     106<sect3><title>jpeg libraries</title>
     107<para>These libraries are used by many programs for reading and writing
     108jpeg format files.</para></sect3>
     109                                                                               
     110</sect2>
    10111
    11112</sect1>
  • general/graphlib/libmng.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libmng-download-http "http://prdownloads.sourceforge.net/libmng/libmng-&libmng-version;.tar.gz">
     8<!ENTITY libmng-download-ftp " ">
     9<!ENTITY libmng-size "492 KB">
     10<!ENTITY libmng-buildsize "13.7 MB">
     11<!ENTITY libmng-time "0.41 SBU">
     12
     13]>
     14
    115<sect1 id="libmng" xreflabel="libmng-&libmng-version;">
    216<?dbhtml filename="libmng.html"?>
    317<title>libmng-&libmng-version;</title>
    418
    5 &libmng-intro;
    6 &libmng-inst;
    7 &libmng-exp;
    8 &libmng-desc;
     19<sect2>
     20<title>Introduction to <application>libmng</application></title>
     21                                                                               
     22<para>The <application>libmng</application> libraries are used by programs
     23wanting to read and write Multiple-image Network Graphics (<acronym>MNG</acronym>)
     24files which are the animation
     25equivalents to <acronym>PNG</acronym> files.</para>
     26                                                                               
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink
     30url="&libmng-download-http;"/></para></listitem>
     31<listitem><para>Download (FTP): <ulink
     32url="&libmng-download-ftp;"/></para></listitem>
     33<listitem><para>Download size: &libmng-size;</para></listitem>
     34<listitem><para>Estimated Disk space required:
     35&libmng-buildsize;</para></listitem>
     36<listitem><para>Estimated build time:
     37&libmng-time;</para></listitem></itemizedlist>
     38</sect3>
     39                                                                               
     40                                                                               
     41<sect3><title><application>libmng</application> dependencies</title>
     42<sect4><title>Required</title>
     43<para><xref linkend="libjpeg"/> and <xref linkend="lcms"/></para></sect4>
     44</sect3>
     45                                                                               
     46</sect2>
     47
     48<sect2>
     49<title>Installation of <application>libmng</application></title>
     50                                                                               
     51<para>Install <application>libmng</application> by running the following
     52commands:</para>
     53                                                                               
     54<screen><userinput><command>./autogen.sh &amp;&amp;
     55./configure --prefix=/usr &amp;&amp;
     56make &amp;&amp;
     57make install &amp;&amp;
     58cp doc/man/*.3 /usr/share/man/man3 &amp;&amp;
     59cp doc/man/*.5 /usr/share/man/man5</command></userinput></screen>
     60                                                                               
     61</sect2>
     62
     63<sect2>
     64<title>Command explanations</title>
     65                                                                               
     66<para><command>./autogen.sh</command>: This package does not ship
     67with the configure script. The autotool files need to be generated
     68before configuring the package.</para>
     69                                                                               
     70<para><command>cp doc/man/*.X /usr/share/man/manX</command>: The
     71install procedure doesn't properly install the man pages so we do it
     72manually.</para>
     73                                                                               
     74</sect2>
     75
     76<sect2>
     77<title>Contents</title>
     78                                                                               
     79<para>The <application>libmng</application> package contains <filename>libmng
     80</filename> libraries.</para>
     81                                                                               
     82</sect2>
     83                                                                               
     84<sect2><title>Description</title>
     85                                                                               
     86<sect3><title>MNG libraries</title>
     87<para><filename>libmng</filename> provides functions for programs wishing to
     88read and write <acronym>MNG</acronym> files which are animation files without
     89the patent problems associated with certain other formats.</para></sect3>
     90                                                                               
     91</sect2>
    992
    1093</sect1>
  • general/graphlib/libpng.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libpng-download-http "http://prdownloads.sourceforge.net/libpng/libpng-&libpng-version;.tar.bz2">
     8<!ENTITY libpng-download-ftp "ftp://ftp.iasi.roedu.net/pub/mirrors/ftp.gimp.org/gimp/libs/libpng-&libpng-version;.tar.bz2">
     9<!ENTITY libpng-size "376 KB">
     10<!ENTITY libpng-buildsize "4.1 MB">
     11<!ENTITY libpng-time "0.16 SBU">
     12
     13]>
     14
    115<sect1 id="libpng" xreflabel="libpng-&libpng-version;">
    216<?dbhtml filename="libpng.html"?>
    317<title>libpng-&libpng-version;</title>
    418
    5 &libpng-intro;
    6 &libpng-inst;
    7 &libpng-exp;
    8 &libpng-config;
    9 &libpng-desc;
     19<sect2>
     20<title>Introduction to <application>libpng</application></title>
     21                                                                               
     22<para>The <application>libpng</application> package contains libraries used
     23by other programs for reading and writing <acronym>PNG</acronym> files.</para>
     24                                                                               
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink
     28url="&libpng-download-http;"/></para></listitem>
     29<listitem><para>Download (FTP): <ulink
     30url="&libpng-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &libpng-size;</para></listitem>
     32<listitem><para>Estimated Disk space required:
     33&libpng-buildsize;</para></listitem>
     34<listitem><para>Estimated build time:
     35&libpng-time;</para></listitem></itemizedlist>
     36</sect3>
     37                                                                               
     38<sect3><title>Additional downloads</title>
     39<itemizedlist spacing='compact'>
     40<listitem><para>Required Patch to explicitly link libpng against system libraries: <ulink
     41url="&patch-root;/libpng-&libpng-version;-link-to-proper-libs.patch"/></para></listitem>
     42</itemizedlist></sect3>
     43                                                                               
     44</sect2>
     45
     46<sect2>
     47<title>Installation of <application>libpng</application></title>
     48                                                                               
     49<para>Install <application>libpng</application> by running the following commands:</para>
     50                                                                               
     51<screen><userinput><command>patch -Np1 -i ../libpng-&libpng-version;-link-to-proper-libs.patch &amp;&amp;
     52make prefix=/usr ZLIBINC=/usr/include \
     53    ZLIBLIB=/usr/lib -f scripts/makefile.linux &amp;&amp;
     54make prefix=/usr install -f scripts/makefile.linux</command></userinput></screen>
     55                                                                               
     56</sect2>
     57
     58<sect2>
     59<title>Command explanations</title>
     60                                                                             
     61<para><parameter>ZLIBINC=/usr/include ZLIBLIB=/usr/lib</parameter>: This
     62forces <application>libpng</application> to look for the
     63<application>zlib</application> includes and libraries where we have them installed.</para>
     64                                                                             
     65<para><parameter>-f scripts/makefile.linux</parameter>: This points make at the
     66Linux version of the makefile as <application>libpng</application> doesn't use
     67an autoconf routine. Instead it has various makefiles for different
     68platforms.</para>
     69
     70</sect2>
     71
     72<sect2>
     73<title>Configuring <application>libpng</application></title>
     74                                                                               
     75<sect3><title>Configuration Information</title>
     76                                                                               
     77<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/> 
     78                                                                               
     79</sect3>
     80                                                                               
     81</sect2>
     82
     83<sect2>
     84<title>Contents</title>
     85                                                                               
     86<para>The <application>libpng</application> package contains <filename class="libraryfile">
     87libpng</filename> libraries and <command>libpng-config</command>.</para>
     88                                                                               
     89</sect2>
     90                                                                               
     91<sect2><title>Description</title>
     92                                                                               
     93<sect3><title>png libraries</title>
     94<para>The <acronym>PNG</acronym> library is a collection of routines used to
     95create and manipulate <acronym>PNG</acronym> format graphics files. The
     96<acronym>PNG</acronym> format was designed as a
     97replacement for <acronym>GIF</acronym> and, to a lesser extent,
     98<acronym>TIFF</acronym>, with many improvements and extensions and lack of
     99patent problems.</para></sect3>
     100                                                                               
     101<sect3><title>libpng-config</title>
     102<para><command>libpng-config</command> provides configuration info for
     103<application>libpng</application>.</para></sect3>
     104                                                                               
     105</sect2>
    10106
    11107</sect1>
  • general/graphlib/libtiff.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libtiff-download-http "http://libtiff.maptools.org/dl/tiff-v&libtiff-version;.tar.gz">
     8<!ENTITY libtiff-download-ftp " ">
     9<!ENTITY libtiff-size "1.1 MB">
     10<!ENTITY libtiff-buildsize "11 MB">
     11<!ENTITY libtiff-time "0.16 SBU">
     12
     13]>
     14
    115<sect1 id="libtiff" xreflabel="libtiff-&libtiff-version;">
    216<?dbhtml filename="libtiff.html"?>
    317<title>libtiff-&libtiff-version;</title>
    418
    5 &libtiff-intro;
    6 &libtiff-inst;
    7 &libtiff-exp;
    8 &libtiff-config;
    9 &libtiff-desc;
     19<sect2>
     20<title>Introduction to <application>libtiff</application></title>
     21                                                                               
     22<para>The <application>libtiff</application> package contains the tiff libraries and associated
     23utilities.  The libraries are used by many programs for reading and
     24writing tiff files and the utilities are useful for general work with
     25tiff files.</para>
     26                                                                               
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink url="&libtiff-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink url="&libtiff-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &libtiff-size;</para></listitem>
     32<listitem><para>Estimated Disk space required: &libtiff-buildsize;</para></listitem>
     33<listitem><para>Estimated build time: &libtiff-time;</para></listitem></itemizedlist>
     34</sect3>
     35                                                                               
     36<sect3><title><application>libtiff</application> dependencies</title>
     37<sect4><title>Optional</title>
     38<para><xref linkend="libjpeg"/>
     39</para></sect4>
     40</sect3>
     41                                                                               
     42</sect2>
     43
     44<sect2>
     45<title>Installation of <application>libtiff</application></title>
     46                                                                               
     47<para>Install <application>libtiff</application> by running the following commands:</para>
     48                                                                               
     49<screen><userinput><command>./configure --prefix=/usr --noninteractive \
     50    --with-DIR_MAN=/usr/share/man \
     51    --with-ZIP=yes --with-DIR_GZLIB=/usr/lib &amp;&amp;
     52make &amp;&amp;
     53make install</command></userinput></screen>
     54                                                                               
     55<note><para>configure prints false error messages that it is unable to find thelibrary directories for ZIP (and JPEG) support. Ignore them. To verify that
     56<filename>libtiff</filename> is indeed linked to these libraries, use the
     57<command>ldd</command> command.</para></note>
     58                                                                               
     59</sect2>
     60
     61<sect2>
     62<title>Command explanations</title>
     63                                                                               
     64<para><option>--noninteractive</option>: This switch is used to
     65avoid the configuration routine asking for confirmation of the
     66installation directories (which we pass to configure).</para>
     67                                                                               
     68<para><parameter>--with-DIR_MAN=/usr/share/man</parameter>: This is used
     69because despite the fact we pass <parameter>--prefix=/usr</parameter>, the
     70configure routine tries to install the man pages in <filename
     71class="directory">/usr/local/man</filename> instead of the correct
     72place.</para>
     73                                                                               
     74<para><parameter>--with-ZIP=yes --with-DIR_GZLIB=/usr/lib</parameter>: This
     75enables support for the handling of <acronym>TIFF</acronym> images with
     76deflate-encoded data.</para>
     77                                                                               
     78<para><parameter>--with-JPEG=yes --with-DIR_JPEGLIB=/usr/lib</parameter>: Use
     79these switches to enable support for the handling of <acronym>TIFF</acronym>
     80images with <acronym>JPEG</acronym>-encoded data.</para>
     81                                                                               
     82</sect2>
     83
     84<sect2>
     85<title>Configuring <application>libtiff</application></title>
     86                                                                               
     87<sect3><title>Configuration Information</title>
     88                                                                               
     89<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>
     90                                                                               
     91</sect3>
     92                                                                               
     93</sect2>
     94
     95<sect2>
     96<title>Contents</title>
     97                                                                               
     98<para>The libtiff package contains
     99<command>fax2ps</command>,
     100<command>fax2tiff</command>,
     101<command>gif2tiff</command>,
     102<command>pal2rgb</command>,
     103<command>ppm2tiff</command>,
     104<command>ras2tiff</command>,
     105<command>raw2tiff</command>,
     106<command>rgb2ycbcr</command>,
     107<command>thumbnail</command>,
     108<command>tiff2bw</command>,
     109<command>tiff2pdf</command>,
     110<command>tiff2ps</command>,
     111<command>tiff2rgba</command>,
     112<command>tiffcmp</command>,
     113<command>tiffcp</command>,
     114<command>tiffdither</command>,
     115<command>tiffdump</command>,
     116<command>tiffinfo</command>,
     117<command>tiffmedian</command>,
     118<command>tiffset</command>,
     119<command>tiffsplit</command> and
     120<filename class="libraryfile">libtiff</filename> libraries.</para>
     121                                                                               
     122</sect2>
     123                                                                               
     124<sect2><title>Description</title>
     125                                                                               
     126<sect3><title>fax2ps</title>
     127<para><command>fac2ps</command> converts a <acronym>TIFF</acronym>
     128facsimile to compressed PostScript file.</para></sect3>
     129                                                                               
     130<sect3><title>fax2tiff</title>
     131<para><command>fax2tiff</command> creates a <acronym>TIFF</acronym>
     132Class F fax file from raw fax data.</para></sect3>
     133                                                                               
     134<sect3><title>gif2tiff</title>
     135<para><command>gif2tiff</command> creates a <acronym>TIFF</acronym> file
     136from a <acronym>GIF87</acronym> format image file.</para></sect3>
     137                                                                               
     138<sect3><title>pal2rgb</title>
     139<para><command>pal2rgb</command> converts a palette color
     140<acronym>TIFF</acronym> image to a full color image.</para></sect3>
     141                                                                               
     142<sect3><title>ppm2tiff</title>
     143<para><command>ppm2tiff</command> creates a <acronym>TIFF</acronym> file
     144from a <acronym>PPM</acronym> image file.</para></sect3>
     145                                                                               
     146<sect3><title>ras2tiff</title>
     147<para><command>ras2tiff</command> creates a <acronym>TIFF</acronym> file
     148from a Sun rasterfile.</para></sect3>
     149                                                                               
     150<sect3><title>raw2tiff</title>
     151<para><command>raw2tiff</command> converts a raw byte sequence into
     152<acronym>TIFF</acronym>.</para></sect3>
     153                                                                               
     154<sect3><title>rgb2ycbcr</title>
     155<para><command>rgb2ycbcr</command> converts non-YCbCr
     156<acronym>TIFF</acronym> images to a YCbCr <acronym>TIFF</acronym>
     157image.</para></sect3>
     158                                                                               
     159<sect3><title>thumbnail</title>
     160<para><command>thumbnail</command> creates a <acronym>TIFF</acronym>
     161file with thumbnail images.</para></sect3>
     162                                                                               
     163<sect3><title>tiff2bw</title>
     164<para><command>tiff2bw</command> converts a color
     165<acronym>TIFF</acronym> image to grayscale.</para></sect3>
     166                                                                               
     167<sect3><title>tiff2pdf</title>
     168<para><command>tiff2pdf</command> converts a <acronym>TIFF</acronym>
     169image to a <acronym>PDF</acronym> document.</para></sect3>
     170                                                                               
     171<sect3><title>tiff2ps</title>
     172<para><command>tiff2ps</command> converts a <acronym>TIFF</acronym>
     173image to a PostScript file.</para></sect3>
     174                                                                               
     175<sect3><title>tiff2rgba</title>
     176<para><command>tiff2rgba</command> converts a wide variety of
     177<acronym>TIFF</acronym> images into an <acronym>RGBA</acronym>
     178<acronym>TIFF</acronym> image.</para></sect3>
     179                                                                               
     180<sect3><title>tiffcmp</title>
     181<para><command>tiffcmp</command> compares two <acronym>TIFF</acronym>
     182files.</para></sect3>
     183                                                                               
     184<sect3><title>tiffcp</title>
     185<para><command>tiffcp</command> copies (and possibly converts) a
     186<acronym>TIFF</acronym> file.</para></sect3>
     187                                                                               
     188<sect3><title>tiffdither</title>
     189<para><command>tiffdither</command> converts a grayscale image to
     190bilevel using dithering.</para></sect3>
     191                                                                               
     192<sect3><title>tiffdump</title>
     193<para><command>tiffdump</command> prints verbatim information about
     194<acronym>TIFF</acronym> files.</para></sect3>
     195                                                                               
     196<sect3><title>tiffinfo</title>
     197<para><command>tiffinfo</command> prints information about
     198<acronym>TIFF</acronym> files.</para></sect3>
     199                                                                               
     200<sect3><title>tiffmedian</title>
     201<para><command>tiffmedian</command> applies the median cut algorithm to
     202data in a <acronym>TIFF</acronym> file.</para></sect3>
     203                                                                               
     204<sect3><title>tiffsplit</title>
     205<para><command>tiffsplit</command> splits a multi-image
     206<acronym>TIFF</acronym> into single-image <acronym>TIFF</acronym>
     207files.</para></sect3>
     208                                                                               
     209<sect3><title>tiff libraries</title>
     210<para>The tiff libraries are used by many programs to read and write
     211tiff files.</para></sect3>
     212                                                                               
     213</sect2>
    10214
    11215</sect1>
  • general/graphlib/libungif.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY libungif-download-http "http://ftp.sunfreeware.com/ftp/pub/freeware/SOURCES/libungif-&libungif-version;.tar.gz">
     8<!ENTITY libungif-download-ftp "ftp://sunfreeware.secsup.org/pub/solaris/freeware/SOURCES/libungif-&libungif-version;.tar.gz">
     9<!ENTITY libungif-size "343 KB">
     10<!ENTITY libungif-buildsize "3.1 MB">
     11<!ENTITY libungif-time "0.11 SBU">
     12
     13]>
     14
    115<sect1 id="libungif" xreflabel="libungif-&libungif-version;">
    216<?dbhtml filename="libungif.html"?>
    317<title>libungif-&libungif-version;</title>
    418
    5 &libungif-intro;
    6 &libungif-inst;
    7 &libungif-desc;
     19<sect2>
     20<title>Introduction to <application>libungif</application></title>
     21                                                                               
     22<para>The libungif package contains libraries for reading all
     23<acronym>GIF</acronym>s and writing non-compressed ones as well as programs for                                                                               
     24converting and working with <acronym>GIF</acronym> files.  The libraries are
     25useful for any graphics program wishing to deal with <acronym>GIF</acronym>
     26files while the programs are useful for conversion purposes as well as cleaning                                                                               
     27up images.</para>
     28                                                                               
     29<para>The reason libungif only writes non-compressed <acronym>GIF</acronym>s
     30is due to a legal issue with <acronym>LZW</acronym> compression (which Unisys
     31claims a patent on). Reading <acronym>GIF</acronym>s is not a problem as the
     32decompression routines do not seem to be limited in this way.  Note that this
     33has in the past been disputed.  The best way to avoid this whole mess is to
     34simply use libungif for looking at <acronym>GIF</acronym> images on the web,
     35while in any pages which you design, use the open source <acronym>PNG</acronym>                                                                               
     36format instead (which uses, not surprisingly, the libpng library) which has no
     37patent issues at all.</para>
     38                                                                               
     39<sect3><title>Package information</title>
     40<itemizedlist spacing='compact'>
     41<listitem><para>Download (HTTP): <ulink url="&libungif-download-http;"/></para></listitem>
     42<listitem><para>Download (FTP): <ulink url="&libungif-download-ftp;"/></para></listitem>
     43<listitem><para>Download size: &libungif-size;</para></listitem>
     44<listitem><para>Estimated Disk space required: &libungif-buildsize;</para></listitem>
     45<listitem><para>Estimated build time: &libungif-time;</para></listitem></itemizedlist>
     46</sect3>
     47                                                                               
     48<sect3><title>Additional downloads</title>
     49<itemizedlist spacing='compact'>
     50<listitem><para>Required patch: <ulink
     51url="&patch-root;/libungif-4.1.0b1-va_start.patch"/></para></listitem>
     52</itemizedlist>
     53</sect3>
     54                                                                               
     55</sect2>
     56
     57<sect2>
     58<title>Installation of <application>libungif</application></title>
     59                                                                               
     60<para>Install <application>libungif</application> by running the following
     61commands:</para>
     62                                                                               
     63<screen><userinput><command>patch -Np1 -i ../libungif-4.1.0b1-va_start.patch &amp;&amp;
     64./configure --prefix=/usr &amp;&amp;
     65make &amp;&amp;
     66make install</command></userinput></screen>
     67                                                                               
     68<!--
     69<note><para>If you get an error during the make portion compiling
     70<filename>lib/qprintf.c</filename>,
     71edit the file and comment out or remove line 14: #include &lt;config.h&gt;
     72</para></note>
     73-->
     74                                                                               
     75</sect2>
     76
     77<sect2>
     78<title>Contents</title>
     79                                                                               
     80<para>The libungif package contains <command>gif2epsn</command>,
     81<command>gif2ps</command>, <command>gif2rgb</command>,
     82<command>gifasm</command>, <command>gifbg</command>,
     83<command>gifburst</command>, <command>gifclip</command>,
     84<command>gifclrmp</command>, <command>gifcolor</command>,
     85<command>gifcomb</command>, <command>gifcompose</command>,
     86<command>giffiltr</command>, <command>giffix</command>,
     87<command>gifflip</command>, <command>gifhisto</command>,
     88<command>gifinfo</command>, <command>gifinter</command>,
     89<command>gifinto</command>, <command>gifovly</command>,
     90<command>gifpos</command>, <command>gifrotat</command>,
     91<command>gifrsize</command>, <command>gifspnge</command>,
     92<command>giftext</command>, <command>gifwedge</command>,
     93<command>icon2gif</command>, <command>raw2gif</command>,
     94<command>rgb2gif</command>, <command>text2gif</command> and
     95<filename>libungif</filename> libraries.</para>
     96                                                                               
     97</sect2>
     98                                                                               
     99<sect2><title>Description</title>
     100                                                                               
     101<sect3><title>gif2epsn</title>
     102<para>Dumps images saved as <acronym>GIF</acronym> files on Epson type printers.</para></sect3>
     103                                                                               
     104<sect3><title>gif2ps</title>
     105<para>Print <acronym>GIF</acronym> files on laser printers supporting PostScript.
     106</para></sect3>
     107                                                                               
     108<sect3><title>gif2rgb</title>
     109<para>Convert images saved as <acronym>GIF</acronym> to 24-bit <acronym>RGB
     110</acronym> image(s).</para></sect3>
     111                                                                               
     112<sect3><title>gifasm</title>
     113<para>Assemble multiple <acronym>GIF</acronym>s into one, or burst a
     114multiple-image <acronym>GIF</acronym>.</para></sect3>
     115                                                                               
     116<sect3><title>gifbg</title>
     117<para>Generate a single-color test pattern <acronym>GIF</acronym>.</para>
     118</sect3>
     119                                                                               
     120<sect3><title>gifburst</title>
     121<para>Burst a <acronym>GIF</acronym> image into subrectangles.</para></sect3>
     122                                                                               
     123<sect3><title>gifclip</title>
     124<para>Clip or crop a <acronym>GIF</acronym> image.</para></sect3>
     125                                                                               
     126<sect3><title>gifclrmp</title>
     127<para>Modify <acronym>GIF</acronym> image colormaps.</para></sect3>
     128                                                                               
     129<sect3><title>gifcolor</title>
     130<para>Generate color test patterns.</para></sect3>
     131                                                                               
     132<sect3><title>gifcomb</title>
     133<para>Combine 2 <acronym>GIF</acronym> images of exactly the same size into one.
     134</para></sect3>
     135                                                                               
     136<sect3><title>gifcompose</title>
     137<para>Use (un)giflib tools to compose images.</para></sect3>
     138                                                                               
     139<sect3><title>giffiltr</title>
     140<para>Template code for filtering a <acronym>GIF</acronym> sequentially.</para></sect3>
     141                                                                               
     142<sect3><title>giffix</title>
     143<para>Clumsily attempts to fix truncated <acronym>GIF</acronym> images.</para>
     144</sect3>
     145
     146<sect3><title>gifflip</title>
     147<para>Flip <acronym>GIF</acronym> image along X or Y axis or rotate by 90
     148degrees.</para></sect3>
     149                                                                               
     150<sect3><title>gifhisto</title>
     151<para>Generate color-frequency histogram from a <acronym>GIF</acronym>.</para>
     152</sect3>
     153                                                                               
     154<sect3><title>gifinfo</title>
     155<para>Gives information on a <acronym>GIF</acronym> file.</para></sect3>
     156                                                                               
     157<sect3><title>gifinter</title>
     158<para>Convert between interlaced and non-interlaced images.</para></sect3>
     159                                                                               
     160<sect3><title>gifinto</title>
     161<para>End-of-pipe fitting for <acronym>GIF</acronym>-processing pipelines.</para></sect3>
     162                                                                               
     163<sect3><title>gifovly</title>
     164<para>Generate one composite <acronym>GIF</acronym> from a multiple-image
     165<acronym>GIF</acronym>.</para></sect3>
     166                                                                               
     167<sect3><title>gifpos</title>
     168<para>Change a GIF's screen size or recondition it.</para></sect3>
     169                                                                               
     170<sect3><title>gifrotat</title>
     171<para>Rotate a <acronym>GIF</acronym> through any desired angle.</para></sect3>                                                                               
     172<sect3><title>gifrsize</title>
     173<para>Resize a <acronym>GIF</acronym> by deletion or duplication of bits.</para>
     174</sect3>
     175                                                                               
     176<sect3><title>gifspnge</title>
     177<para>Template code for filtering a <acronym>GIF</acronym> with in-core
     178operations.</para></sect3>
     179                                                                               
     180<sect3><title>giftext</title>
     181<para>Print (text only) general information about a <acronym>GIF</acronym>.
     182</para></sect3>
     183                                                                               
     184<sect3><title>gifwedge</title>
     185<para>Create a test <acronym>GIF</acronym> image resembling a color monitor
     186test pattern.</para></sect3>
     187                                                                               
     188<sect3><title>icon2gif</title>
     189<para>Converter/deconverter to/from an editable text format.</para></sect3>
     190                                                                               
     191<sect3><title>raw2gif</title>
     192<para>Convert raw 8-bit image data into <acronym>GIF</acronym> files.</para>
     193</sect3>
     194                                                                               
     195<sect3><title>rgb2gif</title>
     196<para>Convert 24 bit images to a <acronym>GIF</acronym> image using color
     197quantization.</para></sect3>
     198                                                                               
     199<sect3><title>text2gif</title>
     200<para>Generate <acronym>GIF</acronym> images out of regular text in 8x8 font.
     201</para></sect3>
     202                                                                               
     203</sect2>
    8204
    9205</sect1>
  • general/graphlib/svgalib.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7<!ENTITY SVGAlib-download-http "http://www.svgalib.org/svgalib-&SVGAlib-version;.tar.gz">
     8<!ENTITY SVGAlib-download-ftp " ">
     9<!ENTITY SVGAlib-size "827 KB">
     10<!ENTITY SVGAlib-buildsize "9.7 MB">
     11<!ENTITY SVGAlib-time "0.20 SBU">
     12
     13]>
     14
    115<sect1 id="SVGAlib" xreflabel="SVGAlib-&SVGAlib-version;">
    216<?dbhtml filename="SVGAlib.html"?>
    317<title>SVGAlib-&SVGAlib-version;</title>
    418
    5 &SVGAlib-intro;
    6 &SVGAlib-inst;
    7 &SVGAlib-exp;
    8 &SVGAlib-config;
    9 &SVGAlib-desc;
     19<sect2>
     20<title>Introduction to <application>SVGAlib</application></title>
     21                                                                               
     22<para><application>SVGAlib</application> is a low-level graphics library
     23that provides <acronym>VGA</acronym> and <acronym>SVGA</acronym>
     24modes in a console. This is useful for programs running on a console
     25that require graphics capabilities.</para>
     26                                                                               
     27<sect3><title>Package information</title>
     28<itemizedlist spacing='compact'>
     29<listitem><para>Download (HTTP): <ulink url="&SVGAlib-download-http;"/></para></listitem>
     30<listitem><para>Download (FTP): <ulink url="&SVGAlib-download-ftp;"/></para></listitem>
     31<listitem><para>Download size: &SVGAlib-size;</para></listitem>
     32<listitem><para>Estimated Disk space required: &SVGAlib-buildsize;</para></listitem>
     33<listitem><para>Estimated build time: &SVGAlib-time;</para></listitem></itemizedlist>
     34</sect3>
     35<sect3><title>Additional downloads</title>
     36<itemizedlist spacing='compact'>
     37<listitem><para>Download (HTTP): <ulink url="&patch-root;/svgalib-1.4.3-gcc3-1.patch"/></para></listitem>
     38</itemizedlist></sect3>
     39                                                                               
     40</sect2>
     41
     42<sect2>
     43<title>Installation of <application>SVGAlib</application></title>
     44                                                                               
     45<note><para>You must compile and install as root. If you don't, certain tools
     46won't be able to become <acronym>SUID</acronym> root which is required for
     47proper operation. However, this raises a risk of exposing your system to any
     48holes in those tools that might be used to gain root access, so use with
     49caution.</para></note>
     50                                                                               
     51<para>Install <application>SVGAlib</application> by running the following commands:</para>
     52                                                                               
     53<screen><userinput><command>patch -Np1 -i ../svgalib-1.4.3-gcc3-1.patch &amp;&amp;
     54make prefix=/usr install &amp;&amp;
     55cd doc &amp;&amp;
     56for dir in man?; do for file in $dir/*; do \
     57gunzip /usr/share/man/$file; done; done</command></userinput></screen>
     58                                                                               
     59</sect2>
     60
     61<sect2>
     62<title>Command explanations</title>
     63                                                                               
     64<para><command>cd doc &amp;&amp; for dir in man?; do for file in $dir/*; do
     65gunzip /usr/share/man/$file; done; done</command>:
     66<application>SVGAlib</application> installs its man pages in compressed format
     67so we uncompress them.</para>
     68                                                                               
     69</sect2>
     70
     71<sect2>
     72<title>Configuring SVGAlib</title>
     73                                                                               
     74<sect3><title>Config files</title>
     75                                                                               
     76<para><filename>/etc/vga/libvga.config</filename>, <filename>~/.svgalibrc</filename></para>
     77</sect3>
     78                                                                               
     79<sect3><title>Configuration information</title>
     80                                                                               
     81<para>You must edit the config file to set the monitor and mouse type.
     82Depending on your hardware, other setup might be required.</para>
     83                                                                               
     84<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/>   
     85                                                                               
     86</sect3>
     87                                                                               
     88</sect2>
     89
     90<sect2>
     91<title>Contents</title>
     92                                                                               
     93<para>The SVGAlib package contains <filename class="libraryfile">libvga</filename>
     94and <filename class="libraryfile">libvgagl</filename> libraries,
     95<command>dumpreg</command>, <command>mode3</command>, <command>restorefont</command>,
     96<command>restorepalette</command>, <command>restoretextmode</command>,
     97<command>savetextmode</command>, <command>textmode</command> and
     98<command>svgakeymap</command>.</para>
     99                                                                               
     100</sect2>
     101                                                                               
     102<sect2><title>Description</title>
     103                                                                               
     104<sect3><title>libvga library</title>
     105<para><filename class="libraryfile">libvga</filename> is a low-level
     106graphics library.</para></sect3>
     107                                                                               
     108<sect3><title>libvgagl library</title>
     109<para><filename class="libraryfile">libvgagl</filename> is a fast
     110frame buffer level graphics library based on libvga.</para></sect3>
     111                                                                               
     112<sect3><title>dumpreg</title>
     113<para><command>dumpreg</command> dumps the state of the card as the
     114svgalib chipset driver sees it.</para></sect3>
     115                                                                               
     116<sect3><title>mode3</title>
     117<para><command>mode3</command> sets a <acronym>VESA</acronym> mode.</para></sect3>
     118                                                                               
     119<sect3><title>restorefont</title>
     120<para><command>restorefont</command> saves or restores the
     121<acronym>SVGA</acronym> font for textmode.</para></sect3>
     122                                                                               
     123<sect3><title>restorepalette</title>
     124<para><command>restorepalette</command> sets the color palette for
     125textmode.</para></sect3>
     126                                                                               
     127<sect3><title>restoretextmode</title>
     128<para><command>restoretextmode</command> saves or restores the
     129<acronym>SVGA</acronym> registers for textmode.</para></sect3>
     130                                                                               
     131<sect3><title>savetextmode, textmode</title>
     132<para><command>savetextmode</command> and <command>textmode</command> save or
     133restore the complete <acronym>SVGA</acronym> status for textmode.</para></sect3>
     134                                                                               
     135<sect3><title>svgakeymap</title>
     136<para><command>svgakeymap</command> generates keymaps for svgalib.</para></sect3>
     137                                                                               
     138</sect2>
    10139
    11140</sect1>
  • general/prog/gcc.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY gcc-download-http  "http://mirrors.rcn.net/pub/sourceware/gcc/releases/gcc-&gcc-version;/gcc-&gcc-version;.tar.bz2">
     8  <!ENTITY gcc-download-ftp   "ftp://mirrors.rcn.net/pub/sourceware/gcc/releases/gcc-&gcc-version;/gcc-&gcc-version;.tar.bz2">
     9  <!ENTITY gcc-size           "23 MB">
     10  <!ENTITY gcc-buildsize      "889 MB">
     11  <!ENTITY gcc-time           "29.3 SBU">
     12 
     13  <!ENTITY gnat-download-http " ">
     14  <!ENTITY gnat-download-ftp  "ftp://cs.nyu.edu/pub/gnat/3.15p/gnat-3.15p-i686-pc-redhat71-gnu-bin.tar.gz">
     15  <!ENTITY gnat-size          "13.2 MB">
     16  <!ENTITY gnat-buildsize     "48.9 MB">
     17  <!ENTITY gnat-time          "0.01 SBU">
     18]>
     19
    120<sect1 id="gcc" xreflabel="GCC-&gcc-version;">
    221<?dbhtml filename="gcc.html" ?>
    322<title>GCC-&gcc-version;</title>
    423
    5 &gcc-intro;
    6 &gcc-inst;
    7 &gcc-exp;
    8 &gcc-desc;
     24<sect2>
     25<title>Introduction to <application><acronym>GCC</acronym></application></title>
     26                                                                               
     27<para>The  <application><acronym>GCC</acronym></application> package
     28contains <acronym>GNU</acronym> compilers. This is useful for
     29compiling programs written in <application>Ada</application>,
     30<application>C</application>, <application>C++</application>,
     31<application>Fortran</application>, <application>Java</application> and
     32<application>Objective C</application>.</para>
     33                                                                               
     34<sect3><title>Package information</title>
     35<itemizedlist spacing='compact'>
     36<listitem><para>Download (HTTP): <ulink
     37url="&gcc-download-http;"/></para></listitem>
     38<listitem><para>Download (FTP): <ulink
     39url="&gcc-download-ftp;"/></para></listitem>
     40<listitem><para>Download size: &gcc-size;</para></listitem>
     41<listitem><para>Estimated Disk space required:
     42&gcc-buildsize;</para></listitem>
     43<listitem><para>Estimated build time:
     44&gcc-time;</para></listitem></itemizedlist>
     45</sect3>
     46<sect3><title>Additional Downloads</title>
     47<itemizedlist spacing='compact'>
     48<listitem><para>Required patch: <ulink url="&patch-root;/gcc-&gcc-version;-no_fixincludes-1.patch"/></para></listitem>
     49</itemizedlist></sect3>
     50                                                                               
     51</sect2>
     52
     53<sect2>
     54<title>Installation of <application><acronym>GCC</acronym></application></title>
     55                                                                               
     56<para>If you plan to compile Ada, you will need to install
     57<application><acronym>GNAT</acronym></application> temporarily to
     58satisfy the circular dependency when you recompile
     59<application><acronym>
     60GCC</acronym></application> to include
     61<application>Ada</application>.</para>
     62
     63<sect3><title>Package information</title>
     64<itemizedlist spacing='compact'>
     65<listitem><para>Download (HTTP): <ulink
     66url="&gnat-download-http;"/></para></listitem>
     67<listitem><para>Download (FTP): <ulink
     68url="&gnat-download-ftp;"/></para></listitem>
     69<listitem><para>Download size: &gnat-size;</para></listitem>
     70<listitem><para>Estimated Disk space required:
     71&gnat-buildsize;</para></listitem>
     72<listitem><para>Estimated build time:
     73&gnat-time;</para></listitem></itemizedlist>
     74</sect3>
     75
     76<sect3><title><application><acronym>GNAT</acronym></application> dependencies</title>
     77<sect4><title>Required</title>
     78<para><xref linkend="tcsh"/></para></sect4>
     79</sect3>
     80
     81</sect2>
     82                                                                               
     83<sect2>
     84<title>Installation of <application><acronym>GNAT</acronym></application></title>
     85
     86<para>Install <application><acronym>GNAT</acronym></application> by running the
     87following commands:</para>
     88
     89<screen><userinput><command>./doconfig</command></userinput></screen>
     90
     91<para>The above script will ask you how and where you would like to install
     92<application><acronym>GNAT</acronym></application>. To avoid conflicts with the
     93system <command>gcc</command>, the package will be installed in a separate
     94directory, that can later be removed from the system.</para>
     95
     96<para>In response to the questions asked by the
     97<command>doconfig</command> script, enter
     98<userinput>3</userinput> in response to the first question
     99and <userinput>/opt/gnat</userinput> in response to the
     100second question.</para>
     101
     102<para>To finish the install, run:</para>
     103<screen><userinput><command>./doinstall</command></userinput></screen>
     104
     105<para>The <application><acronym>GNAT</acronym></application> compiler can be
     106invoked by executing the <command>gcc</command> binary installed by the above
     107script.</para>
     108
     109</sect2>
     110
     111                                                                               
     112<sect2><title>Return to Installation of <application><acronym>GCC</acronym></application></title>
     113                                                                               
     114<para>Patch the source files with the following command:</para>
     115<screen><userinput><command>patch -Np1 -i ../gcc-&gcc-version;-no_fixincludes-1.patch &amp;&amp;
     116sed -i 's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in</command></userinput></screen>
     117                                                                               
     118<para>Install <application><acronym>GCC</acronym></application> by running the
     119following commands:</para>
     120                                                                               
     121<screen><userinput><command>PATH_HOLD=$PATH &amp;&amp;
     122export PATH=/opt/gnat/bin:$PATH &amp;&amp;
     123cd gcc/ada &amp;&amp;
     124touch treeprs.ads [es]info.h nmake.ad[bs] &amp;&amp;
     125cd ../.. &amp;&amp;
     126mkdir ../gcc-build &amp;&amp;
     127cd ../gcc-build &amp;&amp;
     128CC=/usr/bin/gcc ../gcc-&gcc-version;/configure --prefix=/usr --enable-shared \
     129    --enable-languages=c,c++,objc,f77,ada,java --enable-threads=posix \
     130    --enable-__cxa_atexit --enable-clocale=gnu &amp;&amp;
     131make bootstrap &amp;&amp;
     132make -C gcc gnatlib_and_tools &amp;&amp;
     133make -k check &amp;&amp;
     134make install &amp;&amp;
     135ln -sf ../usr/bin/cpp /lib &amp;&amp;
     136ln -sf gcc /usr/bin/cc &amp;&amp;
     137ln -sf g77 /usr/bin/f77 &amp;&amp;
     138export PATH=$PATH_HOLD</command></userinput></screen>
     139                                                                               
     140<para>You may remove the <application><acronym>GNAT</acronym></application>
     141installation:</para>
     142<screen><userinput><command>rm -rf /opt/gnat</command></userinput></screen>
     143                                                                               
     144</sect2>
     145
     146<sect2>
     147<title>Command explanations</title>
     148                                                                               
     149<para><command>PATH_HOLD=$PATH</command>: This command
     150stores your current path before it's modified so that it can be restored after
     151installation.</para>
     152                                                                               
     153<para><command>export PATH=/opt/gnat/bin:$PATH</command>: This
     154command allows the build to find
     155<application><acronym>GNAT</acronym></application>'s
     156<application>Ada</application> compiler to build
     157<application>Ada</application>.</para>
     158                                                                               
     159<para><command>touch treeprs.ads [es]info.h nmake.ad[bs]</command>:
     160This command creates necessary files for the
     161<application>Ada</application> build. This step
     162may be skipped if you don't want to compile the
     163<application>Ada</application> front end.</para>
     164                                                                               
     165<para><parameter>CC=/usr/bin/gcc</parameter>: This command works around the
     166new <envar>PATH</envar> which puts <application><acronym>GNAT</acronym>
     167</application>'s <command>gcc</command> as the primary compiler.</para>
     168                                                                               
     169<para><parameter>--enable-languages=c,c++,objc,f77,ada,java</parameter>: This command builds all available languages in the
     170<application><acronym>GCC</acronym></application> package.
     171You may modify this command to remove unwanted languages.</para>
     172                                                                               
     173<para><parameter>--enable-shared --enable-threads=posix
     174--enable-__cxa_atexit</parameter>: These commands are required to build
     175the <application>C++</application> libraries to published standards.</para>
     176                                                                               
     177<para><parameter>--enable-clocale=gnu</parameter>: This command is a
     178failsafe for incomplete locale data.</para>
     179                                                                               
     180<para><command>make gnatlib_and tools</command>: This command
     181completes the <application>Ada</application> build process. Skip this step if
     182you have not enabled <application>Ada</application> as one of the languages.
     183</para>
     184                                                                               
     185</sect2>
     186
     187<sect2>
     188<title>Contents</title>
     189                                                                               
     190<para>The <application><acronym>GCC</acronym></application> package contains
     191<command>c++</command>,
     192<command>c++filt</command>, <command>cpp</command>,
     193<command>g++</command>, <command>g77</command>,
     194<command>gcc</command>, <command>gccbug</command>,
     195<command>gcov</command>, <command>glob</command>,
     196<command>gnat</command>, <command>gnatbind</command>,
     197<command>gnatbl</command>, <command>gnatchop</command>,
     198<command>gnatfind</command>, <command>gnatkr</command>,
     199<command>gnatlink</command>, <command>gnatls</command>,
     200<command>gnatmake</command>, <command>gnatprep</command>,
     201<command>gnatpsta</command>, <command>gnatpsys</command>,
     202<command>gnatxref</command> and
     203<application><acronym>GCC</acronym></application> libraries.</para>
     204                                                                               
     205</sect2>
     206                                                                               
     207<sect2><title>Description</title>
     208                                                                               
     209<para>The programs and libraries whose descriptions are missing here
     210have been described in the <acronym>LFS</acronym>
     211<acronym>GCC</acronym>-&gcc-version; page.</para>
     212                                                                               
     213<sect3><title>g77</title>
     214<para><command>g77</command> is the <application>Fortran</application> compiler                                                                               
     215invoked by <command>gcc</command>.</para></sect3>
     216                                                                               
     217<sect3><title>add2line</title>
     218<para><command>add2line</command> converts the <acronym>ASCII</acronym> form of                                                                               
     219the 2-line orbital elements in a file to binary form and appends them to the
     220orbdata files. </para></sect3>
     221                                                                               
     222<sect3><title>gcov</title>
     223<para><command>gcov</command> is a test coverage program.</para></sect3>
     224                                                                               
     225<sect3><title>gdb</title>
     226<para><command>gdb</command> is the
     227<application><acronym>GNAT</acronym></application> debugger.</para></sect3>
     228                                                                               
     229<sect3><title>gnatbind</title>
     230<para><command>gnatbind</command> is used to bind compiled objects.</para>
     231</sect3>
     232                                                                               
     233<sect3><title>gnatbl</title>
     234<para><command>gnatbl</command> is the <application>Ada</application> linker.
     235</para></sect3>
     236                                                                               
     237<sect3><title>gnatchop</title>
     238<para><command>gnatchop</command> is useful for renaming files to meet the
     239standard <application>Ada</application> default file naming conventions.</para></sect3>
     240                                                                               
     241<sect3><title>gnatelim</title>
     242<para><command>gnatelim</command> is used to detect and eliminate unused
     243subprograms in an <application>Ada</application> partition.</para></sect3>
     244                                                                               
     245<sect3><title>gnatfind</title>
     246<para><command>gnatfind</command> is the <application><acronym>GNAT</acronym>
     247</application> definition/use finder.</para></sect3>
     248                                                                               
     249<sect3><title>gnatgcc</title>
     250<para><command>gnatgcc</command> is the compiler.</para></sect3>
     251                                                                               
     252<sect3><title>gnathtml.pl</title>
     253<para><command>gnathtml.pl</command> converts
     254<application>Ada</application> source files to <acronym>HTML</acronym> for
     255viewing in Web browsers.</para></sect3>
     256                                                                               
     257<sect3><title>gnatkr</title>
     258<para><command>gnatkr</command> is used to determine the crunched name for a
     259given file, when crunched to a specified maximum length.</para></sect3>
     260                                                                               
     261<sect3><title>gnatlink</title>
     262<para><command>gnatlink</command> is used to link programs and build an
     263executable file.</para></sect3>
     264                                                                               
     265<sect3><title>gnatls</title>
     266<para><command>gnatls</command> is the compiled unit browser.</para></sect3>
     267                                                                               
     268<sect3><title>gnatemake</title>
     269<para><command>gnatmake</command> is an automatic make facility.</para></sect3>                                                                               
     270<sect3><title>gnatmem</title>
     271<para><command>gnatmem</command> is the <application><acronym>GNAT</acronym>
     272</application> utility that monitors dynamic allocation and
     273deallocation activity in a program.</para></sect3>
     274                                                                               
     275<sect3><title>gnatprep</title>
     276<para><command>gnatprep</command> is the
     277<application><acronym>GNAT</acronym></application> external preprocessor.</para>
     278</sect3>
     279                                                                               
     280<sect3><title>gnatpsta</title>
     281<para><command>gnatpsta</command> determines the values of all the relevant
     282parameters in Standard and outputs to stdout.</para></sect3>
     283                                                                               
     284<sect3><title>gnatpsys</title>
     285<para><command>gnatpsys</command> determines the values of all the relevant
     286parameters in System and outputs to stdout.</para></sect3>
     287
     288<sect3><title>gnatstub</title>
     289<para><command>gnatstub</command> is a generator of body stubs.</para></sect3>
     290                                                                               
     291<sect3><title>gnatxref</title>
     292<para><command>gnatxref</command> is the <application><acronym>GNAT</acronym></application> cross-referencer.</para></sect3>
     293                                                                               
     294<sect3><title>gvd</title>
     295<para><command>gvd</command> is the <acronym>GNU</acronym> Visual Debugger.
     296</para></sect3>
     297                                                                               
     298</sect2>
    9299
    10300</sect1>
  • general/prog/gcc2.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY gcc2-download-http "http://ftp.gnu.org/gnu/gcc/gcc-&gcc2-version;.tar.gz">
     8  <!ENTITY gcc2-download-ftp  "ftp://ftp.gnu.org/gnu/gcc/gcc-&gcc2-version;.tar.gz">
     9  <!ENTITY gcc2-size          "9.4 MB">
     10  <!ENTITY gcc2-buildsize     "150 MB">
     11  <!ENTITY gcc2-time          "2.60 SBU">
     12]>
     13
    114<sect1 id="gcc2" xreflabel="GCC-&gcc2-version;">
    215<?dbhtml filename="gcc2.html" ?>
    316<title>GCC-&gcc2-version;</title>
    417
    5 &gcc2-intro;
    6 &gcc2-inst;
    7 &gcc2-config;
    8 &gcc2-desc;
     18<sect2>
     19<title>Introduction to <application><acronym>GCC</acronym></application>-&gcc2-version;</title>
     20                                                                               
     21                                                                               
     22<para>There are two reasons for installing
     23<acronym>GCC</acronym>-&gcc2-version;. The first is that the kernel
     24developers have certified <acronym>GCC</acronym>-&gcc2-version; as the
     25preferred compiler for compiling the kernel. The other (and more compelling
     26reason) is that some commercial closed-source packages (such as Netscape
     27Navigator, Yahoo Pager) and precompiled packages (such as Mozilla)
     28are linked against <acronym>GCC</acronym>-&gcc2-version; libs.</para>
     29                                                                               
     30<sect3><title>Package information</title>
     31<itemizedlist spacing='compact'>
     32<listitem><para>Download (HTTP): <ulink
     33url="&gcc2-download-http;"/></para></listitem>
     34<listitem><para>Download (FTP): <ulink
     35url="&gcc2-download-ftp;"/></para></listitem>
     36<listitem><para>Download size: &gcc2-size;</para></listitem>
     37<listitem><para>Estimated Disk space required:
     38&gcc2-buildsize;</para></listitem>
     39<listitem><para>Estimated build time:
     40&gcc2-time;</para></listitem></itemizedlist>
     41</sect3>
     42                                                                               
     43<sect3><title>Additional downloads</title>
     44<itemizedlist spacing='compact'>
     45<listitem><para><ulink url="&patch-root;/gcc-2.95.3-2.patch"/></para></listitem>
     46<listitem><para><ulink url="&patch-root;/gcc-2.95.3-no-fixinc.patch"/></para></listitem>
     47<listitem><para><ulink url="&patch-root;/gcc-2.95.3-returntype-fix.patch"/></para></listitem>
     48</itemizedlist>
     49</sect3>
     50
     51</sect2>
     52
     53<sect2>
     54<title>Configuring <application><acronym>GCC</acronym></application></title>
     55                                                                               
     56<sect3><title>Configuration Information</title>
     57                                                                               
     58<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/> 
     59                                                                               
     60<para>The instructions given above make compatibility symlinks that pre-compiled
     61packages in <acronym>BLFS</acronym> require. You may create additional
     62compatibility links based on your requirements.</para>
     63                                                                               
     64<para>If you only need the GCC-&gcc2-version; libraries, you may delete
     65<filename>/opt/gcc-&gcc2-version;</filename>.</para>
     66                                                                               
     67<para>Whenever you need to use GCC-&gcc2-version; instead of your system
     68installed compiler, add
     69<filename class="directory">/opt/gcc-&gcc2-version;/bin</filename> to the front of your <envar>PATH</envar> or (preferably) set the <envar>CC</envar>
     70environment variable before compiling the concerned package.</para>
     71                                                                               
     72</sect3>
     73                                                                               
     74</sect2>
     75
     76<sect2>
     77<title>Contents</title>
     78                                                                               
     79<para>The GCC-&gcc2-version; package contains the
     80<command>gcc</command>-&gcc2-version; <application>C</application> and
     81<application>C++</application> compilers and GCC-&gcc2-version;
     82<filename>libstdc++.so</filename> that is required by some commercial and
     83pre-compiled packages.</para>
     84                                                                               
     85</sect2>
    986
    1087</sect1>
  • general/prog/j2sdk.xml

    rbfe245f r52d29f7  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     3   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     4  <!ENTITY % general-entities SYSTEM "../../general.ent">
     5  %general-entities;
     6
     7  <!ENTITY j2sdk-download-http "http://freshmeat.net/projects/sunjdk">
     8  <!ENTITY j2sdk-download-ftp  " ">
     9  <!ENTITY j2sdk-bin-size      "35 MB">
     10  <!ENTITY j2sdk-src-size      "77 MB">
     11  <!ENTITY j2sdk-src-buildsize "1810 MB">
     12  <!ENTITY j2sdk-time          "85 SBU">
     13]>
     14
    115<sect1 id="j2sdk" xreflabel="J2SDK-&j2sdk-src-version;">
    216<?dbhtml filename="j2sdk.html" ?>
    317<title>J2SDK-&j2sdk-src-version;</title>
    418
    5 &j2sdk-intro;
    6 &j2sdk-inst;
    7 &j2sdk-exp;
    8 &j2sdk-config;
    9 &j2sdk-desc;
     19<sect2>
     20<title>Introduction to j2sdk</title>
     21                                                                               
     22<para>The <application>J2SDK</application> package contains Sun's
     23<application>Java</application> development environment. This is useful for
     24developing <application>Java</application> programs and provides the runtime
     25environment necessary to run <application>Java</application> programs.  It also                                                                               
     26includes a plug-in for browsers so that they can be <application>Java
     27</application> aware.</para>
     28                                                                               
     29<para>
     30The <acronym>JDK</acronym> comes in two flavors, a precompiled binary and a
     31source package. Previously, the plugin included in the <acronym>JDK</acronym> binary
     32package was unusable on <acronym>LFS</acronym>
     33owing to incompatibilities with <acronym>GCC</acronym>-3 compiled browsers.
     34This is not the case anymore.</para>
     35                                                                               
     36<para>The source package requires registration at the Sun
     37developer site and accepting the Sun Community Source License.
     38The source code cannot be downloaded from some countries, so for users
     39from those countries, the binary may be the only option.</para>
     40                                                                               
     41<para>Even if you plan on compiling the <acronym>JDK</acronym> source, you will                                                                               
     42need to download the binary version to bootstrap the <acronym>JDK</acronym>
     43build. Follow the link below to download both source and binary packages. When
     44downloading the source also download the <application>Mozilla</application>
     45headers package available at the same location.</para>
     46                                                                               
     47<!--
     48<para>For users who cannot download the <application>J2SDK</application> source owing to license restrictions, <application>blackdown
     49</application> has an <acronym>GCC</acronym>-3 based precompiled version.
     50Check out <ulink url="http://www.blackdown.org/"/> for more
     51information.</para>
     52-->
     53                                                                               
     54<sect3><title>Package information</title>
     55<itemizedlist spacing='compact'>
     56<listitem><para>Download (HTTP): <ulink
     57url="&j2sdk-download-http;"/></para></listitem>
     58
     59<!--
     60<listitem><para>Download (FTP): <ulink
     61url="&j2sdk-download-ftp;"/></para></listitem>
     62-->
     63<listitem><para>Version used (binary):
     64&j2sdk-bin-version;</para></listitem>
     65<listitem><para>Download size (binary): &j2sdk-bin-size;</para></listitem>
     66<listitem><para>Download size (source): &j2sdk-src-size;</para></listitem>
     67<listitem><para>Estimated Disk space required:
     68&j2sdk-src-buildsize;</para></listitem>
     69<listitem><para>Estimated build time:
     70&j2sdk-time;</para></listitem></itemizedlist>
     71</sect3>
     72                                                                               
     73<sect3><title>Additional downloads</title>
     74<itemizedlist spacing='compact'>
     75<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-fix-inline-asm-1.patch"/></para></listitem>
     76<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-gcc33-1.patch"/></para></listitem>
     77<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-motif-mkmsgcat.patch"/></para></listitem>
     78<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-remove-debug-image.patch"/></para></listitem>
     79<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-remove-fixed-paths-1.patch"/></para></listitem>
     80<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-static_cxx.patch"/></para></listitem>
     81<listitem><para><ulink url="&patch-root;/j2sdk-1.4.2-ash.patch"/> (Only required if /bin/sh is symlinked to <xref linkend="ash"/>)</para></listitem>
     82</itemizedlist>
     83</sect3>
     84                                                                               
     85                                                                               
    &nb