sisu manual and man page update

1 files changed, 55 insertions, 228 deletions

diff --git a/man/man1/sisu.1 b/man/man1/sisu.1
index e07eb22a..d3a3ba14 100644
--- a/man/man1/sisu.1
+++ b/man/man1/sisu.1
@@ -1,4 +1,4 @@
-.TH "sisu" "1" "2007-09-29" "0.59.1" "SiSU"
+.TH "sisu" "1" "2007-09-29" "0.61.0" "SiSU"
 .SH NAME
 sisu \- documents: markup, structuring, publishing in multiple standard formats, and search
 .SH SYNOPSIS
@@ -598,7 +598,7 @@ wildcard]
 consider \-u for appended url info or \-v for verbose output
 
 .SH
-5.0.1 COMMAND LINE WITH FLAGS \- BATCH PROCESSING
+5.1 COMMAND LINE WITH FLAGS \- BATCH PROCESSING
 
 .BR
 In the data directory run sisu \-mh filename or wildcard eg. \"sisu \-h
@@ -622,26 +622,24 @@ The most up to date information on sisu should be contained in the sisu_manual,
 available at:
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/>
+  <http://sisudoc.org/sisu/sisu_manual/>
 
 .BR
-and (from
+The manual can be generated from source, found respectively, either within the
 .B SiSU
-0.59 onwards) installed locally at:
+tarball or installed locally at:
 
 .BR
-  /usr/share/doc/sisu/sisu_manual/
+  \./data/doc/sisu/sisu_markup_samples/sisu_manual/
 
 .BR
-or equivalent directory
+  /usr/share/doc/sisu/sisu_markup_samples/sisu_manual/
 
 .BR
-Within the
-.B SiSU
-tarball at:
+move to the respective directory and type e.g.:
 
 .BR
-  \./data/doc/sisu/sisu_manual/
+  sisu sisu_manual.ssm
 
 .SH
 6.2 SISU MAN PAGES
@@ -760,10 +758,7 @@ For lists of alternative help sources, see:
   /usr/share/doc/sisu/html/sisu_help_sources/index.html
 
 .BR
-  <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
+  <http://sisudoc.org/sisu/sisu_help_sources/index.html>
 
 .SH
 7. INTRODUCTION TO SISU MARKUP[^9]
@@ -823,7 +818,7 @@ markup or sisu \-\-help markup
 
 .BR
 Online markup examples are available together with the respective outputs
-produced from <http://www.jus.uio.no/sisu/SiSU/2.html> or from
+produced from <http://www.jus.uio.no/sisu/SiSU/examples.html> or from
 <http://www.jus.uio.no/sisu/sisu_examples/>
 
 .BR
@@ -896,7 +891,7 @@ This current document has a header similar to this one (without the comments):
   % skins modify the appearance of a document and are placed in a sub\-directory under \./_sisu/skin ~/.sisu/skin or /etc/sisu/skin. A skin may affect single documents that request them, all documents in a directory, or be site\-wide. (A document is affected by a single skin)
   @bold: /Gnu|Debian|Ruby|SiSU/
   @links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/
-  { Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/2.html
+  { Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/examples.html
   { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
   { SiSU @ Freshmeat }http://freshmeat.net/projects/sisu/
   { SiSU @ Ruby Application Archive }http://raa.ruby\-lang.org/project/sisu/
@@ -2852,7 +2847,7 @@ skin_poems.rb
 
 .BR
 Current markup examples and document output samples are provided at
-<http://www.jus.uio.no/sisu/SiSU/2.html>
+<http://www.jus.uio.no/sisu/SiSU/examples.html>
 
 .BR
 Some markup with syntax highlighting may be found under
@@ -3471,8 +3466,8 @@ processing instruction and the url. The source file and any associated parts
 
 .BR
 Any of the source documents in the sisu examples page can be used in this way,
-see <http://www.jus.uio.no/sisu/SiSU/2.html> and use the url for the desired
-document.
+see <http://www.jus.uio.no/sisu/SiSU/examples.html> and use the url for the
+desired document.
 
 .BR
 NOTE: to set up a remote machine to serve
@@ -3500,8 +3495,8 @@ documents it contains generated locally.
 
 .BR
 Any of the source documents in the sisu examples page can be used in this way,
-see <http://www.jus.uio.no/sisu/SiSU/2.html> and use the url for the desired
-document.
+see <http://www.jus.uio.no/sisu/SiSU/examples.html> and use the url for the
+desired document.
 
 .SH
 REMOTE DOCUMENT OUTPUT
@@ -3919,7 +3914,7 @@ sisu \-\-help \-\-markup
 A number of markup samples (along with output) are available off:
 
 .BR
-<http://www.jus.uio.no/sisu/SiSU/2.html>
+<http://www.jus.uio.no/sisu/SiSU/examples.html>
 
 .BR
 Additional markup samples are packaged separately in the file:
@@ -4317,22 +4312,13 @@ try one of the following:
 .B man2html
 
 .BR
-  <file:///usr/share/doc/sisu/html/sisu_help.1.html>
-
-.BR
   <http://www.jus.uio.no/sisu/man/sisu_help.1.html>
 
 .BR
 .B sisu generated output \- links to html
 
 .BR
-  <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_help/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html>
+  <http://sisudoc.org/sisu/sisu_help/index.html>
 
 .BR
 .B help sources lists
@@ -4344,16 +4330,7 @@ Alternative sources for this help sources page listed here:
   man sisu_help_sources
 
 .BR
-  <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  <file:///usr/share/doc/sisu/html/sisu_help_sources/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
+  <http://sisudoc.org/sisu/sisu_help_sources/index.html>
 
 .SH
 34.1 MAN PAGES
@@ -4394,199 +4371,85 @@ and output is available in multiple formats including amongst others html,
 pdf, and odf which may be also be accessed via the html pages[^28]
 
 .SH
-34.2.1 LOCALLY INSTALLED
-
-.BR
-<file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html>
-
-.BR
-<file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
-<file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_termsheet/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html
-
-.SH
-34.2.2 WWW.SISUDOC.ORG
-
-.BR
-<http://sisudoc.org/sisu_manual/sisu_manual/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_commands/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_complete/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_configuration/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_description/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_examples/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_faq/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_filetypes/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_help/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_howto/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_introduction/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_manual/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_markup/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_output_overview/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_pdf/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_postgresql/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_quickstart/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_remote/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_search/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_skin/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_sqlite/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_vim/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_webrick/index.html>
-
-.SH
-34.2.3 WWW.JUS.UIO.NO/SISU
+34.2.1 WWW.SISUDOC.ORG
 
 .BR
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>
+<http://sisudoc.org/sisu/sisu_manual/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html>
+  <http://sisudoc.org/sisu/sisu_manual/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html>
+  <http://sisudoc.org/sisu/sisu_commands/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html>
+  <http://sisudoc.org/sisu/sisu_complete/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html>
+  <http://sisudoc.org/sisu/sisu_configuration/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html>
+  <http://sisudoc.org/sisu/sisu_description/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html>
+  <http://sisudoc.org/sisu/sisu_examples/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html>
+  <http://sisudoc.org/sisu/sisu_faq/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html>
+  <http://sisudoc.org/sisu/sisu_filetypes/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html>
+  <http://sisudoc.org/sisu/sisu_help/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
+  <http://sisudoc.org/sisu/sisu_help_sources/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html>
+  <http://sisudoc.org/sisu/sisu_howto/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html>
+  <http://sisudoc.org/sisu/sisu_introduction/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>
+  <http://sisudoc.org/sisu/sisu_manual/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html>
+  <http://sisudoc.org/sisu/sisu_markup/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html>
+  <http://sisudoc.org/sisu/sisu_output_overview/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html>
+  <http://sisudoc.org/sisu/sisu_pdf/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html>
+  <http://sisudoc.org/sisu/sisu_postgresql/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html>
+  <http://sisudoc.org/sisu/sisu_quickstart/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html>
+  <http://sisudoc.org/sisu/sisu_remote/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html>
+  <http://sisudoc.org/sisu/sisu_search/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html>
+  <http://sisudoc.org/sisu/sisu_skin/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html>
+  <http://sisudoc.org/sisu/sisu_sqlite/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html>
+  <http://sisudoc.org/sisu/sisu_syntax_highlighting/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html>
+  <http://sisudoc.org/sisu/sisu_vim/index.html>
 
 .BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html>
+  <http://sisudoc.org/sisu/sisu_webrick/index.html>
 
 .SH
 34.3 MAN2HTML
@@ -4619,48 +4482,12 @@ pdf, and odf which may be also be accessed via the html pages[^28]
   /usr/share/doc/sisu/html/sisu_webrick.1.html
 
 .SH
-34.3.2 WWW.SISUDOC.ORG
-
-.BR
-<http:///sisudoc.org/man/sisu_manual.1.html>
-
-.BR
-<http:///sisudoc.org/man/sisu_help.1.html>
-
-.BR
-<http:///sisudoc.org/man/sisu_help_sources.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_complete.7.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_pdf.7.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_postgresql.7.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_sqlite.7.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_webrick.1.html>
-
-.SH
-34.3.3 WWW.JUS.UIO.NO/SISU
+34.3.2 WWW.JUS.UIO.NO/SISU
 
 .BR
 <http://www.jus.uio.no/sisu/man/sisu.1.html>
 
 .BR
-<http://www.jus.uio.no/sisu/man/sisu_help.1.html>
-
-.BR
-<http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html>
-
-.BR
   <http://www.jus.uio.no/sisu/man/sisu.1.html>
 
 .BR
@@ -4746,24 +4573,24 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu._sst)=
-.I 7d1c79519108da1773a33367e1eba6b5
+.I 8aad6597f7572baae4f0ef75999e5b4f
 
 .BR
 Skin_Digest: MD5(skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
+.I 072b2584bedea82ea8a416587b9fa244
 
 .BR
 .B Generated
 
 .BR
 Document (metaverse) last generated:
-.I Sat Sep 29 17:05:37 +0100 2007
+.I Fri Oct 12 20:14:00 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
+.I 0.61.0
+of 2007w41/1 (2007\-10\-08)
 
 .BR
 Ruby version:
@@ -4920,10 +4747,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
+* Generated by: SiSU 0.61.0 of 2007w41/1 (2007-10-08)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sat Sep 29 17:05:38 +0100 2007
+* Last Generated on: Fri Oct 12 20:14:00 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu