From 52d29f7a4212944c166ad666e105e261790e9621 Mon Sep 17 00:00:00 2001 From: Bruce Dubbs Date: Sat, 12 Jun 2004 22:56:28 +0000 Subject: [PATCH] XML Updates to Part III from DJ git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2304 af4574ff-66df-0310-9fd7-8a98e5e911e0 --- general.ent | 78 ++++ general/general.xml | 17 +- general/genlib/aspell.xml | 87 +++- general/genlib/expat.xml | 60 ++- general/genlib/fam.xml | 157 ++++++- general/genlib/gdbm.xml | 86 +++- general/genlib/genlib.xml | 54 ++- general/genlib/glib.xml | 62 ++- general/genlib/glib2.xml | 87 +++- general/genlib/gmp.xml | 74 +++- general/genlib/guile.xml | 90 +++- general/genlib/gwrap.xml | 75 +++- general/genlib/ispell.xml | 63 ++- general/genlib/libesmtp.xml | 77 +++- general/genlib/libpcap.xml | 63 ++- general/genlib/libusb.xml | 111 ++++- general/genlib/libxml.xml | 67 ++- general/genlib/libxml2.xml | 88 +++- general/genlib/libxslt.xml | 81 +++- general/genlib/lzo.xml | 63 ++- general/genlib/openssl.xml | 175 +++++++- general/genlib/pcre.xml | 96 ++++- general/genlib/popt.xml | 62 ++- general/genlib/readline.xml | 85 +++- general/genlib/slang.xml | 68 ++- general/genlib/slib.xml | 62 ++- general/genutils/bc.xml | 89 +++- general/genutils/compface.xml | 86 ++++ general/genutils/genutils.xml | 17 +- general/genutils/hd2u.xml | 69 ++- general/genutils/imagemagick.xml | 134 +++++- general/genutils/rep-gtk.xml | 84 +++- general/graphlib/aalib.xml | 93 +++- general/graphlib/directfb.xml | 149 ++++++- general/graphlib/fontconfig.xml | 125 +++++- general/graphlib/freetype2.xml | 74 +++- general/graphlib/graphlib.xml | 33 +- general/graphlib/imlib.xml | 87 +++- general/graphlib/imlib2.xml | 74 +++- general/graphlib/lcms.xml | 96 ++++- general/graphlib/libjpeg.xml | 111 ++++- general/graphlib/libmng.xml | 91 +++- general/graphlib/libpng.xml | 106 ++++- general/graphlib/libtiff.xml | 214 ++++++++- general/graphlib/libungif.xml | 202 ++++++++- general/graphlib/svgalib.xml | 139 +++++- general/prog/gcc.xml | 298 ++++++++++++- general/prog/gcc2.xml | 85 +++- general/prog/j2sdk.xml | 406 +++++++++++++++++- general/prog/librep.xml | 95 +++- general/prog/nasm.xml | 63 ++- general/prog/perl-modules.xml | 88 +++- general/prog/prog.xml | 27 +- general/prog/python.xml | 81 +++- general/prog/ruby.xml | 70 ++- general/prog/tcl.xml | 89 +++- general/prog/tk.xml | 85 +++- general/sysutils/cpio.xml | 92 +++- general/sysutils/fcron.xml | 166 ++++++- general/sysutils/gpm.xml | 158 ++++++- general/sysutils/hdparm.xml | 88 +++- general/sysutils/mc.xml | 110 ++++- general/sysutils/pciutils.xml | 78 +++- general/sysutils/pkgconfig.xml | 75 +++- general/sysutils/sysutils.xml | 27 +- general/sysutils/unzip.xml | 125 +++++- general/sysutils/which.xml | 65 ++- general/sysutils/zip.xml | 95 +++- .../core/scrollkeeper/scrollkeeper-intro.xml | 1 + index.xml | 7 +- 70 files changed, 6346 insertions(+), 289 deletions(-) diff --git a/general.ent b/general.ent index 2074613e85..e41877b17d 100644 --- a/general.ent +++ b/general.ent @@ -47,6 +47,82 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -102,3 +178,5 @@ + + diff --git a/general/general.xml b/general/general.xml index 7ba212dfa5..727f863222 100644 --- a/general/general.xml +++ b/general/general.xml @@ -1,11 +1,18 @@ + + + %general-entities; +]> + General Libraries and Utilities -&general-genlib; -&general-graphlib; -&general-genutils; -&general-sysutils; -&general-prog; + + + + + diff --git a/general/genlib/aspell.xml b/general/genlib/aspell.xml index df47ac79fc..5729765460 100644 --- a/general/genlib/aspell.xml +++ b/general/genlib/aspell.xml @@ -1,11 +1,90 @@ + + + %general-entities; + + + + + + + +]> + aspell-&aspell-version; -&aspell-intro; -&aspell-inst; -&aspell-config; -&aspell-desc; + +Introduction to <application>aspell</application> + +The aspell package contains the aspell +library, used to interface to spell checking libraries. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &aspell-size; +Estimated Disk space required: +&aspell-buildsize; +Estimated build time: +&aspell-time; + + +<application>aspell</application> dependencies +Required + + + + + + + +Installation of <application>aspell</application> + +Install aspell by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Configuring <application>aspell</application> + +Configuration Information + +After Aspell is installed, at least one +dictionary needs to be set up. You can find them at . + +Install your dictionary or dictionaries by running the following commands: +./configure && +make && +make install + + + + + + +Contents + +The aspell package contains the libaspell +libraries. + + + +Description + +aspell library +The libaspell library is a spell checking library interface. + + diff --git a/general/genlib/expat.xml b/general/genlib/expat.xml index 9e034da209..d1e4f357be 100644 --- a/general/genlib/expat.xml +++ b/general/genlib/expat.xml @@ -1,9 +1,63 @@ + + + %general-entities; + + + + + + + +]> + expat-&expat-version; -&expat-intro; -&expat-inst; -&expat-desc; + +Introduction to expat + +The expat package contains a stream oriented C library for +parsing XML. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &expat-size; +Estimated Disk space required: &expat-buildsize; +Estimated build time: &expat-time; + + + + +Installation of <application>expat</application> + +Install expat by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The expat package contains the libexpat libraries and +xmlwf. + + + +Description + +xmlwf +xmlwf is a non-validating utility to check whether or +not XML documents are well formed. + + + diff --git a/general/genlib/fam.xml b/general/genlib/fam.xml index 4dfb86fb84..edf2d80240 100644 --- a/general/genlib/fam.xml +++ b/general/genlib/fam.xml @@ -1,11 +1,158 @@ + + + %general-entities; + + + + + + + +]> + FAM-&fam-version; -&fam-intro; -&fam-inst; -&fam-exp; -&fam-config; -&fam-desc; + +Introduction to <application><acronym>FAM</acronym></application> +The FAM package contains a +File Alteration Monitor which is useful for notifying applications of +changes to the file system. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &fam-size; +Estimated Disk space required: +&fam-buildsize; +Estimated build time: +&fam-time; + + +Additional downloads + +Dnotify patch (Recommended): + + + +<application><acronym>FAM</acronym></application> dependencies + +Required + + + + + + +Installation of <application><acronym>FAM</acronym></application> +Install FAM by running the +following commands: + +patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch && +autoreconf -f -i && +./configure --prefix=/usr --sysconfdir=/etc && +make && +make install + + + + +Command explanations + +patch -Np1 -i ../fam-&fam-version;-dnotify-1.patch: This patch enables +FAM to use the Linux kernel +dnotify mechanism to inform the calling process of +file modifications, rather than polling the file system for +modifications. + +autoreconf -f -i +This command is necessary since the dnotify patch affects the +configure.ac and Makefile.am. + + + + +Configuring <application><acronym>FAM</acronym></application> + +Config files + +/etc/rpc, + /etc/fam.conf, + /etc/inetd.conf, + /etc/xinetd.d/fam + or /etc/xinetd.conf + + + +Configuration Information + +Configuring the file alteration monitor. + +If you use inetd, add the +FAM entry to +/etc/inetd.conf with the +following command: + +echo "sgi_fam/1-2 stream rpc/tcp wait root /usr/sbin/famd fam" >> /etc/inetd.conf + +If you use xinetd, add an entry to +/etc/xinetd.conf with the following command (be +sure the "nogroup" group exists): + +cat >> /etc/xinetd.conf << "EOF" + # description: FAM - file alteration monitor + service sgi_fam + { + type = RPC UNLISTED + socket_type = stream + user = root + group = nogroup + server = /usr/sbin/famd + wait = yes + protocol = tcp + rpc_version = 2 + rpc_number = 391002 + } +EOF + +If you do not have any inetd daemon installed and have no +wish to install one, you can also start fam during system startup +by installing /etc/rc.d/init.d/fam +init script included in the + package. + + +make install-fam + + + + + + +Contents + +The FAM package contains +the famd executable and libfam +libraries. + + + +Description + +famd + +famd is the file alteration monitor. + + + + + diff --git a/general/genlib/gdbm.xml b/general/genlib/gdbm.xml index daceca16e1..d755a5a142 100644 --- a/general/genlib/gdbm.xml +++ b/general/genlib/gdbm.xml @@ -1,11 +1,89 @@ + + + %general-entities; + + + + + + + +]> + GDBM-&gdbm-version; -&gdbm-intro; -&gdbm-inst; -&gdbm-exp; -&gdbm-desc; + +Introduction to <application><acronym>GDBM</acronym></application> + +The GDBM package +contains the GNU Database Manager. This +is a disk file format database which stores key/data-pairs in single +files. The actual data of any record being stored is indexed by a unique +key, which can be retrieved in less time than if it was stored in a text +file. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &gdbm-size; +Estimated Disk space required: +&gdbm-buildsize; +Estimated build time: +&gdbm-time; + + + + + + +Installation of <application><acronym>GDBM</acronym></application> + +Install GDBM by running the following commands: + + +./configure --prefix=/usr && +make && +make BINOWN=root BINGRP=root install + +In addition, you may need to install the DBM +and NDBM compatibility headers since some +applications look for these older dbm routines. + +make BINOWN=root BINGRP=root install-compat + + + + +Command explanations + +BINOWN=root BINGRP=root: This command +changes the file ownership to root instead of the bin user. + + + + +Contents + +The GDBM package +contains libgdbm libraries. + + + +Description + +gdbm libraries +libgdbm libraries contain functions that perform +database routines using extendible hashing. + + + diff --git a/general/genlib/genlib.xml b/general/genlib/genlib.xml index 47eb9b6f32..5b0b416d54 100644 --- a/general/genlib/genlib.xml +++ b/general/genlib/genlib.xml @@ -1,3 +1,10 @@ + + + %general-entities; +]> + General Libraries @@ -30,27 +37,28 @@ program's requirements. will need at some point. In this chapter we list these and some others and explain why you may want to install them. -&openssl; -&pcre; -&popt; -&slang; -&fam; -&libxml; -&libxml2; -&libxslt; -&readline; -&gmp; -&gdbm; -&GLib; -&GLib2; -&expat; -&libesmtp; -&aspell; -&ispell; -&guile; -&slib; -&gwrap; -&LZO; -&libpcap; -&libusb; + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/general/genlib/glib.xml b/general/genlib/glib.xml index 8dce86acf5..820e884d58 100644 --- a/general/genlib/glib.xml +++ b/general/genlib/glib.xml @@ -1,10 +1,66 @@ + + + %general-entities; + + + + + + + +]> + GLib-&GLib-version; -&GLib-intro; -&GLib-inst; -&GLib-desc; + +Introduction to <application>GLib</application> + +The glib package contains a low-level core +library. This is useful for providing data structure handling for C, +portability wrappers and interfaces for such runtime functionality as an event +loop, threads, dynamic loading, and an object system. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &GLib-size; +Estimated Disk space required: &GLib-buildsize; +Estimated build time: &GLib-time; + + + + + +Installation of <application>GLib</application> + +Install glib by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The glib package contains libglib-1.2 libraries. + + + +Description + +GLib libraries +GLib libraries contain a low-level core +library for the GIMP Toolkit. + + + diff --git a/general/genlib/glib2.xml b/general/genlib/glib2.xml index 891a819e44..6216a7d038 100644 --- a/general/genlib/glib2.xml +++ b/general/genlib/glib2.xml @@ -1,11 +1,90 @@ + + + %general-entities; + + + + + + + +]> + GLib-&GLib2-version; -&GLib2-intro; -&GLib2-inst; - -&GLib2-desc; + +Introduction to <application>GLib</application> + +The glib package contains a low-level core +library. This is useful for providing data structure handling for C, +portability wrappers and interfaces for such runtime functionality as an +event loop, threads, dynamic loading, and an object system. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &GLib2-size; +Estimated Disk space required: +&GLib2-buildsize; +Estimated build time: +&GLib2-time; + + +<application>GLib</application> dependencies +Required + +Optional + + + + + + +Installation of <application>GLib</application> + +Install glib by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Command explanations + +: This switch will rebuild +the API documentation during the +make command. + + + + +Contents + +The glib package contains +libglib-2.0, +libgobject-2.0, +libgmodule-2.0 and +libgthread-2.0 +libraries. + + + +Description + +GLib libraries +GLib libraries contain a low-level core library for the +GIMP Toolkit. + + diff --git a/general/genlib/gmp.xml b/general/genlib/gmp.xml index 5e95916fcf..7ed326b6b7 100644 --- a/general/genlib/gmp.xml +++ b/general/genlib/gmp.xml @@ -1,9 +1,77 @@ + + + %general-entities; + + + + + + + +]> + GMP-&gmp-version; -&gmp-intro; -&gmp-inst; -&gmp-desc; + +Introduction to <application><acronym>GMP</acronym></application> + +The GMP package +contains a math library. This has useful functions for arbitrary precision +arithmetic. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &gmp-size; +Estimated Disk space required: +&gmp-buildsize; +Estimated build time: +&gmp-time; + + + +<application><acronym>GMP</acronym></application> dependencies +Optional + + + + + + +Installation of <application><acronym>GMP</acronym></application> + +Install GMP by running the following commands: + + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The GMP package contains libgmp + libraries. + + + +Description + +gmp libraries +libgmp libraries contain the functions to operate +on signed integers, rational numbers, and floating point numbers. + + + + diff --git a/general/genlib/guile.xml b/general/genlib/guile.xml index e7ba9d72c5..052723425c 100644 --- a/general/genlib/guile.xml +++ b/general/genlib/guile.xml @@ -1,10 +1,94 @@ + + + %general-entities; + + + + + + + +]> + Guile-&guile-version; -&guile-intro; -&guile-inst; -&guile-desc; + +Introduction to <application>Guile</application> + +The Guile package contains the Project +GNU's extension language library. Guile + also contains a stand alone Scheme +interpreter. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &guile-size; +Estimated Disk space required: +&guile-buildsize; +Estimated build time: +&guile-time; + + + +<application>Guile</application> dependencies +Optional + + + + + + +Installation of <application>Guile</application> + +Install Guile by running the following +commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +In addition to the libguile libraries, the +Guile package contains +guile, +guile-config and +guile-snarf. + + + + +Description + +guile +guile is a stand-alone Scheme interpreter for +Guile. + +guile-config +guile-config is a Guile +script which provides the information necessary to link your programs against +the Guile library, in much the same way does. + +guile-snarf +guile-snarf is a script to parse declarations in +your C code for Scheme +visible C functions, Scheme + objects to be used by C code, +etc. + + diff --git a/general/genlib/gwrap.xml b/general/genlib/gwrap.xml index 7ab0b7784e..02adac483a 100644 --- a/general/genlib/gwrap.xml +++ b/general/genlib/gwrap.xml @@ -1,10 +1,79 @@ + + + %general-entities; + + + + + + + +]> + G-Wrap-&gwrap-version; -&gwrap-intro; -&gwrap-inst; -&gwrap-desc; + +Introduction to <application>G-Wrap</application> + +The G-Wrap package contains tools for +exporting C libraries into Scheme + interpreters. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &gwrap-size; +Estimated Disk space required: +&gwrap-buildsize; +Estimated build time: +&gwrap-time; + + + +<application>G-wrap</application> dependencies +Required + and + + + + + + +Installation of <application>G-Wrap</application> + +Install G-Wrap by running the following +commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +In addition to the Scheme libraries, the +G-Wrap package contains +g-wrap-config. + + + +Description + +g-wrap-config +g-wrap-config is a tool to generate CFLAGS + for linking C code to the +Scheme runtime libraries. + + diff --git a/general/genlib/ispell.xml b/general/genlib/ispell.xml index c834c99bd5..386693ab1f 100644 --- a/general/genlib/ispell.xml +++ b/general/genlib/ispell.xml @@ -1,10 +1,67 @@ + + + %general-entities; + + + + + + + +]> + ispell-&ispell-version; -&ispell-intro; -&ispell-inst; -&ispell-desc; + +Introduction to <application>ispell</application> + +The ispell package contains a spell +checker that can handle international languages. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &ispell-size; +Estimated Disk space required: +&ispell-buildsize; +Estimated build time: +&ispell-time; + + + + + +Installation of <application>ispell</application> + +The first step is to create local.h. + +sed -e "s:/usr/local:/usr:g" local.h.linux > local.h + +By default, ispell only installs an American +English dictionary. To set up other languages, check out the config.X file +for the #define entry to append to local.h. + +Compile and install ispell using the +following commands: +make && +make install + + + + +Contents + +The ispell package contains the +ispell program used for spell checking. + + diff --git a/general/genlib/libesmtp.xml b/general/genlib/libesmtp.xml index 5cd79ac8b6..3687ae802a 100644 --- a/general/genlib/libesmtp.xml +++ b/general/genlib/libesmtp.xml @@ -1,10 +1,81 @@ + + + %general-entities; + + + + + + +]> + libesmtp-&libesmtp-version; -&libesmtp-intro; -&libesmtp-inst; -&libesmtp-desc; + +Introduction to <application>libesmtp</application> + +The libesmtp package contains the libesmtp +libraries which are used by some programs to manage email submission to a +mail transport layer. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libesmtp-size; +Estimated Disk space required: +&libesmtp-buildsize; +Estimated build time: +&libesmtp-time; + + + +<application>libesmtp</application> dependencies + +Optional + + + + + + + + +Installation of <application>libesmtp</application> + +Install libesmtp by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The libesmtp package contains the libesmtp +library. + + + + +Description + + +libesmtp library + +The libesmtp library is used to manage submission of +electronic mail to a Mail Transport Agent. + + + diff --git a/general/genlib/libpcap.xml b/general/genlib/libpcap.xml index 00410e7b5d..f967742123 100644 --- a/general/genlib/libpcap.xml +++ b/general/genlib/libpcap.xml @@ -1,9 +1,66 @@ + + + %general-entities; + + + + + + + +]> + <acronym>libpcap</acronym>-&libpcap-version; -&libpcap-intro; -&libpcap-inst; -&libpcap-desc; + +Introduction to <application><acronym>libpcap</acronym></application> + +libpcap provides +functions for user-level packet capture, used in low-level network +monitoring. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libpcap-size; +Estimated Disk space required: &libpcap-buildsize; +Estimated build time: &libpcap-time; + + + + + +Installation of <application><acronym>libpcap</acronym></application> + +Install libpcap by running the +following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +libpcap package provides +the libpcap library. + + + +Description + +libpcap +libpcap +is a library for user-level packet capture. + + + diff --git a/general/genlib/libusb.xml b/general/genlib/libusb.xml index 6edc5c8b1f..a63969ceec 100644 --- a/general/genlib/libusb.xml +++ b/general/genlib/libusb.xml @@ -1,11 +1,112 @@ + + + %general-entities; + + + + + + + +]> + libusb-&libusb-version; -&libusb-intro; -&libusb-inst; -&libusb-exp; -&libusb-config; -&libusb-desc; + +Introduction to <application>libusb</application> + +The libusb package contains a library +used by some applications for USB device access. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libusb-size; +Estimated Disk space required: &libusb-buildsize; +Estimated build time: &libusb-time; + + +<application>libusb</application> dependencies +Optional + and + + + + + +Installation of <application>libusb</application> + +Install libusb by running the following commands: + +./configure --prefix=/usr --disable-build-docs && +make && +make install + + + + +Command explanations + +--disable-build-docs: This switch turns off +the default enabled building of documentation since it requires +OpenJade. + + + +Configuring <application>libusb</application> + + + +libusb requires the usbfs kernel filesystem to be mounted on +/proc/bus/usb. Applications +require the files in this directory to be accessible to the user, +sometimes for both reading and writing. + +To restrict access to USB devices, create the +usb group: + +groupadd -g 15 usb + +To get usbfs mounted on boot, we will create a special init script, +because just putting an extra line into +/etc/fstab does not work for those who compiled +"USB device filesystem" as a kernel module. +Install /etc/rc.d/init.d/usb +init script included in the + package. + + +make install-usb + + + + +Contents + +The libusb package contains +libusb libraries, +the /usr/include/usb.h header, +and a usb-config script. + + + +Description + +libusb libraries +libusb libraries contain C functions for +accessing USB hardware. + +usb-config +The usb-config script provides the right +compiler and linker flags for programs using +this library. + + + diff --git a/general/genlib/libxml.xml b/general/genlib/libxml.xml index 3e672b8673..2b93a7cdf0 100644 --- a/general/genlib/libxml.xml +++ b/general/genlib/libxml.xml @@ -1,9 +1,70 @@ + + + %general-entities; + + + + + + + +]> + libxml-&libxml-version; -&libxml-intro; -&libxml-inst; -&libxml-desc; + +Introduction to <application>libxml</application> + +The libxml package contains the libxml +libraries. These are useful for parsing XML files. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libxml-size; +Estimated Disk space required: +&libxml-buildsize; +Estimated build time: +&libxml-time; + + + + + +Installation of <application>libxml</application> + +Install libxml by running the following +commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The libxml package contains +libxml libraries, xmllint and +xmlcatalog. + + + +Description + +libxml libraries +libxml libraries provide the functions for programs +to parse files that use the XML format. + + + diff --git a/general/genlib/libxml2.xml b/general/genlib/libxml2.xml index 49972ba4ad..f292875c7b 100644 --- a/general/genlib/libxml2.xml +++ b/general/genlib/libxml2.xml @@ -1,11 +1,91 @@ + + + %general-entities; + + + + + + + +]> + libxml2-&libxml2-version; -&libxml2-intro; -&libxml2-inst; -&libxml2-exp; -&libxml2-desc; + +Introduction to <application>libxml2</application> + +The libxml2 package contains +XML libraries. These are useful for parsing +XML files. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libxml2-size; +Estimated Disk space +required: &libxml2-buildsize; +Estimated build time: +&libxml2-time; + + +<application>libxml2</application> dependencies +Optional + and + + + + + +Installation of <application>libxml2</application> + +Install libxml2 by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Command explanations + +: Enables readline support. + + + + +Contents + +The libxml2 package contains libxml2 libraries, xmllint, +xmlcatalog and xml2-config. + + + +Description + +libxml2 libraries +libxml2 libraries provide +the functions for programs to parse files that use the XML +format. + +xmllint +xmllint parses XML files and outputs reports (based +upon options) to detect errors in XML coding. + +xmlcatalog +xmlcatalog allows users to monitor and manipulate +XML and SGML catalogs. + + diff --git a/general/genlib/libxslt.xml b/general/genlib/libxslt.xml index c4aaddc7ec..6cd7788df7 100644 --- a/general/genlib/libxslt.xml +++ b/general/genlib/libxslt.xml @@ -1,10 +1,85 @@ + + + %general-entities; + + + + + + + +]> + libxslt-&libxslt-version; -&libxslt-intro; -&libxslt-inst; -&libxslt-desc; + +Introduction to <application>libxslt</application> + +The libxslt package contains +XSLT libraries. These are useful +for extending libxml2 libraries to support +XSLT files. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libxslt-size; +Estimated Disk space required: +&libxslt-buildsize; +Estimated build time: +&libxslt-time; + + +<application>libxslt</application> dependencies +Required + +Optional + + + + + + +Installation of <application>libxslt</application> + +Install libxslt by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The libxslt package contains +libxslt libraries, libexslt libraries, +xsltproc and xslt-config. + + + +Description + +libxslt libraries +libxslt libraries provide extensions to the +libxml2 libraries to parse files that use the +XSLT format. + +xsltproc +xsltproc is used to apply +XSLT stylesheets to XML +documents. + + + diff --git a/general/genlib/lzo.xml b/general/genlib/lzo.xml index 8323f977fa..b842b4d9e6 100644 --- a/general/genlib/lzo.xml +++ b/general/genlib/lzo.xml @@ -1,9 +1,66 @@ + + + %general-entities; + + + + + + + +]> + <acronym>LZO</acronym>-&LZO-version; -&LZO-intro; -&LZO-inst; -&LZO-desc; + +Introduction to <application><acronym>LZO</acronym></application> + +LZO is a data compression +library which is suitable for data decompression and compression in real-time. +This means it favors speed over compression ratio. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &LZO-size; +Estimated Disk space required: &LZO-buildsize; +Estimated build time: &LZO-time; + + + + + +Installation of <application><acronym>LZO</acronym></application> + +Install LZO by running the +following commands: + +./configure --prefix=/usr --enable-shared && +make && +make install + + + + +Contents + +LZO package provides +liblzo library. + + + +Description + +liblzo +liblzo +is a data compression and decompression library. + + + diff --git a/general/genlib/openssl.xml b/general/genlib/openssl.xml index 0cf06ca0b2..abe3ba2c66 100644 --- a/general/genlib/openssl.xml +++ b/general/genlib/openssl.xml @@ -1,11 +1,176 @@ + + + %general-entities; + + + + + + + + +]> + + OpenSSL-&openssl-version; -&openssl-intro; -&openssl-inst; -&openssl-exp; -&openssl-config; -&openssl-desc; + + +Introduction to <application>OpenSSL</application> + +The OpenSSL package contains management tools +and libraries relating to cryptography. These are useful for providing +cryptography functions to other packages, notably OpenSSH + and web browsers (for accessing secure https sites). + +Package information + +Download (HTTP): +Download (FTP): +Download size: &openssl-size; +Estimated Disk space required: &openssl-buildsize; +Estimated build time: &openssl-time; + + + + +Installation of <application>OpenSSL</application> + +Install OpenSSL by running the following commands: + +sed 's/^passwd/openssl-passwd/' doc/apps/passwd.pod \ + > doc/apps/openssl-passwd.pod && +rm doc/apps/passwd.pod && +mv doc/crypto/{,openssl_}threads.pod && +sed -i -e 's/-m486/-march=i486/' Configure && +./config --openssldir=/etc/ssl --prefix=/usr shared && +make MANDIR=/usr/share/man && +make MANDIR=/usr/share/man install && +cp -r certs /etc/ssl && +rmdir /etc/ssl/lib + + + + +Command explanations + +: When added to the +./config command, this will eliminate the building of those +encryption methods. Patent licenses may be needed for you to utilize either of +those methods in your projects. + +rm doc/apps/passwd.pod: This command prevents +OpenSSL from installing its +passwd man page over an existing man page with the same name. + +mv doc/crypto/{,openssl_}threads.pod: This +commands prevents OpenSSL from +overwriting an existing man page from Perl. + +sed -i -e 's/-m486/-march=i486/' Configure: +GCC issues a warning on every +compilation because the Configure +command uses deprecated -m486 instead of +-march=i486. + +make MANDIR=/usr/share/man +make MANDIR=/usr/share/man install These +commands install OpenSSL with the man pages +in /usr/share/man instead of the +default which is /etc/ssl/man. + +cp -r certs /etc/ssl: The certificates +must be copied manually since the install script +skips this step. + +rmdir /etc/ssl/lib: This is simply a tidy-up command. +For some reason, the openssl install routine creates +the /etc/ssl/lib directory even though +the libraries have been installed in +/usr/lib. We remove it to keep things +nice and tidy! + + + + +Configuring <application>OpenSSL</application> + +Config files +/etc/ssl/openssl.cnf + + +Configuration Information + +Most people who just want to use +openssl for providing functions +to other programs such as OpenSSH and web browsers won't need to worry +about configuring OpenSSL. Configuring +OpenSSL is an advanced topic and +so those who do would normally be expected to either know how to do it +or to be able to find out how to do it. + + + + + +Contents + +The OpenSSL package contains +c_rehash, openssl, libcrypto libraries and libssl libraries. + + + +Description + +c_rehash + +c_rehash is a Perl script +that scans all files in a directory and adds symbolic links to their hash +values. + + + +openssl + +The openssl program is a command-line tool for using +the various cryptography functions of +OpenSSL's +crypto library from the shell. It can be used for various functions which are +documented in man 1 openssl. + + + +libcrypto + +The OpenSSL crypto library implements a wide +range of cryptographic algorithms used in various Internet standards. The +services provided by this library are used by the +OpenSSL + implementations of SSL, TLS + and S/MIME, and they have also been used to +implement OpenSSH, +OpenPGP +, and other cryptographic standards. + + + +libssl + +The OpenSSL SSL library +implements the Secure Sockets Layer (SSL v2/v3) and +Transport Layer Security (TLS v1) protocols. It provides a +rich API, documentation on which can be found by running +man 3 ssl. + + + + + diff --git a/general/genlib/pcre.xml b/general/genlib/pcre.xml index a7efb4909f..9277124ab8 100644 --- a/general/genlib/pcre.xml +++ b/general/genlib/pcre.xml @@ -1,10 +1,98 @@ + + + %general-entities; + + + + + + + +]> + PCRE-&pcre-version; -&pcre-intro; -&pcre-inst; -&pcre-exp; -&pcre-desc; + +Introduction to <application><acronym>PCRE</acronym></application> + +The PCRE package contains +Perl Compatible Regular Expression +libraries. These are useful for implementing regular expression pattern +matching using the same syntax and semantics as +Perl 5. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &pcre-size; +Estimated Disk space required: +&pcre-buildsize; +Estimated build time: +&pcre-time; + + + + +Installation of <application><acronym>PCRE</acronym></application> + +Install PCRE by running the following commands: + +./configure --prefix=/usr --enable-utf8 && +make && +make install + +If you reinstall grep after installing pcre, +grep will get linked against pcre and +may cause problems if /usr is a separate mount point. To avoid this, +either pass the option --disable-perl-regexp when executing ./configure +for grep or move libpcre to /lib +as follows. + +mv /usr/lib/libpcre.so.* /lib/ && +ln -sf ../../lib/libpcre.so.0 /usr/lib/libpcre.so + + + +Command explanations + +--enable-utf8: This switch includes the +code for handling UTF-8 character strings in the +library. + + + + +Contents + +The PCRE package contains +the libpcre libraries, +pcregrep, pcretest and +pcre-config. + + + +Description + +pcregrep +pcregrep is a grep that understands +Perl compatible regular expressions. + +pcretest +pcretest can test your +Perl compatible regular expression. + +pcre-config +pcre-config is used during the compile process of +programs linking to this library. + + + diff --git a/general/genlib/popt.xml b/general/genlib/popt.xml index ea2cf54d0a..a2b6797271 100644 --- a/general/genlib/popt.xml +++ b/general/genlib/popt.xml @@ -1,10 +1,66 @@ + + + %general-entities; + + + + + + + + +]> + popt-&popt-version; -&popt-intro; -&popt-inst; -&popt-desc; + +Introduction to <application>popt</application> + +The popt package contains the popt libraries which are used by +some programs to parse command-line options. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &popt-size; +Estimated Disk space required: &popt-buildsize; +Estimated build time: &popt-time; + + + + + +Installation of <application>popt</application> + +Install popt by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The popt package contains the +libpopt libraries. + + + +Description + +popt library +The libpopt library is used to +parse command-line options. + + diff --git a/general/genlib/readline.xml b/general/genlib/readline.xml index 88308b8998..54e8cce95d 100644 --- a/general/genlib/readline.xml +++ b/general/genlib/readline.xml @@ -1,11 +1,86 @@ + + + %general-entities; + + + + + + + +]> + readline-&readline-version; -&readline-intro; -&readline-inst; -&readline-exp; -&readline-config; -&readline-desc; + +Introduction to <application>readline</application> + +The readline library provides a set of +functions for use by applications that allow users to edit command-lines as +they are typed in. Both Emacs and +vi editing modes are available. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &readline-size; +Estimated Disk space required: +&readline-buildsize; +Estimated build time: +&readline-time; + + + + + + +Installation of <application>readline</application> + +Install readline by running the following +commands: + +./configure --prefix=/usr && +make SHLIB_LIBS=-lcurses && +make install + + + + +Command explanations + +make SHLIB_LIBS=-lcurses: This command makes the +proper symbols available for applications that assume +readline is compiled with +ncurses links. + + + + +Configuring <application>readline</application> + +Configuration Information + + + + + + + + +Contents + +The readline package contains the +libreadline libraries and libhistory libraries. + + + + diff --git a/general/genlib/slang.xml b/general/genlib/slang.xml index 250042be09..9c69eee16c 100644 --- a/general/genlib/slang.xml +++ b/general/genlib/slang.xml @@ -1,10 +1,70 @@ + + + %general-entities; + + + + + + + +]> + slang-&slang-version; -&slang-intro; -&slang-inst; -&slang-config; -&slang-desc; + +Introduction to <application>slang</application> + +The slang package contains the slang library, which +provides facilities such as display/screen management, keyboard input, and keymaps. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &slang-size; +Estimated Disk space required: &slang-buildsize; +Estimated build time: &slang-time; + + + + + +Installation of <application>slang</application> + +Install slang by running the following commands: + +./configure --prefix=/usr && +make && +make install && +make elf && +make install-elf && +make install-links && +chmod 755 /usr/lib/libslang.so.&slang-version; + + + + +Configuring <application>slang</application> + +Configuration Information + + + + + + + + +Contents + +The slang package contains the libslang libraries. + + + diff --git a/general/genlib/slib.xml b/general/genlib/slib.xml index d3a8f455be..1d0afe7bee 100644 --- a/general/genlib/slib.xml +++ b/general/genlib/slib.xml @@ -1,10 +1,66 @@ + + + %general-entities; + + + + + + + +]> + slib-&slib-version; -&slib-intro; -&slib-inst; -&slib-desc; + +Introduction to <application>slib</application> + +The slib package is a Scheme + library used with Guile. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &slib-size; +Estimated Disk space required: +&slib-buildsize; +Estimated build time: +&slib-time; + + + +<application>slib</application> dependencies +Required + + + + + + +Installation of <application>slib</application> + +Installation of slib is merely a copy command: + + +cp -R slib /usr/share/guile + + + + + +Contents + +The slib package contains a +Scheme library. + + diff --git a/general/genutils/bc.xml b/general/genutils/bc.xml index e2717282ef..21eb1c2719 100644 --- a/general/genutils/bc.xml +++ b/general/genutils/bc.xml @@ -1,3 +1,90 @@ + + + %general-entities; + + + + + + + +]> + + + +bc-&bc-version; + + +Introduction to <application>bc</application> + +The bc package contains +an arbitrary precision numeric processing language. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &bc-size; +Estimated Disk space required: +&bc-buildsize; +Estimated build time: +&bc-time; + + +Additional downloads + +Required Patch: +Required Patch: + + +<application>bc</application> dependencies +Required + + + + + + +Installation of <command>bc</command> + +Install bc by running the following commands: + +patch -Np1 -i ../bc-1.06-flex_invocation-1.patch && +patch -Np1 -i ../bc-1.06-readline-1.patch && +./configure --prefix=/usr --with-readline && +make && +make install + + + + +Contents + +The bc package contains +bc and +dc. + + + +Description + +bc +bc is a calculator. + +dc +dc is a reverse-polish calculator. + + + + + + diff --git a/general/genutils/compface.xml b/general/genutils/compface.xml index a8254882d8..64bac7a007 100644 --- a/general/genutils/compface.xml +++ b/general/genutils/compface.xml @@ -1,3 +1,88 @@ + + + %general-entities; + + + + + + + +]> + + + +Compface-&compface-version; + + +Introduction to <application>Compface</application> + +Compface provides utilities and a library to +convert from/to X-Face format, a 48x48 bitmap format used to carry thumbnails +of email authors in a mail header. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &compface-size; +Estimated Disk space required: &compface-buildsize; +Estimated build time: &compface-time; + + +Additional downloads + +Required patch: + + + + + + +Installation of <application>Compface</application> + +Install Compface by running the +following commands: + +patch -Np1 -i ../compface-1.4-errno-2.patch && +./configure --prefix=/usr && +make && +make install + + + + +Contents + +This package contains compface, +uncompface and +libcompface. + + + +Description + +compface +compface is a filter for generating highly compressed +representations of 48x48x1 face image files. + +uncompface +uncompface is an inverse filter which performs an inverse +transformation with no loss of data. + +libcompface +libcompface allows the compression +and decompression algorithms to be used in other programs such as +MTAs. + + + + + + diff --git a/general/genutils/genutils.xml b/general/genutils/genutils.xml index 23cd3178e0..4b09242d4c 100644 --- a/general/genutils/genutils.xml +++ b/general/genutils/genutils.xml @@ -1,11 +1,18 @@ + + + %general-entities; +]> + General Utilities -&bc; -&rep-gtk; -&compface; -&imagemagick; -&hd2u; + + + + + diff --git a/general/genutils/hd2u.xml b/general/genutils/hd2u.xml index 4332e9ab96..fef5a6bba5 100644 --- a/general/genutils/hd2u.xml +++ b/general/genutils/hd2u.xml @@ -1,10 +1,73 @@ + + + %general-entities; + + + + + + + +]> + hd2u-&hd2u-version; -&hd2u-intro; -&hd2u-inst; -&hd2u-desc; + +Introduction to <application>hd2u</application> + +The hd2u contains +any to any text format converter. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &hd2u-size; +Estimated Disk space required: +&hd2u-buildsize; +Estimated build time: +&hd2u-time; + + +<application>hd2u</application> dependencies +Required + + + + + + +Installation of <application>hd2u</application> + +Install hd2u by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The hd2u package contains +dos2unix. + + + +Description + +dos2unix +dos2unix converts text between various OS formats +(such as converting from DOS format to Unix). + + diff --git a/general/genutils/imagemagick.xml b/general/genutils/imagemagick.xml index 67fbaca7cd..f1d3c34fff 100644 --- a/general/genutils/imagemagick.xml +++ b/general/genutils/imagemagick.xml @@ -1,9 +1,137 @@ + + + %general-entities; + + + + + + + +]> + ImageMagick-&imagemagick-version;-&imagemagick-patch-version; -&imagemagick-intro; -&imagemagick-inst; -&imagemagick-desc; + +Introduction to <application>ImageMagick</application> + +ImageMagick is a collection of tools and libraries +to read, write, and +manipulate an image in various image formats. Image processing operations are +available from the command line. Bindings to various programming languages +are also available. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &imagemagick-size; +Estimated Disk space required: +&imagemagick-buildsize; +Estimated build time: +&imagemagick-time; + + +<application>ImageMagick</application> dependencies + +Recommended + +X ( or ) and + + + +Optional (Install based on the format support needed) + +, +, +, +, +, +libwmf, +libexif, +FlashPIX, +JBIG, +Jasper and +corefonts + + + + + + + +Installation of <application>Imagemagick</application> + +Install Imagemagick by running the following +commands: + +./configure --prefix=/usr --enable-shared --with-modules && +make && +make install + + + + +Additional Configure Options + +There are additional switches that can be passed to ImageMagick +to customize the installation to your need. Check out the ImageMagick +installation instructions at . + + + + +Contents + +ImageMagick contains animate, +composite, +conjure, +convert, +display, +identify, +import, +mogrify, +montage, and the +libMagick and +libMagick++ libraries. + + + +Description + +animate +Animates a sequence of images. + +composite +Composites various images into the given base image. + +conjure +Processes a Magick Scripting Language (MSL) script to create +an image. + +convert +Convert image(s) from one format to another. + +display +Display the image. + +identify +Describes the format and characteristics of an image file. +import +Captures an X window. + +mogrify +Transforms an image. + +montage +Composites various images into a new image. + + diff --git a/general/genutils/rep-gtk.xml b/general/genutils/rep-gtk.xml index 4bbf15187e..6aa572dc75 100644 --- a/general/genutils/rep-gtk.xml +++ b/general/genutils/rep-gtk.xml @@ -1,10 +1,88 @@ + + + %general-entities; + + + + + + +]> + rep-gtk-&rep-gtk-version; -&rep-gtk-intro; -&rep-gtk-inst; -&rep-gtk-desc; + +Introduction to <application>rep-gtk</application> + +The rep-gtk package contains a +Lisp and GTK binding. This is useful +for extending GTK-2 and GDK + libraries with Lisp. Starting at +rep-gtk-0.15, the package contains the bindings to +GTK and uses the same instructions. Both +can be installed, if needed. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &rep-gtk-size; +Estimated Disk space required: +&rep-gtk-buildsize; +Estimated build time: +&rep-gtk-time; + + +Additional downloads + +Required Patch: + + + +<application>rep-gtk</application> dependencies +Required +, and + + + + + +Installation of <application>rep-gtk</application> + +Install rep-gtk by running the following +commands: + +patch -Np1 -i ../rep-gtk-&rep-gtk-version;-gtk2.4.patch && +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The rep-gtk package contains Lisp bindings. + + + + +Description + +Lisp bindings +Lisp bindings are libraries stored in +/usr/lib/rep/i686-pc-linux-gnu/gui/ that assist communications +between Lisp and the GTK libraries. + + diff --git a/general/graphlib/aalib.xml b/general/graphlib/aalib.xml index 646f704fc8..d25209d4ea 100644 --- a/general/graphlib/aalib.xml +++ b/general/graphlib/aalib.xml @@ -1,10 +1,97 @@ + + + %general-entities; + + + + + + + +]> + AAlib-&aalib-version; -&aalib-intro; -&aalib-inst; -&aalib-desc; + +Introduction to <application>AAlib</application> + +AAlib is a library to render any graphic into +ASCII Art. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &aalib-size; +Estimated Disk space required: +&aalib-buildsize; +Estimated build time: +&aalib-time; + + + +<application>AAlib</application> dependencies +Optional +X ( or ) and + + + + + +Installation of <application>AAlib</application> + +Install AAlib by running the following +commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The AAlib package contains the libaa libraries, aalib-config, +aainfo, aatest and +aasavefont. + + + +Description + +ASCII Art libraries +The ASCII Art library is a collection of routines to render any +graphical input in portable format to ASCII Art. It can be used through +many programs and has a very well documented API, so you +can easily put it into your own programs. + +aalib-config +aalib-config provides configuration info for +AAlib. + +aainfo +aainfo provides information for your current settings +related to AAlib. + +aatest +aatest shows the abilities of AAlib + in a little test. + +aafire +aafire is another little toy of AAlib +, rendering an animated fire in ASCII Art. + +aasavefont +Currently no information available. + + diff --git a/general/graphlib/directfb.xml b/general/graphlib/directfb.xml index d3906181ae..31aea6b7dd 100644 --- a/general/graphlib/directfb.xml +++ b/general/graphlib/directfb.xml @@ -1,10 +1,151 @@ + + + %general-entities; + + + + + + + +]> + DirectFB-&DirectFB-version; -&DirectFB-intro; -&DirectFB-inst; -&DirectFB-config; -&DirectFB-desc; + +Introduction to <application>DirectFB</application> + +DirectFB is a graphics library on top of the Linux frame buffer +device. It offers maximum hardware accelerated performance at a +minimum of resource usage and overhead. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &DirectFB-size; +Estimated Disk space required: &DirectFB-buildsize; +Estimated build time: &DirectFB-time; + + +Additional downloads + +Optional image and video providers: + + + +<application>DirectFB</application> dependencies +Required +, and + + +Optional +, +, , and + + + + + + +Installation of <application>DirectFB</application> + +DirectFB needs a Linux kernel with frame buffer support. Check +the documentation in the kernel tree +(/usr/src/linux/Documentation/fb/) +on how to enable the frame buffer device for your graphics +card. + +Install DirectFB by running the +following commands: + +./configure --prefix=/usr && +make && +make install + +If you decided to add any optional image and video providers, then you +have to install the DirectFB-extra package too: + +./configure --prefix=/usr && +make && +make install + +The current version of avifile does not work with DirectFB. +You have to use the avifile version which can be found at + or alternatively disable the +avifile video provider by calling configure with +--disable-avifile. + + + + +Configuring DirectFB + +Config files + +/etc/directfbrc, +~/.directfbrc + + +Configuration information + +DirectFB is shipped with reasonable defaults but you might have to +tweak things. There are several ways to do this. You may edit the +system-wide configuration file /etc/directfbrc, the user-specific +~/.directfbrc or you may configure the DirectFB application via the +command-line. Consult the directfbrc(5) manual page for details. + + + + + +Contents + +The DirectFB package provides dfbdump, +dfbg, dfbinfo, +dfblayer, directfb-config, +directfb-csource and libdirectfb libraries. + + + +Description + +dfbdump + This is a simple debugging tool for DirectFB that shows a list +of surfaces and windows. + +dfbg +dfbg is a background configuration +tool. + +dfbinfo +This tool enumerates input devices. + +dfblayer +dfblayer is a display layer configuration +tool. + +directfb-config +directfb-config provides all flags to link static binaries with +selectable drivers and other modules built in. + +directfb-csource +This is a C code generation utility for DirectFB +surfaces. + +libdirectfb libraries +They provide hardware graphics acceleration, input device handling +and abstraction, integrated windowing system with support for +translucent windows and multiple display layers on top of the Linux +frame buffer device. + + diff --git a/general/graphlib/fontconfig.xml b/general/graphlib/fontconfig.xml index 9cc85b8cc6..ea44cd1c3b 100644 --- a/general/graphlib/fontconfig.xml +++ b/general/graphlib/fontconfig.xml @@ -1,10 +1,127 @@ + + + %general-entities; + + + + + + + +]> + Fontconfig-&fontconfig-version; -&fontconfig-intro; -&fontconfig-inst; -&fontconfig-config; -&fontconfig-desc; + +Introduction to <application>Fontconfig</application> + +The Fontconfig package is a library +for configuring and customizing font access. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &fontconfig-size; +Estimated Disk space required: +&fontconfig-buildsize; +Estimated build time: +&fontconfig-time; + +The numbering system of +Fontconfig is unusual. The beta versions of the +package are numbered with a 9x in the last portion of the release number. This +means that 2.2.90 is a beta release and the most current release is of the +form 2.2.1 + + + +<application>Fontconfig</application> dependencies +Required + and +Optional + +docbook-utils + + + + + +Installation of <application>Fontconfig</application> + +Install Fontconfig by running the following commands: + +./configure --prefix=/usr --sysconfdir=/etc && +make && +make install + + + +Configuring <application>Fontconfig</application> + +Config files +/etc/fonts/* + + +Configuration Information + +The configuration file for Fontconfig is /etc/fonts/fonts.conf. +Generally you do not want to edit this file. To put a new font directory +in the configuration, update the /etc/fonts/local.conf file with your local +information. The default location of fonts in +Fontconfig is: + +/usr/share/fonts +~/.fonts + + +Because we have not built XFree86 yet, put the following directory entries +into /etc/fonts/local.conf, inside the fontconfig +tags: + +sed -i -e '/^<\/fontconfig>/i\ +<dir>/usr/X11R6/lib/X11/fonts/TTF</dir>\ +<dir>/usr/X11R6/lib/X11/fonts/Type1</dir>\ +<dir>/usr/X11R6/lib/X11/fonts/truetype</dir>' /etc/fonts/local.conf + +The Fontconfig program will automatically search the above directories +and all subdirectories for needed fonts. + +X also includes an internal (and +older) version of Fontconfig +and unless it is explicitly disabled when building +XFree86, the internal +version is created leaving two slightly incompatible libraries on your system. +It is recommended that you only install one version. + + + + + + +Contents + +The Fontconfig package contains the +libfontconfig library, +fc-cache, and fc-list. + + + +Description + +fc-cache +fc-cache is a command to create font information +caches. + +fc-list +fc-list is a command to list fonts. + + diff --git a/general/graphlib/freetype2.xml b/general/graphlib/freetype2.xml index 294798f308..efa94dbf0d 100644 --- a/general/graphlib/freetype2.xml +++ b/general/graphlib/freetype2.xml @@ -1,10 +1,78 @@ + + + %general-entities; + + + + + + + +]> + FreeType-&freetype2-version; -&freetype2-intro; -&freetype2-inst; -&freetype2-desc; + +Introduction to <application>FreeType2</application> + +The FreeType2 package contains a library to +allow applications to properly render +TrueType fonts. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &freetype2-size; +Estimated Disk space required: +&freetype2-buildsize; +Estimated build time: +&freetype2-time; + + +Additional downloads + +Recommended Patch: + + + + + +Installation of <application>FreeType2</application> + +Install FreeType2 by running the following +commands: + +patch -Np1 -i ../freetype-&freetype2-version;-bytecode-interpreter.patch && +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The FreeType2 package contains + +libfreetype libraries. + + +Description + +FreeType2 libraries +FreeType2 libraries add +TrueType font +capabilities to XFree86. + + diff --git a/general/graphlib/graphlib.xml b/general/graphlib/graphlib.xml index bc6c9952ee..f13fb63162 100644 --- a/general/graphlib/graphlib.xml +++ b/general/graphlib/graphlib.xml @@ -1,3 +1,10 @@ + + + %general-entities; +]> + Graphics and Font Libraries @@ -7,18 +14,18 @@ may not require the graphics and font libraries. Most desktop machines will want them for use with graphical applications. Most servers on the other hand, will not require them. -&libjpeg; -&libpng; -&libtiff; -&libungif; -&libmng; -&lcms; -&freetype2; -&fontconfig; -&imlib; -&aalib; -&SVGAlib; -&DirectFB; -&imlib2; + + + + + + + + + + + + + diff --git a/general/graphlib/imlib.xml b/general/graphlib/imlib.xml index badf311edb..c6c09fd3fc 100644 --- a/general/graphlib/imlib.xml +++ b/general/graphlib/imlib.xml @@ -1,11 +1,90 @@ + + + %general-entities; + + + + + + + +]> + Imlib-&imlib-version; -&imlib-intro; -&imlib-inst; -&imlib-exp; -&imlib-desc; + +Introduction to <application>Imlib</application> + +The Imlib package contains image libraries. +These are useful for loading, rendering and dithering a wide variety of image +data formats. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &imlib-size; +Estimated Disk space required: +&imlib-buildsize; +Estimated build time: +&imlib-time; + + + +<application>Imlib</application> dependencies +Required + + and + + + + + + + +Installation of <application>Imlib</application> + +Install Imlib by running the following +commands: + +./configure --prefix=/usr --sysconfdir=/etc/imlib && +make && +make install + + + + +Command explanations + + + +--sysconfdir=/etc/imlib: This installs and +combines the configurations files into /etc instead +of /usr/etc. + + + +Contents + +The Imlib package contains libimlib libraries. + + + +Description + +imlib libraries +libimlib libraries provide the functions for +programs to display and edit a wide variety of image data formats. + + + diff --git a/general/graphlib/imlib2.xml b/general/graphlib/imlib2.xml index 987b8675ea..f13bb8e676 100644 --- a/general/graphlib/imlib2.xml +++ b/general/graphlib/imlib2.xml @@ -1,9 +1,77 @@ + + + %general-entities; + + + + + + + +]> + Imlib2-&imlib2-version; -&imlib2-intro; -&imlib2-inst; -&imlib2-desc; + +Introduction to <application>Imlib2</application> + +Imlib2 is a graphics library for fast file +loading, saving, rendering and manipulation. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &imlib2-size; +Estimated Disk space required: &imlib2-buildsize; +Estimated build time: &imlib2-time; + + +<application>Imlib2</application> dependencies +Required +X ( or ) and + +Optional + and + + + + + + +Installation of <application>Imlib2</application> + +Install Imlib2 by running the +following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + + +This package contains libImlib2 library +as well as various filters and image loader libraries. + + + + +Description + +libImlib2 +libImlib2 +provides the functions for programs to deal with various image data formats. + + + diff --git a/general/graphlib/lcms.xml b/general/graphlib/lcms.xml index b00eefc6b4..546af48904 100644 --- a/general/graphlib/lcms.xml +++ b/general/graphlib/lcms.xml @@ -1,10 +1,98 @@ + + + %general-entities; + + + + + + + +]> + lcms-&lcms-version; -&lcms-intro; -&lcms-inst; - -&lcms-desc; + +Introduction to <application>lcms</application> + +The lcms library is used by other programs to provide +color management facilities. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &lcms-size; +Estimated Disk space required: +&lcms-buildsize; +Estimated build time: +&lcms-time; + + +<application>lcms</application> dependencies +Optional +, , and SWIG + + + + + +Installation of <application>lcms</application> + +Install lcms by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The lcms package contains the liblcms +libraries, icc2ps, icclink, +icctrans, wtpt and optionally, tifficc, +jpegicc and lcms Python module. + + + +Description + +liblcms library +The liblcms libraries are used by other programs to provide color +management facilities. + +icc2ps +icc2ps generates PostScript +CRD or CSA from +ICC profiles. + +icclink +icclink links two or more profiles into a +single device link profile. + +icctrans +icctrans is a Color Space conversion +calculator. + +tifficc +tifficc is an ICC profile +applier for TIFF files. + +jpegicc +jpegicc is an ICC profile +applier for JPEG files. + + diff --git a/general/graphlib/libjpeg.xml b/general/graphlib/libjpeg.xml index c83c195323..eaca10a448 100644 --- a/general/graphlib/libjpeg.xml +++ b/general/graphlib/libjpeg.xml @@ -1,12 +1,113 @@ + + + %general-entities; + + + + + + + +]> + libjpeg-&libjpeg-version; -&libjpeg-intro; -&libjpeg-inst; -&libjpeg-exp; -&libjpeg-config; -&libjpeg-desc; + +Introduction to <application>libjpeg</application> + +The libjpeg package contains libraries +that allow compression of image files based on the Joint Photographic Experts +Group standard. It is a "lossy" compression algorithm. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libjpeg-size; +Estimated Disk space required: &libjpeg-buildsize; +Estimated build time: &libjpeg-time; + + + + + +Installation of <application>libjpeg</application> + +Install libjpeg by running the following commands: + +./configure --enable-static --enable-shared --prefix=/usr && +make && +make install + + + + +Command explanations + +./configure --enable-static --enable-shared --prefix=/usr: This command tells libjpeg to build both shared and static libraries and +to install them with a base of /usr. + + + + +Configuring <application>libjpeg</application> + +Configuration Information + + + + + + + + +Contents + +The libjpeg package contains cjpeg, +djpeg, jpegtran, +rdjpgcom, wrjpgcom and +libjpeg libraries. + + + +Description + +cjpeg +cjpeg compresses image files to produce a +JPEG/JFIF file on the standard +output. Currently supported input file formats are: +PPM (PBMPLUS color +format), PGM (PBMPLUS gray-scale +format), BMP, and Targa. + +djpeg +djpeg decompresses image files from +JPEG/JFIF format to either PPM +(PBMPLUS color format), PGM (PBMPLUS gray-scale +format), BMP, or Targa +format. + +jpegtran +jpegtran is used for lossless transformation of +JPEG files. + +rdjpgcom +rdjpgcom displays text comments from within a +JPEG file. + +wrjpgcom +wrjpgcom inserts text comments into a +JPEG file. + +jpeg libraries +These libraries are used by many programs for reading and writing +jpeg format files. + + diff --git a/general/graphlib/libmng.xml b/general/graphlib/libmng.xml index 47c16ae8e3..a0d2447f9b 100644 --- a/general/graphlib/libmng.xml +++ b/general/graphlib/libmng.xml @@ -1,11 +1,94 @@ + + + %general-entities; + + + + + + + +]> + libmng-&libmng-version; -&libmng-intro; -&libmng-inst; -&libmng-exp; -&libmng-desc; + +Introduction to <application>libmng</application> + +The libmng libraries are used by programs +wanting to read and write Multiple-image Network Graphics (MNG) +files which are the animation +equivalents to PNG files. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libmng-size; +Estimated Disk space required: +&libmng-buildsize; +Estimated build time: +&libmng-time; + + + +<application>libmng</application> dependencies +Required + and + + + + + +Installation of <application>libmng</application> + +Install libmng by running the following +commands: + +./autogen.sh && +./configure --prefix=/usr && +make && +make install && +cp doc/man/*.3 /usr/share/man/man3 && +cp doc/man/*.5 /usr/share/man/man5 + + + + +Command explanations + +./autogen.sh: This package does not ship +with the configure script. The autotool files need to be generated +before configuring the package. + +cp doc/man/*.X /usr/share/man/manX: The +install procedure doesn't properly install the man pages so we do it +manually. + + + + +Contents + +The libmng package contains libmng + libraries. + + + +Description + +MNG libraries +libmng provides functions for programs wishing to +read and write MNG files which are animation files without +the patent problems associated with certain other formats. + + diff --git a/general/graphlib/libpng.xml b/general/graphlib/libpng.xml index dfbc4a8f4b..bcbc33616b 100644 --- a/general/graphlib/libpng.xml +++ b/general/graphlib/libpng.xml @@ -1,12 +1,108 @@ + + + %general-entities; + + + + + + + +]> + libpng-&libpng-version; -&libpng-intro; -&libpng-inst; -&libpng-exp; -&libpng-config; -&libpng-desc; + +Introduction to <application>libpng</application> + +The libpng package contains libraries used +by other programs for reading and writing PNG files. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libpng-size; +Estimated Disk space required: +&libpng-buildsize; +Estimated build time: +&libpng-time; + + +Additional downloads + +Required Patch to explicitly link libpng against system libraries: + + + + + +Installation of <application>libpng</application> + +Install libpng by running the following commands: + +patch -Np1 -i ../libpng-&libpng-version;-link-to-proper-libs.patch && +make prefix=/usr ZLIBINC=/usr/include \ + ZLIBLIB=/usr/lib -f scripts/makefile.linux && +make prefix=/usr install -f scripts/makefile.linux + + + + +Command explanations + +ZLIBINC=/usr/include ZLIBLIB=/usr/lib: This +forces libpng to look for the +zlib includes and libraries where we have them installed. + +-f scripts/makefile.linux: This points make at the +Linux version of the makefile as libpng doesn't use +an autoconf routine. Instead it has various makefiles for different +platforms. + + + + +Configuring <application>libpng</application> + +Configuration Information + + + + + + + + +Contents + +The libpng package contains +libpng libraries and libpng-config. + + + +Description + +png libraries +The PNG library is a collection of routines used to +create and manipulate PNG format graphics files. The +PNG format was designed as a +replacement for GIF and, to a lesser extent, +TIFF, with many improvements and extensions and lack of +patent problems. + +libpng-config +libpng-config provides configuration info for +libpng. + + diff --git a/general/graphlib/libtiff.xml b/general/graphlib/libtiff.xml index 42e9a3844f..1ed44f65bf 100644 --- a/general/graphlib/libtiff.xml +++ b/general/graphlib/libtiff.xml @@ -1,12 +1,216 @@ + + + %general-entities; + + + + + + + +]> + libtiff-&libtiff-version; -&libtiff-intro; -&libtiff-inst; -&libtiff-exp; -&libtiff-config; -&libtiff-desc; + +Introduction to <application>libtiff</application> + +The libtiff package contains the tiff libraries and associated +utilities. The libraries are used by many programs for reading and +writing tiff files and the utilities are useful for general work with +tiff files. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libtiff-size; +Estimated Disk space required: &libtiff-buildsize; +Estimated build time: &libtiff-time; + + +<application>libtiff</application> dependencies +Optional + + + + + + + +Installation of <application>libtiff</application> + +Install libtiff by running the following commands: + +./configure --prefix=/usr --noninteractive \ + --with-DIR_MAN=/usr/share/man \ + --with-ZIP=yes --with-DIR_GZLIB=/usr/lib && +make && +make install + +configure prints false error messages that it is unable to find thelibrary directories for ZIP (and JPEG) support. Ignore them. To verify that +libtiff is indeed linked to these libraries, use the +ldd command. + + + + +Command explanations + +: This switch is used to +avoid the configuration routine asking for confirmation of the +installation directories (which we pass to configure). + +--with-DIR_MAN=/usr/share/man: This is used +because despite the fact we pass --prefix=/usr, the +configure routine tries to install the man pages in /usr/local/man instead of the correct +place. + +--with-ZIP=yes --with-DIR_GZLIB=/usr/lib: This +enables support for the handling of TIFF images with +deflate-encoded data. + +--with-JPEG=yes --with-DIR_JPEGLIB=/usr/lib: Use +these switches to enable support for the handling of TIFF +images with JPEG-encoded data. + + + + +Configuring <application>libtiff</application> + +Configuration Information + + + + + + + + +Contents + +The libtiff package contains +fax2ps, +fax2tiff, +gif2tiff, +pal2rgb, +ppm2tiff, +ras2tiff, +raw2tiff, +rgb2ycbcr, +thumbnail, +tiff2bw, +tiff2pdf, +tiff2ps, +tiff2rgba, +tiffcmp, +tiffcp, +tiffdither, +tiffdump, +tiffinfo, +tiffmedian, +tiffset, +tiffsplit and +libtiff libraries. + + + +Description + +fax2ps +fac2ps converts a TIFF +facsimile to compressed PostScript file. + +fax2tiff +fax2tiff creates a TIFF +Class F fax file from raw fax data. + +gif2tiff +gif2tiff creates a TIFF file +from a GIF87 format image file. + +pal2rgb +pal2rgb converts a palette color +TIFF image to a full color image. + +ppm2tiff +ppm2tiff creates a TIFF file +from a PPM image file. + +ras2tiff +ras2tiff creates a TIFF file +from a Sun rasterfile. + +raw2tiff +raw2tiff converts a raw byte sequence into +TIFF. + +rgb2ycbcr +rgb2ycbcr converts non-YCbCr +TIFF images to a YCbCr TIFF +image. + +thumbnail +thumbnail creates a TIFF +file with thumbnail images. + +tiff2bw +tiff2bw converts a color +TIFF image to grayscale. + +tiff2pdf +tiff2pdf converts a TIFF +image to a PDF document. + +tiff2ps +tiff2ps converts a TIFF +image to a PostScript file. + +tiff2rgba +tiff2rgba converts a wide variety of +TIFF images into an RGBA +TIFF image. + +tiffcmp +tiffcmp compares two TIFF +files. + +tiffcp +tiffcp copies (and possibly converts) a +TIFF file. + +tiffdither +tiffdither converts a grayscale image to +bilevel using dithering. + +tiffdump +tiffdump prints verbatim information about +TIFF files. + +tiffinfo +tiffinfo prints information about +TIFF files. + +tiffmedian +tiffmedian applies the median cut algorithm to +data in a TIFF file. + +tiffsplit +tiffsplit splits a multi-image +TIFF into single-image TIFF +files. + +tiff libraries +The tiff libraries are used by many programs to read and write +tiff files. + + diff --git a/general/graphlib/libungif.xml b/general/graphlib/libungif.xml index bf90e61740..eb460ef255 100644 --- a/general/graphlib/libungif.xml +++ b/general/graphlib/libungif.xml @@ -1,10 +1,206 @@ + + + %general-entities; + + + + + + + +]> + libungif-&libungif-version; -&libungif-intro; -&libungif-inst; -&libungif-desc; + +Introduction to <application>libungif</application> + +The libungif package contains libraries for reading all +GIFs and writing non-compressed ones as well as programs for +converting and working with GIF files. The libraries are +useful for any graphics program wishing to deal with GIF +files while the programs are useful for conversion purposes as well as cleaning +up images. + +The reason libungif only writes non-compressed GIFs +is due to a legal issue with LZW compression (which Unisys +claims a patent on). Reading GIFs is not a problem as the +decompression routines do not seem to be limited in this way. Note that this +has in the past been disputed. The best way to avoid this whole mess is to +simply use libungif for looking at GIF images on the web, +while in any pages which you design, use the open source PNG +format instead (which uses, not surprisingly, the libpng library) which has no +patent issues at all. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &libungif-size; +Estimated Disk space required: &libungif-buildsize; +Estimated build time: &libungif-time; + + +Additional downloads + +Required patch: + + + + + + +Installation of <application>libungif</application> + +Install libungif by running the following +commands: + +patch -Np1 -i ../libungif-4.1.0b1-va_start.patch && +./configure --prefix=/usr && +make && +make install + + + + + + +Contents + +The libungif package contains gif2epsn, +gif2ps, gif2rgb, +gifasm, gifbg, +gifburst, gifclip, +gifclrmp, gifcolor, +gifcomb, gifcompose, +giffiltr, giffix, +gifflip, gifhisto, +gifinfo, gifinter, +gifinto, gifovly, +gifpos, gifrotat, +gifrsize, gifspnge, +giftext, gifwedge, +icon2gif, raw2gif, +rgb2gif, text2gif and +libungif libraries. + + + +Description + +gif2epsn +Dumps images saved as GIF files on Epson type printers. + +gif2ps +Print GIF files on laser printers supporting PostScript. + + +gif2rgb +Convert images saved as GIF to 24-bit RGB + image(s). + +gifasm +Assemble multiple GIFs into one, or burst a +multiple-image GIF. + +gifbg +Generate a single-color test pattern GIF. + + +gifburst +Burst a GIF image into subrectangles. + +gifclip +Clip or crop a GIF image. + +gifclrmp +Modify GIF image colormaps. + +gifcolor +Generate color test patterns. + +gifcomb +Combine 2 GIF images of exactly the same size into one. + + +gifcompose +Use (un)giflib tools to compose images. + +giffiltr +Template code for filtering a GIF sequentially. + +giffix +Clumsily attempts to fix truncated GIF images. + + +gifflip +Flip GIF image along X or Y axis or rotate by 90 +degrees. + +gifhisto +Generate color-frequency histogram from a GIF. + + +gifinfo +Gives information on a GIF file. + +gifinter +Convert between interlaced and non-interlaced images. + +gifinto +End-of-pipe fitting for GIF-processing pipelines. + +gifovly +Generate one composite GIF from a multiple-image +GIF. + +gifpos +Change a GIF's screen size or recondition it. + +gifrotat +Rotate a GIF through any desired angle. +gifrsize +Resize a GIF by deletion or duplication of bits. + + +gifspnge +Template code for filtering a GIF with in-core +operations. + +giftext +Print (text only) general information about a GIF. + + +gifwedge +Create a test GIF image resembling a color monitor +test pattern. + +icon2gif +Converter/deconverter to/from an editable text format. + +raw2gif +Convert raw 8-bit image data into GIF files. + + +rgb2gif +Convert 24 bit images to a GIF image using color +quantization. + +text2gif +Generate GIF images out of regular text in 8x8 font. + + + diff --git a/general/graphlib/svgalib.xml b/general/graphlib/svgalib.xml index 76fb8e366f..0db79ee11d 100644 --- a/general/graphlib/svgalib.xml +++ b/general/graphlib/svgalib.xml @@ -1,11 +1,140 @@ + + + %general-entities; + + + + + + + +]> + SVGAlib-&SVGAlib-version; -&SVGAlib-intro; -&SVGAlib-inst; -&SVGAlib-exp; -&SVGAlib-config; -&SVGAlib-desc; + +Introduction to <application>SVGAlib</application> + +SVGAlib is a low-level graphics library +that provides VGA and SVGA +modes in a console. This is useful for programs running on a console +that require graphics capabilities. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &SVGAlib-size; +Estimated Disk space required: &SVGAlib-buildsize; +Estimated build time: &SVGAlib-time; + +Additional downloads + +Download (HTTP): + + + + + +Installation of <application>SVGAlib</application> + +You must compile and install as root. If you don't, certain tools +won't be able to become SUID root which is required for +proper operation. However, this raises a risk of exposing your system to any +holes in those tools that might be used to gain root access, so use with +caution. + +Install SVGAlib by running the following commands: + +patch -Np1 -i ../svgalib-1.4.3-gcc3-1.patch && +make prefix=/usr install && +cd doc && +for dir in man?; do for file in $dir/*; do \ +gunzip /usr/share/man/$file; done; done + + + + +Command explanations + +cd doc && for dir in man?; do for file in $dir/*; do +gunzip /usr/share/man/$file; done; done: +SVGAlib installs its man pages in compressed format +so we uncompress them. + + + + +Configuring SVGAlib + +Config files + +/etc/vga/libvga.config, ~/.svgalibrc + + +Configuration information + +You must edit the config file to set the monitor and mouse type. +Depending on your hardware, other setup might be required. + + + + + + + + +Contents + +The SVGAlib package contains libvga +and libvgagl libraries, +dumpreg, mode3, restorefont, +restorepalette, restoretextmode, +savetextmode, textmode and +svgakeymap. + + + +Description + +libvga library +libvga is a low-level +graphics library. + +libvgagl library +libvgagl is a fast +frame buffer level graphics library based on libvga. + +dumpreg +dumpreg dumps the state of the card as the +svgalib chipset driver sees it. + +mode3 +mode3 sets a VESA mode. + +restorefont +restorefont saves or restores the +SVGA font for textmode. + +restorepalette +restorepalette sets the color palette for +textmode. + +restoretextmode +restoretextmode saves or restores the +SVGA registers for textmode. + +savetextmode, textmode +savetextmode and textmode save or +restore the complete SVGA status for textmode. + +svgakeymap +svgakeymap generates keymaps for svgalib. + + diff --git a/general/prog/gcc.xml b/general/prog/gcc.xml index c0c6ea7744..735d9b6c96 100644 --- a/general/prog/gcc.xml +++ b/general/prog/gcc.xml @@ -1,11 +1,301 @@ + + + %general-entities; + + + + + + + + + + + + +]> + GCC-&gcc-version; -&gcc-intro; -&gcc-inst; -&gcc-exp; -&gcc-desc; + +Introduction to <application><acronym>GCC</acronym></application> + +The GCC package +contains GNU compilers. This is useful for +compiling programs written in Ada, +C, C++, +Fortran, Java and +Objective C. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &gcc-size; +Estimated Disk space required: +&gcc-buildsize; +Estimated build time: +&gcc-time; + +Additional Downloads + +Required patch: + + + + + +Installation of <application><acronym>GCC</acronym></application> + +If you plan to compile Ada, you will need to install +GNAT temporarily to +satisfy the circular dependency when you recompile + +GCC to include +Ada. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &gnat-size; +Estimated Disk space required: +&gnat-buildsize; +Estimated build time: +&gnat-time; + + +<application><acronym>GNAT</acronym></application> dependencies +Required + + + + + + +Installation of <application><acronym>GNAT</acronym></application> + +Install GNAT by running the +following commands: + +./doconfig + +The above script will ask you how and where you would like to install +GNAT. To avoid conflicts with the +system gcc, the package will be installed in a separate +directory, that can later be removed from the system. + +In response to the questions asked by the +doconfig script, enter +3 in response to the first question +and /opt/gnat in response to the +second question. + +To finish the install, run: +./doinstall + +The GNAT compiler can be +invoked by executing the gcc binary installed by the above +script. + + + + +Return to Installation of <application><acronym>GCC</acronym></application> + +Patch the source files with the following command: +patch -Np1 -i ../gcc-&gcc-version;-no_fixincludes-1.patch && +sed -i 's/install_to_$(INSTALL_DEST) //' libiberty/Makefile.in + +Install GCC by running the +following commands: + +PATH_HOLD=$PATH && +export PATH=/opt/gnat/bin:$PATH && +cd gcc/ada && +touch treeprs.ads [es]info.h nmake.ad[bs] && +cd ../.. && +mkdir ../gcc-build && +cd ../gcc-build && +CC=/usr/bin/gcc ../gcc-&gcc-version;/configure --prefix=/usr --enable-shared \ + --enable-languages=c,c++,objc,f77,ada,java --enable-threads=posix \ + --enable-__cxa_atexit --enable-clocale=gnu && +make bootstrap && +make -C gcc gnatlib_and_tools && +make -k check && +make install && +ln -sf ../usr/bin/cpp /lib && +ln -sf gcc /usr/bin/cc && +ln -sf g77 /usr/bin/f77 && +export PATH=$PATH_HOLD + +You may remove the GNAT +installation: +rm -rf /opt/gnat + + + + +Command explanations + +PATH_HOLD=$PATH: This command +stores your current path before it's modified so that it can be restored after +installation. + +export PATH=/opt/gnat/bin:$PATH: This +command allows the build to find +GNAT's +Ada compiler to build +Ada. + +touch treeprs.ads [es]info.h nmake.ad[bs]: +This command creates necessary files for the +Ada build. This step +may be skipped if you don't want to compile the +Ada front end. + +CC=/usr/bin/gcc: This command works around the +new PATH which puts GNAT +'s gcc as the primary compiler. + +--enable-languages=c,c++,objc,f77,ada,java: This command builds all available languages in the +GCC package. +You may modify this command to remove unwanted languages. + +--enable-shared --enable-threads=posix +--enable-__cxa_atexit: These commands are required to build +the C++ libraries to published standards. + +--enable-clocale=gnu: This command is a +failsafe for incomplete locale data. + +make gnatlib_and tools: This command +completes the Ada build process. Skip this step if +you have not enabled Ada as one of the languages. + + + + + +Contents + +The GCC package contains +c++, +c++filt, cpp, +g++, g77, +gcc, gccbug, +gcov, glob, +gnat, gnatbind, +gnatbl, gnatchop, +gnatfind, gnatkr, +gnatlink, gnatls, +gnatmake, gnatprep, +gnatpsta, gnatpsys, +gnatxref and +GCC libraries. + + + +Description + +The programs and libraries whose descriptions are missing here +have been described in the LFS +GCC-&gcc-version; page. + +g77 +g77 is the Fortran compiler +invoked by gcc. + +add2line +add2line converts the ASCII form of +the 2-line orbital elements in a file to binary form and appends them to the +orbdata files. + +gcov +gcov is a test coverage program. + +gdb +gdb is the +GNAT debugger. + +gnatbind +gnatbind is used to bind compiled objects. + + +gnatbl +gnatbl is the Ada linker. + + +gnatchop +gnatchop is useful for renaming files to meet the +standard Ada default file naming conventions. + +gnatelim +gnatelim is used to detect and eliminate unused +subprograms in an Ada partition. + +gnatfind +gnatfind is the GNAT + definition/use finder. + +gnatgcc +gnatgcc is the compiler. + +gnathtml.pl +gnathtml.pl converts +Ada source files to HTML for +viewing in Web browsers. + +gnatkr +gnatkr is used to determine the crunched name for a +given file, when crunched to a specified maximum length. + +gnatlink +gnatlink is used to link programs and build an +executable file. + +gnatls +gnatls is the compiled unit browser. + +gnatemake +gnatmake is an automatic make facility. +gnatmem +gnatmem is the GNAT + utility that monitors dynamic allocation and +deallocation activity in a program. + +gnatprep +gnatprep is the +GNAT external preprocessor. + + +gnatpsta +gnatpsta determines the values of all the relevant +parameters in Standard and outputs to stdout. + +gnatpsys +gnatpsys determines the values of all the relevant +parameters in System and outputs to stdout. + +gnatstub +gnatstub is a generator of body stubs. + +gnatxref +gnatxref is the GNAT cross-referencer. + +gvd +gvd is the GNU Visual Debugger. + + + diff --git a/general/prog/gcc2.xml b/general/prog/gcc2.xml index aa4c1e3482..186fa5683f 100644 --- a/general/prog/gcc2.xml +++ b/general/prog/gcc2.xml @@ -1,11 +1,88 @@ + + + %general-entities; + + + + + + +]> + GCC-&gcc2-version; -&gcc2-intro; -&gcc2-inst; -&gcc2-config; -&gcc2-desc; + +Introduction to <application><acronym>GCC</acronym></application>-&gcc2-version; + + +There are two reasons for installing +GCC-&gcc2-version;. The first is that the kernel +developers have certified GCC-&gcc2-version; as the +preferred compiler for compiling the kernel. The other (and more compelling +reason) is that some commercial closed-source packages (such as Netscape +Navigator, Yahoo Pager) and precompiled packages (such as Mozilla) +are linked against GCC-&gcc2-version; libs. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &gcc2-size; +Estimated Disk space required: +&gcc2-buildsize; +Estimated build time: +&gcc2-time; + + +Additional downloads + + + + + + + + + + +Configuring <application><acronym>GCC</acronym></application> + +Configuration Information + + + +The instructions given above make compatibility symlinks that pre-compiled +packages in BLFS require. You may create additional +compatibility links based on your requirements. + +If you only need the GCC-&gcc2-version; libraries, you may delete +/opt/gcc-&gcc2-version;. + +Whenever you need to use GCC-&gcc2-version; instead of your system +installed compiler, add +/opt/gcc-&gcc2-version;/bin to the front of your PATH or (preferably) set the CC +environment variable before compiling the concerned package. + + + + + + +Contents + +The GCC-&gcc2-version; package contains the +gcc-&gcc2-version; C and +C++ compilers and GCC-&gcc2-version; +libstdc++.so that is required by some commercial and +pre-compiled packages. + + diff --git a/general/prog/j2sdk.xml b/general/prog/j2sdk.xml index 0c321ab3e2..ecad921cd6 100644 --- a/general/prog/j2sdk.xml +++ b/general/prog/j2sdk.xml @@ -1,12 +1,408 @@ + + + %general-entities; + + + + + + + +]> + J2SDK-&j2sdk-src-version; -&j2sdk-intro; -&j2sdk-inst; -&j2sdk-exp; -&j2sdk-config; -&j2sdk-desc; + +Introduction to j2sdk + +The J2SDK package contains Sun's +Java development environment. This is useful for +developing Java programs and provides the runtime +environment necessary to run Java programs. It also +includes a plug-in for browsers so that they can be Java + aware. + + +The JDK comes in two flavors, a precompiled binary and a +source package. Previously, the plugin included in the JDK binary +package was unusable on LFS +owing to incompatibilities with GCC-3 compiled browsers. +This is not the case anymore. + +The source package requires registration at the Sun +developer site and accepting the Sun Community Source License. +The source code cannot be downloaded from some countries, so for users +from those countries, the binary may be the only option. + +Even if you plan on compiling the JDK source, you will +need to download the binary version to bootstrap the JDK +build. Follow the link below to download both source and binary packages. When +downloading the source also download the Mozilla +headers package available at the same location. + + + +Package information + +Download (HTTP): + + +Version used (binary): +&j2sdk-bin-version; +Download size (binary): &j2sdk-bin-size; +Download size (source): &j2sdk-src-size; +Estimated Disk space required: +&j2sdk-src-buildsize; +Estimated build time: +&j2sdk-time; + + +Additional downloads + + + + + + + + (Only required if /bin/sh is symlinked to ) + + + + +<application>J2SDK</application> dependencies +Required +X ( or ), , , , , +and + + + + + + +Installation of <application>J2SDK</application> + +Both versions will be installed in parallel. You may choose to keep +either or both. + +Installation of the precompiled JDK is easy: +create a directory to install from, copy the .bin there, and run the +following commands: + +VERSION=&j2sdk-bin-version; && +MV=`echo $VERSION | cut -d "_" -f 1,1` && +V=`echo ${VERSION} | sed -e "s/\./_/g"` && +sed -i "s:^PATH=.*::" j2sdk-${V}-linux-i?86.bin && +chmod +x j2sdk-${V}-linux-i?86.bin && +mkdir -p bin && +ln -sf /bin/true bin/more && +yes | PATH=$PWD/bin:$PATH ./j2sdk-${V}-linux-i?86.bin && +cd j2sdk${VERSION} && +install -d /opt/j2sdk/j2sdk-precompiled-${MV} && +mv * /opt/j2sdk/j2sdk-precompiled-${MV} + +The binary version is now installed. + +If you don't want to compile the source or are not in a postition to download the source +owing to license restrictions, skip ahead to the configuration +section. + +Add the recently compiled JDK to the path. +export JAVA_HOME=/opt/j2sdk/j2sdk-precompiled-${MV} && +export PATH=$PATH:${JAVA_HOME}/bin + +Unzip the source: + +VERSION=&j2sdk-src-version; && +V=`echo $VERSION | sed -e "s/\./_/g"` && +unzip j2sdk-${V}-src-scsl.zip && +unzip j2sdk-${V}-mozilla_headers-unix.zip && +unzip j2sdk-${V}-bin-scsl.zip + +Apply all the patches downloaded above. + +for PATCH in fix-inline-asm-1 gcc33-1 motif-mkmsgcat \ + remove-debug-image remove-fixed-paths-1 \ + static_cxx +do + patch -Np1 -i j2sdk-1.4.2-$PATCH.patch +done + +Set/unset some variables which affect the build: +export ALT_BOOTDIR="$JAVA_HOME" && +unset JAVA_HOME && +unset CLASSPATH +unset CFLAGS +unset CXXFLAGS +unset LDFLAGS +export ALT_DEVTOOLS_PATH="/usr/bin" && +export BUILD_NUMBER="blfs-`date +%s`" && +export DEV_ONLY=true && +export ALT_MOZILLA_PATH=$PWD && +export INSANE=true && +export MAKE_VERBOSE=true && +export ALT_CACERTS_FILE=${ALT_BOOTDIR}/jre/lib/security/cacerts + +Setting CFLAGS/CXXFLAGS/LDFLAGS is guaranteed to make the build fail. +If you are interested in optimizing the build, set OTHER_CFLAGS/OTHER_CXXFLAGS/OTHER_LDFLAGS +instead. + +Additionally, if you would like to make in parallel, add the following +(adjust MAKE_PARALLEL to your liking): +export HOTSPOT_BUILD_JOBS=$MAKE_PARALLEL + +If the included Motif doesn't build properly, the +error is noticed much later in the build. +A solution is to build the Motif +library before compiling the J2SDK. + +cd motif/lib/Xm && +make && +cd ../../.. + +Make and Install J2SDK with the following +commands. There will be a lot of messages about missing files that look like +errors. As long as the build doesn't stop, the messages are harmless, so ignore +them. + +cd control/make && +make && +cd ../.. && +cd control/build/linux-i?86 && +cp -a j2sdk-image /opt/j2sdk/j2sdk-&j2sdk-src-version; + + + + +Command explanations + +export ALT_BOOTDIR="$JAVA_HOME": This var sets +location of the bootstrap JDK. + + +export ALT_MOZILLA_PATH=$PWD: This sets the +variable that points to where you unzipped the Mozilla + headers. + +export ALT_DEVTOOLS_PATH="/usr/bin": This +changes the location where the build finds the needed executables. + + +export BUILD_NUMBER="blfs-`date +%s`": This will +help you identify this compiled version of the runtime environment and +virtual machine by appending this information to the version in the +output to java -version. + +export DEV_ONLY=true: This command +eliminates compiling the documentation and eliminates a dependency for +rpm. + +unset JAVA_HOME: This clears the +JAVA_HOME +variable as recommended by the build instructions. + +unset CLASSPATH: This clears the +CLASSPATH variable as per the recommendations in the build instructions. + + +unset CFLAGS...: These flags cause miscompilation +of the build. Never set these. + +export INSANE=true: Unless you specify that you +are insane the build will not proceed. The certified platform for the build is +Redhat 6.1. The above variable ensures that all the errors related to +compiling on a non-certified platform will be converted to warnings. + +export MAKE_VERBOSE=true: Allows the current +compilation command to be displayed on the console. + +export ALT_CACERTS_FILE...: Specifies the +certificate file to use. + + + + +Configuring <application>J2SDK</application> + +Configuration Information + +We have two Java 2 SDK's installed in +/opt/j2sdk. Decide on which one you +would like to use as the default. For example if you decide to use the source +compiled J2SDK, do the following: + +ln -nsf j2sdk-&j2sdk-src-version; /opt/j2sdk/j2sdk + +Add the following lines to your shell startup file (e.g., +/etc/profile). + +export JAVA_HOME=/opt/j2sdk/j2sdk +export PATH=$PATH:$JAVA_HOME/bin + +Add $JAVA_HOME/man to your +MANPATH variable or to +/etc/man.conf + +The Java plugin is in the directory +$JAVA_HOME/jre/plugin/i?86/ns610/. +Make a symbolic link to the file in that directory from your plugins directory. + + + +Handling CLASSPATH + +When compiling packages, the CLASSPATH environment variable +is used by JDK to locate classes at compile-time and run-time. It is tedious toadd all the classes used to the CLASSPATH manually. You may add +the following lines to your shell startup file to set CLASSPATH +automatically to include all JAR files in a specified directory, which in +the example below is /usr/lib/auto-java-classpath. + +AUTO_CLASSPATH_DIR=/usr/lib/auto-java-classpath +if [ -z $CLASSPATH ] +then + CLASSPATH=.:$AUTO_CLASSPATH_DIR +else + CLASSPATH=$CLASSPATH:.:$AUTO_CLASSPATH_DIR +fi +for i in $(ls $AUTO_CLASSPATH_DIR/*.jar 2>/dev/null) +do + CLASSPATH=$CLASSPATH:$i +done + + + + + + +Contents + +The J2SDK package contains +appletviewer, +extcheck, idlj, +jar, jarsigner, +java, javac, +javadoc, javah, +javap, jdb, +keytool, native2ascii, +orbd, policytool, +rmic, rmid, +rmiregistry, rmiregistry, +serialver, servertool and +tnameserv. + + + +Description + +appletviewer +appletviewer runs +Java applets outside of the context of a +browser. + +extcheck +extcheck checks a specified JAR +file for title and version conflicts with any extensions installed in the +JDK software. + +idlj +idlj generates Java +bindings from a given IDL file. + +jar +jar combines multiple files into a single +JAR archive file. + +jarsigner +jarsigner signs JAR +(Java ARchive) files and verifies the signatures and integrity of a signed +JAR. + +java +java launches a Java +application by starting a Java runtime +environment, loading a specified class and invoking its main +method. + +javac +javac reads class and interface definitions, written +in the Java programming language, and compiles them +into bytecode class files. + +javadoc +javadoc parses the declarations and documentation +comments in a set of Java source files and produces +a corresponding set of HTML pages describing the classes, +interfaces, constructors, methods, and fields. + +javah +javah generates C header +and source files that are needed to implement native methods. + +javap +javap disassembles a +Java class file. + +jdb +jdb is a simple command-line debugger for +Java classes. + +keytool +keytool is a key and certificate management utility. + +native2ascii +native2ascii converts files that contain non-supported +character encoding into files containing Latin-1 or Unicode-encoded characters. + +orbd +orbd is used to enable clients to transparently locate +and invoke persistent objects on servers in the CORBA +environment. + +policytool +policytool creates and manages a policy file +graphically. + +rmic +rmic generates stub and skeleton class files for +remote objects from the names of compiled Java +classes that contain remote object implementations. + +rmid +rmid starts the activation system daemon. + + +rmiregistry +rmiregistry creates and starts a remote object +registry on the specified port on the current host. + +serialver +serialver returns the serialVersionUID for one or +more classes in a form suitable for copying into an evolving class. + + +servertool +servertool provides an ease-of-use interface for +application programmers to register, unregister, startup and shutdown a server. + +tnameserv +tnameserv starts the Java +IDL name server. + + diff --git a/general/prog/librep.xml b/general/prog/librep.xml index 18459e8d68..21e2ecee2c 100644 --- a/general/prog/librep.xml +++ b/general/prog/librep.xml @@ -1,11 +1,98 @@ + + + %general-entities; + + + + + + + +]> + librep-&librep-version; -&librep-intro; -&librep-inst; -&librep-exp; -&librep-desc; + +Introduction to <application>librep</application> + +The librep package contains a Lisp system. +This is useful for scripting or for applications that may use the Lisp +interpreter as an extension language. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &librep-size; +Estimated Disk space required: +&librep-buildsize; +Estimated build time: +&librep-time; + + + +<application>librep</application> dependencies +Required + +Optional +, and + + + + + + +Installation of <application>librep</application> + +Install librep by running the following +commands: + +./configure --prefix=/usr --libexecdir=/usr/lib && +make && +make install + + + + +Command explanations + +--libexecdir=/usr/lib: This command installs +files to /usr/lib/rep instead of +/usr/libexec/rep. + + + + +Contents + +The librep package contains +rep, +rep-config, +rep-remote, +rep-xgettext, +repdoc and +librep libraries. + + + +Description + +rep +rep is the Lisp interpreter. + +librep libraries +librep libraries contain +the functions necessary for the Lisp interpreter. + + diff --git a/general/prog/nasm.xml b/general/prog/nasm.xml index 5971de89f7..6df20a8bdb 100644 --- a/general/prog/nasm.xml +++ b/general/prog/nasm.xml @@ -1,9 +1,66 @@ + + + %general-entities; + + + + + + + +]> + NASM-&NASM-version; -&NASM-intro; -&NASM-inst; -&NASM-desc; + +Introduction to <application><acronym>NASM</acronym></application> + +NASM (Netwide Assembler) is +an 80x86 assembler designed for portability and modularity. It includes a +disassembler as well. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &NASM-size; +Estimated Disk space required: &NASM-buildsize; +Estimated build time: &NASM-time; + + + + + +Installation of <application><acronym>NASM</acronym></application> + +Install NASM by running thefollowing commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The NASM package contains nasm + and ndisasm programs. + + + +Description + +nasm +nasm is a portable 80x86 assembler. + +ndisasm +ndisasm is an 80x86 binary file disassembler. + + diff --git a/general/prog/perl-modules.xml b/general/prog/perl-modules.xml index 973e41861a..943dfd86b0 100644 --- a/general/prog/perl-modules.xml +++ b/general/prog/perl-modules.xml @@ -1,9 +1,93 @@ + + + %general-entities; + + + + + + + + +]> + Perl modules -&perl-modules-intro; -&perl-modules-inst; + +Introduction to <application>Perl</application> modules + +The Perl module packages add useful objects +to the Perl language. Modules utilized by packages +throughout BLFS are listed here, along with their +dependencies. + +Perl Packages + +PDL-&PDL-version; + +Astro-FITS-Header-&Astro-FITS-Header-version; + +Gtk-Perl-&Gtk-Perl-version; + +XML-Writer-&XML-Writer-version; + +XML-Parser-&XML-Parser-version; + + +Parse-RecDescent-&Parse-RecDescent-version; + + + + + + +Installation of <application>Perl</application> modules + +Install Perl modules by running the following +commands: + +perl Makefile.PL && +make && +make install + +The module listed below requires a modification in order to install +successfully. + +Gtk-Perl-&Gtk-Perl-version;: + +perl Makefile.PL --without-guessing && +make && +make install + + + +(Alternate) Auto installation of <application>Perl</application> +modules. + +There is an alternate way of installing the modules using +Perl's built-in install command. +The command automatically downloads the source from the CPANarchive, extracts it, runs the commands mentioned above, and removes +the build tree. + +Start the perl shell with the commands: + +perl -MCPAN -e shell +Each module may now be installed from this shell with the command: +install <moduleName> + +For additional commands and help, type help. + + diff --git a/general/prog/prog.xml b/general/prog/prog.xml index f3182c3bd9..b1d602d2d1 100644 --- a/general/prog/prog.xml +++ b/general/prog/prog.xml @@ -1,3 +1,10 @@ + + + %general-entities; +]> + Programming @@ -9,15 +16,15 @@ platform, however the base system only includes language support for build many popular programming environments to greatly expand your system's development capabilities. -&Python; -&perl-modules; -&librep; -&j2sdk; -&ruby; -&gcc; -&tcl; -&tk; -&gcc2; -&NASM; + + + + + + + + + + diff --git a/general/prog/python.xml b/general/prog/python.xml index 69b8abc73b..3da1fa4c42 100644 --- a/general/prog/python.xml +++ b/general/prog/python.xml @@ -1,10 +1,85 @@ + + + %general-entities; + + + + + + + +]> + Python-&Python-version; -&Python-intro; -&Python-inst; -&Python-desc; + +Introduction to <application>Python</application> + +The Python package contains the +Python development environment. +This is useful for object-oriented programming, writing scripts, +prototyping large programs or developing entire applications. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &Python-size; +Estimated Disk space required: &Python-buildsize; +Estimated build time: &Python-time; + + +Additional downloads + +Required patch (HTTP): + + + +<application>Python</application> dependencies +Optional +, , , , and + + + + + + + +Installation of <application>Python</application> + +Install Python by running the following commands: + +patch -Np1 -i ../Python-&Python-version;-gdbm-2.patch && +./configure --prefix=/usr --enable-shared && +make && +make install + + + + +Contents + +The Python package contains python and +pydoc. + + + +Description + +python +python is an interpreted, interactive, object-oriented programming +language. + +pydoc +pydoc is the Python documentation tool. + + diff --git a/general/prog/ruby.xml b/general/prog/ruby.xml index be2aea603f..4cdd75aad3 100644 --- a/general/prog/ruby.xml +++ b/general/prog/ruby.xml @@ -1,10 +1,74 @@ + + + %general-entities; + + + + + + + +]> + Ruby-&ruby-version; -&ruby-intro; -&ruby-inst; -&ruby-desc; + +Introduction to <application>Ruby</application> + +The Ruby package contains the +Ruby development environment. This +is useful for object-oriented scripting. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &ruby-size; +Estimated Disk space required: &ruby-buildsize; +Estimated build time: &ruby-time; + + + + + +Installation of <application>Ruby</application> + +Install Ruby by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Contents + +The Ruby package contains +ruby, +irb, +erb, +rdoc, +ri and +testrb. + + + +Description + +ruby +ruby is an interpreted scripting language for quick +and easy object-oriented programming. + +irb +irb is the interactive interface for ruby. + + + diff --git a/general/prog/tcl.xml b/general/prog/tcl.xml index eadb3df105..615059fe1f 100644 --- a/general/prog/tcl.xml +++ b/general/prog/tcl.xml @@ -1,9 +1,92 @@ + + + %general-entities; + + + + + + + +]> + Tcl-&tcl-version; -&tcl-intro; -&tcl-inst; -&tcl-exp; + +Introduction to <application>Tcl</application> + +The Tcl package contains Tool Command Language. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &tcl-size; +Estimated Disk space required: +&tcl-buildsize; +Estimated build time: +&tcl-time; + + + + + +Installation of <application>Tcl</application> + +This package is also installed in LFS +during the bootstrap phase. The significant difference between the +two installations (other than installing to /usr) is to install +the package in such a way that there is no need to keep the build +directory around after installation. + +Install Tcl by running the following commands: + +VERSION=&tcl-version; && +V=`echo $VERSION | cut -d "." -f 1,2` && +DIR=$PWD && +cd unix && +./configure --prefix=/usr && +make && +sed -i "s:${DIR}/unix:/usr/lib:" tclConfig.sh && +sed -i "s:${DIR}:/usr/include/tcl${V}:" tclConfig.sh && +sed -i "s,^TCL_LIB_FILE='libtcl${V}..TCL_DBGX..so',TCL_LIB_FILE=\"libtcl${V}\$\{TCL_DBGX\}.so\"," \ + tclConfig.sh && +mv ../doc/{,Tcl_}Thread.3 && +sed -i 's/ Thread.3/ Tcl_Thread.3/' mkLinks && +make install && +install -d /usr/include/tcl${V}/unix && +install -m644 *.h /usr/include/tcl${V}/unix/ && +install -d /usr/include/tcl${V}/generic && +install -c -m644 ../generic/*.h /usr/include/tcl${V}/generic/ && +rm -f /usr/include/tcl${V}/generic/{tcl,tclDecls,tclPlatDecls}.h && +ln -nsf /usr/include/tcl${V} /usr/lib/tcl${V}/include && +ln -sf libtcl${V}.so /usr/lib/libtcl.so && +ln -sf tclsh${V} /usr/bin/tclsh + + + + +Command explanations + +sed -i ...: The Tcl +package assumes that the source that is used to build Tcl + is always kept around for compiling packages that depend on +Tcl. These sed's remove the +reference to the build directory and replace them by saner system wide +locations. + +install ...: These commands install the internal +headers into a system-wide location. + +ln -sf ...: These commands create compatibility +symbolic links. + + diff --git a/general/prog/tk.xml b/general/prog/tk.xml index fdeeb07d73..68bf15efaa 100644 --- a/general/prog/tk.xml +++ b/general/prog/tk.xml @@ -1,9 +1,88 @@ + + + %general-entities; + + + + + + + +]> + Tk-&tk-version; -&tk-intro; -&tk-inst; -&tk-exp; + +Introduction to <application>Tk</application> + +The Tk package contains +TCL GUI Toolkit. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &tk-size; +Estimated Disk space required: +&tk-buildsize; +Estimated build time: +&tk-time; + + +<application>Tk</application> dependencies +Required +X ( or ) and + + + + + +Installation of <application>Tk</application> + +Install Tk by running the following commands: + +VERSION=&tk-version; && +V=`echo $VERSION | cut -d "." -f 1,2` && +DIR=$PWD && +cd unix && +./configure --prefix=/usr && +make && +sed -i "s:${DIR}/unix:/usr/lib:" tkConfig.sh && +sed -i "s:${DIR}:/usr/include/tk${V}:" tkConfig.sh && +make install && +install -d /usr/include/tk${V}/unix && +install -m644 *.h /usr/include/tk${V}/unix/ && +install -d /usr/include/tk${V}/generic && +install -m644 ../generic/*.h /usr/include/tk${V}/generic/ && +rm -f /usr/include/tk${V}/generic/{tk,tkDecls,tkPlatDecls}.h && +ln -nsf /usr/include/tk${V} /usr/lib/tk${V}/include && +ln -sf libtk${V}.so /usr/lib/libtk.so && +ln -sf wish${V} /usr/bin/wish + + + + +Command explanations + +sed -i ...: The Tk package +assumes that the source that is used to build Tk is +always kept around for compiling packages that depend on +Tk. These sed's remove the +reference to the build directory and replace them by saner system wide +locations. + +install ...: These commands install the internal +headers into a system-wide location. + +ln -sf ...: These commands create compatibility +symbolic links. + + diff --git a/general/sysutils/cpio.xml b/general/sysutils/cpio.xml index a005700911..ddb5bfb563 100644 --- a/general/sysutils/cpio.xml +++ b/general/sysutils/cpio.xml @@ -1,11 +1,95 @@ + + + %general-entities; + + + + + + + +]> + cpio-&cpio-version; -&cpio-intro; -&cpio-inst; -&cpio-exp; -&cpio-desc; + +Introduction to <application>cpio</application> + + +The cpio package contains +tools for archiving. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &cpio-size; +Estimated Disk space required: +&cpio-buildsize; +Estimated build time: +&cpio-time; + + + + + + +Installation of <application>cpio</application> + +Install cpio by running the following commands: + + +./configure --prefix=/usr --libexecdir=/tmp/cpio \ + --bindir=/bin && +make && +make install && +rm -rf /tmp/cpio + + + + +Command explanations + +--libexec=/tmp/cpio: This command installs +rmt to /tmp/cpio so +that it can be removed. The rmt executable is already +installed by the tar package in +LFS. + +--bindir=/bin: This command installs +cpio to /bin instead +of /usr/bin as per +FHS guidelines. + + + + +Contents + +The cpio package contains cpio + and mt. + + + +Description + +cpio +cpio copies files to and from archives. +mt +mt controls magnetic tape drive operations. + + + + diff --git a/general/sysutils/fcron.xml b/general/sysutils/fcron.xml index c4873ed002..530411e37e 100644 --- a/general/sysutils/fcron.xml +++ b/general/sysutils/fcron.xml @@ -1,12 +1,168 @@ + + + %general-entities; + + + + + + + +]> + Fcron-&fcron-version; -&fcron-intro; -&fcron-inst; -&fcron-exp; -&fcron-config; -&fcron-desc; + +Introduction to <application>Fcron</application> + +The Fcron package contains a periodical +command scheduler which aims at replacing Vixie +Cron. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &fcron-size; +Estimated Disk space required: &fcron-buildsize; +Estimated build time: &fcron-time; + + +<application>Fcron</application> dependencies +Optional + +MTA, +, +SELinux, + and + + + + + + + +Installation of <application>Fcron</application> + +Fcron uses the cron facility of +syslog +to log all messages. Since LFS does not set up this +facility in /etc/syslog.conf, it needs to be done +prior to installing Fcron. This command will append +the necessary line to the current /etc/syslog.conf: +cat >> /etc/syslog.conf << "EOF" +# Begin fcron addition to /etc/syslog.conf + +cron.* -/var/log/cron.log + +# End fcron addition +EOF + +The configuration file has been modified, so reloading the +sysklogd daemon will activate the changes. + +/etc/rc.d/init.d/sysklogd reload + +For security reasons, we need to create an unprivileged user and +group for fcron: + +groupadd fcron && +useradd -d /dev/null -g fcron -s /bin/false fcron + +Install Fcron by running the following commands: + +./configure --without-sendmail --with-answer-all=no && +make && +make install + + + + +Command explanations + +: Fcron +will use an iinstalled MTA to email you the results of the +fcron script. If you wish to utilize this feature, change +the switch to --with-sendmail=[path to your +MTA] . + +--with-answer-all=no: After the files are +installed, the make install script enters into a +configuration routine. The first test will be whether to install a boot scriptin the /etc/rc.d/init.d directory with +the appropriate symbolic links in run levels 2, 3, 4, and 5. The second is to +stop any current fcron processes and start a new one. Since this is probably +your first install and we want a boot script based upon the +BLFS template, we answer 'n' to both tests. + +--with-dsssl-dir=/usr/share/sgml/docbook/dsssl-stylesheets-&docbook-dsssl-version; +: This switch can be added if you have installed +OpenJade and dsssl-stylesheets to generate the +documentation from the DocBook source files. + + + + +Configuring <application>Fcron</application> + +Config files + +/etc/fcron.conf, +/etc/fcron.allow, +/etc/fcron.deny + + + +Configuration Information + +There are no required changes in any of the config files. +Configuration information can be found in the man page for +fcron.conf. + +fcron scripts are written using fcrontab. +Refer to the fcrontab man page for proper parameters to address your situation. + +Install the /etc/rc.d/init.d/fcron +init script from the package. + + +make install-fcron + + + + + + +Contents + +The Fcron package contains +fcron, fcrontab, fcronsighup + and fcrondyn. + + + +Description + +fcron +fcron is the scheduling daemon. + + +fcrontab +fcrontab is the program used to install, edit, list +and remove the tables used by fcron. + +fcronsighup +fcronsighup instructs fcron to +reread the fcron tables. + +fcrondyn +fcrondyn is a user tool intended to interact with a +running fcron daemon. + + diff --git a/general/sysutils/gpm.xml b/general/sysutils/gpm.xml index 33f89fd979..273904f168 100644 --- a/general/sysutils/gpm.xml +++ b/general/sysutils/gpm.xml @@ -1,11 +1,159 @@ + + + %general-entities; + + + + + + + +]> + <acronym>GPM</acronym>-&gpm-version; -&gpm-intro; -&gpm-inst; -&gpm-exp; -&gpm-config; -&gpm-desc; + +Introduction to <application><acronym>GPM</acronym></application> + +The GPM (General +Purpose Mouse daemon) package contains a mouse server for the console +and xterm. It not only provides cut and paste support +generally, but its library component is used by various software such as +Links to provide mouse support to the +application. It is useful on desktops, especially if following +(Beyond) Linux From Scratch instructions; it's often much easier (and +less error prone) to cut and paste between two console windows than to +type everything by hand! + +Package information + +Download (HTTP): +Download (FTP): +Download size: &gpm-size; +Estimated Disk space required: +&gpm-buildsize; +Estimated build time: +&gpm-time; + + +Additional downloads + +Recommended patch: +Recommended patch: + + + + + + +Installation of <application><acronym>GPM</acronym></application> + +Install GPM by running the following commands: + + +patch -Np1 -i ../gpm-1.20.1-segfault.patch && +patch -Np1 -i ../gpm-1.20.1-silent.patch && +LDFLAGS="-lm" ./configure --prefix=/usr --sysconfdir=/etc && +make && +make install && +cp conf/gpm-root.conf /etc && +ldconfig -n -l /usr/lib/libgpm.so.1.19.0 + + + +Command explanations + +LDFLAGS="-lm": The math library + must be linked with gpm, as ceil() is used in some cursor +scrolling logic. + +ldconfig -n -l : During installation, gpm outputs a +message to run the above command to create the proper library links. + + + + +Configuring <application><acronym>GPM</acronym></application> + +gpm init.d script +Install the /etc/rc.d/init.d/gpm +init script included in the + package. + +make install-gpm + + + +Config files +/etc/sysconfig/mouse +This file contains the name of your mouse device and the protocol which +it uses. To create this file, run the following: + +cat > /etc/sysconfig/mouse << "EOF" +# Begin /etc/sysconfig/mouse + +MDEVICE=[yourdevice] +PROTOCOL=[yourprotocol] + +# End /etc/sysconfig/mouse +EOF + + +Configuration Information + +Examples of values to set MDEVICE and +PROTOCOL to are: + +MDEVICE=/dev/psaux +PROTOCOL=imps2 + +A list of which protocol values are known can be found by running +gpm -t -help. Your MDEVICE setting depends on +which type of mouse you have. For example, +/dev/ttyS0 for a serial mouse (on Windows this is +COM1), /dev/input/mice is often used for +USB mice +and /dev/psaux for PS2 mice. + + + + + + +Contents + +The GPM package contains +gpm, +gpm-root, disable-paste +and mev. + + + +Description + +gpm +gpm is a cut and paste utility and mouse server for +virtual consoles. + +gpm-root +gpm-root is a default handler for +gpm. It is used to draw menus on the +root window. + +disable-paste +No description available. + +mev +mev is a program to report mouse events. + + diff --git a/general/sysutils/hdparm.xml b/general/sysutils/hdparm.xml index 8b931d023b..5a366aabda 100644 --- a/general/sysutils/hdparm.xml +++ b/general/sysutils/hdparm.xml @@ -1,10 +1,92 @@ + + + %general-entities; + + + + + + + +]> + hdparm-&hdparm-version; -&hdparm-intro; -&hdparm-inst; -&hdparm-desc; + +Introduction to <application>hdparm</application> + +The hdparm package contains a +utility that is useful for controlling ATA/IDE + controllers and hard drives both to increase +performance and sometimes to increase stability. + +As well as being useful, incorrect usage of +hdparm can destroy your information and in +rare cases, drives. Use with caution and make sure you know what you are +doing. If in doubt, we recommend you leave the default kernel parameters +alone. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &hdparm-size; +Estimated Disk space required: &hdparm-buildsize; +Estimated build time: &hdparm-time; + + +Additional downloads + +Required Patch: + + + + + +Installation of <application>hdparm</application> + +First apply the required patch: + +patch -Np1 -i ../hdparm-&hdparm-version;-glibc_CVS-1.patch + +Install hdparm by running the following commands: + +make && +make install + +Note that by default, hdparm is installed in +/sbin as some systems may require it +during the boot process before /usr +is mounted. If you wish to install hdparm under the +/usr hierarchy, then replace the above +commands with the following: + +make && +make binprefix=/usr install + + + + +Contents + +The hdparm package contains hdparm. + + + +Description + +hdparm +hdparm provides a command-line interface to various hard disk +ioctls supported by the stock Linux +ATA/IDE device driver +subsystem. + + diff --git a/general/sysutils/mc.xml b/general/sysutils/mc.xml index b5facec2fa..8801ca07eb 100644 --- a/general/sysutils/mc.xml +++ b/general/sysutils/mc.xml @@ -1,10 +1,112 @@ + + + %general-entities; + + + + + + + +]> + <acronym>MC</acronym>-&mc-version; -&mc-intro; -&mc-inst; -&mc-config; -&mc-desc; + +Introduction to +<application><acronym>MC</acronym></application> + +MC +(Midnight Commander) is a text-mode full-screen file manager and visual +shell. It provides a clear, user-friendly, and somewhat protected +interface to a Unix system while making many frequent file operations +more efficient and preserving the full power of the command +prompt. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &mc-size; +Estimated Disk space required: &mc-buildsize;Estimated build time: &mc-time; + + +<application><acronym>MC</acronym></application> dependencies +Required + or + +Optional + +, +X ( or ), +, +, +, + and + + + + + + + +Installation of +<application><acronym>MC</acronym></application> + +Install MC by +running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Configuring <application><acronym>MC</acronym></application> + +Config files +~/.mc/* + + +Configuration Information + +The ~/.mc directory and +its contents are created when you start mc for the +first time. Then you can edit the main ~/.mc/ini configuration +file manually or through the MC shell. +Consult the mc(1) man page for details. + + + + + + +Contents + +The MC package +contains mc, mcedit, +mcmfmt and mcview. + + + +Description + +mc +mc is a visual shell. + +mcedit +mcedit is an internal file +editor. + +mcview +mcview is an internal file +viewer. + + diff --git a/general/sysutils/pciutils.xml b/general/sysutils/pciutils.xml index ff2ed4e2e8..d5a52cb719 100644 --- a/general/sysutils/pciutils.xml +++ b/general/sysutils/pciutils.xml @@ -1,9 +1,81 @@ + + + %general-entities; + + + + + + + +]> + PCI Utilities-&pciutils-version; -&pciutils-intro; -&pciutils-inst; -&pciutils-desc; + +Introduction to <application><acronym>PCI</acronym> Utilities</application> + +The PCI Utilities package is a set of programs +for listing PCI devices, inspecting their status and +setting their configuration registers. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &pciutils-size; +Estimated Disk space required: &pciutils-buildsize; +Estimated build time: &pciutils-time; + + +<application><acronym>PCI</acronym> Utilities</application> dependencies +Required + + + + + + + +Installation of <application><acronym>PCI</acronym> Utilities</application> + +Install PCI Utilities by +running the following commands: + +make PREFIX=/usr && +make PREFIX=/usr install + + + + +Contents + +The PCI Utilities package +contains lspci, +setpci and update-pciids. + + + +Description + +lspci +lspci is a utility for displaying information +about all PCI buses in the system and all devices +connected to them. + +setpci +setpci is a utility for querying and +configuring PCI devices. + +update-pciids +update-pciids fetches the current version of +the PCI ID list. Requires or + + diff --git a/general/sysutils/pkgconfig.xml b/general/sysutils/pkgconfig.xml index 63d326d9cf..68c153537a 100644 --- a/general/sysutils/pkgconfig.xml +++ b/general/sysutils/pkgconfig.xml @@ -1,11 +1,78 @@ + + + %general-entities; + + + + + + + +]> + pkgconfig-&pkgconfig-version; -&pkgconfig-intro; -&pkgconfig-inst; -&pkgconfig-config; -&pkgconfig-desc; + +Introduction to <application>pkgconfig</application> + +The pkgconfig package contains +tools for passing the include path and/or library paths to build tools during +the make file execution. + +Package information + +Download (HTTP): +Download (FTP): +Download size: &pkgconfig-size; +Estimated Disk space required: &pkgconfig-buildsize; +Estimated build time: &pkgconfig-time; + + + + + + +Installation of <application>pkgconfig</application> + +Install pkgconfig by running the following commands: + +./configure --prefix=/usr && +make && +make install + + + + +Configuring <application>pkgconfig</application> + +The default setting for PKG_CONFIG_PATH is +/usr/lib/pkgconfig because of the prefix we use to +install pkgconfig. You may add to PKG_CONFIG_PATH by exporting +additional paths on your system where pkgconfig files are installed. Note +that PKG_CONFIG_PATH is only needed when compiling packages, +not during run-time. + + + + +Contents + +The pkgconfig package contains +pkg-config. + + + +Description + +pkg-config +pkg-config is a function that returns meta information for the +specified library. + + diff --git a/general/sysutils/sysutils.xml b/general/sysutils/sysutils.xml index fa8b853823..f1929a8876 100644 --- a/general/sysutils/sysutils.xml +++ b/general/sysutils/sysutils.xml @@ -1,3 +1,10 @@ + + + %general-entities; +]> + System Utilities @@ -6,15 +13,15 @@ some applications used by other applications in the book for installation purposes. -&gpm; -&fcron; -&hdparm; -&which; -&unzip; -&zip; -&pciutils; -&pkgconfig; -&cpio; -&mc; + + + + + + + + + + diff --git a/general/sysutils/unzip.xml b/general/sysutils/unzip.xml index 27fb12c116..95b7ebe908 100644 --- a/general/sysutils/unzip.xml +++ b/general/sysutils/unzip.xml @@ -1,10 +1,127 @@ + + + %general-entities; + + + + + + + +]> + UnZip-&unzip-version; -&unzip-intro; -&unzip-inst; -&unzip-exp; -&unzip-desc; + +Introduction to <application>UnZip</application> + +The UnZip package contains ZIP + extraction utilities. These are useful for extracting files from +ZIP archives. ZIP archives are +created with PKZIP or Info-ZIP + utilities primarily in a DOS environment. + + +Package information + +Download (HTTP): +Download (FTP): +Download size: &unzip-size; +Estimated Disk space required: +&unzip-buildsize; +Estimated build time: +&unzip-time; + + +Additional downloads + +Required patch: Required patch: +Recommended patch: + + + + + +Installation of <application>UnZip</application> + +By default, UnZip does not support shrink +decompression. To enable it or to obtain more information, check out the +UnZip FAQ at +. + +Install UnZip by running the following +commands: + +patch -Np1 -i ../unzip-&unzip-version;-fix-Makefile.patch && +patch -Np1 -i ../unzip-&unzip-version;-fix-libz.patch && +patch -Np1 -i ../unzip-&unzip-version;-dont-make-noise.patch && +cp unix/Makefile . && +make prefix=/usr linux && +make prefix=/usr linux_shlibz && +make prefix=/usr install && +cp -a libunzip.so* /usr/lib + + + + +Command explanations + +make prefix=/usr linux: This command +overrides the prefix variable that is set to +/usr/local in the +Makefile +and builds the executables for a linux system. The alternatives to +'linux' can be seen with a 'make list' command. + +make prefix=/usr linux_shlibz: Build shared +libunzip and link UnZip against +it and zlib. + + + + +Contents + +The UnZip package contains unzip +, funzip, unzipfsx, +zipgrep and zipinfo. + + + +Description + +unzip +unzip lists, tests or extracts files from a +ZIP archive. + +funzip +funzip allows the output of unzip +commands to be redirected. + +unzipfsx +unzipfsx is the self-extracting stub that can be +prepended to a ZIP archive. Files in this format allow +the recipient to decompress the archive without installing +UnZip. + +zipgrep +zipgrep is a grep for ZIP +archives. + +zipinfo +zipinfo produces technical information about the files +in a ZIP archive, including file access permissions, +encryption status, type of compression, etc. + + diff --git a/general/sysutils/which.xml b/general/sysutils/which.xml index ea572d33f4..4bfa7cebc7 100644 --- a/general/sysutils/which.xml +++ b/general/sysutils/which.xml @@ -1,3 +1,16 @@ + + + %general-entities; + + + + + + +]> + which-&which-version; and alternatives @@ -12,11 +25,55 @@ is for you to decide. The first option is to install the actual GNU program which. -&which-intro; -&which-inst; -&which-desc; + +Introduction to <application>which</application> + +Package information + +Download (HTTP): +Download (FTP): +Download size: &which-size; +Estimated Disk space required: +&which-buildsize; +Estimated build time: +&which-time; + + + + -The 'which' script + +Installation of <application>which</application> + +Install which by running the following +commands: + +./configure --prefix=/usr && +make && +make install + + + + + +Contents + +The which package contains which. + + + +Description + +which +which shows the full path of (shell) commands. + + + + + +The 'which' script The second option (for those who don't want to install the program) is to create a simple script: cat > /usr/bin/which << "EOF" diff --git a/general/sysutils/zip.xml b/general/sysutils/zip.xml index cd80cc93a2..7231f7fde5 100644 --- a/general/sysutils/zip.xml +++ b/general/sysutils/zip.xml @@ -1,10 +1,97 @@ + + + %general-entities; + + + + + + + +]> + Zip-&zip-version; -&zip-intro; -&zip-inst; -&zip-exp; -&zip-desc; + +Introduction to <application>Zip</application> + + +The Zip package contains +Zip utilities. These +are useful for compressing files into ZIP archives. +Package information + +Download (HTTP): +Download (FTP): +Download size: &zip-size; +Estimated Disk space required: +&zip-buildsize; +Estimated build time: +&zip-time; + + + + + + +Installation of <application>Zip</application> + +Install Zip by running the following commands: + +cp unix/Makefile . && +make prefix=/usr generic_gcc && +make prefix=/usr install + + + + +Command explanations + +make prefix=/usr generic_gcc: This command +overrides the prefix variable that is set to +/usr/local in the +Makefile +and builds the executables for a linux system. The alternatives to +'generic_gcc' can be seen with a make list command. + + + + +Contents + +The Zip package contains zip +, zipcloak, zipnote and +zipsplit. + + + +Description + +zip +zip compresses files into a +ZIP archive. + +zipcloak +zipcloak is disabled in this version of +Zip. It will +display a message about how to support encryption by recompiling with +zcrypt27.zip. + +zipnote +zipnote reads or writes comments stored in a +ZIP file. + +zipsplit +zipsplit is a utility to split +ZIP files into smaller files. + + + diff --git a/gnome/core/scrollkeeper/scrollkeeper-intro.xml b/gnome/core/scrollkeeper/scrollkeeper-intro.xml index 5d0fd71cd4..f73e5cbdd9 100644 --- a/gnome/core/scrollkeeper/scrollkeeper-intro.xml +++ b/gnome/core/scrollkeeper/scrollkeeper-intro.xml @@ -1,4 +1,5 @@ + Introduction to <application>ScrollKeeper</application> The ScrollKeeper package contains a cataloging system for diff --git a/index.xml b/index.xml index 662f474350..17a7e249ae 100644 --- a/index.xml +++ b/index.xml @@ -30,8 +30,8 @@ %introduction; %postlfs; --> %general; - - + %server; %content; %x; @@ -55,8 +55,7 @@ -&general; - + &server;