From dfb7287c414253f7f2b5085747fe13bdb8ddb763 Mon Sep 17 00:00:00 2001
From: sperber <sperber>
Date: Fri, 10 Jan 2003 13:28:11 +0000
Subject: [PATCH] Re-worked; more complete list of stuff in SUnet.

---
 doc/latex/intro.tex | 56 +++++++++++++++++++++++----------------------
 1 file changed, 29 insertions(+), 27 deletions(-)

diff --git a/doc/latex/intro.tex b/doc/latex/intro.tex
index 822dfc5..0aa445e 100644
--- a/doc/latex/intro.tex
+++ b/doc/latex/intro.tex
@@ -1,36 +1,39 @@
 \chapter{Overview}\label{sec:intro}
 
-\section{What's in SUnet?}
+\section{What's SUnet?}
 
-The Scheme Underground Network Package contains a set of libraries for
-doing Net hacking from Scheme/scsh. It includes:
+The Scheme Untergrund Networking Package (SUnet, for short) contains a
+set of libraries for doing Internet hacking from scsh. It includes:
    
 \begin{description}
 \item[The SUnet Web server]
   This is a complete implementation of an HTTP 1.0 server in Scheme.
-  The server contains other standalone packages that may separately be
-  of use:
+  The server is accompanied some libraries which may also be used separately:
   \begin{itemize}
-  \item URI and URL parsers and unparsers.
-  \item A library to help writing CGI scripts in Scheme.
-  \item Server extensions for interfacing to CGI scripts.
-  \item Server extensions for uploading Scheme code.
-  \item Simple structured HTML output library
+  \item URI and URL parsers and unparsers
+  \item a library for writing CGI scripts in Scheme
+  \item server extensions for interfacing to CGI scripts
+  \item server extensions for uploading Scheme code
+  \item simple structured HTML output library
   \end{itemize}            
 \item[The SUnet ftp daemon]
-  This is a complete ftp server in Scheme.
-\item[ftp client library] Access an ftp server programmatically.
-\item[SMTP client library]
-  Forge mail from the comfort of your own Scheme process.
+  This is a complete anonymous ftp server in Scheme.
+\item[ftp client library] This library allows you to access ftp
+  servers programmatically.
+\item[netrc library] This library parses authentication information
+  contained in \verb|~/.netrc|.
+\item[SMTP client library] This library allows you to forge mail from
+  the comfort of your own Scheme process.
 \item[POP3 client library]
-  Get at your mails from inside scsh.
-\item[RFC822 header library]
-  Read email-style headers. Useful in several contexts (smtp, http,
-  etc.)
+  This library allows you to access your POP3 mailbox from inside scsh.
+\item[RFC822 header library] This library parses email-style headers.
 \item[Daytime and Time protocol client library]
-  Find out what time it is without paying for a Rolex.
-\item[An \texttt{ls} clone] Display Unix-style directory listings
-  without running \texttt{ls}.
+  This library lets you find out what time it is without paying for a
+  Rolex.
+\item[DNS client library] This is a fairly complete, multithreaded DNS
+  library.
+\item[An \texttt{ls} clone] This library Displays Unix-style directory
+  listings without running \texttt{ls}.
 \end{description}
 
 \section{Obtaining the system}
@@ -43,14 +46,13 @@ version 0.6.3 or later of \urlhd{http://www.scsh.net/}{scsh}{scsh from
 
 \section{How to use the packages}
 
-Scsh is started in the SUnet top-level directory. Then, the
-description file of the modules is loaded and the \texttt{ftp} module
-is opened (to use a ftp client). After the things are done, scsh is
-finished via the \verb|,exit| command.
+Untar the SUnet distribution somewhere.  Fire up scsh and load the
+SUnet \texttt{packages.scm} file into the configuration package.
+After that, all structures defined by SUnet are available:
 %
 \begin{alltt}
-atari-2600[72] scsh-0.6.2
-Welcome to scsh 0.6.2 (Gambit-C 4.0)
+atari-2600[72] scsh-0.6.3
+Welcome to scsh 0.6.3 (Health Reform)
 Type ,? for help.
 > ,config ,load packages.scm
 modules.scm