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

diff --git a/data/doc/manuals_generated/sisu_manual/sisu_postgresql/plain.txt b/data/doc/manuals_generated/sisu_manual/sisu_postgresql/plain.txt
new file mode 100644
index 00000000..9d040dbd
--- /dev/null
+++ b/data/doc/manuals_generated/sisu_manual/sisu_postgresql/plain.txt
@@ -0,0 +1,215 @@
+SISU - SISU INFORMATION STRUCTURING UNIVERSE - SEARCH [0.58],
+RALPH AMISSAH
+****************************************************************************
+
+SISU SEARCH
+===========
+
+SISU POSTGRESQL
+===============
+
+1. POSTGRESQL
+-------------
+
+1.1 NAME
+........
+
+*SiSU* - Structured information, Serialized Units - a document publishing
+system, postgresql dependency package
+
+
+1.2 DESCRIPTION
+...............
+
+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 *SiSU* to populate a postgresql database, this being
+part of *SiSU* - man sisu).
+
+
+1.3 SYNOPSIS
+............
+
+  sisu -D [instruction] [filename/wildcard if required]
+
+
+  sisu -D --pg --[instruction] [filename/wildcard if required]
+
+
+1.4 COMMANDS
+............
+
+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
+
+
+*-D or --pgsql* may be used interchangeably.
+
+
+1.4.1 CREATE AND DESTROY DATABASE
+.................................
+
+*--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)
+
+
+*sisu -D --createdb*
+creates database where no database existed before
+
+
+*sisu -D --create*
+creates database tables where no database tables existed before
+
+
+*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).
+
+
+*sisu -D --recreate*
+destroys existing database and builds a new empty database structure
+
+
+1.4.2 IMPORT AND REMOVE DOCUMENTS
+.................................
+
+*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).
+
+
+*sisu -D --update -v [filename/wildcard]*
+updates file contents in database
+
+
+*sisu -D --remove -v [filename/wildcard]*
+removes specified document from postgresql database.
+
+
+DOCUMENT INFORMATION (METADATA)
+*******************************
+
+METADATA
+--------
+
+Document Manifest @
+<http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/sisu_manifest.html>
+
+
+*Dublin Core* (DC)
+
+
+/DC tags included with this document are provided here./
+
+
+DC Title: _SiSU - SiSU information Structuring Universe - Search [0.58]_
+
+
+DC Creator: _Ralph Amissah_
+
+
+DC Rights: _Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
+License GPL 3_
+
+
+DC Type: _information_
+
+
+DC Date created: _2002-08-28_
+
+
+DC Date issued: _2002-08-28_
+
+
+DC Date available: _2002-08-28_
+
+
+DC Date modified: _2007-09-16_
+
+
+DC Date: _2007-09-16_
+
+
+*Version Information*
+
+
+Sourcefile: _sisu_postgresql.sst_
+
+
+Filetype: _SiSU text 0.58_
+
+
+Sourcefile Digest, MD5(sisu_postgresql.sst)= _b81ba44e7946dfaf03d26f0dc5d749ab_
+
+
+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)=
+_20fc43cf3eb6590bc3399a1aef65c5a9_
+
+
+*Generated*
+
+
+Document (metaverse) last generated: _Sun Sep 23 04:11:04 +0100 2007_
+
+
+Generated by: _SiSU_ _0.59.0_ of 2007w38/0 (2007-09-23)
+
+
+Ruby version: _ ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]_
+
+
+
+==============================================================================
+
+	title:  SiSU - SiSU information Structuring Universe - Search [0.58]
+
+	creator:  Ralph Amissah
+
+	rights:  Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
+               License GPL 3
+
+	type:  information
+
+	subject:  ebook, epublishing, electronic book, electronic publishing,
+               electronic document, electronic citation, data structure,
+               citation systems, search
+
+	date.created:  2002-08-28
+
+	date.issued:  2002-08-28
+
+	date.available:  2002-08-28
+
+	date.modified:  2007-09-16
+
+	date:  2007-09-16
+
+
+
+
+
+==============================================================================
+nil
+
+Other versions of this document:
+manifest:
+   http://www.jus.uio.no/sisu/sisu_postgresql/sisu_manifest.html
+html:
+   http://www.jus.uio.no/sisu/sisu_postgresql/toc.html
+pdf:
+   http://www.jus.uio.no/sisu/sisu_postgresql/portrait.pdf
+   http://www.jus.uio.no/sisu/sisu_postgresql/landscape.pdf
+plaintext (plain text):
+   http://www.jus.uio.no/sisu/sisu_postgresql/plain.txt
+at:
+   http://www.jus.uio.no/sisu
+* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
+* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
+* Last Generated on: Sun Sep 23 04:11:52 +0100 2007
+* SiSU http://www.jus.uio.no/sisu