August 2004
-----------
The contents of the ./source directory are the source.

    The contents of ./info ./html ./man ./texi are generated
from the source, therefore always make changes to files
in ./source.  Changes to files in ./texi ./info ./man 
./html will be lost.
  
To delete all generated files and remake from scratch
do:   
       make realclean all

The root of the info tree is info/swbis.info

The root of the html tree is html/swbis.html 

To format the sgml man pages file you will need

-rw-rw-r--   1 jhl      other      126671 Dec 20 22:33 docbook-to-man.tar.gz
-rw-rw-r--   1 jhl      other       47501 Dec 21 10:59 docbk241.tar.Z
-rw-rw-r--   1 jhl      other       13484 Dec 29 22:52 man2HTML.tar.gz

docbook-to-man is a free tool from the OSF.
docbk241.tar.Z is the docbook DTD v2.41 package from Davenport Co.
man2HTML is a manpage to HTML translator.

If you don't care to format yourself, pre-formatted files are
provided in the ./man ./info ./html and ./text directories.

BUG:
The sgml source files produce so many warnings that
I had to edit the sgml parser wrapper shell script (which launches the
sgml parser) to allow more parser warnings before quitting with an
error (This is a command line switch to the parser found in the
shell script).


SEPTEMBER 2005 : Compiling the documentation on a modern Debian System:
------------------------------------------------------------------------

The documentation can be compiled on Debian GNU/Linux 3.1r0a
with the following additions/changes:

Add the following two packages manually which are not part
of the Debian distribution, you have to get them off the
Internet yourself:

96489411b5f1aff644abc12ef50510e7  man2texi-0.01.tar.bz2
ccefdac569c96641ee8f67cf99eb0ef4  yman2html-0_22.tar.gz

Then, install the docbook-to-man package (which is part of the
Debian distribution, it was on CD#3 of my CD set) then modify the
docbook-to-man shell script, /usr/bin/docbook-to-man, as indicated by the
following patch:

--- docbook-to-man.orig	2005-01-07 09:18:19.000000000 -0500
+++ docbook-to-man	2005-09-04 21:18:02.277772736 -0400
@@ -177,10 +177,9 @@
 #fi
 
 (#cat /tmp/dtm.$$.psinc;
- $PARSER -gl -m$CATALOG $DECL $INSTANCE |
+ $PARSER -E 5000 -gl -m$CATALOG $DECL $INSTANCE |
 	$INSTANT -croff.cmap -sroff.sdata -tdocbook-to-man.ts $INSTANT_OPT |
-	sed 's/^[	 ]*//
-	     s/$/ /
+	sed 's/$/ /
 	     s/--/\\-\\-/g
 	     s/^-/\\-/
 	     s/\([^A-Za-z0-9\-]\)-/\1\\-/g' )

Then modify the '/usr/share/sgml/transpec/docbook-to-man.ts' file according to
the patch below.  Note, this change reverts some of the changes made by the ANS
Modifications back to being in line with Fred Dalrymple's original package.

# diff -u /usr/share/sgml/transpec/docbook-to-man.ts.deb-sarge /usr/share/sgml/transpec/docbook-to-man.ts
--- /usr/share/sgml/transpec/docbook-to-man.ts.deb-sarge        2005-01-07 09:18:19.000000000 -0500
+++ /usr/share/sgml/transpec/docbook-to-man.ts  2005-09-05 18:32:00.000000000 -0400
@@ -1699,8 +1699,7 @@
 #
 GI:            COMMAND
 StartText:     \\fB
-#EndText:      \\fP
-EndText:       \\fR
+EndText:       \\fP
 -
 #
 GI:            COMPUTEROUTPUT
@@ -1850,8 +1849,7 @@
 #
 GI:            REPLACEABLE
 StartText:     \\fI
-#EndText:      \\fP
-EndText:       \\fR
+EndText:       \\fP
 -
 #
 GI:            RETURNVALUE

-- END of README
