From 9d67969c09669bcd3f5161403cdbbf5d357b1fec Mon Sep 17 00:00:00 2001
From: interp <interp>
Date: Thu, 13 May 2004 21:27:26 +0000
Subject: [PATCH] Adjust section about installing SSAX to package proposal
 Minor reformatting / typos removed

---
 doc/latex/surflethowto.tex | 75 +++++++++++++++++++++++---------------
 1 file changed, 46 insertions(+), 29 deletions(-)

diff --git a/doc/latex/surflethowto.tex b/doc/latex/surflethowto.tex
index 78fa622..05e7081 100644
--- a/doc/latex/surflethowto.tex
+++ b/doc/latex/surflethowto.tex
@@ -61,50 +61,69 @@ The following sections will show pieces of \surflet code you might
 want to try out.  Therefore you need the SUnet webserver running with
 the ability to serve \surflets.  This section tells you how to do it.
 
-\begin{enumerate}
-\item You need Oleg's SSAX package (for scsh), to be able to use
-surflets:
+\paragraph{Obtaining necessary packages} You need Oleg's SSAX package
+(for scsh), to be able to use surflets:
 
 \begin{itemize}
   \item Download Oleg's SSAX package from
   \url{http://prdownloads.sf.net/ssax/ssax-sr5rs-plt200-4.9.tar.gz?download}.
 
-  \item Uncompress and untar it to any directory.  This will create a
-  directory called \name{SSAX}, to which I will refer to as
-  \typew{\$SSAX}.
+  \item Download the SSAX package kit from
+     \url{http://lamp.epfl.ch/~schinz/scsh_packages}.  
 
-  \item Unfortunately, this SSAX distribution (plt200-4.9) has a typo in
-  the package definition for scsh.  Apply the patch that comes with
-  the \surflets distribution to get rid of this typo:
-    \begin{itemize}
-      \item \typew{cd \$SSAX}
-      \item \typew{patch -p1 < \$sunet/httpd/surflets/SSAX-goodhtml-patch}
-    \end{itemize}
+  \item Uncompress and untar both tarballs in the same directory.
+  This will create a directory called \name{SSAX}, to which I will
+  refer to as \typew{\$SSAX}.  The package kit will add a file
+  \name{pkg-def.scm} to the \name{SSAX} directory.
+
+  \item Install SSAX as a scsh package by issuing the command
+  \typew{scsh-install-pkg --prefix /path/to/your/package/root} in the
+  \typew{\$SSAX} directory.  If you don't yet have the packaging
+  utility of Michel Schinz, you can obtain it from
+  \url{http://lamp.epfl.ch/~schinz/scsh_packages}.
+
+  If you don't want to install SSAX with the packaging utility, you
+  can adjust the scripts to directly load the SSAX package definitions
+  from \type{\$SSAX/lib/packages.scm}.  Note that the original file
+  has a typo which you can correct with
+
+  \begin{alltt}
+    cd \$SSAX
+    patch -p1 < \$sunet/httpd/surflets/SSAX-goodhtml-patch
+  \end{alltt}
+
+
+%  \item Unfortunately, this SSAX distribution (plt200-4.9) has a typo in
+%  the package definition for scsh.  Apply the patch that comes with
+%  the \surflets distribution to get rid of this typo:
+%    \begin{itemize}
+%      \item \typew{cd \$SSAX}
+%      \item \typew{patch -p1 < \$sunet/httpd/surflets/SSAX-goodhtml-patch}
+%    \end{itemize}
 \end{itemize}
 
-\item You can start the SUnet webserver along with the
-\surflet-handler now.  The \surflets distribution comes with a script that
+\paragraph{Starting the SUrflet server} 
+ You can start the SUnet webserver along with the
+\surflet-handler now.  The SUnet distribution comes with a script that
 does this for you:
 
-\begin{itemize}
-  \item \typew{cd \$sunet}
-  \item \typew{SSAX=\$SSAX ./start-surflet-server}
-\end{itemize}
-
+\begin{alltt}
+\$ /path/to/your/package/root/sunet/web-server/start-surflet-server
+\end{alltt}
 
 Please be patient, scsh has to load a lot of libraries.  If the
 loading succeeds you will see something like this:
 
 \begin{alltt}
-[andreas@hgt sunet]\$ SSAX=/home/andreas/sw/SSAX ./start-surflet-server
+[andreas@hgt web-server]\$ ./start-surflet-server
 Loading...
 reading options: ()
 Going to run SUrflet server with:
- htdocs-dir:    /home/andreas/sw/sunet/web-server/root/htdocs
- surflet-dir:   /home/andreas/sw/sunet/web-server/root/surflets
- images-dir:    /home/andreas/sw/sunet/web-server/root/img
+ htdocs-dir:    /home/andreas/bin/lib/scsh/0.6/sunet-2.1/web-server/root/htdocs   
+ surflet-dir:   /home/andreas/bin/lib/scsh/0.6/sunet-2.1/web-server/root/surflets 
+ images-dir:    /home/andreas/bin/lib/scsh/0.6/sunet-2.1/web-server/root/img
  port:          8008
- log-file-name: /home/andreas/sw/sunet/web-server/httpd.log
+ log-file-name: /tmp/httpd.log
  a maximum of 5 simultaneous requests, syslogging activated, 
  and home-dir-handler (public_html) activated.
 
@@ -135,12 +154,10 @@ Error: 98
 \end{alltt}
 
 In this case, pass another port number to the script, \eg 8000:
-\codex{ssax=\$SSAX ./start-surflet-server -p 8000}
+\codex{start-surflet-server -p 8000}
 
 The \typew{--help} option will show you more parameters that you can
 adjust, but you won't need them for this howto.
-\end{enumerate}
-
 
 
 \section{How to send web pages}
@@ -1386,7 +1403,7 @@ escaping, \eg for the ampersand (\&).
 
 \section{Outlook}
 
-More to come soon about\surflets containing of different parts and
+More to come soon about \surflets consisting of different parts and
 individual SXML.