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, 129 insertions, 0 deletions

diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/sisurc.yml b/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/sisurc.yml
new file mode 100644
index 00000000..e3fe2a90
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/sisurc.yml
@@ -0,0 +1,129 @@
+# Name: SiSU - Simple information Structuring Universe
+# Author: Ralph@Amissah.com
+# Description: Site wide envionment defaults set here
+# system environment info / resource configuration file, for sisu
+# License: GPL v3 or later
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu/config #per local directory settings
+# $Date$
+# $Id$
+# Notes: implemented 2004w03
+#   Site environment configuration file
+#   this file should be configured and live in
+#      /etc/sisu     #per environment settings, overridden by:
+#      ~/.sisu       #per user settings, overridden by:
+#     ./_sisu        #per local markup directory settings
+#% #image source directory, main path and subdirectories
+#image:
+##  path:         'grotto/theatre/working'
+#  path:         'sisu_working'
+#  public:       'sisu_image'
+#  #all:           'image'
+#% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name)
+webserv:
+  url_root:     'http://www.jus.uio.no/sisu' #without dir stub, e.g. this dir would map to http://www.jus.uio.no/sisu
+  path:         '~/grotto/theatre/dbld/sisu-dev/sisu/data/doc/manuals_generated' # /var/www either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home
+  #images:       'sisu/image'
+  #man:          'man'
+  #php:          'php'
+  #cgi:          '/usr/local/lib/sisu-cgi'
+  feed:         'feed'
+  sqlite:       'sisu/sqlite'
+#  webrick_url:  true
+#show_output_on: 'filesystem' #for -v and -u url information, alternatives: 'filesystem','webserver','remote_webserver','local:8111','localhost','localhost:8080','webrick','path'
+#show_output_on: 'local:8111'
+webserv_cgi:
+#  host:         localhost
+#  base_path:    ~
+#  port:         '8081'
+#  user:         ~
+  file_links:   webserv
+#  file_links:   www.jus.uio.no
+show_output_on: 'filesystem_url'
+#texinfo display output
+#texinfo:
+#  stub:         'texinfo'
+#% processing directories, main path and subdirectories
+processing:
+#  path:         'sisu_processing'
+#  metaverse:    'metaverse'
+#  tune:         'tune'
+#  latex:        'tex'
+#  texinfo:      'texinfo'
+#  concord_max:  400000
+#% flag - set (non-default) processing flag shortcuts -1, -2 etc. (here adding colour and verbosity as default)
+flag:
+  color:        true                       # making colour default -c is toggle, and will now toggle colour off
+  default:      '-NhwpoabxXyYv'            # includes verbose; -m would in any event be run by default
+  i:            '-Nhwpoayv'                # includes verbose; -m run by default
+  ii:           '-NhwpoabxXyv'             # includes verbose; -m run by default
+  iii:          '-NhwpoabxXyYv'            # includes verbose; -m run by default
+  iv:           '-NhwpoabxXYDyv --import'  # includes verbose; -m run by default
+  v:            '-NhwpoabxXYDyv --update'  # includes verbose; -m run by default
+#flag:
+#  color:        false              # colour off default -c is toggle, and will toggle colour on
+#  i:            '-mhwpcyv'         # adding colour and verbosity to defaults (note: another -c won't toggle off)
+#  ii:           '-mhwpaocyv'       # adding colour and verbosity to defaults (note: another -c won't toggle off)
+#  iii:          '-mhwpaobxXcyv'    # adding colour and verbosity to defaults (note: another -c won't toggle off)
+#  iv:           '-mhwpaobxXDcyv --import'  # adding colour and verbosity to defaults (note: another -c won't toggle off)
+#  v:            '-mhwpaobxXDcyv --update'  # adding colour and verbosity to defaults (note: another -c won't toggle off)
+#% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal
+default:
+  papersize:    'A4'
+  language_file: 2
+  #digest:       'sha' #sha is sha256, default is md5
+  #multilingual:  false
+  #language:     'English'
+#% settings used by ssh scp rsync, requires keychain setup
+#remote:
+#  user:         '[provide_username]'
+#  host:         '[provide_hostname]'
+#  path:         '.' #no trailing slash eg 'sisu/www'
+##% webrick information
+##sql database info, postgresql and sqlite
+#db:
+#  postgresql:
+#    user:       '[provide username]'
+#    port:       '5432'
+#  sqlite:
+#    path:       ~ # './sisu_sqlite.db'
+#    port:       "**"
+#    multi:      true
+#    single:     true
+#% possible values ~, true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'.
+#will only ignore if value set to false, absence or nil will not remove program as should operate without rc file
+#ie in case of ~ will ignore and use hard coded defaults within program), true, false, or command instruction e.g. editor: 'gvim -c :R -c :S'
+#on value true system defaults used, to change, e.g. editor specify
+permission_set:
+  zap:               true
+  css_modify:        true
+#  remote_base_site:  true
+program_set:
+  rmagick:           true
+  wc:                true
+  editor:            true
+  postgresql:        true
+  sqlite:            true
+  tidy:              true
+  rexml:             true
+  pdflatex:          true
+program_select:
+  editor:       'gvim -c :R'
+  pdf_viewer:   'evince'
+  web_browser:  'kazehakase'
+  console_web_browser:  'links2'
+  odf_viewer:   'oowriter'
+  xml_viewer:   'xml-viewer'
+#promo:              sisu_icon, sisu, sisu_search_libre, open_society, fsf, ruby
+search:
+  sisu:
+    flag:              true
+#    action:            http://localhost:8081/cgi-bin/sisu_pgsql.cgi
+    action:            http://search.sisudoc.org
+    db:                sisu
+    title:             sample search form
+  hyperestraier:
+    flag:              true
+    action:            http://search.sisudoc.org/cgi-bin/estseek.cgi?