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

1 files changed, 729 insertions, 0 deletions

diff --git a/man/man1/sisu_help_sources.1 b/man/man1/sisu_help_sources.1
new file mode 100644
index 00000000..4e1f84e4
--- /dev/null
+++ b/man/man1/sisu_help_sources.1
@@ -0,0 +1,729 @@
+.TH "sisu_help_sources" "1" "2007-09-16" "0.58.3" "SiSU"
+.SH
+SISU \- REFERENCES,
+RALPH AMISSAH
+.BR
+
+.SH
+SISU HELP SOURCES
+.BR
+
+.SH
+1. HELP SOURCES
+.BR
+
+.BR
+For a summary of alternative ways to get help on
+.B SiSU
+try one of the following:
+
+.BR
+.B man page
+
+.BR
+  man sisu_help
+
+.BR
+.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>
+
+.BR
+.B help sources lists
+
+.BR
+Alternative sources for this help sources page listed here:
+
+.BR
+  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>
+
+.SH
+1.1 MAN PAGES
+
+.SH
+1.1.1 MAN
+
+.BR
+  man sisu
+
+.BR
+  man sisu_commands
+
+.BR
+  man 7 sisu_complete
+
+.BR
+  man sisu_configuration
+
+.BR
+  man 8 sisu_faq
+
+.BR
+  man sisu_filetypes
+
+.BR
+  man sisu_help
+
+.BR
+  man sisu_help_sources
+
+.BR
+  man 8 sisu_howto
+
+.BR
+  man sisu_introduction
+
+.BR
+  man sisu_markup
+
+.BR
+  man sisu_output_overview
+
+.BR
+  man 7 sisu_pdf
+
+.BR
+  man 7 sisu_postgresql
+
+.BR
+  man 8 sisu_quickstart
+
+.BR
+  man 8 sisu_remote
+
+.BR
+  man 8 sisu_search
+
+.BR
+  man sisu_skin
+
+.BR
+  man 7 sisu_sqlite
+
+.BR
+  man 8 sisu_syntax_highlighting
+
+.BR
+  man 7 sisu_vim
+
+.BR
+  man sisu_webrick
+
+.SH
+1.2 SISU GENERATED OUTPUT \- LINKS TO HTML
+
+.BR
+Note
+.B SiSU
+documentation is prepared in
+.B SiSU
+and output is available in multiple formats including amongst others html,
+pdf, and odf which may be also be accessed via the html pages[^1]
+
+.SH
+1.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_commands/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_description/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_help/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_output_overview/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_quickstart/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_search/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html
+
+.BR
+  /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html
+
+.SH
+1.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
+1.2.3 WWW.JUS.UIO.NO/SISU
+
+.BR
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html>
+
+.SH
+1.2.4 MAN2HTML
+
+.SH
+1.2.5 LOCALLY INSTALLED
+
+.BR
+<file:///usr/share/doc/sisu/html/sisu_manual.1.html>
+
+.BR
+<file:///usr/share/doc/sisu/html/sisu_help.1.html>
+
+.BR
+<file:///usr/share/doc/sisu/html/sisu_help_sources.1.html>
+
+.BR
+  /usr/share/doc/sisu/html/sisu.1.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_commands.1.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_complete.7.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_configuration.1.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_faq.8.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_help.1.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_help_sources.1.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_howto.8.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_markup.1.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_pdf.7.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_postgresql.7.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_quickstart.8.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_remote.8.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_search.8.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_skin.1.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_sqlite.7.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_vim.7.html
+
+.BR
+  /usr/share/doc/sisu/html/sisu_webrick.1.html
+
+.SH
+1.2.6 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_commands.1.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_complete.7.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_configuration.1.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_faq.8.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_howto.8.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_markup.1.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_quickstart.8.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_remote.8.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_search.8.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_skin.1.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_sqlite.7.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_syntax_highlighting.8.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_vim.7.html>
+
+.BR
+  <http://sisudoc.org/man/sisu_webrick.1.html>
+
+.SH
+1.2.7 WWW.JUS.UIO.NO/SISU
+
+.BR
+<http://www.jus.uio.no/sisu/man/sisu_manual.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
+  <http://www.jus.uio.no/sisu/man/sisu_commands.1.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_complete.7.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_configuration.1.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_faq.8.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_howto.8.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_markup.1.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_pdf.7.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_remote.8.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_search.8.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_skin.1.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_vim.7.html>
+
+.BR
+  <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html>
+
+.SH
+DOCUMENT INFORMATION (METADATA)
+.BR
+
+.SH
+METADATA
+.BR
+
+.BR
+Document Manifest @
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html>
+
+.BR
+.B Dublin Core
+(DC)
+
+.BR
+.I DC tags included with this document are provided here.
+
+.BR
+DC Title:
+.I SiSU \- References
+
+.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_help_sources.sst
+
+.BR
+Filetype:
+.I SiSU text insert 0.58
+
+.BR
+Sourcefile Digest, MD5(sisu_help_sources.sst)=
+.I ff6812b3008391d7a20d777bbbeb3ec1
+
+.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:13:58 +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
+.BI 1.
+named index.html or more extensively through sisu_manifest.html
+
+.TP
+Other versions of this document:
+.TP
+manifest: <http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html>
+.TP
+html: <http://www.jus.uio.no/sisu/sisu_help_sources/toc.html>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf>
+." .TP
+." manpage: http://www.jus.uio.no/sisu/sisu_help_sources/sisu_help_sources.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:05 +0100 2007
+.TP
+* SiSU http://www.jus.uio.no/sisu