Index: basicnet/basicnet.ent
===================================================================
--- basicnet/basicnet.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/basicnet.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/basicnet.xml
===================================================================
--- basicnet/basicnet.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/basicnet.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/djb/daemontools-man.xml
===================================================================
--- basicnet/djb/daemontools-man.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools-man.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/daemontools.xml
===================================================================
--- basicnet/djb/daemontools.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-desc.xml
===================================================================
--- basicnet/djb/daemontools/daemontools-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools/daemontools-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-exp.xml
===================================================================
--- basicnet/djb/daemontools/daemontools-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools/daemontools-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &gt; 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 &gt; svscanboot~</userinput>
+<userinput>sed 's|/service|/etc/service|g' svscanboot~ &gt; 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 &gt; /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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools/daemontools-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &amp;&amp; 
+package/compile &amp;&amp;
+cd package &amp;&amp; 
+sed 's|command|usr/sbin|' boot.inittab &gt; boot.inittab~ &amp;&amp; 
+mv boot.inittab~ boot.inittab &amp;&amp;
+cd ../command &amp;&amp;
+sed 's|/command:/usr/local/bin:/usr/local/sbin:||' svscanboot &gt; svscanboot~ &amp;&amp;
+sed 's|/service|/etc/service|g' svscanboot~ &gt; svscanboot &amp;&amp; 
+rm svscanboot~ &amp;&amp; 
+cp * /usr/sbin &amp;&amp;
+cd ../package &amp;&amp; 
+cat /etc/inittab boot.inittab &gt; /etc/inittab~ &amp;&amp; 
+mv -f /etc/inittab~ /etc/inittab &amp;&amp; 
+telinit Q &amp;&amp;
+mkdir /etc/service</userinput></screen></para>
+</sect2>
+
Index: basicnet/djb/daemontools/daemontools-intro.xml
===================================================================
--- basicnet/djb/daemontools/daemontools-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools/daemontools-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-man-desc.xml
===================================================================
--- basicnet/djb/daemontools/daemontools-man-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools/daemontools-man-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-man-exp.xml
===================================================================
--- basicnet/djb/daemontools/daemontools-man-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools/daemontools-man-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools/daemontools-man-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &amp;&amp; 
+gzip -9 *.8 &amp;&amp;
+cp *.8.gz /usr/share/man/man8/</userinput></screen></para>
+</sect2>
+
Index: basicnet/djb/daemontools/daemontools-man-intro.xml
===================================================================
--- basicnet/djb/daemontools/daemontools-man-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools/daemontools-man-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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.ent
===================================================================
--- basicnet/djb/daemontools/daemontools.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/daemontools/daemontools.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/djb.xml
===================================================================
--- basicnet/djb/djb.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/djb.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/djb/ucspi-tcp.xml
===================================================================
--- basicnet/djb/ucspi-tcp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/ucspi-tcp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-desc.xml
===================================================================
--- basicnet/djb/ucspi-tcp/ucspi-tcp-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/ucspi-tcp/ucspi-tcp-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/ucspi-tcp/ucspi-tcp-exp.xml
===================================================================
--- basicnet/djb/ucspi-tcp/ucspi-tcp-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/ucspi-tcp/ucspi-tcp-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,19 @@
+<sect2>
+<title>Command explanations</title>
+
+<para><screen><userinput>sed 's|/usr/local|/usr|' conf-home &gt; conf-home~</userinput>
+<userinput>mv conf-home~ conf-home</userinput>
+<userinput>sed 's/bin/sbin/' hier.c &gt; 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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/ucspi-tcp/ucspi-tcp-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &gt; conf-home~ &amp;&amp;</userinput>
+<userinput>mv conf-home~ conf-home &amp;&amp;</userinput>
+<userinput>sed 's/bin/sbin/' hier.c &gt; hier.c~ &amp;&amp;</userinput>
+<userinput>mv hier.c~ hier.c &amp;&amp;</userinput>
+<userinput>make &amp;&amp;</userinput>
+<userinput>make setup check</userinput></screen></para>
+
+</sect2>
+
Index: basicnet/djb/ucspi-tcp/ucspi-tcp-intro.xml
===================================================================
--- basicnet/djb/ucspi-tcp/ucspi-tcp-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/ucspi-tcp/ucspi-tcp-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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.ent
===================================================================
--- basicnet/djb/ucspi-tcp/ucspi-tcp.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/djb/ucspi-tcp/ucspi-tcp.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/mailnews/fetchmail.xml
===================================================================
--- basicnet/mailnews/fetchmail.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/fetchmail.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/fetchmail/fetchmail-config.xml
===================================================================
--- basicnet/mailnews/fetchmail/fetchmail-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/fetchmail/fetchmail-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/fetchmail/fetchmail-desc.xml
===================================================================
--- basicnet/mailnews/fetchmail/fetchmail-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/fetchmail/fetchmail-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-exp.xml
===================================================================
--- basicnet/mailnews/fetchmail/fetchmail-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/fetchmail/fetchmail-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/fetchmail/fetchmail-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &amp;&amp;</userinput>
+<userinput>make &amp;&amp;</userinput>
+<userinput>make install</userinput>
+</screen>
+</para>
+
+</sect2>
+
Index: basicnet/mailnews/fetchmail/fetchmail-intro.xml
===================================================================
--- basicnet/mailnews/fetchmail/fetchmail-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/fetchmail/fetchmail-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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. &quot;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.&quot; </para>
+
+<screen>fetchmail depends on:
+OpenSSL and a local MDA (procmail).</screen>
+
+</sect2>
Index: basicnet/mailnews/fetchmail/fetchmail.ent
===================================================================
--- basicnet/mailnews/fetchmail/fetchmail.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/fetchmail/fetchmail.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/mailnews.xml
===================================================================
--- basicnet/mailnews/mailnews.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/mailnews.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/mutt.xml
===================================================================
--- basicnet/mailnews/mutt.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/mutt.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/mutt/mutt.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,1 @@
+<!ENTITY mutt SYSTEM "../mutt.xml">
Index: basicnet/mailnews/other.xml
===================================================================
--- basicnet/mailnews/other.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/other.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/mailnews/pine.xml
===================================================================
--- basicnet/mailnews/pine.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/pine.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/pine/pine.ent
===================================================================
--- basicnet/mailnews/pine/pine.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/pine/pine.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,1 @@
+<!ENTITY pine SYSTEM "../pine.xml">
Index: basicnet/mailnews/procmail.xml
===================================================================
--- basicnet/mailnews/procmail.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/procmail.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/procmail/procmail.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,1 @@
+<!ENTITY procmail SYSTEM "../procmail.xml">
Index: basicnet/mailnews/slrn.xml
===================================================================
--- basicnet/mailnews/slrn.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/slrn.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/slrn/slrn.ent
===================================================================
--- basicnet/mailnews/slrn/slrn.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/mailnews/slrn/slrn.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,1 @@
+<!ENTITY slrn SYSTEM "../slrn.xml">
Index: basicnet/netlibs/curl.xml
===================================================================
--- basicnet/netlibs/curl.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/curl.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-config.xml
===================================================================
--- basicnet/netlibs/curl/curl-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/curl/curl-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,11 @@
+<sect2>
+<title>Configuring curl</title>
+
+<sect3><title>Configuration Information</title>
+
+&library-config;
+
+</sect3>
+
+</sect2>
+
Index: basicnet/netlibs/curl/curl-desc.xml
===================================================================
--- basicnet/netlibs/curl/curl-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/curl/curl-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-inst.xml
===================================================================
--- basicnet/netlibs/curl/curl-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/curl/curl-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &amp;&amp;
+make &amp;&amp;
+make install </userinput></screen></para>
+
+</sect2>
+
Index: basicnet/netlibs/curl/curl-intro.xml
===================================================================
--- basicnet/netlibs/curl/curl-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/curl/curl-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &gt;
+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.ent
===================================================================
--- basicnet/netlibs/curl/curl.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/curl/curl.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/netlibs.xml
===================================================================
--- basicnet/netlibs/netlibs.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/netlibs.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,8 @@
+<chapter id="basicnet-netlibs">
+<?dbhtml filename="netlibs.html" dir="basicnet"?>
+<title>Networking Libraries</title>
+
+&curl;
+&wvstreams;
+
+</chapter>
Index: basicnet/netlibs/wvstreams.xml
===================================================================
--- basicnet/netlibs/wvstreams.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/wvstreams.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/wvstreams/wvstreams-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,10 @@
+<sect2>
+<title>Configuring wvstreams</title>
+
+<sect3><title>Configuration Information</title>
+
+&library-config;
+
+</sect3>
+
+</sect2>
Index: basicnet/netlibs/wvstreams/wvstreams-desc.xml
===================================================================
--- basicnet/netlibs/wvstreams/wvstreams-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/wvstreams/wvstreams-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/netlibs/wvstreams/wvstreams-inst.xml
===================================================================
--- basicnet/netlibs/wvstreams/wvstreams-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/wvstreams/wvstreams-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &amp;&amp;
+make PREFIX=/usr install</userinput></screen></para>
+
+</sect2>
+
Index: basicnet/netlibs/wvstreams/wvstreams-intro.xml
===================================================================
--- basicnet/netlibs/wvstreams/wvstreams-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/wvstreams/wvstreams-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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.ent
===================================================================
--- basicnet/netlibs/wvstreams/wvstreams.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netlibs/wvstreams/wvstreams.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/netprogs/cvs.xml
===================================================================
--- basicnet/netprogs/cvs.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/cvs.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/cvs/cvs-config.xml
===================================================================
--- basicnet/netprogs/cvs/cvs-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/cvs/cvs-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-desc.xml
===================================================================
--- basicnet/netprogs/cvs/cvs-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/cvs/cvs-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/cvs/cvs-inst.xml
===================================================================
--- basicnet/netprogs/cvs/cvs-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/cvs/cvs-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &amp;&amp;</userinput>
+<userinput>make &amp;&amp;</userinput>
+<userinput>make install</userinput></screen>
+</para>
+
+</sect2>
+
Index: basicnet/netprogs/cvs/cvs-intro.xml
===================================================================
--- basicnet/netprogs/cvs/cvs-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/cvs/cvs-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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.ent
===================================================================
--- basicnet/netprogs/cvs/cvs.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/cvs/cvs.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/ncftp.xml
===================================================================
--- basicnet/netprogs/ncftp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/ncftp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/ncftp/ncftp-config.xml
===================================================================
--- basicnet/netprogs/ncftp/ncftp-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/ncftp/ncftp-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-desc.xml
===================================================================
--- basicnet/netprogs/ncftp/ncftp-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/ncftp/ncftp-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-exp.xml
===================================================================
--- basicnet/netprogs/ncftp/ncftp-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/ncftp/ncftp-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,10 @@
+<sect2>
+<title>Command explanations</title>
+
+<para><userinput>cd libncftp &amp;&amp; make shared &amp;&amp; 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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/ncftp/ncftp-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &amp;&amp;
+cd libncftp &amp;&amp;
+make shared &amp;&amp;
+make soinstall &amp;&amp;
+cd .. &amp;&amp;
+make &amp;&amp;
+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 &amp;&amp;
+make &amp;&amp;
+make install</userinput></screen></para>
+
+</sect2>
+
Index: basicnet/netprogs/ncftp/ncftp-intro.xml
===================================================================
--- basicnet/netprogs/ncftp/ncftp-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/ncftp/ncftp-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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.ent
===================================================================
--- basicnet/netprogs/ncftp/ncftp.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/ncftp/ncftp.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/netprogs.xml
===================================================================
--- basicnet/netprogs/netprogs.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/netprogs.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/netprogs/openssh-client.xml
===================================================================
--- basicnet/netprogs/openssh-client.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/openssh-client.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/telnet.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/wget.xml
===================================================================
--- basicnet/netprogs/wget.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/wget.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netprogs/wget/wget.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,1 @@
+<!ENTITY wget SYSTEM "../wget.xml">
Index: basicnet/netutils/netutils.xml
===================================================================
--- basicnet/netutils/netutils.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/netutils.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/nmap.xml
===================================================================
--- basicnet/netutils/nmap.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/nmap.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/nmap/nmap.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,1 @@
+<!ENTITY nmap SYSTEM "../nmap.xml">
Index: basicnet/netutils/traceroute.xml
===================================================================
--- basicnet/netutils/traceroute.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/traceroute.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-desc.xml
===================================================================
--- basicnet/netutils/traceroute/traceroute-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/traceroute/traceroute-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/netutils/traceroute/traceroute-exp.xml
===================================================================
--- basicnet/netutils/traceroute/traceroute-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/traceroute/traceroute-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,29 @@
+<sect2>
+<title>Command explanations</title>
+
+<para><screen><userinput>sed 's|@prefix@|/usr|' Makefile.in &gt; 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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/traceroute/traceroute-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &gt; 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-intro.xml
===================================================================
--- basicnet/netutils/traceroute/traceroute-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/traceroute/traceroute-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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.ent
===================================================================
--- basicnet/netutils/traceroute/traceroute.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/traceroute/traceroute.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/whois.xml
===================================================================
--- basicnet/netutils/whois.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/whois.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/netutils/whois/whois.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,1 @@
+<!ENTITY whois SYSTEM "../whois.xml">
Index: basicnet/textweb/links.xml
===================================================================
--- basicnet/textweb/links.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/links.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-config.xml
===================================================================
--- basicnet/textweb/links/links-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/links/links-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-desc.xml
===================================================================
--- basicnet/textweb/links/links-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/links/links-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-inst.xml
===================================================================
--- basicnet/textweb/links/links-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/links/links-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &amp;&amp;</userinput>
+<userinput>make &amp;&amp;</userinput>
+<userinput>make install</userinput></screen></para>
+
+</sect2>
+
Index: basicnet/textweb/links/links-intro.xml
===================================================================
--- basicnet/textweb/links/links-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/links/links-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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.ent
===================================================================
--- basicnet/textweb/links/links.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/links/links.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/lynx.xml
===================================================================
--- basicnet/textweb/lynx.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/lynx.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-config.xml
===================================================================
--- basicnet/textweb/lynx/lynx-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/lynx/lynx-config.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/lynx/lynx-desc.xml
===================================================================
--- basicnet/textweb/lynx/lynx-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/lynx/lynx-desc.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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-exp.xml
===================================================================
--- basicnet/textweb/lynx/lynx-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/lynx/lynx-exp.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/lynx/lynx-inst.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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 &amp;&amp;</userinput>
+<userinput>make &amp;&amp;</userinput>
+<userinput>make install &amp;&amp;</userinput>
+<userinput>make DOCDIR=/usr/share/doc/lynx-2.8.4/lynx_doc \</userinput>
+<userinput>&nbsp;&nbsp;&nbsp;HELPDIR=/usr/share/doc/lynx-2.8.4/lynx_help install-doc &amp;&amp;</userinput>
+<userinput>make DOCDIR=/usr/share/doc/lynx-2.8.4/lynx_doc \</userinput>
+<userinput>&nbsp;&nbsp;&nbsp;HELPDIR=/usr/share/doc/lynx-2.8.4/lynx_help install-help &amp;&amp;</userinput>
+<userinput>sed s/"t\/etc"/"t\/usr\/share\/doc\/lynx\-2\.8\.4"/ \</userinput>
+<userinput>&nbsp;&nbsp;&nbsp;/etc/lynx.cfg &gt; /etc/lynx.bak &amp;&amp;</userinput>
+<userinput>mv /etc/lynx.bak /etc/lynx.cfg</userinput></screen></para>
+
+</sect2>
+
Index: basicnet/textweb/lynx/lynx-intro.xml
===================================================================
--- basicnet/textweb/lynx/lynx-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/lynx/lynx-intro.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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.ent
===================================================================
--- basicnet/textweb/lynx/lynx.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/lynx/lynx.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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/textweb.xml
===================================================================
--- basicnet/textweb/textweb.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/textweb.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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: basicnet/textweb/w3m.xml
===================================================================
--- basicnet/textweb/w3m.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/w3m.xml	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -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	(revision f45b195302d36939467202524156f38e0369b4f2)
+++ basicnet/textweb/w3m/w3m.ent	(revision f45b195302d36939467202524156f38e0369b4f2)
@@ -0,0 +1,1 @@
+<!ENTITY w3m SYSTEM "../w3m.xml">
