documentation regenerated, large diff

20 files changed, 464 insertions, 319 deletions

diff --git a/man/man1/sisu.1 b/man/man1/sisu.1
index 0f73191b..1d147195 100644
--- a/man/man1/sisu.1
+++ b/man/man1/sisu.1
@@ -1,6 +1,6 @@
-.TH "sisu" "1" "2007-08-30" "0.58.3" "SiSU - SiSU information Structuring Universe"
+.TH "sisu" "1" "2007-08-30" "0.59.0" "SiSU"
 .SH
-SISU \- SISU INFORMATION STRUCTURING UNIVERSE \- MANUAL \ [0.58],
+SISU \- MANUAL,
 RALPH AMISSAH
 .BR
 
@@ -377,7 +377,7 @@ Within the
 tarball at:
 
 .BR
-  ./data/doc/sisu/sisu_manual/
+  \./data/doc/sisu/sisu_manual/
 
 .SH
 4.2 SISU MAN PAGES
@@ -405,7 +405,7 @@ the sisu manual, the sources files for which are located within the
 tarball at:
 
 .BR
-  ./data/doc/sisu/sisu_manual/
+  \./data/doc/sisu/sisu_manual/
 
 .BR
 Once installed, directory equivalent to:
@@ -420,7 +420,7 @@ Available man pages are converted back to html using man2html:
   /usr/share/doc/sisu/html/
 
 .BR
-  ./data/doc/sisu/html/
+  \./data/doc/sisu/html/
 
 .BR
 The
@@ -624,17 +624,17 @@ provides some information on setting up hyperestraier for sisu
 
 .TP
 .B \ \-H \ \ [filename/wildcard]
-produces html without link suffixes (.html .pdf etc.) (\"Hide\"). Requires an
-appropriately configured web server. \ [behaviour \ switched \ after \ 0.35 \
-see \ \-h].
+produces html without link suffixes (.html \.pdf etc.) (\"Hide\"). Requires
+an appropriately configured web server. \ [behaviour \ switched \ after \ 0.35
+\ see \ \-h].
 
 .TP
 .B \ \-h \ \ [filename/wildcard]
 produces html (with hardlinks i.e. with name suffixes in links/local urls).
 html, with internal document links that include the document suffix, i.e.
-whether it is .html or .pdf (required for browsing directly off a file system,
-and works with most web servers). \ [behaviour \ switched \ after \ 0.35 \ see
-\ \-H].
+whether it is \.html or \.pdf (required for browsing directly off a file
+system, and works with most web servers). \ [behaviour \ switched \ after \
+0.35 \ see \ \-H].
 
 .TP
 .B \ \-I \ \ [filename/wildcard]
@@ -702,7 +702,7 @@ that you have your \"keys\" and ssh agent in place. Also see \-R
 \ produces \ a \ sisupod \ a \ zipped \ sisu \ directory \ of \ markup \
 files \ including \ sisu \ markup \ source \ files \ and \ the \ directories \
 local \ configuration \ file, \ images \ and \ skins. \ Note: \ this \ only \
-includes \ the \ configuration \ files \ or \ skins \ contained \ in \ ./_sisu
+includes \ the \ configuration \ files \ or \ skins \ contained \ in \ \./_sisu
 \ not \ those \ in \ ~/.sisu \ \-S \ \ [filename/wildcard] option. Note: (this
 option is tested only with zsh).
 
@@ -710,7 +710,7 @@ option is tested only with zsh).
 .B \ \-S \ \ [filename/wildcard]
 produces a zipped file of the prepared document specified along with
 associated images, by default named sisupod.zip they may alternatively be named
-with the filename extension .ssp This provides a quick way of gathering the
+with the filename extension \.ssp This provides a quick way of gathering the
 relevant parts of a sisu document which can then for example be emailed. A
 sisupod includes sisu markup source file, (along with associated documents if a
 master file, or available in multilingual versions), together with related
@@ -1067,7 +1067,7 @@ This current document has a header similar to this one (without the comments):
 .nf
   % SiSU 0.57
   @title: SiSU
-  @subtitle: Markup \ [0.58]
+  @subtitle: Markup
   @creator: Ralph Amissah
   @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
   @type: information
@@ -1080,7 +1080,7 @@ This current document has a header similar to this one (without the comments):
   @level: new=C; break=1; num_top=1
   % comment: in this @level header num_top=1 starts automatic heading numbering at heading level 1 (numbering continues 3 levels down); the new and break instructions are used by the LaTeX/pdf and odf output to determine where to put page breaks (that are not used by html output or say sql database population).
   @skin: skin_sisu_manual
-  % 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)
+  % 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
@@ -1342,7 +1342,7 @@ free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst]
 11.1 HEADING LEVELS
 
 .BR
-Heading levels are :A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ ... :A \- :C being part / section
+Heading levels are :A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ \... :A \- :C being part / section
 headings, followed by other heading levels, and 1 \-6 being headings followed
 by substantive text or sub\-headings. :A~ usually the title :A~? conditional
 level 1 heading (used where a stand\-alone document may be imported into
@@ -1795,7 +1795,7 @@ information in each column
   Very active contributors***     |        0|       31|      190|      692|    1,639|    3,016
   No. of English language articles|       25|   16,000|  101,000|  190,000|  320,000|  630,000
   No. of articles, all languages  |       25|   19,000|  138,000|  490,000|  862,000|1,600,000
-  \* Contributed at least ten times; \** at least 5 times in last month; \*\** more than 100 times in last month.
+  \\* Contributed at least ten times; \\** at least 5 times in last month; \\*\** more than 100 times in last month.
 .fi
 
 .BR
@@ -2207,17 +2207,17 @@ generated independently, or they could be markup snippets, prepared so as to be
 easily available to be placed within another text. If the calling document is a
 master document (built from other documents), it should be named with the
 suffix
-.B .ssm
+.B \.ssm
 Within this document you would provide information on the other documents
 that should be included within the text. These may be other documents that
 would be processed in a regular way, or markup bits prepared only for inclusion
 within a master document
-.B .sst
+.B \.sst
 regular markup file, or
-.B .ssi
+.B \.ssi
 (insert/information) A secondary file of the composite document is built
 prior to processing with the same prefix and the suffix
-.B ._sst
+.B \._sst
 
 .BR
 basic markup for importing a document into a master document
@@ -2296,8 +2296,8 @@ variations include \'
 
 .BR
 .B 0.37
-(2006w09/7) introduced new file naming convention, .sst (text), .ssm
-(master), .ssi (insert), markup syntax unchanged
+(2006w09/7) introduced new file naming convention, \.sst (text), \.ssm
+(master), \.ssi (insert), markup syntax unchanged
 
 .BR
 .B 0.35
@@ -2331,7 +2331,7 @@ start of a text line as comment marker
 has plaintext and binary filetypes, and can process either type of document.
 
 .SH
-14.1 .SST .SSM .SSI MARKED UP PLAIN TEXT
+14.1 \.SST \.SSM \.SSI MARKED UP PLAIN TEXT
 
 .BR
 .B SiSU
@@ -2341,10 +2341,10 @@ markup. They may make reference to and contain images (for example), which
 are stored in the directory beneath them _sisu/image.
 .B SiSU
 plaintext markup files are of three types that may be distinguished by the
-file extension used: regular text .sst; master documents, composite documents
+file extension used: regular text \.sst; master documents, composite documents
 that incorporate other text, which can be any regular text or text insert; and
 inserts the contents of which are like regular text except these are marked
-.ssi and are not processed.
+\.ssi and are not processed.
 
 .BR
 .B SiSU
@@ -2382,7 +2382,7 @@ Composite documents which incorporate other
 .B SiSU
 documents which may be either regular
 .B SiSU
-text .sst which may be generated independently, or inserts prepared solely
+text \.sst which may be generated independently, or inserts prepared solely
 for the purpose of being incorporated into one or more master documents.
 
 .BR
@@ -2395,13 +2395,13 @@ manual.
 
 .BR
 Note: Master documents may be prepared in a similar way to regular documents,
-and processing will occur normally if a .sst file is renamed .ssm without
-requiring any other documents; the .ssm marker flags that the document may
+and processing will occur normally if a \.sst file is renamed \.ssm without
+requiring any other documents; the \.ssm marker flags that the document may
 contain other documents.
 
 .BR
 Note: a secondary file of the composite document is built prior to processing
-with the same prefix and the suffix ._sst \ [^22]
+with the same prefix and the suffix \._sst \ [^22]
 
 .BR
 <http://www.jus.uio.no/sisu/sisu_markup>
@@ -2418,11 +2418,11 @@ into one or more master documents. They resemble regular
 .B SiSU
 text files except they are ignored by the
 .B SiSU
-processor. Making a file a .ssi file is a quick and convenient way of
+processor. Making a file a \.ssi file is a quick and convenient way of
 flagging that it is not intended that the file should be processed on its own.
 
 .SH
-14.2 SISUPOD, ZIPPED BINARY CONTAINER (SISUPOD.ZIP, .SSP)
+14.2 SISUPOD, ZIPPED BINARY CONTAINER (SISUPOD.ZIP, \.SSP)
 
 .BR
 A sisupod is a zipped
@@ -2625,7 +2625,7 @@ resource configuration is determined by looking at the following files if
 they exist:
 
 .BR
-  ./_sisu/sisurc.yml
+  \./_sisu/sisurc.yml
 
 .BR
   ~/.sisu/sisurc.yml
@@ -2658,7 +2658,7 @@ Skins modify the default appearance of document output on a document,
 directory, or site wide basis. Skins are looked for in the following locations:
 
 .BR
-  ./_sisu/skin
+  \./_sisu/skin
 
 .BR
   ~/.sisu/skin
@@ -2671,13 +2671,13 @@ directory, or site wide basis. Skins are looked for in the following locations:
 are the following the default sub\-directories for document skins:
 
 .BR
-  ./skin/doc
+  \./skin/doc
 
 .BR
-  ./skin/dir
+  \./skin/dir
 
 .BR
-  ./skin/site
+  \./skin/site
 
 .BR
 A skin is placed in the appropriate directory and the file named skin_[name].rb
@@ -2751,9 +2751,9 @@ list) may be found in:
 .BR
 CSS files to modify the appearance of
 .B SiSU
-html, XHTML or XML may be placed in the configuration directory: ./_sisu/css;
-~/.sisu/css or; /etc/sisu/css and these will be copied to the output
-directories with the command sisu \-CC.
+html, XHTML or XML may be placed in the configuration directory:
+\./_sisu/css; ~/.sisu/css or; /etc/sisu/css and these will be copied to the
+output directories with the command sisu \-CC.
 
 .BR
 The basic CSS file for html output is html.css, placing a file of that name in
@@ -2795,7 +2795,7 @@ under the output directory root and the output for all documents contained in
 the directory of a particular name will be generated to subdirectories beneath
 that directory (poem or conventions). A document will be placed in a
 subdirectory of the same name as the document with the filetype identifier
-stripped (.sst .ssm)
+stripped (.sst \.ssm)
 
 .BR
 The last part of a directory path, representing the sub\-directory in which a
@@ -2850,7 +2850,7 @@ directory structure and organisation of content.
 .BR
 Custom built pages, including the home page index.html may be placed within the
 configuration directory _sisu/home/ in any of the locations that is searched
-for the configuration directory, namely ./_sisu; ~/_sisu; /etc/sisu From there
+for the configuration directory, namely \./_sisu; ~/_sisu; /etc/sisu From there
 they are copied to the root of the output directory with the command:
 
 .BR
@@ -3352,7 +3352,7 @@ rune along the following lines:
 .BR
   find /home/ralph/sisu_www \-type f | egrep \'/home/ralph/sisu_www/([specify \
   first \ directory \ for \ inclusion]|[specify \ second \ directory \ for \
-  inclusion]|[another \ directory \ for \ inclusion? \ ...])/.+?.html$\' |
+  inclusion]|[another \ directory \ for \ inclusion? \ \...])/.+?.html$\' |
   egrep \-v \'(doc|concordance).html$\' |estcmd gather \-sd
   /home/ralph/sisu_www/casket \-
 
@@ -3498,11 +3498,11 @@ processing instructions can be run against remote source documents by
 providing the url of the documents against which the processing instructions
 are to be carried out. The remote
 .B SiSU
-documents can either be sisu marked up files in plaintext .sst or .ssm or;
+documents can either be sisu marked up files in plaintext \.sst or \.ssm or;
 zipped sisu files, sisupod.zip or filename.ssp
 
 .BR
-.B .sst / .ssm \- sisu text files
+.B \.sst / \.ssm \- sisu text files
 
 .BR
 .B SiSU
@@ -3512,7 +3512,7 @@ processing instruction and the url. The source file and any associated parts
 
 
 .nf
-  sisu \-3 http://[provide \ url \ to \ valid \ .sst \ or \ .ssm \ file]
+  sisu \-3 http://[provide \ url \ to \ valid \ \.sst \ or \ \.ssm \ file]
 .fi
 
 .BR
@@ -3524,7 +3524,7 @@ document.
 NOTE: to set up a remote machine to serve
 .B SiSU
 documents in this way, images should be in the directory relative to the
-document source ../_sisu/image
+document source \../_sisu/image
 
 .BR
 .B sisupod \- zipped sisu files
@@ -3541,7 +3541,7 @@ documents it contains generated locally.
 
 
 .nf
-  sisu \-3 http://[provide \ url \ to \ valid \ sisupod.zip \ or \ .ssp \ file]
+  sisu \-3 http://[provide \ url \ to \ valid \ sisupod.zip \ or \ \.ssp \ file]
 .fi
 
 .BR
@@ -3988,7 +3988,7 @@ home site.
 The directory:
 
 .BR
-  ./data/sisu/conf/editor\-syntax\-etc/
+  \./data/sisu/conf/editor\-syntax\-etc/
 
 .BR
   /usr/share/sisu/conf/editor\-syntax\-etc
@@ -4780,7 +4780,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- SiSU information Structuring Universe \- Manual \ [0.58]
+.I SiSU \- Manual
 
 .BR
 DC Creator:
@@ -4828,7 +4828,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu._sst)=
-.I 850b4b4b2da877667488ddfa325b6581
+.I 4c33c586109800b635ffe667a0cf217f
 
 .BR
 Skin_Digest:
@@ -4840,13 +4840,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:13:56 +0100 2007
+.I Mon Sep 24 15:36:12 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -4854,8 +4854,7 @@ Ruby version:
 
 .TP
 .BI 1.
-\"
-.B SiSU
+\"  \.B SiSU
 information Structuring Universe\" or \"Structured information, Serialized
 Units\".
  also chosen for the meaning of the Finnish term "sisu".
@@ -4957,14 +4956,14 @@ Table from the Wealth of Networks by Yochai Benkler
  <http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler>
 .TP
 .BI 22.
-.ssc (for composite) is under consideration but ._sst makes clear that this
+\.ssc (for composite) is under consideration but \._sst makes clear that this
 is not a regular file to be worked on, and thus less likely that people will
-have \"accidents\", working on a .ssc file that is overwritten by subsequent
-processing. It may be however that when the resulting file is shared .ssc is an
+have \"accidents\", working on a \.ssc file that is overwritten by subsequent
+processing. It may be however that when the resulting file is shared \.ssc is an
 appropriate suffix to use.
 .TP
 .BI 23.
-.B SiSU
+\.B SiSU
 has worked this way in the past, though this was dropped as it was thought
 the complexity outweighed the flexibility, however, the balance was rather fine
 and this behaviour could be reinstated.
@@ -5007,10 +5006,8 @@ There is nothing to stop MySQL support being added in future.
 <http://www.jus.uio.no/sisu/man>
 .TP
 .BI 33.
-the
-.B Debian
-Free Software guidelines require that everything distributed within
-.B Debian
+the  \.B Debian
+Free Software guidelines require that everything distributed within  \.B Debian
 can be changed - and the documents are authors\' works that while freely
 distributable are not freely changeable.
 .TP
@@ -5033,10 +5030,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:04 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:29 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_commands.1 b/man/man1/sisu_commands.1
index eba91bb4..af879add 100644
--- a/man/man1/sisu_commands.1
+++ b/man/man1/sisu_commands.1
@@ -1,6 +1,6 @@
-.TH "sisu_commands" "1" "2007-09-16" "0.58.3" "SiSU"
+.TH "sisu_commands" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- COMMANDS \ [0.58],
+SISU \- COMMANDS,
 RALPH AMISSAH
 .BR
 
@@ -119,17 +119,17 @@ provides some information on setting up hyperestraier for sisu
 
 .TP
 .B \ \-H \ \ [filename/wildcard]
-produces html without link suffixes (.html .pdf etc.) (\"Hide\"). Requires an
-appropriately configured web server. \ [behaviour \ switched \ after \ 0.35 \
-see \ \-h].
+produces html without link suffixes (.html \.pdf etc.) (\"Hide\"). Requires
+an appropriately configured web server. \ [behaviour \ switched \ after \ 0.35
+\ see \ \-h].
 
 .TP
 .B \ \-h \ \ [filename/wildcard]
 produces html (with hardlinks i.e. with name suffixes in links/local urls).
 html, with internal document links that include the document suffix, i.e.
-whether it is .html or .pdf (required for browsing directly off a file system,
-and works with most web servers). \ [behaviour \ switched \ after \ 0.35 \ see
-\ \-H].
+whether it is \.html or \.pdf (required for browsing directly off a file
+system, and works with most web servers). \ [behaviour \ switched \ after \
+0.35 \ see \ \-H].
 
 .TP
 .B \ \-I \ \ [filename/wildcard]
@@ -197,7 +197,7 @@ that you have your \"keys\" and ssh agent in place. Also see \-R
 \ produces \ a \ sisupod \ a \ zipped \ sisu \ directory \ of \ markup \
 files \ including \ sisu \ markup \ source \ files \ and \ the \ directories \
 local \ configuration \ file, \ images \ and \ skins. \ Note: \ this \ only \
-includes \ the \ configuration \ files \ or \ skins \ contained \ in \ ./_sisu
+includes \ the \ configuration \ files \ or \ skins \ contained \ in \ \./_sisu
 \ not \ those \ in \ ~/.sisu \ \-S \ \ [filename/wildcard] option. Note: (this
 option is tested only with zsh).
 
@@ -205,7 +205,7 @@ option is tested only with zsh).
 .B \ \-S \ \ [filename/wildcard]
 produces a zipped file of the prepared document specified along with
 associated images, by default named sisupod.zip they may alternatively be named
-with the filename extension .ssp This provides a quick way of gathering the
+with the filename extension \.ssp This provides a quick way of gathering the
 relevant parts of a sisu document which can then for example be emailed. A
 sisupod includes sisu markup source file, (along with associated documents if a
 master file, or available in multilingual versions), together with related
@@ -468,7 +468,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- Commands \ [0.58]
+.I SiSU \- Commands
 
 .BR
 DC Creator:
@@ -516,7 +516,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_commands.sst)=
-.I 8101d9e72f3de2510ef887202f8db3f9
+.I 68a4087f984baffbea779da25e1b6141
 
 .BR
 Skin_Digest:
@@ -528,13 +528,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:13:58 +0100 2007
+.I Mon Sep 24 15:36:13 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -566,10 +566,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:05 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:30 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_configuration.1 b/man/man1/sisu_configuration.1
index 8dcb0560..7c3f364c 100644
--- a/man/man1/sisu_configuration.1
+++ b/man/man1/sisu_configuration.1
@@ -1,6 +1,6 @@
-.TH "sisu_configuration" "1" "2007-08-30" "0.58.3" "SiSU"
+.TH "sisu_configuration" "1" "2007-08-30" "0.59.0" "SiSU"
 .SH
-SISU \- CONFIGURATION \ [0.58],
+SISU \- CONFIGURATION,
 RALPH AMISSAH
 .BR
 
@@ -54,7 +54,7 @@ resource configuration is determined by looking at the following files if
 they exist:
 
 .BR
-  ./_sisu/sisurc.yml
+  \./_sisu/sisurc.yml
 
 .BR
   ~/.sisu/sisurc.yml
@@ -91,7 +91,7 @@ Skins modify the default appearance of document output on a document,
 directory, or site wide basis. Skins are looked for in the following locations:
 
 .BR
-  ./_sisu/skin
+  \./_sisu/skin
 
 .BR
   ~/.sisu/skin
@@ -104,13 +104,13 @@ directory, or site wide basis. Skins are looked for in the following locations:
 are the following the default sub\-directories for document skins:
 
 .BR
-  ./skin/doc
+  \./skin/doc
 
 .BR
-  ./skin/dir
+  \./skin/dir
 
 .BR
-  ./skin/site
+  \./skin/site
 
 .BR
 A skin is placed in the appropriate directory and the file named skin_[name].rb
@@ -211,7 +211,7 @@ directory structure and organisation of content.
 .BR
 Custom built pages, including the home page index.html may be placed within the
 configuration directory _sisu/home/ in any of the locations that is searched
-for the configuration directory, namely ./_sisu; ~/_sisu; /etc/sisu From there
+for the configuration directory, namely \./_sisu; ~/_sisu; /etc/sisu From there
 they are copied to the root of the output directory with the command:
 
 .BR
@@ -271,7 +271,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- Configuration \ [0.58]
+.I SiSU \- Configuration
 
 .BR
 DC Creator:
@@ -318,7 +318,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_configuration._sst)=
-.I 2a18ae8bbfec534c6e064d666ffbe20d
+.I 491d3da039162d60ae0e2951aa260915
 
 .BR
 Skin_Digest:
@@ -330,13 +330,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:02 +0100 2007
+.I Mon Sep 24 15:36:17 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -359,10 +359,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_help.1 b/man/man1/sisu_help.1
index bb6d470b..7d8a2da8 100644
--- a/man/man1/sisu_help.1
+++ b/man/man1/sisu_help.1
@@ -1,6 +1,6 @@
-.TH "sisu_help" "1" "2007-08-30" "0.58.3" "SiSU - SiSU information Structuring Universe"
+.TH "sisu_help" "1" "2007-08-30" "0.59.0" "SiSU"
 .SH
-SISU \- SISU INFORMATION STRUCTURING UNIVERSE \- MANUAL \ [0.58],
+SISU \- HELP,
 RALPH AMISSAH
 .BR
 
@@ -39,7 +39,7 @@ Within the
 tarball at:
 
 .BR
-  ./data/doc/sisu/sisu_manual/
+  \./data/doc/sisu/sisu_manual/
 
 .SH
 1.2 SISU MAN PAGES
@@ -67,7 +67,7 @@ the sisu manual, the sources files for which are located within the
 tarball at:
 
 .BR
-  ./data/doc/sisu/sisu_manual/
+  \./data/doc/sisu/sisu_manual/
 
 .BR
 Once installed, directory equivalent to:
@@ -82,7 +82,7 @@ Available man pages are converted back to html using man2html:
   /usr/share/doc/sisu/html/
 
 .BR
-  ./data/doc/sisu/html/
+  \./data/doc/sisu/html/
 
 .BR
 The
@@ -196,7 +196,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- SiSU information Structuring Universe \- Manual \ [0.58]
+.I SiSU \- Help
 
 .BR
 DC Creator:
@@ -244,7 +244,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_help.sst)=
-.I 387208846e53080b55b39cf92b70aaa9
+.I 66d04ba5f3dd4ede774ffa5549b3faba
 
 .BR
 Skin_Digest:
@@ -256,13 +256,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:13:57 +0100 2007
+.I Mon Sep 24 15:36:13 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -309,10 +309,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_help/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:05 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:30 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_help_sources.1 b/man/man1/sisu_help_sources.1
index 4e1f84e4..058f7097 100644
--- a/man/man1/sisu_help_sources.1
+++ b/man/man1/sisu_help_sources.1
@@ -1,4 +1,4 @@
-.TH "sisu_help_sources" "1" "2007-09-16" "0.58.3" "SiSU"
+.TH "sisu_help_sources" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
 SISU \- REFERENCES,
 RALPH AMISSAH
@@ -688,13 +688,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:13:58 +0100 2007
+.I Mon Sep 24 15:36:13 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -720,10 +720,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:05 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:30 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_markup.1 b/man/man1/sisu_markup.1
index 474c67d8..3addf826 100644
--- a/man/man1/sisu_markup.1
+++ b/man/man1/sisu_markup.1
@@ -1,6 +1,6 @@
-.TH "sisu_markup" "1" "2007-09-16" "0.58.3" "SiSU"
+.TH "sisu_markup" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- MARKUP \ [0.58],
+SISU \- MARKUP,
 RALPH AMISSAH
 .BR
 
@@ -123,7 +123,7 @@ This current document has a header similar to this one (without the comments):
 .nf
   % SiSU 0.57
   @title: SiSU
-  @subtitle: Markup \ [0.58]
+  @subtitle: Markup
   @creator: Ralph Amissah
   @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
   @type: information
@@ -136,7 +136,7 @@ This current document has a header similar to this one (without the comments):
   @level: new=C; break=1; num_top=1
   % comment: in this @level header num_top=1 starts automatic heading numbering at heading level 1 (numbering continues 3 levels down); the new and break instructions are used by the LaTeX/pdf and odf output to determine where to put page breaks (that are not used by html output or say sql database population).
   @skin: skin_sisu_manual
-  % 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)
+  % 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
@@ -398,7 +398,7 @@ free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst]
 3.1 HEADING LEVELS
 
 .BR
-Heading levels are :A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ ... :A \- :C being part / section
+Heading levels are :A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ \... :A \- :C being part / section
 headings, followed by other heading levels, and 1 \-6 being headings followed
 by substantive text or sub\-headings. :A~ usually the title :A~? conditional
 level 1 heading (used where a stand\-alone document may be imported into
@@ -851,7 +851,7 @@ information in each column
   Very active contributors***     |        0|       31|      190|      692|    1,639|    3,016
   No. of English language articles|       25|   16,000|  101,000|  190,000|  320,000|  630,000
   No. of articles, all languages  |       25|   19,000|  138,000|  490,000|  862,000|1,600,000
-  \* Contributed at least ten times; \** at least 5 times in last month; \*\** more than 100 times in last month.
+  \\* Contributed at least ten times; \\** at least 5 times in last month; \\*\** more than 100 times in last month.
 .fi
 
 .BR
@@ -1263,17 +1263,17 @@ generated independently, or they could be markup snippets, prepared so as to be
 easily available to be placed within another text. If the calling document is a
 master document (built from other documents), it should be named with the
 suffix
-.B .ssm
+.B \.ssm
 Within this document you would provide information on the other documents
 that should be included within the text. These may be other documents that
 would be processed in a regular way, or markup bits prepared only for inclusion
 within a master document
-.B .sst
+.B \.sst
 regular markup file, or
-.B .ssi
+.B \.ssi
 (insert/information) A secondary file of the composite document is built
 prior to processing with the same prefix and the suffix
-.B ._sst
+.B \._sst
 
 .BR
 basic markup for importing a document into a master document
@@ -1352,8 +1352,8 @@ variations include \'
 
 .BR
 .B 0.37
-(2006w09/7) introduced new file naming convention, .sst (text), .ssm
-(master), .ssi (insert), markup syntax unchanged
+(2006w09/7) introduced new file naming convention, \.sst (text), \.ssm
+(master), \.ssi (insert), markup syntax unchanged
 
 .BR
 .B 0.35
@@ -1399,7 +1399,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- Markup \ [0.58]
+.I SiSU \- Markup
 
 .BR
 DC Creator:
@@ -1447,7 +1447,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_markup.sst)=
-.I 643738c4b96d001d107e3ea72ba17a97
+.I 6848f40f5844e0a7d59dbb86b3ddae92
 
 .BR
 Skin_Digest:
@@ -1459,13 +1459,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:13:59 +0100 2007
+.I Mon Sep 24 15:36:14 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -1523,10 +1523,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:06 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:30 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_skin.1 b/man/man1/sisu_skin.1
index eb6d825d..ce5537a9 100644
--- a/man/man1/sisu_skin.1
+++ b/man/man1/sisu_skin.1
@@ -1,6 +1,6 @@
-.TH "sisu_skin" "1" "2007-09-16" "0.58.3" "SiSU"
+.TH "sisu_skin" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SKINS \ [0.58],
+SISU \- SKINS,
 RALPH AMISSAH
 .BR
 
@@ -17,7 +17,7 @@ Skins modify the default appearance of document output on a document,
 directory, or site wide basis. Skins are looked for in the following locations:
 
 .BR
-  ./_sisu/skin
+  \./_sisu/skin
 
 .BR
   ~/.sisu/skin
@@ -30,13 +30,13 @@ directory, or site wide basis. Skins are looked for in the following locations:
 are the following the default sub\-directories for document skins:
 
 .BR
-  ./skin/doc
+  \./skin/doc
 
 .BR
-  ./skin/dir
+  \./skin/dir
 
 .BR
-  ./skin/site
+  \./skin/site
 
 .BR
 A skin is placed in the appropriate directory and the file named skin_[name].rb
@@ -124,7 +124,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- Skins \ [0.58]
+.I SiSU \- Skins
 
 .BR
 DC Creator:
@@ -172,7 +172,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_skin.sst)=
-.I 3686b1b7864132c8d6ab3b0398d6e2ae
+.I 8aebfb5312045c3a705ad6c314246f67
 
 .BR
 Skin_Digest:
@@ -184,13 +184,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:13:59 +0100 2007
+.I Mon Sep 24 15:36:15 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -213,10 +213,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:06 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:31 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_webrick.1 b/man/man1/sisu_webrick.1
index 337aa335..45e306ae 100644
--- a/man/man1/sisu_webrick.1
+++ b/man/man1/sisu_webrick.1
@@ -1,6 +1,6 @@
-.TH "sisu_webrick" "1" "2007-09-16" "0.58.3" "SiSU"
+.TH "sisu_webrick" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SISU_WEBRICK \ [0.58],
+SISU \- SISU_WEBRICK,
 RALPH AMISSAH
 .BR
 
@@ -121,7 +121,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- sisu_webrick \ [0.58]
+.I SiSU \- sisu_webrick
 
 .BR
 DC Creator:
@@ -169,7 +169,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_webrick.sst)=
-.I d288c50a18a6d7464fdb3413479b8b98
+.I 2ed989fa51df49e85d1161f4a4afc897
 
 .BR
 Skin_Digest: MD5(/etc/sisu/skin/doc/skin_sisu.rb)=
@@ -180,13 +180,13 @@ Skin_Digest: MD5(/etc/sisu/skin/doc/skin_sisu.rb)=
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:00 +0100 2007
+.I Mon Sep 24 15:36:15 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -209,10 +209,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_webrick/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:06 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:31 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_complete.7 b/man/man7/sisu_complete.7
index 3e3294b7..95ccdb8f 100644
--- a/man/man7/sisu_complete.7
+++ b/man/man7/sisu_complete.7
@@ -1,6 +1,6 @@
-.TH "sisu_complete" "1" "2007-09-16" "0.58.3" "SiSU"
+.TH "sisu_complete" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- COMPLETE PACKAGE \ [0.58],
+SISU \- COMPLETE PACKAGE,
 RALPH AMISSAH
 .BR
 
@@ -83,7 +83,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- Complete Package \ [0.58]
+.I SiSU \- Complete Package
 
 .BR
 DC Creator:
@@ -131,7 +131,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_complete.sst)=
-.I 42003f9cf59fd7e4ddffae864e2c4179
+.I 0974a5dfc0c6bc648ac21c688177bec0
 
 .BR
 Skin_Digest:
@@ -143,13 +143,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:02 +0100 2007
+.I Mon Sep 24 15:36:18 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -172,10 +172,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_complete/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_doc.7 b/man/man7/sisu_doc.7
new file mode 100644
index 00000000..d75f1180
--- /dev/null
+++ b/man/man7/sisu_doc.7
@@ -0,0 +1,160 @@
+.TH "sisu_doc" "1" "2007-09-24" "0.59.0" "SiSU"
+.SH
+SISU \- SISU\-DOC,
+RALPH AMISSAH
+.BR
+
+.SH
+SISU DOC
+.BR
+
+.SH
+SISU\-DOC
+.BR
+
+.SH
+1.1 NAME
+
+.BR
+.B SiSU
+\- Structured information, Serialized Units \- a document publishing system.
+
+.BR
+Information related to sisu documentation
+
+.SH
+1.2 DESCRIPTION
+
+.BR
+sisu documentation is installed in /usr/share/doc/sisu/sisu_manual or
+equivalent directory
+
+.BR
+file:///usr/share/doc/sisu/sisu_manual
+
+.BR
+file:///usr/share/doc/sisu/sisu_manual/sisu_manual/
+
+.BR
+<http://www.jus.uio.no/sisu/sisu_manual>
+
+.BR
+<http://www.sisudoc.org/sisu_manual>
+
+.SH
+DOCUMENT INFORMATION (METADATA)
+.BR
+
+.SH
+METADATA
+.BR
+
+.BR
+Document Manifest @
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_doc/sisu_manifest.html>
+
+.BR
+.B Dublin Core
+(DC)
+
+.BR
+.I DC tags included with this document are provided here.
+
+.BR
+DC Title:
+.I SiSU \- sisu\-doc
+
+.BR
+DC Creator:
+.I Ralph Amissah
+
+.BR
+DC Rights:
+.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
+3
+
+.BR
+DC Type:
+.I information
+
+.BR
+DC Date created:
+.I 2007\-09\-24
+
+.BR
+DC Date issued:
+.I 2007\-09\-24
+
+.BR
+DC Date available:
+.I 2007\-09\-24
+
+.BR
+DC Date modified:
+.I 2007\-09\-24
+
+.BR
+DC Date:
+.I 2007\-09\-24
+
+.BR
+.B Version Information
+
+.BR
+Sourcefile:
+.I sisu_doc.sst
+
+.BR
+Filetype:
+.I SiSU text 0.58
+
+.BR
+Sourcefile Digest, MD5(sisu_doc.sst)=
+.I 00116fb664a23c87ce52dbe0d4c5a702
+
+.BR
+Skin_Digest:
+MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
+.I 20fc43cf3eb6590bc3399a1aef65c5a9
+
+.BR
+.B Generated
+
+.BR
+Document (metaverse) last generated:
+.I Mon Sep 24 15:36:19 +0100 2007
+
+.BR
+Generated by:
+.I SiSU
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
+
+.BR
+Ruby version:
+.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
+
+
+.TP
+Other versions of this document:
+.TP
+manifest: <http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html>
+.TP
+html: <http://www.jus.uio.no/sisu/sisu_doc/toc.html>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf>
+." .TP
+." manpage: http://www.jus.uio.no/sisu/sisu_doc/sisu_doc.1
+.TP
+at: <http://www.jus.uio.no/sisu>
+.TP
+.TP
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
+.TP
+* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
+.TP
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
+.TP
+* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_pdf.7 b/man/man7/sisu_pdf.7
index 00ca7889..3eb72700 100644
--- a/man/man7/sisu_pdf.7
+++ b/man/man7/sisu_pdf.7
@@ -1,19 +1,15 @@
-.TH "sisu_pdf" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe"
+.TH "sisu_pdf" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SISU INFORMATION STRUCTURING UNIVERSE \- SEARCH \ [0.58],
+SISU \- PDF,
 RALPH AMISSAH
 .BR
 
 .SH
-SISU SEARCH
+SISU PDF
 .BR
 
 .SH
-SISU SQLITE
-.BR
-
-.SH
-1. SQLITE
+1. SISU PDF
 .BR
 
 .SH
@@ -118,7 +114,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- SiSU information Structuring Universe \- Search \ [0.58]
+.I SiSU \- PDF
 
 .BR
 DC Creator:
@@ -166,7 +162,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_pdf.sst)=
-.I 161d3f57a0c3b9e816474243229cb423
+.I 63bca4cff790aa5ca87bea788c520076
 
 .BR
 Skin_Digest:
@@ -178,13 +174,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:03 +0100 2007
+.I Mon Sep 24 15:36:19 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -207,10 +203,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_pdf/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_postgresql.7 b/man/man7/sisu_postgresql.7
index 4a550af0..5eff9870 100644
--- a/man/man7/sisu_postgresql.7
+++ b/man/man7/sisu_postgresql.7
@@ -1,6 +1,6 @@
-.TH "sisu_postgresql" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe"
+.TH "sisu_postgresql" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SISU INFORMATION STRUCTURING UNIVERSE \- SEARCH \ [0.58],
+SISU \- SEARCH,
 RALPH AMISSAH
 .BR
 
@@ -125,7 +125,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- SiSU information Structuring Universe \- Search \ [0.58]
+.I SiSU \- Search
 
 .BR
 DC Creator:
@@ -173,7 +173,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_postgresql.sst)=
-.I b81ba44e7946dfaf03d26f0dc5d749ab
+.I 5f9ca1acb186a64f8e924876892dc25e
 
 .BR
 Skin_Digest:
@@ -185,13 +185,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:03 +0100 2007
+.I Mon Sep 24 15:36:18 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -214,10 +214,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_postgresql/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_sqlite.7 b/man/man7/sisu_sqlite.7
index fa162cc3..3e43fa62 100644
--- a/man/man7/sisu_sqlite.7
+++ b/man/man7/sisu_sqlite.7
@@ -1,6 +1,6 @@
-.TH "sisu_sqlite" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe"
+.TH "sisu_sqlite" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SISU INFORMATION STRUCTURING UNIVERSE \- SEARCH \ [0.58],
+SISU \- SEARCH,
 RALPH AMISSAH
 .BR
 
@@ -124,7 +124,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- SiSU information Structuring Universe \- Search \ [0.58]
+.I SiSU \- Search
 
 .BR
 DC Creator:
@@ -172,7 +172,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_sqlite.sst)=
-.I 61ba58f6a2f5cc9651b985a8eabb96e9
+.I 2ffb869c7c41615ca4ec83d8bd70470d
 
 .BR
 Skin_Digest:
@@ -184,13 +184,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:03 +0100 2007
+.I Mon Sep 24 15:36:18 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -213,10 +213,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_sqlite/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_vim.7 b/man/man7/sisu_vim.7
index 65d97d53..bce1238d 100644
--- a/man/man7/sisu_vim.7
+++ b/man/man7/sisu_vim.7
@@ -1,4 +1,4 @@
-.TH "sisu_vim" "1" "2007-09-16" "0.58.3" "SiSU"
+.TH "sisu_vim" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
 SISU \- VIM,
 RALPH AMISSAH
@@ -49,8 +49,8 @@ Vim related files are included in: /usr/share/sisu/conf/editor\-syntax\-etc/vim
 Vim).
 
 .BR
-sisu\-vim actions are activated on files with the suffix .sst .ssm .ssi .\-sst
-._sst (and the same with a further .meta extension)
+sisu\-vim actions are activated on files with the suffix \.sst \.ssm \.ssi
+\.\-sst \._sst (and the same with a further \.meta extension)
 
 
 .nf
@@ -158,13 +158,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:04 +0100 2007
+.I Mon Sep 24 15:36:19 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -187,10 +187,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_vim/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_faq.8 b/man/man8/sisu_faq.8
index 3146086c..308f6a21 100644
--- a/man/man8/sisu_faq.8
+++ b/man/man8/sisu_faq.8
@@ -1,7 +1,6 @@
-.TH "sisu_faq" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe / Structured information, Serialized Units"
+.TH "sisu_faq" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SISU INFORMATION STRUCTURING UNIVERSE / STRUCTURED INFORMATION,
-SERIALIZED UNITS \- FAQ \- FREQUENTLY ASKED/ANSWERED QUESTIONS,
+SISU \- FAQ \- FREQUENTLY ASKED/ANSWERED QUESTIONS,
 RALPH AMISSAH
 .BR
 
@@ -92,7 +91,7 @@ should also provide some relevant information as to where it is placed.
 
 .BR
 I worked with text and (though I find XML immensely valuable) disliked noise
-... better to sidestep the question and say:
+\... better to sidestep the question and say:
 
 .BR
 .B SiSU
@@ -302,8 +301,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- SiSU information Structuring Universe / Structured information,
-Serialized Units \- FAQ \- Frequently Asked/Answered Questions
+.I SiSU \- FAQ \- Frequently Asked/Answered Questions
 
 .BR
 DC Creator:
@@ -351,7 +349,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_faq.sst)=
-.I 4ba78b1270b9d994054c1ff06d58765d
+.I 41577c9fc063cd232914a1a11a59e91a
 
 .BR
 Skin_Digest:
@@ -363,13 +361,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:01 +0100 2007
+.I Mon Sep 24 15:36:17 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -395,10 +393,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_howto.8 b/man/man8/sisu_howto.8
index 42bd1caf..3aebd30b 100644
--- a/man/man8/sisu_howto.8
+++ b/man/man8/sisu_howto.8
@@ -1,7 +1,6 @@
-.TH "sisu_howto" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe / Structured information, Serialized Units"
+.TH "sisu_howto" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SISU INFORMATION STRUCTURING UNIVERSE / STRUCTURED INFORMATION,
-SERIALIZED UNITS \- TECHNICAL, HOWTO,
+SISU \- TECHNICAL, HOWTO,
 RALPH AMISSAH
 .BR
 
@@ -385,13 +384,13 @@ and on installation under:
 The following paths are searched:
 
 .BR
-  ./_sisu/sisurc.yaml
+  \./_sisu/sisurc.yaml
 
 .BR
   ~/.sisu/sisurc.yaml
 
 .BR
-  ./etc/sisu/sisurc.yaml
+  \./etc/sisu/sisurc.yaml
 
 .SH
 4. MARKUP
@@ -463,7 +462,7 @@ words to be made bold within the document
 
 .BR
 Defaults are set. You may change the face to: bold, italics, underscore,
-strikethrough, ...
+strikethrough, \...
 
 .SH
 4.2.1 BOLD
@@ -820,7 +819,7 @@ and on installation under:
 The following paths are searched:
 
 .BR
-  ./_sisu/skin
+  \./_sisu/skin
 
 .BR
   ~/.sisu/skin
@@ -945,9 +944,9 @@ remaining simple.
 .B SiSU
 implements across document formats a \"useful common feature set\" \ [coming
 \ from \ a \ humanities, \ law, \ and \ possibly \ social \ sciences \
-perspective, \ rather \ than \ technical \ or \ scientific \ writing] ... focus
-is primarily on content and data integrity rather than appearance, (though
-outputs in the various formats are respectable).
+perspective, \ rather \ than \ technical \ or \ scientific \ writing] \...
+focus is primarily on content and data integrity rather than appearance,
+(though outputs in the various formats are respectable).
 
 .BR
 A vim syntax highlighting file and an ftplugin with folds for sisu markup is
@@ -1120,7 +1119,7 @@ They may be downloaded from:
   <http://www.jus.uio.no/sisu/SiSU/download.html#rpm>
 
 .SH
-6.2.3 SOURCE PACKAGE .TGZ
+6.2.3 SOURCE PACKAGE \.TGZ
 
 .BR
 Otherwise to install
@@ -1234,13 +1233,13 @@ in the root directory of the unpacked
 as root type:
 
 .BR
-  ruby ./sisu\-install
+  ruby \./sisu\-install
 
 .BR
 or
 
 .BR
-  ruby ./sisu\-install base
+  ruby \./sisu\-install base
 
 .BR
 This makes use of Rant (by Stefan Lang) and the provided Rantfile. It has been
@@ -1261,10 +1260,10 @@ further information:
 For a list of alternative actions you may type:
 
 .BR
-  ruby ./sisu\-install help
+  ruby \./sisu\-install help
 
 .BR
-  ruby ./sisu\-install \-T
+  ruby \./sisu\-install \-T
 
 .SH
 6.3 DEPENDENCIES
@@ -1275,7 +1274,7 @@ that sisu makes use of, and that you may need or wish to install. (this will
 depend on such factors as whether you want to generate pdf, whether you will be
 using
 .B SiSU
-with or without a database, ...) \'man sisu_markup\-samples\' may also be of
+with or without a database, \...) \'man sisu_markup\-samples\' may also be of
 interest if the sisu\-markup\-samples package has also been installed.
 
 .BR
@@ -1342,7 +1341,7 @@ other things provides the dependencies of sisu within
   Description: documents \- structuring, publishing in multiple formats and search
    SiSU is a lightweight markup based, command line oriented, document
    structuring, publishing and search framework for document collections.
-   .
+   \.
    With minimal preparation of a plain\-text, (UTF\-8) file, using its native
    markup syntax in your text editor of choice, SiSU can generate various
    document formats (most of which share a common object numbering system for
@@ -1355,24 +1354,24 @@ other things provides the dependencies of sisu within
    works that are frequently changed or updated) for which it provides a fixed
    means of reference of content. Document outputs also share semantic meta\-data
    provided.
-   .
+   \.
    SiSU also provides concordance files, document content certificates and
    manifests of generated output.
-   .
+   \.
    A vim syntax highlighting file and an ftplugin with folds for sisu markup is
    provided, as are syntax highlighting files for kate, kwrite, gedit and
    diakonos. Vim 7 includes syntax highlighting for SiSU.
-   .
+   \.
    man pages, and interactive help are provided.
-   .
+   \.
    Dependencies for various features are taken care of in sisu related packages.
    The package sisu\-complete installs the whole of SiSU.
-   .
+   \.
    Additional document markup samples are provided in the package
    sisu\-markup\-samples which is found in the non\-free archive the licenses for
    the substantive content of the marked up documents provided is that provided
    by the author or original publisher.
-   .
+   \.
     Homepage: <http://www.jus.uio.no/sisu>
 .fi
 
@@ -1385,11 +1384,11 @@ other things provides the dependencies of sisu within
   Description: installs all SiSU related packages
    This package installs SiSU and related packages that enable sisu to produce
    pdf and to populate postgresql and sqlite databases.
-   .
+   \.
    SiSU is a lightweight markup based document publishing framework.
-   .
+   \.
    See sisu for a description of the package.
-   .
+   \.
     Homepage: <http://www.jus.uio.no/sisu>
 .fi
 
@@ -1401,9 +1400,9 @@ other things provides the dependencies of sisu within
   #Suggests: evince, xpdf
   Description: dependencies to convert SiSU LaTeX output to pdf
    This package enables the conversion of SiSU LaTeX output to pdf.
-   .
+   \.
    SiSU is a lightweight markup based document publishing framework.
-   .
+   \.
     Homepage: <http://www.jus.uio.no/sisu>
 .fi
 
@@ -1417,15 +1416,15 @@ other things provides the dependencies of sisu within
   Description: SiSU dependencies for use with postgresql database
    This package enables SiSU to populate a postgresql database. This is done at
    an object/paragraph level, making granular searches of documents possible.
-   .
+   \.
    This relational database feature of SiSU is not required but provides
    interesting possibilities, including that of granular searches of documents
    for matching units of text, primarily paragraphs that can be displayed or
    identified by object citation number, from which an index of documents
    matched and each matched paragraph within them can be displayed.
-   .
+   \.
    SiSU is a lightweight markup based document publishing framework.
-   .
+   \.
     Homepage: <http://www.jus.uio.no/sisu>
 .fi
 
@@ -1438,15 +1437,15 @@ other things provides the dependencies of sisu within
   Description: SiSU dependencies for use with sqlite database
    This package enables SiSU to populate an sqlite database. This is done at an
    object/paragraph level, making granular searches of documents possible.
-   .
+   \.
    This relational database feature of SiSU is not required but provides
    interesting possibilities, including that of granular searches of documents
    for matching units of text, primarily paragraphs that can be displayed or
    identified by object citation number, from which an index of documents
    matched and each matched paragraph within them can be displayed.
-   .
+   \.
    SiSU is a lightweight markup based document publishing framework.
-   .
+   \.
     Homepage: <http://www.jus.uio.no/sisu>
 .fi
 
@@ -1565,7 +1564,7 @@ documents within ~/.sisu/skin
 .BR
 * additional software \- eg. Tex and LaTeX (tetex, tetex\-base, tetex\-extra on
 .B Debian
-), Postgresql, \ [sqlite], trang, tidy, makeinfo, ... none of which are
+), Postgresql, \ [sqlite], trang, tidy, makeinfo, \... none of which are
 required for basic html or XML processing.
 
 .BR
@@ -1591,7 +1590,7 @@ using the defaults).
 Documents are marked up in
 .B SiSU
 syntax and kept in an ordinary text editable file, named with the suffix
-.sst, or .ssm
+\.sst, or \.ssm
 
 .BR
 Marked up
@@ -1684,7 +1683,7 @@ or
 .BR
 The defaults can be changed via
 .B SiSU
-\'s configure file sisurc.yml which the program expects to find in ./_sisu
+\'s configure file sisurc.yml which the program expects to find in \./_sisu
 ~/.sisu or /etc/sisu (searched in that order, stopping on the first one found)
 
 .SH
@@ -1718,7 +1717,7 @@ Sample marked up document are provided with the download tarball in the
 directory:
 
 .BR
-  ./data/doc/sisu/sisu_markup_samples/dfsg
+  \./data/doc/sisu/sisu_markup_samples/dfsg
 
 .BR
 These are installed on the system usually at:
@@ -1746,7 +1745,7 @@ There is syntax support for some editors provided (together with a README file)
 in
 
 .BR
-  ./data/sisu/conf/syntax
+  \./data/sisu/conf/syntax
 
 .BR
 usually installed to:
@@ -1761,7 +1760,7 @@ usually installed to:
 License: GPL 3 or later see the copyright file in
 
 .BR
-  ./data/doc/sisu
+  \./data/doc/sisu
 
 .BR
 usually installed to:
@@ -1801,7 +1800,7 @@ object citation numbering and system
 CHANGELOG
 
 .BR
-  ./CHANGELOG
+  \./CHANGELOG
 
 .BR
 and see
@@ -1976,7 +1975,7 @@ to your flags.
 configuration file search path is:
 
 .BR
-  ./_sisu/sisurc.yaml
+  \./_sisu/sisurc.yaml
 
 .BR
   ~/.sisu/sisurc.yaml
@@ -2090,7 +2089,7 @@ default document appearance may be modified using skins contained in
 sub\-directories located at the following paths:
 
 .BR
-  ./_sisu/skin
+  \./_sisu/skin
 
 .BR
   ~/.sisu/skin
@@ -2151,8 +2150,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- SiSU information Structuring Universe / Structured information,
-Serialized Units \- Technical, Howto
+.I SiSU \- Technical, Howto
 
 .BR
 DC Creator:
@@ -2200,7 +2198,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_howto.sst)=
-.I 82c606e66689bcb5d190edf8fc7227a0
+.I bb17770a0fa5b4ef035ebf0bcfca3faa
 
 .BR
 Skin_Digest:
@@ -2212,13 +2210,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:01 +0100 2007
+.I Mon Sep 24 15:36:16 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -2274,10 +2272,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:06 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:31 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_quickstart.8 b/man/man8/sisu_quickstart.8
index e13f84e4..eb952758 100644
--- a/man/man8/sisu_quickstart.8
+++ b/man/man8/sisu_quickstart.8
@@ -1,7 +1,6 @@
-.TH "sisu_quickstart" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe / Structured information, Serialized Units"
+.TH "sisu_quickstart" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SISU INFORMATION STRUCTURING UNIVERSE / STRUCTURED INFORMATION,
-SERIALIZED UNITS \- QUICKSTART, INSTALLATION AND USE,
+SISU \- QUICKSTART, INSTALLATION AND USE,
 RALPH AMISSAH
 .BR
 
@@ -398,8 +397,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- SiSU information Structuring Universe / Structured information,
-Serialized Units \- Quickstart, installation and use
+.I SiSU \- Quickstart, installation and use
 
 .BR
 DC Creator:
@@ -447,7 +445,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_quickstart.sst)=
-.I 05a047fd659fbbeaa3cdb982b5911bcd
+.I e76db98ca0d8c2bfe526dad55622fa7a
 
 .BR
 Skin_Digest:
@@ -459,13 +457,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:00 +0100 2007
+.I Mon Sep 24 15:36:15 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -485,10 +483,8 @@ There is nothing to stop MySQL support being added in future.
 <http://www.jus.uio.no/sisu/man>
 .TP
 .BI 5.
-the
-.B Debian
-Free Software guidelines require that everything distributed within
-.B Debian
+the  \.B Debian
+Free Software guidelines require that everything distributed within  \.B Debian
 can be changed - and the documents are authors\' works that while freely
 distributable are not freely changeable.
 
@@ -508,10 +504,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:06 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:31 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_remote.8 b/man/man8/sisu_remote.8
index 9da648f2..94ba07f1 100644
--- a/man/man8/sisu_remote.8
+++ b/man/man8/sisu_remote.8
@@ -1,6 +1,6 @@
-.TH "sisu_remote" "1" "2007-09-16" "0.58.3" "SiSU"
+.TH "sisu_remote" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- REMOTE OPERATIONS \ [0.58],
+SISU \- REMOTE OPERATIONS,
 RALPH AMISSAH
 .BR
 
@@ -18,11 +18,11 @@ processing instructions can be run against remote source documents by
 providing the url of the documents against which the processing instructions
 are to be carried out. The remote
 .B SiSU
-documents can either be sisu marked up files in plaintext .sst or .ssm or;
+documents can either be sisu marked up files in plaintext \.sst or \.ssm or;
 zipped sisu files, sisupod.zip or filename.ssp
 
 .BR
-.B .sst / .ssm \- sisu text files
+.B \.sst / \.ssm \- sisu text files
 
 .BR
 .B SiSU
@@ -32,7 +32,7 @@ processing instruction and the url. The source file and any associated parts
 
 
 .nf
-  sisu \-3 http://[provide \ url \ to \ valid \ .sst \ or \ .ssm \ file]
+  sisu \-3 http://[provide \ url \ to \ valid \ \.sst \ or \ \.ssm \ file]
 .fi
 
 .BR
@@ -44,7 +44,7 @@ document.
 NOTE: to set up a remote machine to serve
 .B SiSU
 documents in this way, images should be in the directory relative to the
-document source ../_sisu/image
+document source \../_sisu/image
 
 .BR
 .B sisupod \- zipped sisu files
@@ -61,7 +61,7 @@ documents it contains generated locally.
 
 
 .nf
-  sisu \-3 http://[provide \ url \ to \ valid \ sisupod.zip \ or \ .ssp \ file]
+  sisu \-3 http://[provide \ url \ to \ valid \ sisupod.zip \ or \ \.ssp \ file]
 .fi
 
 .BR
@@ -153,7 +153,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- Remote Operations \ [0.58]
+.I SiSU \- Remote Operations
 
 .BR
 DC Creator:
@@ -201,7 +201,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_remote.sst)=
-.I 5fe0c81eddcd7e3e18608b8e48b3ccad
+.I 9bdac464998dc3f034fbd8f80df23b83
 
 .BR
 Skin_Digest:
@@ -213,13 +213,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:02 +0100 2007
+.I Mon Sep 24 15:36:17 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -242,10 +242,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_search.8 b/man/man8/sisu_search.8
index 039f6e7c..bb0b6301 100644
--- a/man/man8/sisu_search.8
+++ b/man/man8/sisu_search.8
@@ -1,6 +1,6 @@
-.TH "sisu_search" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe"
+.TH "sisu_search" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SISU INFORMATION STRUCTURING UNIVERSE \- SEARCH \ [0.58],
+SISU \- SEARCH,
 RALPH AMISSAH
 .BR
 
@@ -451,7 +451,7 @@ rune along the following lines:
 .BR
   find /home/ralph/sisu_www \-type f | egrep \'/home/ralph/sisu_www/([specify \
   first \ directory \ for \ inclusion]|[specify \ second \ directory \ for \
-  inclusion]|[another \ directory \ for \ inclusion? \ ...])/.+?.html$\' |
+  inclusion]|[another \ directory \ for \ inclusion? \ \...])/.+?.html$\' |
   egrep \-v \'(doc|concordance).html$\' |estcmd gather \-sd
   /home/ralph/sisu_www/casket \-
 
@@ -516,7 +516,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- SiSU information Structuring Universe \- Search \ [0.58]
+.I SiSU \- Search
 
 .BR
 DC Creator:
@@ -564,7 +564,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_search._sst)=
-.I 52c1d6d3c3082e6b236c65debc733a05
+.I c085c2eb6d68f1b7d50435f673ede407
 
 .BR
 Skin_Digest:
@@ -576,13 +576,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:04 +0100 2007
+.I Mon Sep 24 15:36:19 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -630,10 +630,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_search/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_syntax_highlighting.8 b/man/man8/sisu_syntax_highlighting.8
index b2f85d85..a148d8e0 100644
--- a/man/man8/sisu_syntax_highlighting.8
+++ b/man/man8/sisu_syntax_highlighting.8
@@ -1,6 +1,6 @@
-.TH "sisu_syntax_highlighting" "1" "2007-09-16" "0.58.3" "SiSU"
+.TH "sisu_syntax_highlighting" "1" "2007-09-16" "0.59.0" "SiSU"
 .SH
-SISU \- SYNTAX HIGHLIGHTING \ [0.58],
+SISU \- SYNTAX HIGHLIGHTING,
 RALPH AMISSAH
 .BR
 
@@ -16,7 +16,7 @@ SISU SYNTAX HIGHLIGHTING
 The directory:
 
 .BR
-  ./data/sisu/conf/editor\-syntax\-etc/
+  \./data/sisu/conf/editor\-syntax\-etc/
 
 .BR
   /usr/share/sisu/conf/editor\-syntax\-etc
@@ -209,7 +209,7 @@ Document Manifest @
 
 .BR
 DC Title:
-.I SiSU \- Syntax Highlighting \ [0.58]
+.I SiSU \- Syntax Highlighting
 
 .BR
 DC Creator:
@@ -257,7 +257,7 @@ Filetype:
 
 .BR
 Sourcefile Digest, MD5(sisu_syntax_highlighting.sst)=
-.I 1dfe1975df71459c3f56c3fd13c5789c
+.I 28dd0275c6fcd67bbedcd8aee9df4b3e
 
 .BR
 Skin_Digest:
@@ -269,13 +269,13 @@ MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_sam
 
 .BR
 Document (metaverse) last generated:
-.I Sun Sep 23 01:14:02 +0100 2007
+.I Mon Sep 24 15:36:17 +0100 2007
 
 .BR
 Generated by:
 .I SiSU
-.I 0.58.3
-of 2007w36/4 (2007\-09\-06)
+.I 0.59.0
+of 2007w38/0 (2007\-09\-23)
 
 .BR
 Ruby version:
@@ -298,10 +298,10 @@ pdf: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf>
 at: <http://www.jus.uio.no/sisu>
 .TP
 .TP
-* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
 .TP
 * Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
 .TP
-* Last Generated on: Sun Sep 23 01:14:07 +0100 2007
+* Last Generated on: Mon Sep 24 15:36:32 +0100 2007
 .TP
 * SiSU http://www.jus.uio.no/sisu