[lfs-fr] r4592 - trunk/blfs/traduc/commits

myou72 at orange.fr myou72 at orange.fr
Jeu 3 Oct 08:23:43 PDT 2013


Author: myou72
Date: 2013-10-03 17:23:43 +0200 (Thu, 03 Oct 2013)
New Revision: 4592

Added:
   trunk/blfs/traduc/commits/r44.txt
Log:
[BLFS-EN] r44.txt

Added: trunk/blfs/traduc/commits/r44.txt
===================================================================
--- trunk/blfs/traduc/commits/r44.txt	                        (rev 0)
+++ trunk/blfs/traduc/commits/r44.txt	2013-10-03 15:23:43 UTC (rev 4592)
@@ -0,0 +1,10986 @@
+Révision 3
+
+fichiers ajoutés :
+   basicnet/basicnet.ent
+   basicnet/djb/daemontools.xml
+   basicnet/djb/daemontools/daemontools-man-intro.xml
+   basicnet/djb/daemontools/daemontools-man-exp.xml
+   basicnet/djb/daemontools/daemontools-man-inst.xml
+   basicnet/djb/daemontools/daemontools-man-desc.xml
+   basicnet/djb/daemontools/daemontools.ent
+   basicnet/djb/daemontools/daemontools-intro.xml
+   basicnet/djb/daemontools/daemontools-exp.xml
+   basicnet/djb/daemontools/daemontools-inst.xml
+   basicnet/djb/daemontools/daemontools-desc.xml
+   basicnet/djb/daemontools
+   basicnet/djb/ucspi-tcp.xml
+   basicnet/djb/ucspi-tcp/ucspi-tcp.ent
+   basicnet/djb/ucspi-tcp/ucspi-tcp-intro.xml
+   basicnet/djb/ucspi-tcp/ucspi-tcp-exp.xml
+   basicnet/djb/ucspi-tcp/ucspi-tcp-inst.xml
+   basicnet/djb/ucspi-tcp/ucspi-tcp-desc.xml
+   basicnet/djb/ucspi-tcp
+   basicnet/djb/daemontools-man.xml
+   basicnet/djb/djb.xml
+   basicnet/djb
+   basicnet/mailnews/other.xml
+   basicnet/mailnews/procmail.xml
+   basicnet/mailnews/procmail/procmail.ent
+   basicnet/mailnews/procmail
+   basicnet/mailnews/mutt.xml
+   basicnet/mailnews/mutt/mutt.ent
+   basicnet/mailnews/mutt
+   basicnet/mailnews/pine.xml
+   basicnet/mailnews/fetchmail.xml
+   basicnet/mailnews/pine/pine.ent
+   basicnet/mailnews/pine
+   basicnet/mailnews/fetchmail/fetchmail-intro.xml
+   basicnet/mailnews/fetchmail/fetchmail-exp.xml
+   basicnet/mailnews/fetchmail/fetchmail-inst.xml
+   basicnet/mailnews/fetchmail/fetchmail-desc.xml
+   basicnet/mailnews/fetchmail/fetchmail-config.xml
+   basicnet/mailnews/fetchmail/fetchmail.ent
+   basicnet/mailnews/fetchmail
+   basicnet/mailnews/slrn.xml
+   basicnet/mailnews/mailnews.xml
+   basicnet/mailnews/slrn/slrn.ent
+   basicnet/mailnews/slrn
+   basicnet/mailnews
+   basicnet/netlibs/curl.xml
+   basicnet/netlibs/curl/curl.ent
+   basicnet/netlibs/curl/curl-intro.xml
+   basicnet/netlibs/curl/curl-inst.xml
+   basicnet/netlibs/curl/curl-desc.xml
+   basicnet/netlibs/curl/curl-config.xml
+   basicnet/netlibs/curl
+   basicnet/netlibs/wvstreams.xml
+   basicnet/netlibs/wvstreams/wvstreams-config.xml
+   basicnet/netlibs/wvstreams/wvstreams.ent
+   basicnet/netlibs/wvstreams/wvstreams-intro.xml
+   basicnet/netlibs/wvstreams/wvstreams-inst.xml
+   basicnet/netlibs/wvstreams/wvstreams-desc.xml
+   basicnet/netlibs/wvstreams
+   basicnet/netlibs/netlibs.xml
+   basicnet/netlibs
+   basicnet/netprogs/wget/wget.ent
+   basicnet/netprogs/wget
+   basicnet/netprogs/ncftp.xml
+   basicnet/netprogs/cvs.xml
+   basicnet/netprogs/ncftp/ncftp-config.xml
+   basicnet/netprogs/ncftp/ncftp.ent
+   basicnet/netprogs/ncftp/ncftp-intro.xml
+   basicnet/netprogs/ncftp/ncftp-exp.xml
+   basicnet/netprogs/ncftp/ncftp-inst.xml
+   basicnet/netprogs/ncftp/ncftp-desc.xml
+   basicnet/netprogs/ncftp
+   basicnet/netprogs/openssh-client.xml
+   basicnet/netprogs/telnet.xml
+   basicnet/netprogs/cvs/cvs-config.xml
+   basicnet/netprogs/cvs/cvs.ent
+   basicnet/netprogs/cvs/cvs-intro.xml
+   basicnet/netprogs/cvs/cvs-inst.xml
+   basicnet/netprogs/cvs/cvs-desc.xml
+   basicnet/netprogs/cvs
+   basicnet/netprogs/netprogs.xml
+   basicnet/netprogs/wget.xml
+   basicnet/netprogs
+   basicnet/textweb/w3m.xml
+   basicnet/textweb/w3m/w3m.ent
+   basicnet/textweb/w3m
+   basicnet/textweb/lynx.xml
+   basicnet/textweb/lynx/lynx-config.xml
+   basicnet/textweb/lynx/lynx.ent
+   basicnet/textweb/lynx/lynx-intro.xml
+   basicnet/textweb/lynx/lynx-exp.xml
+   basicnet/textweb/lynx/lynx-inst.xml
+   basicnet/textweb/lynx/lynx-desc.xml
+   basicnet/textweb/lynx
+   basicnet/textweb/links.xml
+   basicnet/textweb/links/links-config.xml
+   basicnet/textweb/links/links.ent
+   basicnet/textweb/links/links-intro.xml
+   basicnet/textweb/links/links-inst.xml
+   basicnet/textweb/links/links-desc.xml
+   basicnet/textweb/links
+   basicnet/textweb/textweb.xml
+   basicnet/textweb
+   basicnet/basicnet.xml
+   basicnet/netutils/netutils.xml
+   basicnet/netutils/whois.xml
+   basicnet/netutils/whois/whois.ent
+   basicnet/netutils/whois
+   basicnet/netutils/nmap.xml
+   basicnet/netutils/nmap/nmap.ent
+   basicnet/netutils/nmap
+   basicnet/netutils/traceroute.xml
+   basicnet/netutils/traceroute/traceroute.ent
+   basicnet/netutils/traceroute/traceroute-intro.xml
+   basicnet/netutils/traceroute/traceroute-exp.xml
+   basicnet/netutils/traceroute/traceroute-inst.xml
+   basicnet/netutils/traceroute/traceroute-desc.xml
+   basicnet/netutils/traceroute
+   basicnet/netutils
+   basicnet
+   connect/other/isdn.xml
+   connect/other/other.xml
+   connect/other/pppoe.xml
+   connect/other
+   connect/connect.xml
+   connect/connect.ent
+   connect/dhcp/dhcp.xml
+   connect/dhcp/config.xml
+   connect/dhcp/dhcpcd.xml
+   connect/dhcp/dhcpcd/dhcpcd-exp.xml
+   connect/dhcp/dhcpcd/dhcpcd-inst.xml
+   connect/dhcp/dhcpcd/dhcpcd-desc.xml
+   connect/dhcp/dhcpcd/dhcpcd-config.xml
+   connect/dhcp/dhcpcd/dhcpcd.ent
+   connect/dhcp/dhcpcd/dhcpcd-intro.xml
+   connect/dhcp/dhcpcd
+   connect/dhcp/dhcp-client.xml
+   connect/dhcp
+   connect/dialup/wvdial.xml
+   connect/dialup/wvdial/wvdial-config.xml
+   connect/dialup/wvdial/wvdial.ent
+   connect/dialup/wvdial/wvdial-intro.xml
+   connect/dialup/wvdial/wvdial-inst.xml
+   connect/dialup/wvdial/wvdial-desc.xml
+   connect/dialup/wvdial
+   connect/dialup/dialup.xml
+   connect/dialup/ppp.xml
+   connect/dialup/ppp/ppp-config.xml
+   connect/dialup/ppp/ppp.ent
+   connect/dialup/ppp/ppp-intro.xml
+   connect/dialup/ppp/ppp-inst.xml
+   connect/dialup/ppp/ppp-desc.xml
+   connect/dialup/ppp
+   connect/dialup
+   connect
+   book/authorgroup.xml
+   book/book.ent
+   book/abstract.xml
+   book/dedication.xml
+   book/bookinfo.xml
+   book/legalnotice.xml
+   book/library-config.xml
+   book/copyright.xml
+   book/book.xml
+   book
+   multimedia/audioutils/lame.xml
+   multimedia/audioutils/lame/lame.ent
+   multimedia/audioutils/lame
+   multimedia/audioutils/CDParanoia.xml
+   multimedia/audioutils/audioutils.xml
+   multimedia/audioutils/cdparanoia/CDParanoia-config.xml
+   multimedia/audioutils/cdparanoia/cdparanoia.ent
+   multimedia/audioutils/cdparanoia/CDParanoia-intro.xml
+   multimedia/audioutils/cdparanoia/CDParanoia-inst.xml
+   multimedia/audioutils/cdparanoia/CDParanoia-desc.xml
+   multimedia/audioutils/cdparanoia
+   multimedia/audioutils/XMMS.xml
+   multimedia/audioutils/vorbistools.xml
+   multimedia/audioutils/xmms/xmms.ent
+   multimedia/audioutils/xmms/XMMS-intro.xml
+   multimedia/audioutils/xmms/XMMS-exp.xml
+   multimedia/audioutils/xmms/XMMS-inst.xml
+   multimedia/audioutils/xmms/XMMS-desc.xml
+   multimedia/audioutils/xmms/XMMS-config.xml
+   multimedia/audioutils/xmms
+   multimedia/audioutils/vorbistools/vorbistools-intro.xml
+   multimedia/audioutils/vorbistools/vorbistools-inst.xml
+   multimedia/audioutils/vorbistools/vorbistools-desc.xml
+   multimedia/audioutils/vorbistools/vorbistools.ent
+   multimedia/audioutils/vorbistools
+   multimedia/audioutils/mpg123.xml
+   multimedia/audioutils/mpg123/mpg123.ent
+   multimedia/audioutils/mpg123/mpg123-intro.xml
+   multimedia/audioutils/mpg123/mpg123-exp.xml
+   multimedia/audioutils/mpg123/mpg123-inst.xml
+   multimedia/audioutils/mpg123/mpg123-desc.xml
+   multimedia/audioutils/mpg123
+   multimedia/audioutils
+   multimedia/cdwriteutils/kernel.xml
+   multimedia/cdwriteutils/cdwriteutils.xml
+   multimedia/cdwriteutils/cdrtools.xml
+   multimedia/cdwriteutils/cdrtools/cdrtools.ent
+   multimedia/cdwriteutils/cdrtools/cdrtools-intro.xml
+   multimedia/cdwriteutils/cdrtools/cdrtools-exp.xml
+   multimedia/cdwriteutils/cdrtools/cdrtools-inst.xml
+   multimedia/cdwriteutils/cdrtools/cdrtools-desc.xml
+   multimedia/cdwriteutils/cdrtools
+   multimedia/cdwriteutils/cdrdao.xml
+   multimedia/cdwriteutils/cdrdao/cdrdao-inst.xml
+   multimedia/cdwriteutils/cdrdao/cdrdao-desc.xml
+   multimedia/cdwriteutils/cdrdao/cdrdao.ent
+   multimedia/cdwriteutils/cdrdao/cdrdao-intro.xml
+   multimedia/cdwriteutils/cdrdao
+   multimedia/cdwriteutils
+   multimedia/videoutils/videoutils.xml
+   multimedia/videoutils/mplayer.xml
+   multimedia/videoutils/mplayer/mplayer.ent
+   multimedia/videoutils/mplayer
+   multimedia/videoutils/avifile.xml
+   multimedia/videoutils/avifile/avifile.ent
+   multimedia/videoutils/avifile
+   multimedia/videoutils/xine.xml
+   multimedia/videoutils
+   multimedia/multimedia.xml
+   multimedia/libdriv/libao/libao-intro.xml
+   multimedia/libdriv/libao/libao-exp.xml
+   multimedia/libdriv/libao/libao-inst.xml
+   multimedia/libdriv/libao/libao-desc.xml
+   multimedia/libdriv/libao/libao-config.xml
+   multimedia/libdriv/libao/libao.ent
+   multimedia/libdriv/libao
+   multimedia/libdriv/arts.xml
+   multimedia/libdriv/libdriv.xml
+   multimedia/libdriv/libvorbis.xml
+   multimedia/libdriv/esound.xml
+   multimedia/libdriv/esound/esound.ent
+   multimedia/libdriv/esound
+   multimedia/libdriv/alsa.xml
+   multimedia/libdriv/alsa/alsa-cards.xml
+   multimedia/libdriv/alsa/alsa-exp.xml
+   multimedia/libdriv/alsa/alsa-inst.xml
+   multimedia/libdriv/alsa/alsa-desc.xml
+   multimedia/libdriv/alsa/alsa-config.xml
+   multimedia/libdriv/alsa/alsa.ent
+   multimedia/libdriv/alsa/alsa-intro.xml
+   multimedia/libdriv/alsa
+   multimedia/libdriv/audiofile.xml
+   multimedia/libdriv/SDL.xml
+   multimedia/libdriv/audiofile/audiofile-config.xml
+   multimedia/libdriv/audiofile/audiofile.ent
+   multimedia/libdriv/audiofile/audiofile-intro.xml
+   multimedia/libdriv/audiofile/audiofile-inst.xml
+   multimedia/libdriv/audiofile/audiofile-desc.xml
+   multimedia/libdriv/audiofile
+   multimedia/libdriv/libogg.xml
+   multimedia/libdriv/sdl/SDL-config.xml
+   multimedia/libdriv/sdl/sdl.ent
+   multimedia/libdriv/sdl/SDL-intro.xml
+   multimedia/libdriv/sdl/SDL-exp.xml
+   multimedia/libdriv/sdl/SDL-inst.xml
+   multimedia/libdriv/sdl/SDL-desc.xml
+   multimedia/libdriv/sdl
+   multimedia/libdriv/libao.xml
+   multimedia/libdriv
+   multimedia/multimedia.ent
+   multimedia
+   postlfs/postlfs.ent
+   postlfs/config/bootdisk.xml
+   postlfs/config/logon.xml
+   postlfs/config/profile.xml
+   postlfs/config/random.xml
+   postlfs/config/vimrc.xml
+   postlfs/config/inputrc.xml
+   postlfs/config/config.xml
+   postlfs/config/manpages.xml
+   postlfs/config
+   postlfs/filesystems/xfs.xml
+   postlfs/filesystems/ext3.xml
+   postlfs/filesystems/filesystems.xml
+   postlfs/filesystems/reiser.xml
+   postlfs/filesystems
+   postlfs/security/security.xml
+   postlfs/security/pam.xml
+   postlfs/security/nessus.xml
+   postlfs/security/syslog.xml
+   postlfs/security/firewalling.xml
+   postlfs/security/iptables.xml
+   postlfs/security/firewalling/busybox.xml
+   postlfs/security/firewalling/intro.xml
+   postlfs/security/firewalling/disclaimer.xml
+   postlfs/security/firewalling/credits.xml
+   postlfs/security/firewalling/finale.xml
+   postlfs/security/firewalling/extrainfo.xml
+   postlfs/security/firewalling/kernel.xml
+   postlfs/security/firewalling/masqrouter.xml
+   postlfs/security/firewalling/status.xml
+   postlfs/security/firewalling/writing.xml
+   postlfs/security/firewalling/library.xml
+   postlfs/security/firewalling/stop.xml
+   postlfs/security/firewalling/persfw.xml
+   postlfs/security/firewalling/firewalling.ent
+   postlfs/security/firewalling
+   postlfs/security/iptables/iptables.ent
+   postlfs/security/iptables/iptables-intro.xml
+   postlfs/security/iptables/iptables-exp.xml
+   postlfs/security/iptables/iptables-inst.xml
+   postlfs/security/iptables/iptables-desc.xml
+   postlfs/security/iptables
+   postlfs/security/shadow.xml
+   postlfs/security/tripwire.xml
+   postlfs/security
+   postlfs/editors/emacs.xml
+   postlfs/editors/editors.xml
+   postlfs/editors/nano.xml
+   postlfs/editors/vim.xml
+   postlfs/editors/joe.xml
+   postlfs/editors
+   postlfs/postlfs.xml
+   postlfs/shells/shells.xml
+   postlfs/shells/tcsh.xml
+   postlfs/shells/zsh.xml
+   postlfs/shells
+   postlfs
+   README
+   xsoft/xsoft.ent
+   xsoft/office/gnumeric/gnumeric.ent
+   xsoft/office/gnumeric
+   xsoft/office/magicpoint.xml
+   xsoft/office/magicpoint/magicpoint.ent
+   xsoft/office/magicpoint
+   xsoft/office/office.xml
+   xsoft/office/gimp.xml
+   xsoft/office/gimp/gimp.ent
+   xsoft/office/gimp
+   xsoft/office/abiword.xml
+   xsoft/office/abiword/abiword.ent
+   xsoft/office/abiword
+   xsoft/office/gnucash.xml
+   xsoft/office/gnucash/gnucash.ent
+   xsoft/office/gnucash
+   xsoft/office/gnumeric.xml
+   xsoft/office
+   xsoft/suites/suites.xml
+   xsoft/suites/openoffice.xml
+   xsoft/suites/openoffice/openoffice.ent
+   xsoft/suites/openoffice
+   xsoft/suites/koffice.xml
+   xsoft/suites/koffice/koffice.ent
+   xsoft/suites/koffice
+   xsoft/suites
+   xsoft/graphweb/mozilla.xml
+   xsoft/graphweb/konq.xml
+   xsoft/graphweb/mozilla/mozilla.ent
+   xsoft/graphweb/mozilla
+   xsoft/graphweb/graphweb.xml
+   xsoft/graphweb/galeon.xml
+   xsoft/graphweb/galeon/galeon.ent
+   xsoft/graphweb/galeon
+   xsoft/graphweb
+   xsoft/other/other.xml
+   xsoft/other
+   xsoft/xsoft.xml
+   xsoft
+   kde/other/other.xml
+   kde/other
+   kde/kde.xml
+   kde/add/add.xml
+   kde/add
+   kde/kde.ent
+   kde/kde-intro.xml
+   kde/inst/kde-libs.xml
+   kde/inst/kde-network.xml
+   kde/inst/kde-artwork.xml
+   kde/inst/kde-multimedia.xml
+   kde/inst/kde-games.xml
+   kde/inst/kde-bindings.xml
+   kde/inst/objprelink.xml
+   kde/inst/kde-toys.xml
+   kde/inst/kde-graphics.xml
+   kde/inst/kde-utils.xml
+   kde/inst/kde-addons.xml
+   kde/inst/kdevelop.xml
+   kde/inst/kdm.xml
+   kde/inst/kde-base.xml
+   kde/inst/kde-edu.xml
+   kde/inst/kdoc.xml
+   kde/inst/kde-sdk.xml
+   kde/inst/kde-pim.xml
+   kde/inst/kde-admin.xml
+   kde/inst
+   kde
+   gnome/other/other.xml
+   gnome/other
+   gnome/gnome.xml
+   gnome/config/config.xml
+   gnome/config
+   gnome/lib/gdk.xml
+   gnome/lib/lib.xml
+   gnome/lib/gdk-config.xml
+   gnome/lib/gdk-intro.xml
+   gnome/lib/gdk-inst.xml
+   gnome/lib/gdk-desc.xml
+   gnome/lib
+   gnome/add/add.xml
+   gnome/add
+   gnome/gnome.ent
+   gnome
+   preface/preface.ent
+   preface/organtemp.xml
+   preface/organization.xml
+   preface/preface.xml
+   preface/foreword.xml
+   preface/whoread.xml
+   preface
+   server/server.xml
+   server/server.ent
+   server/other/xinetd.xml
+   server/other/bind.xml
+   server/other/xinetd/xinetd.ent
+   server/other/xinetd
+   server/other/bind/bind.ent
+   server/other/bind
+   server/other/leafnode.xml
+   server/other/dhcp.xml
+   server/other/leafnode/leafnode.ent
+   server/other/leafnode
+   server/other/dhcp/dhcp-intro.xml
+   server/other/dhcp/dhcp-exp.xml
+   server/other/dhcp/dhcp-inst.xml
+   server/other/dhcp/dhcp-desc.xml
+   server/other/dhcp/dhcp-config.xml
+   server/other/dhcp/dhcp.ent
+   server/other/dhcp
+   server/other/openssh.xml
+   server/other/openssh/openssh-intro.xml
+   server/other/openssh/openssh-exp.xml
+   server/other/openssh/openssh-inst.xml
+   server/other/openssh/openssh-desc.xml
+   server/other/openssh/openssh-config.xml
+   server/other/openssh/openssh.ent
+   server/other/openssh
+   server/other/other.xml
+   server/other/cvsserver.xml
+   server/other/samba.xml
+   server/other/samba/samba.ent
+   server/other/samba
+   server/other
+   server/mail/postfix.xml
+   server/mail/sendmail.xml
+   server/mail/postfix/postfix-intro.xml
+   server/mail/postfix/postfix-inst.xml
+   server/mail/postfix/postfix-desc.xml
+   server/mail/postfix/postfix-config.xml
+   server/mail/postfix/postfix.ent
+   server/mail/postfix
+   server/mail/sendmail/sendmail.ent
+   server/mail/sendmail
+   server/mail/exim.xml
+   server/mail/mail.xml
+   server/mail/exim/exim.ent
+   server/mail/exim
+   server/mail/qmail.xml
+   server/mail/qmail/qmail.ent
+   server/mail/qmail
+   server/mail/qpopper.xml
+   server/mail/qpopper/qpopper.ent
+   server/mail/qpopper
+   server/mail/courier.xml
+   server/mail/courier/courier.ent
+   server/mail/courier
+   server/mail
+   server
+   pst/pst.xml
+   pst/printing/printing.xml
+   pst/printing
+   pst/pst.ent
+   pst/typesetting/typesetting.xml
+   pst/typesetting
+   pst/scanning/scanning.xml
+   pst/scanning
+   pst
+   INSTALL
+   index.xml
+   x/installing/dri.xml
+   x/installing/truetype.xml
+   x/installing/installing.xml
+   x/installing/xfree86.xml
+   x/installing/xfree86/xfree86-config.xml
+   x/installing/xfree86/xfree86.ent
+   x/installing/xfree86/xfree86-intro.xml
+   x/installing/xfree86/xfree86-exp.xml
+   x/installing/xfree86/xfree86-inst.xml
+   x/installing/xfree86/xfree86-desc.xml
+   x/installing/xfree86
+   x/installing
+   x/lib/atk/atk.ent
+   x/lib/atk/atk-intro.xml
+   x/lib/atk/atk-inst.xml
+   x/lib/atk/atk-desc.xml
+   x/lib/atk/atk-config.xml
+   x/lib/atk
+   x/lib/gtk+.xml
+   x/lib/gtk+2.xml
+   x/lib/pango.xml
+   x/lib/qt.xml
+   x/lib/pango/pango-intro.xml
+   x/lib/pango/pango-inst.xml
+   x/lib/pango/pango-desc.xml
+   x/lib/pango/pango-config.xml
+   x/lib/pango/pango.ent
+   x/lib/pango
+   x/lib/qt/qt.ent
+   x/lib/qt/qt-intro.xml
+   x/lib/qt/qt-exp.xml
+   x/lib/qt/qt1-intro.xml
+   x/lib/qt/qt-inst.xml
+   x/lib/qt/qt-desc.xml
+   x/lib/qt/qt1-inst.xml
+   x/lib/qt/qt-config.xml
+   x/lib/qt
+   x/lib/gtk/gtk+-intro.xml
+   x/lib/gtk/gtk+-inst.xml
+   x/lib/gtk/gtk+2-intro.xml
+   x/lib/gtk/gtk.ent
+   x/lib/gtk/gtk+-desc.xml
+   x/lib/gtk/gtk+2-inst.xml
+   x/lib/gtk/gtk+2-desc.xml
+   x/lib/gtk/gtk+-config.xml
+   x/lib/gtk/gtk+2-config.xml
+   x/lib/gtk
+   x/lib/lib.xml
+   x/lib/lesstif.xml
+   x/lib/lesstif/lesstif.ent
+   x/lib/lesstif
+   x/lib/atk.xml
+   x/lib
+   x/x.xml
+   x/x.ent
+   x/wm/enlightenment.xml
+   x/wm/enlightenment/enlightenment.ent
+   x/wm/enlightenment
+   x/wm/wm.xml
+   x/wm/sawfish.xml
+   x/wm/sawfish/sawfish.ent
+   x/wm/sawfish
+   x/wm/fluxbox.xml
+   x/wm/fluxbox/fluxbox.ent
+   x/wm/fluxbox
+   x/wm
+   x
+   blfs.dsl
+   content/databases/db.xml
+   content/databases/mysql.xml
+   content/databases/db/db.ent
+   content/databases/db/db-intro.xml
+   content/databases/db/db-exp.xml
+   content/databases/db/db-inst.xml
+   content/databases/db/db-desc.xml
+   content/databases/db/db-config.xml
+   content/databases/db
+   content/databases/mysql/mysql.ent
+   content/databases/mysql
+   content/databases/databases.xml
+   content/databases
+   content/content.xml
+   content/web/web.xml
+   content/web/apache.xml
+   content/web/apache/apache.ent
+   content/web/apache
+   content/web/php.xml
+   content/web/php/php.ent
+   content/web/php
+   content/web
+   content/content.ent
+   content
+   appendices/appendices.xml
+   appendices/appendices.ent
+   appendices/symlinks/rc0.xml
+   appendices/symlinks/rc1.xml
+   appendices/symlinks/rc2.xml
+   appendices/symlinks/rc3.xml
+   appendices/symlinks/rc4.xml
+   appendices/symlinks/rc5.xml
+   appendices/symlinks/symlinks.xml
+   appendices/symlinks/rc6.xml
+   appendices/symlinks
+   appendices
+   template/template.xml
+   template/README
+   template/template-config.xml
+   template/template-intro.xml
+   template/template-exp.xml
+   template/template-inst.xml
+   template/template-desc.xml
+   template/newitem
+   template
+   general/prog/python.xml
+   general/prog/prog.xml
+   general/prog/jdk.xml
+   general/prog
+   general/graphlib/graphlib.xml
+   general/graphlib/libmng.xml
+   general/graphlib/libmng/libmng.ent
+   general/graphlib/libmng/libmng-intro.xml
+   general/graphlib/libmng/libmng-exp.xml
+   general/graphlib/libmng/libmng-inst.xml
+   general/graphlib/libmng/libmng-desc.xml
+   general/graphlib/libmng/libmng-config.xml
+   general/graphlib/libmng
+   general/graphlib/libpng.xml
+   general/graphlib/imlib.xml
+   general/graphlib/libjpeg.xml
+   general/graphlib/libpng/libpng.ent
+   general/graphlib/libpng/libpng-intro.xml
+   general/graphlib/libpng/libpng-exp.xml
+   general/graphlib/libpng/libpng-inst.xml
+   general/graphlib/libpng/libpng-desc.xml
+   general/graphlib/libpng/libpng-config.xml
+   general/graphlib/libpng
+   general/graphlib/imlib/imlib-config.xml
+   general/graphlib/imlib/imlib.ent
+   general/graphlib/imlib/imlib-intro.xml
+   general/graphlib/imlib/imlib-inst.xml
+   general/graphlib/imlib/imlib-desc.xml
+   general/graphlib/imlib
+   general/graphlib/libjpeg/libjpeg-intro.xml
+   general/graphlib/libjpeg/libjpeg-exp.xml
+   general/graphlib/libjpeg/libjpeg-inst.xml
+   general/graphlib/libjpeg/libjpeg-desc.xml
+   general/graphlib/libjpeg/libjpeg-config.xml
+   general/graphlib/libjpeg/libjpeg.ent
+   general/graphlib/libjpeg
+   general/graphlib/lcms.xml
+   general/graphlib/lcms/lcms-config.xml
+   general/graphlib/lcms/lcms.ent
+   general/graphlib/lcms/lcms-intro.xml
+   general/graphlib/lcms/lcms-exp.xml
+   general/graphlib/lcms/lcms-inst.xml
+   general/graphlib/lcms/lcms-desc.xml
+   general/graphlib/lcms
+   general/graphlib/libtiff.xml
+   general/graphlib/libungif.xml
+   general/graphlib/libtiff/libtiff-exp.xml
+   general/graphlib/libtiff/libtiff-inst.xml
+   general/graphlib/libtiff/libtiff-desc.xml
+   general/graphlib/libtiff/libtiff-config.xml
+   general/graphlib/libtiff/libtiff.ent
+   general/graphlib/libtiff/libtiff-intro.xml
+   general/graphlib/libtiff
+   general/graphlib/libungif/libungif.ent
+   general/graphlib/libungif/libungif-intro.xml
+   general/graphlib/libungif/libungif-inst.xml
+   general/graphlib/libungif/libungif-desc.xml
+   general/graphlib/libungif/libungif-config.xml
+   general/graphlib/libungif
+   general/graphlib
+   general/genutils/bc.xml
+   general/genutils/bc/bc.ent
+   general/genutils/bc
+   general/genutils/genutils.xml
+   general/genutils
+   general/general.xml
+   general/sysutils/pciutils/pciutils.ent
+   general/sysutils/pciutils
+   general/sysutils/sysutils.xml
+   general/sysutils/zip.xml
+   general/sysutils/which.xml
+   general/sysutils/which/which.ent
+   general/sysutils/which/which-intro.xml
+   general/sysutils/which/which-inst.xml
+   general/sysutils/which/which-desc.xml
+   general/sysutils/which
+   general/sysutils/unzip.xml
+   general/sysutils/fcron.xml
+   general/sysutils/pkgconfig.xml
+   general/sysutils/fcron/fcron-inst.xml
+   general/sysutils/fcron/fcron-desc.xml
+   general/sysutils/fcron/fcron-config.xml
+   general/sysutils/fcron/fcron.ent
+   general/sysutils/fcron/fcron-intro.xml
+   general/sysutils/fcron/fcron-exp.xml
+   general/sysutils/fcron
+   general/sysutils/pkgconfig/pkgconfig.ent
+   general/sysutils/pkgconfig/pkgconfig-intro.xml
+   general/sysutils/pkgconfig/pkgconfig-inst.xml
+   general/sysutils/pkgconfig/pkgconfig-desc.xml
+   general/sysutils/pkgconfig
+   general/sysutils/hdparm.xml
+   general/sysutils/hdparm/hdparm.ent
+   general/sysutils/hdparm/hdparm-intro.xml
+   general/sysutils/hdparm/hdparm-inst.xml
+   general/sysutils/hdparm/hdparm-desc.xml
+   general/sysutils/hdparm
+   general/sysutils/pccts.xml
+   general/sysutils/gpm.xml
+   general/sysutils/gpm/gpm-desc.xml
+   general/sysutils/gpm/gpm-config.xml
+   general/sysutils/gpm/gpm.ent
+   general/sysutils/gpm/gpm-intro.xml
+   general/sysutils/gpm/gpm-inst.xml
+   general/sysutils/gpm
+   general/sysutils/whichtemp.xml
+   general/sysutils/pciutils.xml
+   general/sysutils
+   general/genlib/libxml2.xml
+   general/genlib/pcre.xml
+   general/genlib/libfam.xml
+   general/genlib/pcre/pcre-inst.xml
+   general/genlib/pcre/pcre-desc.xml
+   general/genlib/pcre/pcre-config.xml
+   general/genlib/pcre/pcre.ent
+   general/genlib/pcre/pcre-intro.xml
+   general/genlib/pcre
+   general/genlib/libfam/libfam.ent
+   general/genlib/libfam
+   general/genlib/genlib.xml
+   general/genlib/zlib.xml
+   general/genlib/libxslt.xml
+   general/genlib/popt.xml
+   general/genlib/openssl.xml
+   general/genlib/popt/popt.ent
+   general/genlib/popt
+   general/genlib/openssl/openssl.ent
+   general/genlib/openssl/openssl-intro.xml
+   general/genlib/openssl/openssl-exp.xml
+   general/genlib/openssl/openssl-inst.xml
+   general/genlib/openssl/openssl-desc.xml
+   general/genlib/openssl/openssl-config.xml
+   general/genlib/openssl
+   general/genlib/slang.xml
+   general/genlib/slang/slang.ent
+   general/genlib/slang
+   general/genlib/libxml.xml
+   general/genlib
+   general/general.ent
+   general
+   introduction/welcome/contact.xml
+   introduction/welcome/welcome.xml
+   introduction/welcome/credits.xml
+   introduction/welcome/maillists.xml
+   introduction/welcome/which.xml
+   introduction/welcome/newsserver.xml
+   introduction/welcome/acknowledgments.xml
+   introduction/welcome/conventions.xml
+   introduction/welcome/version.xml
+   introduction/welcome/askhelp.xml
+   introduction/welcome/changelog.xml
+   introduction/welcome
+   introduction/important/important.xml
+   introduction/important/unpacking.xml
+   introduction/important/beyond.xml
+   introduction/important/position.xml
+   introduction/important
+   introduction/introduction.xml
+   introduction/introduction.ent
+   introduction
+A       BOOK
+
+Log :
+xmms intro update, postfix script change, dri typo
+
+Le robot a traité -114493 % du commit anglais
+
+ATTENTION : il faut relire les fichiers suivants qui sont ajoutés
+Index: content/web/php.xml
+===================================================================
+--- content/web/php.xml	(révision 0)
++++ content/web/php.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="php" xreflabel="php">
++<?dbhtml filename="php.html" dir="content"?>
++<title>php</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: content/web/php/php.ent
+===================================================================
+--- content/web/php/php.ent	(révision 0)
++++ content/web/php/php.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY php SYSTEM "../php.xml">
+Index: content/web/web.xml
+===================================================================
+--- content/web/web.xml	(révision 0)
++++ content/web/web.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<chapter id="content-web">
++<?dbhtml filename="web.html" dir="content"?>
++<title>Web serving</title>
++
++&apache;
++&php;
++
++</chapter>
+Index: content/web/apache.xml
+===================================================================
+--- content/web/apache.xml	(révision 0)
++++ content/web/apache.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="apache" xreflabel="apache">
++<?dbhtml filename="apache.html" dir="content"?>
++<title>apache</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: content/web/apache/apache.ent
+===================================================================
+--- content/web/apache/apache.ent	(révision 0)
++++ content/web/apache/apache.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY apache SYSTEM "../apache.xml">
+Index: content/content.ent
+===================================================================
+--- content/content.ent	(révision 0)
++++ content/content.ent	(révision 3)
+@@ -0,0 +1,15 @@
++<!ENTITY content SYSTEM "content.xml">
++
++<!-- Database software -->
++<!ENTITY content-databases SYSTEM "databases/databases.xml">
++<!ENTITY % db SYSTEM "databases/db/db.ent">
++<!ENTITY % mysql SYSTEM "databases/mysql/mysql.ent">
++%db;
++%mysql;
++
++<!-- Web server software -->
++<!ENTITY content-web SYSTEM "web/web.xml">
++<!ENTITY % apache SYSTEM "web/apache/apache.ent">
++<!ENTITY % php SYSTEM "web/php/php.ent">
++%apache;
++%php;
+Index: content/databases/db.xml
+===================================================================
+--- content/databases/db.xml	(révision 0)
++++ content/databases/db.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="db" xreflabel="db-&db-version;">
++<?dbhtml filename="db.html" dir="content"?>
++<title>db-&db-version;</title>
++
++&db-intro;
++&db-inst;
++&db-exp;
++&db-config;
++&db-desc;
++
++</sect1>
++
+Index: content/databases/mysql.xml
+===================================================================
+--- content/databases/mysql.xml	(révision 0)
++++ content/databases/mysql.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="mysql" xreflabel="mysql">
++<?dbhtml filename="mysql.html" dir="content"?>
++<title>mysql</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: content/databases/db/db-config.xml
+===================================================================
+--- content/databases/db/db-config.xml	(révision 0)
++++ content/databases/db/db-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring db</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: content/databases/db/db.ent
+===================================================================
+--- content/databases/db/db.ent	(révision 0)
++++ content/databases/db/db.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY db SYSTEM "../db.xml">
++<!ENTITY db-intro SYSTEM "db-intro.xml">
++<!ENTITY db-inst SYSTEM "db-inst.xml">
++<!ENTITY db-exp SYSTEM "db-exp.xml">
++<!ENTITY db-desc SYSTEM "db-desc.xml">
++<!ENTITY db-config SYSTEM "db-config.xml">
++<!ENTITY db-buildsize "23 MB">
++<!ENTITY db-version "4.0.14">
++<!ENTITY db-download "http://www.sleepycat.com/update/snapshot/db-4.0.14.tar.gz">
++<!ENTITY db-size "2.6 MB">
+Index: content/databases/db/db-intro.xml
+===================================================================
+--- content/databases/db/db-intro.xml	(révision 0)
++++ content/databases/db/db-intro.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Introduction to db</title>
++
++<screen>Download location:              &db-download;
++Version used:                   &db-version;
++Package size:                   &db-size;
++Estimated Disk space required:  &db-buildsize;</screen>
++
++<para>The db package contains db_archive, db_checkpoint,
++db_deadlock, db_dump, db_load, db_printlog, db_recover, db_stat,
++db_upgrade, db_verify and the db libraries.  These are used by many
++other programs for db related functions.</para>
++
++</sect2>
+Index: content/databases/db/db-exp.xml
+===================================================================
+--- content/databases/db/db-exp.xml	(révision 0)
++++ content/databases/db/db-exp.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>cd build_unix && ../dist/configure --prefix=/usr --enable-compat185 :</userinput>
++This replaces the normal ./configure command as db comes with the various 
++build directories for different platforms.</para>
++
++<para><userinput>make docdir=/usr/share/doc/db-&db-version; 
++install :</userinput> This installs db installing the documentation in
++the correct place.</para>
++
++</sect2>
++
+Index: content/databases/db/db-inst.xml
+===================================================================
+--- content/databases/db/db-inst.xml	(révision 0)
++++ content/databases/db/db-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of db</title>
++
++<para>Install db by running the following commands:</para>
++
++<para><screen><userinput>cd build_unix &&
++../dist/configure --prefix=/usr --enable-compat185 &&
++make &&
++make docdir=/usr/share/doc/db-&db-version; install</userinput></screen></para>
++
++</sect2>
+Index: content/databases/db/db-desc.xml
+===================================================================
+--- content/databases/db/db-desc.xml	(révision 0)
++++ content/databases/db/db-desc.xml	(révision 3)
+@@ -0,0 +1,48 @@
++<sect2>
++<title>Contents</title>
++
++<para>The db package contains <userinput>db_archive, db_checkpoint,
++db_deadlock, db_dump, db_load, db_printlog, db_recover, db_stat,
++db_upgrade, db_verify</userinput> and the <userinput>db
++libraries</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>db_archive</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db_checkpoint</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db_deadlock</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db_dump</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db_load</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db_printlog</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db_recover</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db_stat</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db_upgrade</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db_verify</title>
++<para>No description available</para></sect3>
++
++<sect3><title>db libraries</title>
++<para>These are used by many other programs to perform db linked
++functions.</para></sect3>
++
++</sect2>
++
+Index: content/databases/mysql/mysql.ent
+===================================================================
+--- content/databases/mysql/mysql.ent	(révision 0)
++++ content/databases/mysql/mysql.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY mysql SYSTEM "../mysql.xml">
+Index: content/databases/databases.xml
+===================================================================
+--- content/databases/databases.xml	(révision 0)
++++ content/databases/databases.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<chapter id="content-databases">
++<?dbhtml filename="databases.html" dir="content"?>
++<title>Databases</title>
++
++&db;
++&mysql;
++
++</chapter>
+Index: content/content.xml
+===================================================================
+--- content/content.xml	(révision 0)
++++ content/content.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<part id="content" xreflabel="Content Serving">
++<?dbhtml filename="content.html" dir="content"?>
++<title>Content Serving</title>
++
++&content-databases;
++&content-web;
++
++</part>
+Index: appendices/symlinks/rc0.xml
+===================================================================
+--- appendices/symlinks/rc0.xml	(révision 0)
++++ appendices/symlinks/rc0.xml	(révision 3)
+@@ -0,0 +1,111 @@
++<sect2>
++
++<title>rc0.d</title>
++
++<table frame="none">
++<title>rc0.d symlinks</title>
++
++<tgroup cols="4">
++<colspec colnum="1" colwidth="1*" align="left"/>
++<colspec colnum="2" colwidth="7*" align="left"/>
++<colspec colnum="3" colwidth="21*" align="left"/>
++<colspec colnum="4" colwidth="30*" align="left"/>
++
++<tbody>
++
++<row>
++<entry><emphasis>Number</emphasis></entry>
++<entry><emphasis>Title</emphasis></entry>
++<entry><emphasis>Link</emphasis></entry>
++<entry><emphasis>Explanation</emphasis></entry>
++</row>
++
++<row>
++<entry>K10</entry>
++<entry>gpm</entry>
++<entry><filename>../init.d/gpm</filename></entry>
++<entry>Shut down General Purpose Mouse Daemon: <xref linkend="gpm"/></entry>
++</row>
++
++<row>
++<entry>K25</entry>
++<entry>postfix</entry>
++<entry><filename>../init.d/postfix</filename></entry>
++<entry>Shut down Postfix MTA: <xref linkend="postfix"/></entry>
++</row>
++
++<row>
++<entry>K30</entry>
++<entry>sshd</entry>
++<entry><filename>../init.d/sshd</filename></entry>
++<entry>Shut down Secure Shell Daemon: <xref linkend="openssh"/></entry>
++</row>
++
++<row>
++<entry>K35</entry>
++<entry>alsa</entry>
++<entry><filename>../init.d/alsa</filename></entry>
++<entry>Save volume settings: <xref linkend="alsa"/></entry>
++</row>
++
++<row>
++<entry>K40</entry>
++<entry>sysklogd</entry>
++<entry><filename>../init.d/sysklogd</filename></entry>
++<entry>Stop system and kernel logging: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K45</entry>
++<entry>random</entry>
++<entry><filename>../init.d/random</filename></entry>
++<entry>Save random seed: <xref linkend="postlfs-config-random"/></entry>
++</row>
++
++<row>
++<entry>K50</entry>
++<entry>sendsignals</entry>
++<entry><filename>../init.d/sendsignals</filename></entry>
++<entry>Kill processes: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K60</entry>
++<entry>mountfs</entry>
++<entry><filename>../init.d/mountfs</filename></entry>
++<entry>Unmount all filesystems: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K70</entry>
++<entry>swap</entry>
++<entry><filename>../init.d/swap</filename></entry>
++<entry>Turn off swap: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K80</entry>
++<entry>network</entry>
++<entry><filename>../init.d/network</filename></entry>
++<entry>Shut down networking: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K90</entry>
++<entry>localnet</entry>
++<entry><filename>../init.d/localnet</filename></entry>
++<entry>Remove loopback interface: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K99</entry>
++<entry>halt</entry>
++<entry><filename>../init.d/halt</filename></entry>
++<entry>Shut down system: Part of LFS base.</entry>
++</row>
++
++</tbody>
++</tgroup>
++</table>
++
++</sect2>
+Index: appendices/symlinks/rc1.xml
+===================================================================
+--- appendices/symlinks/rc1.xml	(révision 0)
++++ appendices/symlinks/rc1.xml	(révision 3)
+@@ -0,0 +1,69 @@
++<sect2>
++
++<title>rc1.d</title>
++
++<table frame="none">
++<title>rc1.d symlinks</title>
++
++<tgroup cols="4">
++<colspec colnum="1" colwidth="1*" align="left"/>
++<colspec colnum="2" colwidth="7*" align="left"/>
++<colspec colnum="3" colwidth="21*" align="left"/>
++<colspec colnum="4" colwidth="30*" align="left"/>
++
++<tbody>
++
++<row>
++<entry><emphasis>Number</emphasis></entry>
++<entry><emphasis>Title</emphasis></entry>
++<entry><emphasis>Link</emphasis></entry>
++<entry><emphasis>Explanation</emphasis></entry>
++</row>
++
++<row>
++<entry>K10</entry>
++<entry>gpm</entry>
++<entry><filename>../init.d/gpm</filename></entry>
++<entry>Shut down General Purpose Mouse Daemon: <xref linkend="gpm"/></entry>
++</row>
++
++<row>
++<entry>K25</entry>
++<entry>postfix</entry>
++<entry><filename>../init.d/postfix</filename></entry>
++<entry>Shut down Postfix MTA: <xref linkend="postfix"/></entry>
++</row>
++
++<row>
++<entry>K30</entry>
++<entry>sshd</entry>
++<entry><filename>../init.d/sshd</filename></entry>
++<entry>Shut down Secure Shell Daemon: <xref linkend="openssh"/></entry>
++</row>
++
++<row>
++<entry>K35</entry>
++<entry>alsa</entry>
++<entry><filename>../init.d/alsa</filename></entry>
++<entry>Save volume settings: <xref linkend="alsa"/></entry>
++</row>
++
++<row>
++<entry>K80</entry>
++<entry>sysklogd</entry>
++<entry><filename>../init.d/sysklogd</filename></entry>
++<entry>Shut down networking: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K90</entry>
++<entry>network</entry>
++<entry><filename>../init.d/network</filename></entry>
++<entry>Shut down networking: Part of LFS base.</entry>
++</row>
++
++</tbody>
++</tgroup>
++</table>
++
++</sect2>
+Index: appendices/symlinks/rc2.xml
+===================================================================
+--- appendices/symlinks/rc2.xml	(révision 0)
++++ appendices/symlinks/rc2.xml	(révision 3)
+@@ -0,0 +1,76 @@
++<sect2>
++
++<title>rc2.d</title>
++
++<table frame="none">
++<title>rc2.d symlinks</title>
++
++<tgroup cols="4">
++<colspec colnum="1" colwidth="1*" align="left"/>
++<colspec colnum="2" colwidth="7*" align="left"/>
++<colspec colnum="3" colwidth="21*" align="left"/>
++<colspec colnum="4" colwidth="30*" align="left"/>
++
++<tbody>
++
++<row>
++<entry><emphasis>Number</emphasis></entry>
++<entry><emphasis>Title</emphasis></entry>
++<entry><emphasis>Link</emphasis></entry>
++<entry><emphasis>Explanation</emphasis></entry>
++</row>
++
++<row>
++<entry>K10</entry>
++<entry>gpm</entry>
++<entry><filename>../init.d/gpm</filename></entry>
++<entry>Shut down General Purpose Mouse Daemon: <xref linkend="gpm"/></entry>
++</row>
++
++<row>
++<entry>K25</entry>
++<entry>postfix</entry>
++<entry><filename>../init.d/postfix</filename></entry>
++<entry>Shut down Postfix MTA: <xref linkend="postfix"/></entry>
++</row>
++
++<row>
++<entry>K30</entry>
++<entry>sshd</entry>
++<entry><filename>../init.d/sshd</filename></entry>
++<entry>Shut down Secure Shell Daemon: <xref linkend="openssh"/></entry>
++</row>
++
++<row>
++<entry>K90</entry>
++<entry>network</entry>
++<entry><filename>../init.d/network</filename></entry>
++<entry>Shut down networking: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>S10</entry>
++<entry>sysklogd</entry>
++<entry><filename>../init.d/sysklogd</filename></entry>
++<entry>Start system and kernel logging: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>S25</entry>
++<entry>random</entry>
++<entry><filename>../init.d/random</filename></entry>
++<entry>Restore random seed: <xref linkend="postlfs-config-random"/></entry>
++</row>
++
++<row>
++<entry>S40</entry>
++<entry>alsa</entry>
++<entry><filename>../init.d/alsa</filename></entry>
++<entry>Start up sound system: <xref linkend="alsa"/></entry>
++</row>
++
++</tbody>
++</tgroup>
++</table>
++
++</sect2>
+Index: appendices/symlinks/rc3.xml
+===================================================================
+--- appendices/symlinks/rc3.xml	(révision 0)
++++ appendices/symlinks/rc3.xml	(révision 3)
+@@ -0,0 +1,76 @@
++<sect2>
++
++<title>rc3.d</title>
++
++<table frame="none">
++<title>rc3.d symlinks</title>
++
++<tgroup cols="4">
++<colspec colnum="1" colwidth="1*" align="left"/>
++<colspec colnum="2" colwidth="7*" align="left"/>
++<colspec colnum="3" colwidth="21*" align="left"/>
++<colspec colnum="4" colwidth="30*" align="left"/>
++
++<tbody>
++
++<row>
++<entry><emphasis>Number</emphasis></entry>
++<entry><emphasis>Title</emphasis></entry>
++<entry><emphasis>Link</emphasis></entry>
++<entry><emphasis>Explanation</emphasis></entry>
++</row>
++
++<row>
++<entry>S10</entry>
++<entry>sysklogd</entry>
++<entry><filename>../init.d/sysklogd</filename></entry>
++<entry>Start system and kernel logging: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>S20</entry>
++<entry>network</entry>
++<entry><filename>../init.d/network</filename></entry>
++<entry>Start networking: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>S25</entry>
++<entry>random</entry>
++<entry><filename>../init.d/random</filename></entry>
++<entry>Restore random seed: <xref linkend="postlfs-config-random"/></entry>
++</row>
++
++<row>
++<entry>S30</entry>
++<entry>sshd</entry>
++<entry><filename>../init.d/sshd</filename></entry>
++<entry>Start Secure Shell Daemon: <xref linkend="openssh"/></entry>
++</row>
++
++<row>
++<entry>S35</entry>
++<entry>postfix</entry>
++<entry><filename>../init.d/postfix</filename></entry>
++<entry>Start Postfix MTA: <xref linkend="postfix"/></entry>
++</row>
++
++<row>
++<entry>S40</entry>
++<entry>alsa</entry>
++<entry><filename>../init.d/alsa</filename></entry>
++<entry>Start up sound system: <xref linkend="alsa"/></entry>
++</row>
++
++<row>
++<entry>S70</entry>
++<entry>gpm</entry>
++<entry><filename>../init.d/gpm</filename></entry>
++<entry>Start the General Purpose Mouse Daemon: <xref linkend="gpm"/></entry>
++</row>
++
++</tbody>
++</tgroup>
++</table>
++
++</sect2>
+Index: appendices/symlinks/rc4.xml
+===================================================================
+--- appendices/symlinks/rc4.xml	(révision 0)
++++ appendices/symlinks/rc4.xml	(révision 3)
+@@ -0,0 +1,76 @@
++<sect2>
++
++<title>rc4.d</title>
++
++<table frame="none">
++<title>rc4.d symlinks</title>
++
++<tgroup cols="4">
++<colspec colnum="1" colwidth="1*" align="left"/>
++<colspec colnum="2" colwidth="7*" align="left"/>
++<colspec colnum="3" colwidth="21*" align="left"/>
++<colspec colnum="4" colwidth="30*" align="left"/>
++
++<tbody>
++
++<row>
++<entry><emphasis>Number</emphasis></entry>
++<entry><emphasis>Title</emphasis></entry>
++<entry><emphasis>Link</emphasis></entry>
++<entry><emphasis>Explanation</emphasis></entry>
++</row>
++
++<row>
++<entry>S10</entry>
++<entry>sysklogd</entry>
++<entry><filename>../init.d/sysklogd</filename></entry>
++<entry>Start system and kernel logging: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>S20</entry>
++<entry>network</entry>
++<entry><filename>../init.d/network</filename></entry>
++<entry>Start networking: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>S25</entry>
++<entry>random</entry>
++<entry><filename>../init.d/random</filename></entry>
++<entry>Restore random seed: <xref linkend="postlfs-config-random"/></entry>
++</row>
++
++<row>
++<entry>S30</entry>
++<entry>sshd</entry>
++<entry><filename>../init.d/sshd</filename></entry>
++<entry>Start Secure Shell Daemon: <xref linkend="openssh"/></entry>
++</row>
++
++<row>
++<entry>S35</entry>
++<entry>postfix</entry>
++<entry><filename>../init.d/postfix</filename></entry>
++<entry>Start Postfix MTA: <xref linkend="postfix"/></entry>
++</row>
++
++<row>
++<entry>S40</entry>
++<entry>alsa</entry>
++<entry><filename>../init.d/alsa</filename></entry>
++<entry>Start up sound system: <xref linkend="alsa"/></entry>
++</row>
++
++<row>
++<entry>S70</entry>
++<entry>gpm</entry>
++<entry><filename>../init.d/gpm</filename></entry>
++<entry>Start the General Purpose Mouse Daemon: <xref linkend="gpm"/></entry>
++</row>
++
++</tbody>
++</tgroup>
++</table>
++
++</sect2>
+Index: appendices/symlinks/rc5.xml
+===================================================================
+--- appendices/symlinks/rc5.xml	(révision 0)
++++ appendices/symlinks/rc5.xml	(révision 3)
+@@ -0,0 +1,76 @@
++<sect2>
++
++<title>rc5.d</title>
++
++<table frame="none">
++<title>rc5.d symlinks</title>
++
++<tgroup cols="4">
++<colspec colnum="1" colwidth="1*" align="left"/>
++<colspec colnum="2" colwidth="7*" align="left"/>
++<colspec colnum="3" colwidth="21*" align="left"/>
++<colspec colnum="4" colwidth="30*" align="left"/>
++
++<tbody>
++
++<row>
++<entry><emphasis>Number</emphasis></entry>
++<entry><emphasis>Title</emphasis></entry>
++<entry><emphasis>Link</emphasis></entry>
++<entry><emphasis>Explanation</emphasis></entry>
++</row>
++
++<row>
++<entry>S10</entry>
++<entry>sysklogd</entry>
++<entry><filename>../init.d/sysklogd</filename></entry>
++<entry>Start system and kernel logging: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>S20</entry>
++<entry>network</entry>
++<entry><filename>../init.d/network</filename></entry>
++<entry>Start networking: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>S25</entry>
++<entry>random</entry>
++<entry><filename>../init.d/random</filename></entry>
++<entry>Restore random seed: <xref linkend="postlfs-config-random"/></entry>
++</row>
++
++<row>
++<entry>S30</entry>
++<entry>sshd</entry>
++<entry><filename>../init.d/sshd</filename></entry>
++<entry>Start Secure Shell Daemon: <xref linkend="openssh"/></entry>
++</row>
++
++<row>
++<entry>S35</entry>
++<entry>postfix</entry>
++<entry><filename>../init.d/postfix</filename></entry>
++<entry>Start Postfix MTA: <xref linkend="postfix"/></entry>
++</row>
++
++<row>
++<entry>S40</entry>
++<entry>alsa</entry>
++<entry><filename>../init.d/alsa</filename></entry>
++<entry>Start up sound system: <xref linkend="alsa"/></entry>
++</row>
++
++<row>
++<entry>S70</entry>
++<entry>gpm</entry>
++<entry><filename>../init.d/gpm</filename></entry>
++<entry>Start the General Purpose Mouse Daemon: <xref linkend="gpm"/></entry>
++</row>
++
++</tbody>
++</tgroup>
++</table>
++
++</sect2>
+Index: appendices/symlinks/symlinks.xml
+===================================================================
+--- appendices/symlinks/symlinks.xml	(révision 0)
++++ appendices/symlinks/symlinks.xml	(révision 3)
+@@ -0,0 +1,32 @@
++<appendix id="appendices-symlinks">
++<?dbhtml filename="symlinks.html" dir="appendices"?>
++<title>List of symlinks</title>
++
++<sect1 id="appendices-symlinks-main">
++<?dbhtml filename="links.html" dir="appendices"?>
++<title>List of rc?.d symlinks used in LFS/BLFS</title>
++
++<para>This page lists all of the symlinks used by the lfs-bootscripts
++package (correct as of version <userinput>1.9</userinput>) and all of
++the scripts in the BLFS book.  This is for two reasons:  first, so that
++you can see at a glance which number we have used for each package, and
++second so that <emphasis>we</emphasis> can see which number we have
++used for each package!  Without this, it would make our lives more
++difficult (as we'd probably end up with conflicts).</para>
++
++<para>It should go without saying that this is <emphasis>not</emphasis>
++the only (or some would argue even optimal) setup for the symlinks.  In
++the LFS tradition, you should find what suits <emphasis>you</emphasis>
++and use that; our recommendations are only a template.</para>
++
++&appendices-symlinks-rc0;
++&appendices-symlinks-rc1;
++&appendices-symlinks-rc2;
++&appendices-symlinks-rc3;
++&appendices-symlinks-rc4;
++&appendices-symlinks-rc5;
++&appendices-symlinks-rc6;
++
++</sect1>
++
++</appendix>
+Index: appendices/symlinks/rc6.xml
+===================================================================
+--- appendices/symlinks/rc6.xml	(révision 0)
++++ appendices/symlinks/rc6.xml	(révision 3)
+@@ -0,0 +1,111 @@
++<sect2>
++
++<title>rc6.d</title>
++
++<table frame="none">
++<title>rc6.d symlinks</title>
++
++<tgroup cols="4">
++<colspec colnum="1" colwidth="1*" align="left"/>
++<colspec colnum="2" colwidth="7*" align="left"/>
++<colspec colnum="3" colwidth="21*" align="left"/>
++<colspec colnum="4" colwidth="30*" align="left"/>
++
++<tbody>
++
++<row>
++<entry><emphasis>Number</emphasis></entry>
++<entry><emphasis>Title</emphasis></entry>
++<entry><emphasis>Link</emphasis></entry>
++<entry><emphasis>Explanation</emphasis></entry>
++</row>
++
++<row>
++<entry>K10</entry>
++<entry>gpm</entry>
++<entry><filename>../init.d/gpm</filename></entry>
++<entry>Shut down General Purpose Mouse Daemon: <xref linkend="gpm"/></entry>
++</row>
++
++<row>
++<entry>K25</entry>
++<entry>postfix</entry>
++<entry><filename>../init.d/postfix</filename></entry>
++<entry>Shut down Postfix MTA: <xref linkend="postfix"/></entry>
++</row>
++
++<row>
++<entry>K30</entry>
++<entry>sshd</entry>
++<entry><filename>../init.d/sshd</filename></entry>
++<entry>Shut down Secure Shell Daemon: <xref linkend="openssh"/></entry>
++</row>
++
++<row>
++<entry>K35</entry>
++<entry>alsa</entry>
++<entry><filename>../init.d/alsa</filename></entry>
++<entry>Save volume settings: <xref linkend="alsa"/></entry>
++</row>
++
++<row>
++<entry>K40</entry>
++<entry>sysklogd</entry>
++<entry><filename>../init.d/sysklogd</filename></entry>
++<entry>Stop system and kernel logging: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K45</entry>
++<entry>random</entry>
++<entry><filename>../init.d/random</filename></entry>
++<entry>Save random seed: <xref linkend="postlfs-config-random"/></entry>
++</row>
++
++<row>
++<entry>K50</entry>
++<entry>sendsignals</entry>
++<entry><filename>../init.d/sendsignals</filename></entry>
++<entry>Kill processes: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K60</entry>
++<entry>mountfs</entry>
++<entry><filename>../init.d/mountfs</filename></entry>
++<entry>Unmount all filesystems: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K70</entry>
++<entry>swap</entry>
++<entry><filename>../init.d/swap</filename></entry>
++<entry>Turn off swap: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K80</entry>
++<entry>network</entry>
++<entry><filename>../init.d/network</filename></entry>
++<entry>Shut down networking: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K90</entry>
++<entry>localnet</entry>
++<entry><filename>../init.d/localnet</filename></entry>
++<entry>Remove loopback interface: Part of LFS base.</entry>
++</row>
++
++<row>
++<entry>K99</entry>
++<entry>reboot</entry>
++<entry><filename>../init.d/halt</filename></entry>
++<entry>Reboot system: Part of LFS base.</entry>
++</row>
++
++</tbody>
++</tgroup>
++</table>
++
++</sect2>
+Index: appendices/appendices.xml
+===================================================================
+--- appendices/appendices.xml	(révision 0)
++++ appendices/appendices.xml	(révision 3)
+@@ -0,0 +1,6 @@
++<part id="appendices">
++<title>Appendices</title>
++
++&appendices-symlinks;
++
++</part>
+Index: appendices/appendices.ent
+===================================================================
+--- appendices/appendices.ent	(révision 0)
++++ appendices/appendices.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY appendices SYSTEM "appendices.xml">
++
++<!ENTITY appendices-symlinks SYSTEM "symlinks/symlinks.xml">
++<!ENTITY appendices-symlinks-rc0 SYSTEM "symlinks/rc0.xml">
++<!ENTITY appendices-symlinks-rc1 SYSTEM "symlinks/rc1.xml">
++<!ENTITY appendices-symlinks-rc2 SYSTEM "symlinks/rc2.xml">
++<!ENTITY appendices-symlinks-rc3 SYSTEM "symlinks/rc3.xml">
++<!ENTITY appendices-symlinks-rc4 SYSTEM "symlinks/rc4.xml">
++<!ENTITY appendices-symlinks-rc5 SYSTEM "symlinks/rc5.xml">
++<!ENTITY appendices-symlinks-rc6 SYSTEM "symlinks/rc6.xml">
+Index: template/README
+===================================================================
+--- template/README	(révision 0)
++++ template/README	(révision 3)
+@@ -0,0 +1,6 @@
++These files are generic templates.
++ 
++The newitem script makes a copy of the files and changes all occurances
++of template in them to the package name to save a lot of tedious work.
++
++Not all will always be needed
+Index: template/template-config.xml
+===================================================================
+--- template/template-config.xml	(révision 0)
++++ template/template-config.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect3>
++<title>Configuring template</title>
++
++<sect4><title>Config files</title>
++<para><userinput>List of config files</userinput></para>
++</sect4>
++
++<sect4><title>Configuration Information</title>
++
++<para><userinput>USERINPUT GOES HERE</userinput> Blah blah blah about config.
++</para>
++</sect4>
++
++</sect3>
++
+Index: template/template-intro.xml
+===================================================================
+--- template/template-intro.xml	(révision 0)
++++ template/template-intro.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect3>
++<title>Introduction to template</title>
++
++<screen>Download location:              &template-download;
++Version used:                   &template-version;
++Package size:                   &template-size;
++Estimated Disk space required:  &template-buildsize;</screen>
++
++<para>The template package contains... This is useful for...</para>
++
++<screen>template depends on:
++DEPENDENCY LIST (if any)</screen>
++
++</sect3>
+Index: template/template-exp.xml
+===================================================================
+--- template/template-exp.xml	(révision 0)
++++ template/template-exp.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect3>
++<title>Command explanations</title>
++
++<para><userinput>COMMAND:</userinput> This command does something.</para>
++
++</sect3>
++
+Index: template/template-inst.xml
+===================================================================
+--- template/template-inst.xml	(révision 0)
++++ template/template-inst.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<sect3>
++<title>Installation of template</title>
++
++<para>Install template by running the following commands:</para>
++
++<para><screen><userinput>./configure </userinput></screen></para>
++
++</sect3>
++
+Index: template/template-desc.xml
+===================================================================
+--- template/template-desc.xml	(révision 0)
++++ template/template-desc.xml	(révision 3)
+@@ -0,0 +1,17 @@
++<sect3>
++<title>Contents</title>
++
++<para>The template package contains <userinput>LISTOFFILES</userinput></para>
++
++</sect3>
++
++<sect3><title>Description</title>
++
++<sect4><title>item1</title>
++<para>item1 does this</para></sect4>
++
++<sect4><title>item2</title>
++<para>item2 does that</para></sect4>
++
++</sect3>
++
+Index: template/newitem
+===================================================================
+--- template/newitem	(révision 0)
++++ template/newitem	(révision 3)
+@@ -0,0 +1,37 @@
++#!/bin/sh
++
++# Copies the template files and replaces template with the supplied package
++# name, greatly simplifying the process of adding a new package.
++
++if [ -z "$1" ]
++then
++  echo "Creates template files for a package and fills in the package name."
++  echo "Usage: $0 <written-package-name> <package-filename>"
++  echo
++  echo "Note that if you want to create the package Glib, you should"
++  echo "call the script as: '$0 Glib glib' so that the filenames are in"
++  echo "lower case.  If you only specify the first option, it is used"
++  echo "for both the written and filenames."
++  echo "Note also that *all* filenames in BLFS should be lower-case only"
++  exit 1
++fi
++
++WRITTENNAME=$1
++
++if [ -z "$2" ]
++then
++ FILENAME=$WRITTENNAME
++else
++ FILENAME=$2
++fi
++
++pushd `dirname $0`
++TEMPLDIR=`pwd`
++popd
++ 
++for i in $TEMPLDIR/template*
++do
++  NEWFILE=`echo $i | sed s@$TEMPLDIR/template@$FILENAME@`
++  echo $NEWFILE
++  sed s/template/$WRITTENNAME/g $i > $NEWFILE
++done
+Index: template/template.xml
+===================================================================
+--- template/template.xml	(révision 0)
++++ template/template.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2 id="template" xreflabel="template-&template-version;">
++<title>template-&template-version;</title>
++
++&template-intro;
++&template-inst;
++&template-exp;
++&template-config;
++&template-desc;
++
++</sect2>
++
+Index: general/sysutils/hdparm.xml
+===================================================================
+--- general/sysutils/hdparm.xml	(révision 0)
++++ general/sysutils/hdparm.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect1 id="hdparm" xreflabel="hdparm-&hdparm-version;">
++<?dbhtml filename="hdparm.html" dir="general"?>
++<title>hdparm-&hdparm-version;</title>
++
++&hdparm-intro;
++&hdparm-inst;
++&hdparm-desc;
++
++</sect1>
++
+Index: general/sysutils/hdparm/hdparm.ent
+===================================================================
+--- general/sysutils/hdparm/hdparm.ent	(révision 0)
++++ general/sysutils/hdparm/hdparm.ent	(révision 3)
+@@ -0,0 +1,8 @@
++<!ENTITY hdparm SYSTEM "../hdparm.xml">
++<!ENTITY hdparm-intro SYSTEM "hdparm-intro.xml">
++<!ENTITY hdparm-inst SYSTEM "hdparm-inst.xml">
++<!ENTITY hdparm-desc SYSTEM "hdparm-desc.xml">
++<!ENTITY hdparm-buildsize "257 KB">
++<!ENTITY hdparm-version "5.2">
++<!ENTITY hdparm-download "ftp://ftp.ibiblio.org/pub/Linux/system/hardware/hdparm-5.2.tar.gz">
++<!ENTITY hdparm-size "36 KB">
+Index: general/sysutils/hdparm/hdparm-intro.xml
+===================================================================
+--- general/sysutils/hdparm/hdparm-intro.xml	(révision 0)
++++ general/sysutils/hdparm/hdparm-intro.xml	(révision 3)
+@@ -0,0 +1,19 @@
++<sect2>
++<title>Introduction to hdparm</title>
++
++<screen>Download location:              &hdparm-download;
++Version used:                   &hdparm-version;
++Package size:                   &hdparm-size;
++Estimated Disk space required:  &hdparm-buildsize;</screen>
++
++<para>The hdparm package contains the hdparm utility.  This is useful
++for controlling ATA/IDE controllers and hard drives both to increase
++performance and sometimes to increase stability.</para>
++
++<para><emphasis>WARNING!</emphasis> 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.</para>
++
++</sect2>
+Index: general/sysutils/hdparm/hdparm-inst.xml
+===================================================================
+--- general/sysutils/hdparm/hdparm-inst.xml	(révision 0)
++++ general/sysutils/hdparm/hdparm-inst.xml	(révision 3)
+@@ -0,0 +1,19 @@
++<sect2>
++<title>Installation of hdparm</title>
++
++<para>Install hdparm by running the following commands:</para>
++
++<para><screen><userinput>make && </userinput>
++<userinput>make install</userinput></screen></para>
++
++<para>Note that by default, hdparm is installed in
++<filename>/sbin</filename> as some systems may require it on bootup
++before <filename>/usr</filename> is mounted.  If you wish to install
++hdparm under the <filename>/usr</filename> hierarchy, then replace the
++above commands with the following:</para>
++
++<para><screen><userinput>make && </userinput>
++<userinput>make binprefix=/usr install</userinput></screen></para>
++
++</sect2>
++
+Index: general/sysutils/hdparm/hdparm-desc.xml
+===================================================================
+--- general/sysutils/hdparm/hdparm-desc.xml	(révision 0)
++++ general/sysutils/hdparm/hdparm-desc.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Contents</title>
++
++<para>The hdparm package contains <userinput>hdparm</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>hdparm</title>
++<para>hdparm provides a command line interface to various hard disk
++ioctls supported by the stock Linux ATA/IDE device driver 
++subsystem.</para></sect3>
++
++</sect2>
++
+Index: general/sysutils/pccts.xml
+===================================================================
+--- general/sysutils/pccts.xml	(révision 0)
++++ general/sysutils/pccts.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="pccts" xreflabel="pccts-&pccts-version;">
++<?dbhtml filename="pccts.html" dir="general"?>
++<title>pccts-&pccts-version;</title>
++
++&pccts-intro;
++&pccts-inst;
++&pccts-exp;
++&pccts-desc;
++
++</sect1>
++
+Index: general/sysutils/gpm.xml
+===================================================================
+--- general/sysutils/gpm.xml	(révision 0)
++++ general/sysutils/gpm.xml	(révision 3)
+@@ -0,0 +1,19 @@
++<sect1 id="gpm" xreflabel="gpm-&gpm-version;">
++<title>gpm-&gpm-version;</title>
++
++<para>Gpm (the general purpose mouse daemon) is a mouse server for
++applications running in the console.  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 generally.  It
++is useful on desktops, especially if following (Beyond)LinuxFromScratch
++instructions - it's often much easier (and less error prone) to cut and
++paste between two console windows than to type everything by
++hand!</para>
++
++&gpm-intro;
++&gpm-inst;
++&gpm-config;
++&gpm-desc;
++
++</sect1>
++
+Index: general/sysutils/gpm/gpm-config.xml
+===================================================================
+--- general/sysutils/gpm/gpm-config.xml	(révision 0)
++++ general/sysutils/gpm/gpm-config.xml	(révision 3)
+@@ -0,0 +1,106 @@
++<sect2>
++<title>Configuring gpm</title>
++
++<sect3><title>gpm init.d script</title>
++<para>The gpm init.d script can be created using the following
++commands:  (This assumes that you have followed the LFS default of
++having your $rc_base set to <filename
++class="directory">/etc/rc.d</filename>)</para>
++<para><screen><userinput>cat > /etc/rc.d/init.d/gpm << "EOF"</userinput>
++#!/bin/sh
++# Begin $rc_base/init.d/gpm
++
++# Based on sysklogd script from LFS-3.1 and earlier.
++# Rewritten by Gerard Beekmans  - gerard at linuxfromscratch.org
++# GPM specific parts by Mark Hymers - markh at linuxfromscratch.org
++
++source /etc/sysconfig/rc
++source $rc_functions
++
++if [ -f /etc/sysconfig/mouse ]
++	then
++        source /etc/sysconfig/mouse
++fi
++
++if [ -z "$MDEVICE" ] || [ -z "$PROTOCOL" ]
++	then
++	echo "Please create an /etc/sysconfig/mouse file containing"
++	echo "MDEVICE and PROTOCOL values"
++	exit 1;
++fi
++
++case "$1" in
++        start)
++                echo "Starting gpm..."
++                loadproc gpm -m $MDEVICE -t $PROTOCOL
++                ;;
++
++        stop)
++                echo "Stopping gpm..."
++                killproc gpm
++                ;;
++
++        restart)
++                $0 stop
++                sleep 1
++                $0 start
++                ;;
++
++        status)
++                statusproc gpm
++                ;;
++
++        *)
++                echo "Usage: $0 {start|stop|restart|status}"
++                exit 1
++                ;;
++esac
++
++# End $rc_base/init.d/gpm
++<userinput>EOF
++chmod 755 /etc/rc.d/init.d/gpm</userinput></screen></para>
++
++<para>You then need to create symbolic links to this file in the relevant rc.d
++directories.  For example:
++<screen><userinput>cd /etc/rc.d/init.d &&
++ln -sf ../init.d/gpm ../rc0.d/K10gpm &&
++ln -sf ../init.d/gpm ../rc1.d/K10gpm &&
++ln -sf ../init.d/gpm ../rc2.d/K10gpm &&
++ln -sf ../init.d/gpm ../rc3.d/S70gpm &&
++ln -sf ../init.d/gpm ../rc4.d/S70gpm &&
++ln -sf ../init.d/gpm ../rc5.d/S70gpm &&
++ln -sf ../init.d/gpm ../rc6.d/K10gpm</userinput></screen></para></sect3>
++
++<sect3><title>Config files</title>
++<para><userinput>/etc/sysconfig/mouse</userinput>
++This file contains the name of your mouse device and the protocol which
++it uses.  To create this file, run the following:</para>
++
++<para><screen><userinput>cat > /etc/sysconfig/mouse << "EOF"</userinput> 
++# start /etc/sysconfig/mouse
++MDEVICE=yourdevice
++PROTOCOL=yourprotocol
++# end /etc/sysconfig/mouse
++<userinput>EOF</userinput></screen></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para>Examples of values to set MDEVICE and PROTOCOL to are</para>
++
++<para><screen>MDEVICE=/dev/psaux
++PROTOCOL=imps2</screen></para>
++
++<para>A list of which protocol values are known can be found by running
++<userinput>gpm -t -help</userinput>.  Your MDEVICE setting depends on
++which type of mouse you have.  For example,
++<userinput>/dev/ttyS0</userinput> for a serial mouse (on Windows this is
++COM1), <userinput>/dev/input/mice</userinput> is often used for USB mice
++and <userinput>/dev/psaux</userinput> for PS2 mice.  It is normally
++thought not a good idea to link /dev/mouse to the relevant device, but
++instead to reference it directly.</para>
++
++</sect3>
++
++</sect2>
++
+Index: general/sysutils/gpm/gpm.ent
+===================================================================
+--- general/sysutils/gpm/gpm.ent	(révision 0)
++++ general/sysutils/gpm/gpm.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY gpm SYSTEM "../gpm.xml">
++<!ENTITY gpm-intro SYSTEM "gpm-intro.xml">
++<!ENTITY gpm-inst SYSTEM "gpm-inst.xml">
++<!ENTITY gpm-desc SYSTEM "gpm-desc.xml">
++<!ENTITY gpm-config SYSTEM "gpm-config.xml">
++<!ENTITY gpm-buildsize "3.2 MB">
++<!ENTITY gpm-version "1.20.0">
++<!ENTITY gpm-download "ftp://arcana.linux.it/pub/gpm/gpm-1.20.0.tar.bz2">
++<!ENTITY gpm-size "382 KB">
+Index: general/sysutils/gpm/gpm-intro.xml
+===================================================================
+--- general/sysutils/gpm/gpm-intro.xml	(révision 0)
++++ general/sysutils/gpm/gpm-intro.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Introduction to gpm</title>
++
++<screen>Download location:              &gpm-download;
++Version used:                   &gpm-version;
++Package size:                   &gpm-size;
++Estimated Disk space required:  &gpm-buildsize;</screen>
++
++<para>The gpm package contains a mouse server for the console and xterm.
++This is is useful for cutting and pasting text in console mode, and also
++because many console-based programs need it to compile mouse support
++into themselves.</para>
++
++</sect2>
+Index: general/sysutils/gpm/gpm-inst.xml
+===================================================================
+--- general/sysutils/gpm/gpm-inst.xml	(révision 0)
++++ general/sysutils/gpm/gpm-inst.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Installation of gpm</title>
++
++<para>Install gpm by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install</userinput></screen></para>
++</sect2>
++
+Index: general/sysutils/gpm/gpm-desc.xml
+===================================================================
+--- general/sysutils/gpm/gpm-desc.xml	(révision 0)
++++ general/sysutils/gpm/gpm-desc.xml	(révision 3)
+@@ -0,0 +1,26 @@
++<sect2>
++<title>Contents</title>
++
++<para>The gpm package contains <userinput>gpm, gpm-root, disable-paste
++and mev</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>gpm</title>
++<para>gpm is a cut and paste utility and mouse server for virtual
++consoles</para></sect3>
++
++<sect3><title>gpm-root</title>
++<para>gpm-root is a default handler for gpm.  It is used to draw menus on the
++root window</para></sect3>
++
++<sect3><title>disable-paste</title>
++<para>No description available</para></sect3>
++
++<sect3><title>mev</title>
++<para>mev is a program to report mouse events</para></sect3>
++
++</sect2>
++
+Index: general/sysutils/whichtemp.xml
+===================================================================
+--- general/sysutils/whichtemp.xml	(révision 0)
++++ general/sysutils/whichtemp.xml	(révision 3)
+@@ -0,0 +1,36 @@
++<sect1 id="ch05-which">
++<?dbhtml filename="which.html" dir="chapter05"?>
++<title>The "which" program / script</title>
++
++<para>The presence / absence of the which program in the main LFS book
++is probably one of the most contentious issues we have on the mailing
++lists.  It has resulted in at least one flame war in the recent past.
++To hopefully put an end to this once and for all, we here present the
++various options for equipping your system with "which".</para>
++
++<para>The first option is simply to use a bash alias:</para>
++<screen>alias which='type -p'</screen>
++<para>This command can be put in your
++<filename>~/.bash_profile</filename> or <filename>~/.bashrc</filename>
++file in order to be set up each time you log in (see man bash for more
++information on the bash login files).  This will not always work
++however, for example it will fail when a program needs to use "which" but 
++doesn't spawn a shell.</para>
++
++<para>The second option is to create a simple script:</para>
++<para><screen><userinput>cat > /usr/bin/which << "EOF"</userinput>
++#!/bin/bash
++type -p "$@"
++<userinput>EOF
++chmod 755 /usr/bin/which
++chown root.root /usr/bin/which</userinput></screen></para>
++<para>This should generally work OK and is probably the easiest solution
++for boxes which don't need a good user environment to work in.</para>
++
++<para>The third option is to install the actual program
++<emphasis>which</emphasis>.</para>
++
++&which;
++
++</sect1>
++
+Index: general/sysutils/pciutils.xml
+===================================================================
+--- general/sysutils/pciutils.xml	(révision 0)
++++ general/sysutils/pciutils.xml	(révision 3)
+@@ -0,0 +1,6 @@
++<sect1 id="pciutils" xreflabel="pciutils">
++<title>pciutils</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: general/sysutils/pciutils/pciutils.ent
+===================================================================
+--- general/sysutils/pciutils/pciutils.ent	(révision 0)
++++ general/sysutils/pciutils/pciutils.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY pciutils SYSTEM "../pciutils.xml">
+Index: general/sysutils/sysutils.xml
+===================================================================
+--- general/sysutils/sysutils.xml	(révision 0)
++++ general/sysutils/sysutils.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<chapter id="general-sysutils">
++<?dbhtml filename="sysutils.html" dir="general"?>
++<title>System Utilities</title>
++
++&gpm;
++&fcron;
++&hdparm;
++&which;
++&unzip;
++&zip;
++&pccts;
++&pciutils;
++&pkgconfig;
++
++</chapter>
+Index: general/sysutils/zip.xml
+===================================================================
+--- general/sysutils/zip.xml	(révision 0)
++++ general/sysutils/zip.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="zip" xreflabel="zip">
++<?dbhtml filename="zip.html" dir="general"?>
++<title>zip</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: general/sysutils/which.xml
+===================================================================
+--- general/sysutils/which.xml	(révision 0)
++++ general/sysutils/which.xml	(révision 3)
+@@ -0,0 +1,40 @@
++<sect1 id="which" xreflabel="which-&which-version;">
++<?dbhtml filename="which.html" dir="general"?>
++<title>The "which" program / script</title>
++
++<para>The presence / absence of the which program in the main LFS book
++is probably one of the most contentious issues we have on the mailing
++lists.  It has resulted in at least one flame war in the recent past.
++To hopefully put an end to this once and for all, we here present the
++various options for equipping your system with "which".</para>
++
++<para>The first option is simply to use a bash alias:</para>
++<screen>alias which='type -p'</screen>
++<para>This command can be put in your
++<filename>~/.bash_profile</filename> or <filename>~/.bashrc</filename>
++file in order to be set up each time you log in (see man bash for more
++information on the bash login files).  This will not always work
++however, for example it will fail when a program needs to use "which"
++but
++doesn't spawn a shell.</para>
++
++<para>The second option is to create a simple script:</para>
++<para><screen><userinput>cat > /usr/bin/which <<
++"EOF"</userinput>
++#!/bin/bash
++type -p "$@"
++<userinput>EOF
++chmod 755 /usr/bin/which
++chown root.root /usr/bin/which</userinput></screen></para>
++<para>This should generally work OK and is probably the easiest solution
++for boxes which don't need a good user environment to work in.</para>
++
++<para>The third option is to install the actual program
++<emphasis>which</emphasis>.</para>
++
++&which-intro;
++&which-inst;
++&which-desc;
++
++</sect1>
++
+Index: general/sysutils/which/which.ent
+===================================================================
+--- general/sysutils/which/which.ent	(révision 0)
++++ general/sysutils/which/which.ent	(révision 3)
+@@ -0,0 +1,8 @@
++<!ENTITY which SYSTEM "../which.xml">
++<!ENTITY which-intro SYSTEM "which-intro.xml">
++<!ENTITY which-inst SYSTEM "which-inst.xml">
++<!ENTITY which-desc SYSTEM "which-desc.xml">
++<!ENTITY which-buildsize "667 KB">
++<!ENTITY which-version "2.13">
++<!ENTITY which-download "ftp://ftp.gnu.org/pub/gnu/which/which-2.13.tar.gz">
++<!ENTITY which-size "104 KB">
+Index: general/sysutils/which/which-intro.xml
+===================================================================
+--- general/sysutils/which/which-intro.xml	(révision 0)
++++ general/sysutils/which/which-intro.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<sect2>
++<title>Introduction to which</title>
++
++<screen>Download location:              &which-download;
++Version used:                   &which-version;
++Package size:                   &which-size;
++Estimated Disk space required:  &which-buildsize;</screen>
++
++</sect2>
+Index: general/sysutils/which/which-inst.xml
+===================================================================
+--- general/sysutils/which/which-inst.xml	(révision 0)
++++ general/sysutils/which/which-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of which</title>
++
++<para>Install which by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: general/sysutils/which/which-desc.xml
+===================================================================
+--- general/sysutils/which/which-desc.xml	(révision 0)
++++ general/sysutils/which/which-desc.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Contents</title>
++
++<para>The which package contains <userinput>which</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>which</title>
++<para>which shows the full path of (shell) commands.</para></sect3>
++
++</sect2>
++
+Index: general/sysutils/unzip.xml
+===================================================================
+--- general/sysutils/unzip.xml	(révision 0)
++++ general/sysutils/unzip.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<sect1 id="unzip" xreflabel="unzip-&unzip-version;">
++<title>unzip-&unzip-version;</title>
++
++&unzip-intro;
++&unzip-inst;
++&unzip-exp;
++&unzip-desc;
++
++</sect1>
+Index: general/sysutils/fcron.xml
+===================================================================
+--- general/sysutils/fcron.xml	(révision 0)
++++ general/sysutils/fcron.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="fcron" xreflabel="fcron-&fcron-version;">
++<?dbhtml filename="fcron.html" dir="general"?>
++<title>fcron-&fcron-version;</title>
++
++&fcron-intro;
++&fcron-inst;
++&fcron-exp;
++&fcron-config;
++&fcron-desc;
++
++</sect1>
++
+Index: general/sysutils/pkgconfig.xml
+===================================================================
+--- general/sysutils/pkgconfig.xml	(révision 0)
++++ general/sysutils/pkgconfig.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect1 id="pkgconfig" xreflabel="pkgconfig-&pkgconfig-version;">
++<?dbhtml filename="pkgconfig.html" dir="general"?>
++<title>pkgconfig-&pkgconfig-version;</title>
++
++&pkgconfig-intro;
++&pkgconfig-inst;
++&pkgconfig-desc;
++
++</sect1>
++
+Index: general/sysutils/pkgconfig/pkgconfig-inst.xml
+===================================================================
+--- general/sysutils/pkgconfig/pkgconfig-inst.xml	(révision 0)
++++ general/sysutils/pkgconfig/pkgconfig-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of pkgconfig</title>
++
++<para>Install pkgconfig by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: general/sysutils/pkgconfig/pkgconfig-desc.xml
+===================================================================
+--- general/sysutils/pkgconfig/pkgconfig-desc.xml	(révision 0)
++++ general/sysutils/pkgconfig/pkgconfig-desc.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Contents</title>
++
++<para>The pkgconfig package contains <userinput>pkg-config</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>pkg-config</title>
++<para>pkg-config is a function that returns metainformation for the
++specified library.</para></sect3>
++
++</sect2>
++
+Index: general/sysutils/pkgconfig/pkgconfig.ent
+===================================================================
+--- general/sysutils/pkgconfig/pkgconfig.ent	(révision 0)
++++ general/sysutils/pkgconfig/pkgconfig.ent	(révision 3)
+@@ -0,0 +1,8 @@
++<!ENTITY pkgconfig SYSTEM "../pkgconfig.xml">
++<!ENTITY pkgconfig-intro SYSTEM "pkgconfig-intro.xml">
++<!ENTITY pkgconfig-inst SYSTEM "pkgconfig-inst.xml">
++<!ENTITY pkgconfig-desc SYSTEM "pkgconfig-desc.xml">
++<!ENTITY pkgconfig-buildsize "5 MB">
++<!ENTITY pkgconfig-version "0.12.0">
++<!ENTITY pkgconfig-download "http://www.freedesktop.org/software/pkgconfig/releases/pkgconfig-0.12.0.tar.gz">
++<!ENTITY pkgconfig-size "596 KB">
+Index: general/sysutils/pkgconfig/pkgconfig-intro.xml
+===================================================================
+--- general/sysutils/pkgconfig/pkgconfig-intro.xml	(révision 0)
++++ general/sysutils/pkgconfig/pkgconfig-intro.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Introduction to pkgconfig</title>
++
++<screen>Download location:              <ulink url="&pkgconfig-download;"/>
++Version used:                   &pkgconfig-version;
++Package size:                   &pkgconfig-size;
++Estimated Disk space required:  &pkgconfig-buildsize;</screen>
++
++<para>The pkgconfig package contains pkg-config. This is useful for
++passing the include path and/or library path to the compiler during the
++make script.</para>
++
++</sect2>
+Index: general/sysutils/fcron/fcron-config.xml
+===================================================================
+--- general/sysutils/fcron/fcron-config.xml	(révision 0)
++++ general/sysutils/fcron/fcron-config.xml	(révision 3)
+@@ -0,0 +1,74 @@
++<sect2>
++<title>Configuring fcron</title>
++
++<sect3><title>make install script</title>
++
++<para>After the files are installed, the make install script enters into a
++configuration routine.  The first test will be for a group named fcron.  If
++it does not exist, you will be given the command line that the script proposes
++to run and a prompt for a 'y' or 'n'.  This is repeated to create a user named
++fcron and to install a script in the init.d directory with the appropriate
++symbolic links in runlevels 2, 3, 4, and 5.  The final configuation step is to
++stop any current fcron processes and start the new fcron.  A yes here will stop
++current fcron processes but will fail to start new fcron.  The following
++commands will correct this:</para>
++
++<para><screen><userinput>cat > /etc/rc.d/init.d/fcron << "EOF"</userinput>
++#!/bin/sh
++# Begin $rc_base/init.d/fcron
++
++# Based on sysklogd script from LFS-3.1 and earlier.
++# Rewritten by Gerard Beekmans  - gerard at linuxfromscratch.org
++
++source /etc/sysconfig/rc
++source $rc_functions
++
++case "$1" in
++        start)
++                echo "Starting fcron..."
++                loadproc fcron
++                ;;
++
++        stop)
++                echo "Stopping fcron..."
++                killproc fcron
++                ;;
++
++        restart)
++                $0 stop
++                sleep 1
++                $0 start
++                ;;
++
++        status)
++                statusproc fcron
++                ;;
++
++        *)
++                echo "Usage: $0 {start|stop|restart|status}"
++                exit 1
++                ;;
++esac
++
++# End $rc_base/init.d/fcron
++<userinput>EOF
++chmod 755 /etc/rc.d/init.d/fcron &&
++/etc/rc.d/init.d/fcron start &&
++mv /etc/rc.d/rc0.d/K60fcron /etc/rc.d/rc0.d/K08fcron &&
++mv /etc/rc.d/rc6.d/K60fcron /etc/rc.d/rc6.d/K08fcron</userinput></screen></para>
++</sect3>
++
++<sect3><title>Config files</title>
++
++<para><userinput>/etc/fcron.conf, /etc/fcron.allow,
++/etc/fcron.deny</userinput></para>
++
++<para>There are no required changes in any of these files.
++Configuration information can be found in the man page for
++fcron.conf.</para>
++
++<para>fcron scripts are written using fcrontab.  Refer to the man page
++for fcrontab for proper parameters for your situation.</para></sect3>
++
++</sect2>
++
+Index: general/sysutils/fcron/fcron.ent
+===================================================================
+--- general/sysutils/fcron/fcron.ent	(révision 0)
++++ general/sysutils/fcron/fcron.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY fcron SYSTEM "../fcron.xml">
++<!ENTITY fcron-intro SYSTEM "fcron-intro.xml">
++<!ENTITY fcron-inst SYSTEM "fcron-inst.xml">
++<!ENTITY fcron-exp SYSTEM "fcron-exp.xml">
++<!ENTITY fcron-desc SYSTEM "fcron-desc.xml">
++<!ENTITY fcron-config SYSTEM "fcron-config.xml">
++<!ENTITY fcron-buildsize "2.3 MB">
++<!ENTITY fcron-version "2.9.0">
++<!ENTITY fcron-download "http://fcron.free.fr/fcron-2.9.0.src.tar.gz">
++<!ENTITY fcron-size "324 KB">
+Index: general/sysutils/fcron/fcron-intro.xml
+===================================================================
+--- general/sysutils/fcron/fcron-intro.xml	(révision 0)
++++ general/sysutils/fcron/fcron-intro.xml	(révision 3)
+@@ -0,0 +1,18 @@
++<sect2>
++<title>Introduction to fcron</title>
++
++<screen>Download location:              <ulink url="&fcron-download;"/>
++Version used:                   &fcron-version;
++Package size:                   &fcron-size;
++Estimated Disk space required:  &fcron-buildsize;</screen>
++
++<para>The fcron package contains the fcron daemon. "It
++is a periodical command scheduler which aims at replacing Vixie
++Cron." </para>
++
++<screen>fcron requires a running syslog (part of the base LFS system).
++fcron recommends a local mail system (sendmail or <xref
++linkend="postfix"></xref>, for example).
++fcron will utilize PAM if it is installed prior to fcron.</screen>
++
++</sect2>
+Index: general/sysutils/fcron/fcron-exp.xml
+===================================================================
+--- general/sysutils/fcron/fcron-exp.xml	(révision 0)
++++ general/sysutils/fcron/fcron-exp.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>make CC="gcc $CFLAGS":</userinput> This makes fcron
++compile using our CFLAGS for optimizations.</para>
++
++</sect2>
++
+Index: general/sysutils/fcron/fcron-inst.xml
+===================================================================
+--- general/sysutils/fcron/fcron-inst.xml	(révision 0)
++++ general/sysutils/fcron/fcron-inst.xml	(révision 3)
+@@ -0,0 +1,43 @@
++<sect2>
++<title>Installation of fcron</title>
++
++<para>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 <filename>/etc/syslog.conf</filename>.</para>
++
++<para><screen><userinput>cat >> /etc/syslog.conf << "EOF"</userinput>
++# Begin fcron addition to /etc/syslog.conf
++
++cron.* -/var/log/cron.log
++
++# End fcron addition
++<userinput>EOF</userinput></screen></para>
++
++<para>The configuration file has been modified, so reloading the sysklogd 
++daemon will activate the changes.</para>
++
++<para><screen><userinput>/etc/rc.d/init.d/sysklogd reload</userinput></screen></para>
++
++<para>Install fcron by running the following commands:</para>
++
++<para><screen><userinput>./configure &&
++make CC="gcc $CFLAGS" &&
++make install</userinput></screen></para>
++
++</sect2>
++
++<sect2>
++
++<title>Install fcron without MTA </title>
++
++<para>Fcron does not require a mail transfer agent (MTA) to run, but will 
++use one if it is installed to email you the results of the fcron script.  If 
++you wish to install without a MTA, run the following commands:</para>
++
++<para><screen><userinput>./configure --without-sendmail &&
++make CC="gcc $CFLAGS" &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: general/sysutils/fcron/fcron-desc.xml
+===================================================================
+--- general/sysutils/fcron/fcron-desc.xml	(révision 0)
++++ general/sysutils/fcron/fcron-desc.xml	(révision 3)
+@@ -0,0 +1,28 @@
++<sect2>
++<title>Contents</title>
++
++<para>The fcron package contains <userinput>fcron, fcrontab,
++fcronsighup</userinput> and <userinput>fcrondyn.</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>fcron</title>
++<para>fcron is the scheduling daemon.
++</para></sect3>
++
++<sect3><title>fcrontab</title>
++<para>fcrontab is the program used to install, edit, list and remove the
++tables used by fcron.</para></sect3>
++
++<sect3><title>fcronsighup</title>
++<para>fcronsighup instructs fcron to reread the fcron tables.
++</para></sect3>
++
++<sect3><title>fcrondyn</title>
++<para>fcrondyn is a user tool intended to interact with a running fcron
++daemon.</para></sect3>
++
++</sect2>
++
+Index: general/genlib/libxml.xml
+===================================================================
+--- general/genlib/libxml.xml	(révision 0)
++++ general/genlib/libxml.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect1 id="libxml" xreflabel="libxml-&libxml-version;">
++<?dbhtml filename="libxml.html" dir="general"?>
++<title>libxml-&libxml-version;</title>
++
++&libxml-intro;
++&libxml-inst;
++&libxml-config;
++&libxml-desc;
++
++</sect1>
+Index: general/genlib/libxml2.xml
+===================================================================
+--- general/genlib/libxml2.xml	(révision 0)
++++ general/genlib/libxml2.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="libxml2" xreflabel="libxml2-&libxml2-version;">
++<?dbhtml filename="libxml2.html" dir="general"?>
++<title>libxml2-&libxml2-version;</title>
++
++&libxml2-intro;
++&libxml2-inst;
++&libxml2-config;
++&libxml2-desc;
++
++</sect1>
++
+Index: general/genlib/pcre.xml
+===================================================================
+--- general/genlib/pcre.xml	(révision 0)
++++ general/genlib/pcre.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect1 id="pcre" xreflabel="pcre-&pcre-version;">
++<?dbhtml filename="pcre.html" dir="general"?>
++<title>pcre-&pcre-version;</title>
++
++&pcre-intro;
++&pcre-inst;
++&pcre-config;
++&pcre-desc;
++
++</sect1>
+Index: general/genlib/libfam.xml
+===================================================================
+--- general/genlib/libfam.xml	(révision 0)
++++ general/genlib/libfam.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="libfam" xreflabel="libfam">
++<?dbhtml filename="libfam.html" dir="general"?>
++<title>libfam</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: general/genlib/pcre/pcre-config.xml
+===================================================================
+--- general/genlib/pcre/pcre-config.xml	(révision 0)
++++ general/genlib/pcre/pcre-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring pcre</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: general/genlib/pcre/pcre.ent
+===================================================================
+--- general/genlib/pcre/pcre.ent	(révision 0)
++++ general/genlib/pcre/pcre.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY pcre SYSTEM "../pcre.xml">
++<!ENTITY pcre-intro SYSTEM "pcre-intro.xml">
++<!ENTITY pcre-inst SYSTEM "pcre-inst.xml">
++<!ENTITY pcre-desc SYSTEM "pcre-desc.xml">
++<!ENTITY pcre-config SYSTEM "pcre-config.xml">
++<!ENTITY pcre-buildsize "2.1 MB">
++<!ENTITY pcre-version "3.9">
++<!ENTITY pcre-download "ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-3.9.tar.bz2">
++<!ENTITY pcre-size "255 KB">
+Index: general/genlib/pcre/pcre-intro.xml
+===================================================================
+--- general/genlib/pcre/pcre-intro.xml	(révision 0)
++++ general/genlib/pcre/pcre-intro.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Introduction to pcre</title>
++
++<screen>Download location:              &pcre-download;
++Version used:                   &pcre-version;
++Package size:                   &pcre-size;
++Estimated Disk space required:  &pcre-buildsize;</screen>
++
++<para>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.</para>
++
++
++</sect2>
+Index: general/genlib/pcre/pcre-inst.xml
+===================================================================
+--- general/genlib/pcre/pcre-inst.xml	(révision 0)
++++ general/genlib/pcre/pcre-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of pcre</title>
++
++<para>Install pcre by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: general/genlib/pcre/pcre-desc.xml
+===================================================================
+--- general/genlib/pcre/pcre-desc.xml	(révision 0)
++++ general/genlib/pcre/pcre-desc.xml	(révision 3)
+@@ -0,0 +1,25 @@
++<sect2>
++<title>Contents</title>
++
++<para>The pcre package contains the <userinput>pcre
++libraries</userinput>, <userinput>pcregrep</userinput>,
++<userinput>pcretest</userinput> and 
++<userinput>pcre-config</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>pcregrep</title>
++<para>pcregrep is a grep that understands perl compatible regular
++expressions.</para></sect3>
++
++<sect3><title>pcretest</title>
++<para>pcretest can test your perl compatible regular expression.</para></sect3>
++
++<sect3><title>pcre-config</title>
++<para>pcre-config is used during the compile process of programs
++linking to this library.</para></sect3>
++
++</sect2>
++
+Index: general/genlib/libfam/libfam.ent
+===================================================================
+--- general/genlib/libfam/libfam.ent	(révision 0)
++++ general/genlib/libfam/libfam.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY libfam SYSTEM "../libfam.xml">
+Index: general/genlib/genlib.xml
+===================================================================
+--- general/genlib/genlib.xml	(révision 0)
++++ general/genlib/genlib.xml	(révision 3)
+@@ -0,0 +1,44 @@
++<chapter id="general-genlib">
++<?dbhtml filename="genlib.html" dir="general"?>
++<title>General Libraries</title>
++
++<para>Libraries contain code which is often required by more than
++one program.  This has the advantage that each program doesn't need to
++duplicate code (and risk introducing bugs), it just has to call
++functions from the libraries installed on the system.  The most obvious
++example of a set of libraries is glibc which is installed during the LFS
++book.  This contains all of the C library functions which programs
++use.</para>
++
++<para>There are two types of library, static and shared.  Shared
++libraries (usually libXXX.so) are loaded into memory from the shared
++copy at runtime (hence the name).  Static libraries (libXXX.a) are
++actually linked into the program executable file itself, thus making the
++program file larger.  Quite often, you will find both static and shared
++copies of the same library on your system.</para>
++
++<para>Generally, you only need to install libraries when you are
++installing software which requires functionality which they supply.  In
++the BLFS book, each package is listed with a list of (known)
++dependencies.  Thus, you can figure out which libraries you need to have
++before installing that program.  If you are installing something without
++using BLFS instructions, usually the <filename>README</filename>  or
++<filename>INSTALL</filename> file will contain details of the programs
++requirements.</para>
++
++<para>There are certain libraries which nearly
++<emphasis>everyone</emphasis> will need at some point.  In this chapter
++we list these and some others and explain why you may want to install
++them.</para>
++
++&zlib;
++&openssl;
++&pcre;
++&popt;
++&slang;
++&libfam;
++&libxml;
++&libxml2;
++&libxslt;
++
++</chapter>
+Index: general/genlib/zlib.xml
+===================================================================
+--- general/genlib/zlib.xml	(révision 0)
++++ general/genlib/zlib.xml	(révision 3)
+@@ -0,0 +1,19 @@
++<sect1 id="zlib" xreflabel="zlib-&zlib-version;">
++<?dbhtml filename="zlib.html" dir="general"?>
++<title>zlib-&zlib-version;</title>
++
++<para>Zlib provides compression and decompression functions to programs.
++Most people will want zlib because both servers and clients are 
++likely to need the openssl libraries which in turn require zlib.
++Servers will want openssl because it is needed for running OpenSSH services and
++clients because most web browsers need it to deal with https (secure)
++websites.</para>
++
++&zlib-intro;
++&zlib-inst;
++&zlib-exp;
++&zlib-config;
++&zlib-desc;
++
++</sect1>
++
+Index: general/genlib/libxslt.xml
+===================================================================
+--- general/genlib/libxslt.xml	(révision 0)
++++ general/genlib/libxslt.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="libxslt" xreflabel="libxslt-&libxslt-version;">
++<?dbhtml filename="libxslt.html" dir="general"?>
++<title>libxslt-&libxslt-version;</title>
++
++&libxslt-intro;
++&libxslt-inst;
++&libxslt-config;
++&libxslt-desc;
++
++</sect1>
++
+Index: general/genlib/popt.xml
+===================================================================
+--- general/genlib/popt.xml	(révision 0)
++++ general/genlib/popt.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="popt" xreflabel="popt">
++<?dbhtml filename="popt.html" dir="general"?>
++<title>popt</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: general/genlib/openssl.xml
+===================================================================
+--- general/genlib/openssl.xml	(révision 0)
++++ general/genlib/openssl.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="openssl" xreflabel="openssl-&openssl-version;">
++<?dbhtml filename="openssl.html" dir="general"?>
++<title>openssl-&openssl-version;</title>
++
++&openssl-intro;
++&openssl-inst;
++&openssl-exp;
++&openssl-config;
++&openssl-desc;
++
++</sect1>
+Index: general/genlib/popt/popt.ent
+===================================================================
+--- general/genlib/popt/popt.ent	(révision 0)
++++ general/genlib/popt/popt.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY popt SYSTEM "../popt.xml">
+Index: general/genlib/openssl/openssl-intro.xml
+===================================================================
+--- general/genlib/openssl/openssl-intro.xml	(révision 0)
++++ general/genlib/openssl/openssl-intro.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Introduction to openssl</title>
++
++<screen>Download location:              <ulink url="&openssl-download;"/>
++Version used:                   &openssl-version;
++Package size:                   &openssl-size;
++Estimated Disk space required:  &openssl-buildsize;</screen>
++
++<para>The openssl package contains <userinput>c_rehash</userinput>,
++<userinput>openssl</userinput>, <userinput>libcrypto</userinput> and
++<userinput>libssl</userinput>.  These are useful for providing
++cryptography functions to other packages, notably OpenSSH and web
++browsers (for accessing secure https sites).</para>
++
++</sect2>
+Index: general/genlib/openssl/openssl-exp.xml
+===================================================================
+--- general/genlib/openssl/openssl-exp.xml	(révision 0)
++++ general/genlib/openssl/openssl-exp.xml	(révision 3)
+@@ -0,0 +1,20 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>mv doc/apps/passwd.pod
++doc/apps/openssl-passwd.pod :</userinput> We do this because otherwise
++openssl installs it's passwd man page over the existing system one which
++isn't what we want.</para>
++
++<para><screen><userinput>make MANDIR=/usr/share/man</userinput>
++<userinput>make MANDIR=/usr/share/man install :</userinput></screen> These
++commands install openssl with the man pages in /usr/share/man instead of
++the default which is /etc/ssl/man.</para>
++ 
++<para><userinput>rmdir /etc/ssl/lib :</userinput> 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!</para>
++
++</sect2>
++
+Index: general/genlib/openssl/openssl-inst.xml
+===================================================================
+--- general/genlib/openssl/openssl-inst.xml	(révision 0)
++++ general/genlib/openssl/openssl-inst.xml	(révision 3)
+@@ -0,0 +1,21 @@
++<sect2>
++<title>Installation of openssl</title>
++
++<para>Install openssl by running the following commands:</para>
++
++<note><para>GCC issues a warning on every compilation because the Configure 
++command uses -m486 instead of -march=i486.  To fix this behavior, 
++change the definition on line 337 of Configure.  The line begins with "linux-elf". 
++</para></note>
++
++<para><screen><userinput>mv doc/apps/passwd.pod doc/apps/openssl-passwd.pod &&
++./Configure linux-elf  --openssldir=/etc/ssl --prefix=/usr shared &&</userinput>
++<userinput>make MANDIR=/usr/share/man &&</userinput>
++<userinput>make MANDIR=/usr/share/man install &&</userinput>
++<userinput>rmdir /etc/ssl/lib</userinput>
++</screen>
++</para>
++
++
++</sect2>
++
+Index: general/genlib/openssl/openssl-desc.xml
+===================================================================
+--- general/genlib/openssl/openssl-desc.xml	(révision 0)
++++ general/genlib/openssl/openssl-desc.xml	(révision 3)
+@@ -0,0 +1,47 @@
++<sect2>
++<title>Contents</title>
++
++<para>The openssl package contains <userinput>c_rehash</userinput>,
++<userinput>openssl</userinput>, <userinput>libcrypto</userinput> and
++<userinput>libssl</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>c_rehash</title>
++
++<para>No description is available for c_rehash.</para>
++
++</sect3>
++
++<sect3><title>openssl</title>
++
++<para>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
++<userinput>man 1 openssl</userinput>.</para>
++
++</sect3>
++
++<sect3><title>libcrypto</title>
++
++<para>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 SSH, OpenPGP, and other 
++cryptographic standards.</para>
++
++</sect3>
++
++<sect3><title>libssl</title>
++ 
++<para>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 
++<userinput>man 3 ssl</userinput>.</para>
++ 
++</sect3>
++
++</sect2>
++
+Index: general/genlib/openssl/openssl-config.xml
+===================================================================
+--- general/genlib/openssl/openssl-config.xml	(révision 0)
++++ general/genlib/openssl/openssl-config.xml	(révision 3)
+@@ -0,0 +1,18 @@
++<sect2>
++<title>Configuring Openssl</title>
++
++<sect3><title>Config files</title>
++<para><userinput>/etc/ssl/openssl.cnf</userinput></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para>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.</para>
++</sect3>
++
++</sect2>
++
+Index: general/genlib/openssl/openssl.ent
+===================================================================
+--- general/genlib/openssl/openssl.ent	(révision 0)
++++ general/genlib/openssl/openssl.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY openssl SYSTEM "../openssl.xml">
++<!ENTITY openssl-intro SYSTEM "openssl-intro.xml">
++<!ENTITY openssl-inst SYSTEM "openssl-inst.xml">
++<!ENTITY openssl-exp SYSTEM "openssl-exp.xml">
++<!ENTITY openssl-desc SYSTEM "openssl-desc.xml">
++<!ENTITY openssl-config SYSTEM "openssl-config.xml">
++<!ENTITY openssl-buildsize "23 MB">
++<!ENTITY openssl-version "0.9.6d">
++<!ENTITY openssl-download "ftp://ftp.openssl.org/source/openssl-0.9.6d.tar.gz">
++<!ENTITY openssl-size "2.0 MB">
+Index: general/genlib/slang.xml
+===================================================================
+--- general/genlib/slang.xml	(révision 0)
++++ general/genlib/slang.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="slang" xreflabel="slang">
++<?dbhtml filename="slang.html" dir="general"?>
++<title>slang</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: general/genlib/slang/slang.ent
+===================================================================
+--- general/genlib/slang/slang.ent	(révision 0)
++++ general/genlib/slang/slang.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY slang SYSTEM "../slang.xml">
+Index: general/general.ent
+===================================================================
+--- general/general.ent	(révision 0)
++++ general/general.ent	(révision 3)
+@@ -0,0 +1,65 @@
++<!ENTITY general SYSTEM "general.xml">
++
++<!-- General Libraries -->
++<!ENTITY general-genlib SYSTEM "genlib/genlib.xml">
++<!ENTITY % zlib SYSTEM "genlib/zlib/zlib.ent">
++<!ENTITY % openssl SYSTEM "genlib/openssl/openssl.ent">
++<!ENTITY % pcre SYSTEM "genlib/pcre/pcre.ent">
++<!ENTITY % xmllib SYSTEM "genlib/xmllib/xmllib.ent">
++<!ENTITY % popt SYSTEM "genlib/popt/popt.ent">
++<!ENTITY % libfam SYSTEM "genlib/libfam/libfam.ent">
++<!ENTITY % slang SYSTEM "genlib/slang/slang.ent">
++
++%zlib;
++%openssl;
++%pcre;
++%xmllib;
++%popt;
++%libfam;
++%slang;
++
++<!-- Graphics Libraries -->
++<!ENTITY general-graphlib SYSTEM "graphlib/graphlib.xml">
++<!ENTITY % lcms SYSTEM "graphlib/lcms/lcms.ent">
++<!ENTITY % libjpeg SYSTEM "graphlib/libjpeg/libjpeg.ent">
++<!ENTITY % libpng SYSTEM "graphlib/libpng/libpng.ent">
++<!ENTITY % libtiff SYSTEM "graphlib/libtiff/libtiff.ent">
++<!ENTITY % libungif SYSTEM "graphlib/libungif/libungif.ent">
++<!ENTITY % libmng SYSTEM "graphlib/libmng/libmng.ent">
++<!ENTITY % imlib SYSTEM "graphlib/imlib/imlib.ent">
++%lcms;
++%libjpeg;
++%libpng;
++%libtiff;
++%libungif;
++%libmng;
++%imlib;
++
++<!-- General Utilities -->
++<!ENTITY general-genutils SYSTEM "genutils/genutils.xml">
++<!ENTITY % bc SYSTEM "genutils/bc/bc.ent">
++%bc;
++
++<!-- System Utilities -->
++<!ENTITY general-sysutils SYSTEM "sysutils/sysutils.xml">
++<!ENTITY % gpm SYSTEM "sysutils/gpm/gpm.ent">
++<!ENTITY % fcron SYSTEM "sysutils/fcron/fcron.ent">
++<!ENTITY % hdparm SYSTEM "sysutils/hdparm/hdparm.ent">
++<!ENTITY % which SYSTEM "sysutils/which/which.ent">
++<!ENTITY % infozip SYSTEM "sysutils/infozip/infozip.ent">
++<!ENTITY % pccts SYSTEM "sysutils/pccts/pccts.ent">
++<!ENTITY % pciutils SYSTEM "sysutils/pciutils/pciutils.ent">
++<!ENTITY % pkgconfig SYSTEM "sysutils/pkgconfig/pkgconfig.ent">
++%gpm;
++%fcron;
++%hdparm;
++%which;
++%infozip;
++%pccts;
++%pciutils;
++%pkgconfig;
++
++<!-- Programming -->
++<!ENTITY general-prog SYSTEM "prog/prog.xml">
++<!ENTITY python SYSTEM "prog/python.xml">
++<!ENTITY jdk SYSTEM "prog/jdk.xml">
+Index: general/prog/python.xml
+===================================================================
+--- general/prog/python.xml	(révision 0)
++++ general/prog/python.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="python" xreflabel="python">
++<?dbhtml filename="python.html" dir="general"?>
++<title>python</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: general/prog/prog.xml
+===================================================================
+--- general/prog/prog.xml	(révision 0)
++++ general/prog/prog.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<chapter id="general-prog">
++<?dbhtml filename="prog.html" dir="general"?>
++<title>Programming</title>
++
++&python;
++&jdk;
++
++</chapter>
+Index: general/prog/jdk.xml
+===================================================================
+--- general/prog/jdk.xml	(révision 0)
++++ general/prog/jdk.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="jdk" xreflabel="jdk">
++<?dbhtml filename="jdk.html" dir="general"?>
++<title>jdk</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: general/graphlib/graphlib.xml
+===================================================================
+--- general/graphlib/graphlib.xml	(révision 0)
++++ general/graphlib/graphlib.xml	(révision 3)
+@@ -0,0 +1,18 @@
++<chapter id="general-graphlib">
++<?dbhtml filename="graphlib.html" dir="general"?>
++<title>Graphics Libraries</title>
++
++<para>Depending on what your system will be used for, you may or
++may not require the graphics libraries.  Most desktop machines will 
++want them for use with graphical applications.  Most servers on the 
++other hand, will not require them.</para>
++
++&lcms;
++&libjpeg;
++&libpng;
++&libtiff;
++&libungif;
++&libmng;
++&imlib;
++
++</chapter>
+Index: general/graphlib/libmng.xml
+===================================================================
+--- general/graphlib/libmng.xml	(révision 0)
++++ general/graphlib/libmng.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="libmng" xreflabel="libmng-&libmng-version;">
++<?dbhtml filename="libmng.html" dir="general"?>
++<title>libmng-&libmng-version;</title>
++
++&libmng-intro;
++&libmng-inst;
++&libmng-exp;
++&libmng-config;
++&libmng-desc;
++
++</sect1>
++
+Index: general/graphlib/libmng/libmng.ent
+===================================================================
+--- general/graphlib/libmng/libmng.ent	(révision 0)
++++ general/graphlib/libmng/libmng.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY libmng SYSTEM "../libmng.xml">
++<!ENTITY libmng-intro SYSTEM "libmng-intro.xml">
++<!ENTITY libmng-inst SYSTEM "libmng-inst.xml">
++<!ENTITY libmng-exp SYSTEM "libmng-exp.xml">
++<!ENTITY libmng-desc SYSTEM "libmng-desc.xml">
++<!ENTITY libmng-config SYSTEM "libmng-config.xml">
++<!ENTITY libmng-buildsize "4.6 MB">
++<!ENTITY libmng-version "1.0.3">
++<!ENTITY libmng-download "http://www.libmng.com/download/libmng-1.0.3.tar.gz">
++<!ENTITY libmng-size "516 KB">
+Index: general/graphlib/libmng/libmng-intro.xml
+===================================================================
+--- general/graphlib/libmng/libmng-intro.xml	(révision 0)
++++ general/graphlib/libmng/libmng-intro.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Introduction to libmng</title>
++
++<screen>Download location:              &libmng-download;
++Version used:                   &libmng-version;
++Package size:                   &libmng-size;
++Estimated Disk space required:  &libmng-buildsize;</screen>
++
++<para>The libmng libraries are used by programs wanting to read and
++write mng files which are the animation equivalents to png files.</para>
++
++<screen>libmng depends on: <xref linkend="zlib"></xref>, <xref linkend="libjpeg"></xref> and <xref linkend="lcms"></xref></screen>
++
++</sect2>
+Index: general/graphlib/libmng/libmng-exp.xml
+===================================================================
+--- general/graphlib/libmng/libmng-exp.xml	(révision 0)
++++ general/graphlib/libmng/libmng-exp.xml	(révision 3)
+@@ -0,0 +1,19 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>sed 's/lcms\/lcms.h/lcms.h/' configure.bak >
++configure :</userinput> This change is to make the libmng configure
++routine look in the right place for the lcms header files.</para>
++
++<para><screen><userinput>./configure --prefix=/usr --with-zlib \
++--with-jpeg --with-lcms </userinput></screen>
++
++This command sets the install directory and also tells the configuration
++routine to look and find zlib, libjpeg and lcms.</para>
++
++<para><userinput>cp doc/man/*.X /usr/share/man/manX :</userinput> The
++install procedure doesn't properly install the man pages so we do it
++manually.</para>
++
++</sect2>
++
+Index: general/graphlib/libmng/libmng-inst.xml
+===================================================================
+--- general/graphlib/libmng/libmng-inst.xml	(révision 0)
++++ general/graphlib/libmng/libmng-inst.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Installation of libmng</title>
++
++<para>Install libmng by running the following commands:</para>
++
++<para><screen><userinput>cp configure configure.bak &&
++sed 's/lcms\/lcms.h/lcms.h/' configure.bak > configure &&
++./configure --prefix=/usr --with-zlib \
++   --with-jpeg --with-lcms &&
++make &&
++make install &&
++cp doc/man/*.3 /usr/share/man/man3 &&
++cp doc/man/*.5 /usr/share/man/man5</userinput></screen></para>
++
++</sect2>
++
+Index: general/graphlib/libmng/libmng-desc.xml
+===================================================================
+--- general/graphlib/libmng/libmng-desc.xml	(révision 0)
++++ general/graphlib/libmng/libmng-desc.xml	(révision 3)
+@@ -0,0 +1,17 @@
++<sect2>
++<title>Contents</title>
++
++<para>The libmng package contains the <userinput>mng
++libraries</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>mng libraries</title>
++<para>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.</para></sect3>
++
++</sect2>
++
+Index: general/graphlib/libmng/libmng-config.xml
+===================================================================
+--- general/graphlib/libmng/libmng-config.xml	(révision 0)
++++ general/graphlib/libmng/libmng-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring libmng</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: general/graphlib/libpng.xml
+===================================================================
+--- general/graphlib/libpng.xml	(révision 0)
++++ general/graphlib/libpng.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="libpng" xreflabel="libpng-&libpng-version;">
++<?dbhtml filename="libpng.html" dir="general"?>
++<title>libpng-&libpng-version;</title>
++
++&libpng-intro;
++&libpng-inst;
++&libpng-exp;
++&libpng-config;
++&libpng-desc;
++
++</sect1>
++
+Index: general/graphlib/imlib.xml
+===================================================================
+--- general/graphlib/imlib.xml	(révision 0)
++++ general/graphlib/imlib.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="imlib" xreflabel="imlib-&imlib-version;">
++<?dbhtml filename="imlib.html" dir="general"?>
++<title>imlib-&imlib-version;</title>
++
++&imlib-intro;
++&imlib-inst;
++&imlib-config;
++&imlib-desc;
++
++</sect1>
++
+Index: general/graphlib/libjpeg.xml
+===================================================================
+--- general/graphlib/libjpeg.xml	(révision 0)
++++ general/graphlib/libjpeg.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="libjpeg" xreflabel="libjpeg-&libjpeg-version;">
++<?dbhtml filename="libjpeg.html" dir="general"?>
++<title>libjpeg-&libjpeg-version;</title>
++
++&libjpeg-intro;
++&libjpeg-inst;
++&libjpeg-exp;
++&libjpeg-config;
++&libjpeg-desc;
++
++</sect1>
++
+Index: general/graphlib/libpng/libpng-config.xml
+===================================================================
+--- general/graphlib/libpng/libpng-config.xml	(révision 0)
++++ general/graphlib/libpng/libpng-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring libpng</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: general/graphlib/libpng/libpng.ent
+===================================================================
+--- general/graphlib/libpng/libpng.ent	(révision 0)
++++ general/graphlib/libpng/libpng.ent	(révision 3)
+@@ -0,0 +1,11 @@
++<!ENTITY libpng SYSTEM "../libpng.xml">
++<!ENTITY libpng-intro SYSTEM "libpng-intro.xml">
++<!ENTITY libpng-inst SYSTEM "libpng-inst.xml">
++<!ENTITY libpng-exp SYSTEM "libpng-exp.xml">
++<!ENTITY libpng-desc SYSTEM "libpng-desc.xml">
++<!ENTITY libpng-config SYSTEM "libpng-config.xml">
++<!ENTITY libpng-buildsize "3.5 MB">
++<!ENTITY libpng-version "1.2.3">
++<!ENTITY libpng-download "http://www.libpng.org/pub/png/src/libpng-1.2.3.tar.gz">
++<!ENTITY libpng-download-ftp "ftp://swrinde.nde.swri.edu/pub/png/src/libpng-1.2.3.tar.gz">
++<!ENTITY libpng-size "481 KB">
+Index: general/graphlib/libpng/libpng-intro.xml
+===================================================================
+--- general/graphlib/libpng/libpng-intro.xml	(révision 0)
++++ general/graphlib/libpng/libpng-intro.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Introduction to libpng</title>
++
++<screen>Download location - HTTP:       <ulink url="&libpng-download;"/>
++Download location - FTP:	<ulink url="&libpng-download-ftp;"/>
++Version used:                   &libpng-version;
++Package size:                   &libpng-size;
++Estimated Disk space required:  &libpng-buildsize;</screen>
++
++<para>The libpng package contains the libpng libraries.  These are used
++by other programs for reading and writing png files.</para>
++
++<screen>libpng depends on: 
++<xref linkend="zlib"></xref></screen>
++
++</sect2>
+Index: general/graphlib/libpng/libpng-exp.xml
+===================================================================
+--- general/graphlib/libpng/libpng-exp.xml	(révision 0)
++++ general/graphlib/libpng/libpng-exp.xml	(révision 3)
+@@ -0,0 +1,18 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>CC="gcc $CFLAGS" :</userinput> This makes libpng use
++CFLAGS when compiling.</para>
++
++<para><userinput>ZLIBINC=/usr/include ZLIBLIB=/usr/lib
++:</userinput> This forces libpng to look for the zlib includes and
++libraries where we have them installed.</para>
++
++<para><userinput>-f scripts/makefile.linux :</userinput> This points
++make at the the Linux version of the makefile as libpng doesn't use a
++autoconf routine instead coming with various makefiles for different
++platforms.</para>
++
++
++</sect2>
++
+Index: general/graphlib/libpng/libpng-inst.xml
+===================================================================
+--- general/graphlib/libpng/libpng-inst.xml	(révision 0)
++++ general/graphlib/libpng/libpng-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of libpng</title>
++
++<para>Install libpng by running the following commands:</para>
++
++<para><screen><userinput>make prefix=/usr CC="gcc $CFLAGS" \
++   ZLIBINC=/usr/include ZLIBLIB=/usr/lib -f scripts/makefile.linux &&
++make prefix=/usr install -f scripts/makefile.linux</userinput></screen></para>
++
++</sect2>
++
+Index: general/graphlib/libpng/libpng-desc.xml
+===================================================================
+--- general/graphlib/libpng/libpng-desc.xml	(révision 0)
++++ general/graphlib/libpng/libpng-desc.xml	(révision 3)
+@@ -0,0 +1,18 @@
++<sect2>
++<title>Contents</title>
++
++<para>The libpng package contains the <userinput>png
++libraries</userinput> .</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>png libraries</title>
++<para>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.</para></sect3>
++
++</sect2>
++
+Index: general/graphlib/imlib/imlib-intro.xml
+===================================================================
+--- general/graphlib/imlib/imlib-intro.xml	(révision 0)
++++ general/graphlib/imlib/imlib-intro.xml	(révision 3)
+@@ -0,0 +1,17 @@
++<sect2>
++<title>Introduction to imlib</title>
++
++<screen>Download location:              <ulink url= "&imlib-download;"/>
++Version used:                   &imlib-version;
++Package size:                   &imlib-size;
++Estimated Disk space required:  &imlib-buildsize;</screen>
++
++<para>The imlib package contains image libraries. These are useful for
++loading, rendering and dithering a wide variety of image data formats.</para>
++
++<screen>imlib depends on: 
++<xref linkend="xfree86"/>, <xref linkend="libjpeg"/>, <xref linkend="libtiff"/>, <xref linkend="libungif"/> and <xref linkend="libpng"/>
++imlib will utilize: 
++glib, gtk and gtk-config if installed prior to imlib.</screen>
++
++</sect2>
+Index: general/graphlib/imlib/imlib-inst.xml
+===================================================================
+--- general/graphlib/imlib/imlib-inst.xml	(révision 0)
++++ general/graphlib/imlib/imlib-inst.xml	(révision 3)
+@@ -0,0 +1,23 @@
++<sect2>
++<title>Installation of imlib</title>
++
++<para>Install imlib by running the following commands:</para>
++
++<para><screen><userinput>CPPFLAGS=-w ./configure --prefix=/usr &&
++make &&
++make install</userinput></screen></para>
++
++</sect2>
++
++
++<sect2>
++<title>Command explanations</title>
++ 
++<para><userinput>CPPFLAGS=-w :</userinput>
++This
++disables gcc 3.1 warnings that confuse configure.</para>
++
++<para><userinput>./configure --prefix=/usr:</userinput>
++This compiles and installs imlib into the <filename>/usr</filename>
++hierarchy instead of <filename>/usr/local</filename>.</para>
++</sect2>
+Index: general/graphlib/imlib/imlib-desc.xml
+===================================================================
+--- general/graphlib/imlib/imlib-desc.xml	(révision 0)
++++ general/graphlib/imlib/imlib-desc.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Contents</title>
++
++<para>The imlib package contains <userinput>imlib libraries</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>imlib libraries</title>
++<para>imlib provides the functions for programs to display and edit a
++wide variety of image data formats.</para></sect3>
++
++
++</sect2>
++
+Index: general/graphlib/imlib/imlib-config.xml
+===================================================================
+--- general/graphlib/imlib/imlib-config.xml	(révision 0)
++++ general/graphlib/imlib/imlib-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring imlib</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: general/graphlib/imlib/imlib.ent
+===================================================================
+--- general/graphlib/imlib/imlib.ent	(révision 0)
++++ general/graphlib/imlib/imlib.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY imlib SYSTEM "../imlib.xml">
++<!ENTITY imlib-intro SYSTEM "imlib-intro.xml">
++<!ENTITY imlib-inst SYSTEM "imlib-inst.xml">
++<!ENTITY imlib-desc SYSTEM "imlib-desc.xml">
++<!ENTITY imlib-config SYSTEM "imlib-config.xml">
++<!ENTITY imlib-buildsize "8.6 MB">
++<!ENTITY imlib-version "1.9.14">
++<!ENTITY imlib-download "ftp://ftp.gnome.org/pub/GNOME/stable/sources/imlib/imlib-1.9.14.tar.gz">
++<!ENTITY imlib-size "736 KB">
+Index: general/graphlib/libjpeg/libjpeg-config.xml
+===================================================================
+--- general/graphlib/libjpeg/libjpeg-config.xml	(révision 0)
++++ general/graphlib/libjpeg/libjpeg-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring libjpeg</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: general/graphlib/libjpeg/libjpeg.ent
+===================================================================
+--- general/graphlib/libjpeg/libjpeg.ent	(révision 0)
++++ general/graphlib/libjpeg/libjpeg.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY libjpeg SYSTEM "../libjpeg.xml">
++<!ENTITY libjpeg-intro SYSTEM "libjpeg-intro.xml">
++<!ENTITY libjpeg-inst SYSTEM "libjpeg-inst.xml">
++<!ENTITY libjpeg-exp SYSTEM "libjpeg-exp.xml">
++<!ENTITY libjpeg-desc SYSTEM "libjpeg-desc.xml">
++<!ENTITY libjpeg-config SYSTEM "libjpeg-config.xml">
++<!ENTITY libjpeg-buildsize "3.7 MB">
++<!ENTITY libjpeg-version "6b">
++<!ENTITY libjpeg-download "ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz">
++<!ENTITY libjpeg-size "599 KB">
+Index: general/graphlib/libjpeg/libjpeg-intro.xml
+===================================================================
+--- general/graphlib/libjpeg/libjpeg-intro.xml	(révision 0)
++++ general/graphlib/libjpeg/libjpeg-intro.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Introduction to libjpeg</title>
++
++<screen>Download location:              &libjpeg-download;
++Version used:                   &libjpeg-version;
++Package size:                   &libjpeg-size;
++Estimated Disk space required:  &libjpeg-buildsize;</screen>
++
++<para>The libjpeg package contains the jpeg libraries.  These allow compression
++of image files based on the Joint Photographic Experts Group standard.  It is a
++"lossy" compression algorithm.</para>
++
++</sect2>
+Index: general/graphlib/libjpeg/libjpeg-exp.xml
+===================================================================
+--- general/graphlib/libjpeg/libjpeg-exp.xml	(révision 0)
++++ general/graphlib/libjpeg/libjpeg-exp.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>./configure --enable-static --enable-shared --prefix=/usr</userinput> 
++This command tells libjpeg to build both shared and
++static libraries and to install them with a base of /usr.</para>
++
++</sect2>
++
+Index: general/graphlib/libjpeg/libjpeg-inst.xml
+===================================================================
+--- general/graphlib/libjpeg/libjpeg-inst.xml	(révision 0)
++++ general/graphlib/libjpeg/libjpeg-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of libjpeg</title>
++
++<para>Install libjpeg by running the following commands:</para>
++
++<para><screen><userinput>./configure --enable-static --enable-shared --prefix=/usr &&</userinput>
++<userinput>make &&</userinput>
++<userinput>make install</userinput></screen></para>
++
++</sect2>
++
+Index: general/graphlib/libjpeg/libjpeg-desc.xml
+===================================================================
+--- general/graphlib/libjpeg/libjpeg-desc.xml	(révision 0)
++++ general/graphlib/libjpeg/libjpeg-desc.xml	(révision 3)
+@@ -0,0 +1,38 @@
++<sect2>
++<title>Contents</title>
++
++<para>The libjpeg package contains <userinput>cjpeg, djpeg, jpegtran,
++rdjpgcom, wrjpgcom</userinput> and the <userinput>jpeg
++libraries</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>cjpeg</title>
++<para>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</para></sect3>
++
++<sect3><title>djpeg</title>
++<para>djpeg decompresses image files from JPEG/JFIF format to either PPM 
++(PBMPLUS color format), PGM (PBMPLUS gray-scale format), BMP, or Targa
++format.</para></sect3>
++
++<sect3><title>jpegtran</title>
++<para>jpegtran is used for lossless transformation of JPEG
++files</para></sect3>
++
++<sect3><title>rdjpgcom</title>
++<para>rdjpgcom displays text comments from within a JPEG
++file</para></sect3>
++
++<sect3><title>wrjpgcom</title>
++<para>wrjpgcom inserts text comments into a JPEG file</para></sect3>
++
++<sect3><title>jpeg libraries</title>
++<para>These libraries are used by many programs for reading and writing
++jpeg format files.</para></sect3>
++
++</sect2>
++
+Index: general/graphlib/lcms.xml
+===================================================================
+--- general/graphlib/lcms.xml	(révision 0)
++++ general/graphlib/lcms.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="lcms" xreflabel="lcms-&lcms-version;">
++<?dbhtml filename="lcms.html" dir="general"?>
++<title>lcms-&lcms-version;</title>
++
++&lcms-intro;
++&lcms-inst;
++&lcms-exp;
++&lcms-config;
++&lcms-desc;
++
++</sect1>
++
+Index: general/graphlib/lcms/lcms-config.xml
+===================================================================
+--- general/graphlib/lcms/lcms-config.xml	(révision 0)
++++ general/graphlib/lcms/lcms-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring lcms</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: general/graphlib/lcms/lcms.ent
+===================================================================
+--- general/graphlib/lcms/lcms.ent	(révision 0)
++++ general/graphlib/lcms/lcms.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY lcms SYSTEM "../lcms.xml">
++<!ENTITY lcms-intro SYSTEM "lcms-intro.xml">
++<!ENTITY lcms-inst SYSTEM "lcms-inst.xml">
++<!ENTITY lcms-exp SYSTEM "lcms-exp.xml">
++<!ENTITY lcms-desc SYSTEM "lcms-desc.xml">
++<!ENTITY lcms-config SYSTEM "lcms-config.xml">
++<!ENTITY lcms-buildsize "3.7 MB">
++<!ENTITY lcms-version "1.08">
++<!ENTITY lcms-download "http://www.littlecms.com/lcms-1.08.tar.gz">
++<!ENTITY lcms-size "158 KB">
+Index: general/graphlib/lcms/lcms-intro.xml
+===================================================================
+--- general/graphlib/lcms/lcms-intro.xml	(révision 0)
++++ general/graphlib/lcms/lcms-intro.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect2>
++<title>Introduction to lcms</title>
++
++<screen>Download location:              &lcms-download;
++Version used:                   &lcms-version;
++Package size:                   &lcms-size;
++Estimated Disk space required:  &lcms-buildsize;</screen>
++
++<para>The lcms library is used by other programs to provide
++color management facilities.</para>
++
++</sect2>
+Index: general/graphlib/lcms/lcms-exp.xml
+===================================================================
+--- general/graphlib/lcms/lcms-exp.xml	(révision 0)
++++ general/graphlib/lcms/lcms-exp.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>CC="gcc $CFLAGS" :</userinput> This makes lcms use 
++the CFLAGS set in your environment.</para>
++
++</sect2>
++
+Index: general/graphlib/lcms/lcms-inst.xml
+===================================================================
+--- general/graphlib/lcms/lcms-inst.xml	(révision 0)
++++ general/graphlib/lcms/lcms-inst.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Installation of lcms</title>
++
++<para>Install lcms by running the following commands:</para>
++
++<para><screen><userinput>make CC="gcc $CFLAGS" &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: general/graphlib/lcms/lcms-desc.xml
+===================================================================
+--- general/graphlib/lcms/lcms-desc.xml	(révision 0)
++++ general/graphlib/lcms/lcms-desc.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Contents</title>
++
++<para>The lcms package contains the <userinput>lcms library</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>lcms library</title>
++<para>The lcms library is used by other programs to provide color
++management facilities.</para></sect3>
++
++</sect2>
++
+Index: general/graphlib/libtiff.xml
+===================================================================
+--- general/graphlib/libtiff.xml	(révision 0)
++++ general/graphlib/libtiff.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="libtiff" xreflabel="libtiff-&libtiff-version;">
++<?dbhtml filename="libtiff.html" dir="general"?>
++<title>libtiff-&libtiff-version;</title>
++
++&libtiff-intro;
++&libtiff-inst;
++&libtiff-exp;
++&libtiff-config;
++&libtiff-desc;
++
++</sect1>
++
+Index: general/graphlib/libungif.xml
+===================================================================
+--- general/graphlib/libungif.xml	(révision 0)
++++ general/graphlib/libungif.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="libungif" xreflabel="libungif-&libungif-version;">
++<?dbhtml filename="libungif.html" dir="general"?>
++<title>libungif-&libungif-version;</title>
++
++&libungif-intro;
++&libungif-inst;
++&libungif-config;
++&libungif-desc;
++
++</sect1>
++
+Index: general/graphlib/libtiff/libtiff.ent
+===================================================================
+--- general/graphlib/libtiff/libtiff.ent	(révision 0)
++++ general/graphlib/libtiff/libtiff.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY libtiff SYSTEM "../libtiff.xml">
++<!ENTITY libtiff-intro SYSTEM "libtiff-intro.xml">
++<!ENTITY libtiff-inst SYSTEM "libtiff-inst.xml">
++<!ENTITY libtiff-exp SYSTEM "libtiff-exp.xml">
++<!ENTITY libtiff-desc SYSTEM "libtiff-desc.xml">
++<!ENTITY libtiff-config SYSTEM "libtiff-config.xml">
++<!ENTITY libtiff-buildsize "5.9 MB">
++<!ENTITY libtiff-version "3.5.7">
++<!ENTITY libtiff-download "ftp://ftp.remotesensing.org/pub/libtiff/tiff-v3.5.7.tar.gz">
++<!ENTITY libtiff-size "928 KB">
+Index: general/graphlib/libtiff/libtiff-intro.xml
+===================================================================
+--- general/graphlib/libtiff/libtiff-intro.xml	(révision 0)
++++ general/graphlib/libtiff/libtiff-intro.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Introduction to libtiff</title>
++
++<screen>Download location:              <ulink url="&libtiff-download;"/>
++Version used:                   &libtiff-version;
++Package size:                   &libtiff-size;
++Estimated Disk space required:  &libtiff-buildsize;</screen>
++
++<para>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.</para>
++
++</sect2>
+Index: general/graphlib/libtiff/libtiff-exp.xml
+===================================================================
+--- general/graphlib/libtiff/libtiff-exp.xml	(révision 0)
++++ general/graphlib/libtiff/libtiff-exp.xml	(révision 3)
+@@ -0,0 +1,19 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>--noninteractive :</userinput> This switch is used to
++avoid the configuration routine asking for confirmation of the
++directories to install to (which we pass using switches to configure
++anyways).</para> 
++
++<para><userinput>--with-GCOPTS="$CFLAGS" :</userinput> This switch
++causes libtiff to be built using the options we have set in $CFLAGS
++(which most other packages handle automatically).</para>
++
++<para><userinput>--with-DIR_MAN=/usr/share/man :</userinput> 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.</para>
++
++</sect2>
++
+Index: general/graphlib/libtiff/libtiff-inst.xml
+===================================================================
+--- general/graphlib/libtiff/libtiff-inst.xml	(révision 0)
++++ general/graphlib/libtiff/libtiff-inst.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect2>
++<title>Installation of libtiff</title>
++
++<para>Install libtiff by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr --noninteractive \
++   --with-GCOPTS="$CFLAGS" --with-DIR_MAN=/usr/share/man &&
++make &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: general/graphlib/libtiff/libtiff-desc.xml
+===================================================================
+--- general/graphlib/libtiff/libtiff-desc.xml	(révision 0)
++++ general/graphlib/libtiff/libtiff-desc.xml	(révision 3)
+@@ -0,0 +1,80 @@
++<sect2>
++<title>Contents</title>
++
++<para>The libtiff package contains <userinput>fax2ps, fax2tiff, gif2tiff, 
++pal2rgb, ppm2tiff, ras2tiff, rgb2ycbcr, thumbnail, tiff2bw, tiff2ps,
++tiff2rgba, tiffcmp, tiffcp, tiffdither, tiffdump, tiffinfo, tiffmedian,
++tiffsplit</userinput> and the <userinput>tiff libraries</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>fax2ps</title>
++<para>fac2ps converts a TIFF facsimile to compressed postscript 
++file</para></sect3>
++
++<sect3><title>fax2tiff</title>
++<para>fax2tiff creates a TIFF Class F fax file from raw fax 
++data</para></sect3>
++
++<sect3><title>gif2tiff</title>
++<para>gif2tiff creates a TIFF file from a GIF87 format image 
++file</para></sect3>
++
++<sect3><title>pal2rgb</title>
++<para>pal2rgb converts a palette color TIFF image to a full 
++color image</para></sect3>
++
++<sect3><title>ppm2tiff</title>
++<para>ppm2tiff creates a TIFF file from a PPM image file</para></sect3>
++
++<sect3><title>ras2tiff</title>
++<para>ras2tiff creates a TIFF file from a Sun rasterfile</para></sect3>
++
++<sect3><title>rgb2ycbcr</title>
++<para>rgb2ycbcr converts non-YCbCr TIFF images to a YCbCr TIFF 
++image</para></sect3>
++
++<sect3><title>thumbnail</title>
++<para>thumbnail creates a TIFF file with thumbnail images</para></sect3>
++
++<sect3><title>tiff2bw</title>
++<para>tiff2bw converts a color TIFF image to greyscale</para></sect3>
++
++<sect3><title>tiff2ps</title>
++<para>tiff2ps converts a TIFF image to a postscript file</para></sect3>
++
++<sect3><title>tiff2rgba</title>
++<para>No description available</para></sect3>
++
++<sect3><title>tiffcmp</title>
++<para>tiffcmp compares two TIFF files</para></sect3>
++
++<sect3><title>tiffcp</title>
++<para>tiffcp copies (and possibly converts) a TIFF file</para></sect3>
++
++<sect3><title>tiffdither</title>
++<para>tiffdither converts a greyscale image to bilevel using 
++dithering</para></sect3>
++
++<sect3><title>tiffdump</title>
++<para>tiffdump prints verbatim information about TIFF files</para></sect3>
++
++<sect3><title>tiffinfo</title>
++<para>tiffinfo prints information about TIFF files</para></sect3>
++
++<sect3><title>tiffmedian</title>
++<para>tiffmedian applies the median cut algorithm to data in a 
++TIFF file</para></sect3>
++
++<sect3><title>tiffsplit</title>
++<para>tiffsplit splits a multi-image TIFF into single-image 
++TIFF files</para></sect3>
++
++<sect3><title>tiff libraries</title>
++<para>The tiff libraries are used by many programs to read and write
++tiff files</para></sect3>
++
++</sect2>
++
+Index: general/graphlib/libtiff/libtiff-config.xml
+===================================================================
+--- general/graphlib/libtiff/libtiff-config.xml	(révision 0)
++++ general/graphlib/libtiff/libtiff-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring libtiff</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: general/graphlib/libungif/libungif-intro.xml
+===================================================================
+--- general/graphlib/libungif/libungif-intro.xml	(révision 0)
++++ general/graphlib/libungif/libungif-intro.xml	(révision 3)
+@@ -0,0 +1,25 @@
++<sect2>
++<title>Introduction to libungif</title>
++
++<screen>Download location:              <ulink url="&libungif-download;"/>
++Version used:                   &libungif-version;
++Package size:                   &libungif-size;
++Estimated Disk space required:  &libungif-buildsize;</screen>
++
++<para>The libungif package contains libraries for reading all gifs and
++writing uncompressed 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.</para>
++
++<para>The reason libungif only writes uncompressed gifs is due to a
++legal issue with LZW compression (which Unisys claims a patent on).
++Reading gifs is not a problem as the uncompression 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, whilst 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.</para>
++
++</sect2>
+Index: general/graphlib/libungif/libungif-inst.xml
+===================================================================
+--- general/graphlib/libungif/libungif-inst.xml	(révision 0)
++++ general/graphlib/libungif/libungif-inst.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Installation of libungif</title>
++
++<para>Install libungif by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install</userinput></screen></para>
++
++<note><para>If you get an error during the make portion compiling lib/qprinf.c,
++edit the file and comment out or remove line 14: #include <config.h> 
++</para></note>
++
++</sect2>
++
+Index: general/graphlib/libungif/libungif-desc.xml
+===================================================================
+--- general/graphlib/libungif/libungif-desc.xml	(révision 0)
++++ general/graphlib/libungif/libungif-desc.xml	(révision 3)
+@@ -0,0 +1,106 @@
++<sect2>
++<title>Contents</title>
++
++<para>The libungif package contains <userinput>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</userinput> and the <userinput>ungif
++libraries</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>gif2epsn</title>
++<para>Dumps images saved as GIF files on Epson type printers.</para></sect3>
++
++<sect3><title>gif2ps</title>
++<para>Print GIF file on laser printers supporting PostScript.</para></sect3>
++
++<sect3><title>gif2rgb</title>
++<para>Convert images saved as GIF to 24-bit RGB image(s).</para></sect3>
++
++<sect3><title>gifasm</title>
++<para>assemble multiple GIFs into one, or burst a 
++multiple-image GIF.</para></sect3>
++
++<sect3><title>gifbg</title>
++<para>Generate a single-color test pattern GIF.</para></sect3>
++
++<sect3><title>gifburst</title>
++<para>Burst a GIF image into subrectangles.</para></sect3>
++
++<sect3><title>gifclip</title>
++<para>Clip or crop a GIF image.</para></sect3>
++
++<sect3><title>gifclrmp</title>
++<para>Modify GIF image colormaps.</para></sect3>
++
++<sect3><title>gifcolor</title>
++<para>Generate color test patterns.</para></sect3>
++
++<sect3><title>gifcomb</title>
++<para>Combine 2 GIF images of exactly the same size into one.</para></sect3>
++
++<sect3><title>gifcompose</title>
++<para>Use (un)giflib tools to compose images.</para></sect3>
++
++<sect3><title>giffiltr</title>
++<para>Template code for filtering a GIF sequentially.</para></sect3>
++
++<sect3><title>giffix</title>
++<para>Clumsily attempts to fix truncated GIF images.</para></sect3>
++
++<sect3><title>gifflip</title>
++<para>Flip GIF image along X or Y axis or rotate by 90 degrees.</para></sect3>
++
++<sect3><title>gifhisto</title>
++<para>Generate color-frequency histogram from a GIF.</para></sect3>
++
++<sect3><title>gifinfo</title>
++<para>Gives information on a GIF file.</para></sect3>
++
++<sect3><title>gifinter</title>
++<para>Convert between interlaced and non interlaced images.</para></sect3>
++
++<sect3><title>gifinto</title>
++<para>End-of-pipe fitting for GIF-processing pipelines.</para></sect3>
++
++<sect3><title>gifovly</title>
++<para>Generate one composite GIF from a multiple-image GIF.</para></sect3>
++
++<sect3><title>gifpos</title>
++<para>Change a GIF's screen size or recondition it.</para></sect3>
++
++<sect3><title>gifrotat</title>
++<para>Rotate a GIF through any desired angle.</para></sect3>
++
++<sect3><title>gifrsize</title>
++<para>Resize a GIF by deletion or duplication of bits.</para></sect3>
++
++<sect3><title>gifspnge</title>
++<para>Template code for filtering a GIF with in-core operations.</para></sect3>
++
++<sect3><title>giftext</title>
++<para>Print (text only) general information about a GIF</para></sect3>
++
++<sect3><title>gifwedge</title>
++<para>Create a test GIF image resembling a color monitor test
++pattern.</para></sect3>
++
++<sect3><title>icon2gif</title>
++<para>Converter/deconverter to/from an editable text format.</para></sect3>
++
++<sect3><title>raw2gif</title>
++<para>Convert raw 8-bit image data into GIF files.</para></sect3>
++
++<sect3><title>rgb2gif</title>
++<para>Convert 24 bit images to a GIF image using color 
++quantization.</para></sect3>
++
++<sect3><title>text2gif</title>
++<para>Generate GIF images out of regular text in 8x8 font.</para></sect3>
++
++</sect2>
++
+Index: general/graphlib/libungif/libungif-config.xml
+===================================================================
+--- general/graphlib/libungif/libungif-config.xml	(révision 0)
++++ general/graphlib/libungif/libungif-config.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Configuring libungif</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
+Index: general/graphlib/libungif/libungif.ent
+===================================================================
+--- general/graphlib/libungif/libungif.ent	(révision 0)
++++ general/graphlib/libungif/libungif.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY libungif SYSTEM "../libungif.xml">
++<!ENTITY libungif-intro SYSTEM "libungif-intro.xml">
++<!ENTITY libungif-inst SYSTEM "libungif-inst.xml">
++<!ENTITY libungif-desc SYSTEM "libungif-desc.xml">
++<!ENTITY libungif-config SYSTEM "libungif-config.xml">
++<!ENTITY libungif-buildsize "3.1 MB">
++<!ENTITY libungif-version "4.1.0b1">
++<!ENTITY libungif-download "http://www.linuxpackages.net/packages/Slackware-8/robert/libungif-4.1.0b1/source/libungif-4.1.0b1.tar.gz">
++<!ENTITY libungif-size "343 KB">
+Index: general/genutils/bc.xml
+===================================================================
+--- general/genutils/bc.xml	(révision 0)
++++ general/genutils/bc.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="bc" xreflabel="bc">
++<?dbhtml filename="bc.html" dir="general"?>
++<title>bc</title>
++
++<para>NEW ITEM - TO BE DONE</para>
++
++</sect1>
++
+Index: general/genutils/bc/bc.ent
+===================================================================
+--- general/genutils/bc/bc.ent	(révision 0)
++++ general/genutils/bc/bc.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY bc SYSTEM "../bc.xml">
+Index: general/genutils/genutils.xml
+===================================================================
+--- general/genutils/genutils.xml	(révision 0)
++++ general/genutils/genutils.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<chapter id="general-genutils">
++<?dbhtml filename="genutils.html" dir="general"?>
++<title>General Utilities</title>
++
++&bc;
++
++</chapter>
+Index: general/general.xml
+===================================================================
+--- general/general.xml	(révision 0)
++++ general/general.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<part id="general" xreflabel="General Libraries and Utilities">
++<?dbhtml filename="general.html" dir="general"?>
++<title>General Libraries and Utilities</title>
++
++&general-genlib;
++&general-graphlib;
++&general-genutils;
++&general-sysutils;
++&general-prog;
++
++</part>
+Index: introduction/important/bootscripts.xml
+===================================================================
+--- introduction/important/bootscripts.xml	(révision 0)
++++ introduction/important/bootscripts.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect1 id="intro-important-bootscripts">
++<?dbhtml filename="bootscripts.html" dir="introduction"?>
++<title>Using BLFS bootscripts</title>
++
++<para>The scripts included for packages such as <xref linkend="gpm"/>
++and <xref linkend="alsa"/> are based around the template supplied with
++the lfs-bootscripts package from version 3.2 and later of the LFS book.
++Note that this is lfs-bootscripts-1.6 and later (the old numbering
++changed as of LFS-3.2).  The scripts won't work with versions of LFS
++before 3.2 because of a change in their organisation with the new
++scripts.  However, it should be trivial to adapt the scripts if needed
++for older LFS versions.</para>
++
++</sect1>
+Index: introduction/important/important.xml
+===================================================================
+--- introduction/important/important.xml	(révision 0)
++++ introduction/important/important.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<chapter id="intro-important" xreflabel="Important Information">
++<?dbhtml filename="important.html" dir="introduction"?>
++<title>Important Information</title>
++
++&intro-important-unpacking;
++&intro-important-position;
++&intro-important-bootscripts;
++&intro-important-beyond;
++
++</chapter>
+Index: introduction/important/unpacking.xml
+===================================================================
+--- introduction/important/unpacking.xml	(révision 0)
++++ introduction/important/unpacking.xml	(révision 3)
+@@ -0,0 +1,59 @@
++<sect1 id="intro-important-unpacking">
++<?dbhtml filename="unpacking.html" dir="introduction"?>
++<title>Getting and unpacking the software</title>
++
++<para>Those people who have built a LFS system will be aware of the
++general principles of downloading and unpacking software.  We will
++however repeat some of that information here for those new to building
++their own software.</para>
++
++<para>One difference from the LFS book is that we do <emphasis>not</emphasis> 
++mirror the packages on the BLFS website.
++Instead, each set of installation instructions contains a URL from which
++you can download the package.  We do however keep a selection of patches
++available via http/ftp.  These are referenced as needed in the
++installation instructions.</para>
++
++<para>Whilst you can keep the source tarballs anywhere you like, we
++assume that you have unpacked them and unzipped any required patches
++into <filename>/usr/src</filename>.</para>
++
++<para>We can not emphasise strongly enough that you should start from a
++<emphasis>clean source tree</emphasis> each time.  This means that if
++you have had an error, it's usually best to delete the source tree and
++re-unpack it <emphasis>before</emphasis> trying again.  This obviously
++doesn't apply if you're an advanced user used to hacking Makefiles and C
++code, but if in doubt, start from a clean tree.</para>
++
++<sect2>
++<title>Unpacking the software</title>
++
++<para>If a file is tar'ed and gzip'ed, it is unpacked by running one of
++the following two commands, depending on the filename:</para>
++
++<screen><userinput>tar xvzf filename.tar.gz
++tar xvzf filename.tgz
++tar xvzf filename.tar.Z</userinput></screen>
++
++<para>If a file is tar'ed and bzip2'ed, it can usually be unpacked by
++running:</para>
++
++<screen><userinput>tar jxvf filename.tar.bz2</userinput></screen>
++
++<para>This applies as long as you patched tar to include the j option
++during your LFS install.  If you didn't, you can use a slightly
++different method:</para>
++
++<screen><userinput>bzcat filename.tar.bz2 | tar xv</userinput></screen>
++
++<para>Finally, you need to be able to unpack patches which are generally
++not tar'd.  The best way to do this is to copy the patch file to
++<filename>/usr/src</filename> and then to run one of the following
++commands depending on whether the file is .gz or .bz2:</para>
++
++<screen><userinput>gunzip patchname.gz
++bunzip2 patchname.bz2</userinput></screen>
++
++</sect2>
++
++</sect1>
+Index: introduction/important/beyond.xml
+===================================================================
+--- introduction/important/beyond.xml	(révision 0)
++++ introduction/important/beyond.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="intro-important-beyond">
++<?dbhtml filename="beyond.html" dir="introduction"?>
++<title>Going Beyond BLFS</title>
++
++<para>NEW PAGE TO BE WRITTEN</para>
++
++</sect1>
+Index: introduction/important/position.xml
+===================================================================
+--- introduction/important/position.xml	(révision 0)
++++ introduction/important/position.xml	(révision 3)
+@@ -0,0 +1,82 @@
++<sect1 id="intro-important-position">
++<?dbhtml filename="position.html" dir="introduction"?>
++<title>The /usr versus /usr/local debate</title>
++
++<para><emphasis>Should I install XXX in /usr or
++/usr/local?</emphasis></para>
++
++<para>This is a question without an obvious answer for an LFS based
++system.</para>
++
++<para>In traditional unix systems, <filename>/usr</filename> usually 
++contains files that come
++with the system distribution, and the <filename>/usr/local</filename> tree 
++is free for the local administrator to add things to.  The only 
++really hard and fast
++rule is that unix distributions should not touch
++<filename>/usr/local</filename>, except
++perhaps for creating the basic directories within it.</para>
++
++<para>With Linux distributions, like RedHat, Debian etc. a possible rule is
++that <filename>/usr</filename> is managed by the distribution's 
++package system and <filename>/usr/local</filename> is not.  This way the 
++package manager's database knows about every file within
++<filename>/usr</filename>.</para>
++
++<para>LFS users build their own system and so deciding where the system ends
++and local files begin is not straightforward.  So the choice should be
++made in order to make things easier to administer.  There are several
++reasons for dividing files between <filename>/usr</filename> and
++<filename>/usr/local</filename>.</para>
++
++<itemizedlist>
++
++<listitem><para>On a network of several machines all running LFS, or mixed 
++LFS and
++other Linux distributions, <filename>/usr/local</filename> could be used to 
++hold packages
++that are common between all the computers in the network.  It can be
++NFS mounted or mirrored from a single server.  Here local indicates
++local to the site.</para></listitem>
++
++<listitem><para>On a network of several computers all running an identical 
++LFS system <filename>/usr/local</filename> could hold packages that 
++are different between the machines.  In this case local refers to 
++the individual computers.</para></listitem>
++
++<listitem><para>Even on a single computer <filename>/usr/local</filename> can 
++be useful if you have several distributions installed simultaneously, and want 
++a place to put packages that will be the same on all of
++them.</para></listitem>
++
++<listitem><para>Or you might regularly rebuild your LFS, but want 
++a place to put files
++that you don't want to rebuild each time.  This way you can wipe the
++LFS filesystem and start from a clean partition everytime without losing
++everything.</para></listitem>
++
++</itemizedlist>
++
++<para>Some people ask why not use your own directory tree, eg
++<filename>/usr/site</filename> rather than
++<filename>/usr/local</filename>?</para>
++
++<para>There is nothing stopping you, many sites do make their own trees, however
++it makes installing new software more difficult.  Automatic installers
++often look for dependencies in <filename>/usr</filename> and
++<filename>/usr/local</filename>, and if the file it is looking
++for is in <filename>/usr/site</filename> instead, the installer will 
++probably fail unless
++you specifically tell it where to look.</para>
++
++<para><emphasis>What is the BLFS position on this?</emphasis></para>
++
++<para>All of the BLFS instructions install programs in
++<filename>/usr</filename> unless specifically stated otherwise.  There
++are examples where some files are placed in the
++<filename>/usr/local</filename> hierarchy but these are documented and
++are generally for a good reason. These exceptions should be well documented 
++in the book.  If you think you have
++found one which isn't please tell us!</para>
++
++</sect1>
+Index: introduction/introduction.xml
+===================================================================
+--- introduction/introduction.xml	(révision 0)
++++ introduction/introduction.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<part id="introduction" xreflabel="Introduction">
++<?dbhtml filename="introduction.html" dir="introduction"?>
++<title>Introduction</title>
++
++&intro-welcome;
++&intro-important;
++
++</part>
+Index: introduction/introduction.ent
+===================================================================
+--- introduction/introduction.ent	(révision 0)
++++ introduction/introduction.ent	(révision 3)
+@@ -0,0 +1,19 @@
++<!ENTITY introduction SYSTEM "introduction.xml">
++
++<!ENTITY intro-welcome SYSTEM "welcome/welcome.xml">
++<!ENTITY intro-welcome-conventions SYSTEM "welcome/conventions.xml">
++<!ENTITY intro-welcome-version SYSTEM "welcome/version.xml">
++<!ENTITY intro-welcome-acks SYSTEM "welcome/acknowledgments.xml">
++<!ENTITY intro-welcome-credits SYSTEM "welcome/credits.xml">
++<!ENTITY intro-welcome-changelog SYSTEM "welcome/changelog.xml">
++<!ENTITY intro-welcome-whichsect SYSTEM "welcome/which.xml">
++<!ENTITY intro-welcome-mailinglists SYSTEM "welcome/maillists.xml">
++<!ENTITY intro-welcome-newsserver SYSTEM "welcome/newsserver.xml">
++<!ENTITY intro-welcome-contact SYSTEM "welcome/contact.xml">
++<!ENTITY intro-welcome-askhelp SYSTEM "welcome/askhelp.xml">
++
++<!ENTITY intro-important SYSTEM "important/important.xml">
++<!ENTITY intro-important-unpacking SYSTEM "important/unpacking.xml">
++<!ENTITY intro-important-position SYSTEM "important/position.xml">
++<!ENTITY intro-important-bootscripts SYSTEM "important/bootscripts.xml">
++<!ENTITY intro-important-beyond SYSTEM "important/beyond.xml">
+Index: introduction/welcome/acknowledgments.xml
+===================================================================
+--- introduction/welcome/acknowledgments.xml	(révision 0)
++++ introduction/welcome/acknowledgments.xml	(révision 3)
+@@ -0,0 +1,50 @@
++<sect1 id="intro-welcome-acknowledgments">
++<?dbhtml filename="acknowledgments.html" dir="introduction"?>
++<title>Acknowledgments</title>
++
++<para>We would like to thank the following people and organizations for their
++contributions toward the BLFS and LFS projects:</para>
++
++<itemizedlist>
++
++<listitem><para><ulink url="mailto:strider at linux.com">Mark Stone</ulink> 
++<mstone at linux.com> for donating the linuxfromscratch.org 
++servers.</para></listitem>
++ 
++<listitem><para><ulink url="http://www.valinux.com">VA Linux
++Systems</ulink> for providing rackspace and bandwidth for the 
++linuxfromscratch.org server.</para></listitem>
++
++<listitem><para><ulink url="mailto:gerard at linuxfromscratch.org">Gerard
++Beekmans</ulink> <gerard at linuxfromscratch.org> for starting and
++writing the vast majority of the LFS project.</para></listitem>
++
++<listitem><para><ulink url="mailto:highos at linuxfromscratch.org">Jesse
++Tie-Ten-Quee</ulink> <highos at linuxfromscratch.org> for answering
++many questions on irc, having a great deal of patience and for not
++killing the current editor for the joke in the original BLFS
++announcement!</para></listitem>
++
++<listitem><para><ulink url="http://www.dreamwvr.com/services">DREAMWVR.COM</ulink> for their ongoing sponsorship by donating various resources to the LFS and
++related sub projects.</para></listitem>
++
++<listitem><para>Robert Briggs for donating the linuxfromscratch.org and
++linuxfromscratch.com domain names.</para></listitem>
++
++<listitem><para><ulink url="mailto:bkenoah at oswd.org">Frank
++Skettino</ulink> <bkenoah at oswd.org> at <ulink 
++url="http://www.oswd.org">OSWD</ulink> for coming up the initial design 
++of the LFS and BLFS websites.</para></listitem>
++
++<listitem><para><ulink url="mailto:garrett at linux.com">Garrett
++LeSage</ulink> <garrett at linux.com> for creating the LFS 
++banner</para></listitem>
++
++<listitem><para>Countless other people on the various LFS and BLFS 
++mailinglists who are making this book happen by giving their
++suggestions, testing the book and submitting bug reports.</para></listitem>
++
++</itemizedlist>
++
++</sect1>
++
+Index: introduction/welcome/conventions.xml
+===================================================================
+--- introduction/welcome/conventions.xml	(révision 0)
++++ introduction/welcome/conventions.xml	(révision 3)
+@@ -0,0 +1,49 @@
++<sect1 id="intro-welcome-conventions">
++<?dbhtml filename="conventions.html" dir="introduction"?>
++<title>Conventions used in this book</title>
++
++<para>To make things easy to follow, there are a number of conventions used
++throughout the book.  Following are some examples:</para>
++
++<para><userinput>./configure --prefix=/usr</userinput></para>
++
++<blockquote><para>This form of text is designed to be typed exactly 
++as seen unless otherwise noted in the surrounding text.  It is also used 
++in the explanation sections to identify which of the commands is being 
++referred to.</para></blockquote>
++
++<para><filename>install-info: unknown option 
++`--dir-file=/mnt/lfs/usr/info/dir'</filename></para>
++
++<blockquote><para>This form of text (fixed width text) is showing screen 
++output, probably as the result of commands issued and is also used to 
++show filenames such as <filename>/etc/lilo.conf</filename></para></blockquote>
++
++<para><emphasis>Emphasis</emphasis></para>
++
++<blockquote><para>This form of text is used for several purposes in the 
++book but mainly to emphasize important points or to give examples as to 
++what to type.</para></blockquote>
++
++<para><ulink url="http://www.linuxfromscratch.org/">http://www.linuxfromscratch.org/</ulink></para>
++
++<blockquote><para>This form of text is used for hyperlinks, both within the 
++book and to external pages such as HowTo's, download locations,
++websites, etc.</para></blockquote>
++
++<para><screen><userinput>cat > $LFS/etc/group << "EOF"</userinput>
++	root:x:0:
++	bin:x:1:
++	......
++<userinput>EOF</userinput>
++</screen>
++</para>
++
++<blockquote><para>This type of section is used mainly when creating 
++configuration files.  The first command (in bold) tells the system to create 
++the file $LFS/etc/group from whatever is typed on the following lines until 
++the sequence EOF is encountered. Therefore, this whole section is generally 
++typed as seen.</para></blockquote>
++
++</sect1>
++
+Index: introduction/welcome/version.xml
+===================================================================
+--- introduction/welcome/version.xml	(révision 0)
++++ introduction/welcome/version.xml	(révision 3)
+@@ -0,0 +1,48 @@
++<sect1 id="intro-welcome-version" xreflabel="Book Version">
++<?dbhtml filename="version.html" dir="introduction"?>
++<title>Book version</title>
++
++<para>This is BLFS-BOOK version &version; dated &releasedate;. If this 
++version is older than a month a newer version is probably already available 
++for download. Check one of the mirror sites below for updated
++versions.</para>
++
++<para>Below is a list of our current HTTP and FTP mirror sites as
++of October 14th 2001. This list might not be accurate anymore. 
++The latest info can be found on our website at
++<ulink url="http://beyond.linuxfromscratch.org">http://beyond.linuxfromscratch.org</ulink>.</para>
++
++<sect2>
++<title>HTTP Mirrors</title>
++
++<sect3>
++<title>North America</title>
++
++<itemizedlist>
++
++<listitem><para>Fremont, California, USA [100 Mbit] - <ulink
++url="http://beyond.linuxfromscratch.org/blfs/intro.shtml">http://beyond.linuxfromscratch.org/blfs/intro.shtml</ulink></para></listitem>
++
++<listitem><para>Columbus, Ohio, USA [1 Mbit] - <ulink
++url="http://beyond.us.linuxfromscratch.org/blfs/intro.shtml">http://beyond.us.linuxfromscratch.org/blfs/intro.shtml</ulink></para></listitem>
++
++</itemizedlist>
++
++</sect3>
++
++<sect3>
++<title>Europe</title>
++
++<itemizedlist>
++
++<listitem><para>Teeside, United Kingdom [256 Kbit] - <ulink
++url="http://beyond.linuxfromscratch.co.uk/blfs/intro.shtml">http://beyond.linuxfromscratch.co.uk/blfs/intro.shtml</ulink></para></listitem>
++
++</itemizedlist>
++
++</sect3>
++
++</sect2>
++
++</sect1>
++
+Index: introduction/welcome/askhelp.xml
+===================================================================
+--- introduction/welcome/askhelp.xml	(révision 0)
++++ introduction/welcome/askhelp.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="intro-welcome-askhelp">
++<?dbhtml filename="askhelp.html" dir="introduction"?>
++<title>Asking for help and the FAQ</title>
++
++<para>THIS IS A NEW PAGE</para>
++
++</sect1>
++
+Index: introduction/welcome/changelog.xml
+===================================================================
+--- introduction/welcome/changelog.xml	(révision 0)
++++ introduction/welcome/changelog.xml	(révision 3)
+@@ -0,0 +1,423 @@
++<sect1 id="intro-welcome-changelog">
++<?dbhtml filename="changelog.html" dir="introduction"?>
++<title>Changelog</title>
++
++<para>Please note that the changelog only lists which editor was
++responsible for putting the changes into CVS; please read the Credits
++page in Chapter 1 for details on who wrote what.</para>
++
++<para>&version; - &releasedate;</para>
++
++<itemizedlist>
++
++<listitem><para>July 4, 2002 [bdubbs]: Various typo and 
++grammer changes.</para></listitem>
++
++<listitem><para>July 4, 2002 [bdubbs]: KDE section - updated 
++koffice patch instruction and added a backslash to kdelibs
++build commands. Successfully rebuilt kde 3.0.2 with current
++instructions.</para></listitem>
++
++<listitem><para>July 3, 2002 [bdubbs]: KDE section - updated 
++koffice and changed to kde 3.0.2.</para></listitem>
++
++<listitem><para>July 2, 2002 [bdubbs]: KDE section - updated 
++kdeutils, kdeedu, kdeartwork, kdetoys, and kdeaddons.</para></listitem>
++
++<listitem><para>July 2, 2002 [bdubbs]: Updated 
++link location in libungif and added a note to remove a possible
++compilation error.</para></listitem>
++
++<listitem><para>July 1, 2002 [bdubbs]: KDE section - updated 
++kdegraphics, kdeadmin, and kdegames sections.  Updated imlib
++to correct an error in configure with gcc 3.1.  Changed download
++locations to links in libtiff and libungif</para></listitem>
++
++<listitem><para>June 30, 2002 [bdubbs]: KDE section - updated 
++kedmultimedia, kdenetwork and kdepim sections.</para></listitem>
++
++<listitem><para>June 29, 2002 [larry]: Chapter 5 - updated to
++alsa-0.9.0rc2 and moved gnome intro.</para></listitem>
++
++<listitem><para>June 28, 2002 [bdubbs]: QT section -  Added note to allow
++not building examples and tutorials.</para></listitem>
++
++<listitem><para>June 28, 2002 [larry]: Chapter 4 - Added GTK+-1.2.10,
++GLib-1.2.10, gdk-0.11.0, libxml-1.8.17.</para></listitem>
++
++<listitem><para>June 27, 2002 [larry]: Chapter 12 - Started adding
++GNOME-1.4.1.</para></listitem>
++
++<listitem><para>June 26, 2002 [larry]: Chapter 4 - Added
++GTK+-2.0.5, Chapter 9 - Updated to OpenSSH-3.4p1.</para></listitem>
++
++<listitem><para>June 24, 2002 [larry]: Chapter 9 - Updated to
++OpenSSH-3.3p1, with modifications to set up priviledged/unpriviledged
++operations which is now the default. Chapter 4 - Added GLib-2.0.4,
++Pango-1.0.3 and ATK-1.0.2</para></listitem>
++
++<listitem><para>June 22, 2002 [larry]: Chapter 20 - Added kernel
++configuration and additional reading links to
++introduction.</para></listitem>
++
++<listitem><para>June 21, 2002 [larry]: Chapter 04 - Added
++pkgconfig-0.12.0.</para></listitem>
++
++<listitem><para>June 15th, 2002 [larry]: Chapter 08 - Modified config
++sed command for a change in main.cf after version 1.1.9 on
++myhostname.</para></listitem>
++
++<listitem><para>June 14th, 2002 [larry]: Chapter 07 - Update to curl-7.9.8.
++</para></listitem>
++
++<listitem><para>June 7th, 2002 [markh]: Chapter 02 - Update daemontools
++and daemontools-man packages; patch from Sal Gonzalez.</para></listitem>
++
++<listitem><para>June 7th, 2002 [markh]: Chapter 05 - Update db link
++location.</para></listitem>
++
++<listitem><para>June 7th, 2002 [markh]: Chapter 13 - Update objprelink
++download location and slightly modify build command to match new
++file.</para></listitem>
++
++<listitem><para>June 7th, 2002 [markh]: Chapter 07 - Update to
++links-0.97.</para></listitem>
++
++<listitem><para>June 7th, 2002 [markh]: Chapter 05 - Update to
++hdparm-5.2.</para></listitem>
++
++<listitem><para>June 7th, 2002 [markh]: Chapter 04 - Finally applied the
++fix for libmng to make it use lcms properly.</para></listitem>
++
++<listitem><para>May 31st, 2002 [larry]: Update to
++postfix-1.1.11, modified fcron script.</para></listitem>
++
++<listitem><para>May 31st, 2002 [markh]: Chapter 06 - Update to
++wvstreams-3.70 and wvdial-1.53.</para></listitem>
++
++<listitem><para>May 31st, 2002 [bdubbs]: Add comment about 
++<filename>/lib/libmisc.la</filename> to kdebase instructions.</para></listitem>
++
++<listitem><para>May 30th, 2002 [larry]: Update to libxml2-1.4.22 and
++libxslt-1.0.18.</para></listitem>
++
++<listitem><para>May 29th, 2002 [markh]: Chapter 04 - Update openssl
++instructions to install man pages in /usr/share/man.  We get around the
++passwd man page problem by renaming the source file to openssl-passwd.
++Thanks to Jesse for suggesting this.</para></listitem>
++
++<listitem><para>May 28th, 2002 [bdubbs]: Change structure of kde xml
++and begin KDE Intro.</para></listitem>
++
++<listitem><para>May 28th, 2002 [bdubbs]: Remove extra line feed
++in qt configure instructions for man.conf.</para></listitem>
++
++<listitem><para>May 24th, 2002 [bdubbs]: Updated to openssl
++to version 0.9.6d and updated configure instruction.</para></listitem>
++
++<listitem><para>May 23rd, 2002 [larry]: Updated to libpng
++1.2.3 and OpenSSH 3.2.3p1.</para></listitem>
++
++<listitem><para>May20th, 2002 [larry]: Added pccts 133MR33 to chapter
++04 and cdrdao 1.1.5 to chapter 20.</para></listitem>
++
++<listitem><para>May19th, 2002 [larry]: Updated to OpenSSH 
++3.2.2p1.</para></listitem>
++
++<listitem><para>May 19th, 2002 [bdubbs]: Updated cvs version to 
++1.11.2.</para></listitem>
++
++<listitem><para>May 18th, 2002 [larry]: Updated to postfix
++1.1.9.</para></listitem>
++
++<listitem><para>May 17th, 2002 [bdubbs]: Chapter 11 - Inserted 
++text about Window Mangers.  Chapter 13 - Added stubs for KDE.
++Updated links for QT and objprelink.</para></listitem>
++
++<listitem><para>May 17th, 2002 [bdubbs]: Chapter 10 - Updated
++XFree86 sections. Corrected kernel make commands and changed 
++url references to links.</para></listitem>
++
++<listitem><para>May 16th, 2002 [bdubbs]: Chapter 10 - Added
++XFree86. Updated data for objprelink.</para></listitem>
++
++<listitem><para>May 16th, 2002 [larry]: Chapter 05 - Added
++unzip-5.50.</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 02 - Fix up formatting
++in traceroute section.</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 06 and 09.  Update to
++dhcp-3.0pl1.</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 04 - Update to
++libpng-1.2.2 and fix imlib so it works with this libpng
++version.</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 08 - Update to
++postfix-1.1.8.  Chapter 13 - Update to qt-3.0.4.</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 04 - Add libxml2 and
++libxslt (from Larry).</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 17 - SDL (to 1.2.4) and
++XMMS (to 1.2.7) update from Jeroen.</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 13 - Add objprelink and
++update QT instructions to match.</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 06 - Firewalling.
++Changed references to <filename>/etc/init.d</filename> -->
++<filename>/etc/rc.d/init.d</filename>.</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 06 - DHCP.  Fixed
++extraneous line in dhclient.conf creation command.</para></listitem>
++
++<listitem><para>May 15th, 2002 [markh]: Chapter 05 - Alsa.  Fixed typo
++in chmod command.  Added note about manually creating
++<filename>/etc/asound.conf</filename> so that alsactl doesn't baulk on
++first startup.</para></listitem>
++
++<listitem><para>April 29th, 2002 [markh]: Chapter 06 - Add DHCP_STOP
++variable to DHCP scripts.</para></listitem>
++
++<listitem><para>April 28th, 2002 [markh]: Chapter 04 - Add
++imlib.</para></listitem>
++
++<listitem><para>April 28th, 2002 [markh]: Chapter 02, 04, 08 - Minor fixes
++to daemontools, libpng, libmng and postfix instructions.</para></listitem>
++
++<listitem><para>April 28th, 2002 [markh]: Chapter 05 - Fix to alsa
++install instructions (added a missing 's' and \).</para></listitem>
++
++<listitem><para>April 20th, 2002 [markh]: Chapter 20 - Add
++cdrtools-1.10.</para></listitem>
++
++<listitem><para>April 20th, 2002 [markh]: Chapter 09 - Add DHCP server
++instructions.</para></listitem>
++
++<listitem><para>April 20th, 2002 [markh]: Chapter 06 - We now have DHCP
++client configuration instructions.</para></listitem>
++
++<listitem><para>April 20th, 2002 [markh]: Chapter 08 and Appendix A -
++Update to postfix-1.1.7 and keep runlevels list in sync with LFS-1.9
++(from Larry).</para></listitem>
++
++<listitem><para>April 7th, 2002 [markh]: Chapter 07 - Added curl.
++Chapter 18 - Added vorbistools.</para></listitem>
++
++<listitem><para>April 7th, 2002 [markh]: Chapter 17 - Added libao,
++libogg, libvorbis.</para></listitem>
++
++<listitem><para>April 7th, 2002 [markh]: Chapter 08 - Postfix update
++from Larry and fix script to use spaces instead of
++tabs.</para></listitem>
++
++<listitem><para>April 7th, 2002 [markh]: Chapter 05 - Applied fcron
++updates (two of them) from Larry.  Moves to fcron-2.9.0 with a few
++fixes.</para></listitem>
++
++<listitem><para>April 7th, 2002 [markh]: Daemontools - moved to using
++<userinput>telinit -Q</userinput> instead of <userinput>kill -HUP
++1</userinput> following user comments on blfs-dev.</para></listitem>
++
++<listitem><para>April 7th, 2002 [markh]: Chapter 17 - Add
++audiofile-0.2.3.</para></listitem>
++
++<listitem><para>March 28th, 2002 [markh]: Chapter 08 - Add postfix-1.1.5
++instructions.</para></listitem>
++
++<listitem><para>March 28th, 2002 [markh]: Chapter 13 - Update to
++QT-3.0.3.</para></listitem>
++
++<listitem><para>March 27th, 2002 [markh]: Chapter 07 and 09 - Added
++dhcp package instructions.</para></listitem>
++
++<listitem><para>March 26th, 2002 [markh]: Chapter 04 - Add pcre-3.9
++instructions.</para></listitem>
++
++<listitem><para>March 26th, 2002 [markh]: Chapter 13 - Added initial set
++of qt instructions.</para></listitem>
++
++<listitem><para>March 26th, 2002 [markh]: Chapter 05 - Fcron update to
++2.1.0 and a few miscellaneous fixes from Larry.</para></listitem>
++
++<listitem><para>March 25th, 2002 [markh]: Chapter 05 - Fix the mistake
++whereby we tried to add lines to <filename
++class="directory">/etc/sysconfig</filename> instead of
++<filename>/etc/syslog.conf</filename>.</para></listitem>
++
++<listitem><para>March 25th, 2002 [markh]: Appendix A and other sections
++- Add the initial tables of rc?.d symlinks.  At the same time, make sure
++scripts are set to 755 (to be executable) and sort out the numbering of
++the scripts (some were still using three digits from the old-style
++links).</para></listitem>
++
++<listitem><para>March 25th, 2002 [markh]: Chapter 05 - Added the
++"which" page.</para></listitem>
++
++<listitem><para>March 20th, 2002 [markh]: Moved all homeless packages to
++a new temporary place in Chapter 02 until homes are found for them.
++This leaves appendix A empty for the symlink list.</para></listitem>
++
++<listitem><para>March 20th, 2002 [markh]: Chapter 03 - Added random
++script instructions.</para></listitem>
++
++<listitem><para>March 15th, 2002 [markh]: Chapter 05 - Small update to
++fcron instructions.  Chapter 09 - Small update to OpenSSH
++instructions.</para></listitem>
++
++<listitem><para>March 11th, 2002 [markh]: Chapter 09 - Add OpenSSH-3.1p1
++install instructions.  Chapter 07 - Add reference about installing
++OpenSSH client.</para></listitem>
++
++<listitem><para>March 11th, 2002 [markh]: Chapter 05 - Update fcron
++instructions (syslog related changes).</para></listitem>
++
++<listitem><para>March 11th, 2002 [markh]: Chapter 02 - Add comment about
++using bootscripts with LFS-3.2 and later.  Chapter 05 - Change gpm and
++alsa scripts to work with LFS-3.2 and later.</para></listitem>
++
++<listitem><para>March 11th, 2002 [markh]: Chapter 04 - Update to
++zlib-1.1.4.</para></listitem>
++
++<listitem><para>March 2nd, 2002 [markh]: Chapter 1 - Credits - Modify
++credits list so that each author is only listed once with a complete
++list of what they did (it makes the list smaller).</para></listitem>
++
++<listitem><para>March 2nd, 2002 [markh]: Chapter 5 - Add fcron-2.0.0
++instructions from Larry Lawrence.</para></listitem>
++
++<listitem><para>February 24th, 2002 [markh]: Chapter 5 - Update to
++gpm-1.20.0.</para></listitem>
++
++<listitem><para>February 21st, 2002 [markh]: Argh.. I've been writing
++the wrong date all day!  Changed all Feb 20th entries to Feb
++21st and corrected the book's date.</para></listitem>
++
++<listitem><para>February 21st, 2002 [markh]: Chapter 7 - Update to
++ncftp-3.1.2.</para></listitem>
++
++<listitem><para>February 21st, 2002 [markh]: Chapter 5 - Update to
++db-4.0.14.</para></listitem>
++
++<listitem><para>February 21st, 2002 [markh]: Chapter 4 - Update to
++lcms-1.08, libpng-1.2.1 and libtiff-3.5.7.</para></listitem>
++
++<listitem><para>February 21st, 2002 [markh]: Add chapters 18-20 as
++placeholders for multimedia section and move SDL into ch1 and
++cdparanoia, mpg123 and XMMS into ch18.</para></listitem>
++
++<listitem><para>February 21st, 2002 [markh]: Chapter 5 - Move cvs and db 
++to here from appendix a.</para></listitem>
++
++<listitem><para>February 19th, 2002 [markh]: Chapter 6 - Update to
++hdparm-4.6 and move it here from appendix a.</para></listitem>
++
++<listitem><para>February 19th, 2002 [markh]: Chapter 6 - Update to 
++wvdial-1.50 and add wvstreams-3.64 which is required by the new
++version of wvdial.</para></listitem>
++
++<listitem><para>February 19th, 2002 [markh]: Chapter 6 - Add 
++ppp.</para></listitem>
++
++<listitem><para>February 19th, 2002 [markh]: Chapter 6 - Move wvdial to
++here from appendix A.</para></listitem>
++
++<listitem><para>February 15th, 2002 [markh]: Chapter 6 - DHCP - Added
++initial DHCP section.</para></listitem>
++
++<listitem><para>February 14th, 2002 [markh]: Chapter 6 - Firewalling
++update from Henning.</para></listitem>
++
++<listitem><para>January 3rd, 2002 [markh]: Changed alsa instructions to
++include --with-kernel= for robustness.</para></listitem>
++
++<listitem><para>January 1st, 2002 [markh]: Started large rearrangement
++of book.  Many modifications made.  Fixed up quite a few things.  Happy New 
++Year to you all!</para></listitem>
++
++<listitem><para>December 31st, 2001 [markh]: Gpm - Fixed symlink
++creation so it actually works.</para></listitem>
++
++<listitem><para>December 22nd, 2001 [markh]: Zlib - Added instructions
++to copy manual page as it isn't installed by default.</para></listitem>
++
++<listitem><para>December 20th, 2001 [markh]: Chapter 3 - Added the vimrc
++page.</para></listitem>
++
++<listitem><para>December 20th, 2001 [markh]: Appendix A - Added alsa
++instructions by Alex Kloss.</para></listitem>
++
++<listitem><para>December 20th, 2001 [markh]: Chapter 2 - More text
++added.</para></listitem>
++
++<listitem><para>December 1st, 2001 [markh]: Chapter 3 - Added some
++corrections to the inputrc page regarding the role of /etc/inputrc and
++~/.inputrc.</para></listitem>
++
++<listitem><para>November 30th, 2001 [markh]: Appendix A - Added
++fetchmail instructions by Paul Campbell.</para></listitem>
++
++<listitem><para>November 26th, 2001 [markh]: General - Added
++<&dbhtml> tags all over the place to divide generated HTML
++into directories.</para></listitem>
++
++<listitem><para>November 26th, 2001 [markh]: Chapter 3 - Added
++/etc/inputrc details by Chris Lynn and /etc/issue details by
++me.</para></listitem>
++
++<listitem><para>November 5th, 2001 [markh]: Appendix A - Added gpm
++recommendation to links instructions.</para></listitem>
++
++<listitem><para>October 25th, 2001 [markh]: Chapter 6 - Firewalling
++section added to book.</para></listitem>
++
++<listitem><para>October 25th, 2001 [markh]: Appendix A - wvdial-1.41
++added.</para></listitem>
++
++<listitem><para>October 20th, 2001 [markh]: Appendix A - hdparm-4.2
++added.</para></listitem>
++
++<listitem><para>October 20th, 2001 [markh]: Appendix B removed.  Credits
++moved to a page in Chapter 1.</para></listitem>
++
++<listitem><para>October 20th, 2001 [markh]: Appendix A - All current
++sets of installation instructions changed to install items in /usr
++instead of /usr/local.</para></listitem>
++
++<listitem><para>October 20th, 2001 [markh]: Chapter 2 - Added the /usr
++versus /usr/local debate section.</para></listitem>
++
++<listitem><para>October 14th, 2001 [markh]: Chapter 1 - Added lots of
++text.</para></listitem>
++
++<listitem><para>September 20th, 2001 [markh]: Appendix A - Small
++formatting fix to db instructions so they copy and paste
++properly.</para></listitem>
++
++<listitem><para>September 20th, 2001 [markh]: Appendix A - Updated to
++libmng-1.0.3 and libpng-1.2.0.</para></listitem>
++
++<listitem><para>September 20th, 2001 [markh]: Appendix A - Fixed lcms
++instructions so that they actually work...</para></listitem>
++
++<listitem><para>September 14th, 2001 [markh]: Appendix A - Links
++installation instructions added.</para></listitem>
++
++<listitem><para>September 14th, 2001 [markh]: Appendix A - Lynx
++installation instructions added.</para></listitem>
++
++<listitem><para>September 14th, 2001 [markh]: Appendix A - Finished off
++openssl instructions.</para></listitem>
++
++<listitem><para>September 6th, 2001 [markh]: Appendix A - Added
++daemontools</para></listitem>
++
++<listitem><para>September 4th, 2001 [markh]: General - lots and lots of
++things - setting up xml structure, adding instructions etc.</para></listitem>
++
++</itemizedlist>
++
++</sect1>
++
+Index: introduction/welcome/contact.xml
+===================================================================
+--- introduction/welcome/contact.xml	(révision 0)
++++ introduction/welcome/contact.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect1 id="intro-welcome-contactinfo">
++<?dbhtml filename="contactinfo.html" dir="introduction"?>
++<title>Contact information</title>
++
++<para>Please direct your emails to one of the BLFS mailing lists. See
++<xref linkend="intro-welcome-maillists"/> for more information on the
++available mailing lists.</para>
++
++<para>The current BLFS maintainer is &maintainer-fullname;.  If you need
++to reach &maintainer-firstname;, send an email to
++<ulink url="mailto:&maintainer-address">&maintainer-address;</ulink>.</para>
++
++</sect1>
++
+Index: introduction/welcome/welcome.xml
+===================================================================
+--- introduction/welcome/welcome.xml	(révision 0)
++++ introduction/welcome/welcome.xml	(révision 3)
+@@ -0,0 +1,23 @@
++<chapter id="intro-welcome" xreflabel="Welcome to BLFS">
++<?dbhtml filename="welcome.html" dir="introduction"?>
++<title>Welcome to BLFS</title>
++<para>The Beyond LinuxFromScratch book is designed to carry on from
++where the LFS book leaves off.  Unlike the LFS book, it isn't designed
++to be followed straight through.  Reading the <xref
++linkend="intro-welcome-whichsections"/> part of this chapter should
++help guide you through the book.</para>
++
++<para>Please read most of this part of the book carefully as it explains
++quite a few of the conventions we use throughout the book.</para>
++
++&intro-welcome-conventions;
++&intro-welcome-version;
++&intro-welcome-acks;
++&intro-welcome-credits;
++&intro-welcome-changelog;
++&intro-welcome-whichsect;
++&intro-welcome-mailinglists;
++&intro-welcome-newsserver;
++&intro-welcome-contact;
++&intro-welcome-askhelp;
++</chapter>
+Index: introduction/welcome/credits.xml
+===================================================================
+--- introduction/welcome/credits.xml	(révision 0)
++++ introduction/welcome/credits.xml	(révision 3)
+@@ -0,0 +1,136 @@
++<sect1 id="intro-welcome-credits">
++<?dbhtml filename="credits.html" dir="introduction"?>
++<title>Credits</title>
++
++<para>Many people have contributed both directly and indirectly to BLFS.
++This page lists all of those we can think of.  We may well have
++missed people out and if you feel this is the case, drop us line.  Many
++thanks to all of the LFS community for their assistance with this
++project.  If you are in the list and wish to have your email address
++included, again please drop us a line to &maintainer-address; and we'll
++be happy to add it.  We don't include email addresses by default so if
++you want it included, please state so when you contact us.</para>
++
++<sect2>
++<title>Editors</title>
++<itemizedlist>
++
++<listitem><para><emphasis>Editor:</emphasis> Mark
++Hymers <ulink
++url="mailto:&maintainer-address;"><&maintainer-address;></ulink></para></listitem>
++
++<listitem><para><emphasis>Co-Editors:</emphasis> Bruce 
++Dubbs and Larry Lawrence</para></listitem>
++
++</itemizedlist>
++</sect2>
++
++<sect2>
++<title>Text Authors</title>
++<itemizedlist>
++
++<listitem><para>Chapter 01.  Based on the LFS introductory text by
++<emphasis>Gerard Beekmans</emphasis>, modified by <emphasis>Mark
++Hymers</emphasis> for BLFS.</para></listitem>
++
++<listitem><para>Chapter 02: The /usr versus /usr/local
++debate: <emphasis>Andrew McMurry</emphasis>.</para></listitem>
++
++<listitem><para>Chapter 03: /etc/inputrc: <emphasis>Chris
++Lynn</emphasis>.</para></listitem>
++
++<listitem><para>Chapter 03: Customising your logon & vimrc: <emphasis>Mark
++Hymers</emphasis>.</para></listitem>
++
++<listitem><para>Chapter 03: Random number script <emphasis>Larry
++Lawrence</emphasis>.</para></listitem>
++
++<listitem><para>Chapter 05: Which <emphasis>Mark Hymers</emphasis> with
++many thanks to <emphasis>Seth Klein</emphasis> and <emphasis>Jesse 
++Tie-Ten-Quee</emphasis>.</para></listitem>
++
++<listitem><para>Chapter 06: <!--<xref
++linkend="ch06-firewall"/>-->Firewalling: <emphasis>Henning
++Rohde with thanks to Jeff Bauman</emphasis>.</para></listitem>
++
++<listitem><para>Chapter 10: XFree86 <emphasis>Bruce Dubbs</emphasis>.</para></listitem>
++
++<listitem><para>Chapter 11: Intro to Window Managers 
++<emphasis>Bruce Dubbs</emphasis>.</para></listitem>
++
++<listitem><para>Chapter 12: GNOME: <emphasis>James Iwanek</emphasis></para></listitem>
++
++<listitem><para>Chapter 13: QT: <emphasis>Larry Lawrence</emphasis>
++objprelink and KDE: <emphasis>Bruce Dubbs</emphasis>.</para>
++</listitem>
++
++</itemizedlist>
++</sect2>
++
++<sect2>
++<title>Installation Instruction Authors</title>
++<itemizedlist>
++
++<listitem><para>Alsa: <emphasis>Alex Kloss</emphasis></para></listitem>
++
++<listitem><para>ATK, audiofile, cdrdao, cdrtools, curl, dhcp, fcron, imlib,
++GLib2, GTK+2, libao, libogg, libvorbis, libxml2, libxslt, OpenSSH, Pango, pccts, pcre, pkgconfig, postfix, QT, unzip and vorbis-tools: <emphasis>Larry Lawrence</emphasis></para></listitem>
++
++<listitem><para>CDParanoia, mpg123, SDL and XMMS: <emphasis>Jeroen
++Coumans</emphasis></para></listitem>
++
++<listitem><para>cvs, gpm, hdparm, libjpeg, mng, png, tiff and ungif,
++links, lynx, openssl, which and zlib: <emphasis>Mark 
++Hymers</emphasis></para></listitem>
++
++<listitem><para>daemontools, traceroute and ucspi-tcp: <emphasis>Jeff
++Bauman</emphasis></para></listitem>
++
++<listitem><para>db and lcms: <emphasis>Jeremy Jones and Mark
++Hymers</emphasis></para></listitem>
++
++<listitem><para>fetchmail and wvdial: <emphasis>Paul
++Campbell</emphasis></para></listitem>
++
++<listitem><para>gdk, GLib, GTK+ and libxml: <emphasis>James
++Iwanek</emphasis></para></listitem>
++
++<listitem><para><!--<xref linkend="iptables"/>-->iptables: <emphasis>Henning
++Rohde</emphasis></para></listitem>
++
++</itemizedlist>
++</sect2>
++
++<sect2>
++<title>General Acknowledgments</title>
++
++<itemizedlist>
++
++<listitem><para><emphasis>Gerard Beekmans</emphasis> for generally
++putting up with us and for running the whole LFS project.</para></listitem>
++
++<listitem><para><emphasis>Bruce Dubbs</emphasis> for writing the kde.txt
++hint from which we gathered much useful information.</para></listitem>
++
++<listitem><para><emphasis>Lee Harris</emphasis> for writing the gpm.txt
++hint on which our gpm instructions are based</para></listitem>
++
++<listitem><para><emphasis>Marc Heerdink</emphasis> for writing the
++gpm2.txt hint on which our gpm instruction are based.</para></listitem>
++
++<listitem><para><emphasis>Jeremy Jones</emphasis> (otherwise known as
++<emphasis>mca</emphasis>) for hacking Makefiles and general
++assistance.</para></listitem>
++
++<listitem><para><emphasis>J_Man</emphasis> for submitting a
++gpm-1.19.3.diff file on which our gpm instructions are
++based.</para></listitem>
++
++<listitem><para><emphasis>Scot Mc Pherson</emphasis> for writing the gnome-1.4.txt
++hint on which chapter 12 is closely based</para></listitem>
++
++</itemizedlist>
++</sect2>
++
++</sect1>
++
+Index: introduction/welcome/maillists.xml
+===================================================================
+--- introduction/welcome/maillists.xml	(révision 0)
++++ introduction/welcome/maillists.xml	(révision 3)
+@@ -0,0 +1,266 @@
++<sect1 id="intro-welcome-maillists" xreflabel="Mailing lists and archives">
++<?dbhtml filename="maillists.html" dir="introduction"?>
++<title>Mailing lists and archives</title>
++
++<para>The linuxfromscratch.org server is hosting the following publicly 
++accessible mailing lists:</para>
++
++<itemizedlist>
++
++<listitem><para>blfs-dev</para></listitem>
++
++<listitem><para>blfs-book</para></listitem>
++
++<listitem><para>blfs-support</para></listitem>
++
++<listitem><para>lfs-support</para></listitem>
++
++<listitem><para>lfs-dev</para></listitem>
++
++<listitem><para>lfs-announce</para></listitem>
++
++<listitem><para>lfs-security</para></listitem>
++
++<listitem><para>lfs-book</para></listitem>
++
++<listitem><para>alfs-discuss</para></listitem>
++
++</itemizedlist>
++
++<sect2>
++<title>blfs-book</title>
++
++<para>The blfs-book list is used by the BLFS-BOOK editors
++to co-ordinate blfs-book's maintenance, like XML issues and the like.
++Actual discussion on what should be added and removed should take place
++on blfs-dev.</para>
++
++</sect2>
++
++<sect2>
++<title>blfs-dev</title>
++
++<para>The blfs-dev mailing list discusses matters related to the
++BLFS-BOOK (Beyond LFS).  If problems with the book come up, a bug
++or two need to be
++reported, or suggestions to improve the book (such as suggestions as to
++installation instructions to add) are to be made, this mailing list
++is the right one.</para>
++
++<para>Requests for help with programs beyond the base LFS setup (not
++just those in BLFS) should go to blfs-support.</para>
++
++</sect2>
++
++<sect2>
++<title>blfs-support</title>
++
++<para>The blfs-support list deals with support requests for any software
++not installed in the LFS book.  The list is not just for help with
++software explicitly mentioned in the BLFS book, any software beyond that
++installed as part of the base LFS system can be discussed here.</para>
++
++</sect2>
++
++<sect2>
++<title>lfs-support</title>
++
++<para>The lfs-support mailing list provides support to users building an
++LFS system as far as the end of the main book.  Requests for help with
++installing software beyond the base system should go to the blfs-support
++list.</para>
++
++</sect2>
++
++<sect2>
++<title>lfs-dev</title>
++
++<para>The lfs-dev mailing list discusses matters strictly related to the
++LFS-BOOK. If problems with the book come up, a bug or two need to be
++reported, or suggestions to improve the book should be made,
++this mailing list is the right one.</para>
++
++<para>Requests for help should go to lfs-support or blfs-support.</para>
++
++</sect2>
++
++<sect2>
++<title>lfs-announce</title>
++
++<para>The lfs-announce list is a moderated list. It can be subscribed
++to, but
++you can't post any messages to this list. This list is used to announce
++new stable releases. The lfs-dev list will carry information about
++development releases as well. If a user is already on the lfs-dev
++list, there's little use subscribing to
++this list as well because everything that is posted to the lfs-announce
++list will be posted to the lfs-dev list as well.</para>
++
++</sect2>
++
++<sect2>
++<title>lfs-security</title>
++
++<para>The lfs-security mailing list discusses security-related matters.
++Security concerns or security problems with a package used by LFS,
++should be addressed on this list.</para>
++
++</sect2>
++
++<sect2>
++<title>lfs-book</title>
++
++<para>The lfs-book list is used by the LFS-BOOK editors to co-ordinate
++lfs-book's maintenance, like XML issues and the like. Actual discussion
++on what should be added and removed take place on lfs-dev.</para>
++
++</sect2>
++
++<sect2>
++<title>alfs-discuss</title>
++
++<para>The alfs-discuss list discusses the development of ALFS, which
++stands for
++Automated Linux From Scratch. The goal of this project is to develop an
++installation tool that can install an LFS system automatically.
++It's main goal is to speed up compilation by taking away the need to
++manually enter the commands to configure, compile, and install
++packages.</para>
++
++</sect2>
++
++<sect2>
++<title>Mail archives</title>
++
++<para>All these lists are archived and can be viewed online at
++<ulink url="http://archive.linuxfromscratch.org/mail-archives"/> or downloaded
++from <ulink url="&ftp-root;/mail-archives"/>.</para>
++
++</sect2>
++
++<sect2>
++<title>How to subscribe?</title>
++
++<para>Any of the above-mentioned mailinglists can be subscribed to by
++sending an email to <ulink 
++url="mailto:listar at linuxfromscratch.org">listar at linuxfromscratch.org</ulink>
++and writing <emphasis>subscribe listname</emphasis> as the subject
++header of the message.</para>
++
++<para>Multiple lists at the same time can be subscribed to by using
++one email. This is done by leaving the subject blank and putting all the
++commands in the body of the email. The email will look like:</para>
++
++<blockquote><literallayout>To: listar at linuxfromscratch.org
++Subject:
++
++subscribe lfs-dev
++subscribe blfs-support
++subscribe alfs-discuss</literallayout></blockquote>
++
++<para>After the email is sent, the Listar program will reply with an
++email requesting a confirmation of the subscription request. After
++this confirmation email is sent back, Listar will send an
++email again with the message that the user has been subscribed to the
++list(s) along with an introduction message for that particular
++list.</para>
++
++</sect2>
++
++<sect2>
++<title>How to unsubscribe?</title>
++
++<para>To unsubscribe from a list, send an email 
++to <ulink url="mailto:listar at linuxfromscratch.org"/> and 
++write <emphasis>unsubscribe listname</emphasis> as the subject header of 
++the message.</para>
++
++<para>Multiple lists can be unsubscribed at the same time
++using one email. This is done by leaving the subject header blank and
++putting all the commands in the body of the email. The email will look
++like: </para>
++
++<blockquote><literallayout>To: listar at linuxfromscratch.org
++Subject:
++
++unsubscribe lfs-dev
++unsubscribe blfs-support
++unsubscribe alfs-discuss</literallayout></blockquote>
++
++<para>After the email is sent, the Listar program will reply with an
++email requesting a confirmation of the unsubscription
++request. After this confirmation email is sent back, Listar will
++send an email again with the message that the user has been unsubscribed
++from the list(s).</para>
++
++</sect2>
++
++<sect2>
++<title>Other list modes</title>
++
++<para>The modes that can be set by a user require sending an email to
++<ulink
++url="mailto:listar at linuxfromscratch.org">listar at linuxfromscratch.org</ulink>.
++The modes themselves are set by writing
++the appropriate commands in the subject header of the message.</para>
++
++<para>As the name implies, the <emphasis>Set command</emphasis> tells
++what
++to write to set a mode. The <emphasis>Unset command</emphasis> tells
++what to write to unset a mode.</para>
++
++<para>The listname in the example subject headers should be replaced
++with the
++listname to which
++the mode is going to be applied to. If more than one mode is to be set
++(to
++the same list or multiple lists) with one email, this can be done by
++leaving the subject header blank and writing all the commands in the
++body of
++the message instead.</para>
++
++</sect2>
++
++<sect2>
++<title>Digests</title>
++
++<literallayout>
++Set command: <emphasis>set listname digest</emphasis>
++Unset command: <emphasis>unset listname digest</emphasis>
++</literallayout>
++
++<para>All lists have the digest mode available which can be set after a
++user
++has subscribed to a list. Being in digest mode will
++cause you to stop receiving individual messages as they are posted to
++the list and instead receive one email a day containing all
++the messages posted to the list during that day.</para>
++
++<para>There is a second digest mode called digest2. When a user is set
++to this
++mode he will receive the daily digests but will also continue to
++receive the individual messages to the lists as they are posted. To
++set this mode, substitute <emphasis>digest</emphasis> for
++<emphasis>digest2</emphasis> in the command.</para>
++
++</sect2>
++
++<sect2>
++<title>Vacation</title>
++
++<literallayout>
++Set command: <emphasis>set listname vacation</emphasis>
++Unset command: <emphasis>unset listname vacation</emphasis>
++</literallayout>
++
++<para>If a user is going to be away for a while or wishes to stop
++receiving
++messages from the lists but doesn't want to unsubscribe, he can change
++to vacation mode. This has the same effect as unsubscribing,
++but without having to go through the unsubscribe process and
++then later through the subscribe process again.</para>
++
++</sect2>
++
++</sect1>
++
+Index: introduction/welcome/which.xml
+===================================================================
+--- introduction/welcome/which.xml	(révision 0)
++++ introduction/welcome/which.xml	(révision 3)
+@@ -0,0 +1,50 @@
++<sect1 id="intro-welcome-whichsections" xreflabel="Which sections of the book?">
++<?dbhtml filename="which.html" dir="introduction"?>
++<title>Which sections of the book do I want?</title>
++
++<para>Unlike the LinuxFromScratch book, BLFS isn't designed to be
++followed in a linear manner.  This is because LFS provides instructions
++on how to create a base system which is capable of turning into anything 
++from a web server to a multimedia desktop system.  BLFS is where we try
++to guide you through going from the base system to your intended
++destination and so choice is very much involved.</para>
++
++<para>MUCH OF THIS PAGE HAS TO BE RE-WRITTEN TO FIT THE NEW LAYOUT.  THE
++OLD TEXT IS STILL IN THE XML SOURCE AND THE NEW TEXT CAN BE BASED ON
++IT.</para>
++
++<!-- THIS NEEDS REWRITING TO FIT THE NEW LAYOUT
++<para>Everyone who reads the book will want to read certain sections.
++<xref linkend="part1"/> which you are reading now contains generic
++information.  Especially take note of the information 
++in <xref linkend="chapter02"/> as this chapter contains comments about 
++how to unpack software and various other aspects which apply 
++throughout the book.</para>
++
++<para>Most people will want to at least browse through <xref
++linkend="part2"/> as this contains information on general post-LFS
++configuration issues and information on various libraries which are
++needed by many packages.  Note that you don't have to install all of
++these libraries to start with, each BLFS install procedure tells you
++which packages it depends upon so you can choose the program you want
++to install and see what it needs.</para>
++
++<para>Likewise, most people will probably want to look at <xref
++linkend="chapter06"/> to deal with connecting to the Internet or your local
++LAN.  The basic LFS book deals with setting up a static-ip based
++ethernet connection, all other configurations such as DHCP and dial-up
++internet connections are dealt with in this part of BLFS.</para>
++
++<para>Once you have dealt with these basics, you may wish to configure
++network services such as mail.  All of this is dealt with in the
++remainder of <xref linkend="part3"/>.  Those wanting to build servers
++should find enough information to give them a good starting point here.</para>
++
++<para>Those creating desktop systems will want to look at the next three
++parts of the book: <xref linkend="part4"/>, <xref linkend="part5"/> and
++<xref linkend="part6"/>.</para>-->
++
++<para>We hope you enjoy using BLFS and find it useful.</para>
++
++</sect1>
++
+Index: introduction/welcome/newsserver.xml
+===================================================================
+--- introduction/welcome/newsserver.xml	(révision 0)
++++ introduction/welcome/newsserver.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect1 id="intro-welcome-newsserver">
++<?dbhtml filename="newsserver.html" dir="introduction"?>
++<title>News server</title>
++
++<para>All the mailing lists hosted at linuxfromscratch.org are also 
++accessible via the NNTP server. All messages posted to a mailing list 
++will be copied to it's correspondent newsgroup, and vice versa.</para>
++
++<para>The news server can be reached at <ulink
++url="news:news.linuxfromscratch.org"/>.</para>
++
++</sect1>
++
+Index: basicnet/basicnet.xml
+===================================================================
+--- basicnet/basicnet.xml	(révision 0)
++++ basicnet/basicnet.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<part id="basicnet" xreflabel="Basic Networking">
++<?dbhtml filename="basicnet.html" dir="basicnet"?>
++<title>Basic Networking</title>
++
++&basicnet-netlibs;
++&basicnet-textweb;
++&basicnet-netprogs;
++&basicnet-netutils;
++&basicnet-mailnews;
++&basicnet-djb;
++
++</part>
+Index: basicnet/netutils/netutils.xml
+===================================================================
+--- basicnet/netutils/netutils.xml	(révision 0)
++++ basicnet/netutils/netutils.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<chapter id="basicnet-netutils">
++<?dbhtml filename="netutils.html" dir="basicnet"?>
++<title>Basic Networking Utilities</title>
++
++&traceroute;
++&nmap;
++&whois;
++
++</chapter>
+Index: basicnet/netutils/whois.xml
+===================================================================
+--- basicnet/netutils/whois.xml	(révision 0)
++++ basicnet/netutils/whois.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="whois" xreflabel="whois">
++<?dbhtml filename="whois.html" dir="basicnet"?>
++<title>whois</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: basicnet/netutils/whois/whois.ent
+===================================================================
+--- basicnet/netutils/whois/whois.ent	(révision 0)
++++ basicnet/netutils/whois/whois.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY whois SYSTEM "../whois.xml">
+Index: basicnet/netutils/nmap.xml
+===================================================================
+--- basicnet/netutils/nmap.xml	(révision 0)
++++ basicnet/netutils/nmap.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="nmap" xreflabel="nmap">
++<?dbhtml filename="nmap.html" dir="basicnet"?>
++<title>nmap</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: basicnet/netutils/nmap/nmap.ent
+===================================================================
+--- basicnet/netutils/nmap/nmap.ent	(révision 0)
++++ basicnet/netutils/nmap/nmap.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY nmap SYSTEM "../nmap.xml">
+Index: basicnet/netutils/traceroute.xml
+===================================================================
+--- basicnet/netutils/traceroute.xml	(révision 0)
++++ basicnet/netutils/traceroute.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="traceroute" xreflabel="traceroute">
++<?dbhtml filename="traceroute.html" dir="basicnet"?>
++<title>traceroute-&traceroute-version;</title>
++
++&traceroute-intro;
++&traceroute-inst;
++&traceroute-exp;
++&traceroute-desc;
++
++</sect1>
++
+Index: basicnet/netutils/traceroute/traceroute.ent
+===================================================================
+--- basicnet/netutils/traceroute/traceroute.ent	(révision 0)
++++ basicnet/netutils/traceroute/traceroute.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY traceroute SYSTEM "../traceroute.xml">
++<!ENTITY traceroute-intro SYSTEM "traceroute-intro.xml">
++<!ENTITY traceroute-inst SYSTEM "traceroute-inst.xml">
++<!ENTITY traceroute-exp SYSTEM "traceroute-exp.xml">
++<!ENTITY traceroute-desc SYSTEM "traceroute-desc.xml">
++<!ENTITY traceroute-buildsize "75 KB">
++<!ENTITY traceroute-version "1.4a12">
++<!ENTITY traceroute-download "ftp://ftp.ee.lbl.gov/traceroute.tar.gz">
++<!ENTITY traceroute-size "35 KB">
+Index: basicnet/netutils/traceroute/traceroute-intro.xml
+===================================================================
+--- basicnet/netutils/traceroute/traceroute-intro.xml	(révision 0)
++++ basicnet/netutils/traceroute/traceroute-intro.xml	(révision 3)
+@@ -0,0 +1,17 @@
++<sect2>
++<title>Introduction to traceroute</title>
++
++<screen>Download location:              &traceroute-download; 
++Version used:                   &traceroute-version;
++Package size:                   &traceroute-size;
++Estimated Disk space required:  &traceroute-buildsize;</screen>
++
++<para>The traceroute package contains the traceroute program, which is used 
++to display the network route that packets take to reach a specified host. This 
++is a standard network troubleshooting tool. If you find yourself unable to 
++connect to another system, traceroute can help pinpoint the problem.</para>
++
++<screen>Traceroute does not depend on any packages that are not a part of 
++the base LFS system.</screen>
++
++</sect2>
+Index: basicnet/netutils/traceroute/traceroute-exp.xml
+===================================================================
+--- basicnet/netutils/traceroute/traceroute-exp.xml	(révision 0)
++++ basicnet/netutils/traceroute/traceroute-exp.xml	(révision 3)
+@@ -0,0 +1,29 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><screen><userinput>sed 's|@prefix@|/usr|' Makefile.in > Makefile.in~ mv Makefile.in~ Makefile.in :</userinput></screen>
++Adjusts the Makefile so that traceroute will be installed in /usr/sbin 
++instead of /usr/local/sbin, which is where the default 
++installation puts it.</para>
++
++<para><userinput>make install: </userinput> Installs traceroute setuid root 
++in the /usr/sbin directory. This makes it possible for all users to execute 
++traceroute. For absolute security, turn off the setuid bit in traceroute's 
++file permissions with the command 
++<screen><userinput>chmod 0755 /usr/sbin/traceroute</userinput></screen></para>
++
++<para>The risk is that if a security problem such as a buffer overflow were 
++ever found in the traceroute code, a regular user on your system could gain 
++root access if the program is setuid root. Removing the setuid permission 
++of course also makes it impossible for users other than root to utilize 
++traceroute, so decide what's right for your individual situation.</para>
++
++<para>Now, to be completely FHS compliant, as is our aim, if you do leave the 
++traceroute binary setuid root, then you should move traceroute to /usr/bin 
++with the following command: 
++<screen><userinput>mv /usr/sbin/traceroute /usr/bin</userinput></screen></para>
++
++<para>This ensures that the binary is in the path for non-root users.</para>
++
++</sect2>
++
+Index: basicnet/netutils/traceroute/traceroute-inst.xml
+===================================================================
+--- basicnet/netutils/traceroute/traceroute-inst.xml	(révision 0)
++++ basicnet/netutils/traceroute/traceroute-inst.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Installation of traceroute</title>
++
++<para>Install traceroute by running the following commands:</para>
++
++<para><screen><userinput>sed 's|@prefix@|/usr|' Makefile.in > Makefile.in~</userinput>
++<userinput>mv Makefile.in~ Makefile.in</userinput>
++<userinput>./configure</userinput>
++<userinput>make</userinput>
++<userinput>make install</userinput>
++<userinput>make install-man</userinput></screen></para>
++
++</sect2>
++
+Index: basicnet/netutils/traceroute/traceroute-desc.xml
+===================================================================
+--- basicnet/netutils/traceroute/traceroute-desc.xml	(révision 0)
++++ basicnet/netutils/traceroute/traceroute-desc.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Contents</title>
++
++<para>The traceroute package contains <userinput>traceroute</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>traceroute</title>
++<para>Traceroute does basically what it says: it traces the route your packets take from the host you are working on to another host on a network, showing all the intermediate steps (routers) along the way.</para></sect3>
++
++</sect2>
++
+Index: basicnet/basicnet.ent
+===================================================================
+--- basicnet/basicnet.ent	(révision 0)
++++ basicnet/basicnet.ent	(révision 3)
+@@ -0,0 +1,59 @@
++<!ENTITY basicnet SYSTEM "basicnet.xml">
++
++<!-- Networking Libraries -->
++<!ENTITY basicnet-netlibs SYSTEM "netlibs/netlibs.xml">
++<!ENTITY % curl SYSTEM "netlibs/curl/curl.ent">
++<!ENTITY % wvstreams SYSTEM "netlibs/wvstreams/wvstreams.ent">
++%curl;
++%wvstreams;
++
++<!-- Text Web Browsers -->
++<!ENTITY basicnet-textweb SYSTEM "textweb/textweb.xml">
++<!ENTITY % links SYSTEM "textweb/links/links.ent">
++<!ENTITY % lynx SYSTEM "textweb/lynx/lynx.ent">
++<!ENTITY % w3m SYSTEM "textweb/w3m/w3m.ent">
++%links;
++%lynx;
++%w3m
++
++<!-- Basic Networking Programs -->
++<!ENTITY basicnet-netprogs SYSTEM "netprogs/netprogs.xml">
++<!ENTITY basicnet-netprogs-opensshclient SYSTEM "netprogs/openssh-client.xml">
++<!ENTITY % ncftp SYSTEM "netprogs/ncftp/ncftp.ent">
++<!ENTITY % telnet SYSTEM "netprogs/telnet/telnet.ent">
++<!ENTITY % cvs SYSTEM "netprogs/cvs/cvs.ent">
++<!ENTITY % wget SYSTEM "netprogs/wget/wget.ent">
++%ncftp;
++%telnet;
++%cvs;
++%wget;
++
++<!-- Basic Networking Utilities -->
++<!ENTITY basicnet-netutils SYSTEM "netutils/netutils.xml">
++<!ENTITY % traceroute SYSTEM "netutils/traceroute/traceroute.ent">
++<!ENTITY % nmap SYSTEM "netutils/nmap/nmap.ent">
++<!ENTITY % whois SYSTEM "netutils/whois/whois.ent">
++%traceroute;
++%nmap;
++%whois;
++
++<!-- Mail and News Progs -->
++<!ENTITY basicnet-mailnews SYSTEM "mailnews/mailnews.xml">
++<!ENTITY basicnet-mailnews-othermn SYSTEM "mailnews/other.xml">
++<!ENTITY % procmail SYSTEM "mailnews/procmail/procmail.ent">
++<!ENTITY % fetchmail SYSTEM "mailnews/fetchmail/fetchmail.ent">
++<!ENTITY % mutt SYSTEM "mailnews/mutt/mutt.ent">
++<!ENTITY % pine SYSTEM "mailnews/pine/pine.ent">
++<!ENTITY % slrn SYSTEM "mailnews/slrn/slrn.ent">
++%procmail;
++%fetchmail;
++%mutt;
++%pine;
++%slrn;
++
++<!-- DJB -->
++<!ENTITY basicnet-djb SYSTEM "djb/djb.xml">
++<!ENTITY % daemontools SYSTEM "djb/daemontools/daemontools.ent">
++<!ENTITY % ucspi-tcp SYSTEM "djb/ucspi-tcp/ucspi-tcp.ent">
++%daemontools;
++%ucspi-tcp;
+Index: basicnet/djb/daemontools.xml
+===================================================================
+--- basicnet/djb/daemontools.xml	(révision 0)
++++ basicnet/djb/daemontools.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="daemontools" xreflabel="daemontools">
++<?dbhtml filename="daemontools.html" dir="basicnet"?>
++<title>daemontools-&daemontools-version;</title>
++
++&daemontools-intro;
++&daemontools-inst;
++&daemontools-exp;
++&daemontools-desc;
++
++</sect1>
++
+Index: basicnet/djb/daemontools/daemontools-intro.xml
+===================================================================
+--- basicnet/djb/daemontools/daemontools-intro.xml	(révision 0)
++++ basicnet/djb/daemontools/daemontools-intro.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Introduction to Daemontools</title>
++
++<screen>Download location:              &daemontools-download;
++Version used:                   &daemontools-version;
++Package size:                   &daemontools-size;
++Estimated Disk space required:  &daemontools-buildsize;</screen>
++
++<para>The daemontools package is a replacement for inetd or xinetd. The main 
++reason for using it here is because it's recommended for use with Qmail 
++and djbdns.</para>
++
++</sect2>
+Index: basicnet/djb/daemontools/daemontools-exp.xml
+===================================================================
+--- basicnet/djb/daemontools/daemontools-exp.xml	(révision 0)
++++ basicnet/djb/daemontools/daemontools-exp.xml	(révision 3)
+@@ -0,0 +1,56 @@
++<sect2>
++<title>Command explanations</title>
++
++<para>The first thing to understand in installing any package written 
++by Daniel J. Bernstein, and 
++this includes Qmail, djbdns and ucspi-tcp in addition to daemontools, is 
++that he is willing to completely disregard standards if his idea of the 
++correct thing to do differs from an particular standard. Professor 
++Bernstein is a standards body unto himself when it comes to his own 
++software. </para>
++
++<para>It is therefore necessary to make quite a few changes to the 
++installation commands for his packages to get them to install in a manner 
++that is compliant with the Filesystem Hierarchy Standard (FHS). Most of 
++the following commands are due to this difficulty.</para>
++
++<para><userinput>cd admin/daemontools-0.76: </userinput>First off, the 
++package is unpacked in an "admin" directory. You will find the actual 
++packages two directory levels below this.</para>
++
++<para><userinput>package/compile: </userinput>This command actually 
++compiles the source and puts the binaries in a command directory.</para>
++
++<para><screen><userinput>sed 's|command|usr/sbin|' boot.inittab > boot.inittab~</userinput>
++<userinput>mv boot.inittab~ boot.inittab</userinput></screen></para>
++<para>These two commands are necessary to get the 
++binaries installed in /usr/sbin rather than 
++creating a non-standard /command directory and installing them there.
++</para>
++
++<para><screen><userinput>sed 's|/command:/usr/local/bin:/usr/local/sbin:||' svscanboot > svscanboot~</userinput>
++<userinput>sed 's|/service|/etc/service|g' svscanboot~ > svscanboot</userinput>
++<userinput>rm svscanboot~</userinput></screen></para>
++<para>This changes the svscanboot script so that it checks the 
++/etc/service directory for daemons to run instead of the default 
++/service directory.</para>
++
++<para><userinput>cp * /usr/sbin: </userinput>We must manually copy the 
++binaries to the /usr/sbin directory.</para>
++
++<para><screen><userinput>cat /etc/inittab boot.inittab > /etc/inittab~</userinput>
++<userinput>mv -f /etc/inittab~ /etc/inittab</userinput></screen></para>
++
++<para>These commands append a line to /etc/inittab so that init will launch
++the svscan program.</para>
++
++<para><userinput>telinit Q: </userinput>This command tells the init 
++process to re-read its configuration file (inittab) and act upon any 
++changes that have been made.</para>
++
++<para><userinput>mkdir /etc/service: </userinput>This command creates
++the daemontools control directory, which needs to exist, even if empty
++for daemontools to run properly.</para>
++
++</sect2>
++
+Index: basicnet/djb/daemontools/daemontools-inst.xml
+===================================================================
+--- basicnet/djb/daemontools/daemontools-inst.xml	(révision 0)
++++ basicnet/djb/daemontools/daemontools-inst.xml	(révision 3)
+@@ -0,0 +1,22 @@
++<sect2>
++<title>Installation of daemontools</title>
++
++<para>Install daemontools by running the following commands:</para>
++
++<para><screen><userinput>cd admin/daemontools-0.76 && 
++package/compile &&
++cd package && 
++sed 's|command|usr/sbin|' boot.inittab > boot.inittab~ && 
++mv boot.inittab~ boot.inittab &&
++cd ../command &&
++sed 's|/command:/usr/local/bin:/usr/local/sbin:||' svscanboot > svscanboot~ &&
++sed 's|/service|/etc/service|g' svscanboot~ > svscanboot && 
++rm svscanboot~ && 
++cp * /usr/sbin &&
++cd ../package && 
++cat /etc/inittab boot.inittab > /etc/inittab~ && 
++mv -f /etc/inittab~ /etc/inittab && 
++telinit Q &&
++mkdir /etc/service</userinput></screen></para>
++</sect2>
++
+Index: basicnet/djb/daemontools/daemontools-desc.xml
+===================================================================
+--- basicnet/djb/daemontools/daemontools-desc.xml	(révision 0)
++++ basicnet/djb/daemontools/daemontools-desc.xml	(révision 3)
+@@ -0,0 +1,83 @@
++<sect2>
++<title>Contents</title>
++
++<para>The daemontools package contains <userinput>svscanboot svscan 
++supervise svc svok svstat fghack pgrphack readproctitle multilog tai64n 
++tai64nlocal setuidgid envuidgid envdir softlimit</userinput> and 
++<userinput>setlock</userinput>. More detailed descriptions of these 
++commands may be found at http://cr.yp.to/daemontools.html.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>svscanboot</title>
++<para>svscanboot is simply a script that calls svscan and pipes its output 
++to readproctitle.</para></sect3>
++
++<sect3><title>svscan</title>
++<para>svscan checks the service directory for daemons to run and starts 
++a supervise process for each run script that it finds.</para></sect3>
++
++<sect3><title>supervise</title>
++<para>supervise runs the run script passed to it by svscan and monitors 
++the process the script starts so that if it dies, supervise restarts it.
++</para></sect3>
++
++<sect3><title>svc</title>
++<para>svc sends signals to processes being run under supervise.
++</para></sect3>
++
++<sect3><title>svok</title>
++<para>svok checks to see that supervise is running in the directory 
++passed to it.</para></sect3>
++
++<sect3><title>svstat</title>
++<para>svstat prints the status of processes monitored by supervise.
++</para></sect3>
++
++<sect3><title>fghack</title>
++<para>fghack prevents processes from putting themselves into the 
++background.</para></sect3>
++
++<sect3><title>pgrphack</title>
++<para>pgrphack runs a process in a separate process group.</para>
++</sect3>
++
++<sect3><title>readproctitle</title>
++<para>readproctitle displays log entries in the output of ps.</para>
++</sect3>
++
++<sect3><title>multilog</title>
++<para>multilog is a logging program. It takes output from a daemon and 
++appends it to any number of logs.</para></sect3>
++
++<sect3><title>tai64n</title>
++<para>tai64n is a timestamp generating program.</para></sect3>
++
++<sect3><title>tai64nlocal</title>
++<para>tai64nlocal converts output of tai64n into a human readable 
++format.</para></sect3>
++
++<sect3><title>setuidgid</title>
++<para>setuidgid runs a specified program under a given account's uid 
++and gid.</para></sect3>
++
++<sect3><title>envuidgid</title>
++<para>envuidgid performs the same function as setuidgid, but sets 
++environment variables $UID and $GID equal to the uid and gid of the 
++account specified.</para></sect3>
++
++<sect3><title>envdir</title>
++<para>envdir runs a given program with environment variables specified 
++by files in a directory.</para></sect3>
++
++<sect3><title>softlimit</title>
++<para>softlimit allows resource limits to be set for a given program.
++</para></sect3>
++
++<sect3><title>setlock</title>
++<para>setlock locks a file and runs a program.</para></sect3>
++
++</sect2>
++
+Index: basicnet/djb/daemontools/daemontools-man-intro.xml
+===================================================================
+--- basicnet/djb/daemontools/daemontools-man-intro.xml	(révision 0)
++++ basicnet/djb/daemontools/daemontools-man-intro.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect2>
++<title>Introduction to Daemontools-man</title>
++
++<screen>Download location:              &daemontools-man-download;
++Version used:                   &daemontools-man-version;
++Package size:                   &daemontools-man-size;
++Estimated Disk space required:  &daemontools-man-buildsize;</screen>
++
++<para>The Daemontools package does not come with manpages, so install
++this package if you want online help with the daemontools programs.</para>
++
++</sect2>
+Index: basicnet/djb/daemontools/daemontools-man-exp.xml
+===================================================================
+--- basicnet/djb/daemontools/daemontools-man-exp.xml	(révision 0)
++++ basicnet/djb/daemontools/daemontools-man-exp.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>gzip -9 *.8: </userinput>You can compress the manpages
++to save space, but it isn't needed for the manpages to work.</para>
++
++<para><userinput>package/compile: </userinput>This command actually 
++compiles the source and puts the binaries in a command directory.</para>
++
++</sect2>
++
+Index: basicnet/djb/daemontools/daemontools-man-inst.xml
+===================================================================
+--- basicnet/djb/daemontools/daemontools-man-inst.xml	(révision 0)
++++ basicnet/djb/daemontools/daemontools-man-inst.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Installation of daemontools</title>
++
++<para>Install daemontools by running the following commands:</para>
++
++<para><screen><userinput>cd daemontools-man && 
++gzip -9 *.8 &&
++cp *.8.gz /usr/share/man/man8/</userinput></screen></para>
++</sect2>
++
+Index: basicnet/djb/daemontools/daemontools-man-desc.xml
+===================================================================
+--- basicnet/djb/daemontools/daemontools-man-desc.xml	(révision 0)
++++ basicnet/djb/daemontools/daemontools-man-desc.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Contents</title>
++
++<para>The daemontools-man package contains manpages for the daemontools
++commands <userinput>envdir envuidgid fghack multilog pgrphack
++readproctitle setlock setuidgid softlimit supervise svc svok svscan
++svscanboot svstat tai64n</userinput> and
++<userinput>tai64nlocal</userinput>.</para>
++
++</sect2>
+Index: basicnet/djb/daemontools/daemontools.ent
+===================================================================
+--- basicnet/djb/daemontools/daemontools.ent	(révision 0)
++++ basicnet/djb/daemontools/daemontools.ent	(révision 3)
+@@ -0,0 +1,19 @@
++<!ENTITY daemontools SYSTEM "../daemontools.xml">
++<!ENTITY daemontools-intro SYSTEM "daemontools-intro.xml">
++<!ENTITY daemontools-inst SYSTEM "daemontools-inst.xml">
++<!ENTITY daemontools-exp SYSTEM "daemontools-exp.xml">
++<!ENTITY daemontools-desc SYSTEM "daemontools-desc.xml">
++<!ENTITY daemontools-buildsize "approximately 1 MB">
++<!ENTITY daemontools-version "0.76">
++<!ENTITY daemontools-download "http://cr.yp.to/daemontools/daemontools-0.76.tar.gz" >
++<!ENTITY daemontools-size "162 KB">
++
++<!ENTITY daemontools-man SYSTEM "../daemontools-man.xml">
++<!ENTITY daemontools-man-intro SYSTEM "daemontools-man-intro.xml">
++<!ENTITY daemontools-man-inst SYSTEM "daemontools-man-inst.xml">
++<!ENTITY daemontools-man-exp SYSTEM "daemontools-man-exp.xml">
++<!ENTITY daemontools-man-desc SYSTEM "daemontools-man-desc.xml">
++<!ENTITY daemontools-man-buildsize "approximately 1 MB">
++<!ENTITY daemontools-man-version "0.76">
++<!ENTITY daemontools-man-download "http://smarden.org/pape/djb/manpages/daemontools-0.76-man.tar.gz" >
++<!ENTITY daemontools-man-size "8 KB">
+Index: basicnet/djb/ucspi-tcp.xml
+===================================================================
+--- basicnet/djb/ucspi-tcp.xml	(révision 0)
++++ basicnet/djb/ucspi-tcp.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="ucspi-tcp" xreflabel="ucspi-tcp">
++<?dbhtml filename="ucspi-tcp.html" dir="basicnet"?>
++<title>ucspi-tcp-&ucspi-tcp-version;</title>
++
++&ucspi-tcp-intro;
++&ucspi-tcp-inst;
++&ucspi-tcp-exp;
++&ucspi-tcp-desc;
++
++</sect1>
++
+Index: basicnet/djb/ucspi-tcp/ucspi-tcp.ent
+===================================================================
+--- basicnet/djb/ucspi-tcp/ucspi-tcp.ent	(révision 0)
++++ basicnet/djb/ucspi-tcp/ucspi-tcp.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY ucspi-tcp SYSTEM "../ucspi-tcp.xml">
++<!ENTITY ucspi-tcp-intro SYSTEM "ucspi-tcp-intro.xml">
++<!ENTITY ucspi-tcp-inst SYSTEM "ucspi-tcp-inst.xml">
++<!ENTITY ucspi-tcp-exp SYSTEM "ucspi-tcp-exp.xml">
++<!ENTITY ucspi-tcp-desc SYSTEM "ucspi-tcp-desc.xml">
++<!ENTITY ucspi-tcp-buildsize "199 KB">
++<!ENTITY ucspi-tcp-version "0.88">
++<!ENTITY ucspi-tcp-download "http://cr.yp.to/ucspi-tcp/ucspi-tcp-0.88.tar.gz">
++<!ENTITY ucspi-tcp-size "53 KB">
+Index: basicnet/djb/ucspi-tcp/ucspi-tcp-intro.xml
+===================================================================
+--- basicnet/djb/ucspi-tcp/ucspi-tcp-intro.xml	(révision 0)
++++ basicnet/djb/ucspi-tcp/ucspi-tcp-intro.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Introduction to ucspi-tcp</title>
++
++<screen>Download location:              &ucspi-tcp-download;
++Version used:                   &ucspi-tcp-version;
++Package size:                   &ucspi-tcp-size;
++Estimated Disk space required:  &ucspi-tcp-buildsize;</screen>
++
++<para>The ucspi-tcp package consists of a suite of tools that allow the easy 
++creation of client-server tcp daemons. Tcpserver is a more secure alternative 
++to inetd. It has built in functionality for rule based access control, and 
++will gracefully defer connections when the configurable maximum load is reached,
++unlike inetd. Tcpserver is also recommended for use with Qmail, and was 
++written by the same author.</para>
++
++</sect2>
+Index: basicnet/djb/ucspi-tcp/ucspi-tcp-exp.xml
+===================================================================
+--- basicnet/djb/ucspi-tcp/ucspi-tcp-exp.xml	(révision 0)
++++ basicnet/djb/ucspi-tcp/ucspi-tcp-exp.xml	(révision 3)
+@@ -0,0 +1,19 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><screen><userinput>sed 's|/usr/local|/usr|' conf-home > conf-home~</userinput>
++<userinput>mv conf-home~ conf-home</userinput>
++<userinput>sed 's/bin/sbin/' hier.c > hier.c~</userinput>
++<userinput>mv hier.c~ hier.c :</userinput></screen> 
++These commands change the installation directory to /usr/sbin from the default 
++of /usr/local/bin. Since these tools are used in conjuction with daemons, 
++they don't make much sense in general user directories. However, some of the 
++example programs and the tcpclient program might be of use to non-root users. 
++If you wish to make these available, then we would suggest installing as above, 
++and then executing the following commands: 
++<screen><userinput>cd /usr/sbin</userinput>
++<userinput>mv tcpclient *@ mconnect delcr addcr tcpcat /usr/bin</userinput></screen>This 
++will place the client related programs into /usr/bin for general use.</para>
++
++</sect2>
++
+Index: basicnet/djb/ucspi-tcp/ucspi-tcp-inst.xml
+===================================================================
+--- basicnet/djb/ucspi-tcp/ucspi-tcp-inst.xml	(révision 0)
++++ basicnet/djb/ucspi-tcp/ucspi-tcp-inst.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Installation of ucspi-tcp</title>
++
++<para>Install ucspi-tcp by running the following commands:</para>
++<para><screen><userinput>sed 's|/usr/local|/usr|' conf-home > conf-home~ &&</userinput>
++<userinput>mv conf-home~ conf-home &&</userinput>
++<userinput>sed 's/bin/sbin/' hier.c > hier.c~ &&</userinput>
++<userinput>mv hier.c~ hier.c &&</userinput>
++<userinput>make &&</userinput>
++<userinput>make setup check</userinput></screen></para>
++
++</sect2>
++
+Index: basicnet/djb/ucspi-tcp/ucspi-tcp-desc.xml
+===================================================================
+--- basicnet/djb/ucspi-tcp/ucspi-tcp-desc.xml	(révision 0)
++++ basicnet/djb/ucspi-tcp/ucspi-tcp-desc.xml	(révision 3)
+@@ -0,0 +1,82 @@
++<sect2>
++<title>Contents</title>
++
++<para>The ucspi-tcp package contains <userinput>tcpserver, tcprules, 
++tcprulescheck, argv0, fixcrio, recordio, rblsmtpd, tcpclient, who@,
++date@, finger@, http@, tcpcat, mconnect, addcr, delcr</userinput></para>
++
++<para>You can also find detailed descriptions of each of these programs at 
++http://cr.yp.to/ucspi-tcp/tcpserver.html, but here is a brief summary:</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>tcpserver</title>
++<para>tcpserver listens for incoming tcp connections on a given port, and runs 
++a program of your choosing in response to a connection.</para></sect3>
++
++<sect3><title>tcprules</title>
++<para>tcprules compiles rules that govern access control for tcpserver into a 
++fast access database format.</para></sect3>
++
++<sect3><title>tcprulescheck</title>
++<para>tcprulescheck makes it possible to see how tcpserver will react to 
++connections from a given address without actually having to connect via that 
++address. This is useful for checking to see if the access control rules you 
++are using are doing what you expected.</para></sect3>
++
++<sect3><title>argv0</title>
++<para>argv0 runs a given program with a specified 0th argument.</para></sect3>
++
++<sect3><title>fixcrio</title>
++<para>fixcrio inserts carriage returns at the end of lines when they are 
++missing.</para></sect3>
++
++<sect3><title>recordio</title>
++<para>recordio records all input and output of a program given as an 
++argument.</para></sect3>
++
++<sect3><title>rblsmtpd</title>
++<para>rblsmtpd is a spam blocking program that works in conjunction with your 
++smtp daemon and tcpserver.</para></sect3>
++
++<sect3><title>tcpclient</title>
++<para>tcpclient creates a connection to a tcp port for a given 
++program.</para></sect3>
++
++<sect3><title>who@</title>
++<para>who@ is a demonstration program using tcpclient that has the 
++functionality of the rwho program. It requires a server running sysstat 
++on port 11.</para></sect3>
++
++<sect3><title>date@</title>
++<para>date@ is a demonstration program using tcpclient that will return the 
++system time of a remote host which is running a daytime service on 
++port 13.</para></sect3>
++
++<sect3><title>finger@</title>
++<para>finger@ is a demonstration program using tcpclient that mimics the 
++functionality of the finger program. It requires a server running fingerd 
++on port 79.</para></sect3>
++
++<sect3><title>http@</title>
++<para>http@ downloads web pages from web servers.</para></sect3>
++
++<sect3><title>tcpcat</title>
++<para>tcpcat connects to a tcp port and prints all that is returned from the 
++port.</para></sect3>
++
++<sect3><title>mconnect</title>
++<para>mconnect connects to a tcp port, delivers any input specified to the 
++port, and prints any output from the port.</para></sect3>
++
++<sect3><title>addcr</title>
++<para>addcr adds carriage returns to files. This and delcr are useful for 
++converting between Windows to UNIX file formats.</para></sect3>
++
++<sect3><title>delcr</title>
++<para>delcr removes carriage returns from files.</para></sect3>
++
++</sect2>
++
+Index: basicnet/djb/daemontools-man.xml
+===================================================================
+--- basicnet/djb/daemontools-man.xml	(révision 0)
++++ basicnet/djb/daemontools-man.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="daemontools-man" xreflabel="daemontools-man">
++<?dbhtml filename="daemontools-man.html" dir="basicnet"?>
++<title>daemontools-man-&daemontools-man-version;</title>
++
++&daemontools-man-intro;
++&daemontools-man-inst;
++&daemontools-man-exp;
++&daemontools-man-desc;
++
++</sect1>
++
+Index: basicnet/djb/djb.xml
+===================================================================
+--- basicnet/djb/djb.xml	(révision 0)
++++ basicnet/djb/djb.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<chapter id="basicnet-djb">
++<?dbhtml filename="djb.html" dir="basicnet"?>
++<title>DJB's Utilities</title>
++
++<para>Intro & Who want's to use them?</para>
++
++&daemontools;
++&daemontools-man;
++&ucspi-tcp;
++
++</chapter>
+Index: basicnet/mailnews/procmail.xml
+===================================================================
+--- basicnet/mailnews/procmail.xml	(révision 0)
++++ basicnet/mailnews/procmail.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="procmail" xreflabel="procmail">
++<?dbhtml filename="procmail.html" dir="basicnet"?>
++<title>procmail</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: basicnet/mailnews/procmail/procmail.ent
+===================================================================
+--- basicnet/mailnews/procmail/procmail.ent	(révision 0)
++++ basicnet/mailnews/procmail/procmail.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY procmail SYSTEM "../procmail.xml">
+Index: basicnet/mailnews/mutt.xml
+===================================================================
+--- basicnet/mailnews/mutt.xml	(révision 0)
++++ basicnet/mailnews/mutt.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="mutt" xreflabel="mutt">
++<?dbhtml filename="mutt.html" dir="basicnet"?>
++<title>mutt</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: basicnet/mailnews/mutt/mutt.ent
+===================================================================
+--- basicnet/mailnews/mutt/mutt.ent	(révision 0)
++++ basicnet/mailnews/mutt/mutt.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY mutt SYSTEM "../mutt.xml">
+Index: basicnet/mailnews/pine.xml
+===================================================================
+--- basicnet/mailnews/pine.xml	(révision 0)
++++ basicnet/mailnews/pine.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="pine" xreflabel="pine">
++<?dbhtml filename="pine.html" dir="basicnet"?>
++<title>pine</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: basicnet/mailnews/fetchmail.xml
+===================================================================
+--- basicnet/mailnews/fetchmail.xml	(révision 0)
++++ basicnet/mailnews/fetchmail.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="fetchmail" xreflabel="fetchmail">
++<?dbhtml filename="fetchmail.html" dir="basicnet"?>
++<title>fetchmail-&fetchmail-version;</title>
++
++&fetchmail-intro;
++&fetchmail-inst;
++&fetchmail-exp;
++&fetchmail-config;
++&fetchmail-desc;
++
++</sect1>
++
+Index: basicnet/mailnews/pine/pine.ent
+===================================================================
+--- basicnet/mailnews/pine/pine.ent	(révision 0)
++++ basicnet/mailnews/pine/pine.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY pine SYSTEM "../pine.xml">
+Index: basicnet/mailnews/fetchmail/fetchmail.ent
+===================================================================
+--- basicnet/mailnews/fetchmail/fetchmail.ent	(révision 0)
++++ basicnet/mailnews/fetchmail/fetchmail.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY fetchmail SYSTEM "../fetchmail.xml">
++<!ENTITY fetchmail-intro SYSTEM "fetchmail-intro.xml">
++<!ENTITY fetchmail-inst SYSTEM "fetchmail-inst.xml">
++<!ENTITY fetchmail-exp SYSTEM "fetchmail-exp.xml">
++<!ENTITY fetchmail-desc SYSTEM "fetchmail-desc.xml">
++<!ENTITY fetchmail-config SYSTEM "fetchmail-config.xml">
++<!ENTITY fetchmail-buildsize "4.1 MB">
++<!ENTITY fetchmail-version "5.8.15">
++<!ENTITY fetchmail-download "http://www.tuxedo.org/~esr/fetchmail/fetchmail-5.8.15.tar.gz">
++<!ENTITY fetchmail-size "854 KB">
+Index: basicnet/mailnews/fetchmail/fetchmail-intro.xml
+===================================================================
+--- basicnet/mailnews/fetchmail/fetchmail-intro.xml	(révision 0)
++++ basicnet/mailnews/fetchmail/fetchmail-intro.xml	(révision 3)
+@@ -0,0 +1,17 @@
++<sect2>
++<title>Introduction to fetchmail</title>
++
++<screen>Download location:              &fetchmail-download;
++Version used:                   &fetchmail-version;
++Package size:                   &fetchmail-size;
++Estimated Disk space required:  &fetchmail-buildsize;</screen>
++
++<para>The fetchmail package contains the fetchmail program. "It
++retrieves mail from remote mail servers and forwards it to your local
++(client) machine's delivery system, so it can then be be read by
++normal mail user agents." </para>
++
++<screen>fetchmail depends on:
++OpenSSL and a local MDA (procmail).</screen>
++
++</sect2>
+Index: basicnet/mailnews/fetchmail/fetchmail-exp.xml
+===================================================================
+--- basicnet/mailnews/fetchmail/fetchmail-exp.xml	(révision 0)
++++ basicnet/mailnews/fetchmail/fetchmail-exp.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>--with-ssl</userinput> This enables SSL if found, so that you 
++can handle connections to secure POP3 and IMAP servers.</para>
++<para><userinput>--enable-fallback=procmail</userinput> This tells fetchmail 
++to hand incoming mail to procmail for delivery if your port 25 mail server is 
++not present or not responding.</para>
++</sect2>
++
+Index: basicnet/mailnews/fetchmail/fetchmail-inst.xml
+===================================================================
+--- basicnet/mailnews/fetchmail/fetchmail-inst.xml	(révision 0)
++++ basicnet/mailnews/fetchmail/fetchmail-inst.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Installation of fetchmail</title>
++
++<para>Install fetchmail by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr --with-ssl --enable-fallback=procmail &&</userinput>
++<userinput>make &&</userinput>
++<userinput>make install</userinput>
++</screen>
++</para>
++
++</sect2>
++
+Index: basicnet/mailnews/fetchmail/fetchmail-desc.xml
+===================================================================
+--- basicnet/mailnews/fetchmail/fetchmail-desc.xml	(révision 0)
++++ basicnet/mailnews/fetchmail/fetchmail-desc.xml	(révision 3)
+@@ -0,0 +1,22 @@
++<sect2>
++<title>Contents</title>
++
++<para>The fetchmail package contains <userinput>fetchmail fetchmailconf</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>fetchmail</title>
++<para>When executed as a user this will source that users ~/.fetchmailrc and 
++download the appropraite mail.  When run as root ALL users who have a 
++.fetchmailrc will have their mail downloaded and delivered accordingly.
++</para></sect3>
++
++<sect3><title>fetchmailconf</title>
++<para>This program provides a Tk GUI interface to your ~/.fetchmailrc making it 
++much easier to configure.  However you will require, Python, and it must 
++have the Tkinker module available.</para></sect3>
++
++</sect2>
++
+Index: basicnet/mailnews/fetchmail/fetchmail-config.xml
+===================================================================
+--- basicnet/mailnews/fetchmail/fetchmail-config.xml	(révision 0)
++++ basicnet/mailnews/fetchmail/fetchmail-config.xml	(révision 3)
+@@ -0,0 +1,30 @@
++<sect2>
++<title>Configuring fetchmail</title>
++
++<sect3><title>Config files</title>
++<para><userinput>~/.fetchmailrc</userinput></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para><screen><userinput>set logfile /var/log/fetchmail.log</userinput>
++<userinput>set no bouncemail</userinput>
++<userinput>set postmaster root</userinput>
++
++<userinput>poll SERVERNAME :</userinput>
++<userinput>        user "username" pass "password";</userinput>
++<userinput>        mda "/usr/bin/procmail -f %F -d %T";</userinput></screen>
++</para>
++
++<para>Is an example configuration that should surfice for most people.  You 
++can add as many users and servers as you need using the same syntax.</para>
++
++<para><userinput>man fetchmail</userinput> Look for the section near the bottom 
++named <userinput>CONFIGURATION EXAMPLES</userinput> it gives some quick 
++examples too.  There are countless other config options once you get used to 
++it.</para>
++
++</sect3>
++
++</sect2>
++
+Index: basicnet/mailnews/slrn.xml
+===================================================================
+--- basicnet/mailnews/slrn.xml	(révision 0)
++++ basicnet/mailnews/slrn.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="slrn" xreflabel="slrn">
++<?dbhtml filename="slrn.html" dir="basicnet"?>
++<title>slrn</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: basicnet/mailnews/mailnews.xml
+===================================================================
+--- basicnet/mailnews/mailnews.xml	(révision 0)
++++ basicnet/mailnews/mailnews.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<chapter id="basicnet-mailnews">
++<?dbhtml filename="mailnews.html" dir="basicnet"?>
++<title>Basic Networking Programs</title>
++
++&procmail;
++&fetchmail;
++&mutt;
++&pine;
++&slrn;
++&basicnet-mailnews-othermn;
++
++</chapter>
+Index: basicnet/mailnews/slrn/slrn.ent
+===================================================================
+--- basicnet/mailnews/slrn/slrn.ent	(révision 0)
++++ basicnet/mailnews/slrn/slrn.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY slrn SYSTEM "../slrn.xml">
+Index: basicnet/mailnews/other.xml
+===================================================================
+--- basicnet/mailnews/other.xml	(révision 0)
++++ basicnet/mailnews/other.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="basicnet-mailnews-other">
++<?dbhtml filename="othermn.html" dir="basicnet"?>
++<title>Other mail and news progs</title>
++
++<para>Mention the X-based ones here and link to relevant sections.</para>
++
++</sect1>
+Index: basicnet/netlibs/netlibs.xml
+===================================================================
+--- basicnet/netlibs/netlibs.xml	(révision 0)
++++ basicnet/netlibs/netlibs.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<chapter id="basicnet-netlibs">
++<?dbhtml filename="netlibs.html" dir="basicnet"?>
++<title>Networking Libraries</title>
++
++&curl;
++&wvstreams;
++
++</chapter>
+Index: basicnet/netlibs/curl.xml
+===================================================================
+--- basicnet/netlibs/curl.xml	(révision 0)
++++ basicnet/netlibs/curl.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="curl" xreflabel="curl-&curl-version;">
++<?dbhtml filename="curl.html" dir="basicnet"?>
++<title>curl-&curl-version;</title>
++
++&curl-intro;
++&curl-inst;
++&curl-config;
++&curl-desc;
++
++</sect1>
++
+Index: basicnet/netlibs/curl/curl.ent
+===================================================================
+--- basicnet/netlibs/curl/curl.ent	(révision 0)
++++ basicnet/netlibs/curl/curl.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY curl SYSTEM "../curl.xml">
++<!ENTITY curl-intro SYSTEM "curl-intro.xml">
++<!ENTITY curl-inst SYSTEM "curl-inst.xml">
++<!ENTITY curl-desc SYSTEM "curl-desc.xml">
++<!ENTITY curl-config SYSTEM "curl-config.xml">
++<!ENTITY curl-buildsize "5.8 MB">
++<!ENTITY curl-version "7.9.8">
++<!ENTITY curl-download "http://curl.haxx.se/download/curl-7.9.8.tar.gz">
++<!ENTITY curl-size "720 KB">
+Index: basicnet/netlibs/curl/curl-intro.xml
+===================================================================
+--- basicnet/netlibs/curl/curl-intro.xml	(révision 0)
++++ basicnet/netlibs/curl/curl-intro.xml	(révision 3)
+@@ -0,0 +1,20 @@
++<sect2>
++<title>Introduction to curl</title>
++
++<screen>Download location:              <ulink url="&curl-download;"/>
++Version used:                   &curl-version;
++Package size:                   &curl-size;
++Estimated Disk space required:  &curl-buildsize;</screen>
++
++<para>The curl package contains curl and its support library. This is
++useful for transferring files with URL syntax. For example, curl
++http://curl.haxx.se/download/curl-&curl-version;.tar.gz >
++curl-&curl-version;.tar.gz
++would download this programs tarball to the current directory. This
++ability to both download and redirect files can be incorporated
++into other programs to support functions like streaming media.</para>
++
++<screen>curl will utilize:
++<xref linkend="openssl"/> and openldap</screen>
++
++</sect2>
+Index: basicnet/netlibs/curl/curl-inst.xml
+===================================================================
+--- basicnet/netlibs/curl/curl-inst.xml	(révision 0)
++++ basicnet/netlibs/curl/curl-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of curl</title>
++
++<para>Install curl by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install </userinput></screen></para>
++
++</sect2>
++
+Index: basicnet/netlibs/curl/curl-desc.xml
+===================================================================
+--- basicnet/netlibs/curl/curl-desc.xml	(révision 0)
++++ basicnet/netlibs/curl/curl-desc.xml	(révision 3)
+@@ -0,0 +1,24 @@
++<sect2>
++<title>Contents</title>
++
++<para>The curl package contains <userinput>curl</userinput>, <userinput>curl-config</userinput> and the
++<userinput>curl library</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>curl</title>
++<para>curl is a client that can get documents from or send documents to
++any of the following protocols: HTTP, HTTPS (needs openssl), FTP,
++GOPHER, DICT, TELNET, LDAP (needs openldap) or FILE.</para></sect3>
++
++<sect3><title>curl-config</title>
++<para>curl-config prints information about the last compile, like
++libraries linked to and prefix setting.</para></sect3>
++
++<sect3><title>curl library</title>
++<para>libcurl provides the functionality of curl to other programs.</para></sect3>
++
++</sect2>
++
+Index: basicnet/netlibs/curl/curl-config.xml
+===================================================================
+--- basicnet/netlibs/curl/curl-config.xml	(révision 0)
++++ basicnet/netlibs/curl/curl-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring curl</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: basicnet/netlibs/wvstreams.xml
+===================================================================
+--- basicnet/netlibs/wvstreams.xml	(révision 0)
++++ basicnet/netlibs/wvstreams.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="wvstreams" xreflabel="wvstreams-&wvstreams-version;">
++<?dbhtml filename="wvstreams.html" dir="basicnet"?>
++<title>wvstreams-&wvstreams-version;</title>
++
++&wvstreams-intro;
++&wvstreams-inst;
++&wvstreams-config;
++&wvstreams-desc;
++
++</sect1>
++
+Index: basicnet/netlibs/wvstreams/wvstreams-config.xml
+===================================================================
+--- basicnet/netlibs/wvstreams/wvstreams-config.xml	(révision 0)
++++ basicnet/netlibs/wvstreams/wvstreams-config.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Configuring wvstreams</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
+Index: basicnet/netlibs/wvstreams/wvstreams.ent
+===================================================================
+--- basicnet/netlibs/wvstreams/wvstreams.ent	(révision 0)
++++ basicnet/netlibs/wvstreams/wvstreams.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY wvstreams SYSTEM "../wvstreams.xml">
++<!ENTITY wvstreams-intro SYSTEM "wvstreams-intro.xml">
++<!ENTITY wvstreams-inst SYSTEM "wvstreams-inst.xml">
++<!ENTITY wvstreams-desc SYSTEM "wvstreams-desc.xml">
++<!ENTITY wvstreams-config SYSTEM "wvstreams-config.xml">
++<!ENTITY wvstreams-buildsize "9.6 MB">
++<!ENTITY wvstreams-version "3.70">
++<!ENTITY wvstreams-download "http://open.nit.ca/download/wvstreams-3.70.tar.gz">
++<!ENTITY wvstreams-size "178 KB">
+Index: basicnet/netlibs/wvstreams/wvstreams-intro.xml
+===================================================================
+--- basicnet/netlibs/wvstreams/wvstreams-intro.xml	(révision 0)
++++ basicnet/netlibs/wvstreams/wvstreams-intro.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Introduction to wvstreams</title>
++
++<screen>Download location:              &wvstreams-download;
++Version used:                   &wvstreams-version;
++Package size:                   &wvstreams-size;
++Estimated Disk space required:  &wvstreams-buildsize;</screen>
++
++<para>The wvstreams package contains the libwvutils, libwvstreams and
++libwvcrypto libraries.  These are needed to compile wvdial.</para>
++
++<screen>wvstreams needs <xref linkend="openssl"/> to build the wvcrypto library.</screen>
++
++</sect2>
+Index: basicnet/netlibs/wvstreams/wvstreams-inst.xml
+===================================================================
+--- basicnet/netlibs/wvstreams/wvstreams-inst.xml	(révision 0)
++++ basicnet/netlibs/wvstreams/wvstreams-inst.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Installation of wvstreams</title>
++
++<para>Install wvstreams by running the following commands:</para>
++
++<para><screen><userinput>make PREFIX=/usr &&
++make PREFIX=/usr install</userinput></screen></para>
++
++</sect2>
++
+Index: basicnet/netlibs/wvstreams/wvstreams-desc.xml
+===================================================================
+--- basicnet/netlibs/wvstreams/wvstreams-desc.xml	(révision 0)
++++ basicnet/netlibs/wvstreams/wvstreams-desc.xml	(révision 3)
+@@ -0,0 +1,22 @@
++<sect2>
++<title>Contents</title>
++
++<para>The wvstreams package contains the
++<userinput>wvcrypto</userinput>, <userinput>wvstreams</userinput> and
++<userinput>wvutils</userinput> libraries.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>wvcrypto</title>
++<para>No description is currently available.</para></sect3>
++
++<sect3><title>wvstreams</title>
++<para>No description is currently available.</para></sect3>
++
++<sect3><title>wvutils</title>
++<para>No description is currently available.</para></sect3>
++
++</sect2>
++
+Index: basicnet/netprogs/wget.xml
+===================================================================
+--- basicnet/netprogs/wget.xml	(révision 0)
++++ basicnet/netprogs/wget.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="wget" xreflabel="wget">
++<?dbhtml filename="wget.html" dir="basicnet"?>
++<title>wget</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: basicnet/netprogs/wget/wget.ent
+===================================================================
+--- basicnet/netprogs/wget/wget.ent	(révision 0)
++++ basicnet/netprogs/wget/wget.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY wget SYSTEM "../wget.xml">
+Index: basicnet/netprogs/ncftp.xml
+===================================================================
+--- basicnet/netprogs/ncftp.xml	(révision 0)
++++ basicnet/netprogs/ncftp.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="ncftp" xreflabel="ncftp-&ncftp-version;">
++<?dbhtml filename="ncftp.html" dir="basicnet"?>
++<title>ncftp-&ncftp-version;</title>
++
++&ncftp-intro;
++&ncftp-inst;
++&ncftp-exp;
++&ncftp-config;
++&ncftp-desc;
++
++</sect1>
++
+Index: basicnet/netprogs/cvs.xml
+===================================================================
+--- basicnet/netprogs/cvs.xml	(révision 0)
++++ basicnet/netprogs/cvs.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="cvs" xreflabel="cvs-&cvs-version;">
++<?dbhtml filename="cvs.html" dir="basicnet"?>
++<title>cvs-&cvs-version;</title>
++
++&cvs-intro;
++&cvs-inst;
++&cvs-config;
++&cvs-desc;
++
++</sect1>
++
+Index: basicnet/netprogs/ncftp/ncftp-intro.xml
+===================================================================
+--- basicnet/netprogs/ncftp/ncftp-intro.xml	(révision 0)
++++ basicnet/netprogs/ncftp/ncftp-intro.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Introduction to ncftp</title>
++
++<screen>Download location:              &ncftp-download;
++Version used:                   &ncftp-version;
++Package size:                   &ncftp-size;
++Estimated Disk space required:  &ncftp-buildsize;</screen>
++
++<para>The ncftp package contains a powerful and flexible interface to 
++the Internet standard File Transfer Protocol.  It is intended to replace
++or supplement the stock ftp program.</para>
++
++</sect2>
+Index: basicnet/netprogs/ncftp/ncftp-exp.xml
+===================================================================
+--- basicnet/netprogs/ncftp/ncftp-exp.xml	(révision 0)
++++ basicnet/netprogs/ncftp/ncftp-exp.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>cd libncftp && make shared && make
++soinstall :</userinput>  These commands make and install the 
++dynamic library libncftp which is then used to link against when compiling 
++the main program.</para>
++
++</sect2>
++
+Index: basicnet/netprogs/ncftp/ncftp-inst.xml
+===================================================================
+--- basicnet/netprogs/ncftp/ncftp-inst.xml	(révision 0)
++++ basicnet/netprogs/ncftp/ncftp-inst.xml	(révision 3)
+@@ -0,0 +1,33 @@
++<sect2>
++<title>Installation of ncftp</title>
++
++<para>There are two ways to build ncftp.  The first (and optimal) way,
++builds most of the functionality as a shared library and then builds and
++installs the program linked against this library.  The second method
++simply links all of the functionality into the binary statically.  This
++doesn't make the dynamic library available for linking by other
++applications.  You need to choose which method best suits you.  Note
++that the second method does <emphasis>not</emphasis> create an entirely
++statically linked binary; only the libncftp parts are statically linked
++in, in this case.</para>
++
++<para>To install ncftp using the first (and optimal) method, run the 
++following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++cd libncftp &&
++make shared &&
++make soinstall &&
++cd .. &&
++make &&
++make install</userinput></screen></para>
++
++<para>To install ncftp using the second method (with the libncftp 
++functionality linked in statically) run the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: basicnet/netprogs/ncftp/ncftp-desc.xml
+===================================================================
+--- basicnet/netprogs/ncftp/ncftp-desc.xml	(révision 0)
++++ basicnet/netprogs/ncftp/ncftp-desc.xml	(révision 3)
+@@ -0,0 +1,33 @@
++<sect2>
++<title>Contents</title>
++
++<para>The ncftp package contains <userinput>ncftp, ncftpbatch,
++ncftpbookmarks, ncftpget, ncftpls, ncftpput</userinput> 
++and <userinput>ncftpspooler</userinput>.</para>
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>ncftp</title>
++<para>A browser program for File Transfer Protocol</para></sect3>
++
++<sect3><title>ncftpbatch</title>
++<para>Individual batch FTP job processor</para></sect3>
++
++<sect3><title>ncftpbookmarks</title>
++<para>NcFTP Bookmark Editor (NCurses-based)</para></sect3>
++
++<sect3><title>ncftpget</title>
++<para>Internet file transfer program for scripts</para></sect3>
++
++<sect3><title>ncftpls</title>
++<para>Internet file transfer program for scripts</para></sect3>
++
++<sect3><title>ncftpput</title>
++<para>Internet file transfer program for scripts</para></sect3>
++
++<sect3><title>ncftpspooler</title>
++<para>Global batch FTP job processor daemon</para></sect3>
++
++</sect2>
++
+Index: basicnet/netprogs/ncftp/ncftp-config.xml
+===================================================================
+--- basicnet/netprogs/ncftp/ncftp-config.xml	(révision 0)
++++ basicnet/netprogs/ncftp/ncftp-config.xml	(révision 3)
+@@ -0,0 +1,24 @@
++<sect2>
++<title>Configuring ncftp</title>
++
++<sect3><title>Config files</title>
++<para><userinput>~/.ncftp/*</userinput>; especially
++<userinput>~/.ncftp/prefs_v3</userinput></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para>Most ncftp configuration is done whilst in the program and the
++configuration files are dealt with automatically.  One exception to this
++is <filename>~/.ncftp/prefs_v3</filename>.  There are various options to
++alter in there, including:</para>
++
++<para><userinput>yes-i-know-about-NcFTPd=yes</userinput>: This disables
++the splash screen advertising the NcFTPd server.</para>
++
++<para>There are other options in the prefs_v3 file.  Most of these are
++self-explanatory.</para>
++</sect3>
++
++</sect2>
++
+Index: basicnet/netprogs/ncftp/ncftp.ent
+===================================================================
+--- basicnet/netprogs/ncftp/ncftp.ent	(révision 0)
++++ basicnet/netprogs/ncftp/ncftp.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY ncftp SYSTEM "../ncftp.xml">
++<!ENTITY ncftp-intro SYSTEM "ncftp-intro.xml">
++<!ENTITY ncftp-inst SYSTEM "ncftp-inst.xml">
++<!ENTITY ncftp-exp SYSTEM "ncftp-exp.xml">
++<!ENTITY ncftp-desc SYSTEM "ncftp-desc.xml">
++<!ENTITY ncftp-config SYSTEM "ncftp-config.xml">
++<!ENTITY ncftp-buildsize "5.0 MB">
++<!ENTITY ncftp-version "3.1.2">
++<!ENTITY ncftp-download "ftp://ftp.ncftp.com/ncftp/ncftp-3.1.2-src.tar.bz2">
++<!ENTITY ncftp-size "378 KB">
+Index: basicnet/netprogs/openssh-client.xml
+===================================================================
+--- basicnet/netprogs/openssh-client.xml	(révision 0)
++++ basicnet/netprogs/openssh-client.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect1 id="basicnet-netprogs-openssh">
++<?dbhtml filename="openssh.html" dir="basicnet"?>
++<title>The OpenSSH-&openssh-version; client</title>
++
++<para>The ssh client is a secure replacement for telnet.  If you want to
++install it, the instructions can be found in Chapter 09 - <xref
++linkend="openssh"/>.  Note that if you only want to use the client, you
++do <emphasis>not</emphasis> need to run the server and so do not need
++the startup script and links.  In accordance with good practice, only
++run the server if you actually need it (and if you don't know whether
++you need it or not, it's likely that you don't!).</para>
++
++</sect1>
+Index: basicnet/netprogs/telnet.xml
+===================================================================
+--- basicnet/netprogs/telnet.xml	(révision 0)
++++ basicnet/netprogs/telnet.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<sect1 id="telnet" xreflabel="telnet">
++<?dbhtml filename="telnet.html" dir="basicnet"?>
++<title>telnet</title>
++
++<para>TO BE DONE - CLIENT ONLY - WARN NOT TO USE SERVER UNLESS YOU
++<emphasis>REALLY</emphasis> KNOW WHAT YOU'RE DOING.</para>
++
++</sect1>
++
+Index: basicnet/netprogs/cvs/cvs-config.xml
+===================================================================
+--- basicnet/netprogs/cvs/cvs-config.xml	(révision 0)
++++ basicnet/netprogs/cvs/cvs-config.xml	(révision 3)
+@@ -0,0 +1,20 @@
++<sect2>
++<title>Configuring cvs</title>
++
++<sect3><title>Config files</title>
++<para><userinput>~/.cvsrc ~/.cvswrappers</userinput></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para>~/.cvsrc is the main cvs configuration file.  This file is used by
++users to specify defaults for different cvs commands, for example to
++make all cvs diff commands run with -u, a user would add diff -u to
++their .cvsrc file.</para>
++
++<para>~/.cvswrappers specifies wrappers to be used in addition to
++those specified in the CVSROOT/cvswrappers file in the
++repository.</para></sect3>
++
++</sect2>
++
+Index: basicnet/netprogs/cvs/cvs.ent
+===================================================================
+--- basicnet/netprogs/cvs/cvs.ent	(révision 0)
++++ basicnet/netprogs/cvs/cvs.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY cvs SYSTEM "../cvs.xml">
++<!ENTITY cvs-intro SYSTEM "cvs-intro.xml">
++<!ENTITY cvs-inst SYSTEM "cvs-inst.xml">
++<!ENTITY cvs-desc SYSTEM "cvs-desc.xml">
++<!ENTITY cvs-config SYSTEM "cvs-config.xml">
++<!ENTITY cvs-buildsize "14 MB">
++<!ENTITY cvs-version "1.11.2">
++<!ENTITY cvs-download "http://ccvs.cvshome.org/servlets/ProjectDownloadList">
++<!ENTITY cvs-size "2.6 MB">
+Index: basicnet/netprogs/cvs/cvs-intro.xml
+===================================================================
+--- basicnet/netprogs/cvs/cvs-intro.xml	(révision 0)
++++ basicnet/netprogs/cvs/cvs-intro.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Introduction to cvs</title>
++
++<screen>Download location:              <ulink url="&cvs-download;"/>
++Version used:                   &cvs-version;
++Package size:                   &cvs-size;
++Estimated Disk space required:  &cvs-buildsize;</screen>
++
++<para>CVS is the concurrent versioning system. This is useful for
++projects on which multiple people are working or where archives of
++previous versions of files need to be kept.</para>
++
++</sect2>
+Index: basicnet/netprogs/cvs/cvs-inst.xml
+===================================================================
+--- basicnet/netprogs/cvs/cvs-inst.xml	(révision 0)
++++ basicnet/netprogs/cvs/cvs-inst.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect2>
++<title>Installation of cvs</title>
++
++<para>Install cvs by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&</userinput>
++<userinput>make &&</userinput>
++<userinput>make install</userinput></screen>
++</para>
++
++</sect2>
++
+Index: basicnet/netprogs/cvs/cvs-desc.xml
+===================================================================
+--- basicnet/netprogs/cvs/cvs-desc.xml	(révision 0)
++++ basicnet/netprogs/cvs/cvs-desc.xml	(révision 3)
+@@ -0,0 +1,23 @@
++<sect2>
++<title>Contents</title>
++
++<para>The cvs package contains <userinput>cvs, cvsbug</userinput> and
++<userinput>rcs2log</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>cvs</title>
++<para>This is the main program file for the concurrent versioning 
++system</para></sect3>
++
++<sect3><title>cvsbug</title>
++<para>This is used to send problem reports about CVS to a central
++support site</para></sect3>
++
++<sect3><title>rcs2log</title>
++<para>RCS to ChangeLog generator</para></sect3>
++
++</sect2>
++
+Index: basicnet/netprogs/netprogs.xml
+===================================================================
+--- basicnet/netprogs/netprogs.xml	(révision 0)
++++ basicnet/netprogs/netprogs.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<chapter id="basicnet-netprogs">
++<?dbhtml filename="netprogs.html" dir="basicnet"?>
++<title>Basic Networking Programs</title>
++
++&ncftp;
++&basicnet-netprogs-opensshclient;
++&telnet;
++&cvs;
++&wget;
++
++</chapter>
+Index: basicnet/textweb/w3m.xml
+===================================================================
+--- basicnet/textweb/w3m.xml	(révision 0)
++++ basicnet/textweb/w3m.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="w3m" xreflabel="w3m">
++<?dbhtml filename="w3m.html" dir="basicnet"?>
++<title>w3m</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: basicnet/textweb/w3m/w3m.ent
+===================================================================
+--- basicnet/textweb/w3m/w3m.ent	(révision 0)
++++ basicnet/textweb/w3m/w3m.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY w3m SYSTEM "../w3m.xml">
+Index: basicnet/textweb/lynx.xml
+===================================================================
+--- basicnet/textweb/lynx.xml	(révision 0)
++++ basicnet/textweb/lynx.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="lynx" xreflabel="lynx-&lynx-version;">
++<?dbhtml filename="lynx.html" dir="basicnet"?>
++<title>lynx-&lynx-version;</title>
++
++&lynx-intro;
++&lynx-inst;
++&lynx-exp;
++&lynx-config;
++&lynx-desc;
++
++</sect1>
++
+Index: basicnet/textweb/lynx/lynx.ent
+===================================================================
+--- basicnet/textweb/lynx/lynx.ent	(révision 0)
++++ basicnet/textweb/lynx/lynx.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY lynx SYSTEM "../lynx.xml">
++<!ENTITY lynx-intro SYSTEM "lynx-intro.xml">
++<!ENTITY lynx-inst SYSTEM "lynx-inst.xml">
++<!ENTITY lynx-exp SYSTEM "lynx-exp.xml">
++<!ENTITY lynx-desc SYSTEM "lynx-desc.xml">
++<!ENTITY lynx-config SYSTEM "lynx-config.xml">
++<!ENTITY lynx-buildsize "16 MB">
++<!ENTITY lynx-version "2.8.4">
++<!ENTITY lynx-download "http://lynx.isc.org/release/lynx2.8.4.tar.bz2">
++<!ENTITY lynx-size "1.9 MB">
+Index: basicnet/textweb/lynx/lynx-intro.xml
+===================================================================
+--- basicnet/textweb/lynx/lynx-intro.xml	(révision 0)
++++ basicnet/textweb/lynx/lynx-intro.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Introduction to lynx</title>
++
++<screen>Download location:              &lynx-download;
++Version used:                   &lynx-version;
++Package size:                   &lynx-size;
++Estimated Disk space required:  &lynx-buildsize;</screen>
++
++<para>Lynx is a text based web browser.</para>
++
++<screen>lynx can use <xref linkend="openssl"></xref> and <xref linkend="zlib"></xref>.  
++OpenSSL is needed in order to access HTTPS (i.e. secure) websites and so it is highly recommended that it is used.
++Zlib is used by lynx for decompression of some gzip files.</screen>
++
++</sect2>
+Index: basicnet/textweb/lynx/lynx-exp.xml
+===================================================================
+--- basicnet/textweb/lynx/lynx-exp.xml	(révision 0)
++++ basicnet/textweb/lynx/lynx-exp.xml	(révision 3)
+@@ -0,0 +1,24 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>--libdir=/etc :</userinput> For some reason, the
++configure and make routine for lynx uses libdir as the prefix for the
++configuration file.  We set this to /etc so that the system wide
++configuration file is <userinput>/etc/lynx.cfg</userinput>.</para>
++
++<para><userinput>--with-ssl :</userinput> This enables support for
++linking SSL into lynx.</para>
++
++<para><userinput>--with-zlib :</userinput> This enables support for
++linking zlib into lynx.</para>
++
++<para><userinput>DOCDIR=... HELPDIR=... :</userinput> We set these
++variables to avoid getting the help and documentation files installed
++under /etc.</para>
++
++<para><userinput>sed... mv /etc/lynx.bak /etc/lynx.cfg :</userinput> This 
++sed command changes the /etc/lynx.cfg file so it looks for the help
++files in the correct place.</para>
++
++</sect2>
++
+Index: basicnet/textweb/lynx/lynx-inst.xml
+===================================================================
+--- basicnet/textweb/lynx/lynx-inst.xml	(révision 0)
++++ basicnet/textweb/lynx/lynx-inst.xml	(révision 3)
+@@ -0,0 +1,21 @@
++<sect2>
++<title>Installation of lynx</title>
++
++<para>Install lynx by running the following commands.  If you don't have
++openssl or zlib, miss out the <userinput>--with-ssl</userinput> or
++<userinput>--with-zlib</userinput> part of the configure command as
++appropriate.</para>
++
++<para><screen><userinput>./configure --prefix=/usr --libdir=/etc --with-ssl --with-zlib &&</userinput>
++<userinput>make &&</userinput>
++<userinput>make install &&</userinput>
++<userinput>make DOCDIR=/usr/share/doc/lynx-2.8.4/lynx_doc \</userinput>
++<userinput>   HELPDIR=/usr/share/doc/lynx-2.8.4/lynx_help install-doc &&</userinput>
++<userinput>make DOCDIR=/usr/share/doc/lynx-2.8.4/lynx_doc \</userinput>
++<userinput>   HELPDIR=/usr/share/doc/lynx-2.8.4/lynx_help install-help &&</userinput>
++<userinput>sed s/"t\/etc"/"t\/usr\/share\/doc\/lynx\-2\.8\.4"/ \</userinput>
++<userinput>   /etc/lynx.cfg > /etc/lynx.bak &&</userinput>
++<userinput>mv /etc/lynx.bak /etc/lynx.cfg</userinput></screen></para>
++
++</sect2>
++
+Index: basicnet/textweb/lynx/lynx-desc.xml
+===================================================================
+--- basicnet/textweb/lynx/lynx-desc.xml	(révision 0)
++++ basicnet/textweb/lynx/lynx-desc.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Contents</title>
++
++<para>The lynx package contains <userinput>lynx</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>lynx</title>
++<para>lynx is a general purpose, text-based, distributed information browser 
++for the World Wide Web.</para></sect3>
++
++</sect2>
++
+Index: basicnet/textweb/lynx/lynx-config.xml
+===================================================================
+--- basicnet/textweb/lynx/lynx-config.xml	(révision 0)
++++ basicnet/textweb/lynx/lynx-config.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Configuring lynx</title>
++
++<sect3><title>Config files</title>
++<para><userinput>/etc/lynx.cfg</userinput></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para>Various settings such as proxies can be set in the system-wide
++lynx.cfg file found in /etc</para>
++</sect3>
++
++</sect2>
++
+Index: basicnet/textweb/links.xml
+===================================================================
+--- basicnet/textweb/links.xml	(révision 0)
++++ basicnet/textweb/links.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="links" xreflabel="links-&links-version;">
++<?dbhtml filename="links.html" dir="basicnet"?>
++<title>links-&links-version;</title>
++
++&links-intro;
++&links-inst;
++&links-config;
++&links-desc;
++
++</sect1>
++
+Index: basicnet/textweb/links/links-intro.xml
+===================================================================
+--- basicnet/textweb/links/links-intro.xml	(révision 0)
++++ basicnet/textweb/links/links-intro.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Introduction to links</title>
++
++<screen>Download location:              &links-download;
++Version used:                   &links-version;
++Package size:                   &links-size;
++Estimated Disk space required:  &links-buildsize;</screen>
++
++<para>Links is a text-based WWW browser.</para>
++
++<screen>Links can use <xref linkend="openssl"></xref> and <xref linkend="gpm"></xref>.
++OpenSSL is needed in order to access HTTPS (i.e. secure) websites and so it is highly recommended that it is used.
++GPM provides console mouse support to links.</screen>
++
++</sect2>
+Index: basicnet/textweb/links/links-inst.xml
+===================================================================
+--- basicnet/textweb/links/links-inst.xml	(révision 0)
++++ basicnet/textweb/links/links-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of links</title>
++
++<para>Install links by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&</userinput>
++<userinput>make &&</userinput>
++<userinput>make install</userinput></screen></para>
++
++</sect2>
++
+Index: basicnet/textweb/links/links-desc.xml
+===================================================================
+--- basicnet/textweb/links/links-desc.xml	(révision 0)
++++ basicnet/textweb/links/links-desc.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Contents</title>
++
++<para>The links package contains <userinput>links</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>links</title>
++<para>links is a lynx-like alternative character mode WWW browser</para></sect3>
++
++</sect2>
++
+Index: basicnet/textweb/links/links-config.xml
+===================================================================
+--- basicnet/textweb/links/links-config.xml	(révision 0)
++++ basicnet/textweb/links/links-config.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Configuring links</title>
++
++<sect3><title>Config files</title>
++<para><userinput>~/.links/*</userinput></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para>Links stores its configuration in per-user files in the ~/.links
++directory.  These files are created automatically when links is run.</para>
++</sect3>
++
++</sect2>
++
+Index: basicnet/textweb/links/links.ent
+===================================================================
+--- basicnet/textweb/links/links.ent	(révision 0)
++++ basicnet/textweb/links/links.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY links SYSTEM "../links.xml">
++<!ENTITY links-intro SYSTEM "links-intro.xml">
++<!ENTITY links-inst SYSTEM "links-inst.xml">
++<!ENTITY links-desc SYSTEM "links-desc.xml">
++<!ENTITY links-config SYSTEM "links-config.xml">
++<!ENTITY links-buildsize "4.3 MB">
++<!ENTITY links-version "0.97">
++<!ENTITY links-download "http://artax.karlin.mff.cuni.cz/~mikulas/links/download/links-0.97.tar.gz">
++<!ENTITY links-size "518 KB">
+Index: basicnet/textweb/textweb.xml
+===================================================================
+--- basicnet/textweb/textweb.xml	(révision 0)
++++ basicnet/textweb/textweb.xml	(révision 3)
+@@ -0,0 +1,22 @@
++<chapter id="basicnet-textweb">
++<?dbhtml filename="textweb.html" dir="basicnet"?>
++<title>Text Web Browsers</title>
++
++<para>People who are new to Unix-based systems tend to ask the question
++"Why on earth would I want a text-mode browser?  I'm going to compile X
++and use Konqueror/Mozilla/Whatever!".  Those who have been
++around systems for a while know that when (not if) you manage to mess up
++your graphical browser install and you need to look up some information
++on the web, a console based browser will save you.  Also, there are
++quite a few people who prefer to use one of these browsers as their
++principle method of browsing; either to avoid the clutter and bandwidth
++which accompanies images or because they may use a text-to-speech
++synthesiser which can read the page to them (of use for instance to
++partially sighted or blind users).  We currently have installation
++instructions for two console web browsers:</para>
++
++&links;
++&lynx;
++&w3m;
++
++</chapter>
+Index: connect/connect.xml
+===================================================================
+--- connect/connect.xml	(révision 0)
++++ connect/connect.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<part id="connect" xreflabel="Connecting to a Network">
++<?dbhtml filename="connect.html" dir="connect"?>
++<title>Connecting to a Network</title>
++
++<partintro><para>The LFS book covers setting up networking with a static 
++IP.  There are however, other methods which are used to connect to networks and
++importantly the internet.  We cover the most popular methods in this
++chapter.</para></partintro>
++
++&connect-dialup;
++&connect-dhcp;
++&connect-other;
++
++</part>
+Index: connect/connect.ent
+===================================================================
+--- connect/connect.ent	(révision 0)
++++ connect/connect.ent	(révision 3)
+@@ -0,0 +1,20 @@
++<!ENTITY connect SYSTEM "connect.xml">
++
++<!-- Dial-up -->
++<!ENTITY connect-dialup SYSTEM "dialup/dialup.xml">
++<!ENTITY % ppp SYSTEM "dialup/ppp/ppp.ent">
++<!ENTITY % wvdial SYSTEM "dialup/wvdial/wvdial.ent">
++%ppp;
++%wvdial;
++
++<!-- DHCP -->
++<!ENTITY connect-dhcp SYSTEM "dhcp/dhcp.xml">
++<!ENTITY connect-dhcp-client SYSTEM "dhcp/dhcp-client.xml">
++<!ENTITY % dhcpcd SYSTEM "dhcp/dhcpcd/dhcpcd.ent">
++%dhcpcd;
++<!ENTITY connect-dhcp-config SYSTEM "dhcp/config.xml">
++
++<!-- Other -->
++<!ENTITY connect-other SYSTEM "other/other.xml">
++<!ENTITY connect-other-isdn SYSTEM "other/isdn.xml">
++<!ENTITY connect-other-pppoe SYSTEM "other/pppoe.xml">
+Index: connect/dhcp/config.xml
+===================================================================
+--- connect/dhcp/config.xml	(révision 0)
++++ connect/dhcp/config.xml	(révision 3)
+@@ -0,0 +1,87 @@
++<sect1 id="dhcpclient" xreflabel="Configuring dhcp for a client">
++<?dbhtml filename="configdhcp.html" dir="connect"?>
++<title>Configuring dhcp for a client</title>
++
++<sect2><title>Config files</title>
++<para><userinput>/etc/sysconfig/network, 
++/etc/sysconfig/network-devices/ifup-eth0,
++/etc/sysconfig/network-devices/ifdown-eth0,
++/etc/sysconfig/networkdevices/ifconfig.eth0</userinput></para>
++</sect2>
++
++<sect2><title>Configuration Information</title>
++
++<para>Note that we use <userinput>eth0</userinput> as the interface
++throughout these instructions.  If you want to configure a different (or
++more than one) interface, simply replace <userinput>eth0</userinput>
++with the interface you wish to use.</para>
++
++<para>These instructions will convert the configuration files from LFS
++(a static configuration) to a DHCP configuration.  Note that static and
++DHCP interfaces can co-exist on a LFS system, only make the
++alterations to those interfaces which need to support DHCP.</para>
++
++<para>The first step is to remove the GATEWAY and GATEWAY_IF variables 
++from <filename>/etc/sysconfig/network</filename>.  This should only be done
++if the default interface you intend to use will be using DHCP and only
++needs to be done once; regardless of how many interfaces you are setting
++up.</para>
++
++<para><screen><userinput>cd /etc/sysconfig &&
++cp network network.bak &&
++sed "s/GATEWAY/# GATEWAY/" network.bak > network</userinput></screen></para>
++
++<para>Now you can create the appropriate <filename>ifconfig.eth0</filename> 
++file with the following commands (note that this will overwrite any
++existing file):</para>
++
++<para><screen><userinput>cd /etc/sysconfig/network-devices &&
++cat > ifconfig.eth0 << "EOF"</userinput>
++ONBOOT=yes
++DHCP_PROG=<path to dhcp>
++DHCP_START=<start parameters>
++DHCP_STOP=<stop parameter>
++<userinput>EOF</userinput></screen></para>
++
++<para>Review the appropriate manpages for parameters; for example, the
++stop parameter for dhcpcd is '-k', while the stop parameter for dhclient
++is '-r'.</para>
++
++<para>You then need to create DHCP specific scripts.  First, the
++<filename>ifup-eth0</filename> script:</para>
++
++<para><screen><userinput>cat > ifup-eth0 << "EOF" </userinput>
++#!/bin/sh
++
++source /etc/sysconfig/rc || exit
++source $rc_functions || exit
++source $network_devices/ifconfig.eth0 || exit
++
++echo "Bringing up the eth0 interface..."
++modprobe eth0
++loadproc $DHCP_PROG $DHCP_START
++<userinput>EOF</userinput></screen></para>
++
++<para>Then the <filename>ifdown-eth0</filename> script:</para>
++
++<para><screen><userinput>cat > ifdown-eth0 << "EOF" </userinput>
++#!/bin/sh
++
++source /etc/sysconfig/rc || exit
++source $rc_functions || exit
++source $network_devices/ifconfig.eth0 || exit
++
++echo "Bringing down the eth0 interface..."
++$DHCP_PROG $DHCP_STOP
++evaluate_retval
++<userinput>EOF</userinput></screen></para>
++
++<para>Finally, we need to make these scripts executable:</para>
++
++<para><screen><userinput>chmod 755 ifup-eth0 &&
++chmod 755 ifdown-eth0</userinput></screen></para>
++
++</sect2>
++
++</sect1>
++
+Index: connect/dhcp/dhcpcd.xml
+===================================================================
+--- connect/dhcp/dhcpcd.xml	(révision 0)
++++ connect/dhcp/dhcpcd.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="dhcpcd" xreflabel="dhcpcd-&dhcpcd-version;">
++<?dbhtml filename="dhcpcd.html" dir="connect"?>
++<title>dhcpcd-&dhcpcd-version;</title>
++
++&dhcpcd-intro;
++&dhcpcd-inst;
++&dhcpcd-exp;
++&dhcpcd-config;
++&dhcpcd-desc;
++
++</sect1>
++
+Index: connect/dhcp/dhcpcd/dhcpcd-intro.xml
+===================================================================
+--- connect/dhcp/dhcpcd/dhcpcd-intro.xml	(révision 0)
++++ connect/dhcp/dhcpcd/dhcpcd-intro.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Introduction to dhcpcd</title>
++
++<screen>Download location:              &dhcpcd-download;
++Version used:                   &dhcpcd-version;
++Package size:                   &dhcpcd-size;
++Estimated Disk space required:  &dhcpcd-buildsize;</screen>
++
++<para>The dhcpcd package contains the dhcpcd client. This is useful for
++connecting your computer to a network which uses DHCP to assign network
++addresses.</para>
++
++</sect2>
+Index: connect/dhcp/dhcpcd/dhcpcd-exp.xml
+===================================================================
+--- connect/dhcp/dhcpcd/dhcpcd-exp.xml	(révision 0)
++++ connect/dhcp/dhcpcd/dhcpcd-exp.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect2>
++<title>Command explanations</title>
++
++<para>There may be a good reason for abandoning the normal BLFS convention 
++of using --prefix=/usr here.  If you are installing DHCP, it is likely that 
++it is required during the boot process and /usr may be network mounted in 
++which case, dhcpcd wouldn't be available due to being on the network!  
++Therefore, depending on your situation, you may want it to be installed
++in /sbin or /usr/sbin.</para>
++
++</sect2>
++
+Index: connect/dhcp/dhcpcd/dhcpcd-inst.xml
+===================================================================
+--- connect/dhcp/dhcpcd/dhcpcd-inst.xml	(révision 0)
++++ connect/dhcp/dhcpcd/dhcpcd-inst.xml	(révision 3)
+@@ -0,0 +1,18 @@
++<sect2>
++<title>Installation of dhcpcd</title>
++
++<para>Depending on whether you want dhcpcd to be in /sbin or /usr/sbin,
++use one of the following sets of commands.  For /sbin:</para>
++
++<para><screen><userinput>./configure --prefix=/ &&
++make &&
++make install</userinput></screen></para>
++
++<para>and for /usr/sbin:</para>
++
++<para><screen><userinput>./configure --prefix=/usr --sysconfdir=/etc &&
++make &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: connect/dhcp/dhcpcd/dhcpcd-desc.xml
+===================================================================
+--- connect/dhcp/dhcpcd/dhcpcd-desc.xml	(révision 0)
++++ connect/dhcp/dhcpcd/dhcpcd-desc.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Contents</title>
++
++<para>The dhcpcd package contains <userinput>dhcpcd</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>dhcpcd</title>
++<para>dhcpcd is an implementation of the DHCP client specified in
++RFC2131 and RFC1541 (depending on which options are specified).</para></sect3>
++
++</sect2>
++
+Index: connect/dhcp/dhcpcd/dhcpcd-config.xml
+===================================================================
+--- connect/dhcp/dhcpcd/dhcpcd-config.xml	(révision 0)
++++ connect/dhcp/dhcpcd/dhcpcd-config.xml	(révision 3)
+@@ -0,0 +1,20 @@
++<sect2>
++<title>Configuring dhcpcd</title>
++
++<sect3><title>Config files</title>
++<para><userinput>/etc/dhcpcd/*</userinput></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para>To configure the client, you need to modify the
++<filename>/etc/sysconfig/network-devices/ifconfig.eth0</filename> file
++(or the appropriate one for the interface you are running DHCP on)
++you created earlier by adding the appropriate <userinput>DHCP_PROG
++</userinput>, <userinput>DHCP_START</userinput> and
++<userinput>DHCP_STOP</userinput> values.</para>
++
++</sect3>
++
++</sect2>
++
+Index: connect/dhcp/dhcpcd/dhcpcd.ent
+===================================================================
+--- connect/dhcp/dhcpcd/dhcpcd.ent	(révision 0)
++++ connect/dhcp/dhcpcd/dhcpcd.ent	(révision 3)
+@@ -0,0 +1,12 @@
++<!ENTITY dhcpcd SYSTEM "../dhcpcd.xml">
++<!ENTITY dhcpcd-intro SYSTEM "dhcpcd-intro.xml">
++<!ENTITY dhcpcd SYSTEM "dhcpcd.xml">
++<!ENTITY dhcpcd-intro SYSTEM "dhcpcd-intro.xml">
++<!ENTITY dhcpcd-inst SYSTEM "dhcpcd-inst.xml">
++<!ENTITY dhcpcd-exp SYSTEM "dhcpcd-exp.xml">
++<!ENTITY dhcpcd-desc SYSTEM "dhcpcd-desc.xml">
++<!ENTITY dhcpcd-config SYSTEM "dhcpcd-config.xml">
++<!ENTITY dhcpcd-buildsize "728 KB">
++<!ENTITY dhcpcd-version "1.3.22-pl1">
++<!ENTITY dhcpcd-download "ftp://ftp.phystech.com/pub/dhcpcd-1.3.22-pl1.tar.gz">
++<!ENTITY dhcpcd-size "131 KB">
+Index: connect/dhcp/dhcp-client.xml
+===================================================================
+--- connect/dhcp/dhcp-client.xml	(révision 0)
++++ connect/dhcp/dhcp-client.xml	(révision 3)
+@@ -0,0 +1,39 @@
++<sect1 id="connect-dhcp-client">
++<?dbhtml filename="dhcpclient.html" dir="connect"?>
++<title>Installing dhcp-&dhcp-version;</title>
++
++<para>The dhcp package comes with both a client and a server program for
++using DHCP.  If you want to install it, the instructions can be found
++at <xref linkend="dhcp"/>.  Note that if you only want to
++use the client, you do <emphasis>not</emphasis> need to run the server and
++so do not need the startup script and links provided for the server daemon.
++Note that to use the client, you still need to alter your
++<filename>ethnet</filename> script as described in the next section.
++You only need to run the DHCP server however, if you're providing this
++service to a network, and it's likely that you'll know if that's the
++case; if it isn't, don't run the server!</para>
++
++<para>To configure the client, you need to modify the
++<filename>/etc/sysconfig/network-devices/ifconfig.eth0</filename> file
++(or the appropriate one for the interface you are running DHCP on)
++you created earlier by adding the appropriate <userinput>DHCP_PROG
++</userinput>, <userinput>DHCP_START</userinput> and
++<userinput>DHCP_STOP</userinput> values.</para>
++
++<para>Then create the <filename>/etc/dhclient.conf</filename> using the
++following command:</para>
++
++<para><screen><userinput>cat > /etc/dhclient.conf <<
++"EOF"</userinput>
++# dhclient.conf
++
++interface "eth0"{
++prepend domain-name-servers 127.0.0.1;
++request subnet-mask, broadcast-address, time-offset, routers,
++        domain-name, domain-name-servers, host-name;
++require subnet-mask, domain-name-servers;
++}
++# end dhclient.conf
++<userinput>EOF</userinput></screen></para>
++
++</sect1>
+Index: connect/dhcp/dhcp.xml
+===================================================================
+--- connect/dhcp/dhcp.xml	(révision 0)
++++ connect/dhcp/dhcp.xml	(révision 3)
+@@ -0,0 +1,21 @@
++<chapter id="connect-dhcp">
++<?dbhtml filename="dhcp.html" dir="connect"?>
++<title>DHCP Clients</title>
++
++<para>DHCP stands for Dynamic Host Configuration Protocol.  It is a
++protocol which is used by many sites to automatically provide
++information such as IP addresses, subnet masks and routing information
++to computers.  If your network uses DHCP, you will need a DHCP client
++in order to connect to it.  DHCP is also used by some cable
++modems.</para>
++
++<para>We currently provide installation instructions for two DHCP
++clients, those from the dhcp and dhcpcd packages.  After we discuss
++installing the packages, we will also discuss how to
++configure your bootscripts to allow you to use dhcp as a client.</para>
++
++&connect-dhcp-client;
++&dhcpcd;
++&connect-dhcp-config;
++
++</chapter>
+Index: connect/dialup/wvdial.xml
+===================================================================
+--- connect/dialup/wvdial.xml	(révision 0)
++++ connect/dialup/wvdial.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="wvdial" xreflabel="wvdial-&wvdial-version;">
++<?dbhtml filename="wvdial.html" dir="connect"?>
++<title>wvdial-&wvdial-version;</title>
++
++&wvdial-intro;
++&wvdial-inst;
++&wvdial-config;
++&wvdial-desc;
++
++</sect1>
++
+Index: connect/dialup/wvdial/wvdial-config.xml
+===================================================================
+--- connect/dialup/wvdial/wvdial-config.xml	(révision 0)
++++ connect/dialup/wvdial/wvdial-config.xml	(révision 3)
+@@ -0,0 +1,25 @@
++<sect2>
++<title>Configuring wvdial</title>
++
++<sect3><title>Config files</title>
++<para><userinput>/etc/wvdial.conf</userinput>, 
++<userinput>/etc/ppp/*</userinput></para></sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para><userinput>wvdialconf /etc/wvdial.conf</userinput></para>
++<para>wvdialconf will test that you have a working modem, try and determine 
++it's exact setup and then ask you some questions regarding your ISPs phone 
++number etc.  You will then need to enter that information into the
++<filename>/etc/wvdial.conf</filename> file.</para>
++
++<para>You then start wvdial with: <userinput>wvdial</userinput>.</para>
++
++<para>For more information examine the
++<userinput>wvdialconf</userinput>, <userinput>wvdial.conf</userinput>
++and <userinput>wvdial</userinput> man pages.</para>
++
++</sect3>
++
++</sect2>
++
+Index: connect/dialup/wvdial/wvdial.ent
+===================================================================
+--- connect/dialup/wvdial/wvdial.ent	(révision 0)
++++ connect/dialup/wvdial/wvdial.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY wvdial SYSTEM "../wvdial.xml">
++<!ENTITY wvdial-intro SYSTEM "wvdial-intro.xml">
++<!ENTITY wvdial-inst SYSTEM "wvdial-inst.xml">
++<!ENTITY wvdial-desc SYSTEM "wvdial-desc.xml">
++<!ENTITY wvdial-config SYSTEM "wvdial-config.xml">
++<!ENTITY wvdial-buildsize "2.5 MB">
++<!ENTITY wvdial-version "1.53">
++<!ENTITY wvdial-download "http://open.nit.ca/download/wvdial_1.53.tar.gz">
++<!ENTITY wvdial-size "66 KB">
+Index: connect/dialup/wvdial/wvdial-intro.xml
+===================================================================
+--- connect/dialup/wvdial/wvdial-intro.xml	(révision 0)
++++ connect/dialup/wvdial/wvdial-intro.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Introduction to wvdial</title>
++
++<screen>Download location:              &wvdial-download;
++Version used:                   &wvdial-version;
++Package size:                   &wvdial-size;
++Estimated Disk space required:  &wvdial-buildsize;</screen>
++
++<para>The wvdial package contains a no nonsense, quick and easy to use 
++alternative to chat and pppd scripts.  If you simply want to dial a modem 
++without the fuss and hassle of chat issues, then you'll want this.</para>
++
++<screen>wvdial needs <xref linkend="wvstreams"/> to compile and run and <xref
++linkend="ppp"/> to run.</screen>
++
++</sect2>
+Index: connect/dialup/wvdial/wvdial-inst.xml
+===================================================================
+--- connect/dialup/wvdial/wvdial-inst.xml	(révision 0)
++++ connect/dialup/wvdial/wvdial-inst.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Installation of wvdial</title>
++
++<para>Install wvdial by running the following commands:</para>
++
++<para><screen><userinput>make PREFIX=/usr &&
++make PREFIX=/usr install &&</userinput></screen></para>
++
++</sect2>
++
+Index: connect/dialup/wvdial/wvdial-desc.xml
+===================================================================
+--- connect/dialup/wvdial/wvdial-desc.xml	(révision 0)
++++ connect/dialup/wvdial/wvdial-desc.xml	(révision 3)
+@@ -0,0 +1,18 @@
++<sect2>
++<title>Contents</title>
++
++<para>The wvdial package contains the <userinput>wvdial</userinput>
++and <userinput>wvdialconf</userinput> programs.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>wvdial</title>
++<para>Starts a ppp connection.</para></sect3>
++
++<sect3><title>wvdialconf</title>
++<para>Automates the configuration of wvdial</para></sect3>
++
++</sect2>
++
+Index: connect/dialup/dialup.xml
+===================================================================
+--- connect/dialup/dialup.xml	(révision 0)
++++ connect/dialup/dialup.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<chapter id="connect-dialup">
++<?dbhtml filename="dialup.html" dir="connect"?>
++<title>Dial-up networking</title>
++
++&ppp;
++&wvdial;
++
++</chapter>
+Index: connect/dialup/ppp.xml
+===================================================================
+--- connect/dialup/ppp.xml	(révision 0)
++++ connect/dialup/ppp.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="ppp" xreflabel="ppp-&ppp-version;">
++<?dbhtml filename="ppp.html" dir="connect"?>
++<title>ppp-&ppp-version;</title>
++
++&ppp-intro;
++&ppp-inst;
++&ppp-config;
++&ppp-desc;
++
++</sect1>
++
+Index: connect/dialup/ppp/ppp.ent
+===================================================================
+--- connect/dialup/ppp/ppp.ent	(révision 0)
++++ connect/dialup/ppp/ppp.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY ppp SYSTEM "../ppp.xml">
++<!ENTITY ppp-intro SYSTEM "ppp-intro.xml">
++<!ENTITY ppp-inst SYSTEM "ppp-inst.xml">
++<!ENTITY ppp-desc SYSTEM "ppp-desc.xml">
++<!ENTITY ppp-config SYSTEM "ppp-config.xml">
++<!ENTITY ppp-buildsize "4.1 MB">
++<!ENTITY ppp-version "2.4.1">
++<!ENTITY ppp-download "ftp://ftp.samba.org/pub/ppp/ppp-2.4.1.tar.gz">
++<!ENTITY ppp-size "524 KB">
+Index: connect/dialup/ppp/ppp-intro.xml
+===================================================================
+--- connect/dialup/ppp/ppp-intro.xml	(révision 0)
++++ connect/dialup/ppp/ppp-intro.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Introduction to ppp</title>
++
++<screen>Download location:              &ppp-download;
++Version used:                   &ppp-version;
++Package size:                   &ppp-size;
++Estimated Disk space required:  &ppp-buildsize;</screen>
++
++<para>The ppp package contains the pppd daemon and the chat program.
++This is used for connecting to other machines; often for connecting to
++the Internet via a dial-up connection to an ISP.</para>
++
++<screen>ppp needs nothing to compile but you must have PPP support
++either compiled in or as a kernel module to use it.</screen>
++
++</sect2>
+Index: connect/dialup/ppp/ppp-inst.xml
+===================================================================
+--- connect/dialup/ppp/ppp-inst.xml	(révision 0)
++++ connect/dialup/ppp/ppp-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of ppp</title>
++
++<para>Install ppp by running the following commands:</para>
++
++<para><screen><userinput>./configure &&
++make &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: connect/dialup/ppp/ppp-desc.xml
+===================================================================
+--- connect/dialup/ppp/ppp-desc.xml	(révision 0)
++++ connect/dialup/ppp/ppp-desc.xml	(révision 3)
+@@ -0,0 +1,29 @@
++<sect2>
++<title>Contents</title>
++
++<para>The ppp package contains the <userinput>chat</userinput>,
++<userinput>pppd</userinput>, <userinput>pppdump</userinput> and
++<userinput>pppstats</userinput> programs.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>chat</title>
++<para>The chat program defines a conversational exchange between the
++computer and the modem.  Its primary purpose is to establish the connection 
++between the Point-to-Point Protocol  Daemon  (pppd)  and  the remote's 
++pppd process.</para></sect3>
++
++<sect3><title>pppd</title>
++<para>pppd is the Point to Point Protocol daemon.</para></sect3>
++
++<sect3><title>pppdump</title>
++<para>pppdump is used to convert PPP record files 
++to a readable format.</para></sect3>
++
++<sect3><title>pppstats</title>
++<para>pppstats is used to print PPP statistics.</para></sect3>
++
++</sect2>
++
+Index: connect/dialup/ppp/ppp-config.xml
+===================================================================
+--- connect/dialup/ppp/ppp-config.xml	(révision 0)
++++ connect/dialup/ppp/ppp-config.xml	(révision 3)
+@@ -0,0 +1,17 @@
++<sect2>
++<title>Configuring ppp</title>
++
++<sect3><title>Config files</title>
++<para><userinput>/etc/ppp/*</userinput></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para>The ppp daemon itself requires very little configuration.  The
++main trick is script the connection.  This can be done either using the
++chat program which comes with this package or by using <xref
++linkend="wvdial"/>.</para>
++</sect3>
++
++</sect2>
++
+Index: connect/other/isdn.xml
+===================================================================
+--- connect/other/isdn.xml	(révision 0)
++++ connect/other/isdn.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="isdn" xreflabel="isdn">
++<?dbhtml filename="isdn.html" dir="connect"?>
++<title>isdn</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: connect/other/other.xml
+===================================================================
+--- connect/other/other.xml	(révision 0)
++++ connect/other/other.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<chapter id="connect-other">
++<?dbhtml filename="other.html" dir="connect"?>
++<title>Other</title>
++
++&connect-other-isdn;
++&connect-other-pppoe;
++
++</chapter>
+Index: connect/other/pppoe.xml
+===================================================================
+--- connect/other/pppoe.xml	(révision 0)
++++ connect/other/pppoe.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="pppoe" xreflabel="pppoe">
++<?dbhtml filename="pppoe.html" dir="connect"?>
++<title>pppoe</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: book/book.ent
+===================================================================
+--- book/book.ent	(révision 0)
++++ book/book.ent	(révision 3)
+@@ -0,0 +1,22 @@
++<!ENTITY book SYSTEM "book.xml">
++
++<!ENTITY book-info SYSTEM "bookinfo.xml">
++<!ENTITY book-info-authorgroup SYSTEM "authorgroup.xml">
++<!ENTITY book-info-copyright SYSTEM "copyright.xml">
++<!ENTITY book-info-legalnotice SYSTEM "legalnotice.xml">
++<!ENTITY book-info-abstract SYSTEM "abstract.xml">
++
++<!ENTITY book-dedication SYSTEM "dedication.xml">
++
++<!-- Generally used entities go here -->
++
++<!ENTITY library-config SYSTEM "library-config.xml">
++
++<!ENTITY maintainer-fullname "Mark Hymers">
++<!ENTITY maintainer-firstname "Mark">
++<!ENTITY maintainer-address "markh at linuxfromscratch.org">
++
++<!ENTITY ftp-root "ftp://ftp.linuxfromscratch.org">
++<!ENTITY http-root "http://ftp.linuxfromscratch.org">
++<!ENTITY file-root "ftp://ftp.linuxfromscratch.org/blfs-patches/">
++<!ENTITY hints-root "http://hints.linuxfromscratch.org">
+Index: book/abstract.xml
+===================================================================
+--- book/abstract.xml	(révision 0)
++++ book/abstract.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<abstract>
++
++<para>This book follows on from the LinuxFromScratch book.  It introduces and
++guides the reader through additions to the system including networking,
++X support, sound support and printer and scanner support.</para>
++
++</abstract>
++
+Index: book/dedication.xml
+===================================================================
+--- book/dedication.xml	(révision 0)
++++ book/dedication.xml	(révision 3)
+@@ -0,0 +1,6 @@
++<dedication>
++<title>Dedication</title>
++
++<para>This book is dedicated to the LFS community</para>
++
++</dedication>
+Index: book/bookinfo.xml
+===================================================================
+--- book/bookinfo.xml	(révision 0)
++++ book/bookinfo.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<bookinfo>
++<title>Beyond Linux From Scratch</title>
++<subtitle>Version &version;</subtitle>
++&book-info-authorgroup;
++&book-info-copyright;
++&book-info-legalnotice;
++&book-info-abstract;
++
++</bookinfo>
+Index: book/legalnotice.xml
+===================================================================
+--- book/legalnotice.xml	(révision 0)
++++ book/legalnotice.xml	(révision 3)
+@@ -0,0 +1,36 @@
++<legalnotice>
++
++<para>Copyright (c) 1999-2002, BLFS Development Team</para>
++
++<para>All rights reserved.</para>
++
++<para>Redistribution and use in source and binary forms, with or without
++modification, are permitted provided that the following conditions are
++met:</para>
++
++<itemizedlist>
++<listitem><para>Redistributions in any form must retain the above copyright 
++notice, this list of conditions and the following disclaimer.</para></listitem>
++
++<listitem><para>Neither the name of "Linux From Scratch" nor the names of 
++its contributors may be used to endorse or promote products derived from 
++this material without specific prior written permission.</para></listitem>
++
++<listitem><para>Any material derived from Linux From Scratch must contain 
++a reference to the "Linux From Scratch" project.</para></listitem>
++</itemizedlist>
++
++<para>THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
++IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
++TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
++PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR
++CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
++EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
++PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
++PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
++LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
++NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
++SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</para>
++
++</legalnotice>
++
+Index: book/library-config.xml
+===================================================================
+--- book/library-config.xml	(révision 0)
++++ book/library-config.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<para>As with most libraries, there is no configuration to do, save that
++the library directory i.e. <userinput>/usr/lib</userinput> or
++<userinput>/usr/local/lib</userinput> should appear in
++<userinput>/etc/ld.so.conf</userinput> so that ldd can find the shared
++libraries.  After checking that this is the case,
++<userinput>/sbin/ldconfig</userinput> should be run whilst logged in as
++root.</para>
+Index: book/copyright.xml
+===================================================================
+--- book/copyright.xml	(révision 0)
++++ book/copyright.xml	(révision 3)
+@@ -0,0 +1,6 @@
++<copyright id="copyright">
++	<year>2001-2002</year>
++        <holder>BLFS Development Team</holder>
++
++</copyright>
++
+Index: book/book.xml
+===================================================================
+--- book/book.xml	(révision 0)
++++ book/book.xml	(révision 3)
+@@ -0,0 +1,24 @@
++&book-info;
++&book-dedication;
++&preface;
++
++<!-- Parts -->
++
++&introduction;
++&postlfs;
++&general;
++&connect;
++&basicnet;
++&server;
++&content;
++&x;
++&kde;
++&gnome;
++&xsoft;
++&multimedia;
++&pst;
++
++<!-- End parts -->
++
++<!-- Appendices -->
++&appendices;
+Index: book/authorgroup.xml
+===================================================================
+--- book/authorgroup.xml	(révision 0)
++++ book/authorgroup.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<authorgroup>
++
++<author>
++        <firstname>BLFS</firstname><surname>Development Team</surname>
++	
++</author>
++
++</authorgroup>
++
+Index: multimedia/multimedia.ent
+===================================================================
+--- multimedia/multimedia.ent	(révision 0)
++++ multimedia/multimedia.ent	(révision 3)
+@@ -0,0 +1,48 @@
++<!ENTITY multimedia SYSTEM "multimedia.xml">
++
++<!-- Libraries and drivers -->
++<!ENTITY multimedia-libdriv SYSTEM "libdriv/libdriv.xml">
++<!ENTITY % alsa SYSTEM "libdriv/alsa/alsa.ent">
++<!ENTITY % arts SYSTEM "libdriv/arts/arts.ent">
++<!ENTITY % audiofile SYSTEM "libdriv/audiofile/audiofile.ent">
++<!ENTITY % esound SYSTEM "libdriv/esound/esound.ent">
++<!ENTITY % sdl SYSTEM "libdriv/sdl/sdl.ent">
++<!ENTITY % libao SYSTEM "libdriv/libao/libao.ent">
++<!ENTITY % ogg SYSTEM "libdriv/ogg/ogg.ent">
++%alsa;
++%arts;
++%audiofile;
++%esound;
++%sdl;
++%libao;
++%ogg;
++
++<!-- Audio utilities -->
++<!ENTITY multimedia-audioutils SYSTEM "audioutils/audioutils.xml">
++<!ENTITY % mpg123 SYSTEM "audioutils/mpg123/mpg123.ent">
++<!ENTITY % vorbistools SYSTEM "audioutils/vorbistools/vorbistools.ent">
++<!ENTITY % xmms SYSTEM "audioutils/xmms/xmms.ent">
++<!ENTITY % lame SYSTEM "audioutils/lame/lame.ent">
++<!ENTITY % cdparanoia SYSTEM "audioutils/cdparanoia/cdparanoia.ent">
++%mpg123;
++%vorbistools;
++%xmms;
++%lame;
++%cdparanoia;
++
++<!-- Video utilities -->
++<!ENTITY multimedia-videoutils SYSTEM "videoutils/videoutils.xml">
++<!ENTITY % avifile SYSTEM "videoutils/avifile/avifile.ent">
++<!ENTITY % mplayer SYSTEM "videoutils/mplayer/mplayer.ent">
++<!ENTITY % xine SYSTEM "videoutils/xine/xine.ent">
++%avifile;
++%mplayer;
++%xine;
++
++<!-- CD Writing Utilities -->
++<!ENTITY multimedia-cdwriteutils SYSTEM "cdwriteutils/cdwriteutils.xml">
++<!ENTITY multimedia-cdwriteutils-kernel SYSTEM "cdwriteutils/kernel.xml">
++<!ENTITY % cdrtools SYSTEM "cdwriteutils/cdrtools/cdrtools.ent">
++<!ENTITY % cdrdao SYSTEM "cdwriteutils/cdrdao/cdrdao.ent">
++%cdrtools;
++%cdrdao;
+Index: multimedia/audioutils/CDParanoia.xml
+===================================================================
+--- multimedia/audioutils/CDParanoia.xml	(révision 0)
++++ multimedia/audioutils/CDParanoia.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="CDParanoia" xreflabel="CDParanoia-&CDParanoia-version;">
++<?dbhtml filename="cdparanoia.html" dir="multimedia"?>
++<title>CDParanoia-&CDParanoia-version;</title>
++
++&CDParanoia-intro;
++&CDParanoia-inst;
++&CDParanoia-config;
++&CDParanoia-desc;
++
++</sect1>
++
+Index: multimedia/audioutils/audioutils.xml
+===================================================================
+--- multimedia/audioutils/audioutils.xml	(révision 0)
++++ multimedia/audioutils/audioutils.xml	(révision 3)
+@@ -0,0 +1,20 @@
++<chapter id="multimedia-audioutils">
++<?dbhtml filename="audioutils.html" dir="multimedia"?>
++<title>Audio utilities</title>
++
++<para>This chapter contains programs involved with audio file
++manipulation; that is to say playing, recording, ripping and the other
++common things which people want to do.  To use much of this software,
++you will require either the kernel sound drivers installed, or <xref
++linkend="alsa"/> installed.  Note that in the 2.5 kernel development
++tree, the old drivers are being replaced with ALSA and so when the
++stable 2.6 series arrives; most people will be using it by
++default.</para>
++
++&mpg123;
++&vorbistools;
++&XMMS;
++&lame;
++&CDParanoia;
++
++</chapter>
+Index: multimedia/audioutils/cdparanoia/CDParanoia-inst.xml
+===================================================================
+--- multimedia/audioutils/cdparanoia/CDParanoia-inst.xml	(révision 0)
++++ multimedia/audioutils/cdparanoia/CDParanoia-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of CDParanoia</title>
++
++<para>Install CDParanoia by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make FLAGS="$CFLAGS" &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: multimedia/audioutils/cdparanoia/CDParanoia-desc.xml
+===================================================================
+--- multimedia/audioutils/cdparanoia/CDParanoia-desc.xml	(révision 0)
++++ multimedia/audioutils/cdparanoia/CDParanoia-desc.xml	(révision 3)
+@@ -0,0 +1,19 @@
++<sect2>
++<title>Contents</title>
++
++<para>The CDParanoia package contains <userinput>cdparanoia</userinput>
++and the <userinput>libcdda library</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>cdparanoia</title>
++<para>This is used for 'ripping' an audio-cd. Ripping is the process of 
++digitally extracting music from an audio-cd.</para></sect3>
++
++<sect3><title>libcdda library</title>
++<para>No description is currently available.</para></sect3>
++
++</sect2>
++
+Index: multimedia/audioutils/cdparanoia/CDParanoia-config.xml
+===================================================================
+--- multimedia/audioutils/cdparanoia/CDParanoia-config.xml	(révision 0)
++++ multimedia/audioutils/cdparanoia/CDParanoia-config.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Configuring CDParanoia</title>
++
++<sect3><title>Configuration Information</title>
++
++<para>CDParanoia itself needs little configuration; information can be
++found from the man-page.</para>
++
++<para>For the libcdda library, the usual rules apply:</para>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: multimedia/audioutils/cdparanoia/cdparanoia.ent
+===================================================================
+--- multimedia/audioutils/cdparanoia/cdparanoia.ent	(révision 0)
++++ multimedia/audioutils/cdparanoia/cdparanoia.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY CDParanoia SYSTEM "../CDParanoia.xml">
++<!ENTITY CDParanoia-intro SYSTEM "CDParanoia-intro.xml">
++<!ENTITY CDParanoia-inst SYSTEM "CDParanoia-inst.xml">
++<!ENTITY CDParanoia-desc SYSTEM "CDParanoia-desc.xml">
++<!ENTITY CDParanoia-config SYSTEM "CDParanoia-config.xml">
++<!ENTITY CDParanoia-buildsize "1.3 MB">
++<!ENTITY CDParanoia-version "III-9.8">
++<!ENTITY CDParanoia-download "http://www.xiph.org/paranoia/download/cdparanoia-III-alpha9.8.src.tgz">
++<!ENTITY CDParanoia-size "114 KB">
+Index: multimedia/audioutils/cdparanoia/CDParanoia-intro.xml
+===================================================================
+--- multimedia/audioutils/cdparanoia/CDParanoia-intro.xml	(révision 0)
++++ multimedia/audioutils/cdparanoia/CDParanoia-intro.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Introduction to CDParanoia</title>
++
++<screen>Download location:              &CDParanoia-download;
++Version used:                   &CDParanoia-version;
++Package size:                   &CDParanoia-size;
++Estimated Disk space required:  &CDParanoia-buildsize;</screen>
++
++<para>The CDParanoia package contains cdparanoia. This is useful for
++extracting wave files from audio cd's.  A CDDA capable CDROM drive is
++needed.  Practically all drives supported by Linux can be used.</para>
++
++</sect2>
+Index: multimedia/audioutils/XMMS.xml
+===================================================================
+--- multimedia/audioutils/XMMS.xml	(révision 0)
++++ multimedia/audioutils/XMMS.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="xmms" xreflabel="xmms-&XMMS-version">
++<?dbhtml filename="xmms.html" dir="multimedia"?>
++<title>xmms-&XMMS-version;</title>
++
++&XMMS-intro;
++&XMMS-inst;
++&XMMS-exp;
++&XMMS-config;
++&XMMS-desc;
++
++</sect1>
++
+Index: multimedia/audioutils/vorbistools.xml
+===================================================================
+--- multimedia/audioutils/vorbistools.xml	(révision 0)
++++ multimedia/audioutils/vorbistools.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect1 id="vorbistools" xreflabel="vorbistools-&vorbistools-version;">
++<?dbhtml filename="vorbistools.html" dir="multimedia"?>
++<title>vorbistools-&vorbistools-version;</title>
++
++&vorbistools-intro;
++&vorbistools-inst;
++&vorbistools-desc;
++
++</sect1>
++
+Index: multimedia/audioutils/xmms/XMMS-exp.xml
+===================================================================
+--- multimedia/audioutils/xmms/XMMS-exp.xml	(révision 0)
++++ multimedia/audioutils/xmms/XMMS-exp.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><screen><userinput>./configure --prefix=/usr \
++--enable-one-plugin-dir &&</userinput></screen>
++This command ensures that all plugins are located under
++/usr/lib/xmms/Plugins.</para>
++</sect2>
++
+Index: multimedia/audioutils/xmms/XMMS-inst.xml
+===================================================================
+--- multimedia/audioutils/xmms/XMMS-inst.xml	(révision 0)
++++ multimedia/audioutils/xmms/XMMS-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of XMMS</title>
++
++<para>Install XMMS by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr \
++--enable-one-plugin-dir &&</userinput>
++<userinput>make &&</userinput>
++<userinput>make install</userinput></screen></para>
++</sect2>
++
+Index: multimedia/audioutils/xmms/XMMS-desc.xml
+===================================================================
+--- multimedia/audioutils/xmms/XMMS-desc.xml	(révision 0)
++++ multimedia/audioutils/xmms/XMMS-desc.xml	(révision 3)
+@@ -0,0 +1,28 @@
++<sect2>
++<title>Contents</title>
++
++<para>The xmms package contains <userinput>xmms, xmms-config, gnomexmss, 
++wmxmms.</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>xmms</title>
++<para>XMMS, which stands for X Multimedia System, is a program comparable in
++function with WinAMP. It's main function is playing audio files like wav and
++mp3. It can be extended with plugins to play a number of other audio or video
++formats. It's look can be customized with WinAMP style skins.</para></sect3>
++
++<sect3><title>xmms-config</title>
++<para>This script is used by other programs which need to link with xmms to
++retrieve the library and include paths XMMS was compiled with. </para></sect3>
++
++<sect3><title>gnomexmms</title>
++<para>This is an applet for the GNOME desktop environment that will dock into
++the GNOME panel. From the applet you can start and control xmms.</para></sect3>
++
++<sect3><title>wmxmms</title>
++<para>wmxmms is a dock applet for the Window Maker window manager. From the 
++applet you ca start and control xmms.</para></sect3>
++</sect2>
+Index: multimedia/audioutils/xmms/XMMS-config.xml
+===================================================================
+--- multimedia/audioutils/xmms/XMMS-config.xml	(révision 0)
++++ multimedia/audioutils/xmms/XMMS-config.xml	(révision 3)
+@@ -0,0 +1,17 @@
++<sect2>
++<title>Configuring xmms</title>
++
++<sect3><title>Config files</title>
++<para><userinput>~/.xmms/config</userinput></para>
++</sect3>
++
++<sect3><title>Configuration Information</title>
++
++<para>When you start XMMS for the first time, you can configure it with 
++<userinput>CTRL+P</userinput> Note that you can extend XMMS' functionality
++with plugins and skins. You can find these at http://xmms.org. 
++</para>
++</sect3>
++
++</sect2>
++
+Index: multimedia/audioutils/xmms/xmms.ent
+===================================================================
+--- multimedia/audioutils/xmms/xmms.ent	(révision 0)
++++ multimedia/audioutils/xmms/xmms.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY XMMS SYSTEM "../XMMS.xml">
++<!ENTITY XMMS-intro SYSTEM "XMMS-intro.xml">
++<!ENTITY XMMS-inst SYSTEM "XMMS-inst.xml">
++<!ENTITY XMMS-exp SYSTEM "XMMS-exp.xml">
++<!ENTITY XMMS-desc SYSTEM "XMMS-desc.xml">
++<!ENTITY XMMS-config SYSTEM "XMMS-config.xml">
++<!ENTITY XMMS-buildsize "NOT KNOWN">
++<!ENTITY XMMS-version "1.2.7">
++<!ENTITY XMMS-download "ftp://ftp.xmms.org/xmms/1.2.x/xmms-1.2.7.tar.bz2">
++<!ENTITY XMMS-size "1.7 MB">
+Index: multimedia/audioutils/xmms/XMMS-intro.xml
+===================================================================
+--- multimedia/audioutils/xmms/XMMS-intro.xml	(révision 0)
++++ multimedia/audioutils/xmms/XMMS-intro.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Introduction to XMMS</title>
++
++<screen>Download location:              &XMMS-download;
++Version used:                   &XMMS-version;
++Package size:                   &XMMS-size;
++Estimated Disk space required:  &XMMS-buildsize;</screen>
++
++<para>XMMS is an audio player for the X Window System. </para>
++
++<screen>XMMS depends on:
++a working soundcard, x11, gtk, glib
++XMMS will utilize esd, gnome, libmikmod, libogg, libvorbis and libxml if
++installed prior to XMMS.</screen>
++</sect2>
+Index: multimedia/audioutils/vorbistools/vorbistools-intro.xml
+===================================================================
+--- multimedia/audioutils/vorbistools/vorbistools-intro.xml	(révision 0)
++++ multimedia/audioutils/vorbistools/vorbistools-intro.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Introduction to vorbis-tools</title>
++
++<screen>Download location:              &vorbistools-download;
++Version used:                   &vorbistools-version;
++Package size:                   &vorbistools-size;
++Estimated Disk space required:  &vorbistools-buildsize;</screen>
++
++<para>The vorbis-tools package contains command line tools for ogg audio
++files.  This is useful for encoding, playing or editing files using the ogg CODEX.</para>
++
++<screen>vorbis-tools depends on:
++<xref linkend="curl"/>, <xref linkend="libao"/>, <xref
++linkend="libogg"/> and <xref linkend="libvorbis"/></screen>
++
++</sect2>
+Index: multimedia/audioutils/vorbistools/vorbistools-inst.xml
+===================================================================
+--- multimedia/audioutils/vorbistools/vorbistools-inst.xml	(révision 0)
++++ multimedia/audioutils/vorbistools/vorbistools-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of vorbis-tools</title>
++
++<para>Install vorbis-tools by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install </userinput></screen></para>
++
++</sect2>
++
+Index: multimedia/audioutils/vorbistools/vorbistools-desc.xml
+===================================================================
+--- multimedia/audioutils/vorbistools/vorbistools-desc.xml	(révision 0)
++++ multimedia/audioutils/vorbistools/vorbistools-desc.xml	(révision 3)
+@@ -0,0 +1,32 @@
++<sect2>
++<title>Contents</title>
++
++<para>The vorbis-tools package contains <userinput>oggenc</userinput>,
++<userinput>ogg123</userinput>, <userinput>vcut</userinput> and
++<userinput>vorbiscomment</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>oggenc</title>
++<para>oggenc is the encoder that turns raw, WAV or AIFF files
++into an Ogg Vorbis stream.</para></sect3>
++
++<sect3><title>ogg123</title>
++<para>ogg123 is a commandline audio player for Ogg Vorbis streams.</para></sect3>
++
++<sect3><title>ogginfo</title>
++<para>ogginfo prints information stored in the audio
++file.</para></sect3>
++
++<sect3><title>vcut</title>
++<para>vcut will split a file into two files at a designated cut
++point.</para></sect3>
++
++<sect3><title>vorbiscomment</title>
++<para>vorbiscomment is an editor that changes information in the audio
++file metadata tags.</para></sect3>
++
++</sect2>
++
+Index: multimedia/audioutils/vorbistools/vorbistools.ent
+===================================================================
+--- multimedia/audioutils/vorbistools/vorbistools.ent	(révision 0)
++++ multimedia/audioutils/vorbistools/vorbistools.ent	(révision 3)
+@@ -0,0 +1,8 @@
++<!ENTITY vorbistools SYSTEM "../vorbistools.xml">
++<!ENTITY vorbistools-intro SYSTEM "vorbistools-intro.xml">
++<!ENTITY vorbistools-inst SYSTEM "vorbistools-inst.xml">
++<!ENTITY vorbistools-desc SYSTEM "vorbistools-desc.xml">
++<!ENTITY vorbistools-buildsize "2 MB">
++<!ENTITY vorbistools-version "1.0rc3">
++<!ENTITY vorbistools-download "http://www.vorbis.com/files/rc3/unix/vorbis-tools-1.0rc3.tar.gz">
++<!ENTITY vorbistools-size "260 KB">
+Index: multimedia/audioutils/mpg123.xml
+===================================================================
+--- multimedia/audioutils/mpg123.xml	(révision 0)
++++ multimedia/audioutils/mpg123.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="mpg123" xreflabel="mpg123-&mpg123-version;">
++<?dbhtml filename="mpg123.html" dir="multimedia"?>
++<title>mpg123-&mpg123-version;</title>
++
++&mpg123-intro;
++&mpg123-inst;
++&mpg123-exp;
++&mpg123-desc;
++
++</sect1>
++
+Index: multimedia/audioutils/mpg123/mpg123.ent
+===================================================================
+--- multimedia/audioutils/mpg123/mpg123.ent	(révision 0)
++++ multimedia/audioutils/mpg123/mpg123.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY mpg123 SYSTEM "../mpg123.xml">
++<!ENTITY mpg123-intro SYSTEM "mpg123-intro.xml">
++<!ENTITY mpg123-inst SYSTEM "mpg123-inst.xml">
++<!ENTITY mpg123-exp SYSTEM "mpg123-exp.xml">
++<!ENTITY mpg123-desc SYSTEM "mpg123-desc.xml">
++<!ENTITY mpg123-buildsize "1.3 MB">
++<!ENTITY mpg123-version "0.59r">
++<!ENTITY mpg123-download "http://www.mpg123.de/mpg123/mpg123-0.59r.tar.gz">
++<!ENTITY mpg123-size "155 KB">
+Index: multimedia/audioutils/mpg123/mpg123-intro.xml
+===================================================================
+--- multimedia/audioutils/mpg123/mpg123-intro.xml	(révision 0)
++++ multimedia/audioutils/mpg123/mpg123-intro.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Introduction to mpg123</title>
++
++<screen>Download location:              &mpg123-download;
++Version used:                   &mpg123-version;
++Package size:                   &mpg123-size;
++Estimated Disk space required:  &mpg123-buildsize;</screen>
++
++<para>The mpg123 package contains a console-based mp3-player. It claims to 
++be the fastest mp3-decoder for unix.</para>
++
++<screen>mpg123 depends on: <xref linkend="alsa"></xref> with 
++oss-compatibility.</screen>
++
++</sect2>
+Index: multimedia/audioutils/mpg123/mpg123-exp.xml
+===================================================================
+--- multimedia/audioutils/mpg123/mpg123-exp.xml	(révision 0)
++++ multimedia/audioutils/mpg123/mpg123-exp.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>make linux:</userinput> This command builds 
++mpg123 for linux.</para>
++<para><userinput>make linux-help:</userinput> This command lists 
++all build-options for mpg123.</para>
++<para><userinput>make install:</userinput> This command installs 
++mpg123 in /usr/local/bin</para>
++
++</sect2>
++
+Index: multimedia/audioutils/mpg123/mpg123-inst.xml
+===================================================================
+--- multimedia/audioutils/mpg123/mpg123-inst.xml	(révision 0)
++++ multimedia/audioutils/mpg123/mpg123-inst.xml	(révision 3)
+@@ -0,0 +1,19 @@
++<sect2>
++<title>Installation of mpg123</title>
++
++<para>Install mpg123 by running the following commands:</para>
++
++<para><screen><userinput>make PREFIX=/usr linux &&</userinput>
++<userinput>make PREFIX=/usr install</userinput></screen></para>
++
++<para>You can optimize the build of mpg123 for your processor. 
++To do this, type</para>
++<para><screen><userinput>make linux-help</userinput></screen></para>
++
++<para>and select the optimization appropriate for your machine.
++However, this may not always work.  There have been problems reported
++with using optimizations with mpg123; make PREFIX=/usr linux always
++seems to work.</para>
++
++</sect2>
++
+Index: multimedia/audioutils/mpg123/mpg123-desc.xml
+===================================================================
+--- multimedia/audioutils/mpg123/mpg123-desc.xml	(révision 0)
++++ multimedia/audioutils/mpg123/mpg123-desc.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Contents</title>
++
++<para>The mpg123 package contains <userinput>mpg123</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>mpg123</title>
++<para>mpg123 is used for playing mp3 files via the console.</para></sect3>
++
++</sect2>
++
+Index: multimedia/audioutils/lame.xml
+===================================================================
+--- multimedia/audioutils/lame.xml	(révision 0)
++++ multimedia/audioutils/lame.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="lame" xreflabel="lame">
++<?dbhtml filename="lame.html" dir="multimedia"?>
++<title>lame</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: multimedia/audioutils/lame/lame.ent
+===================================================================
+--- multimedia/audioutils/lame/lame.ent	(révision 0)
++++ multimedia/audioutils/lame/lame.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY lame SYSTEM "../lame.xml">
+Index: multimedia/cdwriteutils/cdrtools.xml
+===================================================================
+--- multimedia/cdwriteutils/cdrtools.xml	(révision 0)
++++ multimedia/cdwriteutils/cdrtools.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="cdrtools" xreflabel="cdrtools-&cdrtools-version;">
++<?dbhtml filename="cdrtools.html" dir="multimedia"?>
++<title>cdrtools-&cdrtools-version;</title>
++
++&cdrtools-intro;
++&cdrtools-inst;
++&cdrtools-exp;
++&cdrtools-desc;
++
++</sect1>
++
+Index: multimedia/cdwriteutils/cdrtools/cdrtools-inst.xml
+===================================================================
+--- multimedia/cdwriteutils/cdrtools/cdrtools-inst.xml	(révision 0)
++++ multimedia/cdwriteutils/cdrtools/cdrtools-inst.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect2>
++<title>Installation of cdrtools</title>
++
++<para>Install cdrtools by running the following commands:</para>
++
++<para><screen><userinput>make INS_BASE=/usr DEFINSUSR=root DEFINSGRP=root \
++   COPTS=$CFLAGS &&
++make INS_BASE=/usr DEFINSUSR=root DEFINSGRP=root \ 
++   COPTS=$CFLAGS install</userinput></screen></para>
++
++</sect2>
++
+Index: multimedia/cdwriteutils/cdrtools/cdrtools-desc.xml
+===================================================================
+--- multimedia/cdwriteutils/cdrtools/cdrtools-desc.xml	(révision 0)
++++ multimedia/cdwriteutils/cdrtools/cdrtools-desc.xml	(révision 3)
+@@ -0,0 +1,47 @@
++<sect2>
++<title>Contents</title>
++
++<para>The cdrtools package contains <userinput>cdrecord</userinput>,
++<userinput>cdda2wav</userinput>, <userinput>mkisofs</userinput>,
++<userinput>readcd</userinput>, <userinput>scgcheck</userinput>,
++<userinput>isoinfo</userinput>, <userinput>isodump</userinput>,
++<userinput>dsovfy</userinput>, <userinput>devdump</userinput>,
++<userinput>rscsi</userinput> and
++<userinput>support libraries</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>cdrecord</title>
++<para>cdrecord records audio or data Compact Discs.</para></sect3>
++
++<sect3><title>cdda2wav</title>
++<para>cdda2wav dumps Compact Disc audio into wav sound files.</para></sect3>
++
++<sect3><title>mkisofs</title>
++<para>mkisofs and mkhybrid generates an ISO9660/JOLIET/HFS hybrid
++filesystem.</para></sect3>
++
++<sect3><title>readcd</title>
++<para>readcd reads or writes Compact Discs.</para></sect3>
++
++<sect3><title>scgcheck</title>
++<para>scgcheck is used to check and verify the Application Binary
++Interface of libscg.</para></sect3>
++
++<sect3><title>support utilities</title>
++<para>isoinfo, isodump, isovfy and devdump are utility programs for
++dumping and verifying iso9660 images.</para></sect3>
++
++<sect3><title>rscsi</title>
++<para>rscsi is a remote scsi manager.</para></sect3>
++
++<sect3><title>support libraries</title>
++<para>libdeflt, libfile, libhfs, librscg, libscg, libschily and libunls
++are the support libraries for this package.</para></sect3>
++
++
++
++</sect2>
++
+Index: multimedia/cdwriteutils/cdrtools/cdrtools.ent
+===================================================================
+--- multimedia/cdwriteutils/cdrtools/cdrtools.ent	(révision 0)
++++ multimedia/cdwriteutils/cdrtools/cdrtools.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY cdrtools SYSTEM "../cdrtools.xml">
++<!ENTITY cdrtools-intro SYSTEM "cdrtools-intro.xml">
++<!ENTITY cdrtools-inst SYSTEM "cdrtools-inst.xml">
++<!ENTITY cdrtools-desc SYSTEM "cdrtools-desc.xml">
++<!ENTITY cdrtools-exp SYSTEM "cdrtools-exp.xml">
++<!ENTITY cdrtools-buildsize "12.3 MB">
++<!ENTITY cdrtools-version "1.10">
++<!ENTITY cdrtools-download "ftp://ftp.fokus.gmd.de/pub/unix/cdrecord/cdrtools-1.10.tar.gz">
++<!ENTITY cdrtools-size "1.27 MB">
+Index: multimedia/cdwriteutils/cdrtools/cdrtools-intro.xml
+===================================================================
+--- multimedia/cdwriteutils/cdrtools/cdrtools-intro.xml	(révision 0)
++++ multimedia/cdwriteutils/cdrtools/cdrtools-intro.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect2>
++<title>Introduction to cdrtools</title>
++
++<screen>Download location:              &cdrtools-download;
++Version used:                   &cdrtools-version;
++Package size:                   &cdrtools-size;
++Estimated Disk space required:  &cdrtools-buildsize;</screen>
++
++<para>The cdrtools package contains cdrecord and mkisofs. These are
++useful for reading, creating or writing (burning) Compact Discs.</para>
++
++</sect2>
+Index: multimedia/cdwriteutils/cdrtools/cdrtools-exp.xml
+===================================================================
+--- multimedia/cdwriteutils/cdrtools/cdrtools-exp.xml	(révision 0)
++++ multimedia/cdwriteutils/cdrtools/cdrtools-exp.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>INS_BASE=/usr :</userinput> This command moves the
++install directory from <filename class="directory"> /opt/schily
++</filename> to <filename class="directory"> /usr </filename>.</para>
++
++<para><userinput>DEFINSUSR=root DEFINSGRP=root :</userinput>These
++commands install all programs with root.root ownership instead of the default
++bin.bin.</para>
++
++</sect2>
++
+Index: multimedia/cdwriteutils/cdrdao.xml
+===================================================================
+--- multimedia/cdwriteutils/cdrdao.xml	(révision 0)
++++ multimedia/cdwriteutils/cdrdao.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect1 id="cdrdao" xreflabel="cdrdao-&cdrdao-version;">
++<?dbhtml filename="cdrdao.html" dir="multimedia"?>
++<title>cdrdao-&cdrdao-version;</title>
++
++&cdrdao-intro;
++&cdrdao-inst;
++&cdrdao-desc;
++
++</sect1>
++
+Index: multimedia/cdwriteutils/cdrdao/cdrdao.ent
+===================================================================
+--- multimedia/cdwriteutils/cdrdao/cdrdao.ent	(révision 0)
++++ multimedia/cdwriteutils/cdrdao/cdrdao.ent	(révision 3)
+@@ -0,0 +1,8 @@
++<!ENTITY cdrdao SYSTEM "../cdrdao.xml">
++<!ENTITY cdrdao-intro SYSTEM "cdrdao-intro.xml">
++<!ENTITY cdrdao-inst SYSTEM "cdrdao-inst.xml">
++<!ENTITY cdrdao-desc SYSTEM "cdrdao-desc.xml">
++<!ENTITY cdrdao-buildsize "15.9 MB">
++<!ENTITY cdrdao-version "1.1.5">
++<!ENTITY cdrdao-download "http://sourceforge.net/projects/cdrdao">
++<!ENTITY cdrdao-size "852 KB">
+Index: multimedia/cdwriteutils/cdrdao/cdrdao-intro.xml
+===================================================================
+--- multimedia/cdwriteutils/cdrdao/cdrdao-intro.xml	(révision 0)
++++ multimedia/cdwriteutils/cdrdao/cdrdao-intro.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Introduction to cdrdao</title>
++
++<screen>Download location:              <ulink url="&cdrdao-download;"/>
++Version used:                   &cdrdao-version;
++Package size:                   &cdrdao-size;
++Estimated Disk space required:  &cdrdao-buildsize;</screen>
++
++<para>The cdrdao package contains cdrdao. This is useful for burning
++a CD in disk-at-once mode.</para>
++
++<screen>cdrdao depends on:
++<xref linkend="pccts"/></screen>
++
++</sect2>
+Index: multimedia/cdwriteutils/cdrdao/cdrdao-inst.xml
+===================================================================
+--- multimedia/cdwriteutils/cdrdao/cdrdao-inst.xml	(révision 0)
++++ multimedia/cdwriteutils/cdrdao/cdrdao-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of cdrdao</title>
++
++<para>Install cdrdao by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install </userinput></screen></para>
++
++</sect2>
++
+Index: multimedia/cdwriteutils/cdrdao/cdrdao-desc.xml
+===================================================================
+--- multimedia/cdwriteutils/cdrdao/cdrdao-desc.xml	(révision 0)
++++ multimedia/cdwriteutils/cdrdao/cdrdao-desc.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Contents</title>
++
++<para>The cdrdao package contains <userinput>cdrdao</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>cdrdao</title>
++<para>cdrdao records audio or data CD-Rs in disk-at-once (DAO) mode
++based on a textual description of the CD contents.</para></sect3>
++
++</sect2>
++
+Index: multimedia/cdwriteutils/kernel.xml
+===================================================================
+--- multimedia/cdwriteutils/kernel.xml	(révision 0)
++++ multimedia/cdwriteutils/kernel.xml	(révision 3)
+@@ -0,0 +1,52 @@
++<sect1 id="kernel" xreflabel="kernel">
++<?dbhtml filename="kernel.html" dir="multimedia"?>
++<title>Configuring your kernel for CD-Writing</title>
++
++<para>In the kernel configuration, check your settings with those listed
++below for your CD-ROM interface type:</para>
++
++<para>SCSI CD-writer:</para>
++<screen>
++SCSI support menu
++  SCSI support:           Y or M
++  SCSI CD-ROM support:    Y or M
++  SCSI generic support:   Y or M
++  Vendor-specific extensions:  [1]
++Also include the low-level driver for your SCSI card if
++applicable.</screen>
++
++
++<para>IDE CD-writer:</para>
++<screen>
++ATA/IDE/MFM/RLL support menu
++  IDE/ATAPI CDROM support:     N
++  SCSI emulation support: Y or M
++SCSI support menu
++  SCSI support:           Y or M
++  SCSI CD-ROM support:    Y or M
++  SCSI generic support:   Y or M
++  Vendor-specific extensions:  [1]</screen>
++
++<para>[1] Read the help to determine if this selection is applicable for
++your hardware.</para>
++
++<para>If necessary, recompile the kernel with
++<screen>make dep &&
++make bzImage&&
++make modules &&
++make modules_install</screen>
++</para>
++<para>
++Copy <filename>/usr/src/linux/arch/i386/boot/bzImage</filename> and
++<filename>/usr/src/linux/System.map</filename> to
++<filename>/boot</filename>, edit <filename>/etc/lilo.conf</filename>
++appropriately and run <userinput>lilo</userinput>.
++</para>
++
++<para>For more information about these settings and the drivers they
++install, read <ulink
++url="http://www.tldp.org/HOWTO/SCSI-2.4-HOWTO/sr.html">The Linux 2.4
++SCSI subsystem HOWTO</ulink>.</para>
++
++</sect1>
++
+Index: multimedia/cdwriteutils/cdwriteutils.xml
+===================================================================
+--- multimedia/cdwriteutils/cdwriteutils.xml	(révision 0)
++++ multimedia/cdwriteutils/cdwriteutils.xml	(révision 3)
+@@ -0,0 +1,26 @@
++<chapter id="multimedia-cdwriteutils">
++<?dbhtml filename="cdwriteutils.html" dir="multimedia"?>
++<title>CD-Writing utilities</title>
++
++<para>This chapter contains information on CD-writing in Linux.  You
++will first have to configure your kernel for cd-writing.  We start by
++discussing how to do this, then discuss installing the actual utilities.</para>
++
++<para>Additional sources of information on CD-writing include:</para>
++
++<itemizedlist>
++
++<listitem><para><ulink
++url="http://www.tldp.org/HOWTO/CD-Writing-HOWTO.html">CD-Writing 
++HOWTO</ulink></para></listitem>
++
++<listitem><para><ulink url="http://www.cdrfaq.org">CD-Recordable
++FAQ</ulink></para></listitem>
++
++</itemizedlist>
++
++&multimedia-cdwriteutils-kernel;
++&cdrtools;
++&cdrdao;
++
++</chapter>
+Index: multimedia/videoutils/xine.xml
+===================================================================
+--- multimedia/videoutils/xine.xml	(révision 0)
++++ multimedia/videoutils/xine.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="xine" xreflabel="xine">
++<?dbhtml filename="xine.html" dir="multimedia"?>
++<title>xine</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: multimedia/videoutils/videoutils.xml
+===================================================================
+--- multimedia/videoutils/videoutils.xml	(révision 0)
++++ multimedia/videoutils/videoutils.xml	(révision 3)
+@@ -0,0 +1,9 @@
++<chapter id="multimedia-videoutils">
++<?dbhtml filename="videoutils.html" dir="multimedia"?>
++<title>Video utilities</title>
++
++&avifile;
++&mplayer;
++&xine;
++
++</chapter>
+Index: multimedia/videoutils/mplayer.xml
+===================================================================
+--- multimedia/videoutils/mplayer.xml	(révision 0)
++++ multimedia/videoutils/mplayer.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="mplayer" xreflabel="mplayer">
++<?dbhtml filename="mplayer.html" dir="multimedia"?>
++<title>mplayer</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: multimedia/videoutils/mplayer/mplayer.ent
+===================================================================
+--- multimedia/videoutils/mplayer/mplayer.ent	(révision 0)
++++ multimedia/videoutils/mplayer/mplayer.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY mplayer SYSTEM "../mplayer.xml">
+Index: multimedia/videoutils/avifile.xml
+===================================================================
+--- multimedia/videoutils/avifile.xml	(révision 0)
++++ multimedia/videoutils/avifile.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="avifile" xreflabel="avifile">
++<?dbhtml filename="avifile.html" dir="multimedia"?>
++<title>avifile</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: multimedia/videoutils/avifile/avifile.ent
+===================================================================
+--- multimedia/videoutils/avifile/avifile.ent	(révision 0)
++++ multimedia/videoutils/avifile/avifile.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY avifile SYSTEM "../avifile.xml">
+Index: multimedia/multimedia.xml
+===================================================================
+--- multimedia/multimedia.xml	(révision 0)
++++ multimedia/multimedia.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<part id="multimedia" xreflabel="multimedia">
++<?dbhtml filename="multimedia.html" dir="multimedia"?>
++<title>Multimedia</title>
++
++&multimedia-libdriv;
++&multimedia-audioutils;
++&multimedia-videoutils;
++&multimedia-cdwriteutils;
++
++</part>
+Index: multimedia/libdriv/esound.xml
+===================================================================
+--- multimedia/libdriv/esound.xml	(révision 0)
++++ multimedia/libdriv/esound.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="esound" xreflabel="esound">
++<?dbhtml filename="esound.html" dir="multimedia"?>
++<title>esound</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
++
+Index: multimedia/libdriv/esound/esound.ent
+===================================================================
+--- multimedia/libdriv/esound/esound.ent	(révision 0)
++++ multimedia/libdriv/esound/esound.ent	(révision 3)
+@@ -0,0 +1 @@
++<!ENTITY esound SYSTEM "../esound.xml">
+Index: multimedia/libdriv/alsa.xml
+===================================================================
+--- multimedia/libdriv/alsa.xml	(révision 0)
++++ multimedia/libdriv/alsa.xml	(révision 3)
+@@ -0,0 +1,38 @@
++<sect1 id="alsa" xreflabel="alsa-&alsa-version;">
++<?dbhtml filename="alsa.html" dir="multimedia"?>
++<title>alsa-&alsa-version;</title>
++
++<para>The first question which people tend to ask about ALSA is why they
++should use it over the sound drivers included in the kernel - there are
++several reasons.  Firstly, the ALSA drivers support more sound cards
++than those in the kernel.  Secondly, the OSS emulation is in some cases
++faster and better than the original OSS driver itself.  And finally, there are
++some programs which can use ALSA's enhanced features to better drive the
++soundcard.</para>
++
++<para>ALSA is also likely to be the future of Linux Sound (hence the
++name <emphasis>Advanced Linux Sound Architecture</emphasis>), and the
++ALSA drivers will probably be included into the main linux kernel at
++some point during the 2.5 development series, leading eventually to ALSA
++being the "standard" sound drivers into the future 2.6 stable
++kernel.</para>
++
++<para>You currently need to decide whether to use the 0.5.x series or
++the 0.9-beta series.  At the moment, if you use the 0.9.x drivers, some
++older software will fail to compile with ALSA support.  This is because
++there is a new API in the 0.9.x series which isn't yet widely supported.
++In these cases it is usually possible just to use the OSS driver
++emulation which ALSA supplies (which can be superior to the OSS drivers
++themselves).  We don't recommend one ALSA series over the other
++as there are advantages to both versions, however you should probably
++use the latest point release of whichever series you decide to
++use.</para>
++
++&alsa-intro;
++&alsa-desc;
++&alsa-inst;
++&alsa-config;
++&alsa-cards;
++
++</sect1>
++
+Index: multimedia/libdriv/alsa/alsa-intro.xml
+===================================================================
+--- multimedia/libdriv/alsa/alsa-intro.xml	(révision 0)
++++ multimedia/libdriv/alsa/alsa-intro.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Introduction to alsa</title>
++
++<screen>Download location:              &alsa-download;
++Version used:                   &alsa-version;
++Package size:                   &alsa-size;
++Estimated Disk space required:  &alsa-buildsize;</screen>
++
++<para>The alsa packages contains a sound driver collection for
++the most known sound cards, a library for easy sound programming
++and some little utilities.</para>
++
++</sect2>
+Index: multimedia/libdriv/alsa/alsa-cards.xml
+===================================================================
+--- multimedia/libdriv/alsa/alsa-cards.xml	(révision 0)
++++ multimedia/libdriv/alsa/alsa-cards.xml	(révision 3)
+@@ -0,0 +1,23 @@
++<sect2>
++<title>Soundcards supported by alsa</title>
++
++<para>try "cat /proc/pci | grep audio" and look for the PCI ID:</para>
++
++<screen>PCI-ID          Name                            Driver
++EMU10k1         Soundblaster SB Live! (or else) emu10k1
++10b9:5451       ALi 5451 Onboard                ali5451
++ES1371          Ensoniq 1371 (Soundblaster)     ens1371
++ES1370          Ensoniq 1370 (Soundblaster)     ens1370
++ES1983S         ESS Maestro 3                   es1983
++VIA             VIA AC97 Audio Controller 686A  via686a 
++ES1986          ESS Maestro 2                   es1986
++Vortex 2        Aureal Vortex II                ???
++ALS4000         Avance Logic ALS 4000           als4000</screen>
++
++<para>For further cards look at CARDS-Status (0.9.x-version) or
++the doc/CARDS file (older Version). Please send an email to
++l.x. at gmx.de about what you'd got on "cat /proc/pci | grep audio" and
++what driver you used. If that Appendix grows big enough, I'll
++use it for an automatic installation script.</para>
++
++</sect2>
+Index: multimedia/libdriv/alsa/alsa-exp.xml
+===================================================================
+--- multimedia/libdriv/alsa/alsa-exp.xml	(révision 0)
++++ multimedia/libdriv/alsa/alsa-exp.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1>
++<title>Command explanations</title>
++
++<para><userinput>COMMAND:</userinput> This command does something.</para>
++
++</sect1>
++
+Index: multimedia/libdriv/alsa/alsa-inst.xml
+===================================================================
+--- multimedia/libdriv/alsa/alsa-inst.xml	(révision 0)
++++ multimedia/libdriv/alsa/alsa-inst.xml	(révision 3)
+@@ -0,0 +1,189 @@
++<sect2>
++<title>Installation of alsa</title>
++
++<para>Unpack the packages you've downloaded</para>
++
++<sect3>
++<title>Installation of the driver</title>
++
++<para><screen><userinput>./configure \
++    --with-moddir=/lib/modules/<kernel-version>/kernel/drivers/sound/ \
++	--with-kernel=<path-to-kernel-source-tree-to-build-for> \
++	--with-sequencer=yes --with-oss=yes \
++	--with-cards=<soundcards-to-compile> &&
++make &&
++make install </userinput></screen></para>
++
++<para>Replace <path-to-kernel-source-tree-to-build-for> and
++<kernel-version> with which the path to the source tree of the 
++kernel version you want to build the drivers for (most commonly your 
++current version) and the kernel version number respectively.  You also
++need to replace <soundcards-to-compile> with the card names 
++you need drivers for (read the SOUNDCARDS section below); otherwise 
++"./configure --help" gives you a list of
++drivers you can compile.</para>
++
++<para>There are two ways of setting up the modules. The easiest
++way is the "let the kernel module loader load them automatically"-way, 
++the other one is to use the bootscript you'll find in the
++/utils-directory of the driver.</para>
++
++<para>For both ways, you need to add some lines to /etc/modules.conf:</para>
++
++<para><screen><userinput>cat >> /etc/modules.conf << "EOF"</userinput>
++alias char-major-116 snd
++options snd snd_major=116 snd_cards_limit=1
++alias snd-card-0 snd-card-<soundcard>
++alias sound-slot-0 snd-card-0
++alias sound-service-0-0 snd-mixer-oss
++alias sound-service-0-3 snd-pcm-oss
++post-install snd-card-<soundcard> /usr/sbin/alsactl restore
++<userinput>EOF</userinput></screen></para>
++
++<para>Remember to replace <soundcard> with whatever is 
++appropriate.  Note that if you are going to use the LFS-style alsa
++script we give below, there is no need for the post-install line.</para>
++
++<para>If you want kmod to automatically load the modules, as long as you
++have the post-install line in modules.conf, you don't need a startup
++script.  If on the other hand you want to use an LFS style startup
++script (because you want to perform other operations at startup/shutdown
++or for another reason), you can use this script here:</para>
++
++<para><screen><userinput>cat > /etc/rc.d/init.d/alsa << "EOF"</userinput>
++#!/bin/sh
++# Begin $rc_base/init.d/alsa
++
++# Based on sysklogd script from LFS-3.1 and earlier.
++# Rewritten by Gerard Beekmans  - gerard at linuxfromscratch.org
++# ALSA specific parts by Mark Hymers - markh at linuxfromscratch.org
++
++source /etc/sysconfig/rc
++source $rc_functions
++
++if [ -f /etc/sysconfig/alsa ]
++then
++	source /etc/sysconfig/alsa
++fi
++
++if [ -z "$CONF" ] 
++then
++	echo "Please create an /etc/sysconfig/alsa file containing"
++	echo "a CONF value (usually /etc/asound.conf)"
++	exit 1;
++fi
++
++case "$1" in
++	start)
++		echo -n "Starting alsa...    Restoring volumes..."
++		loadproc /usr/sbin/alsactl -f $CONF restore
++		#echo -n "                    Loading MIDI font..."
++		#loadproc sfxload $FONT
++		;;
++
++	stop)
++		echo -n "Stopping alsa...    Saving volumes......"
++		loadproc /usr/sbin/alsactl -f $CONF store
++		#echo -n "            Removing MIDI font.........."
++		#loadproc sfxload -i
++		;;
++
++	restart)
++		$0 stop
++		/usr/bin/sleep 1
++		$0 start
++		;;
++	
++	*)
++		echo "Usage: $0 {start|stop|restart}"
++		exit 1
++		;;
++
++esac
++
++# End $rc_base/init.d/alsa
++<userinput>EOF
++chmod 755 /etc/rc.d/init.d/alsa</userinput></screen></para>
++
++<para>Note that the Loading and Removing MIDI font lines are commented out.
++This is because they are only needed for certain soundcards and also
++require an additional program (<userinput>sfxload</userinput>).  An
++example of a soundcard which needs MIDI fonts loaded in order to play
++MIDI files is the Soundblaster Live! which is based on a emu10k1
++chip.</para>
++
++<para>If you are using the above script, you will also need 
++a <filename>/etc/sysconfig/alsa</filename> file.  Create this using
++the following commands:</para>
++
++<para><screen><userinput>cat > /etc/sysconfig/alsa << "EOF"</userinput>
++# Begin /etc/sysconfig/alsa
++
++# CONF is where you want the system to store volume settings.
++# /etc/asound.conf is recommended
++CONF=/etc/asound.conf
++
++# FONT is where your midi font (if any) is stored.
++FONT=/usr/share/8mbgmsfx.sf2
++
++# End /etc/sysconfig/alsa
++<userinput>EOF</userinput></screen></para>
++
++<para>Then create the appropriate symlinks:
++<screen><userinput>cd /etc/rc.d/init.d &&
++ln -sf ../init.d/alsa ../rc0.d/K35alsa &&
++ln -sf ../init.d/alsa ../rc1.d/K35alsa &&
++ln -sf ../init.d/alsa ../rc2.d/S40alsa &&
++ln -sf ../init.d/alsa ../rc3.d/S40alsa &&
++ln -sf ../init.d/alsa ../rc4.d/S40alsa &&
++ln -sf ../init.d/alsa ../rc5.d/S40alsa &&
++ln -sf ../init.d/alsa ../rc6.d/K35alsa</userinput></screen></para>
++
++<para>Beware. All channels of your soundcard are muted by default. You can use
++the <filename>alsamixer</filename> (in alsa-utils, requires alsa-lib) or any 
++other OSS mixer program (like kmix, gmix, aumix) to unmute them.  We
++recommend that you do this <emphasis>before</emphasis> running the
++script above because otherwise alsactl will complain that it cannot read
++the <filename>/etc/asound.conf</filename> file.  You can do this by 
++running <userinput>alsamixer</userinput>, setting the volumes and then
++running <userinput>alsactl -f /etc/asound.conf store</userinput>.  This
++means that the first time you run the script, it will have a valid
++<filename>asound.conf</filename> file to use.</para>
++
++<para>If you get an error like
++<screen>alsamixer: failed to open mixer #0/#0: No such file or directory</screen>
++run the snddevices script in the alsa-driver directory.  From the
++alsa-driver source directory run:</para>
++
++<para><screen><userinput>./snddevices</userinput></screen></para>
++</sect3>
++
++<sect3>
++<title>Installation of the library</title>
++<para>From the alsa-lib source directory, run:</para>
++<para><screen><userinput>./configure &&
++make install</userinput></screen></para>
++</sect3>
++
++<sect3>
++<title>Installation of the utils</title>
++<para>From the alsa-utils source directory, run:</para>
++<para><screen><userinput>./configure &&
++make install</userinput></screen></para>
++</sect3>
++
++<sect3>
++<title>Installation of additional packages (alsa-oss-lib and alsa-tools)</title>
++
++<para><screen><userinput>./configure &&
++make install</userinput></screen></para>
++
++<para>These commands are all you need to install 
++alsa-oss-lib or alsa-tools.  Remember oss-lib is only for future 
++versions and the alsa-tools are only useful for the owners of very old 
++or expensive cards (e.g multichannel cards), so most people 
++don't need it.</para>
++
++</sect3>
++</sect2>
++
+Index: multimedia/libdriv/alsa/alsa-desc.xml
+===================================================================
+--- multimedia/libdriv/alsa/alsa-desc.xml	(révision 0)
++++ multimedia/libdriv/alsa/alsa-desc.xml	(révision 3)
+@@ -0,0 +1,24 @@
++<sect2>
++<title>Contents</title>
++
++<para>There are 5 different alsa-packages:</para>
++
++<para>The alsa-driver package contains the driver module sources.</para>
++
++<para>The alsa-lib package contains a Library for sound access methods
++provided by the alsa-driver.</para>
++
++<para>The alsa-utils package contains the tools 
++<userinput>alsamixer</userinput>, a ncurses based console mixer,
++<userinput>alsactl</userinput>, a control program for the driver,
++<userinput>aplay</userinput>, a simple player for .wav and .au files,
++and <userinput>arecord</userinput>, a simple sound recorder.
++</para>
++
++<para>The alsa-oss-lib package (only version 0.9.x) contains a library
++for developers to convert their OSS applications to ALSA.</para>
++
++<para>The alsa-tools package (only version 0.9.x) contains some utlis
++for older cards and for expensive multichannel cards.</para>
++
++</sect2>
+Index: multimedia/libdriv/alsa/alsa-config.xml
+===================================================================
+--- multimedia/libdriv/alsa/alsa-config.xml	(révision 0)
++++ multimedia/libdriv/alsa/alsa-config.xml	(révision 3)
+@@ -0,0 +1,32 @@
++<sect2>
++<title>Configuring alsa</title>
++
++<sect3><title>/dev/sndstat</title>
++
++<para>There is software out there to look at /dev/sndstat to find out wether a
++sound driver is installed. If you have such software sniggering at you
++"no soundcard found", try the following (before giving up):</para>
++
++<para><screen><userinput>rm /dev/sndstat
++ln -s /proc/asound/sndstat /dev/sndstat</userinput></screen></para>
++
++</sect3>
++
++<sect3>
++<title>Device permissions</title>
++
++<para>If the software is complaining about having no access to the 
++devices with your current UID, you need to set the proper permissions
++(as root):</para>
++
++<para><userinput>chmod a+rw /dev/mi* /dev/dsp* /dev/seq*</userinput>
++This should do the job.</para>
++
++<para>Alternatively, add your user to the <userinput>audio</userinput>
++group and make sure the above <filename>/dev</filename> files are 
++chgrp'd to the audio group and have group read and write access.</para>
++
++</sect3>
++
++</sect2>
++
+Index: multimedia/libdriv/alsa/alsa.ent
+===================================================================
+--- multimedia/libdriv/alsa/alsa.ent	(révision 0)
++++ multimedia/libdriv/alsa/alsa.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY alsa SYSTEM "../alsa.xml">
++<!ENTITY alsa-intro SYSTEM "alsa-intro.xml">
++<!ENTITY alsa-inst SYSTEM "alsa-inst.xml">
++<!ENTITY alsa-desc SYSTEM "alsa-desc.xml">
++<!ENTITY alsa-config SYSTEM "alsa-config.xml">
++<!ENTITY alsa-cards SYSTEM "alsa-cards.xml">
++<!ENTITY alsa-buildsize "4-6MB (depending on chosen drivers)">
++<!ENTITY alsa-version "0.5.12a/0.9.0rc2">
++<!ENTITY alsa-download "http://www.alsa-project.org">
++<!ENTITY alsa-size "400-600k (depending on version)">
+Index: multimedia/libdriv/audiofile.xml
+===================================================================
+--- multimedia/libdriv/audiofile.xml	(révision 0)
++++ multimedia/libdriv/audiofile.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect1 id="audiofile" xreflabel="audiofile-&audiofile-version;">
++<?dbhtml filename="audiofile.html" dir="multimedia"?>
++<title>audiofile-&audiofile-version;</title>
++
++&audiofile-intro;
++&audiofile-inst;
++&audiofile-config;
++&audiofile-desc;
++
++</sect1>
+Index: multimedia/libdriv/SDL.xml
+===================================================================
+--- multimedia/libdriv/SDL.xml	(révision 0)
++++ multimedia/libdriv/SDL.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="SDL" xreflabel="SDL-&SDL-version;">
++<?dbhtml filename="sdl.html" dir="multimedia"?>
++<title>SDL-&SDL-version;</title>
++
++&SDL-intro;
++&SDL-inst;
++&SDL-exp;
++&SDL-config;
++&SDL-desc;
++
++</sect1>
++
+Index: multimedia/libdriv/audiofile/audiofile-intro.xml
+===================================================================
+--- multimedia/libdriv/audiofile/audiofile-intro.xml	(révision 0)
++++ multimedia/libdriv/audiofile/audiofile-intro.xml	(révision 3)
+@@ -0,0 +1,13 @@
++<sect2>
++<title>Introduction to audiofile</title>
++
++<screen>Download location:              &audiofile-download;
++Version used:                   &audiofile-version;
++Package size:                   &audiofile-size;
++Estimated Disk space required:  &audiofile-buildsize;</screen>
++
++<para>The audiofile package contains the audiofile libraries and two
++sound file support programs. These are useful to support basic sound
++file formats.</para>
++
++</sect2>
+Index: multimedia/libdriv/audiofile/audiofile-inst.xml
+===================================================================
+--- multimedia/libdriv/audiofile/audiofile-inst.xml	(révision 0)
++++ multimedia/libdriv/audiofile/audiofile-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of audiofile</title>
++
++<para>Install audiofile by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: multimedia/libdriv/audiofile/audiofile-desc.xml
+===================================================================
+--- multimedia/libdriv/audiofile/audiofile-desc.xml	(révision 0)
++++ multimedia/libdriv/audiofile/audiofile-desc.xml	(révision 3)
+@@ -0,0 +1,30 @@
++<sect2>
++<title>Contents</title>
++
++<para>The audiofile package contains <userinput>audiofile
++libraries</userinput>,
++<userinput>audiofile-config</userinput>, <userinput>sfinfo
++</userinput>and <userinput>sfconvert</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>audiofile libraries</title>
++<para>The audiofile library is used by programs to support AIFF,
++AIFF-compressed, SUN/NeXT, WAVE and BICS audio formats </para></sect3>
++
++<sect3><title>audiofile-config</title>
++<para>The audiofile-config script is used during the compile process by
++programs linking to this library. </para></sect3>
++
++<sect3><title>sfinfo</title>
++<para>The sfinfo program displays the sound file format, audio encoding, 
++sampling rate and duration for audio formats supported by this library.</para></sect3>
++
++<sect3><title>sfconvert</title>
++<para>The sfconvert program converts sound file formats where the
++origional format and destination format are supported by this library.</para></sect3>
++
++</sect2>
++
+Index: multimedia/libdriv/audiofile/audiofile-config.xml
+===================================================================
+--- multimedia/libdriv/audiofile/audiofile-config.xml	(révision 0)
++++ multimedia/libdriv/audiofile/audiofile-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring audiofile</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: multimedia/libdriv/audiofile/audiofile.ent
+===================================================================
+--- multimedia/libdriv/audiofile/audiofile.ent	(révision 0)
++++ multimedia/libdriv/audiofile/audiofile.ent	(révision 3)
+@@ -0,0 +1,9 @@
++<!ENTITY audiofile SYSTEM "../audiofile.xml">
++<!ENTITY audiofile-intro SYSTEM "audiofile-intro.xml">
++<!ENTITY audiofile-inst SYSTEM "audiofile-inst.xml">
++<!ENTITY audiofile-desc SYSTEM "audiofile-desc.xml">
++<!ENTITY audiofile-config SYSTEM "audiofile-config.xml">
++<!ENTITY audiofile-buildsize "17 MB">
++<!ENTITY audiofile-version "0.2.3">
++<!ENTITY audiofile-download "ftp://ftp.68k.org/pub/michael/audiofile-0.2.3.tar.gz">
++<!ENTITY audiofile-size "332 KB">
+Index: multimedia/libdriv/libogg.xml
+===================================================================
+--- multimedia/libdriv/libogg.xml	(révision 0)
++++ multimedia/libdriv/libogg.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect1 id="libogg" xreflabel="libogg-&libogg-version;">
++<?dbhtml filename="libogg.html" dir="multimedia"?>
++<title>libogg-&libogg-version;</title>
++
++&libogg-intro;
++&libogg-inst;
++&libogg-config;
++&libogg-desc;
++
++</sect1>
++
+Index: multimedia/libdriv/sdl/SDL-config.xml
+===================================================================
+--- multimedia/libdriv/sdl/SDL-config.xml	(révision 0)
++++ multimedia/libdriv/sdl/SDL-config.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Configuring SDL</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++
++</sect3>
++
++</sect2>
++
+Index: multimedia/libdriv/sdl/sdl.ent
+===================================================================
+--- multimedia/libdriv/sdl/sdl.ent	(révision 0)
++++ multimedia/libdriv/sdl/sdl.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY SDL SYSTEM "../SDL.xml">
++<!ENTITY SDL-intro SYSTEM "SDL-intro.xml">
++<!ENTITY SDL-inst SYSTEM "SDL-inst.xml">
++<!ENTITY SDL-exp SYSTEM "SDL-exp.xml">
++<!ENTITY SDL-desc SYSTEM "SDL-desc.xml">
++<!ENTITY SDL-config SYSTEM "SDL-config.xml">
++<!ENTITY SDL-buildsize "12 MB">
++<!ENTITY SDL-version "1.2.4">
++<!ENTITY SDL-download "http://www.libsdl.org/release/SDL-1.2.4.tar.gz">
++<!ENTITY SDL-size "1.7 MB">
+Index: multimedia/libdriv/sdl/SDL-intro.xml
+===================================================================
+--- multimedia/libdriv/sdl/SDL-intro.xml	(révision 0)
++++ multimedia/libdriv/sdl/SDL-intro.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Introduction to SDL</title>
++
++<screen>Download location:              &SDL-download;
++Version used:                   &SDL-version;
++Package size:                   &SDL-size;
++Estimated Disk space required:  &SDL-buildsize;</screen>
++
++<para>The Simple DirectMedia Layer (SDL for short) is a cross-platform library
++designed to make it easy to write multimedia software, such as games and
++emulators.</para>
++
++<screen>SDL will utilize oss, alsa, esd, arts, nas, nasm, x11 and directfb by
++default if installed prior to SDL. </screen>
++
++</sect2>
+Index: multimedia/libdriv/sdl/SDL-exp.xml
+===================================================================
+--- multimedia/libdriv/sdl/SDL-exp.xml	(révision 0)
++++ multimedia/libdriv/sdl/SDL-exp.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><screen><userinput>./configure --prefix=/usr --disable-debug </userinput>
++</screen>This command configures SDL to build with aggressive
++optimizations.</para>
++</sect2>
++
+Index: multimedia/libdriv/sdl/SDL-inst.xml
+===================================================================
+--- multimedia/libdriv/sdl/SDL-inst.xml	(révision 0)
++++ multimedia/libdriv/sdl/SDL-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of SDL</title>
++
++<para>Install SDL by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr --disable-debug &&</userinput>
++<userinput>make &&</userinput>
++<userinput>make install</userinput></screen></para>
++
++</sect2>
++
+Index: multimedia/libdriv/sdl/SDL-desc.xml
+===================================================================
+--- multimedia/libdriv/sdl/SDL-desc.xml	(révision 0)
++++ multimedia/libdriv/sdl/SDL-desc.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect2>
++<title>Contents</title>
++
++<para>The SDL package contains the <userinput>Simple DirectMedia 
++Layer</userinput></para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>Simple DirectMedia Layer</title>
++<para>The Simple DirectMedia Layer is a generic API that provides low level
++access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL, and 
++2D framebuffer across multiple platforms.</para></sect3>
++
++</sect2>
+Index: multimedia/libdriv/libao.xml
+===================================================================
+--- multimedia/libdriv/libao.xml	(révision 0)
++++ multimedia/libdriv/libao.xml	(révision 3)
+@@ -0,0 +1,12 @@
++<sect1 id="libao" xreflabel="libao-&libao-version;">
++<?dbhtml filename="libao.html" dir="multimedia"?>
++<title>libao-&libao-version;</title>
++
++&libao-intro;
++&libao-inst;
++&libao-exp;
++&libao-config;
++&libao-desc;
++
++</sect1>
++
+Index: multimedia/libdriv/libao/libao-config.xml
+===================================================================
+--- multimedia/libdriv/libao/libao-config.xml	(révision 0)
++++ multimedia/libdriv/libao/libao-config.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect2>
++<title>Configuring libao</title>
++
++<sect3><title>Configuration Information</title>
++
++&library-config;
++</sect3>
++
++</sect2>
++
+Index: multimedia/libdriv/libao/libao.ent
+===================================================================
+--- multimedia/libdriv/libao/libao.ent	(révision 0)
++++ multimedia/libdriv/libao/libao.ent	(révision 3)
+@@ -0,0 +1,10 @@
++<!ENTITY libao SYSTEM "../libao.xml">
++<!ENTITY libao-intro SYSTEM "libao-intro.xml">
++<!ENTITY libao-inst SYSTEM "libao-inst.xml">
++<!ENTITY libao-exp SYSTEM "libao-exp.xml">
++<!ENTITY libao-desc SYSTEM "libao-desc.xml">
++<!ENTITY libao-config SYSTEM "libao-config.xml">
++<!ENTITY libao-buildsize "1.9 MB">
++<!ENTITY libao-version "0.8.2">
++<!ENTITY libao-download "http://www.vorbis.com/files/rc3/unix/libao-0.8.2.tar.gz">
++<!ENTITY libao-size "202 KB">
+Index: multimedia/libdriv/libao/libao-intro.xml
+===================================================================
+--- multimedia/libdriv/libao/libao-intro.xml	(révision 0)
++++ multimedia/libdriv/libao/libao-intro.xml	(révision 3)
+@@ -0,0 +1,14 @@
++<sect2>
++<title>Introduction to libao</title>
++
++<screen>Download location:              &libao-download;
++Version used:                   &libao-version;
++Package size:                   &libao-size;
++Estimated Disk space required:  &libao-buildsize;</screen>
++
++<para>The libao package contains a cross-platform audio library. This is
++useful to output audio on a wide variety of platforms.  It currently
++supports WAV files, OSS (Open Sound System), ESD (Enlighten Sound
++Daemon) and ALSA (Advanced Linux Sound Architecture).</para>
++
++</sect2>
+Index: multimedia/libdriv/libao/libao-exp.xml
+===================================================================
+--- multimedia/libdriv/libao/libao-exp.xml	(révision 0)
++++ multimedia/libdriv/libao/libao-exp.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect2>
++<title>Command explanations</title>
++
++<para><userinput>make CC="gcc $CFLAGS" :</userinput> This makes libao
++compile using our CFLAGS for optimizations.</para>
++
++</sect2>
++
+Index: multimedia/libdriv/libao/libao-inst.xml
+===================================================================
+--- multimedia/libdriv/libao/libao-inst.xml	(révision 0)
++++ multimedia/libdriv/libao/libao-inst.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2>
++<title>Installation of libao</title>
++
++<para>Install libao by running the following commands:</para>
++
++<para><screen><userinput>./configure --prefix=/usr &&
++make CC="gcc $CFLAGS" &&
++make install</userinput></screen></para>
++
++</sect2>
++
+Index: multimedia/libdriv/libao/libao-desc.xml
+===================================================================
+--- multimedia/libdriv/libao/libao-desc.xml	(révision 0)
++++ multimedia/libdriv/libao/libao-desc.xml	(révision 3)
+@@ -0,0 +1,15 @@
++<sect2>
++<title>Contents</title>
++
++<para>The libao package contains <userinput>ao libraries</userinput>.</para>
++
++</sect2>
++
++<sect2><title>Description</title>
++
++<sect3><title>ao libraries</title>
++<para>libao provides functions for programs wishing to output sound over
++supported platforms.</para></sect3>
++
++</sect2>
++
+Index: multimedia/libdriv/arts.xml
+===================================================================
+--- multimedia/libdriv/arts.xml	(révision 0)
++++ multimedia/libdriv/arts.xml	(révision 3)
+@@ -0,0 +1,73 @@
++<sect1 id="arts" xreflabel="arts-&arts-version;">
++<?dbhtml filename="arts.html" dir="multimedia"?>
++<title>aRts-&arts-version;</title>
++
++<para><screen>Estimated build disk space:  35 MB
++Estimated installed space:  5.7 MB
++Package size:                &arts-size;
++Estimated build time:        11 min (667 MHz)</screen></para>
++
++<para>The Analog Realtime Synthesizer (aRts) provides sound support for KDE.  
++It provides necessary libraries for kdelibs.  It will use the 
++following optional packages, if installed:
++<screen><xref linkend="alsa"/>, <xref linkend="audiofile"/>, <xref linkend="libvorbis"/>, 
++and <xref linkend="objprelink"/>.</screen></para>
++
++<para>
++<screen><userinput>./configure --prefix=&kde-dir;  --enable-objprelink \
++     --disable-debug --disable-dependency-tracking &&
++make &&
++make install &&
++ln -sf &kde-dir; /opt/kde</userinput></screen></para>
++
++<note><para>Another configure option is <userinput>--enable-final</userinput>. 
++This option can speed up the build process, but requires a lot of memory.  If
++you have less than 256MB of RAM, this option will cause swapping and 
++significantly slow compilation. This option applies to all the 
++kde packages.</para></note>
++
++<sect2><title>aRts Installation Commmand explanations</title>
++<para><userinput>--prefix=&kde-dir;:</userinput> This option tells the
++process to install the package in &kde-dir;.</para>
++
++<warning><para>
++<filename>objprelink</filename> has been known to cause problems on some 
++systems.  If it does not work on your system you will have to rebuild kde 
++without it.</para></warning>
++
++<para><userinput>--enable-objprelink:</userinput> This option enables
++the linking process to optimize executable loading times by prelinking 
++many internal references.
++</para>
++
++<para><userinput>--disable-debug:</userinput> This option causes the
++system to be compiled without debugging code.
++</para>
++
++<para><userinput>--disable-dependency-tracking:</userinput> This option speeds
++up one time builds.
++</para>
++
++<para><userinput>ln -s &kde-dir; /opt/kde:</userinput> This command creates
++a link for access to KDE.  If a newer version of KDE is released, the new
++system can be built by changing the <userinput>--prefix</userinput> location
++and then set up by just changing the link.
++</para>
++
++</sect2>
++
++<sect2><title>Configuring aRts</title>
++<para>The library directory <filename class="directory">/opt/kde/lib</filename> 
++should appear in <filename>/etc/ld.so.conf</filename> 
++so that ldd can find the shared libraries. The following command will add it 
++if it is missing:
++<screen><userinput>cat >> /etc/ld.so.conf << "EOF"</userinput>
++# Begin kde addition to /etc/ld.so.conf
++
++/opt/kde/lib
++
++# End kde addition
++<userinput>EOF
++ldconfig</userinput></screen></para>
++</sect2>
++</sect1>
+Index: multimedia/libdriv/libdriv.xml
+===================================================================
+--- multimedia/libdriv/libdriv.xml	(révision 0)
++++ multimedia/libdriv/libdriv.xml	(révision 3)
+@@ -0,0 +1,20 @@
++<chapter id="multimedia-libdriv">
++<?dbhtml filename="libdriv.html" dir="multimedia"?>
++<title>Multimedia Libraries and Drivers</title>
++
++<para>Many multimedia programs require libraries and/or drivers in order 
++to function properly.  The packages in this section fall into this category.
++Generally you only need to install these if you are installing a program
++which has the library listed as either a requirement, or as an option to
++enable it to support certain functionality.</para>
++
++&alsa;
++&arts;
++&audiofile;
++&esound;
++&SDL;
++&libao;
++&libogg;
++&libvorbis;
++
++</chapter>
+Index: multimedia/libdriv/libvorbis.xml
+===================================================================
+--- multimedia/libdriv/libvorbis.xml	(révision 0)
++++ multimedia/libdriv/libvorbis.xml	(révision 3)
+@@ -0,0 +1,10 @@
++<sect1 id="libvorbis" xreflabel="libvorbis-&libvorbis-version;">
++<?dbhtml filename="libvorbis.html" dir="multimedia"?>
++<title>libvorbis-&libvorbis-version;</title>
++
++&libvorbis-intro;
++&libvorbis-inst;
++&libvorbis-config;
++&libvorbis-desc;
++
++</sect1>
+Index: postlfs/config/bootdisk.xml
+===================================================================
+--- postlfs/config/bootdisk.xml	(révision 0)
++++ postlfs/config/bootdisk.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="postlfs-config-bootdisk">
++<?dbhtml filename="bootdisk.html" dir="postlfs"?>
++<title>Creating a custom bootdisk</title>
++
++<para>How to create a decent bootdisk</para>
++
++</sect1>
++
+Index: postlfs/config/logon.xml
+===================================================================
+--- postlfs/config/logon.xml	(révision 0)
++++ postlfs/config/logon.xml	(révision 3)
+@@ -0,0 +1,53 @@
++<sect1 id="postlfs-config-logon">
++<?dbhtml filename="logon.html" dir="postlfs"?>
++<title>Customising your logon (/etc/issue)</title>
++
++<para>When you first boot up your new LFS system, the logon screen will
++be nice and plain (as it should be in a bare-bones system).  Many people
++however, will want their system to display some information in the logon
++message.  This can be accomplished using the 
++file <filename>/etc/issue</filename>.</para>
++
++<para>The <filename>/etc/issue</filename> file is a plain text file
++which will also accept certain Escape sequences (see below) in order to
++insert information about the system.  There is also the file
++<filename>issue.net</filename> which can be used when logging on remotely.  
++SSH however, will only use it if you set the option in the 
++configuration file and will also <emphasis>not</emphasis> interpret the 
++escape sequences as shown below.</para>
++
++<para>One of the most common things which people want to do is to clear
++the screen at each logon.  The easiest way of doing that is to put a
++"clear" escape into /etc/issue.  A simple way of doing this is to do
++<userinput>clear > /etc/issue</userinput>.  This will insert the
++relevant escape code into the start of the
++<filename>/etc/issue</filename> file.  Note that if you do this, when
++you edit the file, you should leave the ^[c character on the first line
++alone.</para>
++
++<para>The following escapes are recognised by agetty (the program which
++usually parses <filename>/etc/issue</filename>).  This information is from
++<userinput>man agetty</userinput> where you can find extra information
++about the logon process.</para>
++
++<para>The issue-file can contain certain escape codes to display various
++information.  All escape codes consist of a backslash (\) immediately followed 
++by one of the letters explained below (so \d in
++<filename>/etc/issue</filename> would insert the current date).</para>
++
++<para><screen>b   Insert the baudrate of the current line.
++d   Insert the current date.
++s   Insert the system name, the name of the operating system.
++l   Insert the name of the current tty line.
++m   Insert the architecture identifier of the machine, eg. i486
++n   Insert the nodename of the machine, also known as the hostname.
++o   Insert the domainname of the machine.
++r   Insert the release number of the kernel, eg. 2.4.16.
++t   Insert the current time.
++u   Insert the number of current users logged in.
++U   Insert the string "1 user" or "<n> users" where <n> is the
++    number of current users logged in.
++v   Insert the version of the OS, eg. the build-date etc.</screen></para>
++
++</sect1>
++
+Index: postlfs/config/profile.xml
+===================================================================
+--- postlfs/config/profile.xml	(révision 0)
++++ postlfs/config/profile.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="postlfs-config-profile">
++<?dbhtml filename="profile.html" dir="postlfs"?>
++<title>/etc/profile and ~/.bash_*</title>
++
++<para>NEW PAGE TO BE WRITTEN</para>
++
++</sect1>
++
+Index: postlfs/config/random.xml
+===================================================================
+--- postlfs/config/random.xml	(révision 0)
++++ postlfs/config/random.xml	(révision 3)
+@@ -0,0 +1,68 @@
++<sect1 id="postlfs-config-random" xreflabel="random">
++<?dbhtml filename="random.html" dir="postlfs"?>
++<title>Random number generation</title>
++
++<para>The Linux kernel supplies a random number generator which is accessed
++through <filename>/dev/random</filename> and 
++<filename>/dev/urandom</filename>.  Programs that utilize the random and
++urandom devices, such as OpenSSH, will benefit from these instructions.</para>
++
++<para>When a Linux system starts up without much operator interaction, the
++entropy pool, data used to compute a random number, may be in a fairly
++predictable state.  This creates the real possibility that the number generated
++at startup may always be the same.  In order to counteract this effect,
++you should carry the entropy pool information across your shut-downs and
++start-ups. The following init.d script and links will perform this function
++for you automatically.</para>
++
++<para><screen><userinput>cat > /etc/rc.d/init.d/random << "EOF"
++</userinput>
++#!/bin/sh
++# Begin $rc_base/init.d/random
++
++# Based on sysklogd script from LFS-3.1 and earlier.
++# Rewritten by Gerard Beekmans  - gerard at linuxfromscratch.org
++# Random script elements by Larry Lawrence
++
++source /etc/sysconfig/rc
++source $rc_functions
++
++case "$1" in
++        start)
++                echo "Initializing kernel random number generator..."
++                if [ -f /var/tmp/random-seed ]; then
++	                cat /var/tmp/random-seed >/dev/urandom
++		fi
++		dd if=/dev/urandom of=/var/tmp/random-seed count=1 &>/dev/null
++		evaluate_retval
++		;;
++		
++	stop)
++		echo "Saving random seed..."
++		dd if=/dev/urandom of=/var/tmp/random-seed count=1 &>/dev/null
++		evaluate_retval
++		;;
++
++        *)
++                echo "Usage: $0 {start|stop}"
++                exit 1
++                ;;
++esac
++
++# End $rc_base/init.d/random
++<userinput>EOF
++chmod 755 /etc/rc.d/init.d/random</userinput></screen></para>
++
++<para>Create the symbolic links to this file in the relevant rc.d directories 
++with the following commands:
++<screen><userinput>cd /etc/rc.d/init.d &&
++ln -sf ../init.d/random ../rc0.d/K45random &&
++ln -sf ../init.d/random ../rc2.d/S25random &&
++ln -sf ../init.d/random ../rc3.d/S25random &&
++ln -sf ../init.d/random ../rc4.d/S25random &&
++ln -sf ../init.d/random ../rc5.d/S25random &&
++ln -sf ../init.d/random ../rc6.d/K45random</userinput></screen></para>
++
++
++</sect1>
++
+Index: postlfs/config/vimrc.xml
+===================================================================
+--- postlfs/config/vimrc.xml	(révision 0)
++++ postlfs/config/vimrc.xml	(révision 3)
+@@ -0,0 +1,92 @@
++<sect1 id="postlfs-config-vimrc">
++<?dbhtml filename="vimrc.html" dir="postlfs"?>
++<title>/etc/vimrc, ~/.vimrc</title>
++
++<para>The LFS book installs vim as its editor.  At this point we should
++state that there are a <emphasis>lot</emphasis> of different editors out
++there including emacs, nano, joe and many more.  Anyone who has been
++around the Internet (especially usenet) for a short time will certainly
++have observed at least one flame war, usually involving vim and emacs
++users!</para>
++
++<para>The LFS book gives a basic <filename>vimrc</filename> file.  Here,
++we attempt to enhance this file.  At startup, vim reads
++<filename>/etc/vimrc</filename> and <filename>~/.vimrc</filename>
++(i.e., the global vimrc and the user-specific one.).  Note that this is
++only true if you compiled vim using LFS-3.1 onwards.  Prior to this,
++the global vimrc was <filename>/usr/share/vim/vimrc</filename>.</para>
++
++<para>Here is an example of a slightly expanded vimrc:</para>
++
++<para><screen>" Begin .vimrc
++
++set nocompatible
++set bs=2
++set columns=80
++set background=dark
++set tabstop=8
++set wrapmargin=8
++set nobk
++syntax on
++set ruler
++set noexpandtab
++
++" End .vimrc</screen></para>
++
++<para>A FAQ on the lfs lists regards the comment tags in vimrc.  Note
++that they are " instead of the more usual # or //.  This is correct, the
++syntax for vimrc is slightly unusual.</para>
++
++<para>We'll run through a quick explanation of what each of the
++options in this example file means here:</para>
++<itemizedlist>
++<listitem><para><userinput>set nocompatible :</userinput>
++This option stops vim from behaving in a strongly vi-compatible way.  It
++should be at the start of any vimrc file as it can affect lots of other
++options which you may want to override.</para></listitem>
++
++<listitem><para><userinput>set bs=2 :</userinput>
++This influences the behaviour of the backspace option.  It is fairly
++complex so see <userinput>:help 'bs'</userinput> for more 
++details.</para></listitem>
++
++<listitem><para><userinput>set columns=80 :</userinput>
++This simply sets the number of columns used on the 
++screen.</para></listitem>
++
++<listitem><para><userinput>set background=dark :</userinput>
++This tells vim to use colours which look good on a dark 
++background.</para></listitem>
++
++<listitem><para><userinput>set tabstop=8 :</userinput>
++The number of spaces which a tabstop takes.</para></listitem>
++
++<listitem><para><userinput>set wrapmargin=8 :</userinput>
++This is the number of characters from the right window 
++border where wrapping starts.</para></listitem>
++
++<listitem><para><userinput>set nobk :</userinput>
++This stops vim from creating a backup before 
++overwriting a file.</para></listitem>
++
++<listitem><para><userinput>syntax on :</userinput>
++Enables vim's syntax highlighting.</para></listitem>
++
++<listitem><para><userinput>set ruler :</userinput>
++This makes vim show the current row and column at the bottom right of
++the screen.</para></listitem>
++
++<listitem><para><userinput>set noexpandtab :</userinput>
++This makes vim insert tabs as tab characters instead of as a set of
++spaces.</para></listitem>
++
++</itemizedlist>
++
++<para>More information on the <emphasis>many</emphasis> vim options 
++can be found by reading the help inside vim itself.  Do this by typing
++<userinput>:help</userinput> in vim to get the general help, or by
++typing <userinput>:help usr_toc.txt</userinput> to view the User Manual
++Table of Contents.</para>
++
++</sect1>
++
+Index: postlfs/config/inputrc.xml
+===================================================================
+--- postlfs/config/inputrc.xml	(révision 0)
++++ postlfs/config/inputrc.xml	(révision 3)
+@@ -0,0 +1,58 @@
++<sect1 id="postlfs-config-inputrc">
++<?dbhtml filename="inputrc.html" dir="postlfs"?>
++<title>/etc/inputrc</title>
++
++<para>There are a number of configuration files that are common to all
++linux system.  Inputrc deals with the mapping of the keybord in ceratin 
++situations.  This file is the start-up file used by readline - the input 
++related library used by bash and most other shells.  By changing this file 
++you can change how certain keys act in different situations.  The following 
++is a simple inputrc along with comments to explain what the various 
++options do.</para>
++
++<para>The following file can be used as
++<filename>/etc/inputrc</filename> or <filename>~/.inputrc</filename> as
++appropriate.  See below for more details on which to use.</para>
++
++<para><screen># Make sure we dont output everything on the 1 line
++set horizontal-scroll-mode Off
++
++set meta-flag On      # Enables 8 bit input
++set input-meta On     # Enables 8 bit input
++set convert-meta Off  # Turns off 8th bit stripping
++set output-meta On    # Keep the 8th bit for display
++set bell-style none   # none,visable or audible
++
++# All of the following map the escape sequence of the 
++# value contained inside the 1st argument to the 
++# readline specific functions
++
++"\eOd": backward-word
++"\eOc": forward-word
++
++# for linux console
++"\e[1~": beginning-of-line
++"\e[4~": end-of-line
++"\e[5~": beginning-of-history
++"\e[6~": end-of-history
++"\e[3~": delete-char
++"\e[2~": quoted-insert
++
++# for xterm
++"\eOH": beginning-of-line
++"\eOF": end-of-line</screen></para>
++
++<para>Please see man 3 readline for more infomation.  There is a lot that 
++can be done with this single rc file.</para>
++
++<para>Note that the readline library checks ~/.inputrc, by default.  If
++you want to use <filename>/etc/inputrc</filename> as your global
++inputrc (i.e. for all users), you will need to add the line 
++<userinput>export INPUTRC=/etc/inputrc</userinput> to your
++.bash_profile, .bashrc or .profile file as appropriate.</para>
++
++<para>If you want to use per-user <userinput>.inputrc</userinput> files.
++You can create one and drop it into <filename>/etc/skel</filename> for use 
++when creating new users.</para>
++
++</sect1>
+Index: postlfs/config/config.xml
+===================================================================
+--- postlfs/config/config.xml	(révision 0)
++++ postlfs/config/config.xml	(révision 3)
+@@ -0,0 +1,29 @@
++<chapter id="postlfs-config">
++<?dbhtml filename="config.html" dir="postlfs"?>
++<title>After LFS Configuration Issues</title>
++
++<para>The intention of LFS is to provide a basic system which you can
++build upon.  There are several things which many people wonder about to
++do with tidying up their system once they have done the base install.
++We hope to cover these issues in this chapter.</para>
++
++<para>Most people coming from a Windows background to Linux find the
++concept of text-only configuration files slightly strange.  In Linux,
++just about all configuration is done via text files.  The majority of
++these files can be found in the <filename>/etc</filename> hierarchy.
++There are often graphical configuration programs available for different
++subsystems but these are mostly simply pretty frontends to the process
++of editing the file.  The advantage of text-only configuration is that
++you can edit parameters using your favourite text editor, whether that
++be vim, emacs or anything else.</para>
++
++&postlfs-config-logon;
++&postlfs-config-profile;
++&postlfs-config-inputrc;
++&postlfs-config-random;
++&postlfs-config-vimrc;
++&postlfs-config-bootdisk;
++&postlfs-config-manpages;
++
++</chapter>
++
+Index: postlfs/config/manpages.xml
+===================================================================
+--- postlfs/config/manpages.xml	(révision 0)
++++ postlfs/config/manpages.xml	(révision 3)
+@@ -0,0 +1,8 @@
++<sect1 id="postlfs-config-manpages">
++<?dbhtml filename="manpages.html" dir="postlfs"?>
++<title>Man page issues</title>
++
++<para>NEW PAGE TO BE WRITTEN</para>
++
++</sect1>
++
+Index: postlfs/filesystems/filesystems.xml
+===================================================================
+--- postlfs/filesystems/filesystems.xml	(révision 0)
++++ postlfs/filesystems/filesystems.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<chapter id="postlfs-filesystems">
++<?dbhtml filename="filesystems.html" dir="postlfs"?>
++<title>Filesystems</title>
++
++<para>Intro goes here.</para>
++
++&postlfs-filesystems-ext3;
++&postlfs-filesystems-reiser;
++&postlfs-filesystems-xfs;
++
++</chapter>
+Index: postlfs/filesystems/reiser.xml
+===================================================================
+--- postlfs/filesystems/reiser.xml	(révision 0)
++++ postlfs/filesystems/reiser.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="postlfs-filesystems-reiser">
++<?dbhtml filename="reiser.html" dir="postlfs"?>
++<title>reiserfs</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: postlfs/filesystems/xfs.xml
+===================================================================
+--- postlfs/filesystems/xfs.xml	(révision 0)
++++ postlfs/filesystems/xfs.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="postlfs-filesystems-xfs">
++<?dbhtml filename="xfs.html" dir="postlfs"?>
++<title>XFS</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: postlfs/filesystems/ext3.xml
+===================================================================
+--- postlfs/filesystems/ext3.xml	(révision 0)
++++ postlfs/filesystems/ext3.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="postlfs-filesystems-ext3">
++<?dbhtml filename="ext3.html" dir="postlfs"?>
++<title>Ext3</title>
++
++<para>TO BE DONE</para>
++
++</sect1>
+Index: postlfs/security/pam.xml
+===================================================================
+--- postlfs/security/pam.xml	(révision 0)
++++ postlfs/security/pam.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="postlfs-security-pam">
++<?dbhtml filename="pam.html" dir="postlfs"?>
++<title>pam</title>
++
++<para>TO BE WRITTEN - NEW</para>
++
++</sect1>
+Index: postlfs/security/nessus.xml
+===================================================================
+--- postlfs/security/nessus.xml	(révision 0)
++++ postlfs/security/nessus.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="postlfs-security-nessus">
++<?dbhtml filename="nessus.html" dir="postlfs"?>
++<title>nessus</title>
++
++<para>TO BE WRITTEN - NEW</para>
++
++</sect1>
+Index: postlfs/security/syslog.xml
+===================================================================
+--- postlfs/security/syslog.xml	(révision 0)
++++ postlfs/security/syslog.xml	(révision 3)
+@@ -0,0 +1,7 @@
++<sect1 id="postlfs-security-syslog">
++<?dbhtml filename="syslog.html" dir="postlfs"?>
++<title>Configuring syslog</title>
++
++<para>TO BE WRITTEN - NEW</para>
++
++</sect1>
+Index: postlfs/security/firewalling.xml
+===================================================================
+--- postlfs/security/firewalling.xml	(révision 0)
++++ postlfs/security/firewalling.xml	(révision 3)
+@@ -0,0 +1,17 @@
++<sect1 id="postlfs-security-fw-firewall" xreflabel="Firewalling">
++<?dbhtml filename="firewall.html" dir="postlfs"?>
++<title>Setting up a network firewall</title>
++
++<para>Before you read this part of the chapter, note that we assume that
++you have already installed iptables as described in the previous
++section.</para>
++
++&postlfs-security-fw-intro;
++&postlfs-security-fw-disclaimer;
++&postlfs-security-fw-kernel;
++&postlfs-security-fw-writing;
++&postlfs-security-fw-finale;
++&postlfs-security-fw-extrainfo;
++
++</sect1>
++
+Index: postlfs/security/iptables.xml
+===================================================================
+--- postlfs/security/iptables.xml	(révision 0)
++++ postlfs/security/iptables.xml	(révision 3)
+@@ -0,0 +1,16 @@
++<sect1 id="postlfs-security-iptables">
++<?dbhtml filename="iptables.html" dir="postlfs"?>
++<title>Installing iptables-&iptables-version;</title>
++
++<para>The next part of this chapter deals with firewalling.  The
++principle firewalling tool for Linux, as of the 2.4 kernel series, is
++iptables.  It replaces ipchains from the 2.2 series and ipfwadm from the
++2.0 series. You will need to install iptables if you intend on
++using any form of firewalling.</para>
++
++&iptables-intro;
++&iptables-inst;
++&iptables-exp;
++&iptables-desc;
++
++</sect1>
+Index: postlfs/security/firewalling/finale.xml
+===================================================================
+--- postlfs/security/firewalling/finale.xml	(révision 0)
++++ postlfs/security/firewalling/finale.xml	(révision 3)
+@@ -0,0 +1,23 @@
++<sect2 id="postlfs-security-fw-finale" xreflabel="Conclusion">
++<title>Editor's Note</title>
++
++<para>Finally, I'd like to remind you of one fact we must not forget:
++The effort spent attacking a system corresponds to the value the cracker
++expects to gain from it.
++If you are responsible for such valuable assets that you expect great
++effort to be made by potential crackers, you hopefully won't be in the 
++need of this hint!</para>
++
++<para><literallayout>Be cautious!
++
++    Henning Rohde
++<email>Henning.Rohde at uni-bayreuth.de</email></literallayout></para>
++
++<para>PS: And always do remember:
++SecureIT is not a matter of a status-quo but one of never stopping 
++to take care!</para>
++
++<para>PPS: If any of these scripts fail, please tell me. I will try to trace 
++any faults.</para>
++
++</sect2>
+Index: postlfs/security/firewalling/extrainfo.xml
+===================================================================
+--- postlfs/security/firewalling/extrainfo.xml	(révision 0)
++++ postlfs/security/firewalling/extrainfo.xml	(révision 3)
+@@ -0,0 +1,11 @@
++<sect2 id="postlfs-security-fw-extra" xreflabel="Extra Information">
++<title>Extra Information</title>
++
++&postlfs-security-fw-library;
++
++&postlfs-security-fw-status;
++
++&postlfs-security-fw-stop;
++
++</sect2>
++
+Index: postlfs/security/firewalling/kernel.xml
+===================================================================
+--- postlfs/security/firewalling/kernel.xml	(révision 0)
++++ postlfs/security/firewalling/kernel.xml	(révision 3)
+@@ -0,0 +1,120 @@
++<sect2 id="postlfs-security-fw-kernel" xreflabel="getting a firewalling-enabled Kernel">
++<title>Getting a firewalling-enabled Kernel</title>
++
++<para>If you want your Linux-Box to do firewalling you must first ensure 
++that your kernel has been compiled with the relevant options turned on
++<footnote><para>If you needed assistance howto configure, compile and install 
++a new kernel, refer back to chapter VIII of the LinuxFromScratch book, 
++<ulink url="http://www.linuxfromscratch.org/view/3.1/chapter08/kernel.html">Installing a kernel</ulink>
++ and eventually 
++<ulink url="http://www.linuxfromscratch.org/view/3.1/chapter08/lilo.html">Making the LFS system bootable</ulink>
++; note, that you'll need to reboot 
++to actually run your new kernel.</para></footnote>.</para>
++
++<para>How to configure your kernel, with enabling the options to be 
++either compiled into the kernel or as modules, depends on your personal 
++preferences and experience. Note, that for the quoted scripts it is assumed 
++that the modules need to be loaded at first.</para>
++
++<table frame='none'>
++<title>Essential config-options for a firewalling-enabled Kernel</title>
++
++<tgroup cols='5'>
++<colspec colnum='1' colwidth='8*'  align='center'/>
++<colspec colnum='2' colwidth='19*' align='left'/>
++<colspec colnum='3' colwidth='11*' align='center'/>
++<colspec colnum='4' colwidth='1*'  align='center'/>
++<colspec colnum='5' colwidth='14*' align='left'/>
++
++<tbody>
++
++<row>
++<entry><emphasis><userinput>Networking options:</userinput></emphasis></entry>
++<entry><userinput>Network packet filtering</userinput></entry>
++<entry></entry>
++<entry>=</entry>
++<entry>CONFIG_NETFILTER</entry>
++</row>
++
++<row>
++<entry></entry>
++<entry><userinput>Unix domain sockets</userinput></entry>
++<entry></entry>
++<entry>=</entry>
++<entry>CONFIG_UNIX</entry>
++</row>
++
++<row>
++<entry></entry>
++<entry><userinput>IP: TCP/IP networking</userinput></entry>
++<entry></entry>
++<entry>=</entry>
++<entry>CONFIG_INET</entry>
++</row>
++
++<row>
++<entry></entry>
++<entry><userinput>IP: advanced router</userinput></entry>
++<entry></entry>
++<entry>=</entry>
++<entry>CONFIG_IP_ADVANCED_ROUTER</entry>
++</row>
++
++<row>
++<entry></entry>
++<entry><userinput>IP: verbose route monitoring</userinput></entry>
++<entry></entry>
++<entry>=</entry>
++<entry>CONFIG_IP_ROUTE_VERBOSE</entry>
++</row>
++
++<row>
++<entry></entry>
++<entry><userinput>IP: TCP Explicit Congestion Notification support</userinput></entry>
++<entry></entry>
++<entry>=</entry>
++<entry>CONFIG_INET_ECN</entry>
++</row>
++
++<row>
++<entry></entry>
++<entry><userinput>IP: TCP syncookie support</userinput></entry>
++<entry></entry>
++<entry>=</entry>
++<entry>CONFIG_SYN_COOKIES</entry>
++</row>
++
++<row>
++<entry></entry>
++<entry align='center'>
++<emphasis><userinput>IP: Netfilter Configuration:</userinput></emphasis></entry>
++<entry align='left'><userinput>every option</userinput></entry>
++<entry>=</entry>
++<entry>CONFIG_IP_NF_*</entry>
++</row>
++
++<row>
++<entry></entry>
++<entry align='right'><emphasis>WITHOUT:</emphasis></entry>
++<entry align='left'><literallayout><userinput>ipchains (2.2-style) support
++ipfw-adm (2.0-style) support</userinput></literallayout></entry>
++<entry>w\</entry>
++<entry>CONFIG_IP_NF_COMPAT_*</entry>
++</row>
++
++<row>
++<entry></entry>
++<entry><userinput>Fast switching</userinput></entry>
++<entry>Make sure to disable it because it would setup a bypass around
++your firewalling-rules.</entry>
++<entry>w\</entry>
++<entry>CONFIG_NET_FASTROUTE</entry>
++</row>
++
++</tbody>
++
++</tgroup>
++
++</table>
++
++</sect2>
+Index: postlfs/security/firewalling/masqrouter.xml
+===================================================================
+--- postlfs/security/firewalling/masqrouter.xml	(révision 0)
++++ postlfs/security/firewalling/masqrouter.xml	(révision 3)
+@@ -0,0 +1,100 @@
++<sect3 id="postlfs-security-fw-masqRouter" xreflabel="Masquerading Router">
++<title>Masquerading Router</title>
++
++<para>A true Firewall has two interfaces, one connected to an intranet,
++in this example, eth0, and one connected to the internet, here, ppp0. 
++To provide the maximum security against the box itself being broken into,
++make sure that there are no servers running on it, especially not X11 et
++al.  And, as a general principle, the box itself should not access any untrusted
++service<footnote><para>Th
\ No newline at end of file




More information about the lfs-traducfr mailing list