primarily todo with sisu documentation, changelog reproduced below:

* start documenting sisu using sisu
  * sisu markup source files in
    data/doc/sisu/sisu_markup_samples/sisu_manual/
    /usr/share/doc/sisu/sisu_markup_samples/sisu_manual/
  * default output [sisu -3] in
    data/doc/manuals_generated/sisu_manual/
    /usr/share/doc/manuals_generated/sisu_manual/
    (adds substantially to the size of sisu package!)

* help related edits

* manpage, work on ability to generate manpages, improved

* param, exclude footnote mark count when occurs within code block

* plaintext changes made

* shared_txt, line wrap visited

* file:// link option introduced (in addition to existing https?:// and
  ftp://) a bit arbitrarily, diff here, [double check changes in sysenv and
  hub]

* minor adjustments
  * html url match refinement
  * css added tiny_center

* plaintext
  * endnotes fix
  * footnote adjustment to make more easily distinguishable from substantive
    text
  * flag -a only [flags -A -e -E dropped]
    controlled by modifiers --unix/msdos --footnote/endnote

* defaults, homepage
  * renamed homepage (instead of index) implications for modifying skins,
    which need likewise to have any homepage entry renamed
  * added link to sisu_manual in homepage

* css the css for the default homepage is renamed homepage.css (instead of
  index.css) [consider removing this and relying on html.css]

* ruby version < ruby1.9
  * place stop on installation and working with for now [ruby String.strip
    broken in ruby 1.9.0 (2007-09-10 patchlevel 0) [i486-linux],
    2007-09-18:38/2]
  * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9

* debian
  * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9
  * sisu-doc new sub-package for sisu documentation
    debian/control and sisu-doc.install

5 files changed, 1034 insertions, 55 deletions

diff --git a/man/man7/sisu_complete.7 b/man/man7/sisu_complete.7
new file mode 100644
index 00000000..3e3294b7
--- /dev/null
+++ b/man/man7/sisu_complete.7
@@ -0,0 +1,181 @@
+.TH "sisu_complete" "1" "2007-09-16" "0.58.3" "SiSU"
+.SH
+SISU \- COMPLETE PACKAGE \ [0.58],
+RALPH AMISSAH
+.BR
+
+.SH
+1. SISU_COMPLETE
+.BR
+
+.SH
+1.1 NAME
+
+.BR
+.B SiSU
+\- Structured information, Serialized Units \- a document publishing system,
+complete dependency package
+
+.SH
+1.2 SYNOPSIS
+
+.BR
+.B Debian
+dummy package installs the whole of
+.B SiSU
+, excluding sisu\-examples.
+
+.BR
+sisu\-complete together with sisu\-examples is the whole of
+.B SiSU
+
+.SH
+1.3 FURTHER INFORMATION
+
+.BR
+For more information on
+.B SiSU
+see:
+
+.BR
+<http://www.jus.uio.no/sisu/sisu_manual>
+
+.BR
+<http://www.jus.uio.no/sisu>
+
+.SH
+1.4 AUTHOR
+
+.BR
+Ralph Amissah ralph@amissah.com or ralph.amissah@gmail.com
+
+.SH
+1.5 SEE
+
+.BR
+sisu(1)
+
+.SH
+1.6 ALSO SEE
+
+.BR
+sisu_webrick(1), sisu_pdf(7) sisu_sqlite(7) sisu_postgresql(7) sisu_vim(7)
+sisu_termsheet(1)
+
+.SH
+DOCUMENT INFORMATION (METADATA)
+.BR
+
+.SH
+METADATA
+.BR
+
+.BR
+Document Manifest @
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/sisu_manifest.html>
+
+.BR
+.B Dublin Core
+(DC)
+
+.BR
+.I DC tags included with this document are provided here.
+
+.BR
+DC Title:
+.I SiSU \- Complete Package \ [0.58]
+
+.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 2002\-08\-28
+
+.BR
+DC Date issued:
+.I 2002\-08\-28
+
+.BR
+DC Date available:
+.I 2002\-08\-28
+
+.BR
+DC Date modified:
+.I 2007\-09\-16
+
+.BR
+DC Date:
+.I 2007\-09\-16
+
+.BR
+.B Version Information
+
+.BR
+Sourcefile:
+.I sisu_complete.sst
+
+.BR
+Filetype:
+.I SiSU text 0.58
+
+.BR
+Sourcefile Digest, MD5(sisu_complete.sst)=
+.I 42003f9cf59fd7e4ddffae864e2c4179
+
+.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 Sun Sep 23 01:14:02 +0100 2007
+
+.BR
+Generated by:
+.I SiSU
+.I 0.58.3
+of 2007w36/4 (2007\-09\-06)
+
+.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_complete/sisu_manifest.html>
+.TP
+html: <http://www.jus.uio.no/sisu/sisu_complete/toc.html>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_complete/portrait.pdf>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_complete/landscape.pdf>
+." .TP
+." manpage: http://www.jus.uio.no/sisu/sisu_complete/sisu_complete.1
+.TP
+at: <http://www.jus.uio.no/sisu>
+.TP
+.TP
+* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+.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
+.TP
+* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_pdf.7 b/man/man7/sisu_pdf.7
new file mode 100644
index 00000000..00ca7889
--- /dev/null
+++ b/man/man7/sisu_pdf.7
@@ -0,0 +1,216 @@
+.TH "sisu_pdf" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe"
+.SH
+SISU \- SISU INFORMATION STRUCTURING UNIVERSE \- SEARCH \ [0.58],
+RALPH AMISSAH
+.BR
+
+.SH
+SISU SEARCH
+.BR
+
+.SH
+SISU SQLITE
+.BR
+
+.SH
+1. SQLITE
+.BR
+
+.SH
+1.1 NAME
+
+.BR
+.B SiSU
+\- Structured information, Serialized Units \- a document publishing system.
+
+.SH
+1.2 DESCRIPTION
+
+.BR
+Information creating pdf output with sisu (and related to the sisu_pdf
+dependency package, which is a dummy package to install dependencies needed for
+.B SiSU
+to generate pdfs (primarily related to LaTeX), sisu_pdf being part of
+.B SiSU
+\- man sisu).
+
+.BR
+.B SiSU
+generates LaTeX which is converted by LaTeX tools to pdf.
+
+.SH
+1.3 SYNOPSIS
+
+.BR
+  sisu \-pv \ [filename/wildcard]
+
+.SH
+1.4 COMMANDS
+
+.TP
+.B \ sisu \ \-pv \ \ [filename/wildcard]
+creates two pdf documents: vertical (portrait.pdf) and; horizontal
+(landscape.pdf).
+.B SiSU
+generates LaTeX output which is converted to pdf if the appropriate LaTeX
+dependencies are met on the system.
+
+.TP
+.B \ sisu \ \-pv \ \-\-papersize\-a4 \ \ [filename/wildcard]
+overrides the default papersize set to A4. Preset alternative sizes include:
+\'A4\', U.S. \'letter\' and \'legal\' and book sizes \'A5\' and \'B5\' (system
+defaults to A4).
+
+.SH
+1.5 SETTING PAPER SIZE
+
+.BR
+The paper\-size may be set to any of the following sizes: \'A4\', U.S.
+\'letter\' and \'legal\' and book sizes: \'A5\' and \'B5\'
+
+.BR
+1. The preset default if not otherwise given in the configuration file or
+elsewhere is A4.
+
+.BR
+2. The default paper size may be set in the configuration file sisurc.yml. See
+sisu_configuration:
+
+
+.nf
+  #% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal
+  default:
+    papersize:    \'A4\'
+.fi
+
+.BR
+3. Paper size may be set in a document header:
+
+
+.nf
+  @papersize: (A4|US_letter|book_B5|book_A5|US_legal)
+.fi
+
+.BR
+4. or provided with additional command line parameter, e.g.
+
+.BR
+  sisu \-pv \-\-papersize\-a4 \ [filename/wildcard]
+
+.SH
+DOCUMENT INFORMATION (METADATA)
+.BR
+
+.SH
+METADATA
+.BR
+
+.BR
+Document Manifest @
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/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 information Structuring Universe \- Search \ [0.58]
+
+.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 2002\-08\-28
+
+.BR
+DC Date issued:
+.I 2002\-08\-28
+
+.BR
+DC Date available:
+.I 2002\-08\-28
+
+.BR
+DC Date modified:
+.I 2007\-09\-16
+
+.BR
+DC Date:
+.I 2007\-09\-16
+
+.BR
+.B Version Information
+
+.BR
+Sourcefile:
+.I sisu_pdf.sst
+
+.BR
+Filetype:
+.I SiSU text 0.58
+
+.BR
+Sourcefile Digest, MD5(sisu_pdf.sst)=
+.I 161d3f57a0c3b9e816474243229cb423
+
+.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 Sun Sep 23 01:14:03 +0100 2007
+
+.BR
+Generated by:
+.I SiSU
+.I 0.58.3
+of 2007w36/4 (2007\-09\-06)
+
+.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_pdf/sisu_manifest.html>
+.TP
+html: <http://www.jus.uio.no/sisu/sisu_pdf/toc.html>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_pdf/portrait.pdf>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_pdf/landscape.pdf>
+." .TP
+." manpage: http://www.jus.uio.no/sisu/sisu_pdf/sisu_pdf.1
+.TP
+at: <http://www.jus.uio.no/sisu>
+.TP
+.TP
+* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+.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
+.TP
+* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_postgresql.7 b/man/man7/sisu_postgresql.7
new file mode 100644
index 00000000..4a550af0
--- /dev/null
+++ b/man/man7/sisu_postgresql.7
@@ -0,0 +1,223 @@
+.TH "sisu_postgresql" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe"
+.SH
+SISU \- SISU INFORMATION STRUCTURING UNIVERSE \- SEARCH \ [0.58],
+RALPH AMISSAH
+.BR
+
+.SH
+SISU SEARCH
+.BR
+
+.SH
+SISU POSTGRESQL
+.BR
+
+.SH
+1. POSTGRESQL
+.BR
+
+.SH
+1.1 NAME
+
+.BR
+.B SiSU
+\- Structured information, Serialized Units \- a document publishing system,
+postgresql dependency package
+
+.SH
+1.2 DESCRIPTION
+
+.BR
+Information related to using postgresql with sisu (and related to the
+sisu_postgresql dependency package, which is a dummy package to install
+dependencies needed for
+.B SiSU
+to populate a postgresql database, this being part of
+.B SiSU
+\- man sisu).
+
+.SH
+1.3 SYNOPSIS
+
+.BR
+  sisu \-D \ [instruction] \ [filename/wildcard \ if \ required]
+
+.BR
+  sisu \-D \-\-pg \-\-[instruction] \ [filename/wildcard \ if \ required]
+
+.SH
+1.4 COMMANDS
+
+.BR
+Mappings to two databases are provided by default, postgresql and sqlite, the
+same commands are used within sisu to construct and populate databases however
+\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql,
+alternatively \-\-sqlite or \-\-pgsql may be used
+
+.BR
+.B \-D or \-\-pgsql
+may be used interchangeably.
+
+.SH
+1.4.1 CREATE AND DESTROY DATABASE
+
+.TP
+.B \ \-\-pgsql \ \-\-createall
+\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in
+\ existing \ (postgresql) \ database \ (a \ database \ should \ be \ created \
+manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \
+requested) \ (rb.dbi) \
+
+.TP
+.B \ sisu \ \-D \ \-\-createdb
+\ creates \ database \ where \ no \ database \ existed \ before \
+
+.TP
+.B \ sisu \ \-D \ \-\-create
+\ creates \ database \ tables \ where \ no \ database \ tables \ existed \
+before \
+
+.TP
+.B \ sisu \ \-D \ \-\-Dropall
+\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \
+and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \
+given \ directory \ (and \ directories \ of \ the \ same \ name). \
+
+.TP
+.B \ sisu \ \-D \ \-\-recreate
+\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database
+\ structure \
+
+.SH
+1.4.2 IMPORT AND REMOVE DOCUMENTS
+
+.TP
+.B \ sisu \ \-D \ \-\-import \ \-v \ \ [filename/wildcard]
+populates database with the contents of the file. Imports documents(s)
+specified to a postgresql database (at an object level).
+
+.TP
+.B \ sisu \ \-D \ \-\-update \ \-v \ \ [filename/wildcard]
+updates file contents in database
+
+.TP
+.B \ sisu \ \-D \ \-\-remove \ \-v \ \ [filename/wildcard]
+removes specified document from postgresql database.
+
+.SH
+DOCUMENT INFORMATION (METADATA)
+.BR
+
+.SH
+METADATA
+.BR
+
+.BR
+Document Manifest @
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/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 information Structuring Universe \- Search \ [0.58]
+
+.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 2002\-08\-28
+
+.BR
+DC Date issued:
+.I 2002\-08\-28
+
+.BR
+DC Date available:
+.I 2002\-08\-28
+
+.BR
+DC Date modified:
+.I 2007\-09\-16
+
+.BR
+DC Date:
+.I 2007\-09\-16
+
+.BR
+.B Version Information
+
+.BR
+Sourcefile:
+.I sisu_postgresql.sst
+
+.BR
+Filetype:
+.I SiSU text 0.58
+
+.BR
+Sourcefile Digest, MD5(sisu_postgresql.sst)=
+.I b81ba44e7946dfaf03d26f0dc5d749ab
+
+.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 Sun Sep 23 01:14:03 +0100 2007
+
+.BR
+Generated by:
+.I SiSU
+.I 0.58.3
+of 2007w36/4 (2007\-09\-06)
+
+.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_postgresql/sisu_manifest.html>
+.TP
+html: <http://www.jus.uio.no/sisu/sisu_postgresql/toc.html>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_postgresql/portrait.pdf>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_postgresql/landscape.pdf>
+." .TP
+." manpage: http://www.jus.uio.no/sisu/sisu_postgresql/sisu_postgresql.1
+.TP
+at: <http://www.jus.uio.no/sisu>
+.TP
+.TP
+* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+.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
+.TP
+* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_sqlite.7 b/man/man7/sisu_sqlite.7
new file mode 100644
index 00000000..fa162cc3
--- /dev/null
+++ b/man/man7/sisu_sqlite.7
@@ -0,0 +1,222 @@
+.TH "sisu_sqlite" "1" "2007-09-16" "0.58.3" "SiSU - SiSU information Structuring Universe"
+.SH
+SISU \- SISU INFORMATION STRUCTURING UNIVERSE \- SEARCH \ [0.58],
+RALPH AMISSAH
+.BR
+
+.SH
+SISU SEARCH
+.BR
+
+.SH
+SISU SQLITE
+.BR
+
+.SH
+1. SQLITE
+.BR
+
+.SH
+1.1 NAME
+
+.BR
+.B SiSU
+\- Structured information, Serialized Units \- a document publishing system.
+
+.SH
+1.2 DESCRIPTION
+
+.BR
+Information related to using sqlite with sisu (and related to the sisu_sqlite
+dependency package, which is a dummy package to install dependencies needed for
+.B SiSU
+to populate an sqlite database, this being part of
+.B SiSU
+\- man sisu).
+
+.SH
+1.3 SYNOPSIS
+
+.BR
+  sisu \-d \ [instruction] \ [filename/wildcard \ if \ required]
+
+.BR
+  sisu \-d \-\-(sqlite|pg) \-\-[instruction] \ [filename/wildcard \ if \
+  required]
+
+.SH
+1.4 COMMANDS
+
+.BR
+Mappings to two databases are provided by default, postgresql and sqlite, the
+same commands are used within sisu to construct and populate databases however
+\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql,
+alternatively \-\-sqlite or \-\-pgsql may be used
+
+.BR
+.B \-d or \-\-sqlite
+may be used interchangeably.
+
+.SH
+1.4.1 CREATE AND DESTROY DATABASE
+
+.TP
+.B \ \-\-sqlite \ \-\-createall
+\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in
+\ existing \ (sqlite) \ database \ (a \ database \ should \ be \ created \
+manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \
+requested) \ (rb.dbi) \
+
+.TP
+.B \ sisu \ \-d \ \-\-createdb
+\ creates \ database \ where \ no \ database \ existed \ before \
+
+.TP
+.B \ sisu \ \-d \ \-\-create
+\ creates \ database \ tables \ where \ no \ database \ tables \ existed \
+before \
+
+.TP
+.B \ sisu \ \-d \ \-\-dropall
+\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \
+and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \
+given \ directory \ (and \ directories \ of \ the \ same \ name). \
+
+.TP
+.B \ sisu \ \-d \ \-\-recreate
+\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database
+\ structure \
+
+.SH
+1.4.2 IMPORT AND REMOVE DOCUMENTS
+
+.TP
+.B \ sisu \ \-d \ \-\-import \ \-v \ \ [filename/wildcard]
+populates database with the contents of the file. Imports documents(s)
+specified to an sqlite database (at an object level).
+
+.TP
+.B \ sisu \ \-d \ \-\-update \ \-v \ \ [filename/wildcard]
+updates file contents in database
+
+.TP
+.B \ sisu \ \-d \ \-\-remove \ \-v \ \ [filename/wildcard]
+removes specified document from sqlite database.
+
+.SH
+DOCUMENT INFORMATION (METADATA)
+.BR
+
+.SH
+METADATA
+.BR
+
+.BR
+Document Manifest @
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/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 information Structuring Universe \- Search \ [0.58]
+
+.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 2002\-08\-28
+
+.BR
+DC Date issued:
+.I 2002\-08\-28
+
+.BR
+DC Date available:
+.I 2002\-08\-28
+
+.BR
+DC Date modified:
+.I 2007\-09\-16
+
+.BR
+DC Date:
+.I 2007\-09\-16
+
+.BR
+.B Version Information
+
+.BR
+Sourcefile:
+.I sisu_sqlite.sst
+
+.BR
+Filetype:
+.I SiSU text 0.58
+
+.BR
+Sourcefile Digest, MD5(sisu_sqlite.sst)=
+.I 61ba58f6a2f5cc9651b985a8eabb96e9
+
+.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 Sun Sep 23 01:14:03 +0100 2007
+
+.BR
+Generated by:
+.I SiSU
+.I 0.58.3
+of 2007w36/4 (2007\-09\-06)
+
+.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_sqlite/sisu_manifest.html>
+.TP
+html: <http://www.jus.uio.no/sisu/sisu_sqlite/toc.html>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_sqlite/portrait.pdf>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_sqlite/landscape.pdf>
+." .TP
+." manpage: http://www.jus.uio.no/sisu/sisu_sqlite/sisu_sqlite.1
+.TP
+at: <http://www.jus.uio.no/sisu>
+.TP
+.TP
+* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+.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
+.TP
+* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_vim.7 b/man/man7/sisu_vim.7
index 58bacc04..65d97d53 100644
--- a/man/man7/sisu_vim.7
+++ b/man/man7/sisu_vim.7
@@ -1,59 +1,196 @@
-.\"  Name: SiSU information Structuring Universe
-.\"  Author: Ralph Amissah
-.\"  Description: vim sisu package manpage
-.\"  arch-tag: sisu manpage
-.\"  License: GPL 3 or later
-.\"  Notes: Process this file with
-.\"    groff -man -Tascii vim_sisu.1
-.\"    nroff -man vim_sisu.1 | most
-.\"  |sisu.1|@|^|<url:sisu.1>
-.TH vim_sisu 7  "July 7, 2006" "version 0.42" "vim syntax and filetype plugin with folds for SiSU markup"
-.SH NAME
+.TH "sisu_vim" "1" "2007-09-16" "0.58.3" "SiSU"
+.SH
+SISU \- VIM,
+RALPH AMISSAH
+.BR
+
+.SH
+SISU VIM
+.BR
+
+.SH
+1. SISU VIM
+.BR
+
+.BR
+.B Synopsis
+
+.BR
 .B SiSU
-\- Structured information, Serialized Units \- a document publishing system.
-.SH SYNOPSIS
-.PP
-An ftplugin to provide vim folds for SiSU markup, and to set some defaults for SiSU markup in installed by sisu.
-.PP
+has syntax highlighting for a number of editors including vim which are
+documented under:
+
+.BR
+  man sisu_syntax_highlighting
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html
+
+.BR
+  <http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html>
+
+.BR
+.B SiSU
+also provides an ftplugin to provide vim folds for
+.B SiSU
+markup, and to set some defaults for
+.B SiSU
+markup in installed by sisu.
+
+.BR
 Vim 7 includes sisu markup syntax highlighting.
-.PP
-Vim related files are included in /usr/share/sisu/vim/addons, (including the syntax highlighter which may be used by Vim 6).
-.PP
-sisu\-vim actions are activated on files with the suffix .sst .ssm .ssi .-sst ._sst (and the same with a further .meta extension)
-.PP
-.BI <ctrl>F
-activate folds on headings matched in a document (also provides folds when sourced on a ruby program file), also
-.B :F
-.PP
-.BI <ctrl>S
-search and replace down
-.PP
-.BI <ctrl>G
-search and replace globally within file
-.PP
-.BI <ctrl>X
-ruby regex global search and replace within file
-.PP
-.BI <ctrl>C
-set color scheme to
-.B slate
-which is provided
-.\"%% Further Information
-.SH FURTHER INFORMATION
-.PP
+
+.BR
+Vim related files are included in: /usr/share/sisu/conf/editor\-syntax\-etc/vim
+(including the syntax highlighter which may be used for earlier versions of
+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)
+
+
+.nf
+  <ctrl>F activate folds on headings matched in a document
+  (also provides folds when sourced on a ruby program file),
+  also :F
+  <ctrl>S search and replace down
+  <ctrl>G search and replace globally within file
+  <ctrl>X ruby regex global search and replace within file
+  <ctrl>C set color scheme to slate which is provided
+.fi
+
+.BR
+FURTHER INFORMATION
+
+.BR
 For more information on
-.I SiSU
+.B SiSU
 see:
-.I <http://www.jus.uio.no/sisu>
-.PP
-or
-.I man sisu
-.SH AUTHOR
-Ralph Amissah
-.I <ralph@amissah.com>
-or
-.I <ralph.amissah@gmail.com>
-.SH SEE ALSO
-.BR sisu(1),
-.BR sisu(8),
-.BR sisu_webrick(1)
+
+.BR
+<http://www.jus.uio.no/sisu>
+
+.BR
+or man sisu
+
+.SH
+DOCUMENT INFORMATION (METADATA)
+.BR
+
+.SH
+METADATA
+.BR
+
+.BR
+Document Manifest @
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/sisu_manifest.html>
+
+.BR
+.B Dublin Core
+(DC)
+
+.BR
+.I DC tags included with this document are provided here.
+
+.BR
+DC Title:
+.I SiSU \- Vim
+
+.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 2002\-11\-12
+
+.BR
+DC Date issued:
+.I 2002\-11\-12
+
+.BR
+DC Date available:
+.I 2002\-11\-12
+
+.BR
+DC Date modified:
+.I 2007\-09\-16
+
+.BR
+DC Date:
+.I 2007\-09\-16
+
+.BR
+.B Version Information
+
+.BR
+Sourcefile:
+.I sisu_vim.sst
+
+.BR
+Filetype:
+.I SiSU text insert 0.58
+
+.BR
+Sourcefile Digest, MD5(sisu_vim.sst)=
+.I a3db74eebef04815aa234d3c3b17f375
+
+.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 Sun Sep 23 01:14:04 +0100 2007
+
+.BR
+Generated by:
+.I SiSU
+.I 0.58.3
+of 2007w36/4 (2007\-09\-06)
+
+.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_vim/sisu_manifest.html>
+.TP
+html: <http://www.jus.uio.no/sisu/sisu_vim/toc.html>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_vim/portrait.pdf>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_vim/landscape.pdf>
+." .TP
+." manpage: http://www.jus.uio.no/sisu/sisu_vim/sisu_vim.1
+.TP
+at: <http://www.jus.uio.no/sisu>
+.TP
+.TP
+* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
+.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
+.TP
+* SiSU http://www.jus.uio.no/sisu