Imported upstream version 0.52.7upstream/0.52.7 sisu_0.52.7

author: Ralph Amissah <ralph.amissah@gmail.com> 2007-05-22 02:06:46 +0100
committer: Ralph Amissah <ralph.amissah@gmail.com> 2007-05-22 02:06:46 +0100
commit: 65477054fd798728bf186aa2938727ddddbe86a5 (patch)
tree: 612da47b57ad4c4157f495dcf10710d32cdc6ead /data
118 files changed, 23972 insertions, 0 deletions
diff --git a/data/doc/sisu/CHANGELOG b/data/doc/sisu/CHANGELOG
new file mode 100644
index 00000000..2c1bf32b
--- /dev/null
+++ b/data/doc/sisu/CHANGELOG
@@ -0,0 +1,6426 @@
+* See homepage at: http://www.jus.uio.no/sisu
+* &   http://www.jus.uio.no/sisu/SiSU/download
+* &   http://www.jus.uio.no/sisu/SiSU/changelog
+
+Reverse Chronological:
+
+%% STABLE MANIFEST
+
+%% sisu_0.52.7.orig.tar.gz (2007-05-17::20/4)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.52.7.orig.tar.gz
+  sisu_0.52.7.orig.tar.gz
+  sisu_0.52.7-1.dsc
+  sisu_0.52.7-1.diff.gz
+
+  * texpdf, related to special characters
+
+%% sisu_0.52.6.orig.tar.gz (2007-05-14::20/1)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.52.6.orig.tar.gz
+  3255ec945b0583a01af963dde3f76f1d 1283482 sisu_0.52.6.orig.tar.gz
+  f466b68b3093e2c95fed13e4ebf0d495 606 sisu_0.52.6-1.dsc
+  aafb3b715fe2566f88c2def746d73099 148689 sisu_0.52.6-1.diff.gz
+
+  * texpdf, a url representation fix, escape of special characters 
+
+%% sisu_0.52.5.orig.tar.gz (2007-05-10::19/4)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.52.5.orig.tar.gz
+  e01dd9390785e8b087140a7166cc6a5e 1283393 sisu_0.52.5.orig.tar.gz
+  1bc960b5ce02d58153579d32bfbb2bd0 606 sisu_0.52.5-1.dsc
+  d6ab36fca512d494a4ce6fe0feec217a 148667 sisu_0.52.5-1.diff.gz
+
+  * postgresql TCP/IP port setting changed, looks first at sisurc.yml else the
+    environment variable PGPORT, else fallback is to set
+    default to 5432
+
+  * debian/control postgresql dependencies updated, version agnostic (Closes:
+    #419294) [Martin Pitt thanks for report]
+    * on debian postgresql-8.2 now replaces postgresql-8.1, migrate database.
+    * you may need to set the TCP/IP port, and this can be done either by
+      setting PGPORT (e.g. "export PGPORT=5432") or setting the port in
+      sisurc.yml (check what the correct value should be [on my system the
+      default was set to 5433 for 8.2, "ls -la /var/run/postgresql/" may help])
+      
+%% sisu_0.52.4.orig.tar.gz (2007-05-05::18/6)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.52.4.orig.tar.gz
+  8712a6162633f27dce36f57bc60599a5 1282392 sisu_0.52.4.orig.tar.gz
+  fd5618da795883fbeb1d53076783f80a 606 sisu_0.52.4-1.dsc
+  7f6b377e5f0bdc0ea805a7af5f21f2bb 148482 sisu_0.52.4-1.diff.gz
+
+  * param, markup version detection added
+
+  * some code cleaning and anchoring of some regexs to start and end of string
+
+  * [checked against ruby 1.9.0 (2006-06-08) [i486-linux] in Debian Sid]
+
+  * debian debhelper (>= 5)
+
+  * [very rough wiki text output/assist (-g), may remove, not documented]
+
+%% sisu_0.52.3.orig.tar.gz (2007-04-26::17/4)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.52.3.orig.tar.gz
+  d71332c68a8ed6b01f358f1e5ae45875 1279017 sisu_0.52.3.orig.tar.gz
+  4dd90c7e7790ea75be3017577759a128 606 sisu_0.52.3-1.dsc
+  a82c2c62106475640b25fefb38e9a6a4 148442 sisu_0.52.3-1.diff.gz
+
+  * texpdf, a fix, utf-8 markup/input file now required and assumed
+    [file magic identification of sisu markup files changes, utf-8 info is not
+    currently provided, (resulting in false assumption on encoding)]
+
+  * debian/control, postgresql dependency reverted till ruby db driver
+    dependencies are updated, [reopened: #419294] [not caught in 0.52.2 because
+    both versions of postgresql were installed, 0.52.2 was not uploaded to the
+    debian repository]
+
+%% sisu_0.52.2.orig.tar.gz  (2007-04-21::16/6)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.52.2.orig.tar.gz
+  96a2d9628e14e997bd93edd817b04996 1278391 sisu_0.52.2.orig.tar.gz
+  b3ed14988e1deed59ba13e0cfaae0b35 606 sisu_0.52.2-1.dsc
+  fb9ec4798fd769320873dbbc7ff145f8 148322 sisu_0.52.2-1.diff.gz
+
+  * html, links to other output make use of the default settings as well as
+    availability of software (e.g. to generate pdf from LaTeX)
+
+  * debian/control, postgresql dependency update, [intended to close: #419294]
+    [thank you for report Martin Pitt]
+
+%% sisu_0.52.1.orig.tar.gz  (2007-04-14::15/6)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.52.1.orig.tar.gz
+  24faea8c8565af2a24fb02c4499cb287 1280993 sisu_0.52.1.orig.tar.gz
+  46a488ef619227fd02426a7311e86927 606 sisu_0.52.1-1.dsc
+  b0286f72ebcbb9a8443ae99bb905407a 141510 sisu_0.52.1-1.diff.gz
+
+  * initial revisit of XML output (and input) models, lots as yet to be done
+
+  * cleanup of some unused code, re-introduce if needed
+
+%% sisu_0.52.0.orig.tar.gz  (2007-04-07::14/6)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.52.0.orig.tar.gz
+  e8767ea85c9e4f0941a8019f184031f3 1273211 sisu_0.52.0.orig.tar.gz
+  991acda3465d5a8a043da7f327d8d020 606 sisu_0.52.0-1.dsc
+  731cb9af8e47d4ebcd4a93c98286ac15 1391220 sisu_0.52.0-1.diff.gz
+
+  * 0.52 introduces: file-type identifier declaration, the _{first line of SiSU
+    a markup file}_ should be the sisu file-type identifier, indicated by the
+    word SiSU optionally (and preferably) followed by the version number of the
+    markup used:
+    e.g. current markup files would start with the line:
+      'SiSU 0.52'
+    or
+      'sisu-0.52'
+    [most markup is unchanged since sisu-0.38 though there have been some
+    additions since see e.g. sisu-0.42... (sisu-0.16 markup remains valid
+    though depreciated) to keep backward compatibility use:]
+    commented out equivalents:
+      '% SiSU 0.38'
+    or
+      '% sisu-0.38'
+    variants include:
+      'SiSU text 0.52'   [filename].sst (equivalent to the default 'SiSU 0.52')
+      'SiSU insert 0.52' [filename].ssi
+      'SiSU master 0.52' [filename].ssm
+
+    sisupod (zip) files (currently) have inserted into the binary:
+      'SiSU sisupod 0.52.0'
+    and sisupod (zip) of directory content: 
+      'SiSU sisupod 0.52.0 directory contents sisupod-sisu-2007-04-03.ssp'
+
+  * command line options:
+    * default action for 'sisu [filename]' introduced: sisu -0 [filename]
+      [flag -0 introduced and can be configured in config as 'flag' 'default']
+    * added long forms for -q (--verbose-0|--quiet) -v (--verbose-1|--verbose)
+      -V (--verbose-2|--Verbose) -M (--maintenance) and -VM (--verbose-3)
+
+  * sst_identify_markup minor adjustments
+
+  * sst_do_inline_footnotes minor adjustments
+
+  * xml input representation variants (sax, dom, node), minor adjustments in
+    conversion to and from ordinary sisu markup (.sst)
+
+  * shared_xml fix (occasionally affecting html) make sure content of
+    <meta name= tag do not contain double quote character transform to 
+    single quote
+
+  * ODF and XML special character and XML escape fixes
+
+  * gpl3 draft3 included as document markup sample
+    (requires the ODF and XML escape fixes made in this release version)
+
+%% sisu_0.51.0.orig.tar.gz  (2007w13/6 | 2007-03-31)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.51.0.orig.tar.gz
+  a5e68fd38f2e35d9d18e0fdbcb5e13cb 1260579 sisu_0.51.0.orig.tar.gz
+  2f7a0cd2b8866c1b92cdd09ff307ed5e 606 sisu_0.51.0-1.dsc
+  bd3565eabc814d2c457302bb0d88a0c2 141851 sisu_0.51.0-1.diff.gz
+
+  * defaults and skins, refactoring (code simplification)
+    * consequential pervasive small changes throughout code
+    * existing skins need to be rewritten (necessary modifications relatively
+      straightforward) [this is the reason for the version number bump up]
+
+    [NB. (i) document syntax remains unchanged; 
+    (ii) refactoring changes pass initial tests but require further testing]
+
+  * xml representations of sisu markup, small a touch
+
+%% sisu_0.50.4.orig.tar.gz  (2007w12/6 | 2007-03-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.50.4.orig.tar.gz
+  9582c43e6a8b888865ffa756f5b897c5 1269202 sisu_0.50.4.orig.tar.gz
+  606947b8081fc7d7bbfb299c258e2f19 606 sisu_0.50.4-1.dsc
+  c194ae084a143b8b7e586bac152f3486 141639 sisu_0.50.4-1.diff.gz
+
+  * (rudimentary generated) sample search form
+    * fix: db paths for files;
+    * fix: highlighting of matches (not yet consistent)
+    * feature: db select range can be set from url (limit and offset)
+    * cosmetic: text adjustments
+
+%% sisu_0.50.3.orig.tar.gz  (2007w11/6 | 2007-03-17)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.50.3.orig.tar.gz
+  fd6c335ea792bdec34dafd22112a28cc 1266710 sisu_0.50.3.orig.tar.gz
+  ab6e0d4e85f9bbe4ccbf73c13050a76b 606 sisu_0.50.3-1.dsc
+  ab3d87396df3cf4c4319d84ce86e30ef 141612 sisu_0.50.3-1.diff.gz
+
+  * sample search form, generated cgi fixes, including selected db path for
+    urls, and setting of webserver port
+
+  * concordance, add search widget
+
+  * html navigation band, need more space with search widget, descriptions
+    shortened
+
+%% sisu_0.50.2.orig.tar.gz  (2007w11/6 | 2007-03-17)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.50.2.orig.tar.gz
+  a8775153ce7e36b900c93b2d21108592 1266482 sisu_0.50.2.orig.tar.gz
+  0fdfc5112033dd0477757193bda1e732 606 sisu_0.50.2-1.dsc
+  a7f5598bc317e18694777cca32eeb277 141599 sisu_0.50.2-1.diff.gz
+
+  * cgi sample search form, a bit of work, needs more
+    * url logic (testing required)
+    * boolean constructs (passed to SQL engine) (requires work)
+    * cgi_pgsql system call made to psql to extract list of available databases
+
+  * search forms (embedding), incorporation into navigation bands, and promo
+    panes (can be limited to search of document in question only, and provide as
+    result matched: object number index or text)
+    * configure sisurc.yml with information on action (cgi query url) and sisu
+      database name
+    * html_promo, search forms may be constructed for sisu databases
+      (yaml samples promo.yml and list.yml provide commented out example)
+
+  * promo (html) may be set (a) per document in document header or by document
+    skin, by directory in directory skin, or directory sisurc file, or per site
+    in per site skin or sisurc file
+
+  * initialisation of directories -CC, set permissions of copied files to 644
+
+  * help, man pages minor updates, default homepage update
+
+    [many small changes, extensive testing required]
+
+  * initial tests with ruby-1.8.6 passed
+
+%% sisu_0.50.1.orig.tar.gz  (2007w10/6 | 2007-03-10)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.50.1.orig.tar.gz
+  51f2236f3612bce6fa2bbcb0cf9545ed 1263537 sisu_0.50.1.orig.tar.gz
+  25a1a4adf387c11d66b985dc2cf47623 606 sisu_0.50.1-1.dsc
+  ae312bda6b54e9e1b8cfaece0f03e1b4 141521 sisu_0.50.1-1.diff.gz
+
+  * promo/advertise minor extension
+
+  * css default, minor changes
+
+  * postgresql indexes, not built automatically on text fields, rely on tsearch, 
+    (suggest you build gin indexes)
+
+  * cgi sample search form scripts visited
+
+  * yaml sample files promo.yml and list.yml updated
+    (removed from conf (/etc/sisu) copy in document samples)
+
+%% sisu_0.50.0.orig.tar.gz  (2007w10/2 | 2007-03-06)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.50.0.orig.tar.gz
+  76844391967ef202a748fa1be9d16a23 1265163 sisu_0.50.0.orig.tar.gz
+  af406857bf7cf1d91ddf0ff1249fe174 606 sisu_0.50.0-1.dsc
+  6b0f5e2a44d8f2dc130efb075601834c 141436 sisu_0.50.0-1.diff.gz
+
+  * CHANGELOG renamed from version_manifest.changelog
+
+  * html some play with navigation bands (usability)
+
+  * sisurc.yml used (instead of depreciated sisurc.yaml)
+
+  * version.yml used (removed version.yaml)
+
+  * dal, metaverse renamed da for document abstraction (layer), variables (and
+    sisupod structure) renamed accordingly. [dal preferred to da because it is
+    easier to find].
+
+  * i18n, (babel renamed i18n)
+
+  * texpdf pdf output make a note about sisu_manifest, alternative output
+    formats
+
+  * promo/advertise, html, permits division into a major and a minor pane
+    (left) which is available for promotional material, links etc. the content of
+    which is currently controlled header @promo: and yaml files promo.yml and
+    list/yml usual path = = = _sisu/skin/yml ~/.sisu/skin/yml /etc/sisu/skin/yml
+    added sample of promo.yml and list.yml and an edited out header for promo
+    inclusion in "Free as in Freedom" and "GPL" document samples (these are
+    called by the document (header) but stored externally from the document (in
+    yml files (promo.yml and list.yml)), (will be possible to make a directory
+    wide inclusion))
+
+  [.gh 50th anniversary commemorative edition - "Freedom and Justice"]
+
+%% sisu_0.49.2.orig.tar.gz  (2007w08/6 | 2007-02-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.49.2.orig.tar.gz
+  10795b62c129f99645dd100a2fe52ddc 1263418 sisu_0.49.2.orig.tar.gz
+  9983da392f16660e9e580b4d92197239 606 sisu_0.49.2-1.dsc
+  0a13214e9ac2aba566c1f7bcd030c1ec 141340 sisu_0.49.2-1.diff.gz
+
+  * sysenv, for processing of remote files, download of remote images,
+    correction to variable name
+
+  * odf documents linebreaks removed
+
+  * description, less mention of document management, more on lightweight
+    markup, text structuring, publishing and search
+
+%% sisu_0.49.1.orig.tar.gz (2007w06/6 | 2007-02-10)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.49.1.orig.tar.gz
+  4c2f96d5236d389384599899ed524bdb 1261990 sisu_0.49.1.orig.tar.gz
+  e9d3028830f44afb1ddd91fa08022bfe 606 sisu_0.49.1-1.dsc
+  4dd3d53ca4b881e62654b871c9cf0957 141247 sisu_0.49.1-1.diff.gz
+
+  * xml, minor refactoring
+
+  * segmented html, minor user interface navigation changes (for pre next and
+    toc): 
+    * navigation arrow buttons and available documents information trade
+      places, navigation arrows moved right (less cursor movement used in
+      navigation, the scroll bar is usually on the right, also more consistent
+      presentation (placement as in toc))
+    * removed two sets of html segment navigation bands, from very top and
+      under title (cleaner presentation without reduction in functionality, (also
+      for console clients))
+
+  * remote placement, rsync, simplify mapping used, should be a bit more robust
+
+  * response, user response abstraction, minor
+
+  * metaverse, superscript, subscript regex adjusted, (consider adopting this
+    modification more widely)
+
+  * digests, representation of document structure updated to use @, :A-:C, 1-3
+    (instead of 0-6)
+
+    [consider object numbering rule change, re: paragraph/line consisting
+    solely of * * * or ***, should these be un-numbered?, currently are numbered]
+
+%% sisu_0.49.0.orig.tar.gz (2007w04/5 | 2007-01-26)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.49.0.orig.tar.gz
+  b628ed7a7b50cb6af37b7072c1ebff3a 1262979 sisu_0.49.0.orig.tar.gz
+  a4d610ca440369ee6bfec28d386f6490 606 sisu_0.49.0-1.dsc
+  56903630d97439f290de51622941dfe1 141237 sisu_0.49.0-1.diff.gz
+
+  * substantially the same as 0.48.8-10 (minor change (sysenv mkdir))
+    0.49 opened post freeze and decision to use iso 639-2
+
+  * [use recursive acronym]
+
+    [0.48 branch should have become 0.49 with switch to iso 639-2
+    in 0.48.8-8 = = = 0.48.12-1 (as this requires the renaming
+    of some markup files e.g. dk becomes da) [builds from now are
+    post freeze (Etch), and the development routine should be
+    more regular]]
+
+%% sisu_0.48.12.orig.tar.gz (2007w04/3 | 2007-01-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.12.orig.tar.gz
+  9b5798e5452624ee051b6a2e1c3cbee5 1262380 sisu_0.48.12.orig.tar.gz
+  0984bb76407ffeb2ed320e2fe54dd370 609 sisu_0.48.12-1.dsc
+  5781b7838cc7eb0a442e99b65713ef74 141210 sisu_0.48.12-1.diff.gz
+
+  * [NOTE substantially the same as 0.48.8-8 (Etch freeze is at 0.48.8)]
+
+  * [NOTE rebuild of the 0.48.11  of (2007w02/5 | 2007-01-12) to merge branch
+    in version control, chronological break in sequence, this build is
+    substantially the same as 0.48.8-7, subsequent versions of 48.8 are more
+    recent (Etch freeze is at 0.48.8), the latest being 0.48.8-8]
+
+  Originally released as:
+  %% sisu_0.48.12.orig.tar.gz (2007w03/7 | 2007-01-21)
+  174368e60459b0a57db63bfb818f2d80 1261172 sisu_0.48.12.orig.tar.gz
+  5c941a2810bd816c3c4285171c90e13c 609 sisu_0.48.12-1.dsc
+  7705abb94584cbe9b4803933e8ebf765 140977 sisu_0.48.12-1.diff.gz
+
+  * use ISO 639-2 for language codes, file names etc.
+    (rename danish samples .~da (instead of dk), [took out Brazilian Portuguese
+    and U.S. American English])
+
+  * debian samples, tex pdf page breaking instruction modified/corrected, and
+    danish examples renamed ISO 639-2
+
+  * sisupod initialisation, fix, (should not fail when initiated in a new sisu
+    work directory, (however do not mix regular sisu markup files and sisupod on
+    command line))
+
+  * sysenv, generic question/check added; used as safeguard against accidental
+    making sisupod of (whole) directory.
+
+  * xml, xhtml several adjustments (including use of xlink), also related css
+    fixes
+
+  * html, toc cosmetic correction
+
+%% sisu_0.48.11.orig.tar.gz (2007w04/3 | 2007-01-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.11.orig.tar.gz
+  341b2cebe2efdba4ae776f2752e9ce1b 1259351 sisu_0.48.11.orig.tar.gz
+  66f3abd74a14f671af92074e7e6ea0fd 609 sisu_0.48.11-1.dsc
+  0d416f48777c99c2b13f2c98a330fd13 141583 sisu_0.48.11-1.diff.gz
+
+  * [NOTE rebuild of the 0.48.11  of (2007w02/5 | 2007-01-12) to merge branch
+    in version control, chronological break in sequence, this build is
+    substantially the same as 0.48.8-7, subsequent versions of 48.8 are more
+    recent (Etch freeze is at 0.48.8), the latest being 0.48.8-8]
+
+  Originally released as:
+  %% sisu_0.48.11.orig.tar.gz (2007w02/5 | 2007-01-12)
+  67ac00458d75646750c67ae3c685cee4 1258340 sisu_0.48.11.orig.tar.gz
+  79c32c1eca4a3be3f97b90ffa6f6f746 609 sisu_0.48.11-1.dsc
+  92153fcc5bd633e45c90c4d8b32115e0 141365 sisu_0.48.11-1.diff.gz
+
+  * sisu-0.48.8-7 equivalent, which includes a fix to the sample cgi search
+    form [0.48.8-4 introduced a bug]
+
+%% sisu_0.48.10.orig.tar.gz (2007w04/3 | 2007-01-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.10.orig.tar.gz
+  42b50dac775cbad84ebc394ec415986d 1259007 sisu_0.48.10.orig.tar.gz
+  d23694f1466e2af8766e61109fa97fcc 609 sisu_0.48.10-1.dsc
+  9ea670634d088c996642ad4f2ec95c4d 141560 sisu_0.48.10-1.diff.gz
+
+  * [NOTE rebuild of the 0.48.10  of (2007w02/1 | 2007-01-08) to merge branch
+    in version control, chronological break in sequence, this build is
+    substantially the same as 0.48.8-6, subsequent versions of 48.8 are more
+    recent (Etch freeze is at 0.48.8), the latest being 0.48.8-8]
+
+  Originally released as:
+  %% sisu_0.48.10.orig.tar.gz (2007w02/1 | 2007-01-08)
+  57f4d4f16ec7bb210823a3fb50cfc644 1257250 sisu_0.48.10.orig.tar.gz
+  2f61d673ded3df48e0e55b49051b652f 609 sisu_0.48.10-1.dsc
+  6cee860bf9684dce3660f5433b9b1bf4 141126 sisu_0.48.10-1.diff.gz
+
+  * debian control, sisu-pdf now depends on texlive alone (tetex removed)
+    (and free from use of metapackages). Feedback from Frank Küster, Ralf
+    Stubner and Norbert Preining (Closes: #402807)
+    [0.48.8-6]
+
+  * rollover year 2006 to 2007
+    [0.48.8-5]
+
+   * cgi sample form related modifications (relatively minor but nice to have
+    sorted) [0.48.8-4]:
+
+    * cgi_pgsql and cgi_sqlite, dynamic path used instead (fixed path will
+      result in errors where the default path is not used).
+
+    * cgi_pgsql and cgi_sqlite, "documentation" tip for copying generated cgi
+      sample to cgi-bin directory, prevent accidental copying to a directory
+      instead of file. Dynamic path used.
+
+    * debian/control Recommends libfcgi-ruby1.8 moved to sisu-postgresql and
+      sisu-sqlite (only used in this context) (previously suggested, needed for
+      sample search form)
+
+  * documentation/help on initially creating postgresql database for use if
+    necessary
+    [0.48.8-3]
+
+  * LaTeX, bugfix - restores missing left column object/paragraph numbers
+    (missing curly (close) brace) [important, though marked as normal]
+    [bug introduced somewhere between 0.47 and 0.48] (closes: #403037)
+    [0.48.8-2]
+
+  * LaTeX use mathptmx.sty instead of "obsolete" times.sty (as suggested by
+    Frank Küster in Bug#402807)
+    [0.48.8-2]
+
+  * cgi-sample form, an arbitrary limit set for sql query results
+    (1000 better than none) (closes: 403042)
+    [0.48.8-2]
+
+  * defaults, update sisu default homepage to current, (mainly urls)
+    [0.48.8-2]
+
+  * css addition to correspond with change to homepage
+    [0.48.8-2]
+
+  * debian control, adds mention of editors other than vim for which there is
+    some kind of syntax support, kate, kwrite, gedit, diakonos
+    [0.48.8-2]
+
+  * vim syntax file, minor adjustment (related to an endnote shortcut)
+
+  * doc/sisu/html keep copy of homepage
+    [introduced in 0.48.9]
+
+%% sisu_0.48.9.orig.tar.gz (2007w04/3 | 2007-01-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.9.orig.tar.gz
+  1ad6d950454583d0130430664fc982ec 1258128 sisu_0.48.9.orig.tar.gz
+  f727321854bdf95cbb12e40bc247dd7f 606 sisu_0.48.9-1.dsc
+  957f1438013ec99bc9a6c5010ca5ea1c 141430 sisu_0.48.9-1.diff.gz
+
+  * [NOTE rebuild of the 0.48.9  of (2006w52/1 | 20061225) to merge branch in
+    version control, chronological break in sequence, this build is substantially
+    the same as 0.48.8-2, subsequent versions of 48.8 are more recent
+    (Etch freeze is at 0.48.8), the latest being 0.48.8-8]
+
+  Originally released as:
+  %% sisu_0.48.9.orig.tar.gz (2006w52/1 | 20061225)
+    237b2bae3e343e4b4c2f781d554f7df8 1254360 sisu_0.48.9.orig.tar.gz
+    8dc727e95913688179b7808592e1c4e9 606 sisu_0.48.9-1.dsc
+    f53b18bbc0919121040cf4c022356e35 140080 sisu_0.48.9-1.diff.gz
+
+  * source tarball incorporates fixes added after Etch freeze in deb 0.48.8-2
+
+    * LaTeX, bugfix - restores missing left column object/paragraph numbers
+      (missing curly (close) brace) [important, though marked as normal]
+      [bug introduced somewhere between 0.47 and 0.48] (closes: #403037)
+
+    * LaTeX use mathptmx.sty instead of "obsolete" times.sty (as suggested by
+      Frank Küster in Bug#402807)
+
+    * cgi-sample form, an arbitrary limit set for sql query results
+      (1000 better than none) (closes: 403042)
+
+    * defaults, update sisu default homepage to current, (mainly urls)
+
+    * css addition to correspond with change to homepage
+
+    * debian control, adds mention of editors other than vim for which there is
+      some kind of syntax support, kate, kwrite, gedit, diakonos
+
+  * texpdf, usepackage url
+
+  * doc/sisu/html keep copy of homepage
+
+  * debian control, sisu-pdf depends for tetex | texlive, take on board
+    suggestion by Frank Küster (see #402807)
+
+%% sisu_0.48.8.orig.tar.gz (2006w48/1 | 20061127)       [Debian Release snapshot, uploaded by Daniel Baumann (Medium)]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.8.orig.tar.gz
+  556de4a3025156e0e7010210a0ddc32f 1248719 sisu_0.48.8.orig.tar.gz
+  e32d8183b0c1dde1020ecf3eced25dff 606 sisu_0.48.8-1.dsc
+  b054905ec4d964f73ccb0c705d593e63 139568 sisu_0.48.8-1.diff.gz
+
+  * metaverse, "visual" adjustment to allow inclusion of column width
+    information
+
+  * debian, dfsg document samples debian constitution v1.3 added
+    [english, german, danish]
+
+  * [sisu-markup-samples_1.0.4 contains "The Wealth of Networks", Yochai
+    Benkler]
+
+%% sisu_0.48.8-2 (2006w50/4 | 20061214)                 [Etch related fixes, uploaded by Daniel Baumann (Medium)]
+  0eba8d5dd3086bd2d1fa830c6c19527c 606 sisu_0.48.8-2.dsc
+  42662b8bf9a83321edbbab0b3b3db554 145527 sisu_0.48.8-2.diff.gz
+
+  * LaTeX, bugfix - restores missing left column object/paragraph numbers
+    (missing curly (close) brace) [important, though marked as normal]
+    [bug introduced somewhere between 0.47 and 0.48] (closes: #403037)
+
+  * LaTeX use mathptmx.sty instead of "obsolete" times.sty (as suggested by
+    Frank Küster in Bug#402807)
+
+  * cgi-sample form, an arbitrary limit set for sql query results 
+    (1000 better than none) (closes: 403042)
+
+  * defaults, update sisu default homepage to current, (mainly urls)
+
+  * css addition to correspond with change to homepage
+
+  * debian control, adds mention of editors other than vim for which there is
+    some kind of syntax support, kate, kwrite, gedit, diakonos
+
+%% sisu_0.48.8-3 (2006w52/5 | 20061229)                 [Etch related fixes, uploaded by Daniel Baumann (Medium)]
+  0f5acb28c8e9fdd21c29db7fbc7e1d3c 606 sisu_0.48.8-3.dsc
+  669875a8ca8102e5772df258b0665ba8 147220 sisu_0.48.8-3.diff.gz
+
+  * texpdf, usepackage url (improved placement of urls)
+
+  * debian control, sisu-pdf now depends on texlive alone, (alternative tetex
+    depends removed - reason: problem keeping both working!), take on board
+    suggestion by to rely on texlive Frank Küster if tetex is problematic (this
+    addresses, but does not close #402807 without further discussion, dropping
+    alternative tetex depends simplifies sisu-pdf (tex) related depends, and
+    makes it much more reliable (also see in changelog earlier feedback on
+    sisu-pdf depends from Norbert Preining url at 0.47.7-3) depends here drop
+    reliance on metapackages, (extra checks required as to determine whether
+    texlive depends list may be shortened, playing safe))
+
+  * debian/control priority changed to extra (from optional) as depends on
+    texlive (without option for use of tetex instead)
+
+  * debian/control sisu recommends libfcgi-ruby1.8 (previously suggested,
+    needed for sample search form)
+
+  * documentation/help on initially creating postgresql database for use if
+    necessary
+
+%% sisu_0.48.8-4 (2006w52/7 | 20061231)                 [Etch related fixes, uploaded by Daniel Baumann (Medium)]
+  20337413c61bc87b8a9b3e8a2e843b81 606 sisu_0.48.8-4.dsc
+  b440173ffabe147a851ecb25b20db6a2 148820 sisu_0.48.8-4.diff.gz
+
+  * cgi sample form related modifications (relatively minor but nice to have
+    sorted):
+  
+    * cgi_pgsql and cgi_sqlite, dynamic path used instead (fixed path will
+      result in errors where the default path is not used).
+  
+    * cgi_pgsql and cgi_sqlite, "documentation" tip for copying generated cgi
+      sample to cgi-bin directory, prevent accidental copying to a directory
+      instead of file. Dynamic path used.
+  
+    * debian/control Recommends libfcgi-ruby1.8 moved to sisu-postgresql and
+      sisu-sqlite (only used in this context)
+
+%% sisu_0.48.8-5 (2007w01/2 | 2007-01-02)                 [Etch related fixes, uploaded by Daniel Baumann (Medium)]
+  07964ec823ae5d96a04ff6c88f5a7f66 606 sisu_0.48.8-5.dsc
+  90aa76b6061e10e715726c51e5b08a70 153491 sisu_0.48.8-5.diff.gz
+
+  * sisu-pdf texlive dependencies shortened and free from use of metapackages
+
+  * rollover year 2006 to 2007
+
+%% sisu_0.48.8-6 (2007w01/3 | 2007-01-03)                 [Etch related fixes, uploaded by Daniel Baumann (Medium), cleared/unblocked by  Marc 'HE' Brockschmidt]
+  4c95034d6d9bbe67cd2d008e561a78cc 606 sisu_0.48.8-6.dsc
+  02bda8e1da0ef74396b1e85ac8ce9e6e 154145 sisu_0.48.8-6.diff.gz
+
+  * sisu-pdf texlive dependency in -5 adjusted on feedback from Norbert
+    Preining (Closes: #402807)
+      http://lists.debian.org/debian-tex-maint/2007/01/msg00034.html
+      http://lists.debian.org/debian-tex-maint/2007/01/msg00033.html
+
+%% sisu_0.48.8-7 (2007w02/3 | 2007-01-10)                 [Etch related fixes, uploaded by Daniel Baumann (Medium), cleared/unblocked by  Marc 'HE' Brockschmidt]
+  fd6e2df63f7b75bc3ad7aa5c34f606fd 606 sisu_0.48.8-7.dsc
+  2e2fc97a23a4550ed279f94f85ea7378 157623 sisu_0.48.8-7.diff.gz
+
+  * the cgi sample form modifications introduced in -4 were premature, they
+    break things, behaviour reverted to -2 [-3].
+    (Closes: #406281 and #406280) [same bug]
+
+  * removed sisu-sqlite suggests on libdbd-sqlite and
+    sisu-postgresql suggests on libdbd-pgsql which are 
+    not found in testing/Etch
+    (Closes: #406282 and #406284)
+
+  * sisu html man page regenerated (from man page)
+
+%% sisu_0.48.8-8 (2007w03/7 | 2007-01-21)                 [Etch related fixes, uploaded by Daniel Baumann (Medium)]
+  0ba3e2e6efecd2c57dccf6457200e945 606 sisu_0.48.8-8.dsc
+  2fb929cfa2fd00366cda7b38f2dea4dd 168554 sisu_0.48.8-8.diff.gz
+
+  * use ISO 639-2 for language codes, file names etc.
+    (rename danish samples .~da (instead of dk), [took out Brazilian Portuguese
+    and U.S. American English])
+
+  * debian samples, tex pdf page breaking instruction modified/corrected, and
+    danish examples renamed ISO 639-2
+
+  * sisupod initialisation, fix, (should not fail when initiated in a new sisu
+    work directory, (however do not mix regular sisu markup files and sisupod on
+    command line))
+
+  * sysenv, generic question/check added; used as safeguard against accidental
+    making sisupod of (whole) directory.
+
+  * xml, xhtml several adjustments (including use of xlink), also related css
+    fixes
+
+  * html, toc cosmetic correction
+
+%% sisu_0.48.8-9 (2007w04/1 | 2007-01-22)                 [Etch related fixes, uploaded by Daniel Baumann (Medium)]
+  8ba3e0a9ba6b9b0f4966e020cbcee865 606 sisu_0.48.8-9.dsc
+  1ac6537c065807c1459e63a4122f9d79 145898 sisu_0.48.8-9.diff.gz
+
+  * removed Danish debian sample markup files to reduce the size of the 
+    inter-diff against the package in testing.
+
+  * minor further adjustments to xml processing
+
+%% sisu_0.48.8-10 (2007w04/2 | 2007-01-23)                 [Etch related fixes]
+  ccc192b7615235f56c9e5b122089d50d 608 sisu_0.48.8-10.dsc
+  64732549e20c98a6958a3544770343fb 146148 sisu_0.48.8-10.diff.gz
+
+  * xml and xhtml adjustment of regex match of urls for xlink
+
+%% sisu_0.48.8-11 (2007w07/5 | 2007-02-16)                 [Etch related fixes]
+  0f3e22d6fd4cfab955f47f9cb5840d7a 608 sisu_0.48.8-11.dsc
+  825404e40bfbe54999c0ae4ec90fa682 162284 sisu_0.48.8-11.diff.gz
+
+  * xml, minor refactoring
+
+  * segmented html, minor user interface navigation changes (for pre next and
+    toc): 
+    * navigation arrow buttons and available documents information trade
+      places, navigation arrows moved right (less cursor movement used in
+      navigation, the scroll bar is usually on the right, also more consistent
+      presentation (placement as in toc))
+    * removed two sets of html segment navigation bands, from very top and
+      under title (cleaner presentation without reduction in functionality, (also
+      for console clients))
+
+  * remote placement, rsync, simplify mapping used, should be a bit more robust
+
+  * response, user response abstraction, minor
+
+  * metaverse, superscript, subscript regex adjusted, (consider adopting this
+    modification more widely)
+
+  * digests, representation of document structure updated to use @, :A-:C, 1-3
+    (instead of 0-6)
+
+  * sysenv, change in use of mkdir
+
+  * sysenv, for processing of remote files, download of remote images,
+    correction to variable name [post 0.49.1 fix]
+
+  [this build is based on 0.49.1 which is "stable" in its major parts]
+
+%% sisu_0.48.7.orig.tar.gz (2006w46/7 | 2006-11-19)       [Debian Release snapshot, uploaded by Daniel Baumann (Medium)]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.7.orig.tar.gz
+  2bbc89da7fa28de1193ea64fd98bb522 1248263 sisu_0.48.7.orig.tar.gz
+  94adac2227718f4a6c1c2437c883e939 606 sisu_0.48.7-1.dsc
+  f53871fe2aad4fc8ddfb9b3b1817d677 100806 sisu_0.48.7-1.diff.gz
+
+  * cgi html test search form, multilingual documents, file naming convention
+    resulted in incorrect url mapping of results, fixed
+
+  * dcc, document content digest, multilingual/non-English documents, fixes
+    related to translation and metadata extraction
+
+  * defaults for html, invisible dot navigation buttons, text made cleaner for
+    console clients, using < ^ > for pre, toc, and next, (there are other
+    equivalent navigation options)
+
+  * sitemaps, very early days, stubs in place to make this work
+    (google, yahoo, ms announced their joint decision to use this week)
+
+  * remote, placement of sitemaps directory to remote server, rsync
+
+%% sisu_0.48.6.orig.tar.gz (2006w45/6 | 2006-11-11)       [Debian Release snapshot, uploaded by Daniel Baumann (Medium)]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.6.orig.tar.gz
+  82b8dd63a4626fcef222d039820827cc 1245728 sisu_0.48.6.orig.tar.gz
+  25be6c97cfa020a1b2971e02bc32b715 606 sisu_0.48.6-1.dsc
+  1c682265850177ec5eb32a3cfe1fc3cd 100704 sisu_0.48.6-1.diff.gz
+
+  * html, doc (single text, scroll version) tables, fixed
+
+  * texpdf, bugfix for (asterisk marker type) footnotes in headings, fixed
+
+  * metaverse, in "visual" table representation {table} may be used instead of
+    {t} likewise {table~h} instead of {t~h},
+    (resulting output cleaned, fix)
+
+  * vim syntax highlighting updated for {table} match
+
+%% sisu_0.48.5.orig.tar.gz (2006w45/3 | 2006-11-08)       [Debian Release snapshot, uploaded by Daniel Baumann (Medium)]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.5.orig.tar.gz
+  208f47dcc87802fcd14b64e9c1aa2a52 1245103 sisu_0.48.5.orig.tar.gz
+  1664f21a14fa2311d7cb115e8d31fc88 606 sisu_0.48.5-1.dsc
+  428fe256c0dd063d362baa751866ede8 100632 sisu_0.48.5-1.diff.gz
+
+  * sisupod (directory zip) creation, file selection tuning
+  
+  * command line option papersize (texpdf), minor convention e.g.
+    --papersize-letter (in addition to --papersize=letter) available options:
+    European 'A4', book 'a5', 'b5' and U.S. 'letter', 'legal' (system defaults
+    to A4). However, these can be and are better set in the config file
+    (document headers being another though not recommended possibility),
+
+    'sisu --help env' should list the current (default/configuration) settings
+    including papersize
+
+  * minor checks, minor editing, e.g. man pages
+
+%% sisu_0.48.4.orig.tar.gz (2006w45/1 | 2006-11-06)       [Debian Release snapshot, uploaded by Daniel Baumann (Medium)]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.4.orig.tar.gz
+  eee656e88462c4dc2f338dadb26fc97a 1244746 sisu_0.48.4.orig.tar.gz
+  70bd0670b8b21130856e87d32644102c 606 sisu_0.48.4-1.dsc
+  f72edba97792bc72f07b5b66223761fc 100603 sisu_0.48.4-1.diff.gz
+
+  * texpdf, default table behaviour changed to accommodate tables with a lot of
+    text, also some cleaning of tables (fixed)
+
+  * plaintext, serious performance issue when dealing with a document with
+    tables, [especially annoying as tables are omitted from this output format]
+    addressed (fixed)
+
+  * markup footnote conversion to paragraph inline footnotes, (fixed)
+
+  * minor adjustment to sisupod directory name...
+
+%% sisu_0.48.3.orig.tar.gz (2006w44/2 | 2006-10-31)       [Debian Release snapshot, uploaded by Daniel Baumann (High)]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.3.orig.tar.gz
+  8c3fffc9a7da73220e15d15cfba968bf 1243334 sisu_0.48.3.orig.tar.gz
+  6a75a4a2d5817914f274388237ddcf4d 606 sisu_0.48.3-1.dsc
+  eea089e0690c3aa6c7a4baae8c4b5f54 100547 sisu_0.48.3-1.diff.gz
+
+  * one file omitted in sisu 0.48.2 fix, see comments there.
+
+%% sisu_0.48.2.orig.tar.gz (2006w44/2 | 2006-10-31)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.2.orig.tar.gz
+  a9a876acb9cdf3501cd3d7bfe09db9d0 1243141 sisu_0.48.2.orig.tar.gz
+  ae29c18dfb96d898e608ff50b1d20512 606 sisu_0.48.2-1.dsc
+  e16685b9fe00f5e6096f72386d699ff7 100497 sisu_0.48.2-1.diff.gz
+
+  * debian ruby build ruby-1.8.5-3 (uploaded yesterday) detects and breaks on
+    cyclic include errors which were found at a basic level of operation,
+    rendering program effectively broken. New ruby build affects all previous
+    versions of sisu. [Further code review is necessary to ascertain that this
+    does not occur anywhere else within sisu code base]
+
+%% sisu_0.48.1.orig.tar.gz (2006w43/7 | 2006-10-29)       [Debian Release snapshot, uploaded by Daniel Baumann (Medium)]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.1.orig.tar.gz
+  cda3082de5c359737bfdfd23474fee2b 1242845 sisu_0.48.1.orig.tar.gz
+  badc4a6d1e6bc77956ec603a5278bbea 606 sisu_0.48.1-2.dsc
+  a95c14570a0e5ebd46a588c7181151f5 101129 sisu_0.48.1-2.diff.gz
+  sisu_0.48.1-1.dsc
+  sisu_0.48.1-1.diff.gz
+
+  * metaverse, indicate image missing if a requested image is not found
+
+  * processing directories default location moved to be placed under home or /tmp
+    from pwd
+
+  * (-1) debian/control, recommends hyperestraier removed as appears to cause
+    issues (also rename and pgaccess)
+
+  * (-2) debian/control recommends hyperestraier (sisu and sisu-complete) put
+    back
+
+%% sisu_0.48.0.orig.tar.gz (2006w43/6 | 2006-10-28)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.48.0.orig.tar.gz
+  5e7bc1752828347d0f43e7eb8403cfec 1241476 sisu_0.48.0.orig.tar.gz
+  79cce16683c3da3f70e9cc205710feb1 606 sisu_0.48.0-1.dsc
+  748830590639ab2e8097b8c0820b37a4 100197 sisu_0.48.0-1.diff.gz
+
+  * sisupod, creation of (zipped sisu content files, primarily a way of
+    bundling sisu content assocated with a prepared sisu file or set of files,
+    that sisu commands can be run directly against) creation:
+      'sisu -S [filename]'
+      places a file named sisupod.zip in the output directory
+    for directory
+      'sisu -S'
+      creates a sisupod of the pwd named:
+        sisupod-[pwd.stub]_[date].ssp
+      e.g. sisupod-sisu_2006-10-26.ssp
+      (uses system call to unix commands find and egrep)
+
+  * sisupod, sisu can be run directly against a sisupod without manual
+    unpacking, e.g.:
+       'sisu -3 sisupod.zip'
+    [early implementation, a system call used], 
+    run against the following filename/types: sisupod, sisupod.zip,
+    [filename].ssp
+    * security:
+      * sisu does not ever use a sisurc.yaml within a sisupod
+      * sisu will only use a skin within sisupod if --trust(ed) modifier is
+        added to the command line
+    * skins, note: copy dir skin to skin_sisupod.rb
+      [doc skin keeps name as called with name within document]
+
+  * remote operations possible on sisupod, e.g.
+    'sisu -3 http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip'
+
+  * sysenv, sisu processing directory '_sisu_processing' default placement now
+    first within pwd (markup text directory) if that is not writable under home
+    ~ and if not available to /tmp (the preference of home over /tmp my be
+    reconsidered, thinking is to default towards keeping processing related
+    info within private space)
+
+  * manifest, uses documents home button/icon, if available
+    (rather than sisu default)
+
+  * sisupod alternative names sisupod, siuspod.zip [filename].ssp
+
+  * urls, tune, removed link to html 'tune' output file, no longer generated
+
+  * sysenv, url path reporting fix, (broken by renaming in 0.47.7)
+
+  * processing directories default location moved to be placed under home or /tmp
+    from pwd, likewise sisupod creation directory moved
+    [processing directory]/sisupod  from ./_sisu/sisu_doc
+
+  * extra testing, numerous small fixes, (several related to method renaming in
+    sisu-0.47.7, also checks against both ruby 1.8.5 and current 1.9, $KCONV set
+    to UTF-8 rather than rely on environment and many more also as above)
+
+%% sisu_0.47.8.orig.tar.gz (2006w42/4 | 2006-10-19)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.47.8.orig.tar.gz
+  53c131f5c569d96ff60ecfdeb1a1f3d5 1237476 sisu_0.47.8.orig.tar.gz
+  a39620a910612684a0dc31b3b5559eda 606 sisu_0.47.8-1.dsc
+  8570a26f39ec44b3c8c539d0dcf63a99 100075 sisu_0.47.8-1.diff.gz
+
+  * metaverse, minor fix related to link created for shared source file with
+    regard to new syntax shortcut markup for listing multiple available output
+    types produced by SiSU (introduced in 0.47.6)
+
+%% sisu_0.47.7.orig.tar.gz (2006w41/6 | 2006-10-14)       [Debian Release snapshot, uploaded by Daniel Baumann]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.47.7.orig.tar.gz
+  6bb28ad3f783184876c455c91cf9ef22 1236983 sisu_0.47.7.orig.tar.gz
+  c8bf85fb300d6260176ad459c2f6e3a0 606 sisu_0.47.7-2.dsc
+  8eaeebb43b6de5ca727995d681d36b1c 102531 sisu_0.47.7-2.diff.gz
+  62c779fa5ca023af71854d989b60bfe9 609 sisu_0.47.7-1.dsc
+  07b12f4b1af9873eee44e610511ac525 99876 sisu_0.47.7-1.diff.gz
+
+  * sysenv, minor code play, some method renaming, organisational
+    (however affects rest of code, much testing, (smallish possibility of
+    breakage remains))
+
+  * gif, reinstate support, however use not yet recommended 
+    (gif no longer under patent, however, gif is not available for all pdf,
+    does not yet appear to be available in tetex) 
+    [image support: png, jpg, (gif)]
+
+  * [debian/control] sisu-pdf set to work with texlive (tetex|texlive depends)
+    (sisu works out of the box with texlive installed, currently an issue with
+    the default font in texlive) 
+    http://lists.debian.org/debian-tex-maint/2006/10/msg00620.html 
+
+%% sisu_0.47.6.orig.tar.gz (2006w40/6 | 2006-10-07)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.47.6.orig.tar.gz
+  7e319ebd2f8265f6ca7e46a4c74bd211 1236547 sisu_0.47.6.orig.tar.gz
+  bf4602222c37f9e288284e1573ebd034 609 sisu_0.47.6-1.dsc
+  9741957517f66d825d952e309d231152 99839 sisu_0.47.6-1.diff.gz
+
+  * tex/pdf, fixed paragraph indent with hyperlink
+    (previously linking not parsed and dealt with)
+
+  * tex/pdf, fixed closing double quote (was typo)
+
+  * syntax, new shortcut markup for listing multiple available output
+    types produced by SiSU (existing syntax unaffected)
+
+  * [package structure, vim directory moved to data/sisu/conf/vim from
+    data/vim]
+
+%% sisu_0.47.5.orig.tar.gz (2006w39/7 | 2006-10-01)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.47.5.orig.tar.gz
+  40d50d1db5e6f1ca4750dec82fc7aad8 1234759 sisu_0.47.5.orig.tar.gz
+  e3555bb320920eb25e62c820961105e7 609 sisu_0.47.5-1.dsc
+  a030d4f4dd052009ce36ab14dec29ed3 99796 sisu_0.47.5-1.diff.gz
+
+  * sisupod, fix creation of, change of library name caused break in 0.47.4
+
+%% sisu_0.47.4.orig.tar.gz (2006w39/5 | 2006-09-29)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.47.4.orig.tar.gz
+  71ae6429e675fdbfb6a8ab507c3e6989 1233691 sisu_0.47.4.orig.tar.gz
+  c0968784d14ac2ff6b7754dc5de6024a 609 sisu_0.47.4-1.dsc
+  a0ccb2abcee55dd60529b2cc88c73454 99693 sisu_0.47.4-1.diff.gz
+
+  * syntax highlighting, kate, kwrite, nano minor updates, review
+
+  * debian: browser and pdf reader icons removed, 
+    (Closes: #389500) fixes debian policy violation
+    removed non dfsg compliant firefox icon
+    (also removed other browser related icons)
+
+%% sisu_0.47.3.orig.tar.gz (2006w38/6 | 2006-09-23)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.47.3.orig.tar.gz
+  18ac94ea4ab58060873ba22d37d03bd0 1268844 sisu_0.47.3.orig.tar.gz
+  3c2fac012a174f930e9030863e92f065 609 sisu_0.47.3-1.dsc
+  c075392d392665de4d5054f438352f2f 99612 sisu_0.47.3-1.diff.gz
+
+  * minor code review
+    [takes care of RAM issue experienced with some forms of batch processing]
+
+%% sisu_0.47.2.orig.tar.gz (2006w38/5 | 2006-09-22)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.47.2.orig.tar.gz
+  5afc268f78ab72b17c387469e2ae5caf 1268744 sisu_0.47.2.orig.tar.gz
+  334056e0cdd87dc2887baf99a638e3d1 609 sisu_0.47.2-1.dsc
+  8e468cc4052b0f28fb3b22ef5dfbf4c2 99580 sisu_0.47.2-1.diff.gz
+
+  * metaverse, a line of code needed changing for ruby-1.8.5
+
+%% sisu_0.47.1.orig.tar.gz (2006w38/1 | 2006-09-18)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.47.1.orig.tar.gz
+  77d77e7888ee1f97a38012233d5d4d90 1268488 sisu_0.47.1.orig.tar.gz
+  c7e9cd3ee27bba16684651bda463124c 609 sisu_0.47.1-1.dsc
+  596bb6380b8355d4b5420aa5ddb2008f 99556 sisu_0.47.1-1.diff.gz
+
+  * fixed, document content certificate, issue with batch processing (and
+    cleaning of earlier document details) sorted
+
+  * fixed, sharing document source for multilingual documents (-s), creates and
+    copies to the wrong directory
+
+  * plaintext minor adjustments, and a batch processing information sync fix
+
+%% sisu_0.47.0.orig.tar.gz (2006w37/7 | 2006-09-17)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.47.0.orig.tar.gz
+  c8eb3908d4b6fb6e6bc199118a0ef897 1268127 sisu_0.47.0.orig.tar.gz
+  42836c37c783d9c7aee87085127cd87c 609 sisu_0.47.0-1.dsc
+  e02895ae383af556ebc50d7832c7d20a 99541 sisu_0.47.0-1.diff.gz
+
+  * sisupod, use zip compression and file extension .zip
+    (instead of tar gzip .tgz) interoperability, wider platform comprehension
+
+  * sisupod, master documents (.ssm) bug in batch processing sorted (todo with
+    filenames)
+
+  * html tune, unnecessary hard output removed (except in maintenance mode -M)
+
+  * (document content certificate, issue with batch processing sorted)
+
+  * reduce system calls
+
+  * odf base file, odt.zip (instead of odt.tgz), easy way to maintain directory
+    structure (issue in version control, hg drops empty directories)
+
+  * conversion, prefer --to- to --to=, keep both, man page and help updated to
+    use --to-[conversion] (also minor cleaning of screen output)
+
+  * debian/control depends zip and unzip added, used for sisupod.zip and ODF output
+
+%% sisu_0.46.5.orig.tar.gz (2006w36/6 | 2006-09-09)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.46.5.orig.tar.gz
+  bea9a0eddb1ea8746de416a7bdd22e2e 1265848 sisu_0.46.5.orig.tar.gz
+  87e99256d31497c23509811e122b6ea2 609 sisu_0.46.5-1.dsc
+  5b4caafec6ac1ebc5314f7fa44e8f677 99342 sisu_0.46.5-1.diff.gz
+
+  * documentation adjustments 
+
+%% sisu_0.46.4.orig.tar.gz (2006w36/3 | 2006-09-06)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.46.4.orig.tar.gz
+  506bc266f4618eea88c7c005f21c2bf4 1269441 sisu_0.46.4.orig.tar.gz
+  6fbd0e2e7f2915725feb03e3ea0f977f 609 sisu_0.46.4-1.dsc
+  a7fcd22b852f90ab4af04c56143a8aa2 99242 sisu_0.46.4-1.diff.gz
+
+  * defaults html text/ accompanying blurb removed some Ruby / Debian / Linux /
+    Unix text
+
+%% sisu_0.46.3.orig.tar.gz (2006w36/1 | 2006-09-04)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.46.3.orig.tar.gz
+  c41d41e0771e66c236b2832c8798a1d8 1269233 sisu_0.46.3.orig.tar.gz
+  74458da231e6e4628996c48eb915344d 609 sisu_0.46.3-1.dsc
+  f7ab7c92526bfecd71331a69ef069d44 99223 sisu_0.46.3-1.diff.gz
+
+  * Ruby version upped to 1.8.4, (probably will work with earlier versions but
+    not tested)
+
+  * db option synonyms --pgsql for -D or --sqlite for -d
+
+  * document structure, extended level, stubs in place
+
+  * syntax highlighting, directory renamed and a quick look at kate and
+    diakonos updated
+
+  * help/man pages, db related minor update
+
+  * termsheet checked
+
+  * minor code play
+
+  * debian/control moved from extra to optional - does not conflict with
+    anything, though a bit specialised perhaps
+
+  * debian/copyright, year 2006 added
+
+  * [debian/control build does not permit changing ruby version to 1.8.4]
+
+%% sisu_0.46.2.orig.tar.gz (2006w34/5 | 2006-08-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.46.2.orig.tar.gz
+  852d865e66fd37e1902d3940cd460e55 1265122 sisu_0.46.2.orig.tar.gz
+  9931d0d05ea5e37134fb063c31caa66e 609 sisu_0.46.2-1.dsc
+  6a52a52ede5cf3158cd4bd843f737295 99124 sisu_0.46.2-1.diff.gz
+
+  * experimental conversion xml(sxs,sxn) to sst, (from xml that was converted
+    from sst) [sxd not yet in place, and several errors identified]
+
+  * header metadata extraction and sharing changed (used by xml and other
+    document types)
+
+  * conversion file libraries, some renaming
+
+  * zsh completion (see 0.46.1), simplified/corrected in response to feedback,
+    still naive
+
+  * help and man pages updated with conversion info between sst and xml and
+    back
+
+  * Ruby: ruby version restrict use to ruby-1.8.2 or later, but only tested for
+    ruby-1.8.4 (and later) [may have to restrict to more recent versions of
+    Ruby]
+
+  * Ruby: if|unless|elsif|where colon constructs are depreciated in Ruby 1.8.5.
+    (released today), so (the aesthetically more pleasing) colons switched with
+    semi-colons.  
+
+%% sisu_0.46.1.orig.tar.gz (2006w33/3 | 2006-08-16)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.46.1.orig.tar.gz
+  26bef582eb5da7fe39b578e9296ceb19 1263026 sisu_0.46.1.orig.tar.gz
+  37ebebd9bf56e2e5fd57b0b1411771be 609 sisu_0.46.1-1.dsc
+  3537949d88ec6749698fd04d21a30d96 99119 sisu_0.46.1-1.diff.gz
+
+  * zsh, naive zsh completion file _sisu in data/sisu/conf/completion (on
+    debian installed to /usr/share/sisu/conf/completion) works if copied
+    somewhere within your $fpath (do it yourself on debian copy to ~/.zfunc or
+    /usr/local/share/zsh/site-functions and run compinit)
+
+  * code, minor alterations, 
+    * creation of Arrays and Hashes, not intended to be substantive
+    * in hub corrected calling of help for termsheet
+    * small adjustments to calling of conversion scripts
+
+  * debian/control, reminded that sisu-vim existed prior to vim-sisu (renamed
+    due to vim policy) both now removed and replaced by default installation,
+    control file modified accordingly for sisu-vim
+
+%% sisu_0.46.0.orig.tar.gz (2006w32/6 | 2006-08-12)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.46.1.orig.tar.gz
+  84d863f4f41ff2e328530930890f7160 1259520 sisu_0.46.0.orig.tar.gz
+  9d04df245c99431649f40f58d5022c40 609 sisu_0.46.0-1.dsc
+  6b027cbd9d063eae67010ee072a6fc28 99068 sisu_0.46.0-1.diff.gz
+
+  * 0.44 branch reinstated (leapfrogging over 0.45 which was a reversion to
+    0.43)
+
+  * metaverse changes for consistency, affects all downstream code (with
+    attendant risk), numerous related changes; preliminary tests passed
+
+  * see 0.44.0
+
+    [basic operation (sisu -mNhwpoabxXyv [filename]) also tested for ruby 1.9
+    with rmagick switched off (db not tested)]
+
+  * debian/rules compression mentioned twice, one removed
+
+%% sisu_0.45.0.orig.tar.gz (2006w31/7 | 2006-08-06)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.45.1.orig.tar.gz
+  dbdcdd947aa6357492ac50a5bb5b81af 1242290 sisu_0.45.0.orig.tar.gz
+  9ac37f27c19ff8696631396627919806 609 sisu_0.45.0-1.dsc
+  7426d8ba2f1e2aa709a0aeccd4596f4d 99025 sisu_0.45.0-1.diff.gz
+
+  * an emergency reversion to 0.43 code, as 0.44 breaks many LaTeX/pdfs
+    [the other components of 0.44 are fine but the LaTeX part does not play
+    properly with the new code base]
+    for the present time, ignore (jump over) the version changes in 0.44,
+    and continue from 0.43
+  
+  * only the odf icon (noted in 0.44) and a cosmetic change to manifest are
+    added to this release since 0.43
+
+  * the debian related changes in 0.44 are retained
+
+  * NB. only emergency maintenance on this branch, development is on 0.44
+
+%% sisu_0.44.0.orig.tar.gz (2006w31/7 | 2006-08-06)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.44.1.orig.tar.gz
+  4ce1f4946ce12180bf257d46f5ab6ff0 1256908 sisu_0.44.0.orig.tar.gz
+  f976a5e8494184696c70c45b240933ee 609 sisu_0.44.0-1.dsc
+  a8fd211fff73a01beb17433707bb1e04 98941 sisu_0.44.0-1.diff.gz
+
+  [some breakage, in particular LaTeX/pdf had issues, fixed in 0.46.0]
+
+  * some juggling of code and renaming of some files
+    (db broken into smaller chunks)
+
+    * metaverse, document level structure moved to external shared library and
+      determined therefrom
+
+    * metaverse, ocn moved to an external shared library and together with
+     "node" numbering determined therefrom
+     [raises possibility of ocn (numbering) issues, preliminary tests passed]
+
+    * db operations broken up into smaller code files
+
+    * numerous other little things
+
+    ** Note: shared sisu libraries, practice likely to become that these contain
+      pointers to libraries, rather than the libraries themselves, e.g.
+      shared_db
+
+  * odf/odt added generic odf tiny icon
+  * html, added icon and link to opendocument text
+    (assumes output is always present, as do the pdf equivalents)
+
+  * markup, experimenting with simple xml models,
+    three xml representations of sisu markup, sxs, sxd, sxn
+    export with
+    sisu --to=sxs [filename]
+    [experimental, these will change]
+    import, not done
+
+  * --to made a synonym for --convert
+
+  * debian/rules simplified
+    [utilising feedback from Daniel Baumann on "rant" package]
+
+  * debian/control sisu-pdf Depends: changed to make TeX Live optional,
+    actually part of it is now required as tetex along with tetex-extra do not
+    contain all the LaTeX packages SiSU requires (in particular manyfoot.sty is
+    missing) [used feedback from Ralf Stubner on dependency options]
+
+  * debian/lintian/sisu added lintian override for man page and non-executables
+
+%% sisu_0.43.0.orig.tar.gz (2006w29/6 | 2006-07-22)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.43.0.orig.tar.gz
+  09127f189334eef57363875bb2fb2a4d 1241138 sisu_0.43.0.orig.tar.gz
+  11692249f8ae03a4ead59fb1f0e00514 609 sisu_0.43.0-1.dsc
+  e3307627de717fca49c9fbec988c8cc2 99392 sisu_0.43.0-1.diff.gz
+
+  * footnotes, introduction of new editor (square bracket) series, 
+    using asterisk and plus signs
+    ~[ asterisk editor note ]~ or ~[* asterisk ed. note ]~ and
+    ~[+ dagger ed. note ]~
+    outputs updated: plaintext, latex, html, xml, odf, dcc, database
+    the sample search form does not yet search the new (asterisk and plus)
+    endnote series
+    [easy to add additional symbols later, also consider it should be fairly
+    straightforward to add possibility to use of name of note maker with
+    numbered note sequences for each contributor; you may wish to think of
+    sorting into different types for some of these like plaintext, later]
+
+  * database, breaks existing database model by introducing new tables, to
+    accommodate the new endnote series, (square bracket series). (there are
+    alternative ways to add the information, e.g. add column with information
+    on the endnote symbol involved; have in fact added a table for each of the
+    symbols used)
+
+  * additional footnote annotations (asterisk, dagger) can be dropped from
+    output with command modifiers --no-asterisk, --no-dagger, --no-annotate
+
+  * --convert=footnotes (convert to embedded footnote markup, do not make
+    changes if footnote mismatch)
+    --convert=footnotes-force (make changes even if there is a footnote
+    mismatch) provide warning about changes what todo, make backup? or create
+    new file, what filename to use?
+
+  * --no-ocn switches off object citation numbering. Produce output without
+    identifying numbers in margins of html or LaTeX/pdf output. [with -h -H or
+    -p]
+
+  * vim syntax highlighter recognises footnote/annotation additions
+
+  * debian vim/addons/syntax/sisu.vim add the new syntax file
+    (submit changes to Bram)
+
+  * man page and help.rb updated on editor footnotes, square bracket series
+
+  * relaxng object models, look at, included in data/doc/sisu/models/relaxng
+    (some models quite old, and undeveloped, originally in sisu library
+    relaxng.rb)
+
+  * metaverse, and elsewhere, utf-8 is assumed: started cleaning out legacy
+    code (character converting regex) sisu generates its first Chinese document
+    in html, plaintext and sql databases (postgresql and sqlite) only, at this
+    stage... [confirmation that first Chinese document presentation is fine,
+    from author of test (law related) text; the listed text representations
+    reasonably handle the utf-8 characters involved, and document structure is
+    ok]
+
+%% sisu_0.42.4.orig.tar.gz (2006w29/1 | 2006-07-17)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.42.4.orig.tar.gz
+  dccd6a56bcd2217d3bb0f1be5211ed57 1230468 sisu_0.42.4.orig.tar.gz
+  a6814ae0311a22d1f0ca89208629e2ac 609 sisu_0.42.4-1.dsc
+  bdebad3bdcda48423bdb4a021224c04b 99255 sisu_0.42.4-1.diff.gz
+
+  * sisu_manifest, pdf description express portrait copy to be optimised/biased
+    towards print, and landscape to have screen view bias/optimisation
+    (orientation and colored links)
+
+  * debian (mostly), meta-packages man pages moved to man(7)
+    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=377209
+    (Closes: #377209) [which was re-opened as not properly done previously,
+    myon]
+
+  * debian, closed bug 377208 after informing submitter changes had been made
+    and requesting review ('fixed' in 0.42.2)
+    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=377208
+    (Closes: #377208) [submitted:myon]
+
+  * debian/control added a Conflicts: vim-sisu,
+    sisu-remote, to the existing Replaces: these
+    two packages have been removed
+  
+  * ruby, also tested ok with ruby1.9 (Debian Version: 1.9.0+20060609-1)
+    sisu -3v [filename]
+    [database tests omitted, relevant ruby drivers not on system]
+
+%% sisu_0.42.3.orig.tar.gz (2006w28/2 | 2006-07-11)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.42.3.orig.tar.gz
+  d3ab92e9f20ef48de711512d10fd3fe7 1230428 sisu_0.42.3.orig.tar.gz
+  33088e3d51a612cf73a64afe239eb8f5 609 sisu_0.42.3-1.dsc
+  28a4652fdade40b19ddb88df4344242f 99164 sisu_0.42.3-1.diff.gz
+
+  * html, segments, cosmetic, removal of footnote marker in headings
+
+  * sysenv, fix for when sisu sql related packages are not
+    installed, should not then be loading rb dbi module
+
+%% sisu_0.42.2.orig.tar.gz (2006w27/6 | 2006-07-08)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.42.2.orig.tar.gz
+  cf5b6605089179140da52f5bde655ebd 1229996 sisu_0.42.2.orig.tar.gz
+  081c37f65a4fbb5ed7d3a2ed1a02c423 609 sisu_0.42.2-1.dsc
+  19f7878a951fa966acb5ab3c5d38f6c8 99115 sisu_0.42.2-1.diff.gz
+
+  * html, xhtml, added utf-8 specification
+    <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
+    [(previously relied on correct browser setting]
+
+  * debian/control, removed sisu-remote, added recommends rsync,
+    openssh-client|lsh-client, keychain,  to main sisu package instead
+    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=377206
+    (Closes: #377206) [submitted:myon]
+
+  * debian/control, removed vim-sisu, this used to contain syntax highligter
+    and color scheme now included in Vim 7, all that remains is ftplugin, now
+    installed by main sisu package
+    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=377207
+    (Closes: #377207) [submitted:myon] [* change to source package structure]
+
+  * debian/control, sisu Replaces: vim-sisu
+    debian/sisu.install installs ftplugin originally in vim-sisu
+
+  * debian/manpages, sisu (main package) now installs vim_sisu page in man(7)
+    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=377209
+    (Closes: #377209) [submitted:myon]
+
+  * debian/control, package description related issues:
+    * modified sisu
+    * modified sisu-complete
+    * modified sisu-postgresql
+    * modified sisu-sqlite
+    * modified sisu-pdf
+    * removed sisu-remote, (as sisu-remote is no more)
+    * removed vim-sisu, (as vim-sisu is no more)
+    * removed sisu-remote, (as sisu-remote is no more)
+      [consider adding a note on remote placement of documents in sisu(8)
+      later]
+    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=377208
+    (verify that descriptions are satisfactory before closing: #377208)
+    [submitted:myon]
+
+%% sisu_0.42.1.orig.tar.gz (2006w27/4 | 2006-07-06)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.42.1.orig.tar.gz
+  7d6bcb9a4be5ded17e71522b37a2af5a 1227649 sisu_0.42.1.orig.tar.gz
+  734e48c69096c912cbd60f38b8961bd0 632 sisu_0.42.1-1.dsc
+  bb107345477000cc540fb08a73df4379 99097 sisu_0.42.1-1.diff.gz
+
+  * dbi fix (--createdb)
+
+  * [ruby1.9, forward testing, general check, (tests ok db operations apart,
+    drivers not installed)]
+
+  * debian/control, removed recommends libtidy [non-existent, see current
+    libtidy-0.99-0, called in by tidy which is recommended and sets libtidy
+    dependency]
+    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=377086
+    (Closes: #377086) [submitted:luk]
+
+%% sisu_0.42.0.orig.tar.gz (2006w27/4 | 2006-07-06)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.42.0.orig.tar.gz
+  297702e8c44b95f0ac16c656b798812d 1227287 sisu_0.42.0.orig.tar.gz
+  065d70ba326d517401f2b62fe5c837c4 632 sisu_0.42.0-2.dsc
+  0ad5a4471a31f4968a7b900a17c43ac7 99754 sisu_0.42.0-2.diff.gz
+  c3be264946486f71b021227a16197162 632 sisu_0.42.0-1.dsc
+  83577a37dbbe6915a25814a541263e54 98970 sisu_0.42.0-1.diff.gz
+
+  * texpdf fix, object citation numbering reinstated
+
+  * asterisk (and plus sign) footnote/endnote marker/tags
+    [SubTech2006::LII:TB "request": required for U.S. law articles]
+    done: html, odf, xmls, plaintext, 
+    latex pdf (some cosmetic changes to come)
+    digests(dcc)
+    sql (specific issue not addressed but works sortof)
+
+  * syntax, asterisk (and plus sign) footnote/endnote marker/tags 
+    introduced ~{* for an asterisk marked endnote }~ and plus sign equivalent
+    [reason for version number change, as previous
+    version won't parse]
+
+  * texpdf portrait text now all black, including toc and endnote markers 
+    landscape retains color for toc (red) & linked text (blue) [online viewing]
+    [introduce configuration options?]
+
+  * help updated
+
+  * kdissert conversion to sisu markup a refinement (with less-than &
+    greater-than)
+
+  ** debian/control changed back to ruby >= 1.8.2
+  * debian/control ruby >= 1.8.4
+    (not done sufficient testing on 1.8.2, so not supported)
+
+  * debian/control sisu-pdf added Depends: texlive-latex-extra
+    (needed for manyfoot.sty, used for asterisk footnotes)
+
+  * debian vim-sisu, description
+    http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=374873
+    (Closes: #374873) [submitted: Jens Seidel]
+
+%% sisu_0.41.8.orig.tar.gz (2006w25/6 | 2006-06-24)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.41.8.orig.tar.gz
+  ea76d18d8c58bb444f4be71c4e9a3185 1225229 sisu_0.41.8.orig.tar.gz
+  283d46cf2196e667e5416327a19659c5 632 sisu_0.41.8-1.dsc
+  1fe0b2f06aed3d3f8a272340dcabef9c 98810 sisu_0.41.8-1.diff.gz
+
+  * kdissert, texpdf, accept sisu page break and new page marker, used for 
+    LaTeX/pdf
+
+%% sisu_0.41.7.orig.tar.gz (2006w25/6 | 2006-06-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.41.7.orig.tar.gz
+  792ed0b0e57e78cf88ec37102fd3de8a 1225007 sisu_0.41.7.orig.tar.gz
+  77b90465be946edcdb57c31b8fc3cd10 632 sisu_0.41.7-1.dsc
+  0f568b819dd5b18a5637d77c220beaf5 98795 sisu_0.41.7-1.diff.gz
+
+  * document samples, created subdirectory dfsg for documents that comply
+    with the Debian Free Software Guidelines and moved the "GPL2" and
+    "Free as in Freedom" texts and associated images back into the source
+    tarball and main (from sisu-markup-samples) [FaiF is published under
+    the GNU Free Documentation License]
+
+  * html segments, footnotes for segments, bugfix, [faulty regex matched more
+    than it was supposed to resulting in dropping of some footnote sections -
+    these remained available elsewhere in the endnote segment]
+
+  * relaxng, sisu object models, first pass at XML object models for sisu input
+    structure, and sisu metaverse structure, alternative data representation
+
+  * kdissert:
+    * sisu headers, added a hack to permit the inclusion of sisu headers, by
+      entering them in the top level node (for which sisu will now only process
+      properly if empty or if it contains comments or sisu headers)
+    * texpdf, tell when documents are prepared using kdissert
+    * html default skin for kdissert with icon
+    * [kept out for now: kdissert sisu sample file, and its converted sisu text
+      equivalent]
+
+  * Debian control, 'Home page:' corrected to 'Homepage:'
+    closes Bug#374873: Improved package description
+
+  * Debian rules, .ssm and .ssi files added to list of not compressed file
+    types (/usr/share/doc/sisu)
+
+%% sisu_0.41.6.orig.tar.gz (2006w25/2 | 2006-06-20)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.41.6.orig.tar.gz
+  ff6217bb156f2ab803bf87367fb327e4 671142 sisu_0.41.6.orig.tar.gz
+  594e27b60ceb415bdd3504929a7adb0f 631 sisu_0.41.6-1.dsc
+  3ba8aecfd904844b40ef2a26a6379aec 98359 sisu_0.41.6-1.diff.gz
+
+  * sisu_manifest, added possibility of sharing of kdissert source, see sample:
+    http://www.jus.uio.no/sisu/kdissert.kdi/sisu_manifest
+    and note the kdissert source file on which sisu markup and outputs are based:
+    http://www.jus.uio.no/sisu/kdissert.kdi/kdissert.kdi
+  
+  * kdissert fixes to make the following true:
+
+    * sisu --convert=kdi [kdissert filename]
+      will attempt to convert a simple file produced using kdissert to sisu
+      markup, basic and experimental
+
+    * kdissert_to_sisu: some fixes, still very basic and experimental
+      [data/sisu/conf/convert or /usr/share/sisu/conf/convert]
+
+  * debian control, added recommends kdissert
+
+  * [issue spotted with rsync, new output directories, fix later]
+
+%% sisu_0.41.5.orig.tar.gz (2006w25/1 | 2006-06-19)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.41.5.orig.tar.gz
+  da50cd8f993761e8011386afcd8d2636 669069 sisu_0.41.5.orig.tar.gz
+  33e2fc91260a5131e60588729cbf0c67 631 sisu_0.41.5-1.dsc
+  d63fd861450216b66acf0295100c754d 98313 sisu_0.41.5-1.diff.gz
+  
+  * sisu --convert=kdi [kdissert filename]
+    will attempt to convert a simple file produced using kdissert to sisu
+    markup, basic and experimental
+
+  * kdissert_to_sisu: some fixes, still very basic and experimental
+    [data/sisu/conf/convert or /usr/share/sisu/conf/convert]
+
+  * param, minor fix to "prefix" metadata regex
+
+  * renamed a couple of libraries related to file conversion
+
+%% sisu_0.41.4.orig.tar.gz (2006w24/7 | 2006-06-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.41.4.orig.tar.gz
+  4182ed0cd4d32beaa71e53028fdd17c5 667716 sisu_0.41.4.orig.tar.gz
+  4d1c95b8e8734adfa72ed7ca3dca443d 631 sisu_0.41.4-1.dsc
+  210daf7fd979a41b1a34db3918a68dbc 98286 sisu_0.41.4-1.diff.gz
+
+  * kdissert_to_sisu: a very basic trial conversion script from kdissert .kdi
+    to sisu .sst markup provided [preliminary/proof of concept, provided in
+    data/sisu/conf/convert or /usr/share/sisu/conf/convert] (Kdissert, by
+    Thomas Nagy is a topic/mind mapping tool for the preparation of documents
+    http://freehackers.org/~tnagy/kdissert/ )
+
+%% sisu_0.41.3.orig.tar.gz (2006w24/3 | 2006-06-14)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.41.3.orig.tar.gz
+  fc5f119deefab7cab8c226d8724d4f99 666605 sisu_0.41.3.orig.tar.gz
+  a64f86b41186e6edc039c960a41c2e1b 631 sisu_0.41.3-2.dsc [2006-06-15]
+  e3bab2d070567bed6e0c72762beb594b 98885 sisu_0.41.3-2.diff.gz
+  55e612d16607e1a23dd2aa2d241a374f 631 sisu_0.41.3-1.dsc
+  36a386fb433eb17e7cfe195b09216d8c 98249 sisu_0.41.3-1.diff.gz
+
+  * options parsing changes, possibility of letter duplication
+    removed [-CC no longer will work use -C --init=site]
+
+  * texpdf_format, old code rearranged
+
+  * sysenv, fixes in File_map where @md (param) not available
+
+  * info related to share source file and sisudoc, bug fix
+
+%% sisu_0.41.2.orig.tar.gz (2006w23/5 | 2006-06-09)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.41.2.orig.tar.gz
+  e98068cf061df4f428b40cfee984f593 666123 sisu_0.41.2.orig.tar.gz
+  55896e6fd677475b3af56b19d20fc33a 631 sisu_0.41.2-1.dsc
+  d66cc73ca8fa3103a5de58903e99626c 98220 sisu_0.41.2-1.diff.gz
+
+  * search form, options passing, sisu -F --webserv=webrick
+
+  * html segments endnote fix for the deposit of endnotes occurring in levels
+    :A - :C
+
+  * texpdf, a4 text height re-fixed
+
+  * digest, document metadata, info re-fix
+
+  * plaintext, small fix, document metadata
+
+%% sisu_0.41.1.orig.tar.gz (2006w23/3 | 2006-06-07)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.41.1.orig.tar.gz
+  e8c3381acb10e678e167755181380091 665743 sisu_0.41.1.orig.tar.gz
+  116ee32633631a305307f59eef4f32e9 631 sisu_0.41.1-1.dsc
+  fef43880a4b0c0ce68ca269b19108216 98204 sisu_0.41.1-1.diff.gz
+
+  * defaults, html_format, some html cleaning (including fix of html comment
+    marker that was problem for dillo in doc.html) 
+
+  * html segments endnotes, fix for first segment, (endnotes were deposited in
+    first segment multiple times (or rather this happened in some segments
+    following a level :A - :C heading ))
+
+  * markup_convert, hub, changes, should now be possible to convert and
+    generate in a single changed rune, e.g.
+
+    sisu --convert=to38 -h autonomy_markup0.sst gpl2.fsf.sst
+
+%% sisu_0.41.0.orig.tar.gz (2006w22/6 | 2006-06-03)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.41.0.orig.tar.gz
+  b35ae1c9380d3ec94db8f97950e32a82 665634 sisu_0.41.0.orig.tar.gz
+  bd2e6542cd3dba16d0489155d1b4e7d5 631 sisu_0.41.0-1.dsc
+  e1d2948368753d4880c8ba9efcb2a651 98182 sisu_0.41.0-1.diff.gz
+
+  * options, (command line options) message passing (should become cleaner),
+    program piping changed, command line information added as 'opt',
+    (subsequently contained within param 'md'), creates considerable scope for
+    further tidying (cosmetic refactoring) [most code affected, preliminary
+    tests passed, (some possibility of bugs and breakage)]
+
+  * hub, param, hooks in place to permit modification of default processing
+    instructions set in config files or within document headers by way of
+    command line processing instruction starting with -- (however, only
+    implemented for latex/pdf paper size).
+
+  * hub command line now accepts individual command instructions, previously
+    was necessary to write, e.g.
+      sisu -mNhwpoabxXyv [filename/wildcard]
+        (sisu -3 [filename/wildcard] for short) now may alternatively write:
+      sisu -m -N -h -w -p -o -a -b -x -X -y -v [filename/wildcard]
+
+  * dbi command line rune now requires "--" before instruction,
+    --import, --update, --recreate, etc.
+    removed short forms for --import and --update (-i and -u)
+
+  * texp pdf, adjustments to document presentation dimensions
+    (A4, US_letter, book_b5, book_a5, US_legal)
+
+  * texpdf, command line parameter may be used to change paper size output
+    sisu -p --papersize='book' [filename]
+    preset sizes include: 'A4', U.S.  'letter' and 'legal' and 'book'  sizes 'A5'
+    and 'B5' (system defaults to A4).
+
+  * texpdf, image resizing for different paper sizes
+    (useful when offering on the fly alternative document dimension processing)
+    (manually calibrated to suit default document layouts) [note however other
+    blocks such as tables are not (yet) handled similarly]
+
+  * help (interactive help) now needs to be invoked with:
+    sisu --help [help query]
+    sisu on its own will still get you into an interactive help mode
+
+  * [consider permitting multiple document size pdf outputs, (easily done, but
+    promises slower processing as each additional size selected is generated)
+    currently you select your size and get a portrait and landscape, the
+    selection of whatever size over-writes the other, as they are saved to the
+    same file-name]
+
+%% sisu_0.40.4.orig.tar.gz (2006w21/7 | 2006-05-28)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.40.4.orig.tar.gz
+  4266b03409162c68322b054fda599134 664267 sisu_0.40.4.orig.tar.gz
+  009e41731e25ddfde8e685998432d795 631 sisu_0.40.4-1.dsc
+  4469b7acab1e00ac9b4fcdf5ae384edb 98011 sisu_0.40.4-1.diff.gz
+
+  * tex pdf, minor adjustments, including page-breaks restored for 0.38 markup
+
+  * package source directory renamed with underscore instead of hyphen
+
+%% sisu_0.40.3.orig.tar.gz (2006w21/3 | 2006-05-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.40.3.orig.tar.gz
+  f67f66e42617dd2c0cd8d28cfa95e217 663690 sisu_0.40.3.orig.tar.gz
+  2280c18cbb60c671a06e0b2dced435af 631 sisu_0.40.3-1.dsc
+  84cb50d042b87fc19e42b156a27480a4 97951 sisu_0.40.3-1.diff.gz
+
+  * metaverse, fix reference to dc_publisher in param (not publisher)
+
+  * rant installer checked, removed sisu-examples, and post install routine as
+    document samples are now packaged separately as sisu-markup-samples
+
+%% sisu_0.40.2.orig.tar.gz (2006w21/3 | 2006-05-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.40.2.orig.tar.gz
+  e792de16cb6acbe2cabe3c650eef47ce 665085 sisu_0.40.2.orig.tar.gz
+  76c87061052e430d8d8ac0cfad4a2168 631 sisu_0.40.2-1.dsc
+  eee774779cb3a15cb164c032de5ae4cc 97904 sisu_0.40.2-1.diff.gz
+
+  * babel, more use of translation module, used in metaverse (originally used
+    for manifest) [expand]
+
+  * correction to apt sources.list information provided in this document for
+    0.40.1, and updated in README
+
+%% sisu_0.40.1.orig.tar.gz (2006w21/1 | 2006-05-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.40.1.orig.tar.gz
+  86b2c25a8bccb0ecb38f0e1fe11aa522 664295 sisu_0.40.1.orig.tar.gz
+  3a2a198b18847ebf6ccf30278848e354 631 sisu_0.40.1-1.dsc
+  85d6478dd001f19f7e3d126a47d85aea 97880 sisu_0.40.1-1.diff.gz
+
+  * debian archive sources.list changed, started using reprepro to produce
+    apt archive, debian "upstream" /etc/apt/sources.list changes to:
+
+      deb http://www.jus.uio.no/sisu/archive unstable main non-free
+      deb-src http://www.jus.uio.no/sisu/archive unstable main non-free
+
+    [archive string corrected]
+
+    [previous string (obsolete for future releases) was:
+      deb http://www.jus.uio.no/sisu/pkg_priv ./deb/
+      deb-src http://www.jus.uio.no/sisu/pkg_priv ./src/
+    ]
+
+%% sisu_0.40.0.orig.tar.gz (2006w20/7 | 2006-05-21)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.40.0.orig.tar.gz
+  cfaa83c0f7a55a143b50865d72338442 663916 sisu_0.40.0.orig.tar.gz
+  5d0801b203e3d76f46b676676226d537 631 sisu_0.40.0-1.dsc
+  68e6d68b871920b372a20ca8ba479b55 97850 sisu_0.40.0-1.diff.gz
+
+  * translate, an internal framework for the translation of related text used
+    first for the document manifest. (it is suggested that i look at gettext)
+    some initial translation by daniel (german), nicholas (french), agi
+    (spanish), enrico (italian), hanna (finnish)
+
+  * param, metaverse fix, 0.38 markup syntax to work with processing
+    instructions related to levels and their translation from :A,:B,:C,1,2,3 to
+    internal representation 1,2,3,4,5,6
+
+  * debian package sisu-examples removed, debian packaging policy requires
+    removal of un-modifiable documents from the main archive. accordingly the
+    books provided as markup samples have been moved from the main sisu package
+    to sisu-markup-samples (which should eventually make its way to the debian
+    non-free archive). Considerable changes in packaging required, and new
+    version number appropriate.
+
+  * [mention of use of reprepro in this release was premature, see sisu-0.40.1]
+
+%% sisu_0.39.3.orig.tar.gz (2006w19/7 | 2006-05-14)       [Debian Release snapshot, uploaded by Wookey (at Debconf 6, in Queue new till replaced)]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.39.3.orig.tar.gz
+  6eadfbf37cbaf43fbae49dc2b71209d2 3406768 sisu_0.39.3.orig.tar.gz
+  cfca428562370b9b2672fc8f7f0b7840 647 sisu_0.39.3-1.dsc
+  8338ef32ecb203bf0328f7f4eb71857a 95295 sisu_0.39.3-1.diff.gz
+
+  * metaverse fix, changed rules on auto-naming of html segments resulted in
+    the introduction of some undesirable artifacts, (actually a change in
+    sequence, some risk of need for further modification)
+
+%% sisu_0.39.2.orig.tar.gz (2006w19/5 | 2006-05-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.39.2.orig.tar.gz
+  e80aae7a5733dbbee6545cb7ff0f9633 3406402 sisu_0.39.2.orig.tar.gz
+  adde80ce35b3258feb199a65ccb5be88 647 sisu_0.39.2-1.dsc
+  f8ffdfb51016cae9f150e95b7d92f177 95226 sisu_0.39.2-1.diff.gz
+  23a45dde920e1c0cab53231eb90865c0 647 sisu_0.39.2-2.dsc
+  18f49697c0634fc87edccdfd6f4ba9ce 95835 sisu_0.39.2-2.diff.gz
+
+  * what to do when missing required: header title; heading top;
+    heading seg. carries risk, false positives not acceptable, testing
+    required, may need to scrap
+
+  * debian policy standards version 3.7.2
+    debian vim policy changes, rename sisu_vim vim_sisu
+    vim 7 in debian includes filetypes, syntax, and color, removed
+    vim-sisu includes ftplugin
+
+%% sisu_0.39.1.orig.tar.gz (2006w19/1 | 2006-05-08)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.39.1.orig.tar.gz
+  bb72b981ace449a4803aaad879398266 3405744 sisu_0.39.1.orig.tar.gz
+  acc111aae4ebf5485e3ae4740ebeab52 647 sisu_0.39.1-1.dsc
+  9094b6e51890fbeb2789365add613143 95128 sisu_0.39.1-1.diff.gz
+
+  * digest/dcc (document content certificate), fix: image digests reinstated
+    [note: during some simplification of code, removed the need to flag images
+    as local or remote, some regexes did not take into account this change, one
+    in metaverse also addressed, (issue likely from 0.38.8 till this fix)]
+
+%% sisu_0.39.0.orig.tar.gz (2006w19/1 | 2006-05-08)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.39.0.orig.tar.gz
+  3c043d2f1356527686a72cd82858d7be 3405229 sisu_0.39.0.orig.tar.gz
+  e1d17b525cf81dceefbb0c81d27aca76 647 sisu_0.39.0-1.dsc
+  3657f7538d1cbd23c8b40d3e32862afd 95097 sisu_0.39.0-1.diff.gz
+
+  * metaverse, changes to auto-naming/numbering of headings, and segment names
+    [back to the more elegant auto-naming of segments solution, however, need
+    to determined to be reliable (naming used to be done in a similar way)
+    release passes initial checks though further testing is required; changes
+    involve reducing the use of extra characters where possible in the
+    auto-naming of html segments (the tilde and underscore were added to reduce
+    the chance of name collision, and have now been removed where possible),
+    additional checks that duplication does not occur have been added. This
+    does mean any existing indexes (sql or hyperestraier) will have to be
+    regenerated and url mappings/ links made within a sisu markup file to other
+    sisu output of html segments will need to be checked and updated. Long term
+    the currently implemented naming should provide a preferable solution
+    (primarily in its being easier on the eye.)
+
+  * odf, odd regex related bug related to matching of + sign in link text and
+    corresponding urls fix not particularly satisfactory
+
+  * debian policy standards-version back 3.7.0 ... (should be 3.7.2 but
+    lintian and linda not up to date this instant)
+
+%% sisu_0.38.10.orig.tar.gz (2006w18/5 | 2006-05-05)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.10.orig.tar.gz
+3bc28f808280673e2f8b86dfe071a53a 3402660 sisu_0.38.10.orig.tar.gz
+6c930e4ea4e3b41388bb61c9b6aad7ac 650 sisu_0.38.10-2.dsc
+43717b69a0bf29cbd810a0c36066fb2e 95761 sisu_0.38.10-2.diff.gz
+
+  * rebuilt using debian standards version 3.7.2 
+    (previous build used 3.7.0)
+
+%% sisu_0.38.10.orig.tar.gz (2006w18/4 | 2006-05-04)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.10.orig.tar.gz
+3bc28f808280673e2f8b86dfe071a53a 3402660 sisu_0.38.10.orig.tar.gz
+26c4ae2cca2e1b22e826834fcd4c135b 650 sisu_0.38.10-1.dsc
+2e17298545f1afb64d6258fb7f732be8 94904 sisu_0.38.10-1.diff.gz
+
+  * minor fixes, need resulting from default removal of ._sst temporary files
+    (master documents:processed composite documents:temporary files)
+
+    process .ssm master file instead where possible, e.g. -R (and url info),
+    (implemented in hub)
+
+    _ flag provided as hack to have ._sst files kept at the end of a run, (as
+    an alternative to use of the -M (maintenance) flag (which changes screen
+    output))
+
+  * vim ftplugin, minor irritation with vim folds sorted
+
+%% sisu_0.38.9.orig.tar.gz (2006w18/3 | 2006-05-03)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.9.orig.tar.gz
+f513d112435ff923e5197a5f5875c58a 3402148 sisu_0.38.9.orig.tar.gz
+317ff04be060a534cc9ddaf356ebbe79 647 sisu_0.38.9-1.dsc
+1b389daf0e1f52c6c1cc88bb48aaba0c 94879 sisu_0.38.9-1.diff.gz
+
+  * sisupod/ sisu_doc, .ssm, renamed sisupod.tgz. Master document pod now
+    contains the composite elements of the master, .ssm and .ssi files rather
+    than the "composited document" ._sst, examine for example:
+    http://www.jus.uio.no/sisu/alices_adventures_in_wonderland_and_through_the_looking_glass.lewis_carroll/sisupod.tgz
+    [consider giving the option as this may not always be preferred, is
+    necessary to find master within pod, but otherwise seems a more elegant
+    solution]
+
+  * search, debian:sisu "recommends" added hyperestraier
+    [option in addition to sisu "atomic" search with postgresql and sqlite]
+    
+    some help on setting hyperestraier up (in very basic way) for sisu
+    provided: sisu help hyperestraier
+
+    documentation for hyperestraier: http://hyperestraier.sourceforge.net/
+    file:///usr/share/doc/hyperestraier/index.html man estcmd
+
+    for help on sisu search generally follow suggestions in: sisu help search
+
+  * vim filetypes fix, the temporary ._sst rather than ._ssi
+   
+  * temporary files ._sst are now removed after run, unless -M (maintenance)
+    flag is used
+
+  * rexml fix necessary
+
+  * help prompt fix
+
+  * fix, 0.38 markup interpretation, evident particularly in XML Dom variant
+    -X of a few documents, more strict regex
+
+  * removed reference to 0.38 markup as experimental in help and man page
+    (conversion script makes it easy to switch between markup versions)
+
+  * debian 'Standards' version changed to 3.7.0
+
+NOTE DISCARDED BUILD -{6d2149ba45d601347d9562edc2995fe7 3401901
+sisu_0.38.9.orig.tar.gz}- -{b96ce1d8b5801c1e2ffa12eddbb1850a 647
+sisu_0.38.9-1.dsc}- -{ee7182ffdca58bd94dec3d07d4ccb9f8 94874
+sisu_0.38.9-1.diff.gz}-
+
+%% sisu_0.38.8.orig.tar.gz (2006w17/6 | 2006-04-29)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.8.orig.tar.gz
+9c1df6c4524fa3a047ca566b779f6600 3398443 sisu_0.38.8.orig.tar.gz
+7514ebf71f95c0d3dd99d2355ad65fc0 647 sisu_0.38.8-1.dsc
+63ae62d331f23a5f79819656e345ef8f 94794 sisu_0.38.8-1.diff.gz
+
+  * images, in particular to do with remote sisu markup source
+    e.g.  sisu -3
+    http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst
+    sisu -3
+    http://www.jus.uio.no/sisu/sphinx_or_robot.leena_krohn.1996/sphinx_or_robot.leena_krohn.1996.sst
+    should once again pull down and generate documents with images (consider
+    using url base plus directory, to make unique image directories for
+    external documents images)
+
+  * vim:sisu syntax, spell
+    [Re: use of Vim, have made the transition to Vim 7]
+
+  * (html_tune, some renaming which could cause breaks)
+
+%% sisu_0.38.7.orig.tar.gz (2006w17/4 | 2006-04-27)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.7.orig.tar.gz
+39bf0e31035f4a97259e2b077835b7bc 3397454 sisu_0.38.7.orig.tar.gz
+b37cba6a7ef7436dc9b4f95648d12a0d 647 sisu_0.38.7-1.dsc
+75aa4afefc0bf8867de5498c6b9642fe 94763 sisu_0.38.7-1.diff.gz
+
+  * sisu, code rearrangement, relatively minor, /usr/bin contains require only
+
+  * vim:sisu ftplugin, only activate :setlocal spell spelllang
+    if version >= 700
+
+  * html, link to concordance only if < build concordance word count limit
+
+  * (html, sub_toc fix for pg texts)
+
+%% sisu_0.38.6.orig.tar.gz (2006w17/2 | 2006-04-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.6.orig.tar.gz
+d01345fe0748ea24af2e206648be1df0 3397003 sisu_0.38.6.orig.tar.gz
+a3819708b447aa1391c923847bc5f868 647 sisu_0.38.6-1.dsc
+fa4f965f92835dccbdcadfbabc29528e 94717 sisu_0.38.6-1.diff.gz
+
+  * a glance forward at ruby 1.9, some early tests passed
+    [ruby 1.9.0 (2006-04-21)]
+
+  * vim:sisu
+    syntax: Spell on vim 7, not quite right colors: slate, vim colors, toned
+    down, endnotes (green changed to "darkkhaki")
+
+  * concordance, wordmaps renamed
+
+%% sisu_0.38.5.orig.tar.gz (2006w16/7 | 2006-04-23)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.5.orig.tar.gz
+b9eae129c6a86c89398a3af5170a22a8 3396296 sisu_0.38.5.orig.tar.gz
+8a559bc917ef9bb082c46949cc77ac53 647 sisu_0.38.5-1.dsc
+2f4ea49bd593d5557b9043b354335181 94686 sisu_0.38.5-1.diff.gz
+
+  * primarily a new debian build as lintian 1.23.17 "published" 
+    yesterday, complains about existing builds
+
+  * vim ftplugin, folds, another minor modification
+    [without which would have been built as 0.38.4-2]
+
+%% sisu_0.38.4.orig.tar.gz (2006w16/5 | 2006-04-21)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.4.orig.tar.gz
+84d5e911d17aaf6a360972acd5bb3a3f 3395161 sisu_0.38.4.orig.tar.gz
+60aa30b124edcd87a622f2a895f3c1a5 647 sisu_0.38.4-1.dsc
+7aeae2641bf9b3968a08bb8fb9eeb8e2 94665 sisu_0.38.4-1.diff.gz
+
+  * param, fix, correction to a condition for setting markup type to 'rad'
+    (0.38)
+
+  * param introduced header @clatalogue: (documented in man)
+
+  * markup_convert and param, a refinement to matching :A type headings
+
+  * vim ftplugin, folds, minor modification
+
+%% sisu_0.38.3.orig.tar.gz (2006w16/4 | 2006-04-20)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.3.orig.tar.gz
+aacb2696144a0d91da658266bff34010 3394702 sisu_0.38.3.orig.tar.gz
+85ad80241d8be30c15af31979d4ed69e 647 sisu_0.38.3-1.dsc
+8e3044976461dce97d78601f0f073c0a 94622 sisu_0.38.3-1.diff.gz
+
+  * convert, refinement in 0.37 to 0.38 and back, required.
+
+  * sample documents, header 'markup' not very descriptive, 'level' preferred,
+    but not ideal either..., changed though accordingly
+
+%% sisu_0.38.2.orig.tar.gz (2006w16/3 | 2006-04-19)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.2.orig.tar.gz
+b7183828d8debf7dfeb671c44fcf984d 3394425 sisu_0.38.2.orig.tar.gz
+6e4c33da7880dede7de035f53003388e 647 sisu_0.38.2-1.dsc
+1df895d8457cf0e2a90c70536c65a5c9 94598 sisu_0.38.2-1.diff.gz
+
+  * --identify ; --convert ; --query ; minor adjustments
+
+%% sisu_0.38.1.orig.tar.gz (2006w16/1 | 2006-04-17)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.1.orig.tar.gz
+6d6a57fb0671c0740abdd75389c8255e 3393572 sisu_0.38.1.orig.tar.gz
+db731e962a0e6553602a978addc49933 647 sisu_0.38.1-1.dsc
+7601b42bb90e739bdac0c65e4a46d753 94579 sisu_0.38.1-1.diff.gz
+
+  * sisu --convert [filename/wildcard] converts between 0.38 and 0.37 markup
+   (which is substantially the same as 0.16 markup, only the file names
+   changed)  
+
+  * sisu --identify [filename/wildcard] attempts to recognises the markup
+    version  
+
+  * sisu --query [version number| or history] provides a bit of information
+    on changes to markup and file naming conventions used
+
+  * urls, minor fix, 
+    (screen output of generated output omitted -H, (-h was ok))
+
+  * generated cgi search form needs a writable present directory,
+    warning of failure posted if it is not (consider placing result elsewhere)
+
+  * vim syntax minor touch
+
+%% sisu_0.38.0.orig.tar.gz (2006w15/7 | 2006-04-16)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.38.0.orig.tar.gz
+ed0af7fd0c4b05301642422bd95647cc 3388111 sisu_0.38.0.orig.tar.gz
+e8611c3610409c083c92d76da8c8ef6d 647 sisu_0.38.0-1.dsc
+5b9872b1b278bf8697d76350038bc47b 94504 sisu_0.38.0-1.diff.gz
+
+  Summary: there is some scope for breakage. preliminary tests passed new
+  markup introduced, as alternative, existing markup is not affected - new
+  document header markup, new document structure markup, experimental, [new
+  header for tagging categories or topics, stub]
+      
+    a script modify.rb is provided for easy conversion between 0.37 standard
+    and 0.38 experimental markup
+
+  * alternative header notation, for consideration, an example
+      @title: is equivalent to 0~title
+
+  * sisu structure, experimental alternative notation,
+    A,B,C,1,2,3 mapping to 1,2,3,4,5,6 switched on on encountering level A~ or
+    if document header should contains @markup: rad
+    * SiSU has in effect two sets of levels to be considered 
+    1-3 headings/levels, pre-ordinary paragraphs /pre-substantive text, and 4-6
+    headings/levels, levels which are followed by ordinary text.  This may be
+    conceptualised as levels A,B,C, 1,2,3, and using such letter number
+    notation, in effect: A must exist, optional B and C may follow in sequence
+    (not strict) 1 must exist, optional 2 and 3 may follow in sequence i.e.
+    there are two independent heading level sequences A,B,C and 1,2,3 or using
+    the standard notation 1,2,3 and 4,5,6 on the positive side:
+      * the A,B,C,1,2,3 alternative makes explicit an aspect of structuring
+        documents in SiSU that is not otherwise obvious to the newcomer (though
+        it appears more complicated, is more in your face and likely to be
+        understood fairly quickly)
+      * the substantive text follows levels 1,2,3 and it is 'nice' to do
+        most work in those levels a couple of issues to consider:
+      * 1,2,3 usually precede A,B,C (and do for generated output), 
+        but in the form is better suited to this context, it takes some getting
+        used to though, and may be necessary to add a marker (an optional
+        exclamation mark (!) or colon (:) perhaps) to the A,B,C to indicate
+        that they are not subsidiary values, and are 'greater' than 1,2,3.
+        :A,:B,:C,1,2,3 colon selected as aesthetically more pleasing (to me)
+        (despite exclamation mark already being in use for bold lines/headings)
+      * there ends up being more in marking up to know, (which needs to be 
+        balanced against any perceived convenience) unless ultimately only one
+        markup structure style is adopted
+      * ok within code may confuse a bit, as things simple are not always what
+        you would expect, present solution is to translate rad markup values to
+        standard ones, so A,B,C,1,2,3 and references to them become 1,2,3,4,5,6
+        (where you expect to find 1 you may find a 4)
+    * a note on implementation of 0.38 experimental (rad), within the program
+      structural markup is converted back to the the standard notation, i.e.
+      levels A,B,C,1,2,3 are re-mapped to 1,2,3,4,5,6 which is used for
+      processing
+
+  * param, header, 0~tag or to use newer notation @tag: introduced, 
+    a stub for topic lists, categories, classification within documents.
+    Formal only in the sense that to make work you need to be aware of previous
+    categories, a degree of organisation is necessary.  Raises technical
+    questions in relation to method and notation used for SiSU structuring.
+    Mapping may be fairly simple for an independent system, however, it is a
+    bit more complex to directly map to SiSU structure as SiSU has in effect
+    two sets of levels to be considered A technically simple but inconvenient
+    solution for making SiSU pages out of tags would be to have them between 4
+    and 6 levels deep, four levels is however from a practical tagging
+    perspective (a bit arbitrary and) an inconvenient minimum depth to require
+    it also also could be inconvenient for other technical purposes
+    
+  * sysenv, utf-8 assumed if file encoding cannot be determined, 'fix' results
+    from an unexpected issue with the use of alternative document header markup
+    introduced in 0.38 (@title:) the program 'file' used to check document type
+    no longer parses the markup document and recognises it as utf-8 unless the
+    document starts with a sisu comment line %2
+
+  * an auto-converter, with canned conversion from 0.37/traditional to 0.38
+    (rad) markup and back from 0.38 (rad) to 0.37/traditional is tossed in to
+    sisu-examples (permissions at 644) sisu-examples/config/convert/modify.rb
+    once enabled (permissions and path set), usage: modify.rb --convert
+    [filename/wildcard] for further options and generally a better place to
+    begin: modify.rb --help this is a fairly generic simple tool that can be
+    used to store other canned conversions
+
+  * an auto-converter with canned conversion 
+      from 0.37/traditional to 0.38 (rad) markup and back from 0.38 (rad) to
+      0.37/traditional is tossed in to sisu-examples (permissions at 644)
+      sisu-examples/config/convert/modify.rb
+
+  * refactor, minor, moved some dublin core checking, affects
+    plaintext, html, xhtml, xml, odf ...
+
+  * db, create added as synonym for createall
+
+  * sqlite, common_db, create command makes directory for output if it
+    does not already exist
+
+  * header @structure: added as a synonym for @toc: it is used to build
+    the table of contents, but probably more usefully thought of and described
+    as the document structure header
+
+  * sisu help, some additions and a fix
+    sisu help env, 'issues' reporting when machine offline
+
+  * vim syntax highlighting file (sisu-0.38),
+    ftplugin more vimrc type defaults review, and colors minor
+
+0.37 introduces NEW FILE-NAME EXTENSIONS rename 's/\.s[123]$/\.sst/' *.s{1,2,3}
+rename 's/\.r[123]$/\.ssm/' *.r{1,2,3} rename 's/\.si$/\.ssi/' *.si
+    
+%% sisu_0.37.12.orig.tar.gz (2006w14/7 | 2006-04-09)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.12.orig.tar.gz
+cf6d1cc419522f353e8b3e1f0c01afa6 3351564 sisu_0.37.12.orig.tar.gz
+31f19920cceee8a8212c12ba5eb62ffe 650 sisu_0.37.12-1.dsc
+73693cb634ddae10ebef21ddeffb0c26 93059 sisu_0.37.12-1.diff.gz
+
+  * vim syntax highlighting file, further testing
+
+%% sisu_0.37.11.orig.tar.gz (2006w14/7 | 2006-04-09)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.11.orig.tar.gz
+7004d8060065f8c4f6108a7d8ba3b825 3350939 sisu_0.37.11.orig.tar.gz
+e8ff904f31207140cbc35802c710b3ee 650 sisu_0.37.11-1.dsc
+73a9275c43abfbee672d15b60262eb1c 93046 sisu_0.37.11-1.diff.gz
+
+  * vim related files, cleaning
+    (filetype.vim, syntax/sisu.vim ftplugin/sisu.vim & colors/slate.vim)
+    syntax/sisu.vim minor refinements; colors/slate.vim has become a bit of a
+    christmas tree, pretty far from what it started out as, will probably tone
+    it down again, (it works only on dark backgrounds)
+ 
+  * help, 'environment' information, minor addition, 
+    (and sysenv remote host rescue so works when machine is offline): 'sisu
+    help env'
+
+%% sisu_0.37.10.orig.tar.gz (2006w14/4 | 2006-04-06)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.10.orig.tar.gz
+416094f2d0e04e1a5c38df6a321712e3 3350639 sisu_0.37.10.orig.tar.gz
+d7f836eec596a99db9bcbd8a21ebb885 650 sisu_0.37.10-1.dsc
+a70a47001d321c3429eee72b0e0e7ea6 93016 sisu_0.37.10-1.diff.gz
+
+  * vim related files, cleaning
+    (filetype.vim, syntax/sisu.vim ftplugin/sisu.vim & colors/slate.vim)
+
+%% sisu_0.37.9.orig.tar.gz (2006w13/6 | 2006-04-01)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.9.orig.tar.gz
+4d546c58a828821baf2463a8fa75d3d9 3350076 sisu_0.37.9.orig.tar.gz
+886fd0492b54340111fead7edb20b250 649 sisu_0.37.9-1.dsc
+d080e93446a7304e6fa699ffaec8cd80 92985 sisu_0.37.9-1.diff.gz
+
+  * vim related files, cleaning
+    (filetype.vim, syntax/sisu.vim ftplugin/sisu.vim & colors/slate.vim)
+
+  * db common, fix for table representation
+
+%% sisu_0.37.8.orig.tar.gz (2006w12/6 | 2006-03-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.8.orig.tar.gz
+60a8f59bb38a43f6de2018a0ce150a60 3353064 sisu_0.37.8.orig.tar.gz
+4782c9516557f93bf8aedea985068e14 649 sisu_0.37.8-1.dsc
+b667a88206342970a051734073f7b791 92945 sisu_0.37.8-1.diff.gz
+
+  * screen text ansi color turned off by default, (color does not suit all
+    terms/consoles)
+    * to turn color on by default, edit sisurc.yaml in (found in ./_sisu
+    * ~/.sisu
+      or /etc/sisu) set flag: color: true
+    * to toggle screen color (on/off) use the -c flag
+
+  * processing path where markup directory is not writable [and no other
+  * default
+    has been set] is now /tmp/_sisu_processing/$USER (instead of
+    /tmp/_sisu_processing) [if document markup directory is writable, it
+    remains ./_sisu_processing, unless a different processing path is set in
+    active sisurc.yaml] e.g. of a non-writable document markup directory:
+    /usr/share/sisu-examples/sample/document_samples_sisu_markup
+
+  * processing path when /tmp/_sisu_processing/$USER is used, clean of content
+    after use (as is in public area on a multi-user system) unless maintenance
+    flag (-M) is used
+
+  * sisurc.yaml, removed processing directory entry, rely on sysenv default
+    (can still change default in sisurc.yaml)
+
+  * help, added a bit of 'environment' information, [expand further as needed]
+      sisu --help env
+
+%% sisu_0.37.7.orig.tar.gz (2006w12/4 | 2006-03-23)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.7.orig.tar.gz
+246a94c92f19e0640f6b5cf368ec6bd1 3351292 sisu_0.37.7.orig.tar.gz
+eefac162286ca49563b20692536a6092 649 sisu_0.37.7-1.dsc
+6794d8e1f5593fae1c920e301fd59fd7 92902 sisu_0.37.7-1.diff.gz
+
+  * common_db, fix affecting pgsql for endnotes in heading levels 1-3
+    [relational db catch-up with footnote fix in 0.36.24]
+
+%% sisu_0.37.6.orig.tar.gz (2006w12/4 | 2006-03-23)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.6.orig.tar.gz
+f0623474f1635d87f0d5674e0d3ae927 3351023 sisu_0.37.6.orig.tar.gz
+c546a82203c685fe59be60ab5492fa96 649 sisu_0.37.6-1.dsc
+699b594457459248a22e2ed97e56c4f5 92886 sisu_0.37.6-1.diff.gz
+
+  * sisu control, minor cleaning
+
+  * gedit/gobby syntax highlighting, very basic start, in:
+    sisu-examples/config/syntax_hi
+
+%% sisu_0.37.5.orig.tar.gz (2006w12/3 | 2006-03-22)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.5.orig.tar.gz
+9a03bbcea82c1625bad4a92d6498e408 3351422 sisu_0.37.5.orig.tar.gz
+46dca71f33c206dbff9b798f75733484 649 sisu_0.37.5-1.dsc
+d3c5ed96ca85254870e2500d2e3957a2 92863 sisu_0.37.5-1.diff.gz
+
+  * metaverse, digest: sha256 offered as alternative to md5
+    (configure in sisurc.yaml, md5 should be sufficient for most purposes and
+    remains default)
+
+  * metaverse, auto bold markup fix
+
+  * some code shuffling and method and variable renaming
+    (including in sisu control file)
+
+  * wmap, sorting of matches (object citation numbers)
+  
+  * wmap, words capitalised unless several letters uppercase or is a phrase
+   (rather than a single word)
+
+  * wmap, names/id associated to phrases, space replaced with underscore
+
+  * html, heading tag names #h dropped if heading starts with alphabet so e.g.:
+    #h1.2 but #linux [consider #h_linux]
+
+%% sisu_0.37.4.orig.tar.gz (2006w10/4 | 2006-03-09)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.4.orig.tar.gz
+22970c76bd545a4852076b958f288d0b 3350498 sisu_0.37.4.orig.tar.gz
+4add721933eaf0b4418e28b61937c837 647 sisu_0.37.4-1.dsc
+cd31e7f43b70bc8bbff7a53f8b96a540 92832 sisu_0.37.4-1.diff.gz
+
+  * w3c compliance in html for: default homepage, document manifest, and
+    wordmap, (and check that renders properly in lynx, elinks, links2, w3m,
+    dillo as well as the rest)
+
+%% sisu_0.37.3.orig.tar.gz (2006w10/4 | 2006-03-09)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.3.orig.tar.gz
+a2f28400c4e741991cbca6c1239003a1 3350055 sisu_0.37.3.orig.tar.gz
+cce7e960ead1ff0fdc2fb4903cdefcd7 647 sisu_0.37.3-1.dsc
+acbada001ba115b5ac1c2f476a5b6d97 92809 sisu_0.37.3-1.diff.gz
+
+  * default home page, make sure that html is w3c compliant, (and renders in
+    lynx, elinks, links2, w3m, dillo as well as the rest)
+
+  * editors (other than vim already done) filetypes match new filenames
+
+%% sisu_0.37.2.orig.tar.gz (2006w10/2 | 2006-03-07)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.2.orig.tar.gz
+422703f270dd8a0df5ea6de38097708b 3356778 sisu_0.37.2.orig.tar.gz
+3669c92aa335a335f0e51a4566747862 647 sisu_0.37.2-1.dsc
+db86dcd03b1ca8c3b730331ba1df62b8 92772 sisu_0.37.2-1.diff.gz
+
+  * filename extensions, reduce in number and rename processed
+    secondary/temporary files to make matching of editable files trivial *.ss?
+    (editable files .sst .ssm .ssi matched with *.ss? or more precisely
+    *.ss[tmi])
+
+  * .sst (sisu structured text). .ssf removed, reason this is processed as
+    being the same file as .sst and increases the possibility of confusion for
+    the user.  .ssm (sisu structured master) .ssc removed for same reason as
+    removal of .ssf described above. .ssm files may include .sst and/or .ssi
+    files within them.
+
+  * filename extensions, processed secondary/temporary files 
+      ._sst was .sss and previously .t (substantive content of composite/master
+      file) .-sst was .ssu and previously .u (sisu markup .sst downloaded as
+      url for processing) reason for choice, identifies as .sst files and are
+      processed as such, while easily ignored/excluded on the command line for
+      editing and processing. These can be ignored by the user, but should be
+      processable by sisu as .sst files.
+
+  * .ssd (sisu structured document) is retained, for use in sisudoc, 
+    or sisupod, where a zipped file with image and other content necessary to
+    reproduce the original is made.
+
+  * .ssi (sisu structured insert/information) unprocessed, sisu markup text, 
+    for use in master documents, is likewise unchanged
+
+  * filetypes.vim made to match (filename extensions)
+
+%% sisu_0.37.1.orig.tar.gz (2006w10/1 | 2006-03-06)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.1.orig.tar.gz
+50064bf4ca448ca512f0867342bda977 3355756 sisu_0.37.1.orig.tar.gz
+47cf73b44e96185a59eaf963ae832cf2 647 sisu_0.37.1-1.dsc
+89a542fc1f5eb054ad6f701e368d2829 92500 sisu_0.37.1-1.diff.gz
+
+  * cgi search forms in sisu-examples, updated to match filename extensions
+   [and to match 'sisu-F webrick' equivalent]
+
+%% sisu_0.37.0.orig.tar.gz (2006w09/7 | 2006-03-05)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.37.0.orig.tar.gz
+24760db51b627f553d57e6b8126a37b5 3355565 sisu_0.37.0.orig.tar.gz
+4cfb6fac0ac6179f1140389c38ef943b 647 sisu_0.37.0-1.dsc
+8ca3ac75f71e776aeffa9727adb6e185 92371 sisu_0.37.0-1.diff.gz
+
+  WARNING: FILE RENAMING NECESSARY as file name extensions have been changed,
+  (there is scope for program breakage as a result, though preliminary tests
+  have been passed).
+  
+  Also note that, SiSU markup syntax is unchanged.  Repeat: there is NO CHANGE
+  to SiSU markup syntax.  Renaming of file-extensions should be all that is
+  necessary for things to work as before.
+
+  File extension name changes, note this does not affect SiSU markup in any
+  way... but the .s1 .s2 .s3 and like types are discontinued, files should be
+  renamed as explained below
+
+  NEW FILE EXTENSIONS the obvious sd and sdf appear to be taken, and there is
+  some use of .st and .sm extensions, so will use .ss extensions, which from an
+  examination of vim filetype.vim and mime.types appear to be available.
+
+  * sst (.ssf) ('sisu structured text')
+      .sst == .s3 (also .s1 and .s2) .ssf == .s3 (also .s1 and .s2)
+      
+      rename 's/\.s[123]$/\.sst/' *.s{1,2,3}
+
+  * ssm & ssc
+    ('sisu structured master' and 'sisu structured composite') .ssm == .r3
+    (also .r1 and .r2) .ssc == .r3 (also .r1 and .r2) [r was for require]
+      
+      rename 's/\.r[123]$/\.ssc/' *.r{1,2,3}
+
+      suggested convention: use ssm where the master contains only requests for
+      parts; use ssc where the composite document contains its own text but
+      requests inserts. they are in fact (technically) interchangeable, not
+      being recognised as distinct by sisu.
+
+  * ssi
+    ('sisu structured insert/information') (this is an unprocessed recognised
+    as being in sisu markup but only used as part of a composite document .ssm
+    or .ssc)
+    
+    ssi == si
+      
+    rename 's/\.si$/\.ssi/' *.si
+    
+  * ssd
+    ('sisu structured document') [filename].ssd should be mapped to sisudoc.tgz
+
+  THE FOLLOWING OCCUR IN PROCESSING they should be taken care of automatically
+  on use of sisu
+
+  * sss
+    secondary file .sss == .t3 [t was for tmp]
+    
+  * ssu
+    downloaded url .ssu == .u3 [u was for url]
+
+  * sst_meta
+    human readable processing file (metaverse)
+
+    .sst_meta == .s3.meta
+    
+  * sst_meta.rbm
+    ruby marshal processing file (metaverse)
+    
+    .sst_meta.rbm == .marshalMeta
+
+  OTHER CHANGES
+
+  * sample markup documents file type extensions changed to .sst from
+    .s3
+
+  * sisu, provide warning and advice on renaming when requests are made to
+  * process files with old filename extensions.
+
+  * xml(s) and xhtml, escape greater than and less than in "code" mode.
+
+  * cgi search form, postgresql, fix - create canned url etc., in line with
+  * what sqlite form does
+
+%% sisu_0.36.25.orig.tar.gz (2006w09/7 | 2006-03-05)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.25.orig.tar.gz
+c614a0f838c46065853ce8a70660df55 3355275 sisu_0.36.25.orig.tar.gz
+14bb8779affa6b1fe88bcdfeb81d2c35 650 sisu_0.36.25-1.dsc
+3091300f2045e946aff51a04beec9b77 91154 sisu_0.36.25-1.diff.gz
+
+  [A Fix is Necessary will revisit]
+
+  * metaverse, don't number headings that are numbered (or rather, start with
+    numbers), [may need an escape]
+
+  * manifest, don't assume a document will contain header (related/recommended)
+    links
+
+  * vim syntax highlighting, sisu.vim, added check that url not preceded or
+    followed by > or < without an intervening space (or <br> which is a bit
+    redundant but a fairly common error that is highlighted as such in full),
+    needed for auto-markup match
+
+%% sisu_0.36.24.orig.tar.gz (2006w09/2 | 2006-02-28)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.24.orig.tar.gz
+f2a727ef111585efbb84fad7d131fdb0 3354247 sisu_0.36.24.orig.tar.gz
+109b804513271cc4b0da43d27dcef8ef 650 sisu_0.36.24-1.dsc
+95838c0b653fc987b69d76c4713015cc 91128 sisu_0.36.24-1.diff.gz
+
+  * html, segmented, footnote in heading levels 1, 2, or 3, (deposit in first
+    segment 4 that follows), and clean heading of the footnote reference marker
+    after the segment in which footnote (for the heading) occurs
+
+  * html, multilingual documents, ensure html filetype suffix is used in html
+    i.e. use html file suffixes within html, even when -H (rather than -h) is
+    selected
+    [decision to hardcode protection is a bit arbitrary, suffixes required here
+    by existing server configuration. Consequences of overlooking this
+    requirement are a bit latent and fairly dire..., add configuration file
+    escape of protection]
+
+%% sisu_0.36.23.orig.tar.gz (2006w09/1 | 2006-02-27)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.23.orig.tar.gz
+  c0677a4ae79820261fa28dd9e21c01ee 3354053 sisu_0.36.23.orig.tar.gz
+  65ff2fede20f8aeb10a9f6cd55089e21 650 sisu_0.36.23-1.dsc
+  51233be83917282cc1d13647902bd0f6 90413 sisu_0.36.23-1.diff.gz
+
+  * odf, use of brackets (also square) within linked text (and linked images
+    with text), fix
+    { text to link (use of brackets odf issue fix) }http://url
+
+  * odf, issue with ? in url in linked text and images, fix
+
+  * odf, single step indent with bullet, fix
+
+  * html, rights passed through special character filter...
+    [do for other "fields"]
+
+  * metaverse, a couple more characters sanitised 
+    “” converted to "
+    — converted to -
+    'irregular' whitespace converted to space
+
+  * html, segmented, footnotes in subheadings (levels 5 & 6) a clumsy fix
+    revisit and address upstream, [also notes name tag remains unclosed]
+
+  * regex, set for utf-8, [you may wish to reconsider fixed default]
+
+  * [sisu-examples, free_culture, minor adjustments to text]
+
+%% sisu_0.36.22.orig.tar.gz (2006w08/4 | 2006-02-23)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.22.orig.tar.gz
+  78d8d224b4db8985072b1806617b5ff0 3352595 sisu_0.36.22.orig.tar.gz
+  6b8caa7cbf4893111deb30ccd05fc680 650 sisu_0.36.22-1.dsc
+  b54396f9443c7f77a9c4ef695128a0bc 90388 sisu_0.36.22-1.diff.gz
+
+  * odf, footnote fix for url matches
+
+%% sisu_0.36.21.orig.tar.gz (2006w08/3 | 2006-02-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.21.orig.tar.gz
+  a8e7a6adf347c9b20965b3d19ad872a7 3352881 sisu_0.36.21.orig.tar.gz
+  b0ff57766149bf1dd63c002d4cba3a84 650 sisu_0.36.21-1.dsc
+  089441cf1a4f72e63772f037036a18be 90358 sisu_0.36.21-1.diff.gz
+
+  * metaverse, further fix to catch exception for auto-heading/title numbering,
+    change of 0.36.19 (non-substantive/editorial hedings)
+
+  * html cosmetic, lower navigation band in scroll (doc.html), fix
+
+%% sisu_0.36.20.orig.tar.gz (2006w08/3 | 2006-02-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.20.orig.tar.gz
+  60c3775c4f553906118f01f5976c2d70 3352515 sisu_0.36.20.orig.tar.gz
+  264cb03dbd7a789568f70d94d117e56f 650 sisu_0.36.20-1.dsc
+  e4d05f5a543f53bfe4acac5fb7ea3b66 90313 sisu_0.36.20-1.diff.gz
+
+  * metaverse, fix required, issue introduced by 0.36.19, affected pdf
+
+%% sisu_0.36.19.orig.tar.gz (2006w08/3 | 2006-02-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.19.orig.tar.gz
+  3ff5116481aeb77583c4144a76f41589 3351726 sisu_0.36.19.orig.tar.gz
+  a096c23f194e748505432b4ea0ae2a2b 650 sisu_0.36.19-1.dsc
+  b6cedff150ad4a65aa85ad9e507a293b 90281 sisu_0.36.19-1.diff.gz
+
+  * metaverse, document auto-heading/title numbering, rule change
+
+  * odf anchor of heading matches to start of line, fix
+
+  * odf hyperlinked text match, escape brackets within linked text, fix
+
+%% sisu_0.36.18.orig.tar.gz (2006w08/1 | 2006-02-20)      [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.18.orig.tar.gz
+  5d1e674fc8d61c703b8479c230abbe21 3351642 sisu_0.36.18.orig.tar.gz
+  4186636de25bb42888c519cd62891101 650 sisu_0.36.18-1.dsc
+  6f61755dc6baeb6b09aac52bba504616 90236 sisu_0.36.18-1.diff.gz
+
+  * cgi sample form, sql search improved
+    [development iterations necessary]
+
+%% sisu_0.36.17.orig.tar.gz (2006w07/7 | 2006-02-19)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.17.orig.tar.gz
+  3715d971d556c5eb4de10ccb8cae4857 3352507 sisu_0.36.17.orig.tar.gz
+  2667514040bbdb928c130b2e565aea18 650 sisu_0.36.17-1.dsc
+  f393dd1f8ba8b344aba976af2c92771e 90212 sisu_0.36.17-1.diff.gz
+
+  * cgi sample forms (sqlite), match highlighting made case insensitive
+    character 'i' added to two files in two places
+
+%% sisu_0.36.16.orig.tar.gz (2006w07/7 | 2006-02-19)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.16.orig.tar.gz
+  1d4ab63bb65308f27fc057e2c4f045de 3352304 sisu_0.36.16.orig.tar.gz
+  2215b97903545574fe57c8b413ac5ba1 650 sisu_0.36.16-1.dsc
+  5100b3d4bfb0eabf11cc3614e389005a 90196 sisu_0.36.16-1.diff.gz
+
+  * cgi form (generator),
+    canned url populates search field
+    more cosmetic rearrangement of code, e.g. cgi_common_sql introduced
+    for common code (in pgsql & sqlite forms)
+
+  * manual cgi samples renamed and updated
+    sisu-examples/sample/cgi-bin/sisu_search_pgsql.cgi
+    sisu-examples/sample/cgi-bin/sisu_search_sqlite.cgi
+
+%% sisu_0.36.15.orig.tar.gz (2006w07/6 | 2006-02-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.15.orig.tar.gz
+  7daadfb8ea39c30c0bc2317e24a3ce17 3358917 sisu_0.36.15.orig.tar.gz
+  13501be6212b0fd7067f4fccd575d22e 650 sisu_0.36.15-1.dsc
+  12d5fcca3dfedf94d0f3360b06b78ffb 90169 sisu_0.36.15-1.diff.gz
+
+  * cgi form (generator), some cosmetic rearrangement of code,
+    order by output esp. for sqlite,
+    image paths rearranged
+
+%% sisu_0.36.14.orig.tar.gz (2006w07/6 | 2006-02-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.14.orig.tar.gz
+  bb206e160026ee8a0804a86191d088fc 3355327 sisu_0.36.14.orig.tar.gz
+  c3c8df68d3c9dea339fd18afce83f258 650 sisu_0.36.14-1.dsc
+  dcbdde8b5401d7aa2ea08cf30d2a4202 90155 sisu_0.36.14-1.diff.gz
+
+  * cgi form (generator) for pgsql and sqlite split up
+  
+  * cgi form (generator) match highlighting added
+    [sample search form remains very basic]
+
+  * images, minor change to sisu.png and
+    inclusion of fsf/gnu levitating gnu
+
+  * metaverse, sanitize ’ character
+
+%% sisu_0.36.13.orig.tar.gz (2006w06/7 | 2006-02-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.13.orig.tar.gz
+  7a4aa2e929e19df900f18b96ae1d5de6 3286170 sisu_0.36.13.orig.tar.gz
+  92cde921735e33b3a781c2632470b721 650 sisu_0.36.13-1.dsc
+  7a4aa2e929e19df900f18b96ae1d5de6 3286170 sisu_0.36.13-1.diff.gz
+
+  * bold line shortcut tag, !_ where no bold list, a fix
+
+  * minor, cosmetic code changes of tests with equivalents (type .nil? and
+    .empty?) [done a bit quickly though]
+
+  * minor, one spelling correction in free_as_in_freedom
+
+%% sisu_0.36.12.orig.tar.gz (2006w06/4 | 2006-02-09)      [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.12.orig.tar.gz
+  0e5ca6878d119dafc6652b4f3dd0fb24 3285735 sisu_0.36.12.orig.tar.gz
+  01ecb4df7879f576e284339abc6b49e2 650 sisu_0.36.12-1.dsc
+  8fe27729103af5a5cbddc26a89d7522e 90101 sisu_0.36.12-1.diff.gz
+
+  * metaverse_syntax, fix required for alternative markup endnotes
+
+  * cgi (frontend for pgsql), url link fix (.html suffix) for webrick server
+
+  * digests/dcc, added info, minor
+
+%% sisu_0.36.11.orig.tar.gz (2006w06/4 | 2006-02-09)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.11.orig.tar.gz
+  31749714603f3730a5589eb736e26cab 3284870 sisu_0.36.11.orig.tar.gz
+  49a9807d5b7cf436a303de1c8f7100d1 650 sisu_0.36.11-1.dsc
+  79301acf6b43364639f34e2baa5697c3 90088 sisu_0.36.11-1.diff.gz
+
+  * digest/dcc, further tuning of output presentation (digest.txt)
+
+%% sisu_0.36.10.orig.tar.gz (2006w06/3 | 2006-02-08)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.10.orig.tar.gz
+  672259d2176c1fa5bba0414493d74970 3284698 sisu_0.36.10.orig.tar.gz
+  da64e5f067408b6db1ffac97649e246b 650 sisu_0.36.10-1.dsc
+  25000b7faf86e44ccdb65b9c9bc0a42d 90073 sisu_0.36.10-1.diff.gz
+
+  * digest/dcc, (document content certificate), a bit more information
+    provided, in output and on man pages, e.g. see
+    http://www.jus.uio.no/sisu/sisu_changelog/digest.txt
+    or
+    http://www.jus.uio.no/sisu/SiSU/digest.txt
+    etc.
+
+  * sisu man page, minor fixes and minor embellishments
+
+  * home page, in default and skins, minor change
+
+%% sisu_0.36.9.orig.tar.gz (2006w06/2 | 2006-02-07)       [Debian Release snapshot, uploaded by Wookey]  
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.9.orig.tar.gz
+  e76442aac4a8cdd7492ad167dca41925 3282776 sisu_0.36.9.orig.tar.gz
+  eedec4d07f05ea60143d87fe0b7a4d98 647 sisu_0.36.9-1.dsc
+  565b0a6b88f2eda2dcd22284e5d6ff72 90040 sisu_0.36.9-1.diff.gz
+
+  * fix of filelists where param is not parsed, relevant to rsync, scp and zap
+    [problem introduced by changes made for multilingual documents which
+    assumed that param is always parsed]
+    [solution not elegant, but likely to remain a while]
+
+%% sisu_0.36.8.orig.tar.gz (2006w06/1 | 2006-02-06)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.8.orig.tar.gz
+  9ed1bf836f160a2bc1b731f28603b546 3281967 sisu_0.36.8.orig.tar.gz
+  6284e201cc9cf8c0eccf7e25ac7d3868 647 sisu_0.36.8-1.dsc
+  bc6c9675bfc3e14ef1a44b0b93d9cf6f 90003 sisu_0.36.8-1.diff.gz
+
+  * plaintext dos/Unix, check that all dos linefeeds are in place
+
+  * help (man pages, html, program), minor adjustments, and sync html
+    with man pages
+
+  * remote (rsync,scp) building of filelist for placement of output
+    improved, relevant for multilingual documents 
+    [could be improved further especially for scp, where there is no
+    language code all documents are copied, which results in
+    duplication]
+
+%% sisu_0.36.7.orig.tar.gz (2006w05/7 | 2006-02-05)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.7.orig.tar.gz
+  b803f347a64d0419965e194f380988fe 3281398 sisu_0.36.7.orig.tar.gz
+  d07542cb5d8789af37a89db8b5ef2753 647 sisu_0.36.7-1.dsc
+  9cda1006001769a03a22245499ebc321 89967 sisu_0.36.7-1.diff.gz
+
+  * metaverse, linefeed conversion, convert msdos line feeds \r\n to unix \n
+    for processing
+
+  * sisu(1) man page, note added on how to produce dos plaintext output file
+    (instead of linux/unix)
+
+  * plaintext, default shortcut flags changed to produce dos ascii files,
+    reason, Unix/Linux seldom has a problem dealing other ascii filetypes, MS
+    based programs are more likely to stumble, also if manifest built
+    concurrently with plaintext will use plaintext command flag to give
+    information on output type - whether Unix or dos etc. [could add a file
+    check of type where manifest is built separately, not really necessary]
+
+  * skins, minor edits, path to css corrected
+
+%% sisu_0.36.6.orig.tar.gz (2006w05/6 | 2006-02-04)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.6.orig.tar.gz
+  490413665dc030ac80eafde61d816aa0 3280852 sisu_0.36.6.orig.tar.gz
+  5823740759b6c1cd7af9f0427f5e5446 647 sisu_0.36.6-1.dsc
+  fcc375a5464c65be9a665d600b7b775a 89943 sisu_0.36.6-1.diff.gz
+
+  * html (some w3c compliance steps) [2006-01-15]:
+    * object "id" number names changed, preceded by letter o
+    * use of name tag to give objects numbers (instead of id for numeric value)
+    * footnote links changed (use of underscore (instead of tilde not permitted))
+    * image tags "closed"
+    * skin adjustment
+    * finally reinstate w3c transitional xhtml header
+
+  * html tables, changed organisation of code [2006-01-16]
+  
+  * odf tables [2006-01-17]
+    [display only without tables headings]
+
+  * odf pagebreaks [2006-01-17]
+  
+  * odf bullets [2006-01-17]
+
+  * odf multiple images in object [2006-01-18]
+    image handling, fix [2006-01-22]
+    image captions [2006-01-22]
+    placement within text "as char" [2006-01-23]
+
+  * overview.txt updated with things done
+
+  * url screen display, fix to urls in batch processing [2006-01-17]
+    [overlooked because of personal practice of using rant/make to run all
+    requested processes on each markup file in a batch process]
+
+  * sisu headers, document recommended links, 12 link limit removed [2006-01-20]
+
+  * tables, introduced an alternative visual representation [2006-01-20]
+
+  * odf tables, max number of columns increased to 14 from 8 [2006-01-22]
+    (12 may be useful for months plus at least one to describe content)
+
+  * sisu_test.s3 document added to serve as quick test of markup forms and a
+    rough guide however it does not at all serve as an example of a typical
+    document [2006-01-21]
+
+  * html anchor heading matches to start of line, [watch] [2006-01-22]
+
+  * odf text links [2006-01-22]
+
+  * odf bullets, as image, currently using "red pill" [2006-01-23]
+
+  * texpdf special character vertical bar / pipe, fix [2006-01-23]
+
+  * digests, document content certification, work on multiple images [2006-01-26]
+
+  * digests, document content certification, (digest info) digest for
+    document skin digest, and repeat of document digest [2006-01-27]
+
+  * sql (pgsql, sqlite), special character escape, changes [2006-01-28]
+
+  * docbook experimental introduced, another form of xml (may need to rename,
+    so far represents a quick first pass at docbook, and does not qualify as
+    docbook: docbook is released under a liberal license permitting all manner
+    of modifications, but if modified may not be called docbook) is as noted
+    experimental and undocumented, (and may as easily be quietly removed, or
+    renamed as improved upon) [2006-01-31] [will need to study a number of things
+    including embedding document parts (within parts)..., may take opportunity
+    to introduce some substantive tags to sisu that are docbook compatible]
+
+%% sisu_0.36.5.orig.tar.gz (2006w01/5 | 2006-01-06)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.5.orig.tar.gz
+  e774624280d20e8e7153a5eaf6cfeadd 3271834 sisu_0.36.5.orig.tar.gz
+  3dc07a05827739b13aebcdb07c777aed 647 sisu_0.36.5-1.dsc
+  1b15ff3121d71868fcc64a912dd7d5c4 89869 sisu_0.36.5-1.diff.gz
+
+  * sisu man page minor edit
+
+  * copyright file contains information on setup.rb included with tarball
+    and on Rant used to generate install, 
+    both under Gnu Lesser Public License
+
+  * Debian build changed, fewer packages, hope to unify the SiSU development
+    and SiSU Debian upload builds
+
+%% sisu_0.36.4.orig.tar.gz (2006w00/7 | 2006-01-01)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.4.orig.tar.gz
+  4fb9343d78745fe582c1d91c5874d8cf 3270301 sisu_0.36.4.orig.tar.gz
+  d89b702d13d00b1bb34f6aca2a03b77a 691 sisu_0.36.4-1.dsc
+  c0889387ad3fe063c38d04a7cdcd0695 89581 sisu_0.36.4-1.diff.gz
+
+  * plaintext, multi-language document url adjustments
+
+  * termsheet, output path and urls
+
+  * [some multi-language document markup samples added to debian build in
+    sisu-examples]
+
+%% sisu_0.36.3.orig.tar.gz (2005w52/6 | 2005-12-31)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.3.orig.tar.gz
+  b2ab154a1f2656edd9032500e757c03e 3261612 sisu_0.36.3.orig.tar.gz
+  964e4279748cf63526b8963f162f1eaf 691 sisu_0.36.3-1.dsc
+  ad3b135cb8dd825e56769b0f583b5542 13969 sisu_0.36.3-1.diff.gz
+
+  * adjustments made for consequences of possibility of multi-language documents in sysenv, wmap, sql (psql/sqlite), remote put
+  
+  * sql prefix column changed to TEXT (from VARCHAR)
+
+  * sysenv, change to the initialization of constants [revisit]
+
+%% sisu_0.36.2.orig.tar.gz (2005w52/5 | 2005-12-30)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.2.orig.tar.gz
+  990dd7e60ecfee3b9dce863a0a28cc4e 3261132 sisu_0.36.2.orig.tar.gz
+  e2a3e592727eb67eacdc863a817df482 691 sisu_0.36.2-1.dsc
+  d8e12848dc94f0c0da1a2afa23312e53 13913 sisu_0.36.2-1.diff.gz
+
+  * sql (pgsql/sqlite), (a fix:) "manifest" column replaces "summary" column
+
+  * html_format_table.rb removed, last dependency removed, rely on css
+
+  * wmap use main css, and own styles
+
+%% sisu_0.36.1.orig.tar.gz (2005w52/4 | 2005-12-29)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.1.orig.tar.gz
+  099b3c9735e664d164a42835e157055b 3262472 sisu_0.36.1.orig.tar.gz
+  646d6b052d0de625badd2ae22551808b 691 sisu_0.36.1-1.dsc
+  31fc43e92b23ceb2834c8b2fdc4caaf5 13896 sisu_0.36.1-1.diff.gz
+
+  * html batch processing fix, placement of files:
+    index.html, toc.html and doc.html
+
+%% sisu_0.36.0.orig.tar.gz (2005w52/4 | 2005-12-29)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.36.0.orig.tar.gz
+  9f81885774e9bccf267ba1bde2d9894b 3261722 sisu_0.36.0.orig.tar.gz
+  f380ff4f31e1e92c796017bf2636f037 691 sisu_0.36.0-1.dsc
+  44f61789decda5816cf4b106fade30b2 13864 sisu_0.36.0-1.diff.gz
+
+  * html -h -H behaviour switch, -h now produces urls with suffixes (hardlinks,
+    including .html .pdf etc.) (this being the default that just works,
+    including for reading output in a browser directly off a file-system), -H
+    omits them and requires an appropriately configured web server. 
+    [change in behaviour is the reason for this version number bump]
+
+  * multilingual/(multiple language) document filenaming convention and
+    associated behaviour, made default, unless turned off in configuration file
+    default:
+      multilingual: false
+
+  * multilingual/(multiple language) document output filenaming convention set
+    at 1 in following example list: 
+    (1) outputdir/es.[file].html
+    (2) outputdir/[file].es.html
+    (3) outputdir/[file].html.es (which Apache for example can be
+    the first option is convenient in that it organises versions of document by
+    language in the output directory, (i tend to use 2 though)
+
+    default:
+      language_file: 2
+
+    (the default in the absence of a setting is 1 es.index.html, rather than 2
+    index.es.html)
+
+    [contains a batch processing bug affecting some html output, fix in 0.36.1]
+
+%% sisu_0.35.0.orig.tar.gz (2005w52/3 | 2005-12-28)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.35.0.orig.tar.gz
+  f86673b0bf576a82aa73c80540a2303f 3260953 sisu_0.35.0.orig.tar.gz
+  4db5b9c912b117286460a85b59fd8d8a 691 sisu_0.35.0-1.dsc
+  362829f8d71ee03eaf47aa1f8b8f3856 13828 sisu_0.35.0-1.diff.gz
+
+  * sisupod, sisu multi-language document pod, in place
+    if config file permits, will search for multiple versions of the same
+    document in different languages, by file naming convention, and all these
+    will be placed into the same sisudoc source file, the intention will be
+    to separate the sisudoc file format for single documents and sisupod for
+    multi-lingual versions of the same.
+    (changes to sysenv and sisudoc for this purpose)
+
+  * multi-lingual versions of document naming and output conventions
+    conceptually sorted,
+    e.g. assuming config file set as appropriate 
+    language version name takes the form:
+    filename~es.s3
+    output alternatives become, (depending on config file setting)
+    (1) filename/es.index.html
+    (2) filename/index.es.html
+    (3) filename/index.html.es (which Apache for example can be
+    configured to use for automatically serving the users preference)
+    it is now just to stepwise implement the rules for output...
+    some detail remains as what to do with the default language, will this
+    feature be strict so that too will have the language version code included,
+    or, is it more convenient to drop it in that instance
+
+    default:
+      language_file: 2
+    #  multilingual:  true
+
+  * param, config filename placement information gathering rules for
+    multi-document version output are in place, done with flexibility in mind,
+    language insertions may be made at any of three points in filename 
+
+  * sub-numbering system, default behaviour change/correction, reset when any
+    major number changes [consider offering the alternative of running
+    sub-numbers, below 4~, would be set in header]
+
+  * urls (-u, -U, -v), match new multilingual file naming convention
+
+  * manifest, show multilingual version manifests, if available
+
+    [contains a batch processing bug affecting some html output, fix in 0.36.1]
+
+%% sisu_0.34.2.orig.tar.gz (2005w51/1 | 2005-12-19)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.34.2.orig.tar.gz
+  db01ece3bc2314c57f0aa88d6ebd2974 3254394 sisu_0.34.2.orig.tar.gz
+  197f762e774ddb42bc35c922386d3133 691 sisu_0.34.2-1.dsc
+  2520379d811471ff5a3ca7fab6c4c646 13798 sisu_0.34.2-1.diff.gz
+
+  * default css, fix to image links (paths),
+    necessitated by changes to directory structure
+
+  * digests, include in header url for set sisu_manifest, and time and version
+    information at the top of the document
+
+%% sisu_0.34.1.orig.tar.gz (2005w50/7 | 2005-12-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.34.1.orig.tar.gz
+  d42234876268924db8dddd33faecd3b0 3254032 sisu_0.34.1.orig.tar.gz
+  ba33053014594db6cc36489ccf49b5c1 691 sisu_0.34.1-1.dsc
+  0d7297accec601ff4e9f93a4746f3cd5 13756 sisu_0.34.1-1.diff.gz
+
+  * html and wmap output manifest cosmetic link change and a link fix in html
+
+  * manifest, md5 if markup source is shared, show if -v
+
+%% sisu_0.34.0.orig.tar.gz (2005w50/6 | 2005-12-17)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.34.0.orig.tar.gz
+  b46664690687cec318848df0f2d663f7 3253826 sisu_0.34.0.orig.tar.gz
+  2c5cdede22b60b4f71294ca1a2a1e804 691 sisu_0.34.0-1.dsc
+  1c636c138c29931d6216349f0655a709 13695 sisu_0.34.0-1.diff.gz
+
+  * directory structure changes
+    [reason for version number jump]
+    * all sisu output server configuration 
+      goes into subdirectories named _sisu,
+      one within the main server directory
+      and another within each document directory created
+        _sisu/image
+        _sisu/css
+        _sisu/dtd
+    * localised sisu markup/input configuration 
+      is placed directly under _sisu in the markup directory
+      (rather than _sisu/config), the hierarchy becoming
+        ./_sisu
+        ~/sisu
+        /etc/sisu
+    NOTE: it is again necessary to run sisu -CC
+    NOTE: the following have so far been considered and discarded as
+    alternatives to _sisu: "sisu" discarded as a name sometimes used for a
+    document directory; ".sisu" discarded as hidden output directories may be
+    confusing to the user; "sisurc" remains a possible alternative which is a
+    bit descriptive, however "_sisu" is consistent with the configuration
+    directories, and chosen for now
+
+    * see notes on css and images
+    for changes to image and css output directories
+    * see notes on configuration for notes on changes within 
+    _sisu in local markup directory
+
+  * manifest, renamed from summary, sisu_manifest.html instead of summary.html
+    [reason: less likely to be useful in other circumstances, summary freed as
+    a reserved filename] [contains: #output #metadata #links]
+  
+  * _sisu: _sisu/conf files and subdirectories moved to _sisu
+    [reason: the deeper directory structure made sense when sisu_processing was
+    also contained with _sisu, it is no longer helpful,
+    the directory structure of ./_sisu mirrors that of ~/.sisu]
+
+  * images now placed within output directory sisu/image
+    (there is a main sisurc directory and each subdirectory (mapping to a
+    markup directory stub) contains its own sisurc directory)
+
+  * generation of remote markup/source documents url, some work, on image
+    mappings
+
+  * css: logic in place for manually created css substitution
+    * -CC copies css files to output/webserver director sisu_css
+    if they exist in ./_sisu/css, ~/.sisu/css or /etc/sisu/css
+    * -H or -h html -x -X for xml etc. will look in output/webserver
+    sisu_css directory for any requested css. If it exists, pages created
+    will link to it, otherwise, the default css files provded by sisu are used.
+    * css requests may be done on a document or directory stub basis 0~css grey 
+    will look for grey_html.css and the directory stub book, will look for 
+    book_html.css
+    [note: check and make pages more css friendly]
+
+  * fix, if the within a document markup directory the directory
+    _sisu_processing exists and is writable it will be used for processing
+    otherwise /tmp/_sisu_processing is used
+    [i.e. to use ./_sisu_processing for processing, create it]
+
+  * sisurc.yaml defaults set to false to prevent zap (-Z) and css changes
+
+  * Sam Williams copyright notice, included under 0~rights in Free as in
+    Freedom, not sure how this has been missed.
+
+  * minor screen display url correction, in sax.xml
+
+%% sisu_0.33.0.orig.tar.gz (2005w50/4 | 2005-12-15)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.33.0.orig.tar.gz
+  8a0907a006a1cb7187b5006db4f5ff7c 3252270 sisu_0.33.0.orig.tar.gz
+  42b0ac73e9c5d680c70c86d9ee3115c2 691 sisu_0.33.0-1.dsc
+  2c1a41d51aefa57d3a7c0f4c82356ce5 13649 sisu_0.33.0-1.diff.gz
+
+  * processing directory, moved to ./_sisu_processing from ./_sisu/processing 
+    [reason: makes it easier to backup _sisu [you will almost never want _sisu_processing]]
+    /tmp/_sisu_processing is default and used if the former directory is absent
+    (instead of /tmp/sisu_processing for consistency)
+    [reason for local directory processing option if /tmp is default, exists,
+    if you prefer to keep processing out of /tmp]
+    [consider for /tmp adding to path /tmp/_sisu_processing/[$USER]/[directory
+    stub] to minimise likelihood of collisions, unlikely currently as the
+    default is to regenerate "metaverse" for each request]
+
+  * css, moved to [web_output]/sisu_css from [web_output]/style
+    [reason: collision with other efforts, manual or otherwise even less likely]
+    this means it is necessary to reinitialise directories, see sisu -CC
+
+  * external document (using url to call for processing), paths for processing
+    and downloaded images adjusted (processing and output)
+
+  * install (Rantfile and rant: install), a fix required
+
+%% sisu_0.32.5.orig.tar.gz (2005w50/3 | 2005-12-14)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.32.5.orig.tar.gz
+  aaaa1f0b62a45f5631d6875b8d1c4f60 3250422 sisu_0.32.5.orig.tar.gz
+  e201e7b1429886cf9b2be3ec14a63f18 691 sisu_0.32.5-1.dsc
+  01009df572a86b00e2ea1d3ddf7b1211 13627 sisu_0.32.5-1.diff.gz
+
+  * orig.tar.gz should now be updated together with debian package
+    orig.tar.gz has not been updated properly since 0.31.4, debian package has
+    issue with autopackage builder
+
+  * debian package improved, however: diffs started from scratch, information/history abandoned
+    Reason: undetermined problem with automated package builder.
+    automated package builder (which uses darcs and darcs-buildpackage) builds package 
+    normally/properly with a pristine directory structure, but not with accumulated debian build history.
+    For now, the orig.tar.gz and debian package structure are updated, and debian history is not included.
+
+  * directory named extra removed from source tarball, 
+    extra/debian/man moved to debian/man
+
+  * debian, correction of a man page
+
+%% sisu_0.32.4.orig.tar.gz (2005w50/1 | 2005-12-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.32.4.orig.tar.gz
+  bd699b88457a2daf06de35681cd4df47 3265783 sisu_0.32.4.orig.tar.gz
+  2e8a85326c7e14845481affb4df00fc0 692 sisu_0.32.4-1.dsc
+  e18913a52d26cf6bd1e5952b288cc08a sisu_0.32.4-1.diff.gz
+
+  * odf (opendocument), images - an image per paragraph/object only, at present
+    (thanks Alex Hudson #odf so_solid_moo for feedback, was placing paragraphs
+    within paragraphs, last step in getting images working)
+
+  * odf (opendocument), sisu document metadata
+
+%% sisu_0.32.3.orig.tar.gz (2005w49/7 | 2005-12-11)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.32.3.orig.tar.gz
+  83e69d4ae96e578e8d089e9ad52c53c0 3265897 sisu_0.32.3.orig.tar.gz
+  e5c79923d0f574b7c9b8c5e36b9cead8 692 sisu_0.32.3-1.dsc
+  6b95e5e713468c957da365e05bf5b3a7 258645 sisu_0.32.3-1.diff.gz
+
+  * html endnote url re-fix
+
+%% sisu_0.32.2.orig.tar.gz (2005w49/4 | 2005-12-08)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.32.2.orig.tar.gz
+  b95ce4a61d1ad27eca528624fcc582c9 3265864 sisu_0.32.2.orig.tar.gz
+  8d84f343edb6dc7dd5e4edbc54f5633c 692 sisu_0.32.2-1.dsc
+  a95ac72c37636ac3ba15f6a9ec6ab4d2 258346 sisu_0.32.2-1.diff.gz
+
+  * sqlite, repair
+
+%% sisu_0.32.1.orig.tar.gz (2005w48/6 | 2005-12-03)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.32.1.orig.tar.gz
+  568917465359a1324f973929009c6993 3265886 sisu_0.32.1.orig.tar.gz
+  6f539432cebe4abfeadf87e993416fcb 692 sisu_0.32.1-1.dsc
+  3420efac3b35079d0ad3197a1e7fb4e0 257563 sisu_0.32.1-1.diff.gz
+
+  * minor code cleaning, mostly removal of commented out code, 
+    lib html_css.rb, removed as redundant
+
+  * package: html files in data/doc/sisu moved to data/doc/sisu/html
+
+  * debian:control a missing comma added to comma delimited depends list
+
+%% sisu_0.32.0.orig.tar.gz (2005w48/4 | 2005-12-01)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.32.0.orig.tar.gz
+  d9a549c11f77809c874ab664fc24d41f 3265763 sisu_0.32.0.orig.tar.gz
+  f3605f1094fb587dbc113198054c868f 692 sisu_0.32.0-1.dsc
+  54f1ebd40f654df574043270e8c939f4 257434 sisu_0.32.0-1.diff.gz
+
+  * -v urls, minor correction 
+
+  * -q quieter
+     pdflatex quieter [/dev/null screen ouput except for -v up]
+
+  * -q -v -V -M -u screen information levels better sorted
+
+%% sisu_0.31.5.orig.tar.gz (2005w48/4 | 2005-12-01)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.31.5.orig.tar.gz
+  9fe95a6f45eb21dabcdf227ccce1dae9 3273030 sisu_0.31.5.orig.tar.gz
+  a7faf0e8797755a628c055e29e2da34a 691 sisu_0.31.5-1.dsc
+  fa5e70331f75052e604297d900907f38 13116 sisu_0.31.5-1.diff.gz
+  [this should have been 0.32.0]
+
+  * -v -M etc. (cosmetic) url, output path information improved
+    additional possibilities in configuration, sisurc.yaml
+    setting of programs used: 
+    text_editer, web_browser, pdf_viewer, odf_viewer
+    setting of viewing preference, vis path, and url
+
+  * -CC re homepages, new option setting the (manually crafted) home page, 
+    copy from first found of:
+      ./_sisu/conf/home/index.html
+      ~/.sisu/home/index.html
+      /etc/sisu/home/index.html
+    otherwise, as before will look for home page in:
+      ./_sisu/conf/skin/doc/skin_sisu.rb
+      ~/.sisu/skin/doc/skin_sisu.rb
+      /etc/sisu/skin/doc/skin_sisu.rb
+    and as before if that is not found, take the sisu default
+
+  * css styles, start implementing a more flexible model for using
+    alternative stylesheets, stylesheets may be specified in document header
+    0~css or 0~stylesheet [name], and if that existws, or if a stylesheet
+    exists that matches the markup directory stub, results in html, xhtml, xml
+    as appropriate, requesting the matching stylesheets documunts
+    [needs work and testing before it becomes really useable, for the time 
+    being is switched off by default to use must be enabled in conf file]
+    [css stylesheets renamed, likely to be noticed]
+
+  * -CCr -CCRZ stubs for remote copying/building of base site,
+    images, css stylesheets, index.html and toc.html
+    (not to be confused with existing remote placement of generated output)
+
+  * Debian package adjustment
+
+%% sisu_0.31.4.orig.tar.gz (2005w48/2 | 2005-11-29)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.31.4.orig.tar.gz
+  5f9e68079806301e4f32ddc801ffdbd0 3249616 sisu_0.31.4.orig.tar.gz
+  9bdc2f510a981efbd811194dddb230a4 679 sisu_0.31.4-1.dsc
+  27db1bffe6571ee571e54961a450775e 11351 sisu_0.31.4-1.diff.gz
+
+  * Debian packages broken into smaller packages, for better control over
+    dependencies, source package structure affected (control, .install,
+    .manpages)
+
+  * sisu-composite together with sisu-examples installs the whole of SiSU
+
+%% sisu_0.31.3.orig.tar.gz (2005w48/1 | 2005-11-28)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.31.3.orig.tar.gz
+  562d89e8a4346350f749f660eb266a57 3245995 sisu_0.31.3.orig.tar.gz
+  af095b570f9aa0a7d1472747ea854e8e 10769 sisu_0.31.3-1.diff.gz
+  68cd0ea97435cc03c893d68d7e70259a 10789 sisu_0.31.3-2.diff.gz
+  198aef746935e6fcf673b8fb33d6e581 579 sisu_0.31.3-2.dsc
+
+  * remote url gathering of images re-fixed, e.g.
+    sisu -Hpv http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.s3
+    should produce html and pdf of Free Culture from the online marked up file, with the images
+    [sisu -CC (to copy downloaded images to the output directory)]
+    sisu -pHv http://www.jus.uio.no/sisu/sphinx_or_robot.leena_krohn.1996/sphinx_or_robot.leena_krohn.1996.s3
+    [has even more images, you will have to repeat sisu -CC]
+    [includes a workaround for an odd bug: retry needed on first attempt]
+
+  * sisu control, ensure file array unique
+    [some risk of unforeseen consequences, test]
+
+  * -v verbose output, minor, tagged on mention of sisu -W starting ruby
+    webserver on sisu output directory
+
+  * add link to sisu_faq, maintain faq
+
+  * [debian, started using pbuilder 
+    (otherwise, package still built using darcs-buildpackage, and additional
+    enthusiastic use of mercurial for version control)]
+
+  * sisu_0.31.3-1 debian:control: Depends: ruby1.8 (>=1.8.3)
+  
+  * sisu_0.31.3-2 debian:control: Depends: ruby (>=1.8.2)
+
+%% sisu_0.31.2.orig.tar.gz (2005w47/6 | 2005-11-26)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.31.2.orig.tar.gz
+  e928fc31ce6109f924836c79a3c19027 3245306 sisu_0.31.2.orig.tar.gz
+  374bbe3ae0ddc53a652c5abcb421d6a7 10726 sisu_0.31.2-1.diff.gz
+
+  * debian autobuild fix [external scaffolding]
+
+%% sisu_0.31.1.orig.tar.gz (2005w47/6 | 2005-11-26)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.31.1.orig.tar.gz
+  b1734e76a39d043010e30722bbb3359c 3245133 sisu_0.31.1.orig.tar.gz
+  20bbb1f84c34779e55abed80aae7fdf0 10679 sisu_0.31.1-1.diff.gz
+
+  * odf, minor fix url match
+
+  * [sample documents urls to amazon and barnes and noble 
+    added as courtesy to authors]
+
+  * [Note: change to automated debian package build procedure]
+
+%% sisu_0.31.0.orig.tar.gz (2005w47/5 | 2005-11-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.31.0.orig.tar.gz
+  e6beae75cda1d00c68dc0d97c67cb540 3244304 sisu_0.31.0.orig.tar.gz
+  8785cf622dee3fe07eed841b8cfbf8e1 10626 sisu_0.31.0-1.diff.gz
+
+  * metaverse, header, italicise and bold lists, 
+    results in significant changes
+    markup change use regex directly
+    [results in odf (openoffice) repair of 0.30.9]
+
+%% sisu_0.30.10.orig.tar.gz (2005w47/5 | 2005-11-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.10.orig.tar.gz
+  ed89acbe1f406f2f55052651d12f1b78 3242816 sisu_0.30.10.orig.tar.gz
+  6495690d1611efd7c9a8145a8b0ca73e 10589 sisu_0.30.10-1.diff.gz
+
+  * rollback to 0.30.8 header, italicise and bold lists, 
+    use of semi-colon delimited list, 
+    [new version number 0.31 opened for header use of regex 
+    to italicise and bold]
+
+%% sisu_0.30.9.orig.tar.gz (2005w47/2 | 2005-11-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.9.orig.tar.gz
+  70cc77083106e86b98bcf719ec35d657 3242867 sisu_0.30.9.orig.tar.gz
+  5ab1832552e65f598304baff2e253a88 10499 sisu_0.30.9-1.diff.gz
+
+  * setup.rb 3.4.1 by Minero Aoki included with SiSU as an installer
+
+  * package directory structure modified to comply with setup.rb default
+    data/man moved to man as setup.rb, affects debian
+  
+  * header, italicise and bold lists, markup change use regex directly
+    [instead of converting semi-colon delimited list]
+
+  * minor notes on installation in README
+
+%% sisu_0.30.8.orig.tar.gz (2005w47/2 | 2005-11-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.8.orig.tar.gz
+  a75adbe1198732ec577c630e4b4e94dd 3229748 sisu_0.30.8.orig.tar.gz
+  3a4cd20539b968f37d10c1a8383bc315 10595 sisu_0.30.8-1.diff.gz
+
+  * latex pdf, the pdfetex parameters used appear to be Debian specific,
+    SiSU LaTeX is written for pdflatex... change precedence/ search order,
+    use pdflatex if present, otherwise try use pdfetex (with pdflatex parameter)
+
+  * url/document output, (largely cosmetic fix) screen information,
+    sisudoc (-S) and sisu markup source (-s) [-S was linked to sqlite]
+
+  * url (-U) print urls without -v
+
+%% sisu_0.30.7.orig.tar.gz (2005w47/1 | 2005-11-21)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.7.orig.tar.gz
+  83c56fa696a75a9111295c99c2e5196e 3229287 sisu_0.30.7.orig.tar.gz
+  2e581d080177a0aa24f7076597676438 10552 sisu_0.30.7-1.diff.gz
+
+  * rsync screen message adjustment
+
+  * skin:hp linked to sisu_changelog which has been separated from sisu_download
+
+  * composite documents, fix manual closure of file is apparently necessary !
+
+%% sisu_0.30.6.orig.tar.gz (2005w46/7 | 2005-11-20)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.6.orig.tar.gz
+  c9abcf18916ac55d67308039f01933bb 3228496 sisu_0.30.6.orig.tar.gz
+  810751b72796f862fe5d9f4cfcbe195b 10510 sisu_0.30.6-1.diff.gz
+
+  * numeric shortcuts accept rsync extra command flag (-R)
+
+  * rsync (-R), screen output minor (what default, verbose and quiet do)
+
+%% sisu_0.30.5.orig.tar.gz (2005w46/7 | 2005-11-20)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.5.orig.tar.gz
+  e3e08897e4d7c3373c5898f31926c094 3228219 sisu_0.30.5.orig.tar.gz
+  583723571b8df2aa7717a7872b143227 10497 sisu_0.30.5-1.diff.gz
+
+  * conf, homepage, skin path precedence, fix 
+    (related to finding ./_sisu/conf/skin/doc/skin_sisu.rb)
+
+  * summary, suggested links, cosmetic: fix to static url
+
+  * sisu_doc, drop making of directory _sisu/config 
+    (using _sisu/conf)
+
+%% sisu_0.30.4.orig.tar.gz (2005w46/6 | 2005-11-19)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.4.orig.tar.gz
+  a2a1bf159e3ccfdd7a15baf4f2603fbf 3227828 sisu_0.30.4.orig.tar.gz
+  895212c9fb09f100674338b7694ad921 10481 sisu_0.30.4-1.diff.gz
+
+  * html segments, summary button, fix (icon and link)
+
+  * sisudoc, cosmetic: screen output, touch (remove repeat of output filename)
+
+  * summary, suggested links, cosmetic: replace relative links with static url
+
+  * conf.rb renamed from config.rb
+
+  * moved sisu_changelog out of main SiSU document [has grown large]
+
+%% sisu_0.30.3.orig.tar.gz (2005w46/6 | 2005-11-19)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.3.orig.tar.gz
+  444a194aae38120f13fd3bf2f9ae505a 3227547 sisu_0.30.3.orig.tar.gz
+  1d1b49a957cb118a3110574d26bb9304 10413 sisu_0.30.3-1.diff.gz
+
+  * configuration, change, use ./_sisu/conf 
+    [WARNING ./_sisu/config is depreciated and will be removed]
+
+  * db:pgsql, bugfix FROM required in a select statement
+    [postgresql 8.1 complained]
+
+  * zap, delete, -Z disable by default,
+    to use must enable in sisurc.yaml
+
+  * rmagick, disable load/require by default, sisurc.yaml 
+    problem with some local installs of ruby
+
+  * pdfetex, call with -fmt=pdflatex
+
+  * summary, metadata suggested links added
+
+  * xml,xhtml,html tidy only run with -V or -M
+    rexml only with -M, primary reason a considerable speedup 
+    in skipping step unless specifically requested for testing
+
+  * sisu control file, changes a bit arbitrary, but a bit easier
+
+  * debian control suggests keychain (added)
+
+  * summary and place of composite document source (-s -y), though just request
+    for other documents [decide later whether to include constituent document
+    parts]
+
+  * help, update, sync with man pages
+
+%% sisu_0.30.2.orig.tar.gz (2005w46/2 | 2005-11-15)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.2.orig.tar.gz
+  d0f8f7dfe1106616e3e0790c034cf190 3228007 sisu_0.30.2.orig.tar.gz
+  f953aa19d54e99a7a8d4669aaffe87ad 10130 sisu_0.30.2-1.diff.gz
+
+  * minor cleaning
+
+%% sisu_0.30.1.orig.tar.gz (2005w46/1 | 2005-11-14)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.1.orig.tar.gz
+  6367fc10883a98452d87044193338062 3227345 sisu_0.30.1.orig.tar.gz
+  59706eabd49a51394887d4ebb218cd3c 10112 sisu_0.30.1-1.diff.gz
+
+  * summary, include plain.txt where available
+
+%% sisu_0.30.0.orig.tar.gz (2005w45/7 | 2005-11-13)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.30.0.orig.tar.gz
+  2ab163fbf4a3b2ed31e14328ce69cbac 3227035 sisu_0.30.0.orig.tar.gz
+  6b0103b794fe8c6c015043b56f7770cd 10096 sisu_0.30.0-1.diff.gz
+
+  * param, polishing...
+
+  * sql metadata, reworked ... ongoing
+
+  * sisudoc, re-named sisu_doc rather than sisu_ball
+
+  * sisudoc, only -V and -M show verbose tgz of what goes in to sisudoc (previously -v did)
+
+  * name correction: SiSU is a recursive acronym, and has other 
+    alternative possible expansions, one of which i got wrong, 
+    under the influenced of the other !
+    * SiSU information Structuring Universe
+    * Simple information Structuring Universe
+    * _Structured information Serialized Units_
+    [<-- i got my last name wrong consistently wrote Serialized information
+    Structured Units, which makes less sense, (i am guessing i managed to
+    overlook this because of the position of the word structured in the first
+    and second expansion) i guess this correction calls for a major version
+    number change! hope no one (else) notices ;-) ]
+
+%% sisu_0.29.5.orig.tar.gz (2005w45/5 | 2005-11-11)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.29.5.orig.tar.gz
+  3e0ad7d2f8b02d0f3e61f113b2430269 3223938 sisu_0.29.5.orig.tar.gz
+  90a2570933de02fabd965fe8218fa354 10060 sisu_0.29.5-1.diff.gz
+
+  * for present have gone back to using pdfatex, need to spend some time to
+    figure what needs to be done for pdfetex, LaTeX headers may need to change,
+    in any event, calling it in same manner as padflatex broke pdf output, (no
+    time et to sort out)
+
+  * minor fixes, [regex match of param metadata and copyright sign in odf]
+
+%% sisu_0.29.4.orig.tar.gz (2005w45/5 | 2005-11-11)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.29.4.orig.tar.gz
+  0d47f551de9f140d6cabc84614e2b4d8 3223745 sisu_0.29.4.orig.tar.gz
+  600d5725cd8835ce4cc345a10d074ca2 10035 sisu_0.29.4-1.diff.gz
+
+  * summary, make easily available from different outputs
+
+  * metaverse, autonumbering of segments from manual text markup,
+    re-checked/re-fixed [as presents some risk must be selected in heading]
+
+  * metaverse, when run remove maintenance metaverse file unless -M flag used
+
+  * param, endnotes checking, where endnote references and endotes are separate
+    check than number count matches else report error, [and place error in
+    document summary]
+
+  * opendocument, renamed file odf
+
+  * opnedocument, added matching & linking of urls and mail address
+
+  * summary, warning of document error if endnote number mismatch, note this
+    cannot occur if the preferred markup style for endnotes is used.
+
+  * sysenv, pdfetex, debian renaming, search for pdfetex, pdftex and pdflatex
+    to generate pdf from SiSU's LaTeX output
+
+%% sisu_0.29.3.orig.tar.gz (2005w45/2 | 2005-11-07)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.29.3.orig.tar.gz
+  f4b9e6b875e9d01c1c52bfa68f1e3d56 3222790 sisu_0.29.3.orig.tar.gz
+  da61f9e61a5e5b7538c47d996b24a937 9961 sisu_0.29.3-1.diff.gz
+
+  * rsync use added for remote puts -R (scp is -r)
+
+  * summary bug fix, variable scope reduced 
+    (incorrectly retained information from previous files in batch runs)
+
+  * introduced -K which deletes output files prior to processing of files of
+    same type
+
+  * -s sisu markup source copied to output directory, (placed remotely with -sr)
+  
+  * -S sisudoc made and copied to output directory, (placed remotely with -Sr)
+    [renamed from -Z]
+  
+  * --update updates previous output, with same filetype output only, useful
+
+  * [-F renaming from -S naive cgi search form sample]
+
+  * [minor editing of program file headers]
+
+%% sisu_0.29.2.orig.tar.gz (2005w45/1 | 2005-11-07)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.29.2.orig.tar.gz
+  b8ecd141040e1ffa0820cdf9382304a7 3220476 sisu_0.29.2.orig.tar.gz
+  3d42aeb8d9648fed4baf837c59cff7a5 9899 sisu_0.29.2-1.diff.gz
+  
+  * sql table metadata created, replaces table titles
+    [breaks former table structure]
+
+  * sql urls replaces links table
+  
+  * pgsql comments
+
+  * cgi scripts use table:metadata instead of table:tiles
+
+  * xml series, poem and group (and code) first pass
+
+  * opendocument renamed odt.tgz instead of o_doc.tgz
+
+  * summary, (-y) summary of document outputs generated and document metadata
+    (metaverse includes links to summary, as does html band and latex doc info)
+
+  * data/sisu (/usr/share/sisu) created for sisu shared images and odf,
+    subdirectories, separating packages sisu from sisu-examples which is
+    recommended only, and should not be needed to provide what sisu requires.
+
+  * debian/sisu.install map data/sisu to /usr/share/sisu
+
+  * [small changes: webserv var rename; cosmetic removal in html and xml of
+    less-than greater-than on copy @ \<< home \>>]
+
+%% sisu_0.29.1.orig.tar.gz (2005w44/6 | 2005-11-05)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.29.1.orig.tar.gz
+  c2a36974bf9c9d04e3c402a01500be68 3214920 sisu_0.29.1.orig.tar.gz
+  398f1f15f798bb31679ca91cb1b400ab 9802 sisu_0.29.1-1.diff.gz
+
+  * tar gzip files changed file suffix to .tgz (instead of .gz)
+    comment added to man page and help
+
+  * html some character encoding corrections (é and a few others)
+
+  * param recognises rcs in addition to cvs and 0~rcs+ $Id$ may be used
+    [as alternative to 0~cvs equivalent, metaverse and downstream adjusted
+    accordingly]
+
+  * debian/control added suggests lv and rcs as alternative to cvs 
+    [to which it is personally preferred for document control (as making
+    more sense working with favoured used development distributed source
+    control management systems, mercurial and darcs)]
+
+%% sisu_0.29.0.orig.tar.gz (2005w44/1 | 2005-10-31)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.29.0.orig.tar.gz
+  a1658902d929eee564c77f061568a677 3214113 sisu_0.29.0.orig.tar.gz
+  fc3c5c566c307636d23467476d38b5bf 9732 sisu_0.29.0-1.diff.gz
+
+  * metaverse autonumbering changed, 
+    affecting default html segment naming
+    [change to metaverse affects downstream processing]
+
+%% sisu_0.28.4.orig.tar.gz (2005w44/1 | 2005-10-31)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.28.4.orig.tar.gz
+  f3f00e850a17d2fbfbffadf8a0d6ef5d 3213380 sisu_0.28.4.orig.tar.gz
+  e9e5a3f5a1ed1065b2c02b15d630a213 9718 sisu_0.28.4-1.diff.gz
+
+  * opendocument -o now defaults to produce metaverse first -mo
+    (this is behaviour for other outupts such as html, latex/pdf...)
+
+  * metaverse footnote url matches, tuning
+
+  * texpdf url matches, tuning, especially footnotes
+
+  * help update of processing flags, checked against man pages
+
+  * some changes to variable names, cf instead of rf (also used pf briefly)
+
+  * debian control file, minor edit of description of SiSU
+
+  * doc/overview.txt update on things not done in list
+
+%% sisu_0.28.3.orig.tar.gz (2005w42/7 | 2005-10-23)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.28.3.orig.tar.gz
+  144e450c59d99c9baa24e1f265e19182 3212941 sisu_0.28.3.orig.tar.gz
+  bf0ecc4e8a2378acfadee2158005a500 9669 sisu_0.28.3-1.diff.gz
+
+  * metaverse, bullets accidentally removed, and put back
+
+%% sisu_0.28.2.orig.tar.gz (2005w42/6 | 2005-10-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.28.2.orig.tar.gz
+  ae92bc6a14600a15f4bfbe5512bf9af2 3213202 sisu_0.28.2.orig.tar.gz
+  ee23f7ac2122521fe4d802e023921a7f 9644 sisu_0.28.2-1.diff.gz
+
+  * texpdf character encoding bugfix, (removed iconv) however, 
+    sisu requires utf-8 input for extended character sets
+
+  * character encoding touches, e.g. sample files saved as utf-8
+
+%% sisu_0.28.1.orig.tar.gz (2005w42/6 | 2005-10-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.28.1.orig.tar.gz
+  e672ccc483cf48fed084bfce99f87b8d 3212728 sisu_0.28.1.orig.tar.gz
+   dbe154e00f8421a2f05c67a11c2e7cbc 9618 sisu_0.28.1-1.diff.gz
+
+  * character encoding, moved a basic transform to metaverse,
+    hopefully more predictable characters to deal with and
+    made easier to work with postgresql, affects other modules
+    changes to html and texpdf, neither perfect, both need work
+    esp. html. two steps forward one step back
+
+  * some database operations visited, (update)
+
+%% sisu_0.28.0.orig.tar.gz (2005w42/5 | 2005-10-21)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.28.0.orig.tar.gz
+  12064bd92864441ab8b103f094412c2f 3210000 sisu_0.28.0.orig.tar.gz
+  22c5452ca4a060ddbb4bcb768a4bd119 9600 sisu_0.28.0-1.diff.gz
+
+  Release (and version number bump) primarily to put ruby sisu segfault 
+  bug behind us, Debian ruby-1.8.3-2 released and fixes this
+  [an emergency build to work around the problem was made available as 
+  0.27.0 see note there for details]
+
+  * remote placement of open document files added (odt)
+
+  * added open document format to several default shortcuts sisu -2 etc.
+
+  * made note of opendocument format output on sisu home page 
+    [feature not complete]
+
+  * synced skin_sisu.rb files, (there are a bit too many of them,    most would normally be syslinks)
+
+%% sisu_0.26.4.orig.tar.gz (2005w42/2 | 2005-10-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.26.4.orig.tar.gz
+  6cd9d7bcb42a48a7475d6bd724b766be 3202069 sisu_0.26.4.orig.tar.gz
+  5f0a0dec3a5819f2e266581d912255ad 9499 sisu_0.26.4-1.diff.gz
+
+  * sisu file format flag moved to -Z (from -B)
+
+    * sisu -Z without [filename/wildcard] makes gzip of sisu directory of
+      marked up files, including sisu markup source files, local configuration
+      file, images and skins.
+    
+    * sisu -Z [filename/wildcard] makes gzip of individual sisu file specified
+      including sisu markup source file and related images and skin
+
+  * opendocument format, -o, experimental, incomplete, [ignore]
+
+    done:
+      headings
+      footnotes
+      bold underscore italics strikethrough
+      superscript subscript
+      extended ascii set
+      indents
+      groups
+        tables
+        poem
+         code
+      
+      todo:
+        groups
+          tables
+        images
+        bullet
+        line break?
+        page break?
+        table of contents
+        page header/footer?
+
+   * debian build (i) recommends sqlite added, overlooked previously;
+     (ii) added recommend zip, used in the making of open document;
+     (iii) removed recommended incorrect libcgi_ruby. libfcgi-ruby1.8, remains;
+     (iv) have added a basic open document file structure as a tgz file.
+
+%% sisu_0.26.3.orig.tar.gz (2005w40/5 | 2005-10-07)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.26.3.orig.tar.gz
+  309cbdc9b2ab048a670ca9301aaeee87 3183245 sisu_0.26.3.orig.tar.gz
+  3dc4a9587427db4819a10958c4adde5c 9342 sisu_0.26.3-1.diff.gz
+
+  * a sisu file format introduced:, -B, a gzipped file, containing:
+      sisu markup sourcefile,
+      its images
+      and its skins,
+    opens as sisu_ball directory, which once unipped sisu may be run within,
+    (sisu does not at present automatically unpack and run on these files, 
+    but is a convenient way of packing the contents of a file for sending)
+    [early days]
+
+  * man1/sisu.1 upadated and html on -B sisu file format (sisu help not yet done)
+
+  * cosmetic firefox taken from list of lightweight browsers, 
+    remains very much amongst the heavies
+
+  * cosmetic correction on info related to librmagick-ruby contained within
+    sample document free_culture
+
+%% sisu_0.26.2.orig.tar.gz (2005w39/5 | 2005-09-30)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.26.2.orig.tar.gz
+  2b5f2c65088a6f95303c2b99d5033386 3179769 sisu_0.26.2.orig.tar.gz
+  9d2aa597a50af0608c382e6f52f8a873 9322 sisu_0.26.2-1.diff.gz
+
+  * css, minor, caption - display: inline;
+
+  * syntax highlighting (sisu markup), editor configuration files, added, see
+    sisu-examples/config/syntax_hi/README
+    /usr/share/sisu-examples/sisu-examples/config/syntax_hi/README
+
+    for the editors:
+    * nano        http://www.nano-editor.org/
+    * diakonos    http://purepistos.net/diakonos/
+    
+    NOT REALLY DONE, but intitial attempt included anyway:
+    * nedit       http://www.nedit.org/
+    * gedit       http://www.gnome.org/projects/gedit
+    * kate        http://kate.kde.org
+    * emacs       http://www.gnu.org/software/emacs/emacs.html
+
+    [vim-sisu still provides the most comprehensive sisu markup 
+    editor environment]
+  
+  * evince becomes the default pdf in maintenance urls etc. (previous was xpdf)
+
+  * document samples image dimensions manually provided, affected document
+    sample "Free Culture", Lawrence Lessig. Note this is not necessary from
+    sisu-0.20.0 onwards, if you have rubymagick installed.
+
+WARNING ruby 1.8.3 (2005-09-21) [i486-linux] segfaults SiSU
+FIXED in 1.8.3 (2005-09-29) [i486-linux] thank you TS/Guy Decoux
+the new ruby build is not as yet uploaded to Debian unstale
+
+%% sisu_0.27.0.orig.tar.gz (2005w39/1 | 2005-09-26)       %% Emergency Release: 
+
+NOTE: this is an emergency version of SiSU that does not segfault with
+problem versions of ruby, see note follwing. It is prepared without Syck/Yaml
+
+Problem ruby versions:
+* ruby 1.8.3 (2005-09-21) and was removed by TS:Guy in ruby 1.8.3 (2005-09-29), 
+  released as Debian unstable ruby-1.8.2-1, and in
+* ruby 1.8.3 (2005-10-12) and was again removed by TS:Guy in ruby 1.8.3 (2005-10-13).
+
+  * Temporary Emergency Release
+    ruby 1.8.3 (2005-09-21) [i486-linux]] segfaults sisu
+    bug report made to ruby-core 2005-09-24
+
+    this version of sisu built without Syck/Yaml
+    and is not configurable, (uses sisu default configuration only)
+    ignoring yaml user config files
+
+    as such this emergency release:
+    * only uses sisu default configuration settings, 
+      ignoring yaml user config files
+    * does not provide sisu version information
+
+%% sisu_0.26.1.orig.tar.gz (2005w37/7 | 2005-09-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.26.1.orig.tar.gz
+  a6e020a9932d972cc92a8abdcb704238 3156526 sisu_0.26.1.orig.tar.gz
+  4cbe9d5240b03eea9fc6392ebb2aca46 9304 sisu_0.26.1-1.diff.gz
+
+  * pruning, removed words.rb (vocab is used)
+
+  * wmap & vocabulary, minor modifications, and runs metaverse
+
+  * minor pruning and renaming, small changes 
+
+%% sisu_0.26.0.orig.tar.gz (2005w37/7 | 2005-09-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.26.0.orig.tar.gz
+  4d1702c6cb8f162f4c7ece7a236148c6 3159698 sisu_0.26.0.orig.tar.gz
+  99f922789101f388cf3a7562ec2953c5 9293 sisu_0.26.0-1.diff.gz
+
+  * sisu_webrick server no longer builds url paths with tilde prefix
+
+  * sysenv, and link urls updated accordingly
+
+  * sisu-examples, cgi sql search form, minor updates
+    sqlite sample set for webrick server defaults, port 8081, with url suffixes
+    pgsql sample set without (port is default port, and no url suffixes)
+
+  * sisu_webrick server defaults must be changed in rc files, rather than by
+    command-line parameters (reason, the rest of sisu would not see command
+    line parameter changes, and would continue to provide rc details)
+
+  * start enforcing lower case sisu markup tagging
+
+%% sisu_0.25.11.orig.tar.gz (2005w37/6 | 2005-09-17)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.11.orig.tar.gz
+  5330033ca4c32a20424b212d5e15705e 3158745 sisu_0.25.11.orig.tar.gz
+  bdd533301ed392ec7c27f1e364dc8388 sisu_0.25.11-1.diff.gz
+
+  * cgi, cgi sql search form sample generator, link suffixes added
+  
+  * cgi, cgi sql search form sample generator, -S takes additional parameter
+    webrick to provide port links that webrick server will use.
+
+  * sisu_webrick, -W does cgi form.
+
+  * sisu_skin & defaults, home page, adjustments
+
+  * html output (tune), fix image, no link where non provided, i.e. where the
+    { imagename.png }image notation is used
+  
+  * html output (css & tune), image caption, smaller font
+
+  * configure, (-C & -CC) absence of trang is only reported 
+    if -V (extra verbose) flag is used
+
+  * processing remote urls, (-C & -CC) absence of external_images is only
+    reported if -V (extra verbose), is used [re-test]
+
+  * man page, man sisu, updated to include "-S webrick"
+
+%% sisu_0.25.10.orig.tar.gz (2005w37/5 | 2005-09-15)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.10.orig.tar.gz
+  1b7fa60d23869d33f5d918d5aa1cf424 3157417 sisu_0.25.10.orig.tar.gz
+  9d4b75bde3f0f138d1e4d31b7964d374 9262 sisu_0.25.10-1.diff.gz
+
+  * urls, minor correction (maintenance mode output)
+
+  * man sisu(1) and sisu(8), minor edits
+
+  * minor code cleaning
+
+%% sisu_0.25.9.orig.tar.gz (2005w37/3 | 2005-09-14)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.9.orig.tar.gz
+  48249bcd13900d9d68519585a3e825f6 3162000 sisu_0.25.9.orig.tar.gz
+  2c74d1288dea0c604603185ae71a4421 9247 sisu_0.25.9-1.diff.gz
+
+  * latex/pdf, librmagick-ruby: will throw a warning and refuse to build
+    latex/pdf output for documents that are marked up without image dimensions,
+    that require the librmagick library. [librmagick-ruby is not "required" as
+    provided documents are marked up accordingly, it is never needed. As an
+    example first image markup form requires the library, the second does not:
+    { freeculture01.png }http://www.free-culture.cc/ 
+    {freeculture01.png 350x350 }http://www.free-culture.cc/
+
+  * man pages additions, mostly "man 8 sisu"
+
+%% sisu_0.25.8.orig.tar.gz (2005w37/3 | 2005-09-14)       [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.8.orig.tar.gz
+  bd8edf228360f3f3795812c93edfee19 3159743 sisu_0.25.8.orig.tar.gz
+  17b662d3d2e7f1881c7eebecb6dca192 9232 sisu_0.25.8-1.diff.gz
+
+  * metaverse, default is to run metaverse wherever it may be required, 
+    i.e. when any of - abDdeHhINptXxz
+
+  * plaintext, endnotes version (-e) sorted, 
+   -a (footnotes following paragraphs) is ok
+   [however is currently an either or, both output plain.txt]
+
+  * texinfo, basic output working again (with pinfo).
+    [fix later, moving of & to <=and>]
+
+  * debian, recommends, added pinfo
+
+  * help, fix help on markup \ escape character (escaped)
+
+%% sisu_0.25.7.orig.tar.gz (2005w37/2 | 2005-09-13)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.7.orig.tar.gz
+  b86531a1788f6bce8e81328760801fa3 3158773 sisu_0.25.7.orig.tar.gz
+  a2824de38545b6695eb06ea35bb73fea 9207 sisu_0.25.7-1.diff.gz
+
+  * metaverse, possibility to escape backslash (\\ to produce \) [Special
+    character escape set near complete for regular text, verify situation for
+    code blocks (code{) where characters should be treated verbatim].
+
+  * metaverse, markup, test and addition of possibility to escape contextual
+    special characters, such as asterisk (*) and exclamation mark (!), which
+    are not normally a special characters that need to be escaped, but the
+    ability to do so is useful where for example used to describe their markup
+    function as in \*{bold}* \!{emphasis}! verified others used in a similar
+    way (*!/_\^,+), either already available or also added \/{italicise}/
+    \_{underscore}_ \^{superscript}\^~{ note that the caret (\^) is a special
+    character that must always be escaped, unlike the other characters
+    described here which are contextual }~ \,{subscript}, \+{inserted}+
+    \-{strikethrough}-
+
+  * man page and help, comments added on escaping special characters and
+    headers
+
+  [extensive testing escaping the full range of special characters is necessary
+  these include \\ \< \> \{ \} and the contextual  * ! / _ \^ , + ]
+
+%% sisu_0.25.6.orig.tar.gz (2005w37/1 | 2005-09-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.6.orig.tar.gz
+  c0b6aa1a71a4d139d65c43fb2d21b8b0 3156969 sisu_0.25.6.orig.tar.gz
+  283c663e1b3e7803217d80709dcc7b73 9186 sisu_0.25.6-1.diff.gz
+
+  * metaverse, cosmetic corrections related to bold, italics and punctuation
+
+  * metaverse, and add a few language settings
+
+  * latex/pdf start looking at language settings, set language selected for
+    document \documentclass \usepackage \selectlanguage
+
+  * latex/pdf creator copymark turned off by adding minus sign to creator
+    header, as in 0~creator- [name of author]
+
+  * man pages, help files updated on language settings
+
+  * copyright SiSU system, object numbering etc. in pdfs, (reduced font size &
+    words from previous Debian release, [a bit more than in 0.25.5])
+
+%% sisu_0.25.5.orig.tar.gz (2005w37/1 | 2005-09-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.5.orig.tar.gz
+  dadf9ffb77c629189be5f08345f451cf 3154083 sisu_0.25.5.orig.tar.gz
+  7749d8a2a4ed73e9f0d85e5fae5d9027 9178 sisu_0.25.5-1.diff.gz
+
+  * latex/pdf cosmetic reduced size of font related to document 
+    processing information.
+
+%% sisu_0.25.4.orig.tar.gz (2005w37/1 | 2005-09-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.4.orig.tar.gz
+  b2bd5bd90ebb3af821f7b60a03cfecaa 3153879 sisu_0.25.4.orig.tar.gz
+  894ed52890f238a8feab48e80e86aae8 9166 sisu_0.25.4-1.diff.gz
+
+  * metaverse, fix related to 0.25.3 (interaction between operation of
+    bold lines and bold words selected in header).
+
+%% sisu_0.25.3.orig.tar.gz (2005w37/1 | 2005-09-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.3.orig.tar.gz
+  079f2c259f8de88e48ce16a6b0eed242 3153671 sisu_0.25.3.orig.tar.gz
+  1388f9f6183f76b49aa52ccef26bc5bc 9153 sisu_0.25.3-1.diff.gz
+
+  * metaverse, subtle correction todo with interaction between operation of
+    bold lines and bold words selected in header.
+
+  * changes to text accompanying latex/pdfs, toning down of language, 
+    correction of gpl2 url to fsf.org rather than gnu.org
+
+%% sisu_0.25.2.orig.tar.gz (2005w36/6 | 2005-09-10)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.2.orig.tar.gz
+  de5b7c20ec8e793d131c0f7665a1447a 3153602 sisu_0.25.2.orig.tar.gz
+  e46bcf337617273e1ef715010c0a7542 9134 sisu_0.25.2-1.diff.gz
+
+  * latex/pdf fix, produce text without object numbers
+    (problem with documents including grouped text markers, poem{ etc.)
+    fix affects processing with the -0 flag (zero), e.g.
+      sisu -mHp0v [filename].s3
+
+%% sisu_0.25.1.orig.tar.gz (2005w36/6 | 2005-09-10)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.1.orig.tar.gz
+  a82d3a227babf3bc1a6660fafba17ecc 3153326 sisu_0.25.1.orig.tar.gz
+  5df9ff95789c457566e0fc822449f1ef 9122 sisu_0.25.1-1.diff.gz
+
+  * cgi search for generator: fix, removal of an errant line of code
+    (removal of hardlink to version number)
+    fix affects
+      sisu -S
+
+%% sisu_0.25.0.orig.tar.gz (2005w36/6 | 2005-09-10)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.25.0.orig.tar.gz
+  15d88f5a33da7f3cb427e5a8a0dae573 3153121 sisu_0.25.0.orig.tar.gz
+  a191b69a92500d8880b764b6c33a4957 9111 sisu_0.25.0-1.diff.gz
+
+  * db/sql: changes to database table names, cleaner
+
+  * db/sql/search: cgi search examples and cgi search sample generator modified
+    accordingly
+
+  * db/sql: recreate, creates if no existing database, instead of complaining
+    (createall complains if database exists - you may not wish to remove
+    existing)
+
+  * db/sql: replaced oid table with links table, and provide links to output files,
+    affects both pgsql and sqlite
+
+
+%% sisu_0.24.2.orig.tar.gz (2005w36/5 | 2005-09-09)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.24.2.orig.tar.gz
+  924f791aa2ab18e3917451ff09183a3b 3152290 sisu_0.24.2.orig.tar.gz
+  cbbfdde8fd261b1bfdd47f633c895222 9093 sisu_0.24.2-1.diff.gz
+
+  * character encoding, existing table hash replaced with a KirbyBase table
+    character encoding lib is not currently used by sisu, 
+    (& KirbyBase is not included with sisu), for what it is see
+      http://www.netpromi.com/kirbybase_ruby.html )
+    hoever, this is a possible way forward should such a table be needed
+
+%% sisu_0.24.1.orig.tar.gz (2005w36/4 | 2005-09-08)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.24.1.orig.tar.gz
+  328d2c858900bca8594aaf9fdad48687 3154040 sisu_0.24.1.orig.tar.gz
+  2a8e982a69c58ea39a82c3c1e849fcc3 9083 sisu_0.24.1-1.diff.gz
+
+  * latex/pdf fix: tilde may be printed if marked up as escaped character
+    has been a problem, (revisit, refactor what is done with tilde)
+
+  * escaping sisu special characters a bit of work done, html latex/pdf 
+    done { } ~ < > _ - / # | : ! ^ examine need for others such as *
+
+  * latex/pdf, also html, bugfix, a bit of work on escaping of sisu special
+   characters, html latex/pdf, done \{ \} \~ \< \> \&.  Several characters are
+   only special characters in given particular locations or combinations, these
+   should be escapable in any event.  Further testing and work necessary, hash
+   is still a problem. { } ~ < > _ - / & | : ! ^ #
+
+  * metaverse_syntax, in code mode special characters should not be escaped
+
+    code{
+
+      { } ~ < > _ - / & | : ! ^ #
+      $ & @ *
+
+    }code
+
+    test more extensively, and correct over time. Note that the hash is for the
+    moment a problem (in latex/pdf)
+
+  * latex/pdf and other files make sure headers are only given special
+   treatment if at start of text, i.e. if actually headers, so can have a
+   description of a header within text like 0\~level new=1,2,3; break=4
+
+%% sisu_0.24.0.orig.tar.gz (2005w36/3 | 2005-09-07)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.24.0.orig.tar.gz
+  2270344926ff777132f50dbba0270c11 3153987 sisu_0.24.0.orig.tar.gz
+  f0bc72f3a3f07984113d7dd21ba7afae 9071 sisu_0.24.0-1.diff.gz
+
+  * pdf page breaks, accepts header notation:
+    0~level new=1,2,3; break=4
+
+  * html fix to links band -H added .html to home url, removed
+
+  * metaverse_syntax, adjustment to lines parsed, (result affects some endnotes)
+
+  * plaintext small fix &amp; is &
+
+  * minor touches to documentation
+
+  * tested supported encodings utf8 and iso8859
+
+  % sisu_0.23.1.orig.tar.gz (2005w36/3 | 2005-09-07)
+  http://www.jus.uio.no/sisu/pkg/src/sisu_0.23.1.orig.tar.gz
+    6182d22f7f4e00a3f224a5362717431a 3151165 sisu_0.23.1.orig.tar.gz
+    6a52b9dd5ce21d46cf365da088d1f334 9063 sisu_0.23.1-1.diff.gz
+
+  * fix to the still very naive sqlite search cgi example for sqlite
+
+  * sisu -S will generate a copy of the naive sqlite and pgsql cgi search form
+    it then needs to be copied to the cgi-bin directory. It differs from the
+    example given in that it looks at output directories and includes them as
+    database options. It is more accurate on sqlite, checking that a database
+    exists, however both forms in their current form leave a lot to be desired.
+
+  * url to location of sqlite database
+
+  * latex/pdf cosmetic fix to front page removed angle brackets
+    << [location] >> appeared incorrectly, and looks cleaner without
+
+  % sisu_0.23.0.orig.tar.gz (2005w36/2 | 2005-09-06)
+  http://www.jus.uio.no/sisu/pkg/src/sisu_0.23.0.orig.tar.gz
+    4e8c4fd6e8d377d4e5af7145c37ac99a 3131414 sisu_0.23.0.orig.tar.gz
+    f7e8ecb953b39ae45772130d54b158b3 9020 sisu_0.23.0-1.diff.gz
+
+  * texpdf, utf8 added properly by way of ucs package (now requires latex-ucs)
+    breaks some things but in the long run is hopefully an improvement
+    currently supported encodings utf8 and iso8859.
+    
+    Resulting in out of the box improved Iñtërnâtiônàlizætiøn a slightly more
+    extended character set, using utf-8, [ tested so far on LaTeX / pdf output,
+    line-breaking is not perfect ] ! # $ % & \ () * + , - .  / ' 1 2 3 4 5 6 7
+    8 9 : ; < = > ? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ]
+    … † ‡ < - ~ t ¡ ¢ £ ¤ ¥ ¦ § ¨ © ª « ¬  ® ¯ ° ± ² ³ ' µ ¶ · ¸ ¹ º » ¼ ½ ¾ ¿
+    À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ð Ñ Ò Ó Ô Õ Ö × Ø Ù Ú Û Ü Ý Þ ß à á â ã ä å
+    æ ç è é ê ë ì í î ï ð ñ ò ó ô õ ö ÷ ø ù ú û ü ý þ ÿ 
+
+  * character encoding, utf-8 improved basic table, not yet utilised though,
+    [and even as a small utf-8 table is on the large side]
+
+  * minor code play with output (webserve) path
+  
+  * sqlite db output mapped to webserve path, current directory stub
+    [instead of being deposited in pwd]
+
+  * very naive sqlite search cgi example for sqlite
+
+  * metaverse, changes to automatic naming of levels 5 & 6
+    same methods used as has been for level 4, could possibly clash at times
+    with level 4 in doc version consider implications [easy to attach somthing
+    to level 5 & 6 names]
+
+  * document digest in document information by default 
+    (previously only when cvs info also selected)
+
+  * loading of skins for inserts
+
+%% sisu_0.22.1.orig.tar.gz (2005w35/4 | 2005-09-01)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.22.1.orig.tar.gz
+  bd05b8766c923fefe62194ccfb851e40 3106333 sisu_0.22.1.orig.tar.gz
+  a3c3f1369d34c477db9422de98ed7306 8955 sisu_0.22.1-1.diff.gz
+
+  * metaverse, regex fix for bold line syntax (^!_)
+
+  * latex/pdf, placement of object numbers re-sorted,
+    an inelegant fix, revisit later.
+
+%% sisu_0.22.0.orig.tar.gz (2005w35/3 | 2005-08-31)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.22.0.orig.tar.gz
+  7a9d78e29a2809767f5510ec8958155d 3105938 sisu_0.22.0.orig.tar.gz
+  9b7babcf4278dc69a94ec7b9f00609e0 8936 sisu_0.22.0-1.diff.gz
+
+  * sysenv, option to check load path and only load module if available reduce
+    dependency on other packages, introduced for rmagick and now used also for
+    dbi.
+
+  * rmagick if installed can be used to calculate image dimensions, so these 
+    need not be provided in markup.
+
+  * sql database operations only attempted if dbi is loaded(/available for
+    loading)
+
+  * texpdf, used parskip and removed use of smallskip from latex output
+    (& other minor edits)
+
+  * FSF address updated:
+      Free Software Foundation, Inc.,
+      51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA
+        [from: 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA]
+
+%% sisu_0.21.2.orig.tar.gz (2005w34/7 | 2005-08-28)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.21.2.orig.tar.gz
+  b6deafd5e3627851a11b3865c7b54a36 3104604 sisu_0.21.2.orig.tar.gz
+  db780c3273a6a6dd3b488dc1ee70cf82 8882 sisu_0.21.2-1.diff.gz
+
+  * sisu-examples sisu_search.cgi sample correction
+
+%% sisu_0.21.1.orig.tar.gz (2005w34/7 | 2005-08-28)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.21.1.orig.tar.gz
+  df503b6de6a98cca07c010ead14c8083 3104417 sisu_0.21.1.orig.tar.gz
+  4ce92696c4eb3c87434ea6c3984f3054 8870 sisu_0.21.1-1.diff.gz
+
+  * debian Sources.gz
+
+  * minor code edits
+
+%% sisu_0.21.0.orig.tar.gz (2005w34/7 | 2005-08-28) [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.21.0.orig.tar.gz
+  095879ae2f0784868b9506eb09012b41 3105687 sisu_0.21.0.orig.tar.gz
+  5d0274cb2a1f0e88c22c78d03dd869da 8852 sisu_0.21.0-1.diff.gz
+
+  * changes to file structure for processing and provided images
+    now placed under the markup directory in _sisu
+    ./_sisu/processing [built by sisu] unless ./ is not writable 
+                                       then /tmp/sisu_processing
+    ./_sisu/image      [added to manually]
+    ./_sisu/config [precedence: ./_sisu/config ~/.sisu /etc/sisu]
+
+  * skin fix reading and precedence 
+    [uses ./_sisu/config/skin ~/.sisu/skin /etc/sisu/skin
+      ./_sisu/processing/external_document/skin]
+
+  * external documents, provide similar logic
+    placed in ./_sisu/processing/external_document/{image,config}
+    this should mean that along external documents are downloaded 
+    together with their skins and images and processed as a unit
+
+  * changed a couple of search path statements (skin,sisurc) to use blocks.
+
+  * sisu manpage updated to take account of changes (help not yet)
+
+%% sisu_0.20.9.orig.tar.gz (2005w34/5 | 2005-08-26)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.9.orig.tar.gz
+  0f267a8fb912193b3714ea573ccaefea 3090429 sisu_0.20.9.orig.tar.gz
+  8b46fe8954ebdfaa89c5ecb608771b6a 8832 sisu_0.20.9-1.diff.gz
+
+  * merged/rearranged (and renamed Postgresql and Sqlite classes).
+    Now SiSU_SQL (avoid possibility of namespace clashes).
+
+  * plaintext, xml (sax & dom), xhtml, run on a new file creates required
+    output sub-directory, it was relying on other selections for directory
+    creation [thought done previously] affects flags -a -x -X -b
+
+%% sisu_0.20.8.orig.tar.gz (2005w34/4 | 2005-08-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.8.orig.tar.gz
+  2fee766bb3079d7f955dbeb8c7e1c9dd 3089931 sisu_0.20.8.orig.tar.gz
+  6505b8ad8e6ccdc73676a61b25a466a2 8815 sisu_0.20.8-1.diff.gz
+
+  * minor database rationalisation, 
+    postgresql & sqlite logic in same files
+    [additional testing required]
+
+%% sisu_0.20.7.orig.tar.gz (2005w34/3 | 2005-08-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.7.orig.tar.gz
+  1fe53caf785a25d4a59ffb05e7c9c3aa 3098483 sisu_0.20.7.orig.tar.gz
+  914f8a07adb73f761c42e4c914abd3b2 8799 sisu_0.20.7-1.diff.gz
+
+  * added metadata categories (to the Dublin Core 15) added the following metatags, which seemed appropriate/useful:
+      translator (or translated_by)
+      illustrator (or illustrated_by)
+      prepared_by
+      digitized_by
+    (added to parameters, metaverse, sql databases)
+
+  * note in man pages and help about sisu markup files being in
+    UNIX ASCII
+
+  * vim auto-conversion to UNIX ASCII for sisu markup files
+    (sisu parses unix ascii, not dos ascii ... consider further, 
+    an issue for example with many(most/all?) Project Gutenberg texts)
+
+%% sisu_0.20.6.orig.tar.gz (2005w34/1 | 2005-08-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.6.orig.tar.gz
+  8e50493f947b6c1e0ed77bb1fb4e8ede 3096291 sisu_0.20.6.orig.tar.gz
+  0636fedf8a38e0cb62dbdf7c0ad9397f 8778 sisu_0.20.6-1.diff.gz
+
+  * (composite) fix for new header links where linbreak used 
+    and imported into composite document, result in .t? suffix
+
+  * (sisu_search.cgi) sample search form, minor fixes &
+    improvements, still a mess
+
+%% sisu_0.20.5.orig.tar.gz (2005w33/5 | 2005-08-19)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.5.orig.tar.gz
+  1df854fd95731c9272c89c62b06ce70a 3095741 sisu_0.20.5.orig.tar.gz
+  31d98e13292c9ab21b77f77bd4e769df 8763 sisu_0.20.5-1.diff.gz
+
+  * fix for old style header links, (broken in 0.20.4 with
+    introduction of new)
+
+%% sisu_0.20.4.orig.tar.gz (2005w33/4 | 2005-08-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.4.orig.tar.gz
+  c65c974dbdef638014c578c8a06d4560 3095378 sisu_0.20.4.orig.tar.gz
+  bca68a13d322deee67a4e20730c55acb 8741 sisu_0.20.4-1.diff.gz
+
+  * (param) header links notation made similar to links within text 
+    old markup syntax remains possible, (i.e. backward compatibility kept)
+    [should possibly force version number change to 0.21 but is minor change]
+
+  * small touch to sisu vim syntax file, remove false positive error
+    highlighting for alternative links markup
+
+  * touch to remove relevance of whitespace in image markup 
+    (previously a problem in composite texts for latex/pdf output)
+
+  * (metaverse for html) touch, whitespace reintroduced where name is given to
+    an object as easy solution to interference that may otherwise arise with
+    urls
+
+  * html touch whitespace reintroduced where name is given to an object 
+    as easy solution to interference that may otherwise arise with urls
+
+  * ruby-libyaml removed from debian control,
+    [a DD had informed me that he had neeeded it early in packaging days he
+    must have been working with a version of ruby older than sisu is written
+    for]
+
+%% sisu_0.20.3.orig.tar.gz (2005w32/7 | 2005-08-14) [Debian Release snapshot, uploaded by Wookey]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.3.orig.tar.gz
+  0a1b40b4c00ab6a7b4c9528b0664cba5 3094654 sisu_0.20.3.orig.tar.gz
+  aea0778abd99cd1f301d059fe83c81e4 8653 sisu_0.20.3-1.diff.gz
+
+  * fix sisu -CC removed attempt to create pg db
+    (this is done rather on -D createall request if does not exist)
+
+%% sisu_0.20.2.orig.tar.gz (2005w32/7 | 2005-08-14)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.2.orig.tar.gz
+  56c7a77c9a78f12cd132e06234ded543 3094356 sisu_0.20.2.orig.tar.gz
+  774b095fc376f4decde435fd6d32fbc2 8631 sisu_0.20.2-1.diff.gz
+  
+  * sisu_vim manpage
+
+  * latex/pdf monospace font (ttfamily) where code{ }code is used
+
+  * html monospace font where code{ }code is used
+
+  * rescue and attempt to create pg db only if db of pg type requested
+
+  * a rule for stripping deleted text from clean text md5 digest introcued
+
+  * debian signing of package against ralph@amissah.com
+
+%% sisu_0.20.1.orig.tar.gz (2005w32/5 | 2005-08-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.1.orig.tar.gz
+  1cdbe3739722c877af1095135a7a6f9e 3089912 sisu_0.20.1.orig.tar.gz
+  90e8a6ac6a1c868d8f7138c8974b2611 8588 sisu_0.20.1-1.diff.gz
+  
+  * console output XML clutter reduced, 
+    REXML parsed headers now only produced for -V not -v
+
+  * debian package, started signing dsc and changes file
+    both email addresses ralph@amissah.com and ralph.amissah@gmail.com
+    on ring, singing ended up being done against latter, 
+    the former being what debian knows me as, correct on next signing
+
+    Key fingerprint = F899 5A87 C648 3F38 5107  79F1 B97B 7C4D BD76 E77F
+
+-----BEGIN PGP PUBLIC KEY BLOCK-----
+Version: GnuPG v1.4.1 (GNU/Linux)
+
+mQGiBEL8fs4RBADNNhIsG6i13rDL4JLTgqy0fzcx8oJ9E/xDKeQo/5pqs18FvyKo
+VsHdkUrPptZgxowalPi2aWvZgdi56yUFt295pNedMNXfTnwkVF/9PSA3r4OTBFWw
+7NJYRUu2ZaSqtj3LpnBhsPpDqcl2g5Mry88mMLUeWB9OtsZE/QFVnoJqawCg4QSY
+IOtgdxZVJfibHbFA0/2iG3cD/A98l/BuRWF+kwNacj1q+D0glC/u9mvg56fnAzTL
+Osbhza/ebqvPgtFpP4PlIuvTcRZ9QsSJgmCTxNRPSKWPGqDmj7B7MDcPKUyJAPKB
+fSLm5v5BuKTCLl9jyihbOqIdTgF1hoBHxTyfYWpVVuhdFP1kahityDNGpRhSfTif
+doDLBACkB090RwyYBR589CMjF4miOo5m29ooQZO3tkR+6w5ny81H+qIHVx3TQZa9
+d2166YcxMOFLh2mXBcVNsF8gQpv8Otk+Oyu5FFKqJiGV6JkEPf/W+iXMdpvTrxtc
+rmU8cKagKxxBjue8PlI6bGusEjJXgmsTwOZB5WxCW4QQs49VoLQhUmFscGggQW1p
+c3NhaCA8cmFscGhAYW1pc3NhaC5jb20+iGQEExECACQFAkL8fs4CGwMFCQPCZwAG
+CwkIBwMCAxUCAwMWAgECHgECF4AACgkQuXt8Tb1253+R+gCg3KfzSGEmdWf01ryr
+QLm35LutXS8AoNVfXb3OB1BMph6bOSNJpIyZAOgstCdSYWxwaCBBbWlzc2FoIDxy
+YWxwaC5hbWlzc2FoQGdtYWlsLmNvbT6IZAQTEQIAJAUCQvyEaAIbAwUJA8JnAAYL
+CQgHAwIDFQIDAxYCAQIeAQIXgAAKCRC5e3xNvXbnf12SAJ44Tuntdnqv7lAGgRes
+KMFbHSt3YgCgjXkkHqY167kvDWmxrdAfupv7Ad65Ag0EQvx+2RAIAL23ShZnJJi/
+1un84eoUoQ/AaXmGAhYjVlYiJzMjTXBygS12TnpNkqibnnIqbn/6v1WFIgZNRhzS
+GzKo//MYtORdhB25UYe0YeOhZhyABLNSFKCye1ACBfDpJAFzc+kh7GjA1k2hnDsn
+zox49eJyubO1FxiXXYrKaSMOGkuhp/JaLEVHZZyY++Zq0TuS8t3bOmNkUbL5X5oZ
+n600yZzNfdQ8/5LjwIUvY9BDR+tHyypGyegDDmS5BVEjmW2d9ujDbVYRY6twA0q6
+6WSx2WqT/HzdvSirEiPp3ENwQAaTnGT0G5q2zmYtutb9Yd/V/5aQBMEkAXF/JT4H
+uw5ad3C6xNcAAwUH/jmC7wmvfA6Dqh9TfqDux9LzWbIny0NsgYTsE2Bkhg8kuHgb
+PeqpOeJRFYxQkhknzW1PZZVwtxmfFgWgvukW4fqGSPWSpWDaYL91zkx2HRMBG1Nb
+YwqNOLQnolRE9z/42b/M4oyIWhd0WTi6tZt5pMvpW5Dn7tOsnU3PlNM3AAv3Bjp9
+QBki1KRjZC7PdKnQa9KSwvr4hgvvBlT4Is9131vmAZhu41Ni8UORmoq5e/lqd5O/
+0QuySo+ZJEyLQuulfK19NPALZM+fu6/3dUHAu4D27MafYdQNqY3Xks4mquQ2p95k
+OhNer8Yu7SSyBCIO/8V71UhkgyUdG7fMl0BzqPmITwQYEQIADwUCQvx+2QIbDAUJ
+A8JnAAAKCRC5e3xNvXbnfzpwAJ0ZKPoWuWrx8K/zGSIRRj7ZRbf6KgCgji13BXoF
+tJaIUHauen7hNIoUQXo=
+=6US6
+-----END PGP PUBLIC KEY BLOCK-----  
+
+%% sisu_0.20.0.orig.tar.gz (2005w32/4 | 2005-08-11)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.20.0.orig.tar.gz
+  0c0c5ef53a3dd85fcaf5912a971c3b26 3089497 sisu_0.20.0.orig.tar.gz
+  741731b3d842820cb2b427fdf1197e4a 8517 sisu_0.20.0-1.diff.gz
+  0b1ea809280f45b293cb5a9ea9453b49 8551 sisu_0.20.0-2.diff.gz
+  
+  * remap sisu psql database names to SiSU_[directory name stub]
+    instead of just [directory name stub] as this will make name collisions
+    (and accidents) with other databases, when using SiSU to creating, deleting
+    and recreating databases much less likely happening to other databases far
+    less likely.  [renaming means databases need rebuilding for use]
+
+  * (psql) have made postgresql >=8.0 the default requirement. An issue
+    showed up with sisu & postgresql 7 series and UNICODE sequences used, as
+    sisu as released is fairly new there is little incentive to maintain it
+    [however, problem would seem to indicate a lot of bug testing is required,
+    i am currently using UTF-8 locale (en_GB.UTF-8)]
+    [corrected to postgresql >=8.0.0; but is currently named posgreql-8.0]
+
+  * cgi script example updated to match SiSU_[directory name stub] convention
+    and to default to search of sisu-examples as this is a standard/common
+    directory anyone might generate (or rather ./document_samples_sisu_markup)
+
+%% sisu_0.18.8.orig.tar.gz (2005w32/3 | 2005-08-10)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.18.8.orig.tar.gz
+  aa7e128202d4e60dfa9b328888406a3d 3087797 sisu_0.18.8.orig.tar.gz
+  262edbc6bcd7b29cf70d8f3b0fd1a9cf 8404 sisu_0.18.8-1.diff.gz
+  
+  * (webrick url) console display of output text default to webrick url
+    (can be switched off in sisurc.yaml, by setting 
+    webserve,webrick_url: false)
+    however this assumes people know to start sisu_webrick
+    (it is a toss-up between advertising webrick's availability, 
+    and sticking with filesystem paths as default, may have 
+    to revert) have thought of tying webrick url output to
+    starting sisu_webrick automatically, would need to look at
+    log files and get logging off the console, else would disturb
+    other sisu console output
+    [a problem appears to be that in some browsers old cached pdf
+    is served when requested, so changes made in subsequent document
+    generation may not be displayed, consider implications]
+
+  * sisu_webrick port sysenv default set back to 8081
+    (instead of 8111, consider 8123)
+
+  * use createdb to attempt to create relevant pgsql database
+    (using stub of directory name; uses a system command and assumes user has
+    permission to create db, if user does not, and the database does not exist,
+    would not be able to proceed anyway)
+
+  * inelegant handling of "" image bug (no image) that appears
+    in a test document.
+
+  * a few urls shortend back to http://www.jus.uio.no/sisu
+    from http://www.jus.uio.no/sisu/SiSU in defaults
+
+  * minor touch to man page and help
+
+%% sisu_0.18.7.orig.tar.gz (2005w32/2 | 2005-08-09) [Debian Release snapshot, uploaded by Joachim Breitner]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.18.7.orig.tar.gz
+  ace9eb421e31f7d3f1d12ba29b00baaf 3086170 sisu_0.18.7.orig.tar.gz
+  3530196ebba2260a60bfe885ee536731 8393 sisu_0.18.7-1.diff.gz
+  
+  * some license clean up, gpl2 or later (appearing in pdf text output),
+    removed sentences referring to alternative, somehow missed in previous
+    grand cleanup sisu_0.16.24 where all document headers were cleaned, and the
+    rest i thought [apologies 0.18.7 was rebuilt to include this change, they
+    occurred in the file defaults.rb and texpdf_format.rb].
+
+  * fix -N md5 digests batch mode, garbage cleaning
+
+  * fix -N remote placement (revisit remote placement)
+
+  * sequence digests if requested follow on directly after metaverse -mN...
+
+  * html and latex/pdf so far, continue tradition of assuming that a comma (,) 
+    or full stop (.) following a url is part of a sentence, i.e. if a url
+    actually is terminated by a comma or a dot are not parsed correctly, is
+    extremely convenient, consider implications though, may need to change.
+    {~^ this ends the sentence }http://www.url.  (this would also {~^ end the
+    sentence. }http://www.url and as before the comma and stop attached to
+    these urls are part of the sentences punctuation http://www.url,
+    http://www.url.)
+
+%% sisu_0.18.6.orig.tar.gz (2005w32/1 | 2005-08-08)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.18.6.orig.tar.gz
+  0687159545781ee1caeb802fd6da9ecf 3085058 sisu_0.18.6.orig.tar.gz
+  096c5f256ecc1b38642186822c55f137 8377 sisu_0.18.6-1.diff.gz
+
+  * fixed metadata (metaverse) sourcefilename (where rc not used)
+
+  * fixed digest tree where image not found
+
+  * defaults for shortcut flags (-1v -3v etc.) set to
+    create the digest tree (-N) 
+    and to include filetype suffix (-H) as this works with webrick
+    (sisu_webrick)
+
+  * jpg image support consistently added (to existing png & jpg) gif
+    consistently removed as on cursory glance does not appear to be
+    supported by tetex, trivial to add later
+
+  man page and help mention of verbose screen output of digest tree 
+
+%% sisu_0.18.5.orig.tar.gz (2005w31/6 | 2005-08-06)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.18.5.orig.tar.gz
+  e41ba898a4514b8f951015df3a30e3e2 3084020 sisu_0.18.5.orig.tar.gz
+  4120df15adf03f14bb58d7fba068c27c 8359 sisu_0.18.5-1.diff.gz
+
+  * bugfix output paths, may change again, currently the default
+    if writable is /var/www/sisu (and if no ~/sisu_www)
+    (in previous version wrote to /var/sisu/www/sisu if writable
+    too idiosyncratic a solution)
+
+  * bugfix image markup where url not used
+    {imagename.png}image working for html and pdf again
+    {imagename.png}image fix also for pdf
+
+%% sisu_0.18.4.orig.tar.gz (2005w30/2 | 2005-07-26)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.18.4.orig.tar.gz
+  9ee3ba3a68640e060a92beb1ffd4351a 3081850 sisu_0.18.4.orig.tar.gz
+  3fabff77f7a9db7e8c47ffa6d01c5bc0 8344 sisu_0.18.4-1.diff.gz
+
+  * detailed document md5 digest output as digest.txt generated with -N flag
+    [decide whether to:
+      keep multiple document digest versions; and 
+      whether to link to html or databse
+      (at some stage add digest names to html generated)]
+
+  * added -N flag (document digests) to man pages and help
+
+  * replaced uses of include? with plain regex (some vague recollection of 
+    rumours of depreciation in future ruby)... no rush, perhaps should have
+    waited
+
+  * (re)moved use of -o flag from old table based html
+
+%% sisu_0.18.3.orig.tar.gz (2005w30/2 | 2005-07-26)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.18.3.orig.tar.gz
+  76b9a55723151f7dd08437fb9a604813 3079656 sisu_0.18.3.orig.tar.gz
+  d6ce0c7986a47436843d3a36ba000822 8322 sisu_0.18.3-1.diff.gz
+
+  * digests on clean text, rule... revisit, but body and endnotes treated "same"
+
+  * tmp fix for special image characters, (e.g. Euro and Copyleft) tmp because
+    image is taken from local directory images where ought to be taken from
+    general image set, revisit.
+
+%% sisu_0.18.2.orig.tar.gz (2005w30/1 | 2005-07-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.18.2.orig.tar.gz
+  cbb34fcf021158193c6e6f366ae9e645 3077824 sisu_0.18.2.orig.tar.gz
+  35ac35ae6872d923c3704c45aae867f4 8306 sisu_0.18.2-1.diff.gz
+
+  * document meta_data, version information re-organization
+
+  * texinfo cursory look, initial 0.18 fix
+
+  * db pg/sqlite md5_all fix for level 4
+
+  * dbi_unicode unused, and removed, (common_db used)
+
+%% sisu_0.18.1.orig.tar.gz (2005w29/0 | 2005-07-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.18.1.orig.tar.gz
+  030ba198b242541bd261ec5fb0776b0a 3086052 sisu_0.18.1.orig.tar.gz
+  6cd8c2b571c485edbe77946fe7245a14 8301 sisu_0.18.1-1.diff.gz
+
+  * latex/pdf, tmp bugfix, substitute & with 'and' in toc, 
+    needed e.g. for AT&T, see ffa, REVISIT
+
+  * a bit of play with texinfo module, but (still) broken 
+    (in 0.18) until tested
+
+  * some writing in man pages
+
+%% sisu_0.18.0.orig.tar.gz (2005w29/5 | 2005-07-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.18.0.orig.tar.gz
+  ff45f2bca98b6e8fbae0714684576571 3086151 sisu_0.18.0.orig.tar.gz
+  9f0cf2ca1b6e02aea52f9dd22e51c32d 8268 sisu_0.18.0-1.diff.gz
+
+  Development branch 0.17 (opened 2005-07-14) 
+  rolled back into main as 0.18:
+
+  sisu_0.17.5.orig.tar.gz (2005w29/5 | 2005-07-22)
+  http://www.jus.uio.no/sisu/pkg/src/sisu_0.17.5.orig.tar.gz
+    23e3b01175d55e815933881fcfe415c5 3085611 sisu_0.17.5.orig.tar.gz
+    41e800763be26bb37a8f1901a05bff08 8570 sisu_0.17.5-1.diff.gz
+  
+    * plaintext linebreaks in endnotes <br />
+  
+    * xml series, branch-fix todo with tables (common_xml)
+  
+    * html endnote section branch-fix
+  
+  sisu_0.17.4.orig.tar.gz (2005w29/4 | 2005-07-21)
+  http://www.jus.uio.no/sisu/pkg/src/sisu_0.17.4.orig.tar.gz
+    23bef7ae21ac0b65cb7b27c049f3ea15 3085478 sisu_0.17.4.orig.tar.gz
+    6542bc3d7f65440f02834de6141e74dd 8553 sisu_0.17.4-1.diff.gz
+  
+    * url maintenance mode, minor fix
+  
+    * small fixes to latex pdf mostly todo with & character
+  
+  sisu_0.17.3.orig.tar.gz (2005w29/3 | 2005-07-20)
+  http://www.jus.uio.no/sisu/pkg/src/sisu_0.17.3.orig.tar.gz
+    086b054dba3ee8837406157c74062252 3084736 sisu_0.17.3.orig.tar.gz
+    3029bdb8375586b57cec9997578d8f98 8535  sisu_0.17.3-1.diff.gz
+  
+    * md5 into postgresql and sqlite modules, (including endnotes clean md5
+      digest)
+  
+    * Implemented, but need to be consistent about content of paragraphs on which
+      md5 digest is made:
+  
+      1. clean/stripped text without any markup, paragraph, headings etc. without
+      endnotes
+  
+      2. endnotes clean/stripped text digest only (there may be several endnotes
+      within a paragraph)
+  
+      3. whole object, text with markup and any endnotes, (question: with or
+      without the endnote digests??? presumption better without, [however may be
+      easier to check with?])
+  
+    * some renaming in db modules
+  
+    [deleted accidentally and rebuilt]
+  
+  sisu_0.17.2.orig.tar.gz (2005w28/5 | 2005-07-15)
+  http://www.jus.uio.no/sisu/pkg/src/sisu_0.17.2.orig.tar.gz
+    dab5f72a55e525e3f2bac4053db57c6a 3083022 sisu_0.17.2.orig.tar.gz
+    4fad5f499da1d26d89070ce1cb26ad8d 8512 sisu_0.17.2-1.diff.gz
+  
+    * change in metaverse representation of md5 hashes
+  
+    * cleaning up of output after introduction of md5 digests
+  
+  sisu_0.17.1.orig.tar.gz (2005w28/5 | 2005-07-15)
+  http://www.jus.uio.no/sisu/pkg/src/sisu_0.17.1.orig.tar.gz
+    ed3301693f3a86535b6d7c1595c1afdf 3082665 sisu_0.17.1.orig.tar.gz
+    a3bf9b7198544ae341e0c4b397b185fd 8467 sisu_0.17.1-1.diff.gz
+  
+    * arrangement of md5s
+  
+  sisu_0.17.1.orig.tar.gz (2005w28/5 | 2005-07-15)
+  http://www.jus.uio.no/sisu/pkg/src/sisu_0.17.1.orig.tar.gz
+    *** sisu_0.17.1.orig.tar.gz
+    *** sisu_0.17.1-1.diff.gz
+  
+    * todo with use of dev branch and being 0.17 rather than 0.16
+  
+  sisu_0.17.0.orig.tar.gz (2005w28/4 | 2005-07-14)
+  http://www.jus.uio.no/sisu/pkg/src/sisu_0.17.0.orig.tar.gz
+    MD5(sisu_0.17.0.orig.tar.gz)= 46d56d54e6040170cbaad77f6764e2ca
+  
+    * incorporated two md5 digests for each object, available for use
+      downstream as desired
+  
+%% sisu_0.16.26.orig.tar.gz (2005w28/6 | 2005-07-16)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.26.orig.tar.gz
+  *** sisu_0.16.26.orig.tar.gz
+  *** sisu_0.16.26-1.diff.gz
+
+* LaTeX output remove individual /parindent placed in header
+
+%% sisu_0.16.25.orig.tar.gz (2005w28/6 | 2005-07-16) [First Debian Release, uploaded by Gunnar Wolf]
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.25.orig.tar.gz
+  *** sisu_0.16.25.orig.tar.gz
+  *** sisu_0.16.25-1.diff.gz
+
+  * sisu-examples, Free as in Freedom ... minor touch,
+    previous markup broken, will check later
+
+%% sisu_0.16.24.orig.tar.gz (2005w28/2 | 2005-07-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.24.orig.tar.gz
+  2072677c897ffa9c677b2b4760003396 3081483 sisu_0.16.24.orig.tar.gz
+  2879560a1af4f0dc27670f519cf5bd94 8211 sisu_0.16.24-1.diff.gz
+
+  * copyright string made more clear as 1997, 1998, 1999, 2000, 2001, 2002,
+    2003, 2004, 2005 ... only question being whether it should not have been
+    1996.
+
+%% sisu_0.16.23.orig.tar.gz (2005w28/2 | 2005-07-12)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.23.orig.tar.gz
+  db0052818b106e0d4c47d8039bdb8497 3081204 sisu_0.16.23.orig.tar.gz
+  f77bab59f3eb7db8ae249411f1685292 8114 sisu_0.16.23-1.diff.gz
+
+  * copyright headers changed within files for Debian
+
+  * some changes in use of ocn for segment naming in html output
+
+  * a couple of postgresql fileds changed to text
+  
+  * using Rant 4.0 for package build and install(er)
+
+  * cosmetic rearrangement of code
+
+%% sisu_0.16.22.orig.tar.gz (2005w27/4 | 2005-07-07)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.22.orig.tar.gz
+  4c290986eb68607420a602c3fae4baaf 3087090 sisu_0.16.22.orig.tar.gz
+  c925bddaee01bb7b5d5a2c241f3f75e0 8089 sisu_0.16.22-1.diff.gz
+
+  * metaverse fix for alternative endnote markup marker 
+    at end of line~^
+
+  * texpdf fix for images, (where dimensions not
+    provided) not final, may need to pass through 
+    imagemagick at metaverse stage
+
+  * fix to cgi sample sisu_search.cgi
+
+%% sisu_0.16.21.orig.tar.gz (2005w26/0 | 2005-07-03)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.21.orig.tar.gz
+  9c4a29a357d1b988a351d2f035f8f8ea 3086501 sisu_0.16.21.orig.tar.gz
+  c80c80a6a90ea037267c127796a0fde5 7956 sisu_0.16.21-1.diff.gz
+
+  * small bugfix (param screen print)
+
+%% sisu_0.16.20.orig.tar.gz (2005w26/0 | 2005-07-03)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.20.orig.tar.gz
+  df663db73934d980ba484d69a2efc361 3086090 sisu_0.16.20.orig.tar.gz
+  1aee087cb250a1fbd760ceb53fbc8c2b 7927 sisu_0.16.20-1.diff.gz
+
+  * separated out sisu vim files (syntax & folds)
+
+  * touch to syntax highlighting
+
+%% sisu_0.16.19.orig.tar.gz (2005w26/5 | 2005-07-01)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.19.orig.tar.gz
+  bf5a17871dfa7f1322bdaa774d24e4bb 3105899 sisu_0.16.19.orig.tar.gz
+  be224695722d529a481beaadecd695d3 7860 sisu_0.16.19-1.diff.gz
+
+  * small touches to vim syntax highlighting.
+
+%% sisu_0.16.18.orig.tar.gz (2005w26/5 | 2005-07-01)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.18.orig.tar.gz
+  0d6bc75f1c631a423941bd20b8cb8ea0 3105726 sisu_0.16.18.orig.tar.gz
+  2265f2449b63b2ba9af39e61a09198c9 7846 sisu_0.16.18-1.diff.gz
+
+  * some fixes to syntax highlighing: - changes to markup syntax introduced in
+    0.16 release broke parts of syntax highlighter, more no doubt to follow.
+
+%% sisu_0.16.17.orig.tar.gz (2005w26/4 | 2005-06-30)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.17.orig.tar.gz
+  410f1c01c261e2cf2bb25ff782b4c0b8 3105488 sisu_0.16.17.orig.tar.gz
+  649cbe59bf940d93a74cdac46e59123c 7774 sisu_0.16.17-1.diff.gz
+
+  * separated color file out from ftplugin ... called dusk (or slate) by 
+    me for several years i now call it sisu... perhaps i should stick 
+    with slate as it is pretty appropriate... hmmm, slate
+
+%% sisu_0.16.16.orig.tar.gz (2005w26/3 | 2005-06-29)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.16.orig.tar.gz
+  f5ce8002e6876feba22c276d4e49d3f5 3105731 sisu_0.16.16.orig.tar.gz
+  251af2096015e193888a429cd69a328d 7576 sisu_0.16.16-1.diff.gz
+
+ * small touches to offer vim config files working the way i am used to 
+   with Debian install... needs testing by someone with different 
+   habits though.
+
+%% sisu_0.16.15.orig.tar.gz (2005w26/3 | 2005-06-29)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.15.orig.tar.gz
+  4de2570843cacd2c665fa8204eaab750 3105521 sisu_0.16.15.orig.tar.gz
+  c650a78d6b079db9c021a608236a920e 7494 sisu_0.16.15-1.diff.gz
+
+* separated vim syntax and ftplugin directory...
+  have still got color file in ftplugin/sisu.vim file
+  which is not acceptable
+
+%% sisu_0.16.14.orig.tar.gz (2005w26/3 | 2005-06-29)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.14.orig.tar.gz
+  18e0cfcac265ecb03e9af5f958aad0f7 3105239 sisu_0.16.14.orig.tar.gz
+  493c64b453dc43ff36565aacacbc0b8c 7441 sisu_0.16.14-1.diff.gz
+ 
+  * sisu vim ftplugin ... for folds, syntax, colors, markup
+    auto installed in debian, 
+    (but uses shared filetype in /usr/share/vim/addons
+    check how that is supposed to work)
+    else (non-debian install)
+    Rantfile places in /usr/share/sisu-examples/config/vim
+
+%% sisu_0.16.13.orig.tar.gz (2005w26/3 | 2005-06-29)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.13.orig.tar.gz
+  775c33a1e6f0140f5552cb3f2784b00a 3124785 sisu_0.16.13.orig.tar.gz
+  04242b7e8fec91a0b4f69bd 7328 sisu_0.16.13-1.diff.gz
+ 
+  * debian setup of vim syntax ok... however much vim setup still to automate,
+    immediately noticeable: folds for sisu not sorted; and permitting cursor
+    movement up and down without following long lines with screen wrap; (and no
+    clever way yet to contribute colors other than through sisu-examples, but
+    they being user preference should be contributed with care).
+ 
+  * on_markup.txt quick check & minor update
+
+%% sisu_0.16.12.orig.tar.gz (2005w26/1 | 2005-06-27)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.12.orig.tar.gz
+  5bdff14e999ea933abdb3f3bfbbc0dcb 3119368 sisu_0.16.12.orig.tar.gz
+  5a9f5898165c74e60b6292b6e777beba 7105 sisu_0.16.12-1.diff.gz
+
+  * home page index.html creation, path precedence set:
+      ~/.sisu/skin/doc
+      /etc/sisu/skin/doc
+      defaults
+    and content is interchangeable (so future latent break 
+    is less likely)
+
+  * touch to Rantfile.
+
+%% sisu_0.16.11.orig.tar.gz (2005w26/1 | 2005-06-27)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.11.orig.tar.gz
+  b14414943ca84f66cde1f646da7a2329 3118990 sisu_0.16.11.orig.tar.gz
+  742089f905479231a32fb6b4fc62824f 7024 sisu_0.16.11-1.diff.gz
+
+  * bugfix a default variable, in defaults version should be @ver
+    introduced by cuts and pastes between different files, 
+    with recent default home page updates; make less likely to 
+    happen in future, for now quick fix, revisit: 
+    currently index.html taken from
+    ~/.sisu/skin/doc if it exists else defaults, 
+    /etc/sisu/skin/doc is ignored, breaking expected 
+    search precedence
+
+%% sisu_0.16.10.orig.tar.gz (2005w25/0 | 2005-06-26)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.10.orig.tar.gz
+  73a4f8c6ffedbee7f1a9571b5f9c25da 3118710 sisu_0.16.10.orig.tar.gz
+  d6307e6e6f42f795d31d6516f6ef48ec 6919 sisu_0.16.10-1.diff.gz
+
+  * small edits to man pages and help
+    NB have taken out reference to alternative markup possibilities
+    e.g. b{ for bold }b being available as well as
+    *{ bold text }* (as the letter the and html equivalents are
+    depreciated, having or using alternative markup styles is
+    less tidy)
+
+%% sisu_0.16.9.orig.tar.gz (2005w25/0 | 2005-06-26)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.9.orig.tar.gz
+  28615d4dcdc00d8342d2d88273f2f5a1 3118488 sisu_0.16.9.orig.tar.gz
+  00142e23bfd377bc4e1a9d7be287d108 6775 sisu_0.16.9-1.diff.gz
+
+  * cleaning up of man pages, largely for html presentation
+    generated by rman
+
+%% sisu_0.16.8.orig.tar.gz (2005w25/6 | 2005-06-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.8.orig.tar.gz
+  d050e1532def2b862843ac653010c97e 3117054 sisu_0.16.8.orig.tar.gz
+  89fb5d9a06748d1c12da98d7b947e0c9 6696 sisu_0.16.8-1.diff.gz
+
+  * minor edits
+
+%% sisu_0.16.7.orig.tar.gz (2005w25/6 | 2005-06-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.7.orig.tar.gz
+  c0afd925e862a2d149f642af6e02f231 3116725 sisu_0.16.7.orig.tar.gz
+  28093c9d63cb5cbdd4bbc9d5cca16020 6678 sisu_0.16.7-1.diff.gz
+
+  * added the man pages in html (converted to html using rman)
+    http://polyglotman.sourceforge.net/rman.html
+
+  * related rather cosmetic changes
+
+%% sisu_0.16.6.orig.tar.gz (2005w25/6 | 2005-06-25)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.6.orig.tar.gz
+  23e4aecd915e86191c8e4622cae787bb 3100364 sisu_0.16.6.orig.tar.gz
+  cf7b0f29ecaba525d0c4f875ee8ba01f 6632 sisu_0.16.6-1.diff.gz
+
+  * vim folds for sisu markup files updated
+    command is :F (ruby folds :R)
+    assuming the file is in place and in use
+
+%% sisu_0.16.5.orig.tar.gz (2005w25/5 | 2005-06-24)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.5.orig.tar.gz
+  7e7ad7b08a1e6177f6333f699a23b4bb 3099726 sisu_0.16.5.orig.tar.gz
+  8796ef31f655d9f074af00c352492653 6599 sisu_0.16.5-1.diff.gz
+
+  * some cleaning of wordmap output, regex exclusions added, not elegant
+    (special issue pages include sha and md5 output, also excluded)
+
+  * [released 0.16.6:] vim folds for sisu markup files updated
+    command is :F (ruby folds :R)
+    assuming the file is in place and in use
+
+  * comments, url locations of samples, output, etc. added to markup syntax
+    files (in addition to SiSU home which was already there)
+
+  * removed from tarball markup samples eu contract law principles
+    can be found at http://www.jus.uio.no/sisu/sample
+
+%% sisu_0.16.4.orig.tar.gz (2005w25/4 | 2005-06-23)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.4.orig.tar.gz
+  899e08a81adf3544079e61f058c76388 3125518 sisu_0.16.4.orig.tar.gz
+   2b70dde1fa067b1b03729be4c1688e2e 6379 sisu_0.16.4-1.diff.gz
+
+  * man 8 sisu post installation instructions looked at
+
+  * an image path adjusted
+
+%% sisu_0.16.3.orig.tar.gz (2005w25/4 | 2005-06-23)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.3.orig.tar.gz
+  7dc657a1299e3ff831c932eb3975293f 3124710 sisu_0.16.3.orig.tar.gz
+  93210116080bed4f22356e8ac1bba570 6324 sisu_0.16.3-1.diff.gz
+
+  * tables fixed, much latent breakage sorted 
+    html segments fixed (scroll was ok)
+    xml sax and dom sorted 
+    xml css naive but done
+    latex/pdf done
+
+%% sisu_0.16.2.orig.tar.gz (2005w25/3 | 2005-06-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.2.orig.tar.gz
+  c3306db32d485d515a4464766d3b81c8 3124314 sisu_0.16.2.orig.tar.gz
+  e82cc99b1a8a62cb1d590aa3dc65a4eb 6227 sisu_0.16.2-1.diff.gz
+
+  * conditional heading reinstated /^[12]~\?\s/
+    (may be used when it is expected that a document may be 
+    imported into another, and the controlling documents level 
+    1 and/or 2 headings should be used instead (take precedence))
+
+  * rant install options, force specification of root if wish to 
+    proceed as root, (previously was default on ok or continue)
+
+%% sisu_0.16.1.orig.tar.gz (2005w25/3 | 2005-06-22)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.1.orig.tar.gz
+  ad0220d5d7097833f404f3ffa1301525 3123961 sisu_0.16.1.orig.tar.gz
+  a7f0bf6bd77746a57f6724d3922bbf2c 6039 sisu_0.16.1-1.diff.gz
+
+  * touches to documentation, markup related
+
+  * markup syntax table is out of date, reference to it removed
+    replaced by suggestion you see online markup sample directory
+      http://www.jus.uio.no/sisu/sample
+
+  * fix, one sample document was overlooked in last package
+    (autonomy_markup2)
+
+%% sisu_0.16.0.orig.tar.gz (2005w25/2 | 2005-06-21)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.16.0.orig.tar.gz
+  d6ddb880cf0958893665ca0f0609acea 3123554 sisu_0.16.0.orig.tar.gz
+  329d30ee875d4d2be75f981a9a875457 5830 sisu_0.16.0-1.diff.gz
+
+% WARNING Syntax Changes in 0.16 break previous markup
+% WARNING Despite Move to Stable Further Testing is Required
+
+  Syntax Cleaning - reduction in characters used
+    and the removal of several uses of unclosed curly brackets
+
+% Vim Regex Substitution Summary of Markup Syntax Changes:
+    :%s/\([0-6]\){\~\?/\1\~/c
+    :%s/ #\~\(\S\+\)/\*\~\1/c
+    :%s/^#{\~\?\s*/% /c
+    :%s/^r{ /<< /c
+    :%s/\~e/\~^/c
+    :%s/[-~]{{ /^\~ /c
+
+%   sisu_0.15.0.orig.tar.gz (2005w24/0 | 2005-06-19)
+      http://www.jus.uio.no/sisu/pkg/src/sisu_0.15.0.orig.tar.gz
+      MD5(sisu_0.15.0.orig.tar.gz)= a367efb13c3dbd2757e4ba968d61a8b2
+
+  * Syntax Changes, WARNING breaks old syntax,
+    a theme is the reduction of characters,
+    and the removal of most unclosed curly braces where used previously
+
+    * to mark headers and heading levels:
+      [0-6]~ replaces [0-6]\{ and [0-6]\{~ [at the start of a line]
+      header and headings marked by digit tilde at the start of the line
+      tilde replacing unclosed curly brace occurring after digit at 
+      beginning of line
+      vim:
+        :%s/\([0-6]\){\~\?/\1\~/c
+    * to provide html name tag within text:
+      *~name replaces #~name
+      vim:
+        :%s/ #\~\(\S\+\)/\*\~\1/c
+    * a comment:
+      % replacing #{ [at the start of a line]
+      ^%% fold set in vim for such comment marker
+      vim:
+        :%s/^#{ /% /c
+    * require external document fold marker
+      << replacing r{
+      vim:
+        :%s/^r{ /<< /c
+
+    header and headings change is fairly major as affects most code
+    worth the break, i think so, given goal of simplicity and minimalism
+    however, syntax higlighting becomes even more crucial
+    as becomes more difficult to spot headings otherwise
+
+%   sisu_0.15.1.orig.tar.gz (2005w25/1 | 2005-06-20)
+      http://www.jus.uio.no/sisu/pkg/src/sisu_0.15.1.orig.tar.gz
+      MD5(sisu_0.15.1.orig.tar.gz)= d00ff37b438fe38732d887d8555dddb5
+
+  * Syntax Changes, WARNING breaks old syntax, 
+
+  * endnotes where not embedded within text, 
+    i.e. endnote following paragraph with endnote marker
+    ~^ replaces ~e as marker within text
+    ^~ for endnote content instead of -{{ or ~{{ [at the start of a line]
+    {~^ shortcut for making link with url as endnote }http://url 
+      instead of {~e previous shortcut}http://url
+    vim:
+      :%s/\~e/\~^/c
+      :%s/[-~]{{ /^\~ /c
+
+%   sisu_0.15.2.orig.tar.gz (2005w25/1 | 2005-06-20)
+      http://www.jus.uio.no/sisu/pkg/src/sisu_0.15.2.orig.tar.gz
+      MD5(sisu_0.15.2.orig.tar.gz)= c28a58664d9a5f1726ed4c5f875e8f12
+
+  * bugfix for composite documents, place newline 
+    and mark end of import 
+    (bug also in current stable 0.14.6)
+
+  * bugfix for [html] endnotes introduced (in param) 
+    in development branch
+
+  * number paragraph in given heading sequence
+    while escaping from being a heading 5~- 6~-
+
+  * filenames for termsheet and standard_form
+    sisu -t
+
+  * fix webrick port settings sysenv
+  
+  * html subtoc touch required
+
+  * help files updated on syntax changes
+  
+  * document markup samples updated
+  
+  * vim syntax files updated
+
+  * extensive testing required
+
+%% Syntax Changes in 0.16 break previous markup
+
+%% sisu_0.14.6.orig.tar.gz (2005w24/6 | 2005-06-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.14.6.orig.tar.gz
+  6c027f44470c313eaae1569a5df8cfb7 3121245 sisu_0.14.6.orig.tar.gz
+  069eafa4261ffc542172a4fc84d5fa44 4723 sisu_0.14.6-1.diff.gz
+
+  * texpdf removed whitespace around \\href{[url]} in a few locations
+    (latexpdf appears possibly to have problem in passing url to browser
+    including whitespaces before and after url)
+
+  * in all source code headers took out development branch reference,
+    leave it to the download page to keep other urls updated
+    author field Ralph Amissah, (instead of similar email address)
+    propagated alternative name 'Serialized Information, Structured Units'
+    (used earlier but not consistently)
+
+  * skin headers likewise looked at and modified
+
+  * touch to default index.html (in defaults and associated skin)
+
+  * (touch to sisu-examples description in debian control file)
+
+%% sisu_0.14.5.orig.tar.gz (2005w24/6 | 2005-06-18)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.14.5.orig.tar.gz
+  1d86c68c0e44f835aeeb2d9b89502f1d 3120463 sisu_0.14.5.orig.tar.gz
+  c3589fc3343d0503e452b846d778f9d3 4412 sisu_0.14.5-1.diff.gz
+
+  * debian build sisu suggests sisu-examples
+
+  * added reference to abandoned U.S. provisional patent application
+
+%% sisu_0.14.4.orig.tar.gz (2005w24/5 | 2005-06-17)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.14.4.orig.tar.gz
+  15ea5387b4cd88717c12c4d1a583d99d 3119833 sisu_0.14.4.orig.tar.gz
+  10961f292abd7ad47b6c072aad6f525e 4339 sisu_0.14.4-1.diff.gz
+
+  * removed copyright mark from 0{~prefix
+    is distinct from 0{~rights which is related to copyright
+
+  * texpdf - pass author through "special character" filter
+
+  * bug fix for minor numbering using # mark, and re-calibrating
+    removed an extraneous tilde (~)
+
+%% sisu_0.14.3.orig.tar.gz (2005w24/3 | 2005-06-15)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.14.3.orig.tar.gz
+  7324ba16cdf644bb560a99 3119435 sisu_0.14.3.orig.tar.gz
+  3988a9ad582121b1972a 4190 sisu_0.14.3-1.diff.gz
+
+  * removed files cgi.rb and cgi_supplies.rb as unused.
+
+%% sisu_0.14.2.orig.tar.gz (2005w24/2 | 2005-06-14)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.14.2.orig.tar.gz
+  90ab342311461a0c7b752df78e43d3b5 3121884 sisu_0.14.2.orig.tar.gz
+  257f8716e88e0a29aa6853d73520821d 3414 sisu_0.14.2-1.diff.gz
+
+  * -g option taken out, unused and forgotten 
+    -h and -H currently do what -g used to by default 
+    (will revisit)
+
+%% sisu_0.14.1.orig.tar.gz (2005w23/2 | 2005-06-14)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.14.1.orig.tar.gz
+  3c1ea0dfcf670316bd2ce49f0a4d65f8 3121529 sisu_0.14.1.orig.tar.gz
+  b87620429c979c9a85f3cf39911d9347 3463 sisu_0.14.1-1.diff.gz
+
+  * documentation related, but minor
+
+%% sisu_0.14.0.orig.tar.gz (2005w22/6 | 2005-06-04)
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.14.0.orig.tar.gz
+  a7ba5eeedad74ba6231f13c3a39535ec 3121235 sisu_0.14.0.orig.tar.gz
+  fd74f52531699370664657064aed8578 3406 sisu_0.14.0-1.diff.gz
+
+  * Flattened directory structure for ./conf/sisu which maps to /etc/sisu 
+    or equivalent i.e. removed the additional version number which is 
+    not supported by debian packaging, and unnecessary anyway. 
+    (this change is the reason for version the hop to 0.14.0)
+
+  * Changed name of ./conf/sisu/sisurc.yaml.sample_disabled, 
+    is now ./conf/sisu/sisurc.yaml
+    and enabled with some parts commented out
+
+  * Source Document Digest (using openssl and currently set to MD5) generated
+    were cvs document details requested, (request set in document header).
+
+  * Added man page summary of sisu-examples
+    (and a README for directory which refers you to man page)
+
+%% sisu_0.12.7.tar.gz (2005w22/3 | 2005-06-01 ) 
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.12.7.tar.gz 
+  MD5(sisu_0.12.7.tar.gz)= 080a45e3e94ed744cca9d0222aa0ae9b 
+  [(self inflicted) glitch with Debian build, not released together with source tarball.]
+
+  * Make SiSU convenient to use to produce other formats (including LaTeX)
+    without the software necessary to produce pdf, i.e. pdflatex
+    http://www.tug.org/applications/pdftex/
+    all this does really is recognise when pdflatex is absent
+    and pdfs cannot be generated in html generated output 
+    (i.e. no links to pdf are produced, as was previously the case
+    where pdf output was assumed)
+
+  * Removed Debian require dependency on tetex-base and tetex-extra (in which
+    pdflatex resides).
+
+%% sisu_0.12.6.orig.tar.gz (2005w21/4 | 2005-05-26 )
+http://www.jus.uio.no/sisu/pkg/src/sisu_0.12.6.orig.tar.gz
+  4cb96905865bead50d0a53c8b0f12e91 3118290 sisu_0.12.6.orig.tar.gz
+  b03f53624fa3030646c5f4e5ff020262 3379 sisu_0.12.6-1.diff.gz
+
+   * sisu_webrick default port set to 8081 (from 2000), [also considered 8111,
+     8123] [0.12.5]
+
+   * short man pages on sisu_webrick and sisu_termsheet provided [0.12.5]
+
+   * sisu_termsheet (changed name from sisu_termsheet.rb) [0.12.5]
+
+   * removed sisu-[version number] executable, is not necessary, (resulted in
+     skip from 0.12.6 from 0.12.4) [0.12.6]
+
+%% sisu_0.12.5.orig.tar.gz 
+skipped, synced tarball and deb in 0.12.6
+
+%% sisu_0.12.4.orig.tar.gz (2005w21/4 | 2005-05-26 ):
+   2ba51878d3e68ac1d268b3aa0294a2ab 3123433 sisu_0.12.4.orig.tar.gz
+   9c0309ccdce1d13946d1a74c48f07ff4 3300 sisu_0.12.4-1.diff.gz
+
+   * sisu_webrick fix, update
+
+%% sisu_0.12.3.orig.tar.gz (2005w21/3 | 2005-05-25 ):
+   ac5e82b8d2a88503d8d004bee12cd979 3123419 sisu_0.12.3.orig.tar.gz
+   db7b4401a63dea7b9f47b6ead5cf9d4a 3272 sisu_0.12.3-1.diff.gz
+
+   * updated man 8 sisu
+   
+   * updated part of interactive help in line with 'man 1 sisu' and 'man 8 sisu'
+   
+   * debian package added as required in current ubuntu at least: libyaml-ruby
+   
+   * touch to sisu_termsheet, colour fix
+
+%% sisu_0.12.2.orig.tar.gz (2005w21/1 | 2005-05-23 ):
+   65d8cc8021579e307f8c2cce31cc988 3119888 sisu_0.12.2.orig.tar.gz
+   6a13bc64be600e96366ccff0fac66344 3208 sisu_0.12.2-1.diff.gz
+
+  * changes with packaging methods (rather than sisu), and redone from 
+    scratch with new origional source
+
+  * switch from using the sha digest to md5
+
+%% sisu_0.12.1.orig.tar.gz (2005w21/1 | 2005-05-23 ):
+   2c877136005c5052921e619d435f0c91 3119846 sisu_0.12.1.orig.tar.gz
+   28e4022ff40fcfc0c5d8f6d64279ede7 3146 sisu_0.12.0-1.diff.gz
+
+  * changes with packaging methods (rather than sisu), and redone from 
+    scratch with new original source
+
+  * switch from using the sha digest to md5
+
+%% sisu_0.12.0.orig.tar.gz (2005w20/4 | 2005-05-20 ):
+   SHA1(sisu_0.12.0.orig.tar.gz)= ca95d1bc6e601d74bbe17516b2d5abbe09c76c49
+   MD5(sisu_0.12.0.orig.tar.gz)= 9a2ec914f925b275045d5a0846edab79
+   9a2ec914f925b275045d5a0846edab79 3101948 sisu_0.12.0.orig.tar.gz
+   a9faa27de0ec632513b0ed81997d44af 20 sisu_0.12.0-1.diff.gz
+
+  * changes to packaging methods (better integration of debian package
+    builds - use of rant and darcs-buildpackage)
+
+  * apt-gettable package built
+
+  * switch from using the sha digest to md5
+
+%% SiSU version 0.10.9 of 2005w20/2 (2005-05-17):
+  sisu_0.10.9.tar.gz
+  SHA1(sisu_0.10.9.tar.gz)= bdb1ea25792549e77f88e9dac56442393714cd7c
+  Debian sisu_0.10.9-1.dsc
+    689f92bce4d1a9390d0c62726410d47b 3128684 sisu_0.10.9.orig.tar.gz
+    2775d317627ca5902b5c430defb39421 235 sisu_0.10.9-1.diff.gz
+
+  * default generic install of sisu is to type as root 
+    (in the root directory of the unpacked tarball):
+
+      ruby install
+
+    For additional options:
+
+      ruby install help
+    
+    or
+    
+      ruby install -T
+   
+    Thanks to rant.
+
+  * rant install file (used by sisu) has been made fairly 
+    generic, and mirrors the directory structure used by 
+    setup.rb
+
+    sisu specific post setup instructions are included 
+    in rant/plugin directory.
+
+  * removed Rakefile, I do like rake, but do find 
+    rant more flexible and remove the duplication of 
+    effort. The Rantfile, or rather install works without
+    the separate installation of rant.
+
+%% SiSU version 0.10.8 of 2005w20/1 (2005-05-16):
+  sisu_0.10.8.tar.gz
+  SHA1(sisu_0.10.8.tar.gz)= 09618366119ae0e7cf047083b860e71fce2cd599
+  Debian sisu_0.10.8-1.dsc: 25da3de61eb78d31abf70472022e7a32 3078004 sisu_0.10.8-1.tar.gz
+
+  * Package directory structure changed to suit setup.rb default mapping
+    and applied to Rant and debian builds (Rake not checked)
+      ./etc renamed ./conf
+      ./man moved to ./data/man
+    destination path mapping as before.
+
+  * renamed some files document text files in ./data/doc/sisu
+    such as this version_manifest
+
+  * copy of version_maifest and README placed in package root
+
+  * SiSU version information adjustment, see display e.g.:
+      sisu -v
+
+%% SiSU version 0.10.7 of 2005w19/0 (2005-05-15):
+  sisu_0.10.7.tar.gz
+  SHA1(sisu_0.10.7.tar.gz)= e18a47f07c1627f353bfc3a7c1e9d647c3265cf3
+  Debian sisu_0.10.7-1.dsc: d5978970a1e5891e5e9b0b406f503f79 3094556 sisu_0.10.7-1.tar.gz
+
+  * Rantfile for installation, (Stefan Lang's rant) 
+    to install SiSU, in the root directory of the unpacked SiSU as root type:
+      ruby install
+
+  * Rakefile fix to path for sisu-examples
+
+%% SiSU version 0.10.6 of 2005w19/3 (2005-05-11):
+  sisu_0.10.6.tar.gz
+  SHA1(sisu_0.10.6.tar.gz)= 55c891acbfe9eb734f96950d4cc646022112eda8
+  Debian sisu_0.10.6-1.dsc: 1124ffebc09426d2c16854069c398483 6140896 sisu_0.10.6-1.tar.gz
+
+  * some re-calibration of ocn required.
+
+%% SiSU version 0.10.5 of 2005w18/0 (2005-05-08):
+  sisu_0.10.5.tar.gz
+  SHA1(sisu_0.10.5.tar.gz)= 274be3ca806288d7cce5607707c4fd35fe1ecc6c
+  
+  * version detail [synchronising packaging]
+
+%% SiSU version 0.10.4 of 2005w18/0 (2005-05-08):
+  sisu_0.10.4.tar.gz
+  SHA1(sisu_0.10.4.tar.gz)= 3adfc0400055fa45200158c34523486fdede895a
+  
+  * small fix on reporting, generated by information, metaverse
+
+%% SiSU version 0.10.3 of 2005w18/0 (2005-05-08):
+  sisu_0.10.3.tar.gz
+  SHA1(sisu_0.10.3.tar.gz)= ad95cbe339115437f1605e4aa7d7cd4519bb34cb
+  
+  * cleaning in packages
+
+%% SiSU version 0.10.2 of 2005w18/0 (2005-05-08):
+  sisu_0.10.2.tar.gz
+  SHA1(sisu_0.10.2.tar.gz)= 6e02af05df9b32ed3565b2058bb15ab19482c893
+  
+  * rebuilt to correct debian package paths
+    .deb installation paths should be correct
+
+  * work-nickname Sabaki dropped from naming convention, will for
+    the time being stick to just sisu 
+    (previous work-names/nick-names included scribbler, and scribe)
+
+%% SiSU version 0.10.1 of 2005w18/5 (2005-05-06):
+  sisu_0.10.1.tar.gz
+  SHA1(sisu_0.10.1.tar.gz)= 210f6ba09aa8d78239a5b01ef981c1f615bce1f6
+  Contains development-branch, version 0.11.1 of 2005w18/5
+
+  0.11.1 of 2005w18/5
+  * debian packaging, 
+    all architectures,
+    use debian sub_version numbers 0.11.1-1
+
+    change darcs directory tarball directory and name to comply
+    with tarball created by debuild (remove sabaki and date stamp)
+
+    the sha provided here is for the darcs tarball,
+    will have to consider what to do when also providing debuild 
+    source tarball with it's own sha, and in any event to reduce 
+    duplication
+
+  * deb package provided together with debian source package 
+    and ***, which contains debian package sha.
+
+  * tinkering in database lib, minor renaming edits, 
+    (tuple instead of loadline)
+
+  * fix to cgi sample: sisu_search.cgi
+    related to match linking to endnotes, (#~\d instead of #\d)
+
+%% SiSU Sabaki, version 0.10.0 of 2005w18/2 (2005-05-03):
+  sisu-sabaki_0.10.0_2005w18-2.tar.gz
+  SHA1(sisu-sabaki_0.10.0_2005w18-2.tar.gz)=
+  fe59ad4f07346713e945de0d87b8b4b57b69fd62
+  Contains development-branch, version 0.11.0 of 2005w18/2
+
+  0.11.0 of 2005w18/2 (0.9.10 - 0.11.0)
+  * debian packaging re-visited, 
+    (based on help from wookey earlier in the year, 
+    thanks also to geoff for testing, ...
+    more to be done, but progress.)
+
+  0.9.9 of 2005w17/0
+  * looking at debian packaging
+    synchronise packaging (0.9.7 - 0.9.9)
+
+%% SiSU Sabaki, version 0.8.4 of 2005w17/6 (2005-04-30):
+  sisu-sabaki_0.8.4_2005w17-6.tar.gz
+  SHA1(sisu-sabaki_0.8.4_2005w17-6.tar.gz)=
+  b8385ec8b6cecd4a2cda06fd42151244a3697e5e
+  Contains development-branch, version 0.9.7 of 2005w17/6
+
+  0.9.7 2005w17/6
+  * tex/pdf document information
+
+%% SiSU Sabaki, version 0.8.3 of 2005w17/5 (2005-04-29):
+  sisu-sabaki_0.8.3_2005w17-5.tar.gz
+  SHA1(sisu-sabaki_0.8.3_2005w17-5.tar.gz)=
+  5603a862909c24eaec7a65b91f376e581fc76362
+  Contains development-branch, version 0.9.6 of 2005w17/5
+  
+  0.9.5 - 6 2005w17/5
+  * xml series tables
+
+%% SiSU Sabaki, version 0.8.2 of 2005w17/5 (2005-04-29):
+  sisu-sabaki_0.8.2_2005w17-5.tar.gz
+  SHA1(sisu-sabaki_0.8.2_2005w17-5.tar.gz)=
+  6564d4babe9a04520699bdeaac0f13c0bd723fa3
+  Contains development-branch, version 0.9.4 of 2005w17/5
+  
+  0.9.4 2005w17/5
+
+  * fixes:
+    * html table of contents, use of ocn
+    * xml series, (metaverse & xml_common)
+      tables not created at present, and removed 
+      revisit, (previous version inserted non-"tidy" xml markup)
+
+%% SiSU Sabaki, version 0.8.1 of 2005w17/4 (2005-04-28):
+  sisu-sabaki_0.8.1_2005w17-4.tar.gz
+  SHA1(sisu-sabaki_0.8.1_2005w17-4.tar.gz)=
+  c3508979690aad04834238354b259ae0c2588bfb
+  Contains development-branch, version 0.9.3 of 2005w17/4
+  
+  0.9.3 2005w17/4 (contains rad of 2005w17/4)
+
+  * hot on the heels of 0.8.0 some fixes, and more likely to follow.
+
+%% SiSU Sabaki, version 0.8.0 of 2005w17/4 (2005-04-28):
+  sisu-sabaki_0.8.0_2005w17-4.tar.gz
+  SHA1(sisu-sabaki_0.8.0_2005w17-4.tar.gz)=
+  8fcfc3f8d7661a0b3110a3206491581a93e0e920
+  Contains development-branch, version 0.9.2 of 2005w17/4 (rad - 0.9.2)
+  
+  Summary, an old idea reinstated, to permit alternative text 
+  presentations downstream: 
+
+  rad of 2005w17/3
+
+  * old idea reinstated: 
+    metaverse now carries three ocn (numbering) schemes for each document
+
+    * ocn as before all substantive objects numbered sequentially
+    * ocn divided, with headings distinguished from other substantive objects
+    * ocn specific, with each object identified and numbered by type
+
+  * changes to html and latex/pdf and database libraries to accommodate ocn
+    some bugs remain
+
+  rad of 2005w17/4
+  * changes to plaintext, xml series, and wmap to take account of ocn 
+    changes
+
+  0.9.0 2005w17/4 (contains rad of 2005w17/3-4)
+
+  * fixes needed in libraries using altered ocn/metaverse
+    (more to follow)
+
+  * cgi-bin search form sample 
+    0.9/data/sisu/sample/cgi-bin/sisu_search.cgi
+    break fix (table structure had been changed)
+
+  0.9.1 - 2 2005w17/4 (contains rad of 2005w17/3-4)
+
+  * more fixes needed in libraries using altered ocn/metaverse
+
+%% SiSU Sabaki, version 0.6.1 of 2005w16/0 (2005-04-24):
+  sisu-sabaki_0.6.1_2005w16-0.tar.gz
+  SHA1(sisu-sabaki_0.6.1_2005w16-0.tar.gz)=
+  c824120ade54278b78a82ed535318974b30d3073
+  Contains development-branch, version 0.7.5 of 2005w15/0 (5.10-7.5)
+
+  0.5.10 of 2005w16/2
+
+  * default shortuct flags -1 to -5 (what they do) can be modified in 
+    sisurc.yaml (by changing the default flags they call)
+
+  * screen output ansi colour default can be set to true or false in 
+    sisu.rc with -c acting as a toggle to turn screen output colour on
+    or off as appropriate against the default set.
+
+  0.7.0 of 2005w16/3
+  
+  * Remove old markup syntax, simplifies description of SiSU markup, without
+    any loss of functionality (the newer markup style is already a superset of
+    the old). Removal of old markup syntax necessitates branch/ version change.
+    Removal of the alternative markup syntax, which dates way back. It was
+    convenient and a bit impressive to be able to use SiSU on documents marked
+    up in 1997; and maintaining the accompanying code was unproblematic, but
+    after reflection over a prolonged period of time, have decided i would
+    rather not encourage alternative markup styles, especially where one is
+    clearly preferred over the other.  There are still alternative ways of
+    representing endnotes for examples as either may confer an advantage,
+    depending on circumstances (usually the pre-markup source document) but
+    only within the new markup style.
+
+  0.7.1 of 2005w16/4
+
+  * removal of alternative markup syntax continues.
+
+  * remote file operations and file letter naming conventions, now
+    composite, requesting, requiring files have filename with extension .r
+    when processed a temporary file is created with the extension .t
+    
+    when a url is provided to request the processing of a remote file, the file
+    is downloaded saved and processed with the .u extension
+
+  0.7.2 of 2005w16/6 
+  
+  * Work with the downloading of images where remote documents are requested
+    either by use of a url on the command line or within a composite document
+    images if not found there are downloaded to a subdirectory of the working
+    directory sisu_images_external. Composite documents flagged with the
+    extension .r1 .r2 and .r3 are if external downloaded and scanned for
+    images, which are downloaded if not found in the directory
+    ./sisu_images_external, and the document as expanded is saved with as a
+    temporary file with the extension .t1, .t2 or .t3 accordingly, for
+    processing. Where a uri is provided on the command line referring to a sisu
+    markup document for processing, that document is downloaded and saved with
+    the extension .u1, .u2 or .u3 which is then processed. In all cases the
+    file extension is dropped with respect to output.
+
+  * Some updates to the man pages with regard to different types of remote
+    processing.
+
+  * pdftex possibility to set image centering in header, default off.
+
+  * pdftex visited sisu and latex special characters, escaping for pdfs
+
+  0.7.3 of 2005w16/0
+
+  * Special characters in pdf, minor
+
+  0.7.4 of 2005w16/0
+
+  * marker, problem with tables detected, make sure can rollback
+
+  0.7.5 of 2005w16/0
+
+  * table fix...
+
+%% SiSU Sabaki, version 0.4.3 of 2005w16/1 (2005-04-18):
+  sisu-sabaki_0.4.3_2005w16-1.tar.gz
+  SHA1(sisu-sabaki_0.4.3_2005w16-1.tar.gz)=
+  ***
+  Contains development-branch, version 0.5.9 of 2005w15/0 (5-9)
+
+  0.5.5 of 2005w15/5
+
+  * sisu control, minor, e.g. reduce number of counters
+
+  [downloaded ruby1.9, this branch uses ruby1.8 though]
+
+  0.5.6 of 2005w15/6
+
+  * changes for ruby1.9, including metaverse, (also sysenv, html & plaintext)
+    most that needs to be done appears to be in place. worst fix ansi colour,
+    revisit all later. much testing needed.
+
+  * param header US Library of Congress cataloguing option ~class_loc also
+    ~class_dewey recall issues with dewey being proprietary? check (perhaps add
+    option and leave unused?) considered all this years ago... ~class_isbn,
+    issue here is that some material will be published under an isbn, and will
+    have page numbering etc. which sisu publication does not follow, i.e. sisu
+    publication is an independent publication, so isbn is a reference to an
+    original hard copy publication...  what of asin etc. revisit, and determine
+    what else to add.
+
+  0.5.7 of 2005w15/0
+
+  * sysenv ansi colors, revisit later
+
+  * wordmaps, revisit later... problem introduced (a loop removed, 
+    double counting removed)
+
+  * rescue single line syntax rescue: ...
+
+  0.5.8 of 2005w15/0
+
+  * introduce -c ansi color flag for screen output, (perhaps should be 
+    color off instead), and 
+    -q quiet mode, no screen output
+    there is some scope for breakage here, continue to examine the 
+    plumbing
+
+  * man page updated
+  
+  0.5.9 of 2005w16/1
+
+  * dbi fixes from 0.5.8 changes (ansi)
+
+%% SiSU Sabaki, version 0.4.2 of 2005w15/4 (2005-04-14):
+  sisu-sabaki_0.4.2_2005w15-4.tar.gz
+  SHA1(sisu-sabaki_0.4.2_2005w15-4.tar.gz)=
+  d670058fe019a106b385049416db5c914fbf308d
+  Contains development-branch, version 0.5.4 of 2005w15/4 (4)
+
+  0.5.4 of 2005w15/4
+
+  * sqlite default file name created to sisu_sqlite.db (was lex.db)
+
+  * plaintext some cleaning of output
+  
+  * xml, minor touch, image tag, version/revision control info optional
+
+%% SiSU Sabaki, version 0.4.1 of 2005w15/3 (2005-04-13):
+  sisu-sabaki_0.4.1_2005w15-3.tar.gz
+  SHA1(sisu-sabaki_0.4.1_2005w15-3.tar.gz)=
+  0b1c6f10832e114f55e4a7d37f6f98d7c345b55f
+  Contains development-branch, version 0.5.3 of 2005w15/3 (1-3)
+
+  0.5.1 of 2005w15/3
+
+  * dbi sqlite re-introduced, though not tested. some things moved to 
+    common_db
+
+  0.5.2 of 2005w15/3
+
+  * common_db, dbi, pg and sqlite most logic is common and moved to 
+    common_db
+
+  0.5.3 of 2005w15/3
+  
+  * dbi increased field size for text contents again, 
+    (to 12,000 for now from inadequate 2712)
+    both postgresql and sqlite appear to support this
+
+%% SiSU Sabaki, version 0.4.0 of 2005w15/2 (2005-04-12):
+  sisu-sabaki_0.4.0_2005w15-2.tar.gz
+  SHA1(sisu-sabaki_0.4.0_2005w15-2.tar.gz)=
+  832f47c37910dfbac05c401f26865b5f53dea358
+  Contains development-branch, version 
+  0.5.0 == 0.3.0 of 2005w15/2
+
+  0.3.1 of 2005w15/2
+
+  * image representation changed dimensions now represented as 
+    width x height i.e. \d+x\d+ e.g. 480x640 (as in imagemagick)
+    previously was explicit w=480 h=640
+    (this change causes breakage in sample text with images)
+
+  * sample marked-up documents updated accordingly
+
+  0.5.0 of 2005w15/2
+
+  * sorry for the quick version number turn around, and for its being applied
+    to pretty minor changes. 
+  
+    The version numbering rule applied is that a second digit version number
+    change will be made when potential breakage is caused by code changes.
+  
+    This has happened now with the decision to alter representation of image
+    dimensions. Backward compatibility, though easily provided is not thought
+    to be necessary (or desirable) in this instance, based on current user
+    base, and modest use of images in text. 0.4.0 is on it's way. This type of
+    event is fairly rare, though it has occurred occasionally in subtle ways.
+    For example Tainaron marked up in 1997-1998 markup style still builds.
+    
+    For description of change see 0.3.1 
+
+%% SiSU Sabaki, version 0.2.0 of 2005w14/0 (2005-04-10):
+  sisu-sabaki_0.2.0_2005w14-0.tar.gz
+  SHA1(sisu-sabaki_0.2.0_2005w14-0.tar.gz)=
+  36986ffa6a17651a0d52646c9c91032af33bb32a
+  From stable 0.1.4-11
+  Contains development-branch, version 
+  0.3 == 0.1.5-58 of 2005w13/6
+
+  * version number changes:
+    stable branch is 0.2
+    development branch is 0.3
+
+  * replaced config_environment.rb file which had dropped out of stable 
+    tarball. [lesson, test future setup/installs from clean slate]
+
+%% STABLE MANIFEST (@ 0.1.4 branch)
+
+%% SiSU Sabaki, version 0.1.4-11 of 2005w14/6 (2005-04-09):
+  sisu-sabaki-stable_0.1.4-10_2005w14-6.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-11_2005w14-6.tar.gz)=
+  bdb2b09d467804a6d3a4bd92abb13c015c57d897
+  Contains development-branch, version 
+  0.1.5-58 of 2005w13/6 (56-58)
+
+  0.1.5-56 of 2005w14/3
+
+  * html endnote segment, (introduced bug fixed) linkback to 
+    main text broken, url was split on more than one line,
+    resulting in error
+
+  * special characters escaping for use within text 
+    looked at, (mostly there previously but not documented)
+    ~ { } < > - _ / also used : ^ ! # 
+    note added to man pages 
+    (more to be done)
+
+  0.1.5-57 of 2005w14/5
+
+  * distinguish text poem from other text groupings by giving an 
+    object citation number to each verse
+
+  * cosmetic html default colors for navigation band and home button 
+    surround made neutral (white)
+
+  0.1.5-58 of 2005w14/6
+
+  * distinguish text poem from other text groupings by giving an 
+    object citation number to each verse
+
+  * alt and group text groupings bugfix
+
+%% SiSU Sabaki, version 0.1.4-10 of 2005w13/6 (2005-04-02):
+  sisu-sabaki-stable_0.1.4-10_2005w13-6.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-10_2005w13-6.tar.gz)=
+  bdd91b004c456251d6e7074439f6e9b571ae5316
+  Contains development-branch, version 
+  0.1.5-55 of 2005w13/6 (47-55)
+
+  0.1.5-47 of 2005w13/3
+
+  * texpdf suggested urls at end of document problems with latex special 
+    characters, not fully looked into, or passed through the appropriate
+    filter, but some ad hoc corrections made
+
+  0.1.5-48 of 2005w13/3
+
+  * cosmetic + information in html navigation band (revisit)
+
+  * texpdf suggested urls special character fix for both url and linked text
+    done.
+
+  0.1.5-49 of 2005w13/3
+
+  * html subtoc fix (as it failed in certain circumstances, watch)
+
+  * html endnotes, cosmetic (presentation of headings, and invisible navigation)
+
+  0.1.5-50 of 2005w13/3
+
+  * html change to display of title and headings in segments (dc and headings)
+    display dc small, and heading normal
+
+  0.1.5-51 of 2005w13/4
+
+  * initial xml table logic is in place (logic taken from html unit) [still using 
+    html type tags but logic is in place]
+
+  0.1.5-52 of 2005w13/6
+
+  * object character numbering of special blocks "code", "poem", "group"
+    and "alt" finally corrected, in line with "tables". (may introduce a subtle 
+    variation, between poem and code, or alt and others, numbering the equivalent
+    of each verse, but need a bit of time to consider) numbering correct, some 
+    cosmetic adjustments to follow, e.g. in pdfs, more work necessary in xml 
+    series.
+
+  0.1.5-53 of 2005w13/6
+
+  * dbi a bit of cleaning of search column, and touch to data
+
+  0.1.5-54 of 2005w13/6 
+
+  * texpdf adjustment to position of ocn in special text blocks
+
+  0.1.5-55 of 2005w13/6
+
+  * texpdf blocks fix
+
+  * texpdf prefix_b issue with portrait, (not landscape) fix
+
+  * sisu info improved in latex output
+
+%% SiSU Sabaki, version 0.1.4-9 of 2005w13/2 (2005-03-29):
+  sisu-sabaki-stable_0.1.4-9_2005w13-2.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-9_2005w13-2.tar.gz)=
+  743b912beddc235ec96456e97fe9350b2a275370
+  Contains development-branch, version 
+  0.1.5-46 of 2005w13/1 (44-46) 
+
+  * small updates to man page
+
+%% SiSU Sabaki, version 0.1.4-8 of 2005w13/2 (2005-03-29):
+  sisu-sabaki-stable_0.1.4-8_2005w13-1.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-8_2005w13-1.tar.gz)=
+  f8a7760bbd583e5d8637420d153c178ffafcbf68
+  Contains development-branch, version 
+  0.1.5-43 of 2005w13/1 (34-43) 
+
+  Quick summary (context sisu markup):
+
+  * allows creation of composite (sisu markup) documents, documents that
+    require other documents or bits of marked up text that are not independent
+    documents (i.e. not capable of being generated as standalone documents),
+    content may be sourced remotely (url)
+
+  * allows processing of remote (sisu markup) documents
+
+  * various small fixes
+
+  -- detail from development branch
+  
+  0.1.5-44 of 2005w13/2:
+
+  * documentation updates
+
+  0.1.5-43 of 2005w13/1:
+
+  * composite documents and remote (url) documents, some on error code
+
+  * composite documents, screen information provided, both cosmetic and on
+    error
+
+  0.1.5-42 of 2005w12/0:
+
+  * composite documents may link to remote urls for their constituent parts
+    using any of its (composite link) syntaxes with an html url, but advisedly
+    either of the following:
+
+    #basic sisu markup
+      r{http://www.url.org/filename.si}
+      {http://www.url.org/filename.s3}require
+      r{ {http://www.url.org/filename.si}req #for vim folds
+
+    #using thlnk
+      <url:http://www.url.org/filename.si>require
+      r{ <url:http://www.url.org/filename.s3>req #for vim folds
+    
+    with thlnk is attractive if you use vim because it recognises and permits
+    the plain-text hyperlinking to the remote file, which can be called in for
+    viewing.
+
+    in this context (urls) textlink markup has little meaning as it does not
+    work for editors with url hyperlinking, while the basic sisu markup does no
+    more or less than it always does. For everyday use, as a means of
+    hyper-linking within an editor i do find textlink attractive though.
+
+  * file suffix naming convention -
+    .s[1-3] ordinary sisu marked up documents
+    .si     sisu marked up snippets for incorporation into other documents
+    .r[1-3] documents using require - (like a master document)
+    .t[1-3] temporary marked up files, usually created by sisu for processing, 
+           e.g. from building the master file, or on having downloaded a remote
+           sisu markup file for local processing.
+
+    while on the subject the 1 to 3 is an old naming convention for processing
+      html output, .s1 indicating that only a scroll, long single text should
+      be produced; .s2 for only segmented html, the document in parts should be
+      produced, no single/full length document (this is used for example on war
+      and peace); and .s3 requesting both the scroll and segments.
+
+  0.1.5-41 of 2005w12/0:
+  
+  * more alpha code: remote source a sisu markup file using url (http://) for
+    local processing. 
+    
+    For example, assuming sisu is installed, you could generate the text of the
+    GPL in plain-text, html, xhtml, XML, pdf and a wordmap of its contents using
+    the following string:
+
+    sisu -mhpabxXwv http://www.jus.uio.no/sisu/sample/markup/gpl2.fsf.s3 
+
+    or to just do html and pdf files from one remote source to the default 
+    remote destination (assuming you have one setup):
+    
+    sisu -mhpr http://www.jus.uio.no/sisu/sample/markup/gpl2.fsf.s3 
+    
+    [this works for texts without embedded images, unless you already have the
+    images stored locally - it will be a relatively easy matter to get the
+    program to search relative parts on the remote server and download them for
+    processing with the document... no doubt it will happen one day, but is not
+    a priority in the near future, also; will be a small step to permit remote
+    (and local files) to be stored in zip format and unzipped prior to
+    processing if desired, to reduce bandwidth and time] 
+    
+    Nice from a flexibility perspective, though I expect SiSU's use to be
+    primarily on locally stored marked up document sets.
+
+  * vim updates (small touches) to sisu: syntax highlighting; folds, and; 
+    recognised filetypes (included .si .[rst][0-3] already being recognised)
+
+  0.1.5-40 of 2005w12/0:
+
+  * *{composite document}*, alpha code: introduced alternative ways of
+    specifying document require, using vim's hypertext ascii thlnk or textlink.
+    The following forms of document require are valid, to incorporate a
+    document fragment named filename.si (the require statement must be at the
+    start of a line):
+
+    #basic sisu markup
+      r{filename}
+      {filename.si}require
+      r{ {filename.si}req #for vim folds
+
+    #using textlink
+      |filename.si|@|^|require
+      r{ |filename.si|@|^|req #for vim folds
+
+    #using thlnk
+      <url:filename.si>require
+      r{ <url:filename.si>req #for vim folds
+
+    the value of the textlink and thlnk style is they are live hyperlinks to 
+    the constituent parts of the document, which can be brought up at a 
+    keystroke for viewing or editing.
+    
+    [An interesting possibility to consider, is to permit sisu to get the
+    composite parts of a document from a remote url source via http, using
+    thlnk syntax which permits this <URL:http://www.bf-consulting.de/thlnk/vim>
+    - NOTE: implemented in 0.1.5-42] 
+    
+    0.1.5-39 of 2005w12/6:
+  
+  * *alpha* code: assemble source document for processing from a document 
+    requesting additional parts ... i.e.  a master document, or a document with
+    regular markup plus external insertions. Requesting documents currently
+    with named suffix .r[1-3] documents requested may be complete valid sisu
+    documents named with suffix .s[1-3] or valid sisu markup constituting part
+    of a document named with suffix .si (to distinguish and to prevent attempt
+    to generate the snippet). A temporary or transient document is assembled
+    for processing and na    med with the suffix .t[1-3] (retaining the
+    processing instruction digit) [current intention is that the .t file will
+    be clobbered at the end of processing unless the maintenance processing
+    flag is used] parts are requested with:
+      {[name_of_file_to_load.s[i1-3]]}require
+    e.g.
+      {name_of_file_to_load.si}require
+    or
+      { name_of_file_to_load.s3 }require
+
+  0.1.5-38 of 2005w12/6:
+  
+  * xml sax and dom, pass data through...
+
+  development-branch, version 0.1.5-37 of 2005w12/6
+  
+  * document generator information added as comment to head of xml & xhtml
+    output
+
+  0.1.5-36 of 2005w12/6:
+
+  * fix, remote sending of xhtml files (-r on -b option), include [b] in
+    regex match for file to be placed correctly in remote directory
+
+  * cosmetic, (still with screen output on doing remote sending)
+
+  * [ratchet fix so yyyymmdd date info displayed correctly, was dropping 
+    the 0 before month and day where less than 10]
+
+  * css and default home page modified
+
+  0.1.5-35 of 2005w12/4:
+
+  * xml sax dom and xhtml change to header match
+
+  * xml dom changes to css
+
+  * some feedback provided on remote file placement -r
+
+  * document version guide added to toc html, (stub only unused)
+
+  0.1.5-34 of 2005w12/4:
+
+  * xhtml filename extension now scroll.xhtml instead of doc.xhtml
+
+  * man page small update, file name extensions (xhtml and plain-text)
+
+%% SiSU Sabaki, version 0.1.4-7 of 2005w12/3 (2005-03-23):
+  sisu-sabaki-stable_0.1.4-7_2005w12-3.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-7_2005w12-3.tar.gz)=
+  929875de0658f1adeabd837fa09aca3ae48197e0
+  Contains development-branch, version 
+  0.1.5-33 of 2005w12/3 (30-33) 
+
+  0.1.5-33 of 2005w12/3:
+
+  * largely cosmetic changes to default home page.
+
+  0.1.5-32 of 2005w12/3:
+
+  * finally removed double bullets from ie on ms, problem with html tagging
+    <ul> and <li> both required. Small related changes to css and more to
+    follow.
+
+  0.1.5-31 of 2005w12/3:
+
+  * sysenv: reverted to using ruby -v for ruby version info (no longer find
+    what i want within rbconfig: Config::CONFIG)
+
+  * plaintext: pass metadata through wrapper, some document rights info extends
+    beyond line wrap limit.
+
+  0.1.5-30 of 2005w12/1:
+
+  * passed css (sisu.css) through a validator, corrections made
+
+  * expressly close segment files as produced, (else problem remote sending
+    last metadata file created as is not yet closed)
+
+%% SiSU Sabaki, version 0.1.4-6 of 2005w12/1 (2005-03-21):
+  sisu-sabaki-stable_0.1.4-6_2005w12-1.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-6_2005w12-1.tar.gz)=
+  3f8ded60f1f43e3ba3e745d9bbc045bb0ab43ffb
+  Contains development-branch, version 
+  0.1.5-29 of 2005w11/6 (22-29) 
+
+   from development-branch, version 0.1.5-26 to 0.1.5-29 of 2005w11/6
+
+  * -h0 turns off object character number display in html ouput 
+    (-p0 to turn of object character number display in pdf, already
+    exists) [this is the digit 0 not upercase o]
+
+  * man page alphabetised
+
+  * renamed ascii plaintext, as use utf-8
+
+  * renamed plaintext output file plain.txt from file.txt (recently was
+    doc.txt but there were "webserver conflicts" with doc.html)
+
+  * manually constructed homepage embedded, and created on initialisation (-C),
+    will probably have to consider how and when this is done.
+
+  0.1.5-25 of 2005w11/5:
+
+  * on table of contents page (for segmented text), new arrow navigation
+    button linked to first segment. 
+
+  * -ru forces use of scp so as to build remote file structure and for input
+    files selected for processing, to copy all output files in their
+    directories (rather than only the currently selected output types).
+    [Bugcheck: There may be a bug, check that metaverse.html closes after
+    normal html processing and before copy, ... seems to end up posted empty,
+    when actually is built.]
+
+  * html for segmented table of contents, correction url markup levels 4,5 & 6
+
+  * [removal of erroneous reference to lexmercatoria]
+
+  0.1.5-24 of 2005w11/3:
+
+  * [decided how to represent blockquotes, propagte]
+  
+  * provided sisu home site urls (not a code change)
+
+  0.1.5-23 of 2005w11/3:
+
+  * remote -r only ssh copy file types for which processing requested
+    (e.g. all pdf files for the following files to be processed - previously
+    copied all files from output directory of file for which processing was
+    requested) has a drawback though, as rely on scp -r to build the directory
+    structure, the first sending of any file must be done by calling the 
+    -r flag alone, ie without other sisu instructions.
+
+  0.1.5-22 of 2005w11/2:
+
+  * html, css more ...
+    [some problems reported with presentation of bullet lists in IE, will sort
+    later]
+
+  * use name file.txt instead of doc.txt for basic text (ascii type)
+    presentation output. Reason, some web servers are configured to give
+    precedence to .txt extension over .html i.e. when doc is requested doc.txt
+    rather than doc.html (the sisu preferred default) would be presented.
+
+%% SiSU Sabaki, version 0.1.4-5 of 2005w11/2 (2005-03-15):
+  sisu-sabaki-stable_0.1.4-5_2005w11-2.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-5_2005w11-2.tar.gz)=
+  25e35edc2f932269d21b17c29890ad72c54510a5
+  Contains development-branch, version 
+  0.1.5-21 of 2005w11/2 
+
+  * html, css, indented bullet fixed
+  
+  * [see 0.1.4-4 for recent changes]
+
+%% SiSU Sabaki, version 0.1.4-4 of 2005w11/1 (2005-03-14):
+  sisu-sabaki-stable_0.1.4-4_2005w11-1.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-4_2005w11-1.tar.gz)=
+  2ab9fa0a45275ca65a23e5199ef13851f00042f2
+  Contains development-branch, version 
+  0.1.5-16 to 0.1.5-20 of 2005w11/1 
+
+  * html markup, a quick glance at & nod (anew) towards css
+    changes to ruby html code & to markup arranging & pruning (also get rid of
+    some line noise) from 0.1.5-16 to 0.1.5-20 (an ongoing longer term sort of
+    thing) quite a few changes, more to be done though
+  
+  * line wrap visited
+  
+  * ascii touched
+
+  * some code files moved and renamed
+
+%% SiSU Sabaki, version 0.1.4-3 of 2005w10/5 (2005-03-11):
+  sisu-sabaki-stable_0.1.4-3_2005w10-5.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-3_2005w10-5.tar.gz)=
+  7e06a3b37e85eaebc74892244f6626ee4f2fcc8a
+  Contains development-branch, version 
+  0.1.5-15 of 2005w10/5 
+
+  * remote host secure copy: adjustments, and flagged in help as EXPERIMENTAL
+    and as requiring configuration. Checks provided - no action taken if
+    username and remote hostname have not been provided and host not found.
+    Further checks necessary, first no action if network not available
+    (actually this feature should not yet have been made available in stable,
+    but so be it). [0.1.5-14 & 15 of 2005w10/4] - does not currently create
+    base directory for output on remote server - only sub-directories for each
+    document produced.
+
+%% SiSU Sabaki, version 0.1.4-2 of 2005w10/5 (2005-03-11):
+  sisu-sabaki-stable_0.1.4-2_2005w10-5.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-2_2005w10-5.tar.gz)=
+  46ad3b254b5e9293610dccd6274e039e49c5b9a2
+  Contains development-branch, version 
+  0.1.5-12 of 2005w10/5 
+
+  * forgot to update Rakefile along with rest of last stable relese (this is
+    excuse for current update) 
+
+  * [A potentially useful feature, released prematurely] remote host secure
+    copy using system call, -r flag introduced, hostname and user must be
+    configured in sisurc.yaml (It is much more convenient to install SiSU on
+    remote machine, and do processing there, but that is not possible and it is
+    often convenient to have the files you are working on placed on the remote
+    host without further intervention [this serves as (an occasional?) fix],
+    (note is faster i am sure to send a compressed tarball)) [could do same for
+    ftp etc.] Note also would be more efficiently implemented as a threaded,
+    will consider later, for now the output of this implementation is
+    appreciated. 
+
+  * ascii.rb minor touch, (repeated require removed)
+  
+  * an email address update for author
+
+%% SiSU Sabaki, version 0.1.4-1 of 2005w10/3 (2005-03-09):
+  sisu-sabaki-stable_0.1.4-1_2005w10-3.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki-stable_0.1.4-0_2005w10-3.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-1_2005w10-3.tar.gz)=
+  8ab95e942f7dd2449e1c92ec94f15a938d01edce
+  Contains development-branch, version 
+  0.1.5-1 (post 2005w06/4) - 0.1.5-11 of 2005w10/2 
+
+  0.1.5-11 of 2005w10/1:
+
+  * latex/pdf match regex improved (for work referred to in 0.1.5-10)
+
+  0.1.5-10 of 2005w10/2 - fold back into stable:
+
+  * fix for bug in latex/pdf for certain types of multiple url/endnote tagging
+    within a paragraph, previously not properly caught (not much need had arisen
+    for multiple 'such' tags... but sorted)
+
+  0.1.5-9 of 2005w10/1:
+
+  * cosmetic changes, html navigation
+
+  0.1.5-8 of 2005w09/0:
+
+  * cosmetic changes, css visited turned off in html, and previous, next arrow
+    buttons changed (with image-buttons from darcs wiki)
+
+  0.1.5-7 of 2005w09/0:
+
+  * utf8 xml
+  
+  * utf8 related transforms in one file, (but should profile), so far latexpdf
+    and html, (xml to follow)
+
+  * switch over to UTF-8 from ISO-8859-1
+
+  0.1.5-6 of 2005w09/5:
+
+  * platform architechture hooks in place
+
+  * Iñtërnâtiônàlizætiøn a few more utf-8 characters added
+    ¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûü
+    ¢£¥§©ª«®°±²³µ¶¹º»¼½¾×÷
+
+  * man page, looked odd under utf8, adjustments made (post 0.1.5-5 and
+  uploaded)
+
+  * rake base, function updated to setup man along with: bin, lib, etc
+
+  0.1.5-5 of 2005w09/3:
+
+  * papersize, LaTeX/pdf start adjusting, further refinement necessary
+
+  * documentation, small update
+
+  0.1.5-4 of 2005w09/3:
+
+  * internationalisation, Unicode UTF-8 (preferred default (from now on)): the
+    locale common denominator between various programs used, from LaTeX and
+    Postgresql to ... vim, appears to be utf-8
+      Changed computer environment to utf8 (locale, postgresql, vim etc.), and
+      run SiSU to see what breaks...
+      * issues detected with LaTeX/pdf and sorted
+  
+  * hooks for paper size used by latex/pdf in place currently only default a4 set
+    for all available types, sort out LaTeX settings later.
+  
+  * text version of version manifest included start to provide 2004-02-27
+  
+  * small changes to rakefile
+
+  * small changes to dates in sysenv
+
+  * termsheets wrapper included, (termsheet sisu pre-processing for merging a
+    computer legal 'termsheet' into a set of standard contract documents)
+    included wrapper. However, to be useful need to provide examples, and/or
+    detail as to how this works... this is left out for now, as having so many
+    appendages is a distraction and make sisu look more complicated than it
+    need be, or rather than it is for its' ordinary functions.
+  
+  * included Debian directory, first attempt at making a deb.
+    [still only in development directory]
+
+%% SiSU Sabaki, version 0.1.4-0 of 2005w07/2 (2005-02-15):
+  sisu-sabaki-stable_0.1.4-0_2005w07-2.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki-stable_0.1.4-0_2005w07-2.tar.gz
+  SHA1(sisu-sabaki-stable_0.1.4-0_2005w07-2.tar.gz)=
+  0867a884c6741751e73e664c6fe485ec7161dcdb
+	 
+  * substantively the same as 0.1.5-0 (development branch)
+
+  * tables get object citation numbers
+
+  * tables are currently omitted from xml output, and table notes are disabled
+    for the moment
+
+%% SiSU Sabaki, version 0.1.2-27 of 2005w05/0 (2005-02-06):
+  sisu-sabaki_0.1.2-27_2005w05-0.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-27_2005w05-0.tar.gz
+  SHA1(sisu-sabaki_0.1.2-27_2005w05-0.tar.gz)=
+  af17a4a3f8c192e772fb862f16f6c93bd48129b5
+
+  * adjustments to Rakefile post installation configuration and generation of
+    sample file output, post-installation options
+
+  * word map hardlinks ... (.html suffix previously handled by webserver
+    configuration)
+
+%% SiSU Sabaki, version 0.1.2-26 of 2005w05/0 (2005-02-06):
+   sisu-sabaki_0.1.2-26_2005w05-0.tar.gz
+   http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-26_2005w05-0.tar.gz
+   SHA1(sisu-sabaki_0.1.2-26_2005w05-0.tar.gz)=
+   3fe1d7aafacad9926ef228b48bf13af0cafa9217
+
+  * adjustments to Rakefile post installation configuration and generation of
+    sample file output
+
+%% SiSU Sabaki, version 0.1.2-25 of 2005w05/5 (2005-02-04):
+  sisu-sabaki_0.1.2-25_2005w05-5.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-25_2005w05-5.tar.gz
+  SHA1(sisu-sabaki_0.1.2-25_2005w05-5.tar.gz)=
+  0f00d3bf6883a02da4270e953781aec4cfe6ebb9
+
+  * tweaking of default output and processing paths, (for testing, may have
+    broken something)
+
+  * adjustment to url pattern match for LaTeX output
+
+  * As rake has been configured to do post installation setup, it is the
+    preferred method of installation for the present time.
+
+%% SiSU Sabaki, version 0.1.2-24 of 2005w05/5 (2005-02-04):
+  sisu-sabaki_0.1.2-24_2005w05-5.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-24_2005w05-5.tar.gz
+  SHA1(sisu-sabaki_0.1.2-24_2005w05-5.tar.gz)=
+  d93c2b510d3784dc7b396541734bcdaf198c0c9b 
+
+  * if you have ruby1.8.2, rake and sudo install and setup should be automated -
+    small adjustments to Rakefile, if sudo is used on machine, will request
+    user (name) to be used when generating test document, and attempts to do
+    additional setup required and generate the first document; if not skips
+    that final step, manual configuration, being required (basically running
+    sisu -CC in document markup directory first before generating first
+    document)
+
+  * hard test for presence of rexml which is supposed to be part of ruby1.8 I
+  thought but reports back from a number of distros that is not always there...
+  as it is so far only used in SiSU for cosmetic purposes, rexml is ignored if
+  not found. Caused hiccup if not present in previous version.
+
+  * on Debian testers had to have the following packages installed in addition to
+    having ruby1.8 and preferably rake as well:
+      tetex-base tetex-bin tetex-extra
+      libyaml-ruby
+    other programs used if available
+      librexml-ruby trang and tidy
+
+  * on Mac the following page was valuable to one who had not previously used
+    Ruby
+      http://www.rubygarden.org/ruby?RubyOnMacintosh
+
+%% *Withdrawn* - SiSU Sabaki, version 0.1.2-23 of 2005w05/4 (2005-02-03):
+  sisu-sabaki_0.1.2-23_2005w05-4.tar.gz
+  SHA1(sisu-sabaki_0.1.2-23_2005w05-4.tar.gz)=
+  771e0a98246162c61618dc941ab9831e57551e9f
+
+  Withdrawn because more was done setting up SiSU in root than is practicable,
+  causing problems for ordinary use of sisu.
+
+  * small adjustments to Rakefile, still need to decide whether default action
+    should include an attempt to generate a test document
+
+  * sisurc.yaml sample provided disabled by default (
+    /etc/sisu/0.1.2/sisurc.yaml.sample_disabled probably best copied to ~/.sisu
+    and renamed sisurc.yaml)
+
+%% SiSU Sabaki, version 0.1.2-22 of 2005w05/3 (2005-02-02):
+  sisu-sabaki_0.1.2-22_2005w05-3.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-22_2005w05-3.tar.gz
+  SHA1(sisu-sabaki_0.1.2-22_2005w05-3.tar.gz)=
+  b9b51c7f9e5a95f32df91632fb43c96c1a9057a3
+
+  * SiSU's Rakefile configure automation taken a bit further. If using Rake setup
+    then after the installation of SiSU, Rake will attempt to do initial
+    configuration of the sisu document samples output directory, and to
+    generate multiple output versions of a sample text file (html, ascii, xml
+    (dom and sax versions), latex, pdf). Will consider whether to keep things
+    this way, it does provide early feedback as the status of the installation.
+
+  * Permissions on files placed by Rake, bin 755 the rest 644
+
+  * /etc added to sisurc.yaml search path, was previously a sample document.
+
+%% SiSU Sabaki, version 0.1.2-21 of 2005w05/3 (2005-02-02):
+  sisu-sabaki_0.1.2-21_2005w05-3.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-21_2005w05-3.tar.gz
+  SHA1(sisu-sabaki_0.1.2-21_2005w05-3.tar.gz)=
+  6f5ae5a24ff8099aea492e47ac99c73f906d18e4
+
+  * LaTex/pdf output should now work across the platforms on which sisu has been
+    tested, Linux and Mac/OSX/BSD, but this is anticipated rather than
+    extensively tested...
+
+  * sisu -CC from within a document working directory, after install should do
+    additional things related to initialising output directory
+
+  * system calls were mostly placed in one library/module and the availability of
+    the binary tested for with whereis -b, apparently the -b flag for binary
+    only is not available across all Linux/Unix, so the whereis check has been
+    modified.
+
+  * various little things todo with setup and installation
+
+  * Thanks O-E P, and chris2 for help and feedback with Mac OSX installations.
+
+%% SiSU Sabaki, version 0.1.2-20 of 2005w05/2 (2005-02-01):
+  sisu-sabaki_0.1.2-20_2005w05-2.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-20_2005w05-2.tar.gz
+  SHA1(sisu-sabaki_0.1.2-20_2005w05-2.tar.gz)=
+  1e28dde239c96b82acfced1a37615ca7255d102a 
+
+  * Most remaining system calls moved to single location, and binaries checked
+    for before use, will be very easy to have alternative calls for different
+    platforms
+
+  * Well this is news SiSU ran on a Mac yesterday - html, ascii, xml Very much a
+    first look. There are issues to resolve, but not major ones: sisu -v:
+
+      SiSU Sabaki: version 0.1.2-19 of 2005w05/1 (2005-01-31) & Ruby: ruby 1.8.2
+      (2004-12-25) [powerpc-darwin7.7.0]
+
+  * & my info, sisu -v:
+
+      SiSU Sabaki: version 0.1.2-19 of 2005w05/1 (2005-01-31) & Ruby: ruby 1.8.2
+      (2005-01-10) [i386-linux]
+
+%% SiSU Sabaki, version 0.1.2-19 of 2005w05/1 (2005-01-31):
+  sisu-sabaki_0.1.2-19_2005w05-1.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-19_2005w05-1.tar.gz
+  SHA1(sisu-sabaki_0.1.2-19_2005w05-1.tar.gz)= eb7ef826f2fa69c4ef8eaf33ff297f3141c1217e 
+
+  * Rakefile modified, same result ... a few more options
+
+  * touch to vim folds
+
+  * cosmetic change to code headers
+
+  * a touch related to initialisation of directories (probably more to follow),
+    checks done as to whether to -C on use of -m and -M flags
+
+  * SiSU ran on a Mac today - html, ascii, xml. There are issues to resolve, but
+    not major ones: sisu -v on a powerpc yesterday:
+
+  * Well this is news SiSU ran on a Mac yesterday - html, ascii, xml Very much a
+    first look. There are issues to resolve, but not major ones): sisu -v:
+
+     SiSU Sabaki: version 0.1.2-19 of 2005w05/1 (2005-01-31) & Ruby: ruby 1.8.2
+     (2004-12-25) [powerpc-darwin7.7.0]
+
+  * my info, sisu -v:
+
+      SiSU Sabaki: version 0.1.2-19 of 2005w05/1 (2005-01-31) & Ruby: ruby 1.8.2
+      (2005-01-10) [i386-linux]
+
+  * Released together with 0.1.2-18 which was held back because some remaining
+    issues with extension of feature set introduced in 0.1.2-14 and 0.1.2-15
+    were detected. These have been largely but not completely resolved. Will
+    have to study effects of changes on middle layer more closely in subsequent
+    releases.  There will be some.  The release is made now anyway because
+    there are a number of installations taking place this week, and it does
+    contain improvements over previous versions, in the install procedures
+    which are primarily what is to be looked at.
+
+%% SiSU Sabaki, version 0.1.2-18 of 2005w04/0 (2005-01-30):
+  sisu-sabaki_0.1.2-18_2005w04-0.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-18_2005w04-0.tar.gz
+  SHA1(sisu-sabaki_0.1.2-18_2005w04-0.tar.gz)=
+  99cb98163fad28aec1111429d505e8c54cc6f353
+
+  * Rakefile modified, same result ... a few more options
+
+  * touch to vim folds
+
+  * cosmetic change to code headers
+
+  * a touch related to initialisation of directories (probably more to follow),
+    checks done as to whether to -C on use of -m and -M flags
+
+  * Held back and released at the same time as 0.1.2-19. While containing the
+    noted improvements over 0.1.2-17 was withheld as some remaining issues
+    resulting from the extension of features in 0.1.2-14 & 0.1.2-15, which
+    0.1.2-18 goes some way to address as well.
+
+%% SiSU Sabaki, version 0.1.2-17 of 2005w04/4 (2005-01-27):
+  sisu-sabaki_0.1.2-17_2005w04-4.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-17_2005w04-4.tar.gz
+  SHA1(sisu-sabaki_0.1.2-17_2005w04-4.tar.gz)=
+  e61952bcde4b7cd936fdcd35835287d50af83814
+	 
+  * Test documents regenerated.
+
+  * Bugfix release, fixing bug intruduced by longtime planned nifty new feature
+    introduced in 0.1.2-14 and 0.1.2-15 ¿  in keeping with markup ergonomics,
+    emphasis, i.e. word list to be made bold and italics can be adjusted in
+    skins as well as in headers, or directly in text, see 0.1.2-14 and 0.1.2-15
+    release and notes below for general details.
+
+  * bugfix of feature introduced in 0.1.2-15
+    single fix for bug in 0.1.2-15 (markup wordlist defaults and skin
+    adjustment), 0.1.2-16 (earlier bugfix). In special circumstances the bug
+    could also affect 0.1.2-14 (markup wordlist header adjustment)
+
+  * max pdf image size optimised for landscape output.  sizes changed in
+    0.1.2-16, incidentally, really should have different maximum values for
+    landscape and portrait, planned.
+
+%% *Withdrawn* - SiSU Sabaki, version 0.1.2-16 of 2005w04/4 (2005-01-27):
+  sisu-sabaki_0.1.2-16_2005w04-4.tar.gz
+  SHA1(sisu-sabaki_0.1.2-16_2005w04-4.tar.gz)=
+  d6ab8845e160821fc41bdd79a5f6b35df0ce236a
+
+  * bugfix release which itself had to be fixed, see bugfix, 0.1.2-17 of 2005w04/4
+
+%% *Withdrawn* - SiSU Sabaki, version 0.1.2-15 of 2005w04/3 (2005-01-26):
+  sisu-sabaki_0.1.2-15_2005w04-3.tar.gz
+  SHA1(sisu-sabaki_0.1.2-15_2005w04-3.tar.gz)=
+  5b101f13f4cef41989ace6d801b657ab559f95c5
+
+  * in keeping with markup ergonomics, emphasis, i.e. word list to be made bold
+    and italics can be adjusted in skins as well as in headers (0.1.2-14), or
+    directly in text (as before), see 0.1.2-14 release and notes below for
+    general details.
+
+  * See bugfix, 0.1.2-17 of 2005w04/4
+
+%% SiSU Sabaki, version 0.1.2-14 of 2005w04/3 (2005-01-26):
+  sisu-sabaki_0.1.2-14_2005w04-3.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-14_2005w04-3.tar.gz
+  SHA1(sisu-sabaki_0.1.2-14_2005w04-3.tar.gz)=
+  55cb833cae5cd8e4e2c44ff09c9574a90877275b
+
+  * auto-detect and configure output directory (autorun sisu -C if related
+    directories are not detected)
+
+  * minor touch to Rakefile
+
+  * in keeping with markup ergonomics, word list to emphasise, ie bold and
+    italics can be added in document headers,[*] where a word is to be
+    consistently tagged in this way
+
+  * documentation updated accordingly
+
+%% SiSU Sabaki, version 0.1.2-13 of 2005w03/0 (2005-01-23):
+  sisu-sabaki_0.1.2-13_2005w03-0.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-13_2005w03-0.tar.gz
+  SHA1(sisu-sabaki_0.1.2-13_2005w03-0.tar.gz)=
+  dc540fe8152651dec93454401e6703064734b4bc
+
+  * Rakefile updated (rake help)
+
+%% SiSU Sabaki, version 0.1.2-12 of 2005w03/6 (2005-01-22):
+  sisu-sabaki_0.1.2-12_2005w03-6.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-12_2005w03-6.tar.gz
+  SHA1(sisu-sabaki_0.1.2-12_2005w03-6.tar.gz)=
+  1674a9189c30726be2225b8576eae847ab9aaaee
+
+  * Rakefile added (sudo rake)
+
+%% SiSU Sabaki, version 0.1.2-11 of 2005w03/5 (2005-01-21):
+  sisu-sabaki_0.1.2-11_2005w03-5.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-11_2005w03-5.tar.gz
+  SHA1(sisu-sabaki_0.1.2-11_2005w03-5.tar.gz)=
+  1eb07edd9f3e83cd4792f2c4c533fb97d70bac72
+
+  * removed install.rb which has been stripped of almost all function (and rely
+    on setup.rb)
+
+%% SiSU Sabaki, version 0.1.2-10 of 2005w03/5 (2005-01-21):
+  sisu-sabaki_0.1.2-10_2005w03-5.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-10_2005w03-5.tar.gz
+  SHA1(sisu-sabaki_0.1.2-10_2005w03-5.tar.gz)=
+  375b0bf022d2c0f8a73ded67c4155821b6afa0bb
+
+  * some basic default install issues...
+
+  * Minero Aoki's setup.rb used for basic installation, but rough home brew
+    install.rb copies remaining required files to /etc. setup.rb used to
+    install sisu package (bin,lib,data) apart from the /etc directory.
+    install.rb used for /etc only. Will switch to using only setup.rb when it
+    sets up etc in addition to bin, lib, and data. When there is time,
+    (possibly as late as next month) will work towards having a release that
+    uses setup.rb for installation.
+
+%% SiSU Sabaki, version 0.1.2-9 of 2005w03/4 (2005-01-20):
+  sisu-sabaki_0.1.2-9_2005w03-4.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-9_2005w03-4.tar.gz
+  SHA1(sisu-sabaki_0.1.2-9_2005w03-4.tar.gz)=
+  c0080dc1f58f8889845ac34c38d995bc7e33badc
+
+  * only change is to man pages
+
+%% SiSU Sabaki, version 0.1.2-8 of 2005w03/3 (2005-01-19):
+  sisu-sabaki_0.1.2-8_2005w03-3.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-8_2005w03-3.tar.gz
+  SHA1(sisu-sabaki_0.1.2-8_2005w03-3.tar.gz)=
+  4fa129cc49d5ecf1f4deed14129904e6bd6bf37a
+
+  * Still pre-setup.rb
+
+  * Minero Aoki's setup.rb and the rough home brew install.rb put together for
+    sisu, both included...
+
+  * setup.rb included and can be used to install sisu package (bin,lib,data)
+    apart from the /etc directory
+
+  * install.rb still used for general installation of sisu package (bin,lib,etc),
+    it does nothing with data directory
+
+  * man page updated, and can be "installed" using setup.rb
+
+%% SiSU Sabaki, version 0.1.2-7 of 2005w03/3 (2005-01-19):
+  sisu-sabaki_0.1.2-7_2005w03-3.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-7_2005w03-3.tar.gz
+  SHA1(sisu-sabaki_0.1.2-7_2005w03-3.tar.gz)=
+  9953ecc0a3e3e23733e734c09210507649f3dc62
+
+  * Still pre-setup.rb
+
+  * directory structure maps that used by setup.rb
+
+%% SiSU Sabaki, version 0.1.2-6 of 2005w03/3 (2005-01-19):
+  sisu-sabaki_0.1.2-6_2005w03-3.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-6_2005w03-3.tar.gz
+  SHA1(sisu-sabaki_0.1.2-6_2005w03-3.tar.gz)=
+  10dea0de4424180b8af2413a95c165286022eafe
+
+Previous bundle inclomplete, and withdrawn
+SHA1(sisu-sabaki_0.1.2-5_2005w03-2.tar.gz)=
+6c39c531356e7a954d9e49c6fac4541fe6f9ce89
+
+  * Still pre-setup.rb
+
+  * using yaml instead of pstore for version info, taken from read-only /etc
+
+  * no attempt to setup ~/.sisu resource configuration directory, make it
+    yourself as required.
+
+%% SiSU Sabaki, version 0.1.2-4 of 2005w03/1 (2005-01-17):
+  sisu-sabaki_0.1.2-4_2005w03-1.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-4_2005w03-1.tar.gz
+  SHA1(sisu-sabaki_0.1.2-4_2005w03-1.tar.gz)=
+  80e8a4ebfac3989174a0b9be7afa5cc9dc22e935
+
+  * minor fix made to LaTeX for pdfs (package loaded twice)
+
+  * minor fix made to example cgi search form, front-end for Postgresql db, (a
+    counter contained a typo, plus cosmetic touches)
+
+%% SiSU Sabaki, version 0.1.2-3 of 2005w02/4 (2005-01-13):
+  sisu-sabaki_0.1.2-3_2005w02-4.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-3_2005w02-4.tar.gz
+  SHA1(sisu-sabaki_0.1.2-3_2005w02-4.tar.gz)=
+  b94ff6f770d11a9ef33fa989b8aeefa07aac6432
+
+  * Installation and configuration issues.
+
+  * does output check on directory permissions, and defaults to home directory if
+    web server directory does not have write permission
+
+  * can switch off external programs that are unavailable in resource
+  configuration file
+
+  * note in README on which external programs are used
+
+  * bug detected [2005-01-16] in released behaviour of object citation numbering,
+    tables should be numbered.  Not yet fixed. Unlikely to touch before
+    mid-February.
+    Not certain when behaviour changed. It appears to be pre-introduction of
+    new table syntax. Each table gets an ocn, required amongst other things for
+    relational database. Check consistency of ocn elsewhere.
+
+%% SiSU Sabaki, version 0.1.2-2 of 2005w02/2 (2005-01-11):
+  sisu-sabaki_0.1.2-2_2005w02-2.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-2_2005w02-2.tar.gz
+  SHA1(sisu-sabaki_0.1.2-2_2005w02-2.tar.gz)=
+  7ca13bb377bb7403cf2b9436984c2c8a1ac629b3
+
+  * manual location anchor/marker/tagging provided for html, (at present in html
+    only, adds nothing to other output types).  Interactive help (and SiSU_MARKUP
+    textfile in tar bundle) updated accordingly.
+    Very minor code addition, has existed previously, decided is still useful
+    on some occasions. Use sparingly, the author is currently responsible for
+    non-duplication of such names. There is a remote possibility it breaks
+    something. An example of such a link:
+    http://www.jus.uio.no/sisu/SiSU/2004#ibm
+    http://www.jus.uio.no/sisu/SiSU/2004#2004-06-17 
+
+  * endnotes were missing from the html full length, scroll outputs, and are now
+    back.
+
+  * skins included (now properly marked for revision control - or rather
+    accidental marking as "boring" removed for darcs).
+
+%% SiSU Sabaki, version 0.1.2-1 of 2005w02/1 (2005-01-10):
+  sisu-sabaki_0.1.2-1_2005w02-1.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-1_2005w02-1.tar.gz
+  SHA1(sisu-sabaki_0.1.2-1_2005w02-1_sha1)=
+  6afa36b152359da215df84244cb156c2ee61d61f
+  
+  * previous bundle not quite complete (skins missing) - [still missing were
+    marked incorrectly for darcs revision control exclusion]
+
+  * also previous version 0.1.2-0 despite its name worked as part of previous
+  0.1.1 version, directories created etc.
+
+%% SiSU Sabaki, version 0.1.2-0 of 2005w01/0 (2005-01-09):
+  sisu-sabaki_0.1.2-0_2005w01-0.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.2-0_2005w01-0.tar.gz
+  SHA1(sisu-sabaki_0.1.2-0_2005w01-0_sha1)=
+  7c500761f8aadb55faaf3aec4d20996f38462ece
+
+  * syntax tidying and small additions, old syntax remains effective, but
+    possibility to reduce some repetatition. See interactive help on markup
+    which has been updated accordingly, and within bundle SiSU_MARKUP.txt
+
+  * bugfix, pdf: corrects inconsistent behaviour in marking up urls in
+    footnotes, should be live hyperlinks and small font, introduced in 0.1.1-2
+
+  * bugfix, metaverse: tables with headings did not previously work with
+    updated table syntax, in release 0.1.1-2
+
+%% *Withdrawn* - SiSU Sabaki, version 0.1.1-3 of 2005w01/6 (2005-01-08):
+  sisu-sabaki_0.1.1-3_2005w01-6.tar.gz
+  SHA1(sisu-sabaki_0.1.1-3_2005w01-6.tar.gz)=
+  21d9591f1c069e7111470b2bc98751a36833030d
+
+  * The default markup for: tables, grouped text, poems, code etc. has been
+    tidied/simplified. These are changes that have been planned for some time
+    and bring the style for these in line with the other markup syntax used.
+    The default syntax has been stable for a few years now, I thought this best
+    done prior to use by others. Note however: the previous syntax form is
+    still supported but depreciated. The default syntax has been stable for a
+    few years now.
+
+  * For help on markup syntax see one of the following:
+
+    interactive help - type 'sisu help tables'
+
+    marked up text samples
+
+    the SiSU_Markup.txt file provided with the program
+
+  * Quick fixes have been made to the vim syntax file which is provided.
+
+  [Will slow down updates for a while though there are still issues with the install.]
+
+%% *Withdrawn* - SiSU Sabaki, version 0.1.1-2 of 2005w01/6 (2005-01-08):
+  SHA1(sisu-sabaki_0.1.1-2_2005w01-6.tar.gz)=
+  6acb02f98d100ff9a7f7a01ad71b88c215488009
+  
+  * Few lines of code changed from 0.1.1-2, which is withdrawn.
+
+%% SiSU Sabaki, version 0.1.1-1 of 2005w01/5 (2005-01-07):
+  sisu-sabaki_0.1.1-1_2005w01-5.tar.gz
+  http://www.jus.uio.no/sisu/download/sisu-sabaki_0.1.1-1_2005w01-5.tar.gz
+  SHA1(sisu-sabaki_0.1.1-1_2005w01-5_sha1)=
+  541bad03cba1bcb35c2582534e4312acc0bacd70
+
+  * install touch
+
+  * version information moved
+
+  * Still things to sort out with installation
+
+  * Manually change ownership on the resource configuration directory
+
+%% SiSU Sabaki, version 0.1.1-0 of 2005w01/4 (2005-01-06):
+  sisu_0.1.1-0_2005w01-4.tgz
+  http://www.jus.uio.no/sisu/download/sisu_0.1.1-0_2005w01-4.tgz
+  SHA1(sisu_0.1.1-0_2005w01-4.tgz)=
+  ff5ca4cf45d34ca3a6491e8ba29da30474b47b2b
+
+  * Modifications to installation script, configuration paths, and help only.
+
+  * Install script a bit smarter, (also installs the configuration files that
+    come along with the sample marked up documents) and more information
+    provided on paths, both by the install script and interactive help once
+    installed. Not much effort spent on installer, however, he directory
+    structure used is fine, paths may need to be reset, and information
+    provided on what is being attempted should make it easier to figure out
+    what may need to be done should problems arise.
+
+  [preferably run old remove script prior to install... otherwise you link
+  /usr/local/bin/sisu to /usr/local/bin/sisu-0.1.1]
+
+First release of SiSU - sisu_0.1.0-9_2005w01-2.tgz
+  http://www.jus.uio.no/sisu/download/sisu_0.1.0-9_2005w01-2.tgz
+  SHA1(sisu_0.1.0-9_2005w01-2.tgz)=
+  14b230ba5a4c8f1c7264b38cd2d9c95a97477f3a 
+
+  SiSU Sabaki, version 0.1.0-9 of 2005w01/2 (2005-01-04) was released to the
+  public on January 4th 2005. It may be downloaded from:
+    http://www.jus.uio.no/sisu/download/sisu_0.1.0-9_2005w01-2.tgz
+
+%% DEVELOPMENT (Merged into STABLE) MANIFEST (@ 0.1.5 branch)
+
+SiSU Sabaki development-branch, version 0.5.8 of 2005w15-0 [==0.4.3]
+
+SiSU Sabaki development-branch, version 0.5.4 of 2005w15-4 [==0.4.2]
+
+SiSU Sabaki development-branch, version 0.5.3 of 2005w15-3 [==0.4.1]
+
+SiSU Sabaki development-branch, version 0.5.0 of 2005w15-2 [==0.4.0]
+
+SiSU Sabaki development-branch, version 0.3.0 of 2005w14-0 [==0.1.5-58]
+* substantively the same as 0.2.0 [== 0.1.4-11]
+
+SiSU Sabaki development-branch, version 0.1.5-58 of 2005w14/6
+* substantively the same as 0.1.4-11
+
+SiSU Sabaki development-branch, version 0.1.5-55 of 2005w13/6
+* substantively the same as 0.1.4-10
+
+SiSU Sabaki development-branch, version 0.1.5-46 of 2005w13/2
+* substantively the same as 0.1.4-9
+
+SiSU Sabaki development-branch, version 0.1.5-44 of 2005w13/2
+* substantively the same as 0.1.4-8 
+
+SiSU Sabaki development-branch, version 0.1.5-33 of 2005w12/3
+* substantively the same as 0.1.4-7 
+
+SiSU Sabaki development-branch, version 0.1.5-29 of 2005w12/1
+* substantively the same as 0.1.4-6 
+
+SiSU Sabaki development-branch, version 0.1.5-21 of 2005w11/2
+* substantively the same as 0.1.4-5 
+
+SiSU Sabaki development-branch, version 0.1.5-20 of 2005w11/1
+* substantively the same as 0.1.4-4 
+
+SiSU Sabaki development-branch, version 0.1.5-15 of 2005w10/4 
+* substantively the same as 0.1.4-3 
+
+SiSU Sabaki development-branch, version 0.1.5-12 of 2005w10/4 
+* substantively the same as 0.1.4-2 
+
+SiSU Sabaki development-branch, version 0.1.5-11 of 2005w10/2 
+* substantively the same as 0.1.4-1 
+
+SiSU Sabaki development-branch, version 0.1.5-0 of 2005w06/4 
+* substantively the same as 0.1.4-0 
+
diff --git a/data/doc/sisu/README b/data/doc/sisu/README
new file mode 100644
index 00000000..a688fcb5
--- /dev/null
+++ b/data/doc/sisu/README
@@ -0,0 +1,422 @@
+SiSU 0.49 2007w08/5 20070223
+homepage: http://www.jus.uio.no/sisu
+
+%% Description
+---------------
+
+  SiSU is lightweight markup based document creation and publishing framework
+  that is controlled from the command line.  Prepare documents for SiSU using
+  your text editor of choice, then use SiSU to generate various output document
+  formats.
+ 
+  With minimal preparation of a plain-text (UTF-8) file using its native
+  markup-syntax, SiSU produces: plain-text, HTML, XHTML, XML, ODF:ODT
+  (Opendocument), LaTeX, PDF, and populates an SQL database (PostgreSQL or
+  SQLite) in paragraph sized chunks so that document searches are done at this
+  "atomic" level of granularity.
+ 
+  Outputs share a common citation numbering system, and any semantic meta-data
+  provided about the document.
+ 
+  SiSU also provides concordance files, document content certificates and
+  manifests of generated output.
+
+    SiSU takes advantage of well established open standard ways of representing
+    text, and provides a bridge to take advantage of the strengths of each,
+    while remaining simple. 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).
+ 
+  A vim syntax highlighting file and an ftplugin with folds for sisu markup is
+  provided. 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
+
+-----
+
+SiSU - simple information structuring universe, is a publishing tool, document
+generation and management, (and search enabling) tool primarily for literary, 
+academic and legal works.
+
+SiSU can be used for Internet, Intranet, local filesystem or cd publishing.
+
+SiSU can be used directly off the filesystem, or from a database.
+
+SiSU's scalability, is be dependent on your hardware, and filesystem (in my
+case Reiserfs), and/or database Postgresql.
+
+Amongst it's characteristics are: 
+
+* simple mnemonoic markup style,
+
+* the ability to produce multiple output formats, including
+html, structured XML, LaTeX, pdf (via LaTeX), stream to a relational database
+whilst retaining document structure - Postgresql and Sqlite,
+
+* that all share a common citation system (a simple idea from which much good),
+possibly most exciting, the following: if fed into a relational database (as it
+can be automatically), the document set is searchable, with results displayed
+at a paragraph level, or the possibility of an indexed display of documents in
+which the match is found together with a hyperlinked listing for each of each
+paragraph in which the match is found. In any event citations using this system
+(with or without the relational database) are relevant for all output formats.
+
+* it is command line driven, and can be set up on a remote server
+
+* Documents are marked up in SiSU syntax in your favourite editor. SiSU syntax
+may be regarded as a type of smart ascii - which in its basic form is simpler
+than the most elementary html. There is currently a syntax highlighter, and
+folding for Vim. Syntax highlighters for other editors are welcome.
+
+Input files should be UTF-8
+
+Once set up it is simple to use.
+
+%% Online Information, places to look
+---------------
+
+http://www.jus.uio.no/sisu
+
+Download Sources:
+  http://www.jus.uio.no/sisu/SiSU/download.html#current
+  http://www.jus.uio.no/sisu/SiSU/download.html#debian
+or the same:
+  http://www.jus.uio.no/sisu/sisu_download/download.html#current
+  http://www.jus.uio.no/sisu/sisu_download/download.html#debian
+
+%% Installation
+---------------
+NB. Platform is Unix / Linux.
+
+%% Debian
+---------------
+If you use Debian use the Debian packages, 
+check the information at:
+  http://www.jus.uio.no/sisu/SiSU/download.html#debian
+  http://www.jus.uio.no/sisu/sisu_download/download.html#debian
+
+(A) SiSU is available directly off the Debian archives for Sid and testing. It
+should necessary only to run as root:
+
+  aptitude update
+  aptitude install sisu-complete
+
+(B) If there are newer versions of SiSU upstream of the Debian archives, they
+will be available by adding the following to your /etc/apt/sources.list
+
+  deb http://www.jus.uio.no/sisu/archive unstable main non-free
+  deb-src http://www.jus.uio.no/sisu/archive unstable main non-free
+
+   [the non-free line is for document markup
+   samples, for which the substantive text is
+   provided under the author or original
+   publisher's license and which in most cases will
+   not be debian free software guideline compliant]
+
+Then as root run:
+  aptitude update
+  aptitude install sisu-complete
+
+%% RPM
+---------------
+RPMs are provided though untested, they are prepared by running alien against the
+source package, and against the debs.
+
+They may be downloaded from:
+  http://www.jus.uio.no/sisu/SiSU/download.html#rpm
+
+%% Source package .tgz
+---------------
+Otherwise to install SiSU from source, check information at:
+  http://www.jus.uio.no/sisu/SiSU/download.html#current
+  http://www.jus.uio.no/sisu/sisu_download/download.html#current
+
+two alternative modes of installation from source are provided, 
+setup.rb (by Minero Aoki) and a rant(by Stefan Lang) built install file,
+in either case: the first steps are the same, download and unpack the 
+source file:
+
+1. Download the latest source (information available) from:
+  http://www.jus.uio.no/sisu/SiSU/download.html#current
+
+2. Unpack the source
+
+%% to use setup.rb
+---------------
+this is a three step process,
+in the root directory of the unpacked SiSU as root type:
+
+    ruby setup.rb config 
+    ruby setup.rb setup 
+    #[as root:]
+    ruby setup.rb install
+
+  further information:
+    http://i.loveruby.net/en/projects/setup/
+    http://i.loveruby.net/en/projects/setup/doc/usage.html
+  
+%% to use install (prapared with "Rant")
+---------------
+in the root directory of the unpacked SiSU as root type:
+  ruby install
+
+or
+  ruby install base
+
+This makes use of Rant (by Stefan Lang) and the provided Rantfile. It has been
+configured to do post installation setup setup configuration and generation of
+first test file. Note however, that additional external package dependencies,
+such as tetex-extra are not taken care of for you.
+  
+  further information:
+    http://make.rubyforge.org/
+    http://rubyforge.org/frs/?group_id=615
+
+For a list of alternative actions you may type:
+  ruby install help
+  ruby install -T
+
+Dependencies
+--------------
+Once installed see 'man 8 sisu' for some information on additional programs
+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 SiSU with or without a database, ...) 'man sisu_markup-samples' may also be of
+interest if the sisu-markup-samples package has also been installed.
+
+The information in man 8 may not be most up to date, and it is possible that
+more useful information can be gleaned from the following notes taken from the
+Debian control file (end edited), gives an idea of additional packages that
+SiSU can make use of if available, (the use/requirement of some of which are
+interdependent for specific actions by SiSU):
+
+Package: sisu
+Depends: ruby (>= 1.8.4), libwebrick-ruby
+Recommends: sisu-pdf, sisu-sqlite, sisu-postgresql, librmagick-ruby, trang,
+  tidy, librexml-ruby, zip, unzip, openssl, rsync, openssh-client | lsh-client,
+  keychain, hyperestraier, kdissert
+Suggests: libfcgi-ruby1.8, rcs | cvs, lv, texinfo, pinfo, rename
+
+Package: sisu-complete
+Depends: ruby (>= 1.8.4), sisu, sisu-pdf, sisu-postgresql, sisu-sqlite
+Recommends: hyperestraier
+
+Package: sisu-pdf
+Depends: sisu, tetex-bin | texlive-base-bin, tetex-extra | texlive-latex-extra,
+  texlive-latex-extra, latex-ucs
+Suggests: evince, xpdf
+
+Package: sisu-postgresql
+Depends: sisu, postgresql-8.1, libdbi-ruby, libdbm-ruby, libdbd-pg-ruby
+Suggests: pgaccess, libdbd-pgsql, postgresql-contrib-8.1
+
+Package: sisu-sqlite
+Depends: sisu, sqlite, libdbi-ruby, libdbm-ruby, libdbd-sqlite-ruby
+Suggests: libdbd-sqlite
+
+Package: sisu-markup-samples
+Depends: sisu
+
+%% Quick start
+---------------
+Most of the installation should be taken care of by the aptitude or rant
+install. (The rant install if run in full will also test run the generation of
+the first document).
+
+After installation of sisu-complete, move to the document samples directory
+
+  cd /usr/share/doc/sisu/sisu_markup_samples/dfsg
+
+and run
+
+  sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst
+
+[or the same:
+  sisu  -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst
+]
+
+look at output results, see the "sisu_manifest" page created for the document
+
+or to generate an online document move to a writable directory, as the file
+will be downloaded there and e.g.
+
+sisu -3 http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst
+
+the database stuff is extra perhaps, the latex stuff could be considered extra
+perhaps but neither needs to be installed for most of sisu output to work
+
+examine source document, vim has syntax support
+
+gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst
+
+additional markup samples in
+http://www.jus.uio.no/sisu/SiSU/2.html
+
+For help
+ man sisu
+
+or
+ sisu --help
+
+e.g.
+sisu --help env
+for the way sisu "sees/maps" your system
+sisu --help commands
+for list of commands and so on
+
+%% Configuration files
+---------------
+
+The default configuration/setup is contained within the program and is altered
+by configuration settings in /etc/[sisu version]/sisurc.yml
+or in ~/.sisu/sisurc.yml
+
+* configuration file - a yaml file 
+  /etc/sisu/[sisu version]/sisurc.yml
+  ~/.sisu/sisurc.yml
+
+* directory structure - setting up of output and working directory.
+
+* skins - changing the appearance of a project, directory or individual
+documents within ~/.sisu/skin
+  ~/.sisu/skin/doc contains individual skins, with symbolic links from
+  ~/.sisu/skin/dir if the contents of a directory are to take a particular
+  document skin.
+
+* additional software - eg. Tex and LaTeX (tetex, tetex-base, tetex-extra on
+Debian), Postgresql, [sqlite], trang, tidy, makeinfo,  ... none of which are
+required for basic html or XML processing. 
+
+* if you use Vim as editor there is a syntax highlighter and fold resource
+config file for SiSU. I hope more syntax highlighters follow.
+
+There are post installation steps (which are really part of the overall
+installation)
+
+sisu -C in your marked up document directory, should do some auto-configuring
+provided you have the right permissions for the output directories. (and
+provided the output directories have already been specified if you are not
+using the defaults).
+
+%% Use General Overview
+---------------
+Documents are marked up in SiSU syntax and kept in an ordinary text editable
+file, named with the suffix .sst, or .ssm
+
+Marked up SiSU documents are usually kept in a sub-directory of your choosing
+
+use the interactive help and man pages
+  sisu --help
+  man sisu
+
+%% Help
+---------------
+
+interactive help described below, or man page:
+
+  man sisu
+
+  man 8 sisu
+ 'man sisu_markup-samples' [if the sisu-markup-samples package is also installed]
+
+Once installed an interactive help is available typing 'sisu' (without) any
+flags, and select an option:
+
+  sisu
+
+alternatively, you could type e.g.
+  sisu --help commands
+  sisu --help env
+  sisu --help headers
+  sisu --help markup
+  sisu --help headings
+  etc.
+
+for questions about mappings, output paths etc.
+  sisu --help env
+  sisu --help path
+  sisu --help directory
+
+%% Directory Structure
+---------------
+Once installed, type:
+  sisu --help env
+
+%% Configuration File
+---------------
+
+The defaults can be changed via SiSU's configure file sisurc.yml which the
+program expects to find in ./_sisu ~/.sisu or /etc/sisu
+
+%% Markup
+---------------
+
+See man pages.
+  man sisu
+
+Once installed there is some information on SiSU Markup in its help:
+  sisu --help markup
+and
+  sisu --help headers
+
+Sample marked up document are provided with the download tarball in the
+directory:
+  ./data/doc/sisu/sisu_markup_samples/dfsg
+
+These are installed on the system usually at:
+  /usr/share/doc/sisu/sisu_markup_samples/dfsg
+
+More markup samples are available in the package sisu-markup-samples
+
+Many more are available online off:
+  http://www.jus.uio.no/sisu/SiSU/2.html
+
+%% Additional Things
+---------------
+
+There is syntax support for some editors provided (together with a README file) in
+
+  ./data/sisu/conf/syntax
+
+usually installed to:
+
+  /usr/share/sisu/conf/syntax
+
+%% License
+---------------
+
+License: GPL 2 or later see the copyright file in
+
+  ./data/doc/sisu
+
+usually installed to:
+
+  /usr/share/doc/sisu
+
+%% SiSU Standard
+-----------------
+
+SiSU uses:
+
+*  Standard SiSU markup syntax,
+*  Standard SiSU meta-markup syntax, and the
+*  Standard SiSU object citation numbering and system
+
+© Ralph Amissah 1997, current 2006.
+All Rights Reserved.
+
+* however note the License section
+
+
diff --git a/data/doc/sisu/copyright b/data/doc/sisu/copyright
new file mode 100644
index 00000000..06b9f0e1
--- /dev/null
+++ b/data/doc/sisu/copyright
@@ -0,0 +1,67 @@
+This is sisu, written and maintained by Ralph Amissah <ralph@amissah.com>
+on Mon, 2 May 2005 17:33:58 +0100.
+
+The homepage is:
+  <http://www.jus.uio.no/sisu>
+
+The original source can always be found at:
+	<http://www.jus.uio.no/sisu/SiSU/download>
+	<http://www.jus.uio.no/sisu/pkg/src>
+
+Copyright (C) 1997, 1998, 1999, 2000, 20001, 2002, 2003, 2004, 2005
+Ralph Amissah
+
+License: GPL 2 or later
+
+  GPL2 summary:
+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this package; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+  MA 02110-1301, USA
+
+  If you have Internet connection, the latest version of the GPL should be
+  available from these locations:
+    <http://www.fsf.org/licenses/gpl.html>
+    <http://www.gnu.org/copyleft/gpl.html>
+    <http://www.jus.uio.no/sisu/gpl2.fsf>
+
+  On Debian systems, the complete text of the GNU General
+  Public License can be found in `/usr/share/common-licenses/GPL'.
+
+  The Free Software Foundation:
+    <http://www.fsf.org/>
+
+For installation purposes the SiSU tarball includes
+
+setup.rb by Minero Aoki
+
+Hompepage:
+  <http://i.loveruby.net/en/projects/setup/>
+
+License:
+  LGPL
+
+and 
+
+install, an installer generated by
+Rant which is by Stefan Lang
+
+Homepage:
+  <http://make.rubyforge.org/>
+
+License:
+  LGPL
+
+NB: Rant is not included in the SiSU tarball, and is not itself required for
+    the Rant generated install file to work
diff --git a/data/doc/sisu/html/README b/data/doc/sisu/html/README
new file mode 100644
index 00000000..1c320ced
--- /dev/null
+++ b/data/doc/sisu/html/README
@@ -0,0 +1 @@
+SiSU man pages 0.48 (last major syntax additions 0.38)
diff --git a/data/doc/sisu/html/homepage/index.html b/data/doc/sisu/html/homepage/index.html
new file mode 100644
index 00000000..8493cffd
--- /dev/null
+++ b/data/doc/sisu/html/homepage/index.html
@@ -0,0 +1,264 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<title>SiSU information Structuring Universe - Structured
+information, Serialized Units - software for electronic texts,
+documents, books, digital libraries in plaintext, html, xhtml, XML,
+ODF (OpenDocument), LaTeX, pdf, SQL (PostgreSQL and SQLite), and
+for search</title>
+<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
+<meta name="dc.title" content=
+"SiSU information Structuring Universe, Structured information Serialised Units, 2007" />
+<meta name="dc.creator" content="Ralph Amissah" />
+<meta name="dc.subject" content=
+"ebook, publishing, pdf, LaTeX, XML, ODF, SQL, postgresql, sqlite, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search, digital library" />
+<meta name="dc.publisher" content=
+"SiSU http://www.jus.uio.no/sisu" />
+<meta name="dc.language" content="en" />
+<meta name="dc.rights" content="Copyright Ralph Amissah" />
+<meta name="generator" content="SiSU 0.48.9 of 2007w01/1 (20070101) (n*x and Ruby!)" />
+<link rel="generator" href="http://www.jus.uio.no/sisu/SiSU" />
+<link rel="stylesheet" href="./_sisu/css/html.css" type="text/css" />      
+<link rel="shortcut icon" href="./_sisu/image/rb7.ico" />
+</head>
+<body>
+<div id="top_band">
+<p class="top_band_image">
+  <a href="http://www.jus.uio.no/sisu/SiSU" target="_top" >
+    <img border="0" src="./_sisu/image/sisu.png" alt="SiSU &gt;&gt;">
+  </a>
+</p>
+<h1 class="top_band">
+  SiSU information Structuring Universe
+</h1>
+<h2 class="top_band_tiny">
+  Structured information, Serialized Units
+</h2>
+<h2 class="top_band_tiny">
+software for electronic texts, document collections, books, digital libraries, and search
+</h2>
+<h2 class="top_band_tiny">
+ with "atomic search" and text positioning system (shared text citation numbering: "<i>ocn</i>")
+</h2>
+<h2 class="top_band_tiny">
+outputs include: plaintext, html, xhtml, XML, ODF (OpenDocument), LaTeX, pdf, SQL (PostgreSQL and SQLite)
+</h2>
+</div>
+<div id="column_left">
+<p class="bold">
+  <a href="http://www.jus.uio.no/sisu/SiSU" target="_top" >
+    SiSU
+  </a>
+</p>
+<p class="tiny">
+  ---
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/SiSU/1.html#summary" target="_top" >
+    What does SiSU do? Summary
+  </a>
+</p>
+<p class="tiny">
+  ---
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/SiSU/2.html" target="_top" >
+    Book Samples and Markup Examples
+  </a>
+</p>
+<p class="tiny">
+  ---
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/SiSU/1.html#ocn" target="_top" >
+    Object Citation Numbering - <i>ocn</i>
+  </a>
+</p>
+<p class="tiny">(a text positioning system)</p>
+<p class="tiny">
+  ---
+</p>
+<p class="small">
+<p>
+  <a href="http://www.jus.uio.no/sisu/SiSU/1.html#search" target="_top" >
+    Search - "<i>Atomic</i>"
+  </a>
+</p>
+<p class="tiny">
+  Of interest is the ease of streaming documents to a relational database, at an object (roughly paragraph) level and the potential for increased precision in the presentation of matches that results thereby. The ability to serialise html, LaTeX, XML, SQL, (whatever) is also inherent in / incidental to the design. For a description see the
+  <a href="http://www.jus.uio.no/sisu/sisu_provisional_patent_application_200408" target="_top" >
+    abandoned U.S. provisional patent application
+  </a>
+</p>
+<p class="tiny">
+  ---
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/SiSU/download.html" target="_top" >
+    <b>Download</b>
+  </a>
+</p>
+<p class="tiny">
+  ---
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/SiSU/changelog.html" target="_top" >
+    Changelog
+  </a>
+</p>
+<p class="tiny">
+  ---
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/SiSU/license.html" target="_top" >
+    License
+  </a>
+</p>
+<p class="tiny">
+  Gnu / Linux / Unix
+</p>
+<p class="tiny">
+  =============
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/man" target="_top" >
+    sisu man pages
+  </a>
+</p>
+<p class="tiny">
+  ---
+</p>
+<p class="tiny">
+  document preparation can be on any platform, in any editor:
+  (syntax highlight support currently for: vim, kate, write, gedit, diakonos)
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/syntax_highlight" target="_top" >
+    Syntax highlighting
+  </a> 
+</p>
+<p class="tiny">
+  =============
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/SiSU" target="_top" >
+    * Composite document
+  </a>
+</p>
+<p class="tiny">
+  the composite document is a superset of the following documents:
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_description" target="_top" >
+    SiSU description
+  </a>
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_examples" target="_top" >
+    SiSU examples
+  </a>
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_chronology" target="_top" >
+    SiSU chronology
+  </a>
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_technical_info" target="_top" >
+    SiSU technical
+  </a>
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_faq" target="_top" >
+    SiSU FAQ
+  </a>
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_download" target="_top" >
+    SiSU download
+  </a>
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_changelog" target="_top" >
+    SiSU changelog
+  </a>
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_license" target="_top" >
+    SiSU license
+  </a>
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_standard" target="_top" >
+    SiSU standard
+  </a>
+</p>
+<p class="small">
+  <a href="http://www.jus.uio.no/sisu/sisu_provisional_patent_application_200408" target="_top" >
+    SiSU abandoned provisional patent
+  </a>
+</p>
+<p class="tiny">
+  Note: the placement of SiSU documents on the Net predate the release of SiSU.
+</p>
+</div>
+<div id="column_center">
+<p class="bold">
+  For less markup than the most elementary HTML you can have so much more.
+</p>
+<p><a href="http://www.jus.uio.no/sisu/SiSU" target="_top" ><b>SiSU</b> - Structured information, Serialized Units</a> for Electronic Documents, is an information structuring, transforming and publishing framework with the following features:</p>
+<p><b>(i)</b> markup syntax: (a) simpler than html, (b) mnemonic, influenced by mail/messaging/wiki markup practices, (c) human readable, and easily writable,</p>
+<p><b>(ii)</b> (a) minimal markup requirement, (b) single file marked up for multiple outputs,</p>
+<p><b>(iii)</b> (a) multiple outputs include amongst others: html; pdf via LaTeX; (structured) XML; ODF (OpenDocument); sql - currently PostgreSQL (and SQLite); ascii, (also texinfo), (b) takes advantage of the strengths implicit in these very different output types, (e.g. pdfs produced using typsetting of LaTeX, databases populated with documents at an individual object/paragraph level, with implications for search possibilities...)</p>
+<p><b>(iv)</b> provides a common object positioning and citation system for all outputs, which is human relevant and machine usable: <u><i>object citation numbering</i></u>, all objects (paragraphs, headings, verse, tables etc. and images) are numbered identically, for citation purposes, in all outputs (html, pdf, sql etc.),</p>
+<p><b>(v)</b> use of Dublin Core and other meta-tags to permit the addition of some semantic information on documents, and making easy integration of rdf/rss feeds etc.,</p>
+<p><b>(vi)</b> creates organised directory/file structure for (file-system) output, easily mapped with its clearly defined structure, with all text objects numbered, you know in advance where in each document output type, a bit of text will be found (eg. from an sql search, you know where to go to find the prepared html output or pdf etc.)... there is more; easy directory management and document associations, the document preparation (sub-)directory may be used to determine output (sub-)directory, the skin used, and the sql database used,</p>
+<p><b>(vii)</b> search of document sets, at object/paragraph level, the relational database retains information on the document structure, and citation numbering makes it possible for example to present search matches as an index of documents and locations within the document where the match is found,</p>
+<p><b>(viii)</b> "Concordance file" wordmap, consisting of all the words in a document and their (text/ object) locations within the text, (and the possibility of adding vocabularies),</p>
+<p><b>(ix)</b> document content certification and comparison considerations: (a) the document and each object within it stamped with an md5 hash making it possible to easily check or guarantee that the substantive content of a document is unchanged, (b) version control, documents integrated with time based source control system, default RCS or CVS with use of $Id$ tag, which SiSU checks
+<p><b>(x)</b> SiSU's minimalist markup makes for meaningful "diffing" of the substantive content of markup-files,</p>
+<p><b>(xi)</b> easily skinnable, document appearance on a project/site wide, directory wide, or document instance level easily controlled/changed,</p>
+<p><b>(xii)</b> in many cases a regular expression may be used (once in the document header) to define all or part of a documents structure obviating or reducing the need to provide structural markup within the document,</p>
+<p><b>(xiii)</b> is a batch processor for handling large document sets, ... though once generated they need not be re-generated, unless changes are made to the desired presentation of a particular output type,</p>
+<p><b>(xiv)</b> possible to pre-process, which permits: the easy creation of standard form documents, and templates/term-sheets, or; building of composite documents (master documents) from other sisu marked up documents, or marked up parts, i.e. import documents or parts of text into a main document should this be desired</p>
+<p><b>(xv)</b> future proofing, a framework for adding further capability or updating existing capability as required: (a) modular, (thanks in no small part to Ruby) another output format required, write another module....(b) easy to update output formats (eg html, xhtml, latex/pdf produced can be updated in program and run against whole document set), (c) easy to add, modify, or have alternative syntax rules for input, should you need to,</p>
+<p><b>(xvi)</b> scalability, dependent on your file-system (in my case Reiserfs) and on the relational database used (currently Postgresql and SQLite), and your hardware,</p>
+<p><b>(xvii)</b> only marked up files need be backed up, to secure the larger document set produced,</p>
+<p><b>(xviii)</b> document management,</p>
+<p><b>(xix)</b> use your favourite editor, syntax highlighting files for markup, primarily (g)vim so far,</p>
+<p><b>(xx)</b> remote operations: (a) run SiSU on a remote server, (having prepared sisu markup documents locally or on that server, i.e. this solution where sisu is installed on the remote server, would work whatever type of machine you chose to prepare your markup documents on), (b) alternatively, (assuming sisu is available to you locally but not installed on the remote server) configure sisu to securely copy (scp) its output to your remote host and run sisu locally, (c) request a remotely located sisu markup file and process it locally by identifying it by its' url.</p>
+<br />
+<p class="small">
+More information on <a href="http://www.jus.uio.no/sisu/SiSU/"><b>SiSU</b></a> provided at <a href="http://www.jus.uio.no/sisu/SiSU/">www.jus.uio.no/sisu/SiSU</a></p>
+</div>
+<div id="column_right">
+<p class="small">
+  More information on <a href="http://www.jus.uio.no/sisu/SiSU/"><b>SiSU</b></a> provided at:
+  <a href="http://www.jus.uio.no/sisu/SiSU/">
+    www.jus.uio.no/sisu/SiSU
+  </a>
+<p class="tiny">
+SiSU was developed in relation to legal documents, and is strong across a wide variety of texts (law, literature...(humanities, law and part of the social sciences)). SiSU handles images but is not suitable for formulae/ statistics, or for technical writing at this time.</p>
+<p class="tiny">
+SiSU has been developed and has been in use for several years. Requirements to cover a wide range of documents within its use domain have been explored.</p>
+<p class="tiny">
+Some modules are more mature than others, the most mature being Html and LaTeX / pdf. PostgreSQL and search functions are useable and together with <i>ocn</i> unique (to the best of my knowledge). The XML output document set is "well formed" but largely proof of concept, as is the OpenDocument output which is a limited SiSU feature set (SiSU is interested in a very limited ODF feature set).</p>
+<p class="small">
+<a href="mailto://ralph@amissah.com">
+ralph@amissah.com
+</a>
+</p>
+<p class="small">
+<a href="mailto://ralph.amissah@gmail.com">
+ralph.amissah@gmail.com
+</a>
+</p>
+<p class="small">
+2007
+</p>
+<p class="tiny">
+w3 since October 3 1993
+</p>
+</div>
+</body>
+</html>      
diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html
new file mode 100644
index 00000000..4922bab1
--- /dev/null
+++ b/data/doc/sisu/html/sisu.1.html
@@ -0,0 +1,1335 @@
+           <!-- manual page source format generated by PolyglotMan v3.2, -->
+<!-- available at http://polyglotman.sourceforge.net/ -->
+
+<html>
+<head>
+<title>"sisu"("1") manual page</title>
+</head>
+<body bgcolor='white'>
+<a href='#toc'>Table of Contents</a><p>
+
+<h2><a name='sect0' href='#toc0'>Name</a></h2>
+<b>SiSU</b> - Structured information, Serialized Units - a document
+publishing system 
+<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
+<b>sisu</b> <b>[</b> <i>-AabcDdEeFHhIMmNnopqrRSstUuVvwXxYyZz0-9</i>
+<b>] [</b> <i>filename/</i> wildcard <b>]</b> <p>
+<b>sisu</b> <b>[</b> <i>-Ddcv</i> <b>] [</b> <i>instruction</i> <b>]</b> <p>
+<b>sisu</b> <b>[</b> <i>-CcFLSVvW</i>
+<b>]</b> <p>
+Note: commands should be issued from within the directory that contains
+the marked up files, cd to markup directory.  
+<h2><a name='sect2' href='#toc2'>Description</a></h2>
+<b>SiSU</b> SiSU is a
+document publishing system, that from a simple single marked-up document,
+produces multiple of output formats including: plaintext, html, LaTeX,
+pdf, xhtml, XML, info, and SQL (PostgreSQL and SQLite), which share numbered
+text objects ("object citation numbering") and the same document structure
+information. For more see: <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i> <p>
+ 
+<h2><a name='sect3' href='#toc3'>Summary of man page</a></h2>
+
+<dl>
+
+<dt>This
+man page covers a number of subjects in brief, including: document processing
+command flags; document markup (basic markup and headers); configuration
+files; directory structure; skins; document naming; interactive help and
+other information. </dt>
+<dd> </dd>
+</dl>
+
+<h2><a name='sect4' href='#toc4'>Document Processing Command Flags</a></h2>
+
+<dl>
+
+<dt><b>-A</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>produces <i>plaintext</i> with  <i>dos</i> linefeeds and without markup, (object numbers
+are omitted), has footnotes at end of each paragraph that contains them
+[ <i>-a</i> for equivalent Unix (linefeed) output file] [see <i>-E</i> for endnotes]. </dd>
+
+<dt><b>-a</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>produces <i>plaintext</i> with  <i>Unix</i> linefeeds and without markup, (object numbers
+are omitted), has footnotes at end of each paragraph that contains them
+[ <i>-A</i> for equivalent dos (linefeed) output file] [see <i>-e</i> for endnotes]. </dd>
+
+<dt><b>-b</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>produces  <i>xhtml/XML</i> output for browser viewing (sax parsing). </dd>
+
+<dt><b>-C</b><i>&nbsp;[--init=site]</i>
+</dt>
+<dd><i>configure/initialise</i> shared output directory files initialize shared output
+directory (config files such as css and dtd files are not updated if they
+already exist unless modifier is used). <b>-C</b><i>&nbsp;--init=site</i> <i>configure/initialise</i>
+site more extensive than <i>-C</i> on its own, shared output directory files/force
+update, existing shared output config files such as css and dtd files are
+updated if this modifier is used.  </dd>
+
+<dt><b>-c</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>screen  <i>toggle</i> ansi
+screen colour on or off depending on default set (unless -c flag is used:
+if sisurc colour default is set to &rsquo;true&rsquo;, output to screen will be with
+colour, if sisurc colour default is set to &rsquo;false&rsquo; or is undefined screen
+output will be without colour). </dd>
+
+<dt><b>-D</b><i>&nbsp;[instruction]</i><b>&nbsp;[filename]</b> </dt>
+<dd>database postgresql
+( <i>--pgsql</i>  may be used instead) possible instructions, include: <i>--createdb;</i>
+<i>--create;</i> <i>--dropall;</i> <i>--import</i> &nbsp;[filename]; <i>--update</i> &nbsp;[filename]; <i>--remove</i> &nbsp;[filename];
+see database section below. </dd>
+
+<dt><b>-d</b><i>&nbsp;[--db-[database</i><b>&nbsp;type</b><i>&nbsp;(sqlite|pg)]]</i><b>&nbsp;--[instruction]</b><i>&nbsp;[filename]</i>
+</dt>
+<dd>database type default set to sqlite, (for which <i>--sqlite</i>  may be used instead)
+or to specify another database <i>--db-[pgsql,</i> sqlite] (however see -D) possible
+instructions include: <i>--createdb;</i> <i>--create;</i> <i>--dropall;</i> <i>--import</i> &nbsp;[filename]; <i>--update</i>
+&nbsp;[filename]; <i>--remove</i> &nbsp;[filename]; see database section below. </dd>
+
+<dt><b>-E</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>produces  <i>plaintext</i> with  <i>dos</i> linefeeds, and without markup, endnotes follow
+the main text (in  <i>-a</i> endnotes follow the paragraphs that contain them).
+There are no object numbers [see  <i>-e</i> for Unix (linefeed) output file] [see
+<i>-A</i> for footnotes]. </dd>
+
+<dt><b>-e</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>produces  <i>plaintext</i> with  <i>Unix</i> linefeeds,
+and without markup, endnotes follow the main text. Object numbers are omitted.
+[ <i>-E</i> for equivalent dos (linefeed) output file] [ <i>-a</i> for footnotes]. </dd>
+
+<dt><b>-F</b><i>&nbsp;[--webserv=webrick]</i>
+</dt>
+<dd>generate examples of (naive) <i>cgi</i> search form for  <i>sqlite</i> and  <i>pgsql</i> depends
+on your already having used sisu to populate an sqlite and/or pgsql database,
+(the sqlite version scans the output directories for existing sisu_sqlite
+databases, so it is first necessary to create them, before generating the
+search form) see  <i>-d</i>  <i>-D</i>  and the  <i>database</i> section below. If the optional
+parameter <i>--webserv=webrick</i> is passed, the cgi examples created will be set
+up to use the default port set for use by the webrick server, (otherwise
+the port is left blank and the system setting used, usually 80). The samples
+are dumped in the present work directory which must be writable, (with
+screen instructions given that they be copied to the  <i>cgi-bin</i> directory).
+<i>-Fv</i>  (in addition to the above) provides some information on setting up
+<i>hyperestraier</i> for sisu    </dd>
+
+<dt>   <b>-H</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>produces  <i>html</i> without
+link suffixes (.html .pdf etc.) ("Hide"). Requires an appropriately configured
+web server. [behaviour switched after 0.35 see -h]. </dd>
+
+<dt><b>-h</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>produces
+ <i>html</i> (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]. </dd>
+
+<dt><b>-I</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>produces  <i>texinfo</i> file. </dd>
+
+<dt><b>-L</b> </dt>
+<dd>prints license information. </dd>
+
+<dt><b>-M</b><i>&nbsp;[filename/wildcard/url]</i>
+</dt>
+<dd><i>maintenance</i> mode files created for processing preserved and their locations
+indicated. (also see -V) </dd>
+
+<dt><b>-m</b><i>&nbsp;[filename/wildcard/url]</i> </dt>
+<dd>assumed for most other
+flags, creates new meta-markup file, (the <i>metaverse</i> ) that is used in all
+subsequent processing of other output. This step is assumed for most processing
+flags. To skip it see <i>-n</i> </dd>
+
+<dt><b>-N</b><i>&nbsp;[filename/wildcard/url]</i> </dt>
+<dd>document <i>digest</i> or <i>document</i>
+content certificate ( <i>DCC</i> ) as <i>md5</i> digest tree of the document: the digest
+for the document, and digests for each object contained within the document
+(together with information on software versions that produced it)  (digest.txt).
+<i>-NV</i> for verbose digest output to screen. </dd>
+
+<dt><b>-n</b><i>&nbsp;[filename/wildcard/url]</i> </dt>
+<dd>skip meta-markup
+(building of "metaverse"), this skips the equivalent of  <i>-m</i> which is otherwise
+assumed by most processing flags. </dd>
+
+<dt><b>-o</b><i>&nbsp;[filename/wildcard/url]</i> </dt>
+<dd>output basic
+document in <i>opendocument</i> file format (opendocument.odt). </dd>
+
+<dt><b>-p</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>produces  <i>LaTeX</i> pdf (portrait.pdf &amp; landscape.pdf). Default paper size is set
+in config file, or document header, or provided with additional command
+line parameter, e.g. <i>--papersize-a4</i> preset sizes include: &rsquo;A4&rsquo;, U.S. &rsquo;letter&rsquo; and
+&rsquo;legal&rsquo; and book sizes &rsquo;A5&rsquo; and &rsquo;B5&rsquo; (system defaults to A4). </dd>
+
+<dt><b>-q</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd><i>quiet</i> less output to screen. </dd>
+
+<dt><b>-R</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd><i>copies</i> sisu output files
+to  <i>remote</i> host using rsync. This requires that sisurc.yml has been provided
+with information on hostname and username, and that you have your "keys"
+and ssh agent in place. Note the behavior of rsync different if -R is used
+with other flags from if used alone. Alone the rsync --delete parameter is
+sent, useful for cleaning the remote directory (when -R is used together
+with other flags, it is not). Also see <i>-r</i> </dd>
+
+<dt><b>-r</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd><i>copies</i> sisu
+output files to  <i>remote</i> host using scp. This requires that sisurc.yml has
+been provided with information on hostname and username, and that you have
+your "keys" and ssh agent in place. Also see <i>-R</i> </dd>
+
+<dt><b>-S</b> </dt>
+<dd>produces a <i>sisupod</i> a zipped
+sisu directory of markup files including  <i>sisu</i> markup source files and
+the directories local  <i>configuration</i> file, <i>images</i> and <i>skins.</i> <b>Note:</b> this
+only includes the configuration files or skins contained in  <i>./_sisu</i> not
+those in <i>~/.sisu</i> <i>-S</i> &nbsp;[filename/wildcard] option. <b>Note:</b> (this option is tested
+only with zsh). </dd>
+
+<dt><b>-S</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>produces a zipped file of the prepared
+document specified along with associated images, by default named <i>sisupod.zip</i>
+they may alternatively be named with the filename extension  <i>.ssp</i> This provides
+a quick way of gathering the relevant parts of a sisu document which can
+then for example be emailed. A sisupod includes  <i>sisu</i> markup source file,
+ (along with associated documents if a master file, or available in multilingual
+versions),  together with related <i>images</i> and <i>skin.</i> SiSU commands can be
+run directly against a sisupod contained in a local directory, or provided
+as a url on a remote site. As there is a security issue with skins provided
+by other users, they are not applied unless the flag --trust or --trusted is
+added to the command instruction, it is recommended that file that are
+not your own are treated as untrusted. The directory structure of the unzipped
+file is understood by sisu, and sisu commands can be run within it. <b>Note:</b>
+if you wish to send multiple files, it quickly becomes more space efficient
+to zip the sisu markup directory, rather than the individual files for
+sending). See the  <i>-S</i> option without [filename/wildcard]. </dd>
+
+<dt><b>-s</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>copies sisu markup file to output directory. </dd>
+
+<dt><b>-t</b><i>&nbsp;[filename/wildcard</i><b>&nbsp;(*.termsheet.rb)]</b>
+</dt>
+<dd>standard form document builder, preprocessing feature </dd>
+
+<dt><b>-U</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>prints  <i>url</i> output list/map for the available processing flags options
+and resulting files that could be requested, (can be used to get a list
+of processing options in relation to a file, together with information
+on the output that would be produced),  <i>-u</i>  provides  <i>url</i> output mapping
+for those flags requested for processing. The default assumes sisu_webrick
+is running and provides webrick url mappings where appropriate, but these
+can be switched to file system paths in sisurc.yml </dd>
+
+<dt><b>-u</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>provides  <i>url</i> mapping of output files for the flags requested for processing,
+also see  <i>-U</i> </dd>
+
+<dt><b>-V</b> </dt>
+<dd>on its own, provides SiSU  <i>version</i> and <i>environment</i> information
+(sisu --help env) </dd>
+
+<dt><b>-V</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>even more  <i>verbose</i> than the  <i>-v</i> flag.
+(also see -M) </dd>
+
+<dt><b>-v</b> </dt>
+<dd>on its own, provides SiSU  <i>version</i> information </dd>
+
+<dt><b>-v</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>provides  <i>verbose</i> output of what is being built, where it is being built
+(and error messages if any), as with  <i>-u</i> flag provides a url mapping of
+files created for each of the processing flag requests. See also <b>-V</b> </dd>
+
+<dt><b>-W</b> </dt>
+<dd>starts
+ruby&rsquo;s  <i>webrick</i> webserver points at sisu output directories, the default
+port is set to 8081 and can be changed in the resource configuration files.
+[tip: the webrick server requires link suffixes, so html output should
+be created using the  <i>-h</i>  option rather than  <i>-H</i> ; also, note  <i>-F</i> webrick
+].     </dd>
+
+<dt><b>-w</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>produces  <i>concordance</i> (wordmap) a rudimentary
+index of all the words in a document. </dd>
+
+<dt><b>-X</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>produces  <i>XML</i>
+output with deep document structure, in the nature of dom. </dd>
+
+<dt><b>-x</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>produces <i>XML</i> output shallow structure (sax parsing). </dd>
+
+<dt><b>-Y</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>produces a short sitemap entry for the document, based on html output and
+the sisu_manifest. <i>--sitemaps</i> generates/updates the sitemap index of existing
+sitemaps. (Experimental, [g,y,m announcement this week]) </dd>
+
+<dt><b>-y</b><i>&nbsp;[filename/wildcard]</i>
+</dt>
+<dd>produces an html summary of output generated (hyperlinked to content) and
+document specific metadata (sisu_manifest.html). This step is assumed for
+most processing flags. </dd>
+
+<dt><b>-Z</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>Zap, if used with other processing
+flags  <i>deletes</i> output files of the type about to be processed, prior to
+processing.  If -Z is used as the lone processing related flag (or in conjunction
+with a combination of -[mMvVq]), will remove the related document output
+directory.  </dd>
+
+<dt><b>-z</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>produces <i>php</i> (zend) [this feature is disabled
+for the time being]  </dd>
+</dl>
+
+<h2><a name='sect5' href='#toc5'>modifiers</a></h2>
+
+<dl>
+
+<dt><b>--no-ocn</b> </dt>
+<dd>[with -h -H or -p] switches off object
+citation numbering. Produce output without identifying numbers in margins
+of html or LaTeX/pdf output. </dd>
+
+<dt><b>--no-annotate</b> </dt>
+<dd>strips output text of editor endnotes~[*
+square brackets ]~ denoted by asterisk or dagger/plus sign </dd>
+
+<dt><b>--no-asterisk</b> </dt>
+<dd>strips
+output text of editor endnotes~[* square brackets ]~ denoted by asterisk
+sign </dd>
+
+<dt><b>--no-dagger</b> </dt>
+<dd>strips output text of editor endnotes~[+ square brackets
+]~ denoted by dagger/plus sign        </dd>
+</dl>
+
+<h2><a name='sect6' href='#toc6'>databases</a></h2>
+
+<dl>
+
+<dt>dbi - database interface
+</dt>
+<dd><b>-D</b> or <b>--pgsql</b> set for  <i>postgresql</i>  <b>-d</b> or <b>--sqlite</b> default set for  <i>sqlite</i> -d is
+modifiable with --db=[database &nbsp;type &nbsp;(pgsql &nbsp;or &nbsp;sqlite)] </dd>
+
+<dt><b>-Dv --createall</b> </dt>
+<dd>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) [ <i>-dv</i> --createall sqlite equivalent]
+it may be necessary to run sisu <i>-Dv</i> --createdb initially </dd>
+
+<dt>NOTE: at the present
+time for postgresql it may be necessary to manually create the database.
+The command would be </dt>
+<dd><i>&rsquo;createdb</i> [database name]&rsquo; where database name would
+be SiSU_[present working directory name (without path)]. Please use only
+alphanumerics and underscores. </dd>
+
+<dt><b>-Dv --import </b> </dt>
+<dd><i>[filename/wildcard]</i> imports data
+specified to postgresql db (rb.dbi) [ <i>-dv</i> --import sqlite equivalent] </dd>
+
+<dt><b>-Dv --update
+</b> </dt>
+<dd><i>[filename/wildcard]</i> updates/imports specified data to postgresql db (rb.dbi)
+[ <i>-dv</i> --update sqlite equivalent] </dd>
+
+<dt><b>-D --remove</b> </dt>
+<dd><i>[filename/wildcard]</i> removes specified
+data to postgresql db (rb.dbi) [ <i>-d</i> --remove sqlite equivalent]  </dd>
+
+<dt><b>-D --dropall</b>
+</dt>
+<dd>kills data" and drops (postgresql or sqlite) db, tables &amp; indexes [ <i>-d</i> --dropall
+sqlite equivalent]  </dd>
+
+<dt>The v in e.g. -Dv is for verbose output. </dt>
+<dd></dd>
+</dl>
+</blockquote>
+ 
+<h2><a name='sect7' href='#toc7'>Shortcuts, Shorthand
+for multiple flags</a></h2>
+
+<dl>
+
+<dt><b>--update</b><i>&nbsp;[filename/wildcard]</i> </dt>
+<dd>Checks existing file output
+and runs the flags required to update this output. This means that if only
+html and pdf output was requested on previous runs, only the -hp files will
+be applied, and only these will be generated this time, together with the
+summary. This can be very convenient, if you offer different outputs of
+different files, and just want to do the same again. </dd>
+
+<dt>-0 to -5 [filename or
+wildcard]     </dt>
+<dd>Default shorthand mappings (note that the defaults can be
+changed/configured in the sisurc.yml file): </dd>
+</dl>
+<p>
+<i>-0</i> -mNhwpAobxXyYv  [this is the
+default action run when no options are give, i.e. on &rsquo;sisu [filename]&rsquo;] <p>
+<i>-1</i> -mNHwpy
+<p>
+<i>-2</i> -mNHwpaoy <p>
+<i>-3</i> -mNhwpAobxXyY <p>
+<i>-4</i> -mNhwpAobxXDyY &nbsp;--import <p>
+<i>-5</i> -mNhwpAobxXDyY &nbsp;--update
+<p>
+add  <i>-v</i> for verbose mode and <i>-c</i> for color, e.g. <i>sisu</i> -2vc [filename or wildcard]
+<p>
+consider  <i>-u</i> for appended url info or  <i>-v</i> for verbose output  
+<h2><a name='sect8' href='#toc8'>Document Markup</a></h2>
+<b>SiSU
+Markup</b> an incomplete summary.  <p>
+<b>Note:</b> files should be marked up for SiSU
+using  <i>UTF-8</i> encoding. <p>
+Some interactive help on markup is available, by typing
+ <i>sisu</i> and selecting  <i>markup</i> or <i>sisu</i> --help markup 
+<dl>
+
+<dt>Sample markup files can
+be used as examples: </dt>
+<dd><i>&lt;<a href='http://www.jus.uio.no/sisu/sample'>http://www.jus.uio.no/sisu/sample</a>
+&gt;</i> </dd>
+
+<dt>actual marked up plaintext
+files ready for use: </dt>
+<dd><i>&lt;<a href='http://www.jus.uio.no/sisu/sample/markup'>http://www.jus.uio.no/sisu/sample/markup</a>
+&gt;</i> </dd>
+
+<dt>as html with
+syntax highlighting for viewing: </dt>
+<dd><i>&lt;<a href='http://www.jus.uio.no/sisu/sample/syntax'>http://www.jus.uio.no/sisu/sample/syntax</a>
+&gt;</i>
+</dd>
+
+<dt>an alternative presentation of markup syntax: </dt>
+<dd><i>&lt;<a href='http://www.jus.uio.no/sisu/sample/on_markup.txt'>http://www.jus.uio.no/sisu/sample/on_markup.txt</a>
+&gt;</i>
+ </dd>
+</dl>
+
+<h2><a name='sect9' href='#toc9'>Basic Markup</a></h2>
+Data text markup (alternative to available html subset)  <p>
+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.  <i>:A~</i> usually the title  <i>:A~?</i> conditional level 1 heading
+(used where a stand-alone document may be imported into another) <p>
+<i>1~filename</i>
+level 1 heading, the primary division such as Chapter that is followed
+by substantive text, and may be further subdivided (this is the level on
+which by default html segments are made) <p>
+<i>!{</i> emphasis <i>}!</i> <p>
+<i>*{</i> bold text <i>}*</i>
+<p>
+<i>_{</i> underscore <i>}_</i> <p>
+<i>/{</i> italics <i>}/</i> <p>
+<i>&rsquo;"{</i> citation <i>}"</i> <p>
+<i>^{</i> superscript <i>}^</i> <p>
+<i>,{</i> subscript
+<i>},</i> <p>
+<i>+{</i> inserted text <i>}+</i> <p>
+<i>-{</i> strikethrough <i>}-</i>  
+<h2><a name='sect10' href='#toc10'>Footnotes/Endnotes</a></h2>
+<p>
+<i>~{</i> a footnote
+or endnote <i>}~</i> <p>
+footnote/endnote <i>~{</i> self contained endnote marker &amp; endnote
+in one <i>}~</i> <p>
+<i>~{*</i> unnumbered asterisk footnote/endnote, insert multiple asterisks
+if required <i>}~</i> <p>
+<i>~[*</i> editors notes, numbered asterisk footnote/endnote series
+<i>]~</i> (+ the plus sign may be used as well) <p>
+alternative endnote pair notation:
+<p>
+<i>~^</i> endnote marker <p>
+<i>^~</i> endnote text following the paragraph in which the marker
+occurs  
+<h2><a name='sect11' href='#toc11'>Line Operations (marker placed at start of line)</a></h2>
+<p>
+<i>!_</i> bold line <p>
+<i>_1</i>
+indent paragraph one level <p>
+<i>_2</i> indent paragraph two steps <p>
+<i>_*</i> bullet paragraph
+<p>
+<i>#</i> number paragraph          (see headers for numbering document headings)
+<p>
+<i>_#</i> number paragraph level 2  (see headers for numbering document headings)
+ 
+<h2><a name='sect12' href='#toc12'>Links</a></h2>
+<p>
+<i>{</i> link name <i>}<a href='http://url.org'>http://url.org</i></a>
+ <p>
+<i>{</i> image.png <i>}<a href='http://url.org'>http://url.org</i></a>
+ <p>
+<i>{</i> image.png <i>}image</i>
+<p>
+<i>{</i> tux.png 64x80 <i>}image</i> <p>
+NOTE: (a) png and jpg support only (no gif) (b) width
+x height, not required if imagemagick is installed, (where provided, dimensions
+may be smaller than the actual image), [images should be no larger than
+width: 480 and height: 640] <p>
+the shortcut: <p>
+<i>{~^</i> [text to link] <i>}<a href='http://url.org'>http://url.org</i></a>
+
+<p>
+is equivalent to:  <p>
+<i>{</i> [text to link] <i>}<a href='http://url.org'>http://url.org</i></a>
+ <i>~{</i> <a href='http://url.org'>http://url.org</a>
+ <i>}~</i>
+<p>
+(which produces hyper-linked text within a document/paragraph, with an endnote
+providing the url for the text location used in the hyperlink) <p>
+url example:
+<p>
+<i>{</i> SiSU Geek Writer <i>}<a href='http://www.jus.uio.no/sisu/'>http://www.jus.uio.no/sisu/</i></a>
+ <p>
+linked image: <p>
+<i>{</i> tux.png 64x80
+"a better way" <i>}<a href='http://www.jus.uio.no/sisu/'>http://www.jus.uio.no/sisu/</i></a>
+ image example with all options
+<p>
+note width x height <p>
+the shortcut: <p>
+<i>{</i> [text to link] <i>[3sS]}markup_source_filename.sst</i>
+<p>
+if a server host name has been provided/configured, will provide a list
+of available output types that would be generated using the shortcut command
+and the markup file provided, i.e. output generated using the command (as
+configured): "sisu -3sS markup_source_filename.sst", using server host, directory
+stub, filename to compose the link.  
+<h2><a name='sect13' href='#toc13'>Adding a fixed names in html</a></h2>
+<p>
+<i>*~[name]</i>
+manual location marker/tagging at present only in html to produce &lt;a name="[name]"&gt;&lt;/a&gt;
+(use sparingly) <blockquote>note at a heading level the same is automatically achieved
+by providing names to headings 5 and 6 i.e. 5~[name] and 6~[name] or in the
+case of auto-heading numbering, without further intervention. </blockquote>
+ 
+<h2><a name='sect14' href='#toc14'>Escape object
+citation numbering</a></h2>
+<p>
+(place marker at end of paragraph) <p>
+<i>~#</i> unnumbered paragraph
+<p>
+<i>-#</i> unnumbered paragraph, delete when not required (place marker at end of
+paragraph) [used in dummy headings, eg. for segmented html] <p>
+It is convenient
+to mention here that the  <i>-0</i> flag generates html and latex/pdf output without
+visible object character numbers. <p>
+<i>sisu</i> -0 [filename.sst]  
+<h2><a name='sect15' href='#toc15'>Page breaks (LaTeX/pdf)</a></h2>
+<p>
+page
+breaks are introduced to pdfs either as header instructions, indicating
+that pages should break at given levels, and mentioned in the header section,
+or manually, using the following notation <p>
+<i>&lt;:pb&gt;</i> page break, which breaks
+a page, starting a new page in single column text and a new column in double
+column text <p>
+<i>&lt;:pn&gt;</i> page new, which starts a new page, in both single and double
+column text (leaving an empty column in double column text if necessary).
+ 
+<h2><a name='sect16' href='#toc16'>Comment line</a></h2>
+<p>
+<i>%</i> ignored by sisu in processing if placed at beginning of
+line <p>
+<i>%%</i> ignored by sisu in processing if placed at beginning of line, used
+for folding by vim folds  
+<h2><a name='sect17' href='#toc17'>Special characters</a></h2>
+special characters can be escaped
+with a backslash  <i>{</i> } &lt; &gt; are contextual special characters, (in combination
+with other characters). <i>~</i> - _ / % ^ and occasionally <i>!</i> # + , are special characters
+in particular circumstances, see the syntax chart. [note that SiSU is not
+optimised for technical writing]  
+<h2><a name='sect18' href='#toc18'>Tables</a></h2>
+<p>
+<i>table{</i> [number of columns] [column
+width %];[column width %] 
+<p>   [table content, line breaks are important
+see example below]<br>
+ 
+<p> <i>}table</i> 
+<p>   sample table:<br>
+ 
+<p> <i>table{~h</i> c3; 26; 32; 32; 
+<p>   This is a table, column1<br>
+   this would become row one of column two<br>
+   column three of row one is here<br>
+ 
+<p>   column one row 2<br>
+   column two of row two<br>
+   column three of row two, and so on<br>
+ 
+<p>   column one row three<br>
+   and so on<br>
+   here<br>
+   <br>
+ <i>}table</i> 
+<p> whole table gets an object citation number 
+<p>  
+<h2><a name='sect19' href='#toc19'>Other Grouped or
+Pre-formatted Text</a></h2>
+<i>poem{</i> 
+<p>   [Text here]<br>
+ 
+<p>   [Text here]<br>
+ 
+<p> <i>}poem</i> 
+<p> each verse is given an object citation number 
+<p>   ----<br>
+ 
+<p> <i>group{</i> 
+<p>   [Text here]<br>
+ 
+<p> <i>}group</i> 
+<p> whole group gets an object citation number 
+<p>   ----<br>
+ 
+<p> <i>code{</i> 
+<p>   [Text here]<br>
+ 
+<p> <i>}code</i> 
+<p> whole group gets an object citation number 
+<p>  
+<h2><a name='sect20' href='#toc20'>Composite Documents</a></h2>
+<p>
+It
+is possible to build a document by requiring other documents. The documents
+required may complete documents that could be 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 mainly from other documents), by convention it should be named with
+the suffix <i>.ssm</i> (master) 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 <i>.sst</i> regular markup
+file, or <i>.ssi</i> (insert/information) <i>.sst</i> A secondary file of the composite
+document is built prior to processing with the same prefix and the suffix
+ <i>._sst</i> and <i>._sst</i> There are a number of alternative syntaxes for requiring
+external documents in order to permit use of ascii hypertext linking available
+in the vim editor. They are as follows: 
+<p> 
+<dl>
+
+<dt>basic markup for importing a document
+</dt>
+<dd>
+<p> <i>r{</i> filename <i>}</i> 
+<p> <i>{</i> filename.si <i>}require</i> 
+<p> <i>&lt;&lt;</i> { filename.si <i>}</i> #for vim folds 
+<p>
+</dd>
+
+<dt>importing a document with textlink syntax </dt>
+<dd>
+<p> <i>|filename.si|@|^|require</i> 
+<p> <i>&lt;&lt;</i> |filename.si|@|^|
+
+<p>#for vim folds 
+<p> </dd>
+
+<dt>importing a document with thlnk syntax </dt>
+<dd>
+<p> <i>&lt;url:filename.si&gt;require</i>
+
+<p> <i>&lt;&lt;</i> &lt;url:filename.si&gt; #for vim folds 
+<p> </dd>
+
+<dt>remote documents may be called with the
+thlnk syntax (or regular sisu syntax), e.g. </dt>
+<dd>
+<p> <i>&lt;&lt;</i> &lt;url:<a href='http://www.url.com/filename.si'>http://www.url.com/filename.si</a>
+&gt;
+
+<p>  </dd>
+</dl>
+
+<h2><a name='sect21' href='#toc21'>Document Headers</a></h2>
+Header tags appear at the beginning of a document and
+provide meta information on the document (such as the Dublin Core), or
+information as to how the document as a whole is to be processed.  
+<p> All
+header instructions may take either form: <i>@headername:</i> [introduced in 0.38]
+
+<p>or <i>0~headername</i> All Dublin Core meta tags are available 
+<p> <i>@indentifier:</i>
+information or instructions [introduced in 0.38] 
+<p> or 
+<p> <i>0~indentifier</i> information
+or instructions, old equivalent, depreciated 
+<p> where the "identifier" is
+a tag recognised by the program, and the "information" or "instructions"
+belong to the tag/indentifier specified. 
+<p> Note: a header where used should
+only be used once; all headers apart from @title: (0~title) are optional;
+the @structure: (0~toc) header is used to describe document structure,
+and can be useful to know. 
+<p> @structure: PART; CHAPTER; SECTION; ARTICLE;
+none; none; 
+<p> structure can be defined by a match words or regular expression
+(the regular expression is assumed to start at the beginning of a line
+of text i.e. ^) 
+<p>   For help see one of the following (and markup samples):<br>
+ 
+<p>   *  interactive help - type &rsquo;sisu --help headers&rsquo;<br>
+ 
+<p>   *  marked up text samples<br>
+ 
+<p>   *  the SiSU_Markup.txt file provided with the program<br>
+ 
+<p>   *  an outline of headers is provided below --&gt;<br>
+  
+<h2><a name='sect22' href='#toc22'>Outline of header options</a></h2>
+<i>%</i> SiSU 0.38 [declared file-type identifier with
+markup version] 
+<p> <i>@title:</i> My Title - This is now the Title of the Document
+
+<p>and used as such 
+<p> <i>@subtitle:</i> The Subtitle if any 
+<p> <i>@creator:</i> [or ~author]
+
+<p>Ralph Amissah 
+<p> <i>@subject:</i> (whatever your subject) 
+<p> <i>@description:</i> 
+<p> <i>@publisher:</i>
+
+<p> <i>@contributor:</i> 
+<p> <i>@translator:</i> [or ~translated_by] 
+<p> <i>@illustrator:</i> [or ~illustrated_by]
+
+<p> <i>@prepared_by:</i> [or ~digitized_by] 
+<p> <i>@date:</i> 2000-08-27 [ also @date.created:
+@date.issued: @date.available: @date.valid: @date.modified: ] 
+<p> <i>@type:</i> article
+
+<p> <i>@format:</i> 
+<p> <i>@identifier:</i> 
+<p> <i>@source:</i> 
+<p> <i>@language:</i>  [or @language.document:]
+language in which current version of document is published. Some country
+settings result in processing adjustments, e.g. in LaTeX hyphenation, some
+country codes are recognized, but the language name in Engish is preferred.
+English is the default setting. (en - English, fr - French, de - German, it
+- Italian, es - Spanish, pt - Portuguese, sv - Swedish, da - Danish, fi - Finnish,
+no - Norwegian, is - Icelandic, nl - Dutch, ee - Estonian, hu - Hungarian, pl
+- Polish, ro - Romanian, ru - Russian, gl - Greek, uk - Ukranian, tr - Turkish,
+si - Slovene, sk - Slovak, hr - Croatian, cs - Czech, bg - Bulgarian ) [however,
+encodings are not available for all of the languages listed.] 
+<p> <i>@language.original:</i>
+
+<p>original language in which the work was published 
+<p> <i>@papersize:</i> (A4|US_letter|book_B5|book_A5|US_legal)
+
+<p> <i>@relation:</i> 
+<p> <i>@coverage:</i> 
+<p> <i>@rights:</i> copyright, all rights reserved, public
+domain, copyleft, creative commons variant, etc. 
+<p> <i>@owner:</i> 
+<p> <i>@keywords:</i> text
+document generation processing management LaTeX pdf structured XML citation
+[your keywords here, used for example by rss feeds, and in sql sear ches]
+
+<p> <i>@abstract:</i> [paper abstract, placed after table of contents] 
+<p> <i>@comment:</i>
+[...] 
+<p> <i>@catalogue:</i> loc=[Library of Congress classification]; dewey=[Dewey
+classification]; isbn=[ISBN]; pg=[Project Gutenberg text number] 
+<p> <i>@classify_loc:</i>
+
+<p>Library of Congress classification 
+<p> <i>@classify_dewey:</i> Dewey classification
+
+<p> <i>@classify_isbn:</i> ISBN 
+<p> <i>@classify_pg:</i> Project Gutenberg text number 
+<p> <i>@prefix_a:</i>
+[prefix is placed just before table of contents - not implemented] 
+<p> <i>@prefix_b:</i>
+or @prefix: [prefix is placed just after table of contents] 
+<p> <i>@rcs:</i> $Id$
+[or  <i>@cvs:</i> used by rcs or cvs to embed version (revision control) information
+into document, rcs or cvs can usefully provide a history of updates to
+a document ] 
+<p> <i>@structure:</i> PART; CHAPTER; SECTION; ARTICLE; none; none;
+optional, where document structure can be defined by a match words or regular
+expression (the regular expression is assumed to start at the beginning
+of a line of text i.e. ^) default markers :A~ to :C~ and 1~ to 6~ can be used
+within text instead, without this header ta g, and may be used to supplement
+the instructions provided in this header tag if provided (@structure: is
+a synonym for @toc:) 
+<p> <i>@markup:</i> information on the markup used, e.g. <i>new=1,2,3;</i>
+break=4; num_top=4 [or newpage=1,2,3; breakpage=4; num_top=4] newpage and
+breakpage, heading level, used by LaTeX to breakpages. breakpage: starts
+on a new page in single column text and on a new column in double column
+text; newpage: starts on a new page for both single and double column texts.
+<i>num_top=4</i> [auto-number document, starting at level 4. the default is to provide
+3 levels, as in 1 level 4, 1.1 level 5, 1.1.1 level 6, markup to be merged
+within level] <i>num_extract</i> [take numbering of headings provided (manually
+in marked up source document), and use for numbering of segments. Available
+where a clear numbering structure is provided within document, without
+the repetition of a number in a header.] [In 0.38 notation, you would map
+to the equivalent levels, the examples provided would map to the following
+new=A,B,C; break=1; num_top=1 [or newpage=A,B,C; breakpage=1; num_top=1]
+see headings] 
+<p> <i>@bold:</i> [regular expression of words/phrases to be made bold]
+
+<p> <i>@italics:</i> [regular expression of words/phrases to italicise]  <br>
+ <i>@vocabulary:</i> name of taxonomy/vocabulary/wordlist to use against document
+
+<p> <i>@skin:</i> skin_doc_[name_of_desired_document_skin] 
+<p> <i>@links:</i> { SiSU }<a href='http://www.jus.uio.no/sisu/'>http://www.jus.uio.no/sisu/</a>
+
+{ FSF }<a href='http://www.fsf.org'>http://www.fsf.org</a>
+ 
+<p> <i>@promo:</i> sisu, ruby, search_libre_docs, open_society
+[places content in right pane in html, makes use of list.yml and promo.yml,
+commented out sample in document sample: free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst]
+
+<p> <i>:A~</i> Top level heading [this usually has similar content to the title @title:
+] NOTE: the heading levels described here are in 0.38 notation, see heading
+ 
+<p> <i>:B~</i> Second level heading [this is a heading level divider] 
+<p> <i>:C~</i> Third
+level heading [this is a heading level divider] 
+<p> <i>1~</i> Top level heading preceding
+substantive text of document or sub-heading 2, the heading level that would
+normally be marked 1. or 2. or 3. etc. in a document, and the level on which
+sisu by default would break html output into named segments, names are
+provided automatically if none are given (a number), otherwise takes the
+
+<p>form 1~my_filename_for_this_segment 
+<p> <i>2~</i> Second level heading preceding
+substantive text of document or sub-heading 3 , the heading level that would
+normally be marked 1.1 or 1.2 or 1.3 or 2.1 etc. in a document. 
+<p> <i>3~</i> Third level
+heading preceding substantive text of document, that would normally be
+marked 1.1.1 or 1.1.2 or 1.2.1 or 2.1.1 etc. in a document 
+<p> NOTE: headers and heading
+levels used in the description provided refer to 0.38 markup (a conversion
+script provided in sisu-examples, modify.rb makes conversion between 0.37
+and 0.38 markup simple) 
+<p> For some help on document structure try 
+<p> <i>sisu</i> --help
+
+<p>headings 
+<p> and view sample markup documents provided 
+<p>   
+<p>  
+<h2><a name='sect23' href='#toc23'>Configuration
+Files</a></h2>
+<p>
+Some configuration is required for SiSU, specifying in which directory
+processing should be done, and where the generated output should be placed.
+<p>
+SiSU resource configuration is determined by looking at the following files
+if they exist: <p>
+<i>./_sisu/sisurc.yml</i> <p>
+<i>~/.sisu/sisurc.yml</i> <p>
+<i>/etc/sisu/sisurc.yml</i> <p>
+In
+the absence of instructions in any of these it falls back to the internal
+program defaults. <p>
+Configuration determines the output and processing directories
+and the database access details. <p>
+A sample sisurc.yml may be found in /etc/sisu/sisurc.yml
+
+<p>  
+<h2><a name='sect24' href='#toc24'>More HELP on Markup and headers</a></h2>
+type:     sisu ~<br>
+     sisu --help<br>
+ 
+<p>   markup help is available on:<br>
+     document wide instructions: headers (document structure)<br>
+     general text markup: headings; endnotes; tables<br>
+ 
+<p> A markup table and sample marked-up files (also in html with syntax highlighting)
+are available at: 
+<p> <i>&lt;<a href='http://www.jus.uio.no/sisu/sample'>http://www.jus.uio.no/sisu/sample</a>
+&gt;</i> 
+<p>  
+<h2><a name='sect25' href='#toc25'>DIRECTORY STRUCTURE
+&amp; Document Output</a></h2>
+
+<dl>
+
+<dt>SiSU determines output directories by looking at the resource
+configuration files, and in their absence the programs internal defaults.
+</dt>
+<dd> </dd>
+</dl>
+
+<h2><a name='sect26' href='#toc26'>Default Directories</a></h2>
+
+<dl>
+
+<dt>In the absence of other specifications in </dt>
+<dd><i>~/.sisu/sisurc.yml</i>
+in <i>/etc/sisu/sisurc.yml</i> SiSU writes to the following directories, processing
+files are placed in sub-directories within <i>./_sisu/processing</i> and if that
+is not writable to <i>/tmp/sisu_processing</i> </dd>
+</dl>
+<p>
+Output is written to sub-directories
+within <i>/var/www/</i> if it exists and is writable, and otherwise to <i>~/sisu_output</i>
+ 
+<h2><a name='sect27' href='#toc27'>Markup Document Directories and File Mapping</a></h2>
+
+<dl>
+
+<dt>Ideally documents should be
+placed as collections sub-directories of their own, with a common denominator,
+such as subject or author. </dt>
+<dd></dd>
+
+<dt>The last part of a directory path is used to
+create a sub-directory into which generated documents are placed, in (sub-sub)directories
+of their own. </dt>
+<dd></dd>
+
+<dt>the document </dt>
+<dd></dd>
+</dl>
+<p>
+<blockquote><i>~/ebook/free_culture.sst</i> </blockquote>
+
+<dl>
+
+<dt>would map to  </dt>
+<dd></dd>
+</dl>
+<p>
+<blockquote><i>~[configured</i>
+output path]/ebook/free_culture </blockquote>
+
+<dl>
+
+<dt>within which would be placed all html,
+XML, pdf output, typically under the names: </dt>
+<dd></dd>
+</dl>
+<p>
+<blockquote><i>index.html</i> index for segmented
+text <p>
+<i>doc.html</i> full length scrollable document <p>
+<i>toc.html</i> index for segmented
+text <p>
+html segments, as many as there may be... 
+<dl>
+
+<dt><i>portrait.pdf</i> </dt>
+<dd></dd>
+</dl>
+<p>
+<i>landscape.pdf</i> <p>
+<i>sax.xml</i>
+XML shallow structure, sax type parsing <p>
+<i>dom.xml</i> XML deeper structure, dom
+type parsing <p>
+<i>scroll.xhtml</i> xhtml <p>
+<i>plain.txt</i> plain text  </blockquote>
+
+<h2><a name='sect28' href='#toc28'>Multi-language Document
+File Naming and Directory Mapping</a></h2>
+
+<dl>
+
+<dt>If the same document exists in different
+language versions, and it is desired that the published language versions
+should reside in the same output directory, the following filenaming convention
+should be observed, using Spannish as the sample language code (es) [it
+is very likley the use of country codes as language codes will be changed
+or extended in future] [filename]~[language code].sst </dt>
+<dd></dd>
+
+<dt>filename~es.sst </dt>
+<dd></dd>
+
+<dt>within
+sisurc.yml under the heading default the setting of language file: at 1,
+2 or 3 determines the output filenaming convention used, as follows: </dt>
+<dd></dd>
+
+<dt>(1)
+[output directory path]/filename/es.index.html </dt>
+<dd></dd>
+
+<dt>(2) [output directory path]/filename/index.es.html
+</dt>
+<dd></dd>
+
+<dt>(3) [output directory path]/filename/index.html.es (which Apache for example
+can be configured to use to automatically serve each users preference)
+</dt>
+<dd></dd>
+
+<dt>filename~fr.sst </dt>
+<dd></dd>
+
+<dt>filename~de.sst </dt>
+<dd></dd>
+
+<dt>etc. would be placed in the same directory
+using the same convention as indeed would: </dt>
+<dd></dd>
+
+<dt>filename.sst </dt>
+<dd></dd>
+
+<dt>using the default
+convention mapping convention. </dt>
+<dd></dd>
+
+<dt>Selecting this form of filename will overide
+other language settings including the language header within a document.
+</dt>
+<dd> </dd>
+</dl>
+
+<h2><a name='sect29' href='#toc29'>Markup Document Directories and Database Mapping</a></h2>
+<p>
+Similarly there is a mapping
+to the database into which documents are placed. <p>
+The last part of a directory
+path is used to create a sub-directory into which generated documents are
+placed, in a database of the same name, unless overridden. <p>
+Documents within
+the directory  <i>~/ebook</i>  <p>
+<blockquote><i>~/ebook/free_culture.sst</i> </blockquote>
+<p>
+would be placed in tables
+within the database <p>
+<blockquote><i>SiSU_ebook</i> </blockquote>
+ 
+<h2><a name='sect30' href='#toc30'>SKINS - document, directory and site skins</a></h2>
+<p>
+Skins
+modify the default appearance of document output on a document, directory,
+or site wide basis. Skins are looked for in the following locations: <p>
+<i>./_sisu/skin</i>
+<p>
+<i>~/.sisu/skin</i> <p>
+<i>/etc/sisu/skin</i> <p>
+Within the skin directory are the following
+the default sub-directories for document skins: <p>
+<i>./skin/doc</i> <p>
+<i>./skin/dir</i> <p>
+<i>./skin/site</i>
+<p>
+Documents take on a document skin, if the header of the document specifies
+a skin to be used. <p>
+A directory may be mapped on to a particular skin, so
+all documents within that directory take on a particular appearance. If
+a skin exists in the skin/dir with the same name as the document directory,
+it will automatically be used for each of the documents in that directory,
+(except where a document specifies the use of another skin, in the skin/doc
+directory). when  end <p>
+A personal habit is to place all skins within the
+doc directory, and symbolic links as needed from the site, or dir directories
+as required. <p>
+A site skin, modifies the program default skin. <p>
+Sample skins
+may be found in /etc/sisu/skin/doc and /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc
+(or equivalent directory) <p>
+Samples of list.yml and promo.yml may be found
+in /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent
+directory)  
+<h2><a name='sect31' href='#toc31'>Document Naming Convention</a></h2>
+<p>
+SiSU documents are named with the
+suffix  <i>ss</i>  followed by a third distinguishing letter, usually t for ordinary
+text files. <p>
+<i>.sst</i> is used by regular documents, and for most purposes is all
+you need to be aware of <p>
+<i>.ssm</i> suffix indicates a master or composite document,
+i.e. a document which requests other documents, which may have the file extension
+.sst or .ssi. See section on Composite Documents for information on how these
+are prepared. <p>
+<i>.ssi</i> indicates some prepared sisu markup information that is
+to be requested within master or composite document(s) and is not to be
+processed as a stand-alone document. <p>
+<i>._sst</i> and <i>.-sst</i> suffix are reserved for
+SiSU processing, and indicate a secondary file. Such secondary files are
+created when a composite file is constructed, and when a url is provided,
+it is saved locally for processing, as a secondary processing file. Secondary
+files may be clobbered by SiSU at will, and are not a way of storing information.
+
+<p> <i>.sxs.xml</i> simple xml sax, sisu markup representation 
+<p> <i>.sxd.xml</i> simple xml dom,
+
+<p>sisu markup representation 
+<p> <i>.sxn.xml</i> simple xml node, sisu markup representation
+
+<p> <i>.sxs.xml.sst</i> or <i>.sxd.xml.sst</i> or <i>.sxn.xml.sst</i> auto-converted from a simple xml markup
+representation (sxs, sxd, sxn)  
+<h2><a name='sect32' href='#toc32'>Remote Operations</a></h2>
+<p>
+These may be of three
+basic types. <p>
+Instruction that processed files are to be copied to a remote
+server, using the -r or -R flag as part of the processing instruction. This
+requires previous setting up/configuration of the method to be used (eg
+scp assumed for -r and rsync for -R) and url to which these files are to
+be sent. * <p>
+The downloading of a remote file for processing using SiSU locally,
+which is achieved in one of two ways: <p>
+A processing instruction may include
+the url to the a remote file that is to be processed - this will be downloaded
+and given a temporary file .t extension, and will be processed using SiSU
+locally. <p>
+A file may request the inclusion of a remote document within it,
+see comments on "Composite Documents" for the request syntax. <p>
+Finally SiSU
+may be run on a remote server, which you download marked up files to for
+processing. This is not really a function of the operation of SiSU, just
+an available possibility given that not much bandwidth is required. <p>
+* with
+regard to remote files processed locally, the -r option, a limitation is
+that it is up to the user to ensure that the remote file does not have
+an identical filename to another, e.g. local file, that is to be processed
+in the same directory. So far this has not been found to happen in practice...
+Alternative solutions are under consideration, but it is desired that filenames
+be human assigned, and meaningful, so hash keys of contents for filenames
+are not amongst the options considered.  
+<h2><a name='sect33' href='#toc33'>Note</a></h2>
+<p>
+For basic use only a fraction
+of the information provided here is required. There may be a bit of an information
+management problem in determining what though. For the markup of a book
+see the samples provided in  <i>&lt;<a href='http://www.jus.uio.no/sisu/sample'>http://www.jus.uio.no/sisu/sample</a>
+&gt;</i> and referred
+to in the text <i>&lt;<a href='http://www.jus.uio.no/sisu/SiSU'>http://www.jus.uio.no/sisu/SiSU</a>
+&gt;</i> The flags to generate html
+and pdf for use locally would be sisu -mHp [name of file to be processed]
+This does assume an ok install and setup of SiSU and the associated software
+it uses. 
+<p>  
+<h2><a name='sect34' href='#toc34'>Processing Examples</a></h2>
+<p>
+To initialise a new directory <b>sisu</b> <i>-C</i> <p>
+Note:
+this create a corresponding output subdirectory and this copies css stylesheet
+files and basic image files to the output directory. The output directory
+is created in the output path/directory as a subdirectory with its name
+corresponding to that of the directory you are currently initialising. <p>
+generate
+the metafile used in subsequent processing only (note changes made to the
+markup file will not appear in subsequently generated text unless this
+flag is used: <b>sisu</b> <i>-m</i> [filename or wildcard] <p>
+to create html and pdf output,
+with verbose output of samplefile1.sst and samplefile2.sst <b>sisu</b> <i>-mhpv</i> samplefile1.sst
+samplefile2.sst <blockquote>Note:  <i>-m</i> does initial processing, and  <i>-H</i> omits filename
+suffixes and requires a properly configured web server. <i>-h</i> is used to include
+filename suffixes for file system viewing </blockquote>
+<p>
+generate html, a word map and
+pdf with verbose output for all marked up documents in a directory: <b>sisu</b>
+<i>-mhwpv</i> * <p>
+generate html, word map, pdf, plaintext, xhtml, xml sax and xml
+dom versions with verbose output for all marked up documents in a directory:
+<b>sisu</b> <i>-mhwpabxXv</i> * <p>
+to create html, pdf, xml, plaintext and a concordance
+file (wordmap) as output, with verbose output of all marked up files in
+a directory <b>sisu</b> <i>-mhpxXawv</i> *.{r,s}? <p>
+generate html, word map and pdf and place
+on remote server with verbose output 2 named example files in a directory
+(assumes has been set up, and first time must be run without other flags
+ie sisu  <i>-mrv</i> [filenames/wildcard]): <b>sisu</b> <i>-mhwprv</i> example_file.sst other_example_file.sst
+<p>
+to process a remote sisu marked up file (html,pdf,concordance), provide
+the url(s) (works for text only files, will be downloaded and processed
+locally): <b>sisu</b> <i>-mhwpv</i> <a href='http://www.jus.uio.no/sisu/sample/markup/gpl2.fsf.sst'>http://www.jus.uio.no/sisu/sample/markup/gpl2.fsf.sst</a>
+ http://www.jus.uio.no/sisu/sample/markup/autonomy_markup0.sst
+<p>
+one file is local the other remote process (html,pdf,concordance,plaintext
+and place on pre-set remote destination): <b>sisu</b> <i>-mhwparv</i> gpl2.fsf.sst <a href='http://www.jus.uio.no/sisu/sample/markup/autonomy_markup0.sst'>http://www.jus.uio.no/sisu/sample/markup/autonomy_markup0.sst</a>
+
+<p>
+initialize database, create relations (first manually create database with
+same name as working directory): <b>sisu</b> <i>-Dv</i> createall <p>
+it may be necessary
+to first run <b>sisu</b> <i>-Dv</i> createdb <p>
+import all marked up files first time into
+a database: <b>sisu</b> <i>-Dv</i> import * <p>
+<i>-c</i> toggles color  
+<h2><a name='sect35' href='#toc35'>Interactive Help Options</a></h2>
+<p>
+SiSU
+has an interactive help, which is accessed by typing just "sisu" at the
+command line, or as described below: <b>sisu</b> commands, document preparation,
+customisation, installation etc.  <br>
+<pre>try:
+sisu --help  
+  sisu help
+    help             sisu --help
+    commands         sisu --help commands
+    environment      sisu --help env
+  ------------------------------------------
+  Using SiSU
+    commands:        sisu --help commands
+  ------------------------------------------
+  Preparing Documents for SiSU
+    markup:          sisu --help markup     (an incomplete overview)
+    headers:         sisu --help headers    (document-wide instructions, meta-data)
+    structure        sisu --help structure  (document structure, headings,
+tables of contents)
+    endnotes:        sisu --help endnotes
+    tables:          sisu --help tables
+    an example 0.37: sisu --help example37
+    an example 0.38: sisu --help example38
+  ------------------------------------------
+    search           sisu --help search
+  ------------------------------------------
+    customise:       sisu --help customise
+  ------------------------------------------
+  SiSU&rsquo;s License
+    license:         sisu --help license
+  sisu interactive help topics include:
+        keywords include: list, commands, shortcuts, markup, syntax, headers,
+        headings, endnotes, tables, example, customise, skin, environment,
+        directories, path, language, db, install, setup, configure,
+        external_programs, dublincore, termsheet, search, features,
+        external_programs, license, exit
+</pre>
+<p> 
+<h2><a name='sect36' href='#toc36'>SiSU VERSION CONVERSION</a></h2>
+<p>
+<i>sisu</i> --to-current [filename/wildcard] converts from
+0.37 markup to current markup (0.38) 
+<p> <i>sisu</i> --to-38 [filename/wildcard] converts
+
+<p>from 0.37 markup to 0.38 
+<p> <i>sisu</i> --to-37 [filename/wildcard] converts from 0.38
+
+<p>markup to 0.37 
+<p> <i>sisu</i> --convert-36to37 [filename/wildcard] re-names file from
+
+<p>pre-0.36 convention to 0.37 
+<p> <i>sisu</i> --convert-footnotes [filename/wildcard] converts
+
+<p>footnotes to preferred embedded footnote markup style 
+<p> <i>sisu</i> --convert-footnotes-force
+[filename/wildcard] converts footnotes to preferred embedded footnote markup
+style, even if there is a mismatch of footnote numbers. WARNING: there is
+a problem with the source document and it is necessary to manually check
+where each footnotes actually should be. 
+<p> convert from sst to simple xml
+representations (sax, dom and node): 
+<p> <i>sisu</i> --to-sax [filename/wildcard] or
+<i>sisu</i> --to-sxs [filename/wildcard] 
+<p> <i>sisu</i> --to-dom [filename/wildcard] or <i>sisu</i>
+--to-sxd [filename/wildcard] 
+<p> <i>sisu</i> --to-node [filename/wildcard] or <i>sisu</i> --to-sxn
+[filename/wildcard] 
+<p> convert to sst from simple xml representations (sax,
+dom and node): 
+<p> <i>sisu</i> --from-xml2sst [filename/wildcard [.sxs.xml,.sxd.xml,sxn.xml]]
+
+<p> or the same: 
+<p> <i>sisu</i> --from-sxml [filename/wildcard [.sxs.xml,.sxd.xml,sxn.xml]]
+
+<p> <i>sisu</i> --from-kdi [kdissert filename] attempts to convert a kdissert file (.kdi)
+
+<p>to sisu markup 
+<p> <i>sisu</i> --identify [filename/wildcard]  attempts to identify
+
+<p>the markup version of the file 
+<p> <i>sisu</i> --query=[version number] and <i>sisu</i> --query=history
+
+<p>provides a brief summary of changes to SiSU markup 
+<p> 
+<h2><a name='sect37' href='#toc37'>Sample Markup Documents</a></h2>
+<p>
+
+<p>
+Sample markup documents are provided in sisu-examples and are available
+online. 
+<p>  
+<h2><a name='sect38' href='#toc38'>Home Page</a></h2>
+<p>
+<i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i> 
+<p> 
+<h2><a name='sect39' href='#toc39'>Author</a></h2>
+Ralph Amissah <i>&lt;ralph@amissah.com&gt;</i>
+or <i>&lt;ralph.amissah@gmail.com&gt;</i> 
+<p> 
+<h2><a name='sect40' href='#toc40'>See Also</a></h2>
+<a href='http:~/bin/man2html?sisu:8'><b>sisu(8)</a>
+,</b> <a href='http:~/bin/man2html?sisu_webrick:1'><b>sisu_webrick(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu_termsheet:1'><b>sisu_termsheet(1)</a>
+,</b>
+<a href='http:~/bin/man2html?sisu_pdf:1'><b>sisu_pdf(1)</b></a>
+ <a href='http:~/bin/man2html?sisu_sqlite:1'><b>sisu_sqlite(1)</b></a>
+ <a href='http:~/bin/man2html?sisu_postgresql:1'><b>sisu_postgresql(1)</b></a>
+ <a href='http:~/bin/man2html?sisu_vim:7'><b>sisu_vim(7)</b></a>
+ <p>
+
+<hr><p>
+<a name='toc'><b>Table of Contents</b></a><p>
+<ul>
+<li><a name='toc0' href='#sect0'>Name</a></li>
+<li><a name='toc1' href='#sect1'>Synopsis</a></li>
+<li><a name='toc2' href='#sect2'>Description</a></li>
+<li><a name='toc3' href='#sect3'>Summary of man page</a></li>
+<li><a name='toc4' href='#sect4'>Document Processing Command Flags</a></li>
+<li><a name='toc5' href='#sect5'>modifiers</a></li>
+<li><a name='toc6' href='#sect6'>databases</a></li>
+<li><a name='toc7' href='#sect7'>Shortcuts, Shorthand for multiple flags</a></li>
+<li><a name='toc8' href='#sect8'>Document Markup</a></li>
+<li><a name='toc9' href='#sect9'>Basic Markup</a></li>
+<li><a name='toc10' href='#sect10'>Footnotes/Endnotes</a></li>
+<li><a name='toc11' href='#sect11'>Line Operations (marker placed at start of line)</a></li>
+<li><a name='toc12' href='#sect12'>Links</a></li>
+<li><a name='toc13' href='#sect13'>Adding a fixed names in html</a></li>
+<li><a name='toc14' href='#sect14'>Escape object citation numbering</a></li>
+<li><a name='toc15' href='#sect15'>Page breaks (LaTeX/pdf)</a></li>
+<li><a name='toc16' href='#sect16'>Comment line</a></li>
+<li><a name='toc17' href='#sect17'>Special characters</a></li>
+<li><a name='toc18' href='#sect18'>Tables</a></li>
+<li><a name='toc19' href='#sect19'>Other Grouped or Pre-formatted Text</a></li>
+<li><a name='toc20' href='#sect20'>Composite Documents</a></li>
+<li><a name='toc21' href='#sect21'>Document Headers</a></li>
+<li><a name='toc22' href='#sect22'>Outline of header options</a></li>
+<li><a name='toc23' href='#sect23'>Configuration Files</a></li>
+<li><a name='toc24' href='#sect24'>More HELP on Markup and headers</a></li>
+<li><a name='toc25' href='#sect25'>DIRECTORY STRUCTURE & Document Output</a></li>
+<li><a name='toc26' href='#sect26'>Default Directories</a></li>
+<li><a name='toc27' href='#sect27'>Markup Document Directories and File Mapping</a></li>
+<li><a name='toc28' href='#sect28'>Multi-language Document File Naming and Directory Mapping</a></li>
+<li><a name='toc29' href='#sect29'>Markup Document Directories and Database Mapping</a></li>
+<li><a name='toc30' href='#sect30'>SKINS - document, directory and site skins</a></li>
+<li><a name='toc31' href='#sect31'>Document Naming Convention</a></li>
+<li><a name='toc32' href='#sect32'>Remote Operations</a></li>
+<li><a name='toc33' href='#sect33'>Note</a></li>
+<li><a name='toc34' href='#sect34'>Processing Examples</a></li>
+<li><a name='toc35' href='#sect35'>Interactive Help Options</a></li>
+<li><a name='toc36' href='#sect36'>SiSU VERSION CONVERSION</a></li>
+<li><a name='toc37' href='#sect37'>Sample Markup Documents</a></li>
+<li><a name='toc38' href='#sect38'>Home Page</a></li>
+<li><a name='toc39' href='#sect39'>Author</a></li>
+<li><a name='toc40' href='#sect40'>See Also</a></li>
+</ul>
+</body>
+</html>
diff --git a/data/doc/sisu/html/sisu.8.html b/data/doc/sisu/html/sisu.8.html
new file mode 100644
index 00000000..755d1d32
--- /dev/null
+++ b/data/doc/sisu/html/sisu.8.html
@@ -0,0 +1,229 @@
+         <!-- manual page source format generated by PolyglotMan v3.2, -->
+<!-- available at http://polyglotman.sourceforge.net/ -->
+
+<html>
+<head>
+<title>sisu(8) manual page</title>
+</head>
+<body bgcolor='white'>
+<a href='#toc'>Table of Contents</a><p>
+
+<h2><a name='sect0' href='#toc0'>Name</a></h2>
+<b>SiSU</b> - Structured information, Serialized Units - a document
+publishing system 
+<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
+<b>sisu</b> <b>[-mhwpxXv...] [</b> <i>filename/wildcard</i> <b>]</b>  
+<h2><a name='sect2' href='#toc2'>Description</a></h2>
+A
+document publishing system, that from a simple single marked-up document,
+produces a multitude of output formats including: html, latex, pdf, info,
+and sql output, which can be cross referenced as having the same document
+structure and text object numbering, "object citation numbering". Features
+include its&rsquo; simple syntax; the semantic identification of documents using
+the Dublin Core; document management; built to be associated with a revision
+control system; text object numbering for the identification of a texts
+location in any of the output formats, easy skinning on a site wide, or
+per document basis, ... for more see  <i>man</i> 1 sisu or  <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i>
+<p>
+<b>SiSU is an alternative way of publishing and managing documents.</b>  
+<h2><a name='sect3' href='#toc3'>Installation</a></h2>
+<p>
+Up
+to date information on SiSU downloads, and their installation should be
+available from: <i>&lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html'>http://www.jus.uio.no/sisu/SiSU/download.html</a>
+&gt;</i> or at: <i>&lt;<a href='http://www.jus.uio.no/sisu/sisu_download/download.html'>http://www.jus.uio.no/sisu/sisu_download/download.html</a>
+&gt;</i>
+<p>
+There you should find links to the latest source tarball, and instructions
+on how to install SiSU. <p>
+Sample marked up documents are are available at
+<i>/usr/share/doc/sisu/sisu_markup_samples/dfsg</i> or equivalent directory, or
+online at <i>&lt;<a href='http://www.jus.uio.no/sisu/sample/markup.html'>http://www.jus.uio.no/sisu/sample/markup.html</a>
+&gt;</i> or for viewing in html
+with syntax highlighting from <i>&lt;<a href='http://www.jus.uio.no/sisu/sample/syntax'>http://www.jus.uio.no/sisu/sample/syntax</a>
+&gt;</i> <p>
+A syntax
+table is provided at  <i>/usr/share/doc/sisu/on_markup.txt</i> or equivalent, and
+online at <i>&lt;<a href='http://www.jus.uio.no/sisu/sample/on_markup.txt'>http://www.jus.uio.no/sisu/sample/on_markup.txt</a>
+&gt;</i> <p>
+<i>man</i> 1 sisu has a
+syntax table along with processing commands. <p>
+SiSU also provides some help
+via the command:  <i>sisu</i> --help and selecting an appropriate subject, e.g. <p>
+<i>sisu</i>
+--help commands <p>
+<i>sisu</i> --help markup <p>
+<i>sisu</i> --help headers <p>
+<i>sisu</i> --help env <p>
+The rest
+of this note is on post installation setup  
+<h2><a name='sect4' href='#toc4'>Post Installation Setup - Quick
+start</a></h2>
+<p>
+After installation of sisu-complete, move to the document samples directory
+<p>
+  cd /usr/share/doc/sisu/sisu_markup_samples/dfsg<br>
+ <p>
+and run <p>
+  sisu -1 free_as_in_freedom.rms_and_free_software.sam_williams.sst<br>
+ <p>
+or the same: <p>
+  sisu  -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst<br>
+ <p>
+look at output results, see the "sisu_manifest" page created for the document
+<p>
+To generate an online document move to a writable directory, (create a
+work directory and cd into it) as the file will be downloaded there and
+e.g. <p>
+<i>sisu</i> -1 <a href='http://www.jus.uio.no/sisu/gpl2.fsf/gpl2.fsf.sst'>http://www.jus.uio.no/sisu/gpl2.fsf/gpl2.fsf.sst</a>
+ <p>
+<i>sisu</i> -3 <a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst</a>
+
+<p>
+examine source document, vim has syntax highlighting support <p>
+gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst
+<p>
+additional markup samples in <i>&lt;<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
+&gt;</i> <p>
+it should
+also be possible to run sisu against sisupods (prepared zip files, created
+by running the command sisu -S [filename]), whether stored locally or remotely.
+<p>
+<i>sisu</i> -3 <a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a>
+ <p>
+there
+is a security issue associated with the running of document skins that
+are not your own, so these are turned of by default, and the use of the
+following command, which switches on the associated skin is not recommended:
+<p>
+<i>sisu</i> -3 --trust <a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a>
+
+<p>
+For help <i>man</i> sisu <p>
+<i>sisu</i> --help <p>
+<i>sisu</i> --help env for the way sisu "sees/maps"
+your system <p>
+<i>sisu</i> --help commands for list of commands and so on <p>
+ <b>Document
+markup directory</b> <p>
+Perhaps the easiest way to begin is to create a directory
+for sisu marked up documents within your home directory, and copy the file
+structure (and document samples) provided in the document sample directory:
+<i>mkdir</i> ~/sisu_test <p>
+<i>cd</i> ~/sisu_test <p>
+<i>cp</i> -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/*
+~/sisu_test/. <p>
+<b>----------</b> <p>
+<b>Tip: </b> the markup syntax examples may be of interest  <i>&lt;<a href='http://www.jus.uio.no/sisu/sample/'>http://www.jus.uio.no/sisu/sample/</a>
+&gt;</i>
+<p>
+<b>Tip:</b> <i>sisu</i> -U [sisu markup filename] should printout the different possible
+outputs and where sisu would place them. <p>
+<b>Tip: </b> if you want to toggle ansi
+color add  <i>c</i> to your flags. <p>
+<b>----------</b> <p>
+ <b>SiSU configuration file search path is:</b> <p>
+<i>./_sisu/sisurc.yaml</i>
+<p>
+<i>~/.sisu/sisurc.yaml</i> <p>
+<i>/etc/sisu/sisurc.yaml</i> <p>
+ 
+<h2><a name='sect5' href='#toc5'>Debian INSTALLATION Note</a></h2>
+<p>
+It is best
+you see <i>&lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#debian'>http://www.jus.uio.no/sisu/SiSU/download.html#debian</a>
+&gt;</i> for up the most
+up to date information. <p>
+notes taken from the Debian control file (end edited),
+gives an idea of additional packages that SiSU can make use of if available,
+(the use/requirement of some of which are interdependent for specific actions
+by SiSU): <p>
+Package: sisu <p>
+Depends: ruby (&gt;= 1.8.4), libwebrick-ruby <p>
+Recommends:
+sisu-pdf, sisu-sqlite, sisu-postgresql, librmagick-ruby, trang,   tidy, librexml-ruby,
+zip, unzip, openssl, rsync, openssh-client  lsh-client,<br>
+   keychain, hyperestraier, kdissert<br>
+ <p>
+Suggests: libfcgi-ruby1.8, rcs  cvs, lv, texinfo, pinfo, rename <p>
+Package:
+sisu-complete <p>
+Depends: ruby (&gt;= 1.8.4), sisu, sisu-pdf, sisu-postgresql, sisu-sqlite
+<p>
+Recommends: hyperestraier <p>
+Package: sisu-pdf <p>
+Depends: sisu, tetex-bin  texlive-base-bin,
+tetex-extra  texlive-latex-extra,   texlive-latex-extra, latex-ucs<br>
+ <p>
+Suggests: evince, xpdf <p>
+Package: sisu-postgresql <p>
+Depends: sisu, postgresql-8.1,
+libdbi-ruby, libdbm-ruby, libdbd-pg-ruby <p>
+Suggests: pgaccess, libdbd-pgsql, postgresql-contrib-8.1
+<p>
+Package: sisu-sqlite <p>
+Depends: sisu, sqlite, libdbi-ruby, libdbm-ruby, libdbd-sqlite-ruby
+<p>
+Suggests: libdbd-sqlite <p>
+Package: sisu-markup-samples <p>
+Depends: sisu <p>
+</pre> 
+<h2><a name='sect6' href='#toc6'>Document
+Resource Configuration</a></h2>
+<b>sisu</b> resource configuration information is obtained
+from sources (where they exist):  <br>
+<pre>~/.sisu/sisurc.yaml/etc/sisu/[sisu version]/sisurc.yamlsisu program defaults</pre><p>
+
+<b>Skins</b> <p>
+default document appearance may be modified using skins contained
+in sub-directories located at the following paths:  <br>
+<pre>./_sisu/skin~/.sisu/skin/etc/sisu/skin</pre><p>
+more specifically, the following locations
+(or their /etc/sisu equivalent) should be used: <p>
+<i>~/.sisu/skin/doc</i> skins for
+individual documents; <p>
+<i>~/.sisu/skin/dir</i> skins for directories of matching
+names; <p>
+<i>~/.sisu/skin/site</i> site-wide skin modifying the site-wide appearance
+of documents. <p>
+Usually all skin files are placed in the document skin directory:
+<i>~/.sisu/skin/doc</i> with softlinks being made to the skins contained there
+from other skin directories as required.  
+<h2><a name='sect7' href='#toc7'>Further Information</a></h2>
+<p>
+For more information
+on  <i>SiSU</i> see: <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i> <p>
+or <i>man</i> sisu  
+<h2><a name='sect8' href='#toc8'>Author</a></h2>
+Ralph Amissah
+<i>&lt;ralph@amissah.com&gt;</i> or <i>&lt;ralph.amissah@gmail.com&gt;</i> 
+<h2><a name='sect9' href='#toc9'>See Also</a></h2>
+<a href='http:~/bin/man2html?sisu:1'><b>sisu(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu_examples:1'><b>sisu_examples(1)</a>
+,</b>
+<a href='http:~/bin/man2html?sisu_webrick:1'><b>sisu_webrick(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu_pdf:1'><b>sisu_pdf(1)</b></a>
+ <a href='http:~/bin/man2html?sisu_sqlite:1'><b>sisu_sqlite(1)</b></a>
+ <a href='http:~/bin/man2html?sisu_postgresql:1'><b>sisu_postgresql(1)</b></a>
+ <a href='http:~/bin/man2html?sisu_termsheet:1'><b>sisu_termsheet(1)</a>
+,</b>
+<p>
+
+<hr><p>
+<a name='toc'><b>Table of Contents</b></a><p>
+<ul>
+<li><a name='toc0' href='#sect0'>Name</a></li>
+<li><a name='toc1' href='#sect1'>Synopsis</a></li>
+<li><a name='toc2' href='#sect2'>Description</a></li>
+<li><a name='toc3' href='#sect3'>Installation</a></li>
+<li><a name='toc4' href='#sect4'>Post Installation Setup - Quick start</a></li>
+<li><a name='toc5' href='#sect5'>Debian INSTALLATION Note</a></li>
+<li><a name='toc6' href='#sect6'>Document Resource Configuration</a></li>
+<li><a name='toc7' href='#sect7'>Further Information</a></li>
+<li><a name='toc8' href='#sect8'>Author</a></li>
+<li><a name='toc9' href='#sect9'>See Also</a></li>
+</ul>
+</body>
+</html>
diff --git a/data/doc/sisu/html/sisu_complete.7.html b/data/doc/sisu/html/sisu_complete.7.html
new file mode 100644
index 00000000..b4ab749e
--- /dev/null
+++ b/data/doc/sisu/html/sisu_complete.7.html
@@ -0,0 +1,54 @@
+         <!-- manual page source format generated by PolyglotMan v3.2, -->
+<!-- available at http://polyglotman.sourceforge.net/ -->
+
+<html>
+<head>
+<title>sisu_complete(7) manual page</title>
+</head>
+<body bgcolor='white'>
+<a href='#toc'>Table of Contents</a><p>
+
+<h2><a name='sect0' href='#toc0'>Name</a></h2>
+<b>SiSU</b> - Structured information, Serialized Units - a document
+publishing system, complete dependency package <p>
+
+<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
+Dummy package installs
+the whole of SiSU, excluding sisu-examples <p>
+sisu-complete together with sisu-examples
+is the whole of sisu  
+<h2><a name='sect2' href='#toc2'>Further Information</a></h2>
+<p>
+For more information on  <i>SiSU</i>
+see: <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i> <p>
+or <i>man</i> sisu 
+<h2><a name='sect3' href='#toc3'>Author</a></h2>
+Ralph Amissah <i>&lt;ralph@amissah.com&gt;</i>
+or <i>&lt;ralph.amissah@gmail.com&gt;</i> 
+<h2><a name='sect4' href='#toc4'>See</a></h2>
+<a href='http:~/bin/man2html?sisu:1'><b>sisu(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu:8'><b>sisu(8)</a>
+,</b> 
+<h2><a name='sect5' href='#toc5'>Also</a></h2>
+<a href='http:~/bin/man2html?sisu_webrick:1'><b>sisu_webrick(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu_pdf:7'><b>sisu_pdf(7)</b></a>
+
+<a href='http:~/bin/man2html?sisu_sqlite:7'><b>sisu_sqlite(7)</b></a>
+ <a href='http:~/bin/man2html?sisu_postgresql:7'><b>sisu_postgresql(7)</b></a>
+ <a href='http:~/bin/man2html?sisu_vim:7'><b>sisu_vim(7)</b></a>
+ <a href='http:~/bin/man2html?sisu_termsheet:1'><b>sisu_termsheet(1)</a>
+,</b> <p>
+
+<hr><p>
+<a name='toc'><b>Table of Contents</b></a><p>
+<ul>
+<li><a name='toc0' href='#sect0'>Name</a></li>
+<li><a name='toc1' href='#sect1'>Synopsis</a></li>
+<li><a name='toc2' href='#sect2'>Further Information</a></li>
+<li><a name='toc3' href='#sect3'>Author</a></li>
+<li><a name='toc4' href='#sect4'>See</a></li>
+<li><a name='toc5' href='#sect5'>Also</a></li>
+</ul>
+</body>
+</html>
diff --git a/data/doc/sisu/html/sisu_pdf.7.html b/data/doc/sisu/html/sisu_pdf.7.html
new file mode 100644
index 00000000..6f0cd214
--- /dev/null
+++ b/data/doc/sisu/html/sisu_pdf.7.html
@@ -0,0 +1,48 @@
+         <!-- manual page source format generated by PolyglotMan v3.2, -->
+<!-- available at http://polyglotman.sourceforge.net/ -->
+
+<html>
+<head>
+<title>sisu_pdf(7) manual page</title>
+</head>
+<body bgcolor='white'>
+<a href='#toc'>Table of Contents</a><p>
+
+<h2><a name='sect0' href='#toc0'>Name</a></h2>
+<b>SiSU</b> - Structured information, Serialized Units - a document
+publishing system <p>
+Dummy package installs the dependencies required to convert
+LaTeX output from SiSU to pdf 
+<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
+<b>sisu</b> <b>-p</b> [filename/wildcard]  
+<h2><a name='sect2' href='#toc2'>Description</a></h2>
+<b>sisu_pdf</b>
+<i>is</i> part of SiSU (man sisu) sisu_pdf is a dummy package to install dependencies
+needed for sisu to make rudimentary info files output, documented in man
+sisu  
+<h2><a name='sect3' href='#toc3'>Further Information</a></h2>
+<p>
+For more information on  <i>SiSU</i> see: <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i>
+<p>
+or <i>man</i> sisu 
+<h2><a name='sect4' href='#toc4'>Author</a></h2>
+Ralph Amissah <i>&lt;ralph@amissah.com&gt;</i> or <i>&lt;ralph.amissah@gmail.com&gt;</i>
+
+<h2><a name='sect5' href='#toc5'>See Also</a></h2>
+<a href='http:~/bin/man2html?sisu:1'><b>sisu(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu:8'><b>sisu(8)</a>
+,</b> <p>
+
+<hr><p>
+<a name='toc'><b>Table of Contents</b></a><p>
+<ul>
+<li><a name='toc0' href='#sect0'>Name</a></li>
+<li><a name='toc1' href='#sect1'>Synopsis</a></li>
+<li><a name='toc2' href='#sect2'>Description</a></li>
+<li><a name='toc3' href='#sect3'>Further Information</a></li>
+<li><a name='toc4' href='#sect4'>Author</a></li>
+<li><a name='toc5' href='#sect5'>See Also</a></li>
+</ul>
+</body>
+</html>
diff --git a/data/doc/sisu/html/sisu_postgresql.7.html b/data/doc/sisu/html/sisu_postgresql.7.html
new file mode 100644
index 00000000..90f04be4
--- /dev/null
+++ b/data/doc/sisu/html/sisu_postgresql.7.html
@@ -0,0 +1,95 @@
+ Universe   . Description: sisu postgresql package manpage . arch-tag: sisu
+manpage . later . -man -Tascii sisu.1 . most . sisu_postgresql 7  "September 09,
+2006" "version 0.46" "sisu -I" <!-- manual page source format generated by PolyglotMan v3.2, -->
+<!-- available at http://polyglotman.sourceforge.net/ -->
+
+<html>
+<head>
+<title>sisu_postgresql(7) manual page</title>
+</head>
+<body bgcolor='white'>
+<a href='#toc'>Table of Contents</a><p>
+
+<h2><a name='sect0' href='#toc0'>Name</a></h2>
+<b>SiSU</b> - Structured information, Serialized
+Units - a document publishing system, postgresql dependency package <p>
+Dummy
+package to install the dependencies required by SiSU to populate a postgresql
+database 
+<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
+<b>sisu</b> <i>-D</i> [instruction] <p>
+<i>-d</i>  --(sqlite|pg) --[instruction] [filename/wildcard
+if required] <p>
+<b>sisu</b> <i>--pgsql</i> --[instruction] [filename/wildcard if required] <p>
+
+
+<h2><a name='sect2' href='#toc2'>Description</a></h2>
+<b>sisu_postgresql</b> <i>is</i> part of SiSU (man sisu) sisu_postgresql is
+a dummy dummy package to install dependencies needed for sisu to populate
+a postgresql database, documented in man sisu  
+<h2><a name='sect3' href='#toc3'>databases</a></h2>
+
+<dl>
+
+<dt>dbi - database interface
+</dt>
+<dd><b>-D</b> set for  <i>postgresql</i>  </dd>
+
+<dt><b>--pgsql --createall</b> </dt>
+<dd>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) </dd>
+
+<dt><b>--pgsql --import -v </b> </dt>
+<dd><i>[filename/wildcard]</i> imports data specified to postgresql
+db (rb.dbi) </dd>
+
+<dt><b>--pgsql --update -v </b> </dt>
+<dd><i>[filename/wildcard]</i> updates/imports specified
+data to (postgresql) db (rb.dbi) </dd>
+
+<dt><b>--pgsql --remove -v </b> </dt>
+<dd><i>[filename/wildcard]</i> removes
+specified data to (postgresql) db (rb.dbi) </dd>
+
+<dt><b>--pgsql --dropall </b> </dt>
+<dd>kills data" and
+drops (postgresql) db, tables &amp; indexes </dd>
+
+<dt><b>--pgsql --recreate </b> </dt>
+<dd>kills data" and
+drops and rebuilds empty (postgresql) db, tables &amp; </dd>
+</dl>
+indexes </blockquote>
+ 
+<h2><a name='sect4' href='#toc4'>Further Information</a></h2>
+<p>
+For
+more information on  <i>SiSU</i> see: <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i> <p>
+or <i>man</i> sisu 
+<h2><a name='sect5' href='#toc5'>Author</a></h2>
+Ralph
+Amissah <i>&lt;ralph@amissah.com&gt;</i> or <i>&lt;ralph.amissah@gmail.com&gt;</i> 
+<h2><a name='sect6' href='#toc6'>See Also</a></h2>
+<a href='http:~/bin/man2html?sisu:1'><b>sisu(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu:8'><b>sisu(8)</a>
+,</b>
+<a href='http:~/bin/man2html?sisu_sqlite:7'><b>sisu_sqlite(7)</a>
+,</b> <a href='http:~/bin/man2html?sisu_vim:7'><b>sisu_vim(7)</b></a>
+ <p>
+
+<hr><p>
+<a name='toc'><b>Table of Contents</b></a><p>
+<ul>
+<li><a name='toc0' href='#sect0'>Name</a></li>
+<li><a name='toc1' href='#sect1'>Synopsis</a></li>
+<li><a name='toc2' href='#sect2'>Description</a></li>
+<li><a name='toc3' href='#sect3'>databases</a></li>
+<li><a name='toc4' href='#sect4'>Further Information</a></li>
+<li><a name='toc5' href='#sect5'>Author</a></li>
+<li><a name='toc6' href='#sect6'>See Also</a></li>
+</ul>
+</body>
+</html>
diff --git a/data/doc/sisu/html/sisu_sqlite.7.html b/data/doc/sisu/html/sisu_sqlite.7.html
new file mode 100644
index 00000000..4d85c37b
--- /dev/null
+++ b/data/doc/sisu/html/sisu_sqlite.7.html
@@ -0,0 +1,91 @@
+         <!-- manual page source format generated by PolyglotMan v3.2, -->
+<!-- available at http://polyglotman.sourceforge.net/ -->
+
+<html>
+<head>
+<title>sisu_sqlite(7) manual page</title>
+</head>
+<body bgcolor='white'>
+<a href='#toc'>Table of Contents</a><p>
+
+<h2><a name='sect0' href='#toc0'>Name</a></h2>
+<b>SiSU</b> - Structured information, Serialized Units - a document
+publishing system, sqlite dependency package <p>
+This is a dummy package to
+install the dependencies required by SiSU to populate an sqlite database
+
+<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
+<b>sisu</b> <i>-d</i> [instruction] [filename/wildcard if required] <p>
+<b>sisu</b> <i>-d</i>  --(sqlite|pg)
+--[instruction] [filename/wildcard if required] <p>
+ 
+<h2><a name='sect2' href='#toc2'>Description</a></h2>
+<b>sisu_sqlite</b> <i>is</i>
+part of SiSU (man sisu) sisu_sqlite is a dummy package to install dependencies
+needed for sisu to populate an sqlite database, documented in man sisu
+ 
+<h2><a name='sect3' href='#toc3'>databases</a></h2>
+
+<dl>
+
+<dt>dbi - database interface </dt>
+<dd><b>-d</b> set for  <i>sqlite</i>  </dd>
+
+<dt><b>--sqlite --createall</b> </dt>
+<dd>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) </dd>
+
+<dt><b>--sqlite --import -v </b> </dt>
+<dd><i>[filename/wildcard]</i>
+imports data specified to (sqlite) db (rb.dbi) </dd>
+
+<dt><b>--sqlite --update -v </b> </dt>
+<dd><i>[filename/wildcard]</i>
+updates/imports specified data to (sqlite) db (rb.dbi) </dd>
+
+<dt><b>--sqlite --remove -v </b>
+</dt>
+<dd><i>[filename/wildcard]</i> removes specified data to (sqlite) db (rb.dbi) </dd>
+
+<dt><b>--sqlite
+--dropall </b> </dt>
+<dd>kills data" and drops (postgresql) db, tables &amp; indexes </dd>
+
+<dt><b>--sqlite
+--recreate </b> </dt>
+<dd>kills data" and drops and rebuilds empty (postgresql) db, tables
+&amp; </dd>
+</dl>
+indexes </blockquote>
+ 
+<h2><a name='sect4' href='#toc4'>Further Information</a></h2>
+<p>
+For more information on  <i>SiSU</i> see: <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i>
+<p>
+or <i>man</i> sisu 
+<h2><a name='sect5' href='#toc5'>Author</a></h2>
+Ralph Amissah <i>&lt;ralph@amissah.com&gt;</i> or <i>&lt;ralph.amissah@gmail.com&gt;</i>
+
+<h2><a name='sect6' href='#toc6'>See Also</a></h2>
+<a href='http:~/bin/man2html?sisu:1'><b>sisu(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu:8'><b>sisu(8)</a>
+,</b> <a href='http:~/bin/man2html?sisu_postgresql:7'><b>sisu_postgresql(7)</a>
+,</b> <a href='http:~/bin/man2html?sisu_vim:7'><b>sisu_vim(7)</b></a>
+ <p>
+
+<hr><p>
+<a name='toc'><b>Table of Contents</b></a><p>
+<ul>
+<li><a name='toc0' href='#sect0'>Name</a></li>
+<li><a name='toc1' href='#sect1'>Synopsis</a></li>
+<li><a name='toc2' href='#sect2'>Description</a></li>
+<li><a name='toc3' href='#sect3'>databases</a></li>
+<li><a name='toc4' href='#sect4'>Further Information</a></li>
+<li><a name='toc5' href='#sect5'>Author</a></li>
+<li><a name='toc6' href='#sect6'>See Also</a></li>
+</ul>
+</body>
+</html>
diff --git a/data/doc/sisu/html/sisu_termsheet.1.html b/data/doc/sisu/html/sisu_termsheet.1.html
new file mode 100644
index 00000000..14a904d3
--- /dev/null
+++ b/data/doc/sisu/html/sisu_termsheet.1.html
@@ -0,0 +1,63 @@
+         <!-- manual page source format generated by PolyglotMan v3.2, -->
+<!-- available at http://polyglotman.sourceforge.net/ -->
+
+<html>
+<head>
+<title>sisu_termsheet(1) manual page</title>
+</head>
+<body bgcolor='white'>
+<a href='#toc'>Table of Contents</a><p>
+
+<h2><a name='sect0' href='#toc0'>Name</a></h2>
+<b>SiSU</b> - Structured information, Serialized Units - a document
+publishing system 
+<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
+<p>
+<b>sisu</b> <b>-t</b> <i>[termsheet-name(s)]</i>  
+<h2><a name='sect2' href='#toc2'>Description</a></h2>
+<b>sisu_termsheet</b>
+<i>is</i> part of SiSU is  <b>invoked</b> <i>through</i> the sisu command (man sisu) <p>
+ 
+<h2><a name='sect3' href='#toc3'>Summary
+of man page</a></h2>
+<p>
+sisu_termsheet, is started with the command: <b>sisu -t </b> <i>[termsheet-name(s)]</i>
+ 
+<h2><a name='sect4' href='#toc4'>Document Processing Command Flags</a></h2>
+<p>
+<b>sisu</b><i>&nbsp;-t</i><b>&nbsp;[termsheet-name(s)]</b> (runs sisu_termsheet)
+merges the termsheet(s) specified on the commandline with the documents
+it is instructed to merge in the termsheet(s), and produces regular  <i>SiSU</i>
+output documents from the merged results. <p>
+[further documentation on termsheets
+required]  
+<h2><a name='sect5' href='#toc5'>Further Information</a></h2>
+<p>
+For more information on  <i>SiSU</i> see: <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i>
+<p>
+or <i>man</i> sisu 
+<h2><a name='sect6' href='#toc6'>Author</a></h2>
+Ralph Amissah <i>&lt;ralph@amissah.com&gt;</i> or <i>&lt;ralph.amissah@gmail.com&gt;</i>
+
+<h2><a name='sect7' href='#toc7'>See Also</a></h2>
+<a href='http:~/bin/man2html?sisu:1'><b>sisu(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu:8'><b>sisu(8)</a>
+,</b> <a href='http:~/bin/man2html?sisu_webrick:1'><b>sisu_webrick(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu_vim:7'><b>sisu_vim(7)</b></a>
+ <p>
+
+<hr><p>
+<a name='toc'><b>Table of Contents</b></a><p>
+<ul>
+<li><a name='toc0' href='#sect0'>Name</a></li>
+<li><a name='toc1' href='#sect1'>Synopsis</a></li>
+<li><a name='toc2' href='#sect2'>Description</a></li>
+<li><a name='toc3' href='#sect3'>Summary of man page</a></li>
+<li><a name='toc4' href='#sect4'>Document Processing Command Flags</a></li>
+<li><a name='toc5' href='#sect5'>Further Information</a></li>
+<li><a name='toc6' href='#sect6'>Author</a></li>
+<li><a name='toc7' href='#sect7'>See Also</a></li>
+</ul>
+</body>
+</html>
diff --git a/data/doc/sisu/html/sisu_vim.7.html b/data/doc/sisu/html/sisu_vim.7.html
new file mode 100644
index 00000000..0909ce6a
--- /dev/null
+++ b/data/doc/sisu/html/sisu_vim.7.html
@@ -0,0 +1,60 @@
+         <!-- manual page source format generated by PolyglotMan v3.2, -->
+<!-- available at http://polyglotman.sourceforge.net/ -->
+
+<html>
+<head>
+<title>vim_sisu(7) manual page</title>
+</head>
+<body bgcolor='white'>
+<a href='#toc'>Table of Contents</a><p>
+
+<h2><a name='sect0' href='#toc0'>Name</a></h2>
+<b>SiSU</b> - Structured information, Serialized Units - a document
+publishing system. 
+<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
+<p>
+An ftplugin to provide vim folds for SiSU markup,
+and to set some defaults for SiSU markup in installed by sisu. <p>
+Vim 7 includes
+sisu markup syntax highlighting. <p>
+Vim related files are included in /usr/share/sisu/vim/addons,
+(including the syntax highlighter which may be used by Vim 6). <p>
+sisu-vim actions
+are activated on files with the suffix .sst .ssm .ssi .-sst ._sst (and the same
+with a further .meta extension) <p>
+<b>&lt;ctrl&gt;F</b> activate folds on headings matched
+in a document (also provides folds when sourced on a ruby program file),
+also <b>:F</b> <p>
+<b>&lt;ctrl&gt;S</b> search and replace down <p>
+<b>&lt;ctrl&gt;G</b> search and replace globally
+within file <p>
+<b>&lt;ctrl&gt;X</b> ruby regex global search and replace within file <p>
+<b>&lt;ctrl&gt;C</b>
+set color scheme to <b>slate</b> which is provided  
+<h2><a name='sect2' href='#toc2'>Further Information</a></h2>
+<p>
+For more
+information on  <i>SiSU</i> see: <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i> <p>
+or <i>man</i> sisu 
+<h2><a name='sect3' href='#toc3'>Author</a></h2>
+Ralph
+Amissah <i>&lt;ralph@amissah.com&gt;</i> or <i>&lt;ralph.amissah@gmail.com&gt;</i> 
+<h2><a name='sect4' href='#toc4'>See Also</a></h2>
+<a href='http:~/bin/man2html?sisu:1'><b>sisu(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu:8'><b>sisu(8)</a>
+,</b>
+<a href='http:~/bin/man2html?sisu_webrick:1'><b>sisu_webrick(1)</b></a>
+ <p>
+
+<hr><p>
+<a name='toc'><b>Table of Contents</b></a><p>
+<ul>
+<li><a name='toc0' href='#sect0'>Name</a></li>
+<li><a name='toc1' href='#sect1'>Synopsis</a></li>
+<li><a name='toc2' href='#sect2'>Further Information</a></li>
+<li><a name='toc3' href='#sect3'>Author</a></li>
+<li><a name='toc4' href='#sect4'>See Also</a></li>
+</ul>
+</body>
+</html>
diff --git a/data/doc/sisu/html/sisu_webrick.1.html b/data/doc/sisu/html/sisu_webrick.1.html
new file mode 100644
index 00000000..f82412e2
--- /dev/null
+++ b/data/doc/sisu/html/sisu_webrick.1.html
@@ -0,0 +1,69 @@
+         <!-- manual page source format generated by PolyglotMan v3.2, -->
+<!-- available at http://polyglotman.sourceforge.net/ -->
+
+<html>
+<head>
+<title>sisu_webrick(1) manual page</title>
+</head>
+<body bgcolor='white'>
+<a href='#toc'>Table of Contents</a><p>
+
+<h2><a name='sect0' href='#toc0'>Name</a></h2>
+<b>SiSU</b> - Structured information, Serialized Units - a document
+publishing system 
+<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
+<b>sisu_webrick</b> <i>[port]</i> <p>
+or <p>
+<b>sisu</b> <b>-W</b> <i>[port]</i>  
+<h2><a name='sect2' href='#toc2'>Description</a></h2>
+<b>sisu_webrick</b>
+<i>is</i> part of SiSU (man sisu) sisu_webrick starts Ruby&rsquo;s Webrick web-server
+and points it to the directories to which  <i>SiSU</i> output is written, providing
+a list of these directories (assuming  <i>SiSU</i>  is in use and they exist).
+<p>
+The default port for sisu_webrick is set to 8081, this may be modified
+in the yaml file: <i>~/.sisu/sisurc.yaml</i> a sample of which is provided as <i>/etc/sisu/sisurc.yaml</i>
+(or in the equivalent directory on your system).  
+<h2><a name='sect3' href='#toc3'>Summary of man page</a></h2>
+<p>
+sisu_webrick,
+may be started on it&rsquo;s own with the command: <b>sisu_webrick</b> <i>[port]</i> or using
+the sisu command with the -W flag: <b>sisu -W </b> <i>[port]</i> <p>
+where no port is given
+and settings are unchanged the default port is 8081  
+<h2><a name='sect4' href='#toc4'>Document Processing
+Command Flags</a></h2>
+<p>
+<b>sisu</b><i>&nbsp;-W</i><b>&nbsp;[port]</b> starts Ruby Webrick web-server, serving <i>SiSU</i> output
+directories, on the port provided, or if no port is provided and the defaults
+have not been changed in  <i>~/.sisu/sisurc.yaml</i> then on port 8081  
+<h2><a name='sect5' href='#toc5'>Further
+Information</a></h2>
+<p>
+For more information on  <i>SiSU</i> see: <i>&lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
+&gt;</i> <p>
+or
+<i>man</i> sisu 
+<h2><a name='sect6' href='#toc6'>Author</a></h2>
+Ralph Amissah <i>&lt;ralph@amissah.com&gt;</i> or <i>&lt;ralph.amissah@gmail.com&gt;</i>
+
+<h2><a name='sect7' href='#toc7'>See Also</a></h2>
+<a href='http:~/bin/man2html?sisu:1'><b>sisu(1)</a>
+,</b> <a href='http:~/bin/man2html?sisu_vim:7'><b>sisu_vim(7)</b></a>
+ <a href='http:~/bin/man2html?sisu:8'><b>sisu(8)</a>
+,</b> <p>
+
+<hr><p>
+<a name='toc'><b>Table of Contents</b></a><p>
+<ul>
+<li><a name='toc0' href='#sect0'>Name</a></li>
+<li><a name='toc1' href='#sect1'>Synopsis</a></li>
+<li><a name='toc2' href='#sect2'>Description</a></li>
+<li><a name='toc3' href='#sect3'>Summary of man page</a></li>
+<li><a name='toc4' href='#sect4'>Document Processing Command Flags</a></li>
+<li><a name='toc5' href='#sect5'>Further Information</a></li>
+<li><a name='toc6' href='#sect6'>Author</a></li>
+<li><a name='toc7' href='#sect7'>See Also</a></li>
+</ul>
+</body>
+</html>
diff --git a/data/doc/sisu/model/README b/data/doc/sisu/model/README
new file mode 100644
index 00000000..0b03e45e
--- /dev/null
+++ b/data/doc/sisu/model/README
@@ -0,0 +1,14 @@
+Models of SiSU xml 
+[early attempt at modelling, not definitive]
+* xsd - xml schema
+* rnc - relax ng compact format
+* rng - relax ng xml format
+
+* input (markup) formats
+  * sax (.sxs.xml)
+  * dom (.sxd.xml)
+  * node (.sxn.xml)
+
+* output formats
+  * sax (sax.xml)
+  * dom (dom.xml)
diff --git a/data/doc/sisu/model/relaxng/sisu_object_model_dom.rnc b/data/doc/sisu/model/relaxng/sisu_object_model_dom.rnc
new file mode 100644
index 00000000..2ab5cf79
--- /dev/null
+++ b/data/doc/sisu/model/relaxng/sisu_object_model_dom.rnc
@@ -0,0 +1,148 @@
+#%% sisu object model: input
+#  Name: SiSU information Structuring Universe - Structured information, Serialized Units
+#  Author: Ralph Amissah
+#    http://www.jus.uio.no/sisu
+#    http://www.jus.uio.no/sisu/SiSU/download.html
+
+#  Description: sisu object models in relaxNG dom model base
+#               used for preliminary modeling, not definitive
+
+#  Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Ralph Amissah
+
+#  License: GPL 2 or later
+
+# Summary of GPL 2
+
+# This program is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the Free
+# Software Foundation; either version 2 of the License, or (at your option)
+# any later version.
+
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+# more details.
+
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+# If you have Internet connection, the latest version of the GPL should be
+# available at these locations:
+#   http://www.fsf.org/licenses/gpl.html
+#   http://www.gnu.org/copyleft/gpl.html
+#   http://www.jus.uio.no/sisu/gpl2.fsf
+
+# SiSU was first released to the public on January 4th 2005
+
+# SiSU uses:
+# 
+#   Standard SiSU markup syntax,
+#   Standard SiSU meta-markup syntax, and the
+#   Standard SiSU object citation numbering and system
+# 
+# © Ralph Amissah 1997, current 2006.
+# All Rights Reserved.
+
+#%% definitions
+#dublin core:
+element-dc =
+  ( attribute title { text }
+  #attribute subtitle { text }?
+  & attribute creator { text }?
+  & attribute subject { text }?
+  & attribute description { text }?
+  & attribute publisher { text }?
+  & attribute contributor { text }?
+  & attribute date { text }?
+  & attribute datecreated { text }?
+  & attribute dateissued { text }?
+  & attribute dateavailable { text }?
+  & attribute datevalid { text }?
+  & attribute datemodified { text }?
+  & attribute type { text }?
+  & attribute format { text }?
+  & attribute identifier { text }?
+  & attribute source { text }?
+  & attribute relation { text }?
+  & attribute coverage { text }?
+  & attribute rights { text }?
+  & attribute keywords { text }? )
+#element-paragraph = 
+#  text
+#  element b
+#  element i
+#  element u
+#endnotes, zero or many, embedded in text:
+element-endnote =
+  element endnote {
+    element number { text },
+    element note { text }
+  }*
+#body text/contents
+element-text =
+  element mytext {
+    text
+    & element-endnote
+  }
+#object citation number, unique sequential number for objects:
+element-ocn =
+  element ocn { text }
+#object container:
+element-object =
+  element object {
+    element-ocn,
+    #note nametag is only used in element-heading, object is used in both heading and content ->
+    element nametag { text }?,
+    element-text
+  }+
+#heading object container
+element-heading =
+  element heading {
+    element-object
+  }
+#content/paragraph/main text object container
+element-content =
+  element content {
+    element-object*
+  },
+#text includes <en> endnote pointer numbers, and <b> <i> <u> etc.
+#note includes <b> <i> <u> etc.
+#%% structure
+element document {
+  #document head:
+  element head {
+    attribute id { text },
+    element-dc,
+    attribute copyright { text }?
+    #element title {
+    #  attribute xml:lang { text },
+    #  text
+    #}
+  },
+  #document body:
+  element body { 
+    element heading1 {
+      element-heading,
+      element heading2 {
+        element-heading,
+        element heading3 {
+          element-heading,
+          element contents1 {
+            element-heading,
+            element-content*,
+            element contents2 {
+              element-heading,
+              element-content*,
+              element contents3 {
+                element-heading,
+                element-content*
+              }*
+            }*
+          }+
+        }+
+      }+
+    }+
+  }
+}
+
diff --git a/data/doc/sisu/model/relaxng/sisu_object_model_input.rnc b/data/doc/sisu/model/relaxng/sisu_object_model_input.rnc
new file mode 100644
index 00000000..56c2606c
--- /dev/null
+++ b/data/doc/sisu/model/relaxng/sisu_object_model_input.rnc
@@ -0,0 +1,186 @@
+#%% sisu object model: input
+#  Name: SiSU information Structuring Universe - Structured information, Serialized Units
+#  Author: Ralph Amissah
+#    http://www.jus.uio.no/sisu
+#    http://www.jus.uio.no/sisu/SiSU/download.html
+
+#  Description: sisu object models in relaxNG input model base
+#               used for preliminary modeling, not definitive
+
+#  Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Ralph Amissah
+
+#  License: GPL 2 or later
+
+# Summary of GPL 2
+
+# This program is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the Free
+# Software Foundation; either version 2 of the License, or (at your option)
+# any later version.
+
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+# more details.
+
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+# If you have Internet connection, the latest version of the GPL should be
+# available at these locations:
+#   http://www.fsf.org/licenses/gpl.html
+#   http://www.gnu.org/copyleft/gpl.html
+#   http://www.jus.uio.no/sisu/gpl2.fsf
+
+# SiSU was first released to the public on January 4th 2005
+
+# SiSU uses:
+# 
+#   Standard SiSU markup syntax,
+#   Standard SiSU meta-markup syntax, and the
+#   Standard SiSU object citation numbering and system
+# 
+# © Ralph Amissah 1997, current 2006.
+# All Rights Reserved.
+
+#%% definitions
+# dublin core:
+element-semantic =
+  element semantic {
+  # dublin core:
+  element title { text }
+  & element creator { text }?
+  & element subject { text }?
+  & element description { text }?
+  & element publisher { text }?
+  & element contributor { text }?
+  & element date { text }?
+  & element date.created { text }?
+  & element date.issued { text }?
+  & element date.available { text }?
+  & element date.valid { text }?
+  & element date.modified { text }?
+  & element type { text }?
+  & element format { text }?
+  & element identifier { text }?
+  & element source { text }?
+  & element relation { text }?
+  & element coverage { text }?
+  & element rights { text }?
+  & element keywords { text }?
+  # extended semantic metadata:
+  & attribute subtitle { text }?
+  & attribute illustrator { text }?
+  & attribute translator { text }?
+  & attribute prepared_by { text }?
+  & attribute digitized_by { text }?
+  & attribute language { text }?
+  & attribute language.original { text }?
+  & attribute classify.pg { text }?
+  & attribute classify.isbn { text }?
+  & attribute classify.dewey { text }?
+  & attribute classify.loc { text }?
+  & attribute prefix.a { text }?
+  & attribute prefix.b { text }?
+  & attribute suffix { text }?
+  & attribute comments { text }?
+  & attribute abstract { text }?
+  # & attribute information { text }?
+  & attribute contact { text }?
+  & attribute links { text }?
+  }
+element-processing =
+  element processing {
+  attribute structure { text }?
+  & attribute level { text }?
+  & attribute markup { text }?
+  & attribute bold { text }?
+  & attribute italics { text }?
+  & attribute papersize { text }?
+  & attribute vocabulary { text }?
+  & element date_scheme { text }?
+  & element date.issued.scheme { text }?
+  & element date.available.scheme { text }?
+  & element date.valid.scheme { text }?
+  & element date.modified.scheme { text }?
+  }?
+element-head =
+  element head {
+    # processing instructions, and semantic data, distinguish?:
+    element metadata {
+      element title { text },
+      element file { text },
+      element generator { text },
+      element-semantic,
+      element-processing
+    }+
+  }
+# body text/contents
+# includes <b> <i> <u> <del> <ins> <indent1> <bullet> etc.
+element-txt = 
+  element txt {
+    text*
+    & element b { text }*
+    & element i { text }*
+    & element u { text }*
+    & element ins { text }*
+    & element del { text }*
+  }
+element-endnote =
+  element endnote {
+    element number { text },
+    element note { element-txt }+
+  }+
+element-para =
+  element para {
+    # attribute paragraph_format { text },
+    element-txt+
+    & element-endnote?
+  }
+element-external_space =
+  element external_space {
+    # ignored by sisu, provide program needs
+    element program {
+      # e.g. kdissert
+      element name { text },
+      element xpos { text },
+      element ypos { text },
+      element font { text },
+      element outline_color { text },
+      element text_color { text },
+      element comment { text }
+    }*
+  }*,
+#%% structure
+  element document {
+    # document head:
+    element-head,
+    # document body:
+    element body {
+      # object, a unit of text, usually a paragraph with any associated endnotes
+      element node {
+        element structure {
+          # structure document using either node:heading levels or node:heading relationships:
+          # (i) sisu default uses node:heading levels (1-6 or A-C,1-3) to build document structure
+          element level { text }?,
+          # (ii) sisu alternatively could use node:heading relationship information to build document structure
+          element node.id { text },
+          element node.parent { text },
+          element node.child { text }*
+        },
+        element node.objects {
+          element object.heading {
+            # nametag used only in headings, especially important for segmented html
+            element nametag { text },
+            element-para
+          },
+          element object.para {
+            element-para
+          }*
+        }+,
+        element-external_space
+      }+
+    }
+  }
+
diff --git a/data/doc/sisu/model/relaxng/sisu_object_model_metaverse.rnc b/data/doc/sisu/model/relaxng/sisu_object_model_metaverse.rnc
new file mode 100644
index 00000000..913aee90
--- /dev/null
+++ b/data/doc/sisu/model/relaxng/sisu_object_model_metaverse.rnc
@@ -0,0 +1,210 @@
+#%% sisu object model: input
+#  Name: SiSU information Structuring Universe - Structured information, Serialized Units
+#  Author: Ralph Amissah
+#    http://www.jus.uio.no/sisu
+#    http://www.jus.uio.no/sisu/SiSU/download.html
+
+#  Description: sisu object models in relaxNG metaverse model base
+#               used for preliminary modeling, not definitive
+
+#  Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Ralph Amissah
+
+#  License: GPL 2 or later
+
+# Summary of GPL 2
+
+# This program is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the Free
+# Software Foundation; either version 2 of the License, or (at your option)
+# any later version.
+
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+# more details.
+
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+# If you have Internet connection, the latest version of the GPL should be
+# available at these locations:
+#   http://www.fsf.org/licenses/gpl.html
+#   http://www.gnu.org/copyleft/gpl.html
+#   http://www.jus.uio.no/sisu/gpl2.fsf
+
+# SiSU was first released to the public on January 4th 2005
+
+# SiSU uses:
+# 
+#   Standard SiSU markup syntax,
+#   Standard SiSU meta-markup syntax, and the
+#   Standard SiSU object citation numbering and system
+# 
+# © Ralph Amissah 1997, current 2006.
+# All Rights Reserved.
+
+#%% definitions
+# dublin core:
+element-semantic =
+  element semantic {
+  # dublin core:
+  element title { text }
+  & element creator { text }?
+  & element subject { text }?
+  & element description { text }?
+  & element publisher { text }?
+  & element contributor { text }?
+  & element date { text }?
+  & element date.created { text }?
+  & element date.issued { text }?
+  & element date.available { text }?
+  & element date.valid { text }?
+  & element date.modified { text }?
+  & element type { text }?
+  & element format { text }?
+  & element identifier { text }?
+  & element source { text }?
+  & element relation { text }?
+  & element coverage { text }?
+  & element rights { text }?
+  & element keywords { text }?
+  # extended semantic metadata:
+  & attribute subtitle { text }?
+  & attribute illustrator { text }?
+  & attribute translator { text }?
+  & attribute prepared_by { text }?
+  & attribute digitized_by { text }?
+  & attribute language { text }?
+  & attribute language.original { text }?
+  & attribute classify.pg { text }?
+  & attribute classify.isbn { text }?
+  & attribute classify.dewey { text }?
+  & attribute classify.loc { text }?
+  & attribute prefix.a { text }?
+  & attribute prefix.b { text }?
+  & attribute suffix { text }?
+  & attribute comments { text }?
+  & attribute abstract { text }?
+  # & attribute information { text }?
+  & attribute contact { text }?
+  & attribute links { text }?
+  }
+element-processing =
+  element processing {
+  attribute structure { text }?
+  & attribute level { text }?
+  & attribute markup { text }?
+  & attribute bold { text }?
+  & attribute italics { text }?
+  & attribute papersize { text }?
+  & attribute vocabulary { text }?
+  & element date_scheme { text }?
+  & element date.issued.scheme { text }?
+  & element date.available.scheme { text }?
+  & element date.valid.scheme { text }?
+  & element date.modified.scheme { text }?
+  }?
+element-head =
+  element head {
+    # processing instructions, and semantic data, distinguish?:
+    element metadata {
+      element title { text },
+      element file { text },
+      element generator { text },
+      element-semantic,
+      element-processing
+    }+
+  }
+# body text/contents
+# includes <b> <i> <u> <del> <ins> <indent1> <bullet> etc.
+element-txt = 
+  element txt {
+    text*
+    & element b { text }*
+    & element i { text }*
+    & element u { text }*
+    & element ins { text }*
+    & element del { text }*
+  }
+element-checksum.endnote = element checksum.clean { text }
+element-endnote =
+  element endnote {
+    element number { text },
+    element note { element-txt }+,
+    element-checksum.endnote
+  }+
+element-checksum.para =
+  element checksum.para {
+    element checksum.clean { text },
+    element checksum.marked { text }
+  }
+element-para =
+  element para {
+    # attribute paragraph_format { text },
+    element-txt+
+    & element-endnote?
+  }
+element-object =
+  element object {
+    element-para,
+    element-checksum.para
+  }
+# object citation number, unique sequential number for objects:
+element-ocn = element ocn { text }
+element-object_structure_summary =
+  element-ocn,
+  # type: heading level value 1 -6, or normal text
+  element type { text },
+  # type number: sequential number for designated type
+  element type_number { text },
+  # type category: sequential number for designated category, e.g. sequentially counting all headers
+  element category_number { text }
+element-external_space =
+  element external_space {
+    # ignored by sisu, provide program needs
+    element program {
+      # e.g. kdissert
+      element name { text },
+      element xpos { text },
+      element ypos { text },
+      element font { text },
+      element outline_color { text },
+      element text_color { text },
+      element comment { text }
+    }*
+  }*,
+#%% structure
+  element document {
+    # document head:
+    element-head,
+    # document body:
+    element body {
+      # object, a unit of text, usually a paragraph with any associated endnotes
+      element node {
+        element structure {
+          # structure document using either node:heading levels or node:heading relationships:
+          # (i) sisu default uses node:heading levels (1-6 or A-C,1-3) to build document structure
+          element level { text }?,
+          # (ii) sisu alternatively could use node:heading relationship information to build document structure
+          element node.id { text },
+          element node.parent { text },
+          element node.child { text }*
+        },
+        element node.objects {
+          element object.heading {
+            element-object_structure_summary,
+            # nametag used only in headings, especially important for segmented html
+            element nametag { text },
+            element-object
+          },
+          element object.para {
+            element-object_structure_summary,
+            element-object
+          }*
+        }+,
+        element-external_space
+      }+
+    }
+  }
+
diff --git a/data/doc/sisu/model/relaxng/sisu_object_model_sax.rnc b/data/doc/sisu/model/relaxng/sisu_object_model_sax.rnc
new file mode 100644
index 00000000..0c82dae1
--- /dev/null
+++ b/data/doc/sisu/model/relaxng/sisu_object_model_sax.rnc
@@ -0,0 +1,86 @@
+#%% sisu object model: input
+#  Name: SiSU information Structuring Universe - Structured information, Serialized Units
+#  Author: Ralph Amissah
+#    http://www.jus.uio.no/sisu
+#    http://www.jus.uio.no/sisu/SiSU/download.html
+
+#  Description: sisu object models in relaxNG sax model base
+#               used for preliminary modeling, not definitive
+
+#  Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Ralph Amissah
+
+#  License: GPL 2 or later
+
+# Summary of GPL 2
+
+# This program is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the Free
+# Software Foundation; either version 2 of the License, or (at your option)
+# any later version.
+
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+# more details.
+
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+# If you have Internet connection, the latest version of the GPL should be
+# available at these locations:
+#   http://www.fsf.org/licenses/gpl.html
+#   http://www.gnu.org/copyleft/gpl.html
+#   http://www.jus.uio.no/sisu/gpl2.fsf
+
+# SiSU was first released to the public on January 4th 2005
+
+# SiSU uses:
+# 
+#   Standard SiSU markup syntax,
+#   Standard SiSU meta-markup syntax, and the
+#   Standard SiSU object citation numbering and system
+# 
+# © Ralph Amissah 1997, current 2006.
+# All Rights Reserved.
+
+#  Ralph Amissah: ralph@amissah.com
+#                 ralph.amissah@gmail.com
+
+#%% definitions
+#text includes <en> endnote pointer numbers, and <b> <i> <u> etc.
+#note includes <b> <i> <u> etc.
+
+#%% structure
+element document {
+  #document head:
+  element head {
+    #dublin core:
+    element dc {
+      attribute class { text }
+    }+
+  },
+  #document body:
+  element body {
+    #object, a unit of text, usually a paragraph with any associated endnotes
+    element object {
+      attribute number { text },
+      element ocn { text },
+      #body content/text, whether ordinary paragraph or heading:
+      element text { 
+        #attributes indicates whether ordinary text (norm) or heading, (levels h[1-6]):
+        attribute class { text },
+        text
+      },
+      #endnotes, zero or many:
+      element endnote {
+        attribute notenumber { text },
+        #endnotes number:
+        element number { text },
+        #endnotes content/text:
+        element note { text }
+      }*
+    }+
+  }
+}
+
diff --git a/data/doc/sisu/model/relaxng/sisu_object_model_xhtml.rnc b/data/doc/sisu/model/relaxng/sisu_object_model_xhtml.rnc
new file mode 100644
index 00000000..c4930a40
--- /dev/null
+++ b/data/doc/sisu/model/relaxng/sisu_object_model_xhtml.rnc
@@ -0,0 +1,105 @@
+#%% sisu object model: input
+#  Name: SiSU information Structuring Universe - Structured information, Serialized Units
+#  Author: Ralph Amissah
+#    http://www.jus.uio.no/sisu
+#    http://www.jus.uio.no/sisu/SiSU/download.html
+
+#  Description: sisu object models in relaxNG xhtml model base
+#               used for preliminary modeling, not definitive
+
+#  Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Ralph Amissah
+
+#  License: GPL 2 or later
+
+# Summary of GPL 2
+
+# This program is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the Free
+# Software Foundation; either version 2 of the License, or (at your option)
+# any later version.
+
+# This program is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+# more details.
+
+# You should have received a copy of the GNU General Public License along
+# with this program; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+# If you have Internet connection, the latest version of the GPL should be
+# available at these locations:
+#   http://www.fsf.org/licenses/gpl.html
+#   http://www.gnu.org/copyleft/gpl.html
+#   http://www.jus.uio.no/sisu/gpl2.fsf
+
+# SiSU was first released to the public on January 4th 2005
+
+# SiSU uses:
+# 
+#   Standard SiSU markup syntax,
+#   Standard SiSU meta-markup syntax, and the
+#   Standard SiSU object citation numbering and system
+# 
+# © Ralph Amissah 1997, current 2006.
+# All Rights Reserved.
+
+#%% definitions
+#dublin core:
+element-dc =
+  ( attribute title { text }
+  #attribute subtitle { text }?
+  & attribute creator { text }?
+  & attribute subject { text }?
+  & attribute description { text }?
+  & attribute publisher { text }?
+  & attribute contributor { text }?
+  & attribute date { text }?
+  & attribute datecreated { text }?
+  & attribute dateissued { text }?
+  & attribute dateavailable { text }?
+  & attribute datevalid { text }?
+  & attribute datemodified { text }?
+  & attribute type { text }?
+  & attribute format { text }?
+  & attribute identifier { text }?
+  & attribute source { text }?
+  & attribute relation { text }?
+  & attribute coverage { text }?
+  & attribute rights { text }?
+  & attribute keywords { text }? ),
+#text includes <en> endnote pointer numbers, and <b> <i> <u> etc.
+#note includes <b> <i> <u> etc.
+#%% structure
+element document {
+  #document head:
+  element head {
+    attribute id { text },
+    element-dc,
+    attribute copyright { text }?
+    #element title {
+    #  attribute xml:lang { text },
+    #  text
+    #}
+  },
+  #document body:
+  element body {
+    #object, unit
+    element object {
+      #may or may not be a heading, if heading provide heading level [1-6]:
+      element heading { text }?,
+      #object citation number, unique sequential number for objects:
+      element ocn { text },
+      #body content/text, whether heading or ordinary paragraph:
+      element text { text },
+      #endnotes, zero or many:
+      element endnote {
+        #endnotes number:
+        element en_n { text },
+        #endnotes content/text:
+        element note { text }
+      }*
+    }+
+  }
+}
+
diff --git a/data/doc/sisu/model/xml/input/rnc/dom.rnc b/data/doc/sisu/model/xml/input/rnc/dom.rnc
new file mode 100644
index 00000000..7391eca4
--- /dev/null
+++ b/data/doc/sisu/model/xml/input/rnc/dom.rnc
@@ -0,0 +1,69 @@
+#% dom input model, part of SiSU and under the same license
+default namespace = ""
+start =
+  element document {
+    element head {
+      element header {
+        attribute class { xsd:NCName },
+        (element creator { text }
+         | element date { xsd:NMTOKEN }
+         | element date.available { xsd:NMTOKEN }
+         | element date.created { xsd:NMTOKEN }
+         | element date.issued { xsd:NMTOKEN }
+         | element date.modified { xsd:NMTOKEN }
+         | element date.valid { xsd:NMTOKEN }
+         | element italicize { text }
+         | element language { xsd:NCName }
+         | element links { text }
+         | element markup { text }
+         | element rights { text }
+         | element skin { xsd:NCName }
+         | element subject { text }
+         | element title { text }
+         | element type { xsd:NCName }
+         | element vocabulary { xsd:NCName })
+      }+
+    },
+    element body {
+      element heading1 {
+        heading,
+        element heading2 {
+          heading,
+          contents1+,
+          element heading3 { heading, contents1+ }+
+        }
+      }
+    }
+  }
+heading = element heading { object }
+contents1 =
+  element contents1 {
+    heading,
+    content,
+    element contents2 {
+      heading,
+      content,
+      element contents3 { heading, content }*
+    }*
+  }
+object =
+  element object {
+    element text {
+      (text
+       | italic
+       | element bold { xsd:NMTOKEN }
+       | element endnote {
+           element symbol { text }?,
+           element note {
+             (text
+              | italic
+              | element br { empty })+
+           }
+         }
+       | element underscore { italic }
+       | element image.path { text }
+       | element italic { text })+
+    }
+  }
+italic = element italic { text }
+content = element content { object+ }
diff --git a/data/doc/sisu/model/xml/input/rnc/node.rnc b/data/doc/sisu/model/xml/input/rnc/node.rnc
new file mode 100644
index 00000000..5116f629
--- /dev/null
+++ b/data/doc/sisu/model/xml/input/rnc/node.rnc
@@ -0,0 +1,67 @@
+#% node input model, part of SiSU and under the same license
+default namespace = ""
+start =
+  element document {
+    element head {
+      element header {
+        attribute class { xsd:NCName },
+        (element creator { text }
+         | element date { xsd:NMTOKEN }
+         | element date.available { xsd:NMTOKEN }
+         | element date.created { xsd:NMTOKEN }
+         | element date.issued { xsd:NMTOKEN }
+         | element date.modified { xsd:NMTOKEN }
+         | element date.valid { xsd:NMTOKEN }
+         | element italicize { (text | i)+ }
+         | element language { xsd:NCName }
+         | element links { text }
+         | element markup { text }
+         | element rights { text }
+         | element skin { xsd:NCName }
+         | element subject { text }
+         | element title { text }
+         | element type { xsd:NCName }
+         | element vocabulary { xsd:NCName })
+      }+
+    },
+    element body {
+      element object {
+        (element text {
+           attribute class { xsd:NCName },
+           (text
+            | b
+            | i
+            | element br { empty }
+            | element endnote {
+                attribute symbol { xsd:NCName },
+                (text | i)+
+              }
+            | element image.path { text }
+            | element sub { text })+
+         }
+         | (element ocn { empty },
+            element table {
+              attribute align { xsd:NCName },
+              attribute bgcolor { xsd:NCName },
+              attribute border { xsd:integer },
+              attribute cellpadding { xsd:integer },
+              attribute summary { text },
+              attribute width { text },
+              element tr {
+                element td {
+                  attribute valign { xsd:NCName },
+                  attribute width { text },
+                  (text | b)+
+                }+
+              }+
+            })),
+        element node {
+          element id { xsd:integer },
+          element parent { xsd:integer },
+          element offspring { text }?
+        }
+      }+
+    }
+  }
+b = element b { text }
+i = element i { text }
diff --git a/data/doc/sisu/model/xml/input/rnc/sax.rnc b/data/doc/sisu/model/xml/input/rnc/sax.rnc
new file mode 100644
index 00000000..891a18f8
--- /dev/null
+++ b/data/doc/sisu/model/xml/input/rnc/sax.rnc
@@ -0,0 +1,47 @@
+#% sax input model, part of SiSU and under the same license
+default namespace = ""
+start =
+  element document {
+    element head {
+      element header {
+        attribute class { xsd:NCName },
+        (element creator { text }
+         | element date { xsd:NMTOKEN }
+         | element date.available { xsd:NMTOKEN }
+         | element date.created { xsd:NMTOKEN }
+         | element date.issued { xsd:NMTOKEN }
+         | element date.modified { xsd:NMTOKEN }
+         | element date.valid { xsd:NMTOKEN }
+         | element italicize { text }
+         | element language { xsd:NCName }
+         | element links { text }
+         | element markup { text }
+         | element rights { text }
+         | element skin { xsd:NCName }
+         | element subject { text }
+         | element title { text }
+         | element type { xsd:NCName }
+         | element vocabulary { xsd:NCName })
+      }+
+    },
+    element body {
+      element object {
+        element text {
+          attribute class { xsd:NCName },
+          (text
+           | b
+           | i
+           | element endnote {
+               attribute symbol { xsd:NCName },
+               (text
+                | i
+                | element br { empty })+
+             }
+           | element u { i }
+           | element image.path { text })+
+        }?
+      }+
+    }
+  }
+i = element i { text }
+b = element b { text }
diff --git a/data/doc/sisu/model/xml/input/rng/dom.rng b/data/doc/sisu/model/xml/input/rng/dom.rng
new file mode 100644
index 00000000..746421c8
--- /dev/null
+++ b/data/doc/sisu/model/xml/input/rng/dom.rng
@@ -0,0 +1,166 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- dom rng input model, part of SiSU and under the same license -->
+<grammar ns="" xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
+  <start>
+    <element name="document">
+      <element name="head">
+        <oneOrMore>
+          <element name="header">
+            <attribute name="class">
+              <data type="NCName"/>
+            </attribute>
+            <choice>
+              <element name="creator">
+                <text/>
+              </element>
+              <element name="date">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.available">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.created">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.issued">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.modified">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.valid">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="italicize">
+                <text/>
+              </element>
+              <element name="language">
+                <data type="NCName"/>
+              </element>
+              <element name="links">
+                <text/>
+              </element>
+              <element name="markup">
+                <text/>
+              </element>
+              <element name="rights">
+                <text/>
+              </element>
+              <element name="skin">
+                <data type="NCName"/>
+              </element>
+              <element name="subject">
+                <text/>
+              </element>
+              <element name="title">
+                <text/>
+              </element>
+              <element name="type">
+                <data type="NCName"/>
+              </element>
+              <element name="vocabulary">
+                <data type="NCName"/>
+              </element>
+            </choice>
+          </element>
+        </oneOrMore>
+      </element>
+      <element name="body">
+        <element name="heading1">
+          <ref name="heading"/>
+          <element name="heading2">
+            <ref name="heading"/>
+            <oneOrMore>
+              <ref name="contents1"/>
+            </oneOrMore>
+            <oneOrMore>
+              <element name="heading3">
+                <ref name="heading"/>
+                <oneOrMore>
+                  <ref name="contents1"/>
+                </oneOrMore>
+              </element>
+            </oneOrMore>
+          </element>
+        </element>
+      </element>
+    </element>
+  </start>
+  <define name="heading">
+    <element name="heading">
+      <ref name="object"/>
+    </element>
+  </define>
+  <define name="contents1">
+    <element name="contents1">
+      <ref name="heading"/>
+      <ref name="content"/>
+      <zeroOrMore>
+        <element name="contents2">
+          <ref name="heading"/>
+          <ref name="content"/>
+          <zeroOrMore>
+            <element name="contents3">
+              <ref name="heading"/>
+              <ref name="content"/>
+            </element>
+          </zeroOrMore>
+        </element>
+      </zeroOrMore>
+    </element>
+  </define>
+  <define name="object">
+    <element name="object">
+      <element name="text">
+        <oneOrMore>
+          <choice>
+            <text/>
+            <ref name="italic"/>
+            <element name="bold">
+              <data type="NMTOKEN"/>
+            </element>
+            <element name="endnote">
+              <optional>
+                <element name="symbol">
+                  <text/>
+                </element>
+              </optional>
+              <element name="note">
+                <oneOrMore>
+                  <choice>
+                    <text/>
+                    <ref name="italic"/>
+                    <element name="br">
+                      <empty/>
+                    </element>
+                  </choice>
+                </oneOrMore>
+              </element>
+            </element>
+            <element name="underscore">
+              <ref name="italic"/>
+            </element>
+            <element name="image.path">
+              <text/>
+            </element>
+            <element name="italic">
+              <text/>
+            </element>
+          </choice>
+        </oneOrMore>
+      </element>
+    </element>
+  </define>
+  <define name="italic">
+    <element name="italic">
+      <text/>
+    </element>
+  </define>
+  <define name="content">
+    <element name="content">
+      <oneOrMore>
+        <ref name="object"/>
+      </oneOrMore>
+    </element>
+  </define>
+</grammar>
diff --git a/data/doc/sisu/model/xml/input/rng/node.rng b/data/doc/sisu/model/xml/input/rng/node.rng
new file mode 100644
index 00000000..8b60cce8
--- /dev/null
+++ b/data/doc/sisu/model/xml/input/rng/node.rng
@@ -0,0 +1,177 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- node rng input model, part of SiSU and under the same license -->
+<grammar ns="" xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
+  <start>
+    <element name="document">
+      <element name="head">
+        <oneOrMore>
+          <element name="header">
+            <attribute name="class">
+              <data type="NCName"/>
+            </attribute>
+            <choice>
+              <element name="creator">
+                <text/>
+              </element>
+              <element name="date">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.available">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.created">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.issued">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.modified">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.valid">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="italicize">
+                <oneOrMore>
+                  <choice>
+                    <text/>
+                    <ref name="i"/>
+                  </choice>
+                </oneOrMore>
+              </element>
+              <element name="language">
+                <data type="NCName"/>
+              </element>
+              <element name="links">
+                <text/>
+              </element>
+              <element name="markup">
+                <text/>
+              </element>
+              <element name="rights">
+                <text/>
+              </element>
+              <element name="skin">
+                <data type="NCName"/>
+              </element>
+              <element name="subject">
+                <text/>
+              </element>
+              <element name="title">
+                <text/>
+              </element>
+              <element name="type">
+                <data type="NCName"/>
+              </element>
+              <element name="vocabulary">
+                <data type="NCName"/>
+              </element>
+            </choice>
+          </element>
+        </oneOrMore>
+      </element>
+      <element name="body">
+        <oneOrMore>
+          <element name="object">
+            <choice>
+              <element name="text">
+                <attribute name="class">
+                  <data type="NCName"/>
+                </attribute>
+                <oneOrMore>
+                  <choice>
+                    <text/>
+                    <ref name="b"/>
+                    <ref name="i"/>
+                    <element name="br">
+                      <empty/>
+                    </element>
+                    <element name="endnote">
+                      <attribute name="symbol">
+                        <data type="NCName"/>
+                      </attribute>
+                      <oneOrMore>
+                        <choice>
+                          <text/>
+                          <ref name="i"/>
+                        </choice>
+                      </oneOrMore>
+                    </element>
+                    <element name="image.path">
+                      <text/>
+                    </element>
+                    <element name="sub">
+                      <text/>
+                    </element>
+                  </choice>
+                </oneOrMore>
+              </element>
+              <group>
+                <element name="ocn">
+                  <empty/>
+                </element>
+                <element name="table">
+                  <attribute name="align">
+                    <data type="NCName"/>
+                  </attribute>
+                  <attribute name="bgcolor">
+                    <data type="NCName"/>
+                  </attribute>
+                  <attribute name="border">
+                    <data type="integer"/>
+                  </attribute>
+                  <attribute name="cellpadding">
+                    <data type="integer"/>
+                  </attribute>
+                  <attribute name="summary"/>
+                  <attribute name="width"/>
+                  <oneOrMore>
+                    <element name="tr">
+                      <oneOrMore>
+                        <element name="td">
+                          <attribute name="valign">
+                            <data type="NCName"/>
+                          </attribute>
+                          <attribute name="width"/>
+                          <oneOrMore>
+                            <choice>
+                              <text/>
+                              <ref name="b"/>
+                            </choice>
+                          </oneOrMore>
+                        </element>
+                      </oneOrMore>
+                    </element>
+                  </oneOrMore>
+                </element>
+              </group>
+            </choice>
+            <element name="node">
+              <element name="id">
+                <data type="integer"/>
+              </element>
+              <element name="parent">
+                <data type="integer"/>
+              </element>
+              <optional>
+                <element name="offspring">
+                  <text/>
+                </element>
+              </optional>
+            </element>
+          </element>
+        </oneOrMore>
+      </element>
+    </element>
+  </start>
+  <define name="b">
+    <element name="b">
+      <text/>
+    </element>
+  </define>
+  <define name="i">
+    <element name="i">
+      <text/>
+    </element>
+  </define>
+</grammar>
diff --git a/data/doc/sisu/model/xml/input/rng/sax.rng b/data/doc/sisu/model/xml/input/rng/sax.rng
new file mode 100644
index 00000000..14412938
--- /dev/null
+++ b/data/doc/sisu/model/xml/input/rng/sax.rng
@@ -0,0 +1,120 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- sax rng input model, part of SiSU and under the same license -->
+<grammar ns="" xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
+  <start>
+    <element name="document">
+      <element name="head">
+        <oneOrMore>
+          <element name="header">
+            <attribute name="class">
+              <data type="NCName"/>
+            </attribute>
+            <choice>
+              <element name="creator">
+                <text/>
+              </element>
+              <element name="date">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.available">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.created">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.issued">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.modified">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date.valid">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="italicize">
+                <text/>
+              </element>
+              <element name="language">
+                <data type="NCName"/>
+              </element>
+              <element name="links">
+                <text/>
+              </element>
+              <element name="markup">
+                <text/>
+              </element>
+              <element name="rights">
+                <text/>
+              </element>
+              <element name="skin">
+                <data type="NCName"/>
+              </element>
+              <element name="subject">
+                <text/>
+              </element>
+              <element name="title">
+                <text/>
+              </element>
+              <element name="type">
+                <data type="NCName"/>
+              </element>
+              <element name="vocabulary">
+                <data type="NCName"/>
+              </element>
+            </choice>
+          </element>
+        </oneOrMore>
+      </element>
+      <element name="body">
+        <oneOrMore>
+          <element name="object">
+            <optional>
+              <element name="text">
+                <attribute name="class">
+                  <data type="NCName"/>
+                </attribute>
+                <oneOrMore>
+                  <choice>
+                    <text/>
+                    <ref name="b"/>
+                    <ref name="i"/>
+                    <element name="endnote">
+                      <attribute name="symbol">
+                        <data type="NCName"/>
+                      </attribute>
+                      <oneOrMore>
+                        <choice>
+                          <text/>
+                          <ref name="i"/>
+                          <element name="br">
+                            <empty/>
+                          </element>
+                        </choice>
+                      </oneOrMore>
+                    </element>
+                    <element name="u">
+                      <ref name="i"/>
+                    </element>
+                    <element name="image.path">
+                      <text/>
+                    </element>
+                  </choice>
+                </oneOrMore>
+              </element>
+            </optional>
+          </element>
+        </oneOrMore>
+      </element>
+    </element>
+  </start>
+  <define name="i">
+    <element name="i">
+      <text/>
+    </element>
+  </define>
+  <define name="b">
+    <element name="b">
+      <text/>
+    </element>
+  </define>
+</grammar>
diff --git a/data/doc/sisu/model/xml/input/xsd/dom.xsd b/data/doc/sisu/model/xml/input/xsd/dom.xsd
new file mode 100644
index 00000000..8de8999a
--- /dev/null
+++ b/data/doc/sisu/model/xml/input/xsd/dom.xsd
@@ -0,0 +1,181 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- dom input model, part of SiSU and under the same license -->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
+  <xs:element name="document">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="head"/>
+        <xs:element ref="body"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="head">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="header"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="header">
+    <xs:complexType>
+      <xs:choice>
+        <xs:element ref="creator"/>
+        <xs:element ref="date"/>
+        <xs:element ref="date.available"/>
+        <xs:element ref="date.created"/>
+        <xs:element ref="date.issued"/>
+        <xs:element ref="date.modified"/>
+        <xs:element ref="date.valid"/>
+        <xs:element ref="italicize"/>
+        <xs:element ref="language"/>
+        <xs:element ref="links"/>
+        <xs:element ref="markup"/>
+        <xs:element ref="rights"/>
+        <xs:element ref="skin"/>
+        <xs:element ref="subject"/>
+        <xs:element ref="title"/>
+        <xs:element ref="type"/>
+        <xs:element ref="vocabulary"/>
+      </xs:choice>
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="creator" type="xs:string"/>
+  <xs:element name="date" type="xs:NMTOKEN"/>
+  <xs:element name="date.available" type="xs:NMTOKEN"/>
+  <xs:element name="date.created" type="xs:NMTOKEN"/>
+  <xs:element name="date.issued" type="xs:NMTOKEN"/>
+  <xs:element name="date.modified" type="xs:NMTOKEN"/>
+  <xs:element name="date.valid" type="xs:NMTOKEN"/>
+  <xs:element name="italicize" type="xs:string"/>
+  <xs:element name="language" type="xs:NCName"/>
+  <xs:element name="links" type="xs:string"/>
+  <xs:element name="markup" type="xs:string"/>
+  <xs:element name="rights" type="xs:string"/>
+  <xs:element name="skin" type="xs:NCName"/>
+  <xs:element name="subject" type="xs:string"/>
+  <xs:element name="title" type="xs:string"/>
+  <xs:element name="type" type="xs:NCName"/>
+  <xs:element name="vocabulary" type="xs:NCName"/>
+  <xs:element name="body">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading1"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="heading1">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element ref="heading2"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="heading2">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element maxOccurs="unbounded" ref="contents1"/>
+        <xs:element maxOccurs="unbounded" ref="heading3"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="heading3">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element maxOccurs="unbounded" ref="contents1"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="heading">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="object"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="contents1">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element ref="content"/>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="contents2"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="contents2">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element ref="content"/>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="contents3"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="contents3">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element ref="content"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="object">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="text"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="text">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="italic"/>
+        <xs:element ref="bold"/>
+        <xs:element ref="endnote"/>
+        <xs:element ref="underscore"/>
+        <xs:element ref="image.path"/>
+        <xs:element ref="italic"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="bold" type="xs:NMTOKEN"/>
+  <xs:element name="endnote">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element minOccurs="0" ref="symbol"/>
+        <xs:element ref="note"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="symbol" type="xs:string"/>
+  <xs:element name="note">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="italic"/>
+        <xs:element ref="br"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="br">
+    <xs:complexType/>
+  </xs:element>
+  <xs:element name="underscore">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="italic"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="image.path" type="xs:string"/>
+  <xs:element name="italic" type="xs:string"/>
+  <xs:element name="content">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="object"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+</xs:schema>
diff --git a/data/doc/sisu/model/xml/input/xsd/node.xsd b/data/doc/sisu/model/xml/input/xsd/node.xsd
new file mode 100644
index 00000000..f0fc9614
--- /dev/null
+++ b/data/doc/sisu/model/xml/input/xsd/node.xsd
@@ -0,0 +1,159 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- node input model, part of SiSU and under the same license -->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
+  <xs:element name="document">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="head"/>
+        <xs:element ref="body"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="head">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="header"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="header">
+    <xs:complexType>
+      <xs:choice>
+        <xs:element ref="creator"/>
+        <xs:element ref="date"/>
+        <xs:element ref="date.available"/>
+        <xs:element ref="date.created"/>
+        <xs:element ref="date.issued"/>
+        <xs:element ref="date.modified"/>
+        <xs:element ref="date.valid"/>
+        <xs:element ref="italicize"/>
+        <xs:element ref="language"/>
+        <xs:element ref="links"/>
+        <xs:element ref="markup"/>
+        <xs:element ref="rights"/>
+        <xs:element ref="skin"/>
+        <xs:element ref="subject"/>
+        <xs:element ref="title"/>
+        <xs:element ref="type"/>
+        <xs:element ref="vocabulary"/>
+      </xs:choice>
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="creator" type="xs:string"/>
+  <xs:element name="date" type="xs:NMTOKEN"/>
+  <xs:element name="date.available" type="xs:NMTOKEN"/>
+  <xs:element name="date.created" type="xs:NMTOKEN"/>
+  <xs:element name="date.issued" type="xs:NMTOKEN"/>
+  <xs:element name="date.modified" type="xs:NMTOKEN"/>
+  <xs:element name="date.valid" type="xs:NMTOKEN"/>
+  <xs:element name="italicize">
+    <xs:complexType mixed="true">
+      <xs:sequence>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="i"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="language" type="xs:NCName"/>
+  <xs:element name="links" type="xs:string"/>
+  <xs:element name="markup" type="xs:string"/>
+  <xs:element name="rights" type="xs:string"/>
+  <xs:element name="skin" type="xs:NCName"/>
+  <xs:element name="subject" type="xs:string"/>
+  <xs:element name="title" type="xs:string"/>
+  <xs:element name="type" type="xs:NCName"/>
+  <xs:element name="vocabulary" type="xs:NCName"/>
+  <xs:element name="body">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="object"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="object">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:choice>
+          <xs:element ref="text"/>
+          <xs:sequence>
+            <xs:element ref="ocn"/>
+            <xs:element ref="table"/>
+          </xs:sequence>
+        </xs:choice>
+        <xs:element ref="node"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="text">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="b"/>
+        <xs:element ref="i"/>
+        <xs:element ref="br"/>
+        <xs:element ref="endnote"/>
+        <xs:element ref="image.path"/>
+        <xs:element ref="sub"/>
+      </xs:choice>
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="br">
+    <xs:complexType/>
+  </xs:element>
+  <xs:element name="endnote">
+    <xs:complexType mixed="true">
+      <xs:sequence>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="i"/>
+      </xs:sequence>
+      <xs:attribute name="symbol" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="image.path" type="xs:string"/>
+  <xs:element name="sub" type="xs:string"/>
+  <xs:element name="ocn">
+    <xs:complexType/>
+  </xs:element>
+  <xs:element name="table">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="tr"/>
+      </xs:sequence>
+      <xs:attribute name="align" use="required" type="xs:NCName"/>
+      <xs:attribute name="bgcolor" use="required" type="xs:NCName"/>
+      <xs:attribute name="border" use="required" type="xs:integer"/>
+      <xs:attribute name="cellpadding" use="required" type="xs:integer"/>
+      <xs:attribute name="summary" use="required"/>
+      <xs:attribute name="width" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="tr">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="td"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="td">
+    <xs:complexType mixed="true">
+      <xs:sequence>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="b"/>
+      </xs:sequence>
+      <xs:attribute name="valign" use="required" type="xs:NCName"/>
+      <xs:attribute name="width" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="node">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="id"/>
+        <xs:element ref="parent"/>
+        <xs:element minOccurs="0" ref="offspring"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="id" type="xs:integer"/>
+  <xs:element name="parent" type="xs:integer"/>
+  <xs:element name="offspring" type="xs:string"/>
+  <xs:element name="b" type="xs:string"/>
+  <xs:element name="i" type="xs:string"/>
+</xs:schema>
diff --git a/data/doc/sisu/model/xml/input/xsd/sax.xsd b/data/doc/sisu/model/xml/input/xsd/sax.xsd
new file mode 100644
index 00000000..450bfce5
--- /dev/null
+++ b/data/doc/sisu/model/xml/input/xsd/sax.xsd
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- sax input model, part of SiSU and under the same license -->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
+  <xs:element name="document">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="head"/>
+        <xs:element ref="body"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="head">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="header"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="header">
+    <xs:complexType>
+      <xs:choice>
+        <xs:element ref="creator"/>
+        <xs:element ref="date"/>
+        <xs:element ref="date.available"/>
+        <xs:element ref="date.created"/>
+        <xs:element ref="date.issued"/>
+        <xs:element ref="date.modified"/>
+        <xs:element ref="date.valid"/>
+        <xs:element ref="italicize"/>
+        <xs:element ref="language"/>
+        <xs:element ref="links"/>
+        <xs:element ref="markup"/>
+        <xs:element ref="rights"/>
+        <xs:element ref="skin"/>
+        <xs:element ref="subject"/>
+        <xs:element ref="title"/>
+        <xs:element ref="type"/>
+        <xs:element ref="vocabulary"/>
+      </xs:choice>
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="creator" type="xs:string"/>
+  <xs:element name="date" type="xs:NMTOKEN"/>
+  <xs:element name="date.available" type="xs:NMTOKEN"/>
+  <xs:element name="date.created" type="xs:NMTOKEN"/>
+  <xs:element name="date.issued" type="xs:NMTOKEN"/>
+  <xs:element name="date.modified" type="xs:NMTOKEN"/>
+  <xs:element name="date.valid" type="xs:NMTOKEN"/>
+  <xs:element name="italicize" type="xs:string"/>
+  <xs:element name="language" type="xs:NCName"/>
+  <xs:element name="links" type="xs:string"/>
+  <xs:element name="markup" type="xs:string"/>
+  <xs:element name="rights" type="xs:string"/>
+  <xs:element name="skin" type="xs:NCName"/>
+  <xs:element name="subject" type="xs:string"/>
+  <xs:element name="title" type="xs:string"/>
+  <xs:element name="type" type="xs:NCName"/>
+  <xs:element name="vocabulary" type="xs:NCName"/>
+  <xs:element name="body">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="object"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="object">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element minOccurs="0" ref="text"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="text">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="b"/>
+        <xs:element ref="i"/>
+        <xs:element ref="endnote"/>
+        <xs:element ref="u"/>
+        <xs:element ref="image.path"/>
+      </xs:choice>
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="endnote">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="i"/>
+        <xs:element ref="br"/>
+      </xs:choice>
+      <xs:attribute name="symbol" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="br">
+    <xs:complexType/>
+  </xs:element>
+  <xs:element name="u">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="i"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="image.path" type="xs:string"/>
+  <xs:element name="i" type="xs:string"/>
+  <xs:element name="b" type="xs:string"/>
+</xs:schema>
diff --git a/data/doc/sisu/model/xml/output/rnc/dom.rnc b/data/doc/sisu/model/xml/output/rnc/dom.rnc
new file mode 100644
index 00000000..e8a3ed42
--- /dev/null
+++ b/data/doc/sisu/model/xml/output/rnc/dom.rnc
@@ -0,0 +1,144 @@
+#% dom output model, part of SiSU and under the same license
+default namespace = ""
+namespace xlink = "http://www.w3.org/1999/xlink"
+start =
+  element document {
+    element head {
+      element header {
+        meta,
+        (element creator { text }
+         | element date { xsd:NMTOKEN }
+         | element date_available { xsd:NMTOKEN }
+         | element date_created { xsd:NMTOKEN }
+         | element date_issued { xsd:NMTOKEN }
+         | element date_modified { xsd:NMTOKEN }
+         | element date_valid { xsd:NMTOKEN }
+         | element keywords { text }
+         | element language { xsd:NCName }
+         | element rights { (text | link)+ }
+         | element source { text }
+         | element structure { text }
+         | element subject { text }
+         | element title { text }
+         | element type { text }
+         | element source_control {
+             (br
+              | meta
+              | element sc {
+                  attribute class { xsd:NCName },
+                  text
+                })+
+           })
+      }+
+    },
+    element body {
+      element heading1 {
+        heading,
+        contents1*,
+        element heading2 {
+          heading,
+          contents1*,
+          element heading3 {
+            heading,
+            element contents1 {
+              heading,
+              content,
+              element contents2 {
+                heading,
+                content,
+                element contents3 { heading, content }*
+              }*
+            }+
+          }*
+        }*
+      }+
+    }
+  }
+meta = element meta { text }
+br = element br { empty }
+heading = element heading { object }
+contents1 =
+  element contents1 {
+    heading,
+    content,
+    element contents2 {
+      heading,
+      content,
+      element contents3 { heading, content }*
+    }*
+  }
+content = element content { object* }
+object =
+  element object {
+    attribute id { xsd:integer },
+    element ocn { text },
+    element nametag { text }?,
+    (element table {
+       attribute align { xsd:NCName },
+       attribute bgcolor { xsd:NCName },
+       attribute border { xsd:integer },
+       attribute cellpadding { xsd:integer },
+       attribute summary { text },
+       attribute width { text },
+       element tr {
+         element td {
+           attribute valign { xsd:NCName },
+           attribute width { text },
+           (text | b | i)+
+         }+
+       }+
+     }
+     | element text {
+         attribute class { xsd:NCName }?,
+         (text
+          | b
+          | del
+          | endnote
+          | i
+          | link
+          | element br { empty }
+          | element endnote {
+              element number { xsd:integer },
+              element note { (text | i | link)+ }
+            }
+          | element image {
+              attribute height { xsd:integer },
+              attribute width { xsd:integer },
+              attribute xlink:actuate { xsd:NCName },
+              attribute xlink:href { text },
+              attribute xlink:show { xsd:NCName },
+              attribute xlink:type { xsd:NCName }
+            }
+          | element sub { text })+
+       })
+  }
+i = element i { text }
+b = element i { text }
+u = element u { (text | b | i)+ }
+sub = element sub { xsd:NCName }
+sup = element sup { xsd:NCName }
+del = element del { (text | b | i | link)+ }
+link =
+  element link {
+    attribute xlink:href { xsd:anyURI },
+    attribute xlink:type { xsd:NCName },
+    xsd:anyURI
+  }
+endnote =
+  element endnote {
+    (element number { xsd:integer }
+     | element symbol { text }),
+    element note {
+      (text
+       | b
+       | br
+       | del
+       | i
+       | link
+       | sub
+       | sup
+       | u
+       | element em { xsd:NCName }
+       | element sub { xsd:NCName })+
+    }
+  }
diff --git a/data/doc/sisu/model/xml/output/rnc/sax.rnc b/data/doc/sisu/model/xml/output/rnc/sax.rnc
new file mode 100644
index 00000000..b242afb3
--- /dev/null
+++ b/data/doc/sisu/model/xml/output/rnc/sax.rnc
@@ -0,0 +1,164 @@
+# % sax output model, part of SiSU and distributed under the same license
+
+default namespace = ""
+namespace xlink = "http://www.w3.org/1999/xlink"
+
+start =
+  element document {
+    element head {
+      (br
+       | meta
+       | element creator {
+           attribute class { xsd:NCName },
+           (text
+            | element link {
+                attribute xlink:href { xsd:anyURI },
+                attribute xlink:type { xsd:NCName },
+                xsd:anyURI
+              })+
+         }
+       | element date {
+           attribute class { xsd:NCName },
+           xsd:NMTOKEN
+         }
+       | element date_available {
+           attribute class { xsd:NCName },
+           xsd:NMTOKEN
+         }
+       | element date_created {
+           attribute class { xsd:NCName },
+           xsd:NMTOKEN
+         }
+       | element date_issued {
+           attribute class { xsd:NCName },
+           xsd:NMTOKEN
+         }
+       | element date_modified {
+           attribute class { xsd:NCName },
+           xsd:NMTOKEN
+         }
+       | element date_valid {
+           attribute class { xsd:NCName },
+           xsd:NMTOKEN
+         }
+       | element keywords {
+           attribute class { xsd:NCName },
+           text
+         }
+       | element language {
+           attribute class { xsd:NCName },
+           xsd:NCName
+         }
+       | element meta { xsd:NMTOKEN }
+       | element rights {
+           attribute class { xsd:NCName },
+           (text | link)+
+         }
+       | element source {
+           attribute class { xsd:NCName },
+           text
+         }
+       | element structure {
+           attribute class { xsd:NCName },
+           text
+         }
+       | element subject {
+           attribute class { xsd:NCName },
+           text
+         }
+       | element title {
+           attribute class { xsd:NCName },
+           text
+         }
+       | element type {
+           attribute class { xsd:NCName },
+           text
+         }
+       | element source_control {
+           (br
+            | meta
+            | element sc {
+                attribute class { xsd:NCName },
+                text
+              })+
+         })+
+    },
+    element body {
+      element object {
+        attribute id { text },
+        element ocn {
+          text
+        },
+        element text {
+          attribute class { xsd:NCName },
+          (text
+           | b
+           | br
+           | del
+           | en
+           | i
+           | link
+           | sub
+           | sup
+           | u
+           | element image {
+               attribute alt { text }?,
+               attribute height { xsd:integer }?,
+               attribute width { xsd:integer }?,
+               attribute xlink:actuate { xsd:NCName },
+               attribute xlink:href { text },
+               attribute xlink:show { xsd:NCName },
+               attribute xlink:type { xsd:NCName }
+             })+
+        }?,
+        element table {
+          attribute align { xsd:NCName },
+          attribute bgcolor { xsd:NCName },
+          attribute border { xsd:integer },
+          attribute cellpadding { xsd:integer },
+          attribute summary { text },
+          attribute width { text },
+          element tr {
+            element td {
+              attribute valign { xsd:NCName },
+              attribute width { text },
+              (text | b | i)+
+            }+
+          }+
+        }?,
+        element endnote {
+          attribute notenumber { xsd:integer }?,
+          attribute symbol { text }?,
+          (element number { xsd:integer }
+           | element symbol { text }),
+          element note {
+            (text
+             | b
+             | br
+             | del
+             | i
+             | link
+             | sup
+             | u
+             | element em { xsd:NCName }
+             | element sub { xsd:NCName })+
+          }
+        }*
+      }+
+    }
+  }
+meta = element meta { text }
+br = element br { empty }
+b = element b { (text | en | i | link | sup)+ }
+i = element i { (text | b | br | sup)+ }
+en = element en { text }
+sub = element sub { xsd:NCName }
+sup = element sup { xsd:NCName }
+link =
+  element link {
+    attribute xlink:href { xsd:anyURI },
+    attribute xlink:type { xsd:NCName },
+    (xsd:anyURI | text | b | i | sup)+
+  }
+u = element u { (text | b | i)+ }
+del = element del { (text | b | i | link)+ }
diff --git a/data/doc/sisu/model/xml/output/rng/dom.rng b/data/doc/sisu/model/xml/output/rng/dom.rng
new file mode 100644
index 00000000..eea891ec
--- /dev/null
+++ b/data/doc/sisu/model/xml/output/rng/dom.rng
@@ -0,0 +1,438 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- dom output model, part of SiSU and under the same license -->
+<grammar xmlns:xlink="http://www.w3.org/1999/xlink" ns="" xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
+  <start>
+    <element name="document">
+      <element name="head">
+        <oneOrMore>
+          <element name="header">
+            <ref name="meta"/>
+            <choice>
+              <element name="creator">
+                <text/>
+              </element>
+              <element name="date">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date_available">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date_created">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date_issued">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date_modified">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="date_valid">
+                <data type="NMTOKEN"/>
+              </element>
+              <element name="keywords">
+                <text/>
+              </element>
+              <element name="language">
+                <data type="NCName"/>
+              </element>
+              <element name="rights">
+                <oneOrMore>
+                  <choice>
+                    <text/>
+                    <ref name="link"/>
+                  </choice>
+                </oneOrMore>
+              </element>
+              <element name="source">
+                <text/>
+              </element>
+              <element name="structure">
+                <text/>
+              </element>
+              <element name="subject">
+                <text/>
+              </element>
+              <element name="title">
+                <text/>
+              </element>
+              <element name="type">
+                <text/>
+              </element>
+              <element name="source_control">
+                <oneOrMore>
+                  <choice>
+                    <ref name="br"/>
+                    <ref name="meta"/>
+                    <element name="sc">
+                      <attribute name="class">
+                        <data type="NCName"/>
+                      </attribute>
+                      <text/>
+                    </element>
+                  </choice>
+                </oneOrMore>
+              </element>
+            </choice>
+          </element>
+        </oneOrMore>
+      </element>
+      <element name="body">
+        <oneOrMore>
+          <element name="heading1">
+            <ref name="heading"/>
+            <zeroOrMore>
+              <ref name="contents1"/>
+            </zeroOrMore>
+            <zeroOrMore>
+              <element name="heading2">
+                <ref name="heading"/>
+                <zeroOrMore>
+                  <ref name="contents1"/>
+                </zeroOrMore>
+                <zeroOrMore>
+                  <element name="heading3">
+                    <ref name="heading"/>
+                    <oneOrMore>
+                      <element name="contents1">
+                        <ref name="heading"/>
+                        <ref name="content"/>
+                        <zeroOrMore>
+                          <element name="contents2">
+                            <ref name="heading"/>
+                            <ref name="content"/>
+                            <zeroOrMore>
+                              <element name="contents3">
+                                <ref name="heading"/>
+                                <ref name="content"/>
+                              </element>
+                            </zeroOrMore>
+                          </element>
+                        </zeroOrMore>
+                      </element>
+                    </oneOrMore>
+                  </element>
+                </zeroOrMore>
+              </element>
+            </zeroOrMore>
+          </element>
+        </oneOrMore>
+      </element>
+    </element>
+  </start>
+  <define name="meta">
+    <element name="meta">
+      <text/>
+    </element>
+  </define>
+  <define name="br">
+    <element name="br">
+      <empty/>
+    </element>
+  </define>
+  <define name="heading">
+    <element name="heading">
+      <ref name="object"/>
+    </element>
+  </define>
+  <define name="contents1">
+    <element name="contents1">
+      <ref name="heading"/>
+      <ref name="content"/>
+      <zeroOrMore>
+        <element name="contents2">
+          <ref name="heading"/>
+          <ref name="content"/>
+          <zeroOrMore>
+            <element name="contents3">
+              <ref name="heading"/>
+              <ref name="content"/>
+            </element>
+          </zeroOrMore>
+        </element>
+      </zeroOrMore>
+    </element>
+  </define>
+  <define name="content">
+    <element name="content">
+      <zeroOrMore>
+        <ref name="object"/>
+      </zeroOrMore>
+    </element>
+  </define>
+<!--
+  <define name="contents1">
+    <element name="contents1">
+      <ref name="heading"/>
+      <element name="content">
+        <oneOrMore>
+          <ref name="object"/>
+        </oneOrMore>
+      </element>
+    </element>
+  </define>
+-->
+  <define name="object">
+    <element name="object">
+      <attribute name="id">
+        <data type="integer"/>
+      </attribute>
+      <element name="ocn">
+        <text/>
+      </element>
+      <optional>
+        <element name="nametag">
+          <text/>
+        </element>
+      </optional>
+      <choice>
+        <element name="table">
+          <attribute name="align">
+            <data type="NCName"/>
+          </attribute>
+          <attribute name="bgcolor">
+            <data type="NCName"/>
+          </attribute>
+          <attribute name="border">
+            <data type="integer"/>
+          </attribute>
+          <attribute name="cellpadding">
+            <data type="integer"/>
+          </attribute>
+          <attribute name="summary"/>
+          <attribute name="width"/>
+          <oneOrMore>
+            <element name="tr">
+              <oneOrMore>
+                <element name="td">
+                  <attribute name="valign">
+                    <data type="NCName"/>
+                  </attribute>
+                  <attribute name="width"/>
+                  <oneOrMore>
+                    <choice>
+                      <text/>
+                      <ref name="b"/>
+                      <ref name="i"/>
+                    </choice>
+                  </oneOrMore>
+                </element>
+              </oneOrMore>
+            </element>
+          </oneOrMore>
+        </element>
+        <element name="text">
+          <optional>
+            <attribute name="class">
+              <data type="NCName"/>
+            </attribute>
+          </optional>
+          <oneOrMore>
+            <choice>
+              <text/>
+              <ref name="b"/>
+              <ref name="del"/>
+              <ref name="endnote"/>
+              <ref name="i"/>
+              <ref name="link"/>
+              <element name="br">
+                <empty/>
+              </element>
+              <element name="endnote">
+                <element name="number">
+                  <data type="integer"/>
+                </element>
+                <element name="note">
+                  <oneOrMore>
+                    <choice>
+                      <text/>
+                      <ref name="i"/>
+                      <ref name="link"/>
+                    </choice>
+                  </oneOrMore>
+                </element>
+              </element>
+              <element name="image">
+                <attribute name="height">
+                  <data type="integer"/>
+                </attribute>
+                <attribute name="width">
+                  <data type="integer"/>
+                </attribute>
+                <attribute name="xlink:actuate">
+                  <data type="NCName"/>
+                </attribute>
+                <attribute name="xlink:href"/>
+                <attribute name="xlink:show">
+                  <data type="NCName"/>
+                </attribute>
+                <attribute name="xlink:type">
+                  <data type="NCName"/>
+                </attribute>
+              </element>
+              <element name="sub">
+                <text/>
+              </element>
+            </choice>
+          </oneOrMore>
+        </element>
+      </choice>
+<!--
+        <element name="text">
+          <optional>
+            <attribute name="class">
+              <data type="NCName"/>
+            </attribute>
+          </optional>
+          <oneOrMore>
+            <choice>
+              <text/>
+              <ref name="i"/>
+              <element name="b">
+                <oneOrMore>
+                  <choice>
+                    <text/>
+                    <ref name="i"/>
+                  </choice>
+                </oneOrMore>
+              </element>
+              <element name="endnote">
+                <choice>
+                  <element name="number">
+                    <data type="integer"/>
+                  </element>
+                  <element name="symbol">
+                    <text/>
+                  </element>
+                </choice>
+                <element name="note">
+                  <oneOrMore>
+                    <choice>
+                      <text/>
+                      <ref name="i"/>
+                      <element name="br">
+                        <empty/>
+                      </element>
+                      <element name="link">
+                        <attribute name="xlink:href">
+                          <data type="anyURI"/>
+                        </attribute>
+                        <attribute name="xlink:type">
+                          <data type="NCName"/>
+                        </attribute>
+                        <data type="anyURI"/>
+                      </element>
+                    </choice>
+                  </oneOrMore>
+                </element>
+              </element>
+              <element name="u">
+                <ref name="i"/>
+              </element>
+            </choice>
+          </oneOrMore>
+        </element>
+-->
+    </element>
+  </define>
+<!--
+  <define name="content">
+    <element name="content">
+      <zeroOrMore>
+        <ref name="object"/>
+      </zeroOrMore>
+    </element>
+  </define>
+  <define name="b">
+    <element name="b">
+      <text/>
+    </element>
+  </define>
+-->
+  <define name="i">
+    <element name="i">
+      <text/>
+    </element>
+  </define>
+  <define name="b">
+    <element name="i">
+      <text/>
+    </element>
+  </define>
+  <define name="u">
+    <element name="u">
+      <oneOrMore>
+        <choice>
+          <text/>
+          <ref name="b"/>
+          <ref name="i"/>
+        </choice>
+      </oneOrMore>
+    </element>
+  </define>
+  <define name="sub">
+    <element name="sub">
+      <data type="NCName"/>
+    </element>
+  </define>
+  <define name="sup">
+    <element name="sup">
+      <data type="NCName"/>
+    </element>
+  </define>
+  <define name="del">
+    <element name="del">
+      <oneOrMore>
+        <choice>
+          <text/>
+          <ref name="b"/>
+          <ref name="i"/>
+          <ref name="link"/>
+        </choice>
+      </oneOrMore>
+    </element>
+  </define>
+  <define name="link">
+    <element name="link">
+      <attribute name="xlink:href">
+        <data type="anyURI"/>
+      </attribute>
+      <attribute name="xlink:type">
+        <data type="NCName"/>
+      </attribute>
+      <data type="anyURI"/>
+    </element>
+  </define>
+  <define name="endnote">
+    <element name="endnote">
+      <choice>
+        <element name="number">
+          <data type="integer"/>
+        </element>
+        <element name="symbol">
+          <text/>
+        </element>
+      </choice>
+      <element name="note">
+        <oneOrMore>
+          <choice>
+            <text/>
+            <ref name="b"/>
+            <ref name="br"/>
+            <ref name="del"/>
+            <ref name="i"/>
+            <ref name="link"/>
+            <ref name="sub"/>
+            <ref name="sup"/>
+            <ref name="u"/>
+            <element name="em">
+              <data type="NCName"/>
+            </element>
+            <element name="sub">
+              <data type="NCName"/>
+            </element>
+          </choice>
+        </oneOrMore>
+      </element>
+    </element>
+  </define>
+</grammar>
diff --git a/data/doc/sisu/model/xml/output/rng/sax.rng b/data/doc/sisu/model/xml/output/rng/sax.rng
new file mode 100644
index 00000000..a2df4fed
--- /dev/null
+++ b/data/doc/sisu/model/xml/output/rng/sax.rng
@@ -0,0 +1,374 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- % sax output model, part of SiSU and distributed under the same license -->
+<grammar xmlns:xlink="http://www.w3.org/1999/xlink" ns="" xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
+  <start>
+    <element name="document">
+      <element name="head">
+        <oneOrMore>
+          <choice>
+            <ref name="br"/>
+            <ref name="meta"/>
+            <element name="creator">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <oneOrMore>
+                <choice>
+                  <text/>
+                  <element name="link">
+                    <attribute name="xlink:href">
+                      <data type="anyURI"/>
+                    </attribute>
+                    <attribute name="xlink:type">
+                      <data type="NCName"/>
+                    </attribute>
+                    <data type="anyURI"/>
+                  </element>
+                </choice>
+              </oneOrMore>
+            </element>
+            <element name="date">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <data type="NMTOKEN"/>
+            </element>
+            <element name="date_available">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <data type="NMTOKEN"/>
+            </element>
+            <element name="date_created">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <data type="NMTOKEN"/>
+            </element>
+            <element name="date_issued">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <data type="NMTOKEN"/>
+            </element>
+            <element name="date_modified">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <data type="NMTOKEN"/>
+            </element>
+            <element name="date_valid">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <data type="NMTOKEN"/>
+            </element>
+            <element name="keywords">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <text/>
+            </element>
+            <element name="language">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <data type="NCName"/>
+            </element>
+            <element name="meta">
+              <data type="NMTOKEN"/>
+            </element>
+            <element name="rights">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <oneOrMore>
+                <choice>
+                  <text/>
+                  <ref name="link"/>
+                </choice>
+              </oneOrMore>
+            </element>
+            <element name="source">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <text/>
+            </element>
+            <element name="structure">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <text/>
+            </element>
+            <element name="subject">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <text/>
+            </element>
+            <element name="title">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <text/>
+            </element>
+            <element name="type">
+              <attribute name="class">
+                <data type="NCName"/>
+              </attribute>
+              <text/>
+            </element>
+            <element name="source_control">
+              <oneOrMore>
+                <choice>
+                  <ref name="br"/>
+                  <ref name="meta"/>
+                  <element name="sc">
+                    <attribute name="class">
+                      <data type="NCName"/>
+                    </attribute>
+                    <text/>
+                  </element>
+                </choice>
+              </oneOrMore>
+            </element>
+          </choice>
+        </oneOrMore>
+      </element>
+      <element name="body">
+        <oneOrMore>
+          <element name="object">
+            <attribute name="id"/>
+            <!--
+              <attribute name="id">
+                <data type="integer"/>
+              </attribute>
+            -->
+            <element name="ocn">
+              <text/>
+              <!--
+                <data type="integer"/>
+              -->
+            </element>
+            <optional>
+              <element name="text">
+                <attribute name="class">
+                  <data type="NCName"/>
+                </attribute>
+                <oneOrMore>
+                  <choice>
+                    <text/>
+                    <ref name="b"/>
+                    <ref name="br"/>
+                    <ref name="del"/>
+                    <ref name="en"/>
+                    <ref name="i"/>
+                    <ref name="link"/>
+                    <ref name="sub"/>
+                    <ref name="sup"/>
+                    <ref name="u"/>
+                    <element name="image">
+                      <optional>
+                        <attribute name="alt"/>
+                      </optional>
+                      <optional>
+                        <attribute name="height">
+                          <data type="integer"/>
+                        </attribute>
+                      </optional>
+                      <optional>
+                        <attribute name="width">
+                          <data type="integer"/>
+                        </attribute>
+                      </optional>
+                      <attribute name="xlink:actuate">
+                        <data type="NCName"/>
+                      </attribute>
+                      <attribute name="xlink:href"/>
+                      <attribute name="xlink:show">
+                        <data type="NCName"/>
+                      </attribute>
+                      <attribute name="xlink:type">
+                        <data type="NCName"/>
+                      </attribute>
+                    </element>
+                  </choice>
+                </oneOrMore>
+              </element>
+            </optional>
+            <optional>
+              <element name="table">
+                <attribute name="align">
+                  <data type="NCName"/>
+                </attribute>
+                <attribute name="bgcolor">
+                  <data type="NCName"/>
+                </attribute>
+                <attribute name="border">
+                  <data type="integer"/>
+                </attribute>
+                <attribute name="cellpadding">
+                  <data type="integer"/>
+                </attribute>
+                <attribute name="summary"/>
+                <attribute name="width"/>
+                <oneOrMore>
+                  <element name="tr">
+                    <oneOrMore>
+                      <element name="td">
+                        <attribute name="valign">
+                          <data type="NCName"/>
+                        </attribute>
+                        <attribute name="width"/>
+                        <oneOrMore>
+                          <choice>
+                            <text/>
+                            <ref name="b"/>
+                            <ref name="i"/>
+                          </choice>
+                        </oneOrMore>
+                      </element>
+                    </oneOrMore>
+                  </element>
+                </oneOrMore>
+              </element>
+            </optional>
+            <zeroOrMore>
+              <element name="endnote">
+                <optional>
+                  <attribute name="notenumber">
+                    <data type="integer"/>
+                  </attribute>
+                </optional>
+                <optional>
+                  <attribute name="symbol"/>
+                </optional>
+                <choice>
+                  <element name="number">
+                    <data type="integer"/>
+                  </element>
+                  <element name="symbol">
+                    <text/>
+                  </element>
+                </choice>
+                <element name="note">
+                  <oneOrMore>
+                    <choice>
+                      <text/>
+                      <ref name="b"/>
+                      <ref name="br"/>
+                      <ref name="del"/>
+                      <ref name="i"/>
+                      <ref name="link"/>
+                      <ref name="sup"/>
+                      <ref name="u"/>
+                      <element name="em">
+                        <data type="NCName"/>
+                      </element>
+                      <element name="sub">
+                        <data type="NCName"/>
+                      </element>
+                    </choice>
+                  </oneOrMore>
+                </element>
+              </element>
+            </zeroOrMore>
+          </element>
+        </oneOrMore>
+      </element>
+    </element>
+  </start>
+  <define name="meta">
+    <element name="meta">
+      <text/>
+    </element>
+  </define>
+  <define name="br">
+    <element name="br">
+      <empty/>
+    </element>
+  </define>
+  <define name="b">
+    <element name="b">
+      <oneOrMore>
+        <choice>
+          <text/>
+          <ref name="en"/>
+          <ref name="i"/>
+          <ref name="link"/>
+          <ref name="sup"/>
+        </choice>
+      </oneOrMore>
+    </element>
+  </define>
+  <define name="i">
+    <element name="i">
+      <oneOrMore>
+        <choice>
+          <text/>
+          <ref name="b"/>
+          <ref name="br"/>
+          <ref name="sup"/>
+        </choice>
+      </oneOrMore>
+    </element>
+  </define>
+  <define name="en">
+    <element name="en">
+      <text/>
+    </element>
+  </define>
+  <define name="sub">
+    <element name="sub">
+      <data type="NCName"/>
+    </element>
+  </define>
+  <define name="sup">
+    <element name="sup">
+      <data type="NCName"/>
+    </element>
+  </define>
+  <define name="link">
+    <element name="link">
+      <attribute name="xlink:href">
+        <data type="anyURI"/>
+      </attribute>
+      <attribute name="xlink:type">
+        <data type="NCName"/>
+      </attribute>
+      <oneOrMore>
+        <choice>
+          <data type="anyURI"/>
+          <text/>
+          <ref name="b"/>
+          <ref name="i"/>
+          <ref name="sup"/>
+        </choice>
+      </oneOrMore>
+    </element>
+  </define>
+  <define name="u">
+    <element name="u">
+      <oneOrMore>
+        <choice>
+          <text/>
+          <ref name="b"/>
+          <ref name="i"/>
+        </choice>
+      </oneOrMore>
+    </element>
+  </define>
+  <define name="del">
+    <element name="del">
+      <oneOrMore>
+        <choice>
+          <text/>
+          <ref name="b"/>
+          <ref name="i"/>
+          <ref name="link"/>
+        </choice>
+      </oneOrMore>
+    </element>
+  </define>
+</grammar>
diff --git a/data/doc/sisu/model/xml/output/xsd/dom.xsd b/data/doc/sisu/model/xml/output/xsd/dom.xsd
new file mode 100644
index 00000000..3132338a
--- /dev/null
+++ b/data/doc/sisu/model/xml/output/xsd/dom.xsd
@@ -0,0 +1,327 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- dom output model, part of SiSU and under the same license -->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <xs:import namespace="http://www.w3.org/1999/xlink" schemaLocation="xlink.xsd"/>
+  <xs:element name="document">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="head"/>
+        <xs:element ref="body"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="head">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="header"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="header">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="meta"/>
+        <xs:choice>
+          <xs:element ref="creator"/>
+          <xs:element ref="date"/>
+          <xs:element ref="date_available"/>
+          <xs:element ref="date_created"/>
+          <xs:element ref="date_issued"/>
+          <xs:element ref="date_modified"/>
+          <xs:element ref="date_valid"/>
+          <xs:element ref="keywords"/>
+          <xs:element ref="language"/>
+          <xs:element ref="rights"/>
+          <xs:element ref="source"/>
+          <xs:element ref="structure"/>
+          <xs:element ref="subject"/>
+          <xs:element ref="title"/>
+          <xs:element ref="type"/>
+          <xs:element ref="source_control"/>
+        </xs:choice>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="creator" type="xs:string"/>
+  <xs:element name="date" type="xs:NMTOKEN"/>
+  <xs:element name="date_available" type="xs:NMTOKEN"/>
+  <xs:element name="date_created" type="xs:NMTOKEN"/>
+  <xs:element name="date_issued" type="xs:NMTOKEN"/>
+  <xs:element name="date_modified" type="xs:NMTOKEN"/>
+  <xs:element name="date_valid" type="xs:NMTOKEN"/>
+  <xs:element name="keywords" type="xs:string"/>
+  <xs:element name="language" type="xs:NCName"/>
+  <xs:element name="rights">
+    <xs:complexType mixed="true">
+      <xs:sequence>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="link"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="source" type="xs:string"/>
+  <xs:element name="structure" type="xs:string"/>
+  <xs:element name="subject" type="xs:string"/>
+  <xs:element name="title" type="xs:string"/>
+  <xs:element name="type" type="xs:string"/>
+  <xs:element name="source_control">
+    <xs:complexType>
+      <xs:choice maxOccurs="unbounded">
+        <xs:element ref="br"/>
+        <xs:element ref="meta"/>
+        <xs:element ref="sc"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="sc">
+    <xs:complexType mixed="true">
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="body">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="heading1"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="heading1">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="contents1"/>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="heading2"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="heading2">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="contents1"/>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="heading3"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="heading3">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element maxOccurs="unbounded" ref="contents1"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="contents1">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element ref="content"/>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="contents2"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="contents2">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element ref="content"/>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="contents3"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="contents3">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="heading"/>
+        <xs:element ref="content"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="meta" type="xs:string"/>
+  <xs:element name="br">
+    <xs:complexType/>
+  </xs:element>
+  <xs:element name="heading">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="object"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="content">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="object"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <!--
+    <define name="contents1">
+      <element name="contents1">
+        <ref name="heading"/>
+        <element name="content">
+          <oneOrMore>
+            <ref name="object"/>
+          </oneOrMore>
+        </element>
+      </element>
+    </define>
+  -->
+  <xs:element name="object">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="ocn"/>
+        <xs:element minOccurs="0" ref="nametag"/>
+        <xs:choice>
+          <xs:element ref="table"/>
+          <xs:element ref="text"/>
+        </xs:choice>
+      </xs:sequence>
+      <xs:attribute name="id" use="required" type="xs:integer"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="ocn" type="xs:string"/>
+  <xs:element name="nametag" type="xs:string"/>
+  <xs:element name="table">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="tr"/>
+      </xs:sequence>
+      <xs:attribute name="align" use="required" type="xs:NCName"/>
+      <xs:attribute name="bgcolor" use="required" type="xs:NCName"/>
+      <xs:attribute name="border" use="required" type="xs:integer"/>
+      <xs:attribute name="cellpadding" use="required" type="xs:integer"/>
+      <xs:attribute name="summary" use="required"/>
+      <xs:attribute name="width" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="tr">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="td"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="td">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="i"/>
+        <xs:element ref="i"/>
+      </xs:choice>
+      <xs:attribute name="valign" use="required" type="xs:NCName"/>
+      <xs:attribute name="width" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="text">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="i"/>
+        <xs:element ref="del"/>
+        <xs:element ref="endnote"/>
+        <xs:element ref="i"/>
+        <xs:element ref="link"/>
+        <xs:element ref="br"/>
+        <xs:element name="endnote">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element ref="number"/>
+              <xs:element name="note">
+                <xs:complexType mixed="true">
+                  <xs:choice minOccurs="0" maxOccurs="unbounded">
+                    <xs:element ref="i"/>
+                    <xs:element ref="link"/>
+                  </xs:choice>
+                </xs:complexType>
+              </xs:element>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+        <xs:element ref="image"/>
+        <xs:element name="sub" type="xs:string"/>
+      </xs:choice>
+      <xs:attribute name="class" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="number" type="xs:integer"/>
+  <xs:element name="image">
+    <xs:complexType>
+      <xs:attribute name="height" use="required" type="xs:integer"/>
+      <xs:attribute name="width" use="required" type="xs:integer"/>
+      <xs:attribute ref="xlink:actuate" use="required"/>
+      <xs:attributeGroup ref="xlink:href"/>
+      <xs:attribute ref="xlink:show" use="required"/>
+      <xs:attribute ref="xlink:type" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <!--
+    <define name="content">
+      <element name="content">
+        <zeroOrMore>
+          <ref name="object"/>
+        </zeroOrMore>
+      </element>
+    </define>
+    <define name="b">
+      <element name="b">
+        <text/>
+      </element>
+    </define>
+  -->
+  <xs:element name="i" type="xs:string"/>
+  <xs:element name="u">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="i"/>
+        <xs:element ref="i"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="sub" type="xs:NCName"/>
+  <xs:element name="sup" type="xs:NCName"/>
+  <xs:element name="del">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="i"/>
+        <xs:element ref="i"/>
+        <xs:element ref="link"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="link">
+    <xs:complexType>
+      <xs:simpleContent>
+        <xs:extension base="xs:anyURI">
+          <xs:attributeGroup ref="xlink:href1"/>
+          <xs:attribute ref="xlink:type" use="required"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="endnote">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:choice>
+          <xs:element ref="number"/>
+          <xs:element ref="symbol"/>
+        </xs:choice>
+        <xs:element name="note">
+          <xs:complexType mixed="true">
+            <xs:choice minOccurs="0" maxOccurs="unbounded">
+              <xs:element ref="i"/>
+              <xs:element ref="br"/>
+              <xs:element ref="del"/>
+              <xs:element ref="i"/>
+              <xs:element ref="link"/>
+              <xs:element ref="sub"/>
+              <xs:element ref="sup"/>
+              <xs:element ref="u"/>
+              <xs:element ref="em"/>
+              <xs:element ref="sub"/>
+            </xs:choice>
+          </xs:complexType>
+        </xs:element>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="symbol" type="xs:string"/>
+  <xs:element name="em" type="xs:NCName"/>
+</xs:schema>
diff --git a/data/doc/sisu/model/xml/output/xsd/sax.xsd b/data/doc/sisu/model/xml/output/xsd/sax.xsd
new file mode 100644
index 00000000..db6eb147
--- /dev/null
+++ b/data/doc/sisu/model/xml/output/xsd/sax.xsd
@@ -0,0 +1,332 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- % sax output model, part of SiSU and distributed under the same license -->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <xs:import namespace="http://www.w3.org/1999/xlink" schemaLocation="xlink.xsd"/>
+  <xs:element name="document">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="head"/>
+        <xs:element ref="body"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="head">
+    <xs:complexType>
+      <xs:choice maxOccurs="unbounded">
+        <xs:element ref="br"/>
+        <xs:element ref="meta"/>
+        <xs:element ref="creator"/>
+        <xs:element ref="date"/>
+        <xs:element ref="date_available"/>
+        <xs:element ref="date_created"/>
+        <xs:element ref="date_issued"/>
+        <xs:element ref="date_modified"/>
+        <xs:element ref="date_valid"/>
+        <xs:element ref="keywords"/>
+        <xs:element ref="language"/>
+        <xs:element name="meta" type="xs:NMTOKEN"/>
+        <xs:element ref="rights"/>
+        <xs:element ref="source"/>
+        <xs:element ref="structure"/>
+        <xs:element ref="subject"/>
+        <xs:element ref="title"/>
+        <xs:element ref="type"/>
+        <xs:element ref="source_control"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="creator">
+    <xs:complexType mixed="true">
+      <xs:sequence>
+        <xs:element minOccurs="0" maxOccurs="unbounded" name="link">
+          <xs:complexType>
+            <xs:simpleContent>
+              <xs:extension base="xs:anyURI">
+                <xs:attributeGroup ref="xlink:href"/>
+                <xs:attribute ref="xlink:type" use="required"/>
+              </xs:extension>
+            </xs:simpleContent>
+          </xs:complexType>
+        </xs:element>
+      </xs:sequence>
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="date">
+    <xs:complexType>
+      <xs:simpleContent>
+        <xs:extension base="xs:NMTOKEN">
+          <xs:attribute name="class" use="required" type="xs:NCName"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="date_available">
+    <xs:complexType>
+      <xs:simpleContent>
+        <xs:extension base="xs:NMTOKEN">
+          <xs:attribute name="class" use="required" type="xs:NCName"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="date_created">
+    <xs:complexType>
+      <xs:simpleContent>
+        <xs:extension base="xs:NMTOKEN">
+          <xs:attribute name="class" use="required" type="xs:NCName"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="date_issued">
+    <xs:complexType>
+      <xs:simpleContent>
+        <xs:extension base="xs:NMTOKEN">
+          <xs:attribute name="class" use="required" type="xs:NCName"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="date_modified">
+    <xs:complexType>
+      <xs:simpleContent>
+        <xs:extension base="xs:NMTOKEN">
+          <xs:attribute name="class" use="required" type="xs:NCName"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="date_valid">
+    <xs:complexType>
+      <xs:simpleContent>
+        <xs:extension base="xs:NMTOKEN">
+          <xs:attribute name="class" use="required" type="xs:NCName"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="keywords">
+    <xs:complexType mixed="true">
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="language">
+    <xs:complexType>
+      <xs:simpleContent>
+        <xs:extension base="xs:NCName">
+          <xs:attribute name="class" use="required" type="xs:NCName"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="rights">
+    <xs:complexType mixed="true">
+      <xs:sequence>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="link"/>
+      </xs:sequence>
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="source">
+    <xs:complexType mixed="true">
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="structure">
+    <xs:complexType mixed="true">
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="subject">
+    <xs:complexType mixed="true">
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="title">
+    <xs:complexType mixed="true">
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="type">
+    <xs:complexType mixed="true">
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="source_control">
+    <xs:complexType>
+      <xs:choice maxOccurs="unbounded">
+        <xs:element ref="br"/>
+        <xs:element ref="meta"/>
+        <xs:element ref="sc"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="sc">
+    <xs:complexType mixed="true">
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="body">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="object"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="object">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element ref="ocn"/>
+        <xs:element minOccurs="0" ref="text"/>
+        <xs:element minOccurs="0" ref="table"/>
+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="endnote"/>
+      </xs:sequence>
+      <xs:attribute name="id" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="ocn" type="xs:string"/>
+  <xs:element name="text">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="b"/>
+        <xs:element ref="br"/>
+        <xs:element ref="del"/>
+        <xs:element ref="en"/>
+        <xs:element ref="i"/>
+        <xs:element ref="link"/>
+        <xs:element ref="sub"/>
+        <xs:element ref="sup"/>
+        <xs:element ref="u"/>
+        <xs:element ref="image"/>
+      </xs:choice>
+      <xs:attribute name="class" use="required" type="xs:NCName"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="image">
+    <xs:complexType>
+      <xs:attribute name="alt"/>
+      <xs:attribute name="height" type="xs:integer"/>
+      <xs:attribute name="width" type="xs:integer"/>
+      <xs:attribute ref="xlink:actuate" use="required"/>
+      <xs:attributeGroup ref="xlink:href1"/>
+      <xs:attribute ref="xlink:show" use="required"/>
+      <xs:attribute ref="xlink:type" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="table">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="tr"/>
+      </xs:sequence>
+      <xs:attribute name="align" use="required" type="xs:NCName"/>
+      <xs:attribute name="bgcolor" use="required" type="xs:NCName"/>
+      <xs:attribute name="border" use="required" type="xs:integer"/>
+      <xs:attribute name="cellpadding" use="required" type="xs:integer"/>
+      <xs:attribute name="summary" use="required"/>
+      <xs:attribute name="width" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="tr">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element maxOccurs="unbounded" ref="td"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="td">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="b"/>
+        <xs:element ref="i"/>
+      </xs:choice>
+      <xs:attribute name="valign" use="required" type="xs:NCName"/>
+      <xs:attribute name="width" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="endnote">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:choice>
+          <xs:element ref="number"/>
+          <xs:element ref="symbol"/>
+        </xs:choice>
+        <xs:element ref="note"/>
+      </xs:sequence>
+      <xs:attribute name="notenumber" type="xs:integer"/>
+      <xs:attribute name="symbol"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="number" type="xs:integer"/>
+  <xs:element name="symbol" type="xs:string"/>
+  <xs:element name="note">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="b"/>
+        <xs:element ref="br"/>
+        <xs:element ref="del"/>
+        <xs:element ref="i"/>
+        <xs:element ref="link"/>
+        <xs:element ref="sup"/>
+        <xs:element ref="u"/>
+        <xs:element ref="em"/>
+        <xs:element ref="sub"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="em" type="xs:NCName"/>
+  <xs:element name="sub" type="xs:NCName"/>
+  <xs:element name="meta" type="xs:string"/>
+  <xs:element name="br">
+    <xs:complexType/>
+  </xs:element>
+  <xs:element name="b">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="en"/>
+        <xs:element ref="i"/>
+        <xs:element ref="link"/>
+        <xs:element ref="sup"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="i">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="b"/>
+        <xs:element ref="br"/>
+        <xs:element ref="sup"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="en" type="xs:string"/>
+  <xs:element name="sup" type="xs:NCName"/>
+  <xs:element name="link">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="b"/>
+        <xs:element ref="i"/>
+        <xs:element ref="sup"/>
+      </xs:choice>
+      <xs:attributeGroup ref="xlink:href"/>
+      <xs:attribute ref="xlink:type" use="required"/>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="u">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="b"/>
+        <xs:element ref="i"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="del">
+    <xs:complexType mixed="true">
+      <xs:choice minOccurs="0" maxOccurs="unbounded">
+        <xs:element ref="b"/>
+        <xs:element ref="i"/>
+        <xs:element ref="link"/>
+      </xs:choice>
+    </xs:complexType>
+  </xs:element>
+</xs:schema>
diff --git a/data/doc/sisu/on_markup.txt b/data/doc/sisu/on_markup.txt
new file mode 100644
index 00000000..72aee93b
--- /dev/null
+++ b/data/doc/sisu/on_markup.txt
@@ -0,0 +1,343 @@
+SiSU Markup Standard
+* Copyright Ralph Amissah
+* version 0.16.0
+* homepage: http://www.jus.uio.no/sisu
+* manpages 'man sisu'
+* markup examples
+  * data/sisu-markup-samples/document_samples_sisu_markup
+  * /usr/share/sisu-markup-samples/document_samples_sisu_markup
+  * http://www.jus.uio.no/sisu/sample/markup
+  * http://www.jus.uio.no/sisu/sample/syntax
+* book samples
+  * http://www.jus.uio.no/sisu/sisu_examples/1#books
+  * http://www.jus.uio.no/sisu/SiSU/2#books
+
+The man pages 'man sisu' are likely to be more up to date than this document,
+please consult them.
+
+Examples of marked up documents are also provided, under the directory branch 
+data/sisu-markup-samples
+or online at
+
+SiSU Markup syntax
+
+sisu
+  Data text markup (alternative to available html subset)
+
+  1~ heading/title               [levels 1 to 6 available]
+
+  4~filename heading             [segmentation level]
+
+  !{emphasis}!
+
+  *{bold text}*
+
+  _{underscore}_
+
+  /{italics}/
+
+  "{citation}"
+
+  ^{superscript}^
+
+  ,{subscript},
+
+  +{inserted text}+
+
+  -{strikethrough}-
+
+  ------------------------------------------
+  Indentation and bullets
+
+  _1                             indent paragraph one level
+
+  _2                             indent paragraph two steps
+
+  _2                             indent paragraph two steps
+
+  _*                             bullet text
+
+  _1*                            bullet text, first indent
+
+  ------------------------------------------
+  Numbered List (not to be confused with headings/titles, (document structure))
+
+  # numbered list                numbered list 1., 2., 3, etc.
+
+  _# numbered list               numbered list indented a., b., c., d., etc.
+
+  ------------------------------------------
+  Endnotes
+
+  ~{ endnote }~                  endnote~{ self contained endnote marker & endnote in one }~
+
+  ---
+  alternative endnote pair notation
+
+  ~^                             endnote marker
+  ^~ endnote text following the paragraph in which the marker occurs
+
+  ------------------------------------------
+  Links
+
+    A url within text is automatically hyperlinked to itself, ie raw urls within text are automatically marked up.
+
+    http://url.org               would be hyperlinked to itself
+
+    { [text to link] }http://url.org
+
+    { image.png }http://url.org
+
+    { image.png }image    { tux.png 64x80 }image                        width x height
+
+  Linked image
+
+    { SiSU Geek Writer }http://www.jus.uio.no/sisu/                     url example
+
+    { tux.png 64x80 "a better way" }http://www.jus.uio.no/sisu/     image example with all options
+  
+  shortcut - hyper-linked text with endnote providing the url information
+
+    {~^ [text to link] }http://url.org         maps to   { [text to link] }http://url.org ~{ http://url.org }~
+    which produces hyper-linked text within a document/paragraph, with an endnote providing the url for the text location used in the hyperlink
+    
+    manual location marker/tagging at present only in html to produce <a name="[name]"> (use sparingly)
+
+    *~[name]
+
+    note at a heading level the same is automatically achieved by providing names to headings 5 and 6 i.e. 5~[name] and 6~[name] or in the case of auto-heading numbering, without further intervention.
+
+  ------------------------------------------
+
+  ~#    unnumbered paragraph (place marker at end of paragraph)
+
+  -#    unnumbered paragraph, delete when not required (place marker at end of paragraph) [used in dummy headings, eg. for segmented html]
+
+  ------------------------------------------
+  %     add a comment to text, that will be removed prior to processing (place marker at beginning of line)
+
+  ------------------------------------------
+
+  There are some things to be aware of <br> may be used, but urls occuring before or after a break must have a space. The vim syntax highlighter catches most of the rules... 
+
+  ------------------------------------------
+
+  More HELP on Markup markup help is available on:
+
+    document wide instructions: headers (document structure)
+
+    general text markup: headings; endnotes; tables
+
+  configuration and customisation
+
+    document or site wide customisation: customise; skin
+
+TABLES
+
+
+table{ [number of columns] [column width %];[column width %]
+
+[table content, line breaks are important see example below]
+
+}table
+----
+This is a sample table:
+-----------------------
+
+table{ c3; 40; 30; 30;
+
+This is a table
+this would become column two of row one
+column three of row one is here
+
+And here begins another row
+column two of row two
+column three of row two, and so on
+
+}table
+
+PREFORMATTED TEXT
+
+poem{
+
+  [Text here]
+
+}poem
+----
+
+group{
+
+  [Text here]
+
+}group
+----
+
+code{
+
+  [Text here]
+
+}code
+
+HEADERS
+
+Header tags appear at the beginning of a document and provide meta information on the document (such as the Dublin Core), or information as to how the document as a whole is to be processed.
+All header instructions take either the form 0~ . All Dublin Core meta tags are available
+0~indentifier information
+where the "identifier" is a tag recognised by the program, and the "information" or "instructions" belong to the tag/indentifier specified
+The { form was introduced to take advantage of vim folds, and its use is reserved primarily for document structural instructions: namely header and heading tags (also a footnote/endnote option).
+This is a sample header (Dublin Core in fuschia, other information headers in cyan, markup instructions in red):
+
+0~title My Title - This is now the Title of the Document and used as such
+
+0~subtitle The Subtitle if any
+
+0~creator [or ~author] Ralph Amissah
+
+0~subject Document production and management (or whatever your subject)
+
+0~description 
+
+0~publisher 
+
+0~contributor 
+
+0~date 2000-08-27
+  [ also 0~date.created 0~date.issued 0~date.available 0~date.valid 0~date.modified ]
+
+0~type article
+
+0~format
+
+0~identifier
+
+0~source
+
+0~language (en|us|fr|de|es|se|dk|fi|no)
+
+0~relation
+
+0~coverage
+
+0~rights copyright, all rights reserved, public domain, copyleft, creative commons variant, etc.
+
+0~owner
+
+0~keywords text document generation processing management latex pdf structured xml citation [your keywords here, used for example by rss feeds, and in sql searches]
+
+0~abstract [paper abstract, placed after table of contents]
+
+0~comment [...]
+
+0~classify_loc [Library of Congress classification]
+
+0~classify_dewey [Dewey classification system]
+
+0~classify_isbn [ISBN]
+
+0~classify_pg [Project Gutenberg text number]
+
+0~prefix_a [prefix is placed just before table of contents - not implemented]
+
+0~prefix_b or 0~prefix [prefix is placed just after table of contents]
+
+0~rcs $Id$ [or 0~cvs used by rcs or cvs to embed version (revision control) information into document, rcs or cvs can usefully provide a history of updates to a document ]
+
+0~toc PART; CHAPTER; SECTION; ARTICLE; none; none;
+optional, where document structure can be defined by a match words or regular expression (the regular expression is assumed to start at the beginning of a line of text)
+default markers 1~ to 6~ can be used within text instead, without this header tag, and may be used to suppliment the instructions provided in this header tag if provided
+
+0~level newpage=3; breakpage=4 [paragraph level, used by latex to breakpages, the page is optional eg. in newpage] 
+
+0~markup num_top=4 [various markup instructions, eg: num_top=4 headings tobe numbered, starting at heading level 4... the default is to provide 3 levels, as in 1 level 4, 1.1 level 5, 1.1.1 level 6, markup to be merged within level]
+
+0~vocabulary name of taxonomy/vocabulary/wordlist to use against document
+
+0~skin skin_doc_[name_of_desired_document_skin]
+
+0~links http://google.com; Google;
+
+1~ Top level heading [this is usually the same as the title 0~title ]
+
+2~ Second level heading [this is a heading level divider]
+
+3~ Third level heading [this is a heading level divider]
+
+4~ Top level heading preceeding substantive text of document or sub-heading 5, the heading level that would normally be marked 1. or 2. or 3. etc. in a document
+
+5~ Second level heading preceeding substantive text of document or sub-heading 6, the heading level that would normally be marked 1.1 or 1.2 or 1.3 or 2.1 etc in a document
+
+6~ Third level heading preceeding substantive text of document, that would normally be marked 1.1.1 or 1.1.2 or 1.2.1 or  2.1.1 etc. in a document
+
+SAMPLE DOCUMENT
+
+For sample marked up documents see the directory 
+  markup_samples
+
+0~title Working Sample Document
+
+0~subtitle Demonstrating markup
+
+0~creator Ralph Amissah
+
+0~date 
+
+0~markup num_top=4 
+
+0~links 
+
+1~ A Sample Document
+  
+2~ just for fun 
+    
+4~ This is Chapter One or Article One
+
+Ordinary Text follows here. The Title would be a Chapter or Article depending on the type of document you were working to produce.
+
+4~ This would be Chapter Two or Article Two
+
+And so on.
+
+Assuming sisu is configured properly so it has been instructed where to put the work files and ouput files, you would generate this text once saved, with the suffix .s3 if saved as example.s3, by typing sisu -mhwxp example.s3 while in the directory in which the file is saved. 
+
+_1 -m initial processing, -h html (css based), -w wordmap for html, -x xml, -p pdf output, generated via latex, there are of course additional options
+
+_1 for a listing type: sisu ~ commands
+
+_1 for an outline of sisu markup type: sisu ~ markup 
+
+The example ends here.
+
+-------------------
+
+Composite Documents
+
+It  is  possible  to build a document by requiring other documents.  The documents required may complete documents that could be  gener ated  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 mainly from other doc uments), by convention it should be named with the suffix .r1 , .r2 ,  or .r3 .s1 , .s2 , or .s3 , and if markup snippets .si. A tempo rary file of the composite document is built  prior  to  processing with the same prefix and the suffix .t1 , .t2 , or .t3
+
+basic markup for importing a document into another, 
+[note placement is at start of the line, no spaces despite presentation below]
+
+  r{ filename }
+
+  { filename.si }require
+
+  << { filename.si } #for vim folds
+
+importing a document with textlink syntax
+
+  |filename.si|@|^|require
+
+  << |filename.si|@|^| #for vim folds
+
+
+importing a document with thlnk syntax
+
+  <url:filename.si>require
+
+  << <url:filename.si> #for vim folds
+
+
+remote  documents  may  be called with the thlnk syntax (or regular
+sisu syntax), e.g.
+
+   << <url:http://www.url.com/filename.si>
+
diff --git a/data/doc/sisu/on_standards.txt b/data/doc/sisu/on_standards.txt
new file mode 100644
index 00000000..fc34468b
--- /dev/null
+++ b/data/doc/sisu/on_standards.txt
@@ -0,0 +1,17 @@
+* Name: SiSU information Structuring Universe   
+* Author: Ralph@Amissah.com
+* Description: Information on SiSU Standards
+*  homepage: http://www.jus.uio.no/sisu
+
+SiSU uses:
+*  Standard SiSU markup syntax,
+*  Standard SiSU meta-markup syntax, and the
+*  Standard SiSU object citation numbering and system
+
+Information on these may be obtained from:
+  http://www.jus.uio.no/sisu/SiSU
+
+More information to be provided later.
+
+? Ralph Amissah 1997, current 2005
+All Rights Reserved
diff --git a/data/doc/sisu/sisu_markup_samples/README.samples b/data/doc/sisu/sisu_markup_samples/README.samples
new file mode 100644
index 00000000..56ec4c21
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/README.samples
@@ -0,0 +1,9 @@
+Document samples for sisu processing are contained in the sub-directory
+./dfsg and if it exists ./non-free
+
+DFSG stands for Debian Free Software Guidelines.
+
+Sample documents in the dfsg directory should comply with the guidelines.
+
+The non-free directory if it exists contains document samples that do not or
+may not comply with the DFSG.
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/README b/data/doc/sisu/sisu_markup_samples/dfsg/README
new file mode 100644
index 00000000..ef602a54
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/README
@@ -0,0 +1,6 @@
+A few document markup samples, note that more can be found at
+http://www.jus.uio.no/sisu
+http://www.jus.uio.no/sisu/SiSU/2
+
+"Free as in Freedom" on Richard Stallman by Sam Williams
+was published under the GNU Free Documentation License
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/Gnu_Debian_Linux_Ruby_Way_Better.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/Gnu_Debian_Linux_Ruby_Way_Better.png
new file mode 100644
index 00000000..0f3f4a16
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/Gnu_Debian_Linux_Ruby_Way_Better.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/b_doc.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/b_doc.png
new file mode 100644
index 00000000..13ca8ebe
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/b_doc.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/c_Copyleft.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/c_Copyleft.png
new file mode 100644
index 00000000..5b3865b8
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/c_Copyleft.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/c_Euro.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/c_Euro.png
new file mode 100644
index 00000000..8e5c13a9
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/c_Euro.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/debian_home.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/debian_home.png
new file mode 100644
index 00000000..cee42aa0
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/debian_home.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom.png
new file mode 100644
index 00000000..ad4c05b2
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_01_rms.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_01_rms.png
new file mode 100644
index 00000000..3b4563b0
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_01_rms.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_02_rms_snr_year_report.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_02_rms_snr_year_report.png
new file mode 100644
index 00000000..5d5a57aa
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_02_rms_snr_year_report.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_03_rms_st_ignucius.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_03_rms_st_ignucius.png
new file mode 100644
index 00000000..d84bf568
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_03_rms_st_ignucius.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_04_rms_pleasure_card.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_04_rms_pleasure_card.png
new file mode 100644
index 00000000..2ab79e1c
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/free_as_in_freedom_04_rms_pleasure_card.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/kdissert.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/kdissert.png
new file mode 100644
index 00000000..2dff3753
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/kdissert.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/levitating_gnu.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/levitating_gnu.png
new file mode 100644
index 00000000..9a25319a
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/levitating_gnu.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/philosophical_gnu.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/philosophical_gnu.png
new file mode 100644
index 00000000..ebd239ef
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/philosophical_gnu.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/sisu.png b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/sisu.png
new file mode 100644
index 00000000..b449fa6b
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/image/sisu.png
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/dir/skin_sisu.rb b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/dir/skin_sisu.rb
new file mode 100644
index 00000000..66786cea
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/dir/skin_sisu.rb
@@ -0,0 +1,105 @@
+=begin
+ * Name: SiSU information Structuring Universe - Structured information, Serialized Units
+ * Author: Ralph@Amissah.com
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+ * Description: Document skin for SiSU descriptive pages, ... 
+ * License: Same as SiSU see http://www.jus.uio.no/sisu
+ * Notes: Site default appearance variables set in defaults.rb
+     Generic site wide modifications set here scribe_skin.rb, and this file required by other "scribes" instead of defaults.rb
+=end
+module SiSU_Viz
+  require SiSU_lib + '/defaults'
+  class Skin
+    #% widget
+    def widget_search
+      true
+    end
+    def widget_promo
+#put  s "#{__LINE__} #{__FILE__}"
+      #['sisu','ruby','sisu_search_libre','ruby','open_society']
+    end
+    #% path
+    def path_root
+#puts "#{__LINE__} #{__FILE__}"
+      './sisu/'                                                                  # the only parameter that cannot be changed here
+    end
+    def path_rel
+#puts "#{__LINE__} #{__FILE__}"
+      '../'
+    end
+    #% url
+    def url_home
+#puts "#{__LINE__} #{__FILE__}"
+      'http://www.jus.uio.no/sisu/'
+    end
+    def url_site                                                                     # used in pdf header
+#puts "#{__LINE__} #{__FILE__}"
+      'http://www.jus.uio.no/sisu' 
+    end
+    def url_txt                                                                      # text to go with url usually stripped url
+#puts "#{__LINE__} #{__FILE__}"
+      'www.jus.uio.no/sisu/'
+    end
+    def url_home_url
+#puts "#{__LINE__} #{__FILE__}"
+      '../index.html'
+    end
+    #def url_root_http
+      #root server path info, used in document information
+    #end
+    #% color
+    def color_band1
+      '"#ffffff"'      
+    end
+    def color_band2
+      '"#ffffff"'
+    end
+    #% text
+    def text_hp
+    	'&nbsp;SiSU'
+    end
+    def text_home
+      'SiSU' 
+    end
+    #% icon
+    def icon_home_button
+      'sisu.png'
+    end
+    def icon_home_banner
+      icon_home_button
+    end
+    #% banner
+    def banner_home_button
+  	  %{<table summary="home button" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#ffffff"><a href="#{url_site}/">#{png_home}</a></td></tr></table>\n}
+    end
+    def banner_home_and_index_buttons
+      %{<table><tr><td width="20%"><table summary="home and index buttons" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#ffffff"><a href="#{url_site}/" target="_top">#{png_home}</a>#{table_close}</td><td width="60%"><center><center><table summary="buttons" border="1" cellpadding="3" cellspacing="0"><tr><td align="center" bgcolor="#ffffff"><font face="arial" size="2"><a href="toc" target="_top">&nbsp;This&nbsp;text&nbsp;sub-&nbsp;<br />&nbsp;Table&nbsp;of&nbsp;Contents&nbsp;</a></font>#{table_close}</center></center></td><td width="20%">&nbsp;#{table_close}}
+    end
+    def banner_band
+      %{<table summary="band" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#ffffff"><a href="#{url_site}/" target="_top">#{png_home}</a>#{table_close}}
+    end
+    #% credits
+    def credits_splash
+      %{<center><table summary="credits" align="center"bgcolor="#ffffff"><tr><td>#{widget_sisu}#{widget_wayBetter}#{widget_browsers}#{widget_pdfviewers}</td></tr></table></center>}
+    end
+    #% stamp
+    def stamp_stmp
+  	  "\\copyright Ralph Amissah, released under the GPL \\\\\n ralph@amissah.com \\\\\n www.jus.uio.no/sisu/"
+    end
+  end
+  class TeX
+    def header_center
+	    "\\chead{\\href{#{@vz.url_site}/}{www.jus.uio.no/sisu/}}"
+    end
+    def home_url
+	    "\\href{#{@vz.url_site}/}{www.jus.uio.no/sisu/}"
+    end
+    def home
+	    "\\href{#{@vz.url_site}/}{Ralph Amissah}"
+    end
+    def owner_chapter
+      'Document owner details'
+    end
+  end
+end
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_gnu.rb b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_gnu.rb
new file mode 100644
index 00000000..50516f85
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_gnu.rb
@@ -0,0 +1,96 @@
+=begin
+ * Name: SiSU - Simple information Structuring Universe - Structured information, Serialized Units
+ * Author: Ralph Amissah
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+ * Description: Free Software Foundation, Gnu sisu skin
+ * License: Same as SiSU see http://www.jus.uio.no/sisu
+ * Notes: Site default appearance variables set in defaults.rb
+     Generic site wide modifications set here scribe_skin.rb, and this file required by other "scribes" instead of defaults.rb
+=end
+module SiSU_Viz
+  require SiSU_lib + '/defaults'
+  class Skin
+    #% widget
+    def widget_promo
+      # ['sisu_icon','sisu','sisu_search_libre','open_society','fsf','ruby']
+    end
+    #% home
+    def home_index
+    end
+    def home_toc
+    end
+    #% path
+    def path_root
+      './sisu/'                                                                  # the only parameter that cannot be changed here
+    end
+    def path_rel
+      '../'
+    end
+    #% url
+    def url_home
+      'http://www.fsf.org'
+    end
+    def url_site                                                                     # used in pdf header
+      'http://www.fsf.org'
+    end
+    def url_txt                                                                      # text to go with url usually stripped url
+      'www.fsf.org'
+    end
+    def url_home_url
+      '../index.html'
+    end
+    # color
+    def color_band1
+      '"#000070"'      
+    end
+    #% txt
+    def txt_hp
+    	'Free Software Foundation'
+    end
+    def txt_home                                                                     # this should be the name of the site eg. Lex Mercatoria or if you prefer to see a url the url in text form copy & ...
+      #"www.jus.uio.no/sisu/" 
+    	'Free Software Foundation'
+    end
+    #% icon
+    def icon_home_button
+      'philosophical_gnu.png'
+    end
+    def icon_home_banner
+      icion_home_button
+    end
+    #% banner
+    def banner_home_button
+		  %{<table border="0" summary="home button" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#000070"><a href="#{url_site}/">#{png_home}</a></td></tr></table>\n}
+    end
+    def banner_home_and_index_buttons
+	    %{<table><tr><td width="20%"><table summary="home and index buttons" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#000070"><a href="#{url_site}/" target="_top">#{png_home}</a>#{table_close}</td><td width="60%"><center><table summary="buttons" border="1" cellpadding="3" cellspacing="0"><tr><td align="center" bgcolor="#f1e8de"><font face="arial" size="2"><a href="toc" target="_top">&nbsp;This&nbsp;text&nbsp;sub-&nbsp;<br />&nbsp;Table&nbsp;of&nbsp;Contents&nbsp;</a></font>#{table_close}</center></td><td width="20%">&nbsp;#{table_close}}
+    end
+    def banner_band
+      %{<table summary="band" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#000070"><a href="#{url_site}/" target="_top">#{png_home}</a>#{table_close}}
+    end
+    #% credits
+    def credits_splash
+      %{<center><table summary="credits" align="center"bgcolor="#ffffff"><tr><td>#{widget_sisu}#{widget_wayBetter}#{widget_browsers}#{widget_pdfviewers}#{table_close}</center>}
+    end
+  end
+  class TeX
+    def header_center
+	    "\\chead{\\href{#{@vz.url_site}/}{www.jus.uio.no/sisu/}}"
+    end
+    def home_url
+	    "\\href{#{@vz.url_site}/}{www.fsf.org}"
+    end
+    def home
+	    "\\href{#{@vz.url_site}/}{Free Software Foundation}"
+    end
+    def owner_chapter
+      "Document owner details"
+    end
+  end
+  class Stamp
+    def stmp
+  	  "\\copyright Ralph Amissah to be released under the GPL (or QT License equivalent as to be decided) \\\\\n ralph@amissah.com \\\\\n www.jus.uio.no/sisu/"
+    end
+  end
+end
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_gutenberg.rb b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_gutenberg.rb
new file mode 100644
index 00000000..0df9c7ff
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_gutenberg.rb
@@ -0,0 +1,218 @@
+=begin
+ * Name: SiSU - Simple information Structuring Universe - Structured information, Serialized Units
+ * Author: Ralph Amissah
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+ * Description: Document skin sample prepared for Gutenberg Project (first used with "War and Peace") 
+ * License: Same as SiSU see http://www.jus.uio.no/sisu
+ * Notes: Site default appearance variables set in defaults.rb
+     Generic site wide modifications set here scribe_skin.rb, and this file required by other "scribes" instead of defaults.rb
+=end
+module SiSU_Viz
+  require "#{SiSU_lib}/defaults"
+  class Skin
+    #% path
+    def path_root                                                                     # the only parameter that cannot be changed here
+      './sisu/'  
+    end
+    def path_rel
+      '../'
+    end
+  #% url
+    def url_home
+      'http://www.gutenberg.net'
+    end
+    def url_txt                                                                      # text to go with url usually stripped url
+      'www.gutenberg.net'
+    end
+    #% txt
+    def txt_hp
+      'www.gutenberg.net'
+    end
+    def txt_home
+      'Gutenberg Project'
+    end
+    #% icon
+    def icon_home_button
+      'gutenberg.home.png'
+    end
+    def icon_home_banner
+      icon_home_button
+    end
+    #% banner
+    def banner_home_button
+      %{<table summary="home button" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor=#{color_yellow_dark}><a href="#{url_home}">#{png_home}</a></td></tr></table>\n}
+    end
+    def banner_home_and_index_buttons
+      %{<table><tr><td width="20%"><table summary="home and index buttons" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor=#{color_yellow_dark}><a href="#{url_home}" target="_top">#{png_home}</a></td></tr></table></td><td width="60%"><center><center><table summary="buttons" border="1" cellpadding="3" cellspacing="0"><tr><td align="center" bgcolor="#f1e8de"><font face="arial" size="2"><a href="toc.html" target="_top">&nbsp;This&nbsp;text&nbsp;sub-&nbsp;<br />&nbsp;Table&nbsp;of&nbsp;Contents&nbsp;</a></font></td></tr></table></center></center></td><td width="20%">&nbsp;</td></tr></table>}
+    end
+    def banner_band
+      %{<table summary="band" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor=#{color_yellow_dark}><a href="#{url_home}" target="_top">#{png_home}</a>#{table_close}}
+    end
+    #% credits
+    def credits_splash
+      %{<table summary="credits" align="center"bgcolor="#ffffff"><tr><td><font color="black"><center><a href="http://www.gutenberg.net/"><img border="0" align="center" src="../_sisu/image_local/gutenberg_icon.png" alt="Gutenberg Project"><br />Courtesy of The Gutenberg Project</a><br />#{widget_sisu}</center></font></td></tr></table>}
+    end
+  end
+  class TeX
+    def header_center
+	    "\\chead{\\href{#{@vz.url_home}}{www.gutenberg.net}}"
+    end
+    def home_url
+	    "\\href{#{@vz.url_home}}{www.gutenberg.net}"
+    end
+    def home
+	    "\\href{#{@vz.url_home}}{Gutenberg Project}"
+    end
+    def owner_chapter
+      "Document owner details"
+    end
+    def stmp
+	    "\\copyright Ralph Amissah, licence GPL \\\\\n www.jus.uio.no/sisu/"
+    end
+  end
+  class Inserts
+    def insert1
+<<CONTENTS
+
+3~ Project Gutenberg~#
+
+4~ Project Gutenberg Notes~#
+
+Copyright laws are changing all over the world, be sure to check the copyright laws for your country before posting these files!!~#
+
+Please take a look at the important information in this header.  We encourage you to keep this file on your own disk, keeping an electronic path open for the next readers.  Do not remove this.~#
+
+*{It must legally be the first thing seen when opening the book.}* In fact, our legal advisors said we can't even change margins.~#
+
+*{Welcome To The World of Free Plain Vanilla Electronic Texts}*~#
+
+*{Etexts Readable By Both Humans and By Computers, Since 1971}*~#
+
+*{These Etexts Prepared By Hundreds of Volunteers and Donations}*~#
+
+Information on contacting Project Gutenberg to get Etexts, and further information is included below.  We need your donations.~#
+
+CONTENTS
+    end
+    def insert2                                                                  #note took out stop after http://promo.net/pg and created space after  this url repeated in subsequent paragraph, as broke latex/pdf, think of modifying regexs for urls
+<<CONTENTS
+Project Gutenberg Etexts are usually created from multiple editions, all of which are in the Public Domain in the United States, unless a copyright notice is included.  Therefore, we usually do NOT keep any of these books in compliance with any particular paper edition.~#
+
+We are now trying to release all our books one month in advance of the official release dates, leaving time for better editing.~#
+
+Please note:  neither this list nor its contents are final till midnight of the last day of the month of any such announcement.  The official release date of all Project Gutenberg Etexts is at Midnight, Central Time, of the last day of the stated month.  A preliminary version may often be posted for suggestion, comment and editing by those who wish to do so.  To be sure you have an up to date first edition [xxxxx10x.xxx] please check file sizes in the first week of the next month.  Since our ftp program has a bug in it that scrambles the date [tried to fix and failed] a look at the file size will have to do, but we will try to see a new copy has at least one byte more or less.~#
+
+4~ Information about Project Gutenberg (one page)~#
+
+We produce about two million dollars for each hour we work.  The time it takes us, a rather conservative estimate, is fifty hours to get any etext selected, entered, proofread, edited, copyright searched and analyzed, the copyright letters written, etc.  This projected audience is one hundred million readers.  If our value per text is nominally estimated at one dollar then we produce $2 million dollars per hour this year as we release thirty-six text files per month, or 432 more Etexts in 1999 for a total of 2000+ If these reach just 10% of the computerized population, then the total should reach over 200 billion Etexts given away this year.~#
+
+The Goal of Project Gutenberg is to Give Away One Trillion Etext Files by December 31, 2001.  [10,000 x 100,000,000 = 1 Trillion] This is ten thousand titles each to one hundred million readers, which is only ~5% of the present number of computer users.  At our revised rates of production, we will reach only one-third of that goal by the end of 2001, or about 3,333 Etexts unless we manage to get some real funding; currently our funding is mostly from Michael Hart's salary at Carnegie-Mellon University, and an assortment of sporadic gifts; this salary is only good for a few more years, so we are looking for something to replace it, as we don't want Project Gutenberg to be so dependent on one person.~#
+
+We need your donations more than ever!~#
+
+All donations should be made to "Project Gutenberg/CMU": and are tax deductible to the extent allowable by law.  (CMU = Carnegie-Mellon University).~#
+
+For these and other matters, please mail to:~#
+
+Project Gutenberg~#
+
+P. O. Box  2782~#
+
+Champaign, IL 61825~#
+
+When all other email fails. . .try our Executive Director: Michael S. Hart hart@pobox.com forwards to hart@prairienet.org and archive.org if your mail bounces from archive.org, I will still see it, if it bounces from prairienet.org, better resend later on. . . .~#
+
+We would prefer to send you this information by email.~#
+
+******~#
+
+To access Project Gutenberg etexts, use any Web browser to view http://promo.net/pg  This site lists Etexts by author and by title, and includes information about how to get involved with Project Gutenberg.  You could also download our past Newsletters, or subscribe here.  This is one of our major sites, please email hart@pobox.com, for a more complete list of our various sites.~#
+
+To go directly to the etext collections, use FTP or any Web browser to visit a Project Gutenberg mirror (mirror sites are available on 7 continents; mirrors are listed at http://promo.net/pg ).~#
+
+Mac users, do NOT point and click, typing works better.~#
+
+Example FTP session:~#
+
+ftp metalab.unc.edu~#
+
+login: anonymous~#
+
+password: your@login~#
+
+cd pub/docs/books/gutenberg~#
+
+cd etext90 through etext99 or etext00 through etext01, etc.~#
+
+dir [to see files]~#
+
+get or mget [to get files. . .set bin for zip files]~#
+
+GET GUTINDEX.??  [to get a year's listing of books, e.g., GUTINDEX.99]~#
+
+GET GUTINDEX.ALL [to get a listing of ALL books]~#
+
+***~#
+
+3~ Information prepared by the Project Gutenberg legal advisor** (three pages)~#
+
+4~ THE SMALL PRINT!**FOR PUBLIC DOMAIN ETEXTS~#
+
+Why is this "Small Print!" statement here?  You know: lawyers.  They tell us you might sue us if there is something wrong with your copy of this etext, even if you got it for free from someone other than us, and even if what's wrong is not our fault.  So, among other things, this "Small Print!" statement disclaims most of our liability to you.  It also tells you how you can distribute copies of this etext if you want to.~#
+
+5~ *BEFORE!* YOU USE OR READ THIS ETEXT~#
+
+By using or reading any part of this PROJECT GUTENBERG-tm etext, you indicate that you understand, agree to and accept this "Small Print!" statement.  If you do not, you can receive a refund of the money (if any) you paid for this etext by sending a request within 30 days of receiving it to the person you got it from.  If you received this etext on a physical medium (such as a disk), you must return it with your request.~#
+
+5~ ABOUT PROJECT GUTENBERG-TM ETEXTS~#
+
+This PROJECT GUTENBERG-tm etext, like most PROJECT GUTENBERG-tm etexts, is a "public domain" work distributed by Professor Michael S. Hart through the Project Gutenberg Association at Carnegie-Mellon University (the "Project").  Among other things, this means that no one owns a United States copyright on or for this work, so the Project (and you!) can copy and distribute it in the United States without permission and without paying copyright royalties.  Special rules, set forth below, apply if you wish to copy and distribute this etext under the Project's "PROJECT GUTENBERG" trademark.~#
+
+To create these etexts, the Project expends considerable efforts to identify, transcribe and proofread public domain works.  Despite these efforts, the Project's etexts and any medium they may be on may contain "Defects".  Among other things, Defects may take the form of incomplete, inaccurate or corrupt data, transcription errors, a copyright or other intellectual property infringement, a defective or damaged disk or other etext medium, a computer virus, or computer codes that damage or cannot be read by your equipment.~#
+
+5~ LIMITED WARRANTY; DISCLAIMER OF DAMAGES~#
+
+But for the "Right of Replacement or Refund" described below, [1] the Project (and any other party you may receive this etext from as a PROJECT GUTENBERG-tm etext) disclaims all liability to you for damages, costs and expenses, including legal fees, and [2] YOU HAVE NO REMEDIES FOR NEGLIGENCE OR UNDER STRICT LIABILITY, OR FOR BREACH OF WARRANTY OR CONTRACT, INCLUDING BUT NOT LIMITED TO INDIRECT, CONSEQUENTIAL, PUNITIVE OR INCIDENTAL DAMAGES, EVEN IF YOU GIVE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.~#
+
+If you discover a Defect in this etext within 90 days of receiving it, you can receive a refund of the money (if any) you paid for it by sending an explanatory note within that time to the person you received it from.  If you received it on a physical medium, you must return it with your note, and such person may choose to alternatively give you a replacement copy.  If you received it electronically, such person may choose to alternatively give you a second opportunity to receive it electronically.~#
+
+THIS ETEXT IS OTHERWISE PROVIDED TO YOU "AS-IS".  NO OTHER WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, ARE MADE TO YOU AS TO THE ETEXT OR ANY MEDIUM IT MAY BE ON, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.~#
+
+Some states do not allow disclaimers of implied warranties or the exclusion or limitation of consequential damages, so the above disclaimers and exclusions may not apply to you, and you may have other legal rights.~#
+
+5~ INDEMNITY~#
+
+You will indemnify and hold the Project, its directors, officers, members and agents harmless from all liability, cost and expense, including legal fees, that arise directly or indirectly from any of the following that you do or cause: [1] distribution of this etext, [2] alteration, modification, or addition to the etext, or [3] any Defect.~#
+
+5~ DISTRIBUTION UNDER "PROJECT GUTENBERG-tm"~#
+
+You may distribute copies of this etext electronically, or by disk, book or any other medium if you either delete this "Small Print!" and all other references to Project Gutenberg, or:~#
+
+*{[1]}*  Only give exact copies of it.  Among other things, this requires that you do not remove, alter or modify the etext or this "small print!" statement.  You may however, if you wish, distribute this etext in machine readable binary, compressed, mark-up, or proprietary form, including any form resulting from conversion by word pro- cessing or hypertext software, but only so long as *{EITHER}*:~#
+
+_1 *{[*]}*  The etext, when displayed, is clearly readable, and does *not* contain characters other than those intended by the author of the work, although tilde (~), asterisk (*) and underline (_) characters may be used to convey punctuation intended by the author, and additional characters may be used to indicate hypertext links; OR~#
+
+_1 *{[*]}*  The etext may be readily converted by the reader at no expense into plain ASCII, EBCDIC or equivalent form by the program that displays the etext (as is the case, for instance, with most word processors); OR~#
+
+_1 *{[*]}*  You provide, or agree to also provide on request at no additional cost, fee or expense, a copy of the etext in its original plain ASCII form (or in EBCDIC or other equivalent proprietary form).~#
+
+*{[2]}*  Honor the etext refund and replacement provisions of this "Small Print!" statement.~#
+
+*{[3]}*  Pay a trademark license fee to the Project of 20% of the net profits you derive calculated using the method you already use to calculate your applicable taxes.  If you don't derive profits, no royalty is due.  Royalties are payable to "Project Gutenberg Association/Carnegie-Mellon University" within the 60 days following each date you prepare (or were legally required to prepare) your annual (or equivalent periodic) tax return.~#
+
+5~ WHAT IF YOU *WANT* TO SEND MONEY EVEN IF YOU DON'T HAVE TO?~#
+
+The Project gratefully accepts contributions in money, time, scanning machines, OCR software, public domain etexts, royalty free copyright licenses, and every other sort of contribution you can think of.  Money should be paid to "Project Gutenberg Association / Carnegie-Mellon University".~#
+
+We are planning on making some changes in our donation structure in 2000, so you might want to email me, hart@pobox.com beforehand.~#
+
+*END THE SMALL PRINT! FOR PUBLIC DOMAIN ETEXTS*Ver.04.29.93*END*~#
+
+<!pn!>
+
+CONTENTS
+    end
+  end
+end
+
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_kdissert.rb b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_kdissert.rb
new file mode 100644
index 00000000..87d371f2
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_kdissert.rb
@@ -0,0 +1,93 @@
+=begin
+ * Name: SiSU - Simple information Structuring Universe - Structured information, Serialized Units
+ * Author: Ralph Amissah
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+ * Description: Kdissert
+ * License: Same as SiSU see http://www.jus.uio.no/sisu
+ * Notes: Site default appearance variables set in defaults.rb
+     Generic site wide modifications set here scribe_skin.rb, and this file required by other "scribes" instead of defaults.rb
+=end
+module SiSU_Viz
+  require "#{SiSU_lib}/defaults"
+  class Skin
+    ##% path
+    #def path_root
+    #  './sisu/'  # the only parameter that cannot be changed here
+    #end
+    #def path_rel
+    #  '../'
+    #end
+    #% url
+    def url_home
+      'http://www.jus.uio.no/sisu'
+    end
+    def url_site                                                                     # used in pdf header
+      url_home
+    end
+    def url_txt                                                                      # text to go with url usually stripped url
+      'www.jus.uio.no/sisu'
+      url_home
+    end
+    def url_hp
+      'http://freehackers.org/~tnagy/kdissert'
+    end
+    def url_home_url
+      '../index.html'
+    end
+    #% color
+    def color_band1
+      '"#ffffff"'      
+    end
+    #% txt
+    def txt_hp
+    	'Kdissert, Document Mapping'
+    end
+    def txt_home                                                                     # this should be the name of the site eg. Lex Mercatoria or if you prefer to see a url the url in text form copy & ...
+      #"www.jus.uio.no/sisu/" 
+    	'SiSU (document prepared using Kdissert)'
+    end
+    #% icon
+    def icon_home_button
+      'kdissert.png'
+    end
+    def icon_home_banner
+      icon_home_button
+    end
+    #% banner
+    def banner_home_button
+		  %{<table border="0" summary="home button" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#000070"><a href="#{url_hp}/">#{png_home}</a></td></tr></table>\n}
+    end
+    def banner_home_and_index_buttons
+	    %{<table><tr><td width="20%"><table summary="home and index buttons" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#000070"><a href="#{url_hp}/" target="_top">#{png_home}</a>#{table_close}</td><td width="60%"><center><table summary="buttons" border="1" cellpadding="3" cellspacing="0"><tr><td align="center" bgcolor="#f1e8de"><font face="arial" size="2"><a href="toc" target="_top">&nbsp;This&nbsp;text&nbsp;sub-&nbsp;<br />&nbsp;Table&nbsp;of&nbsp;Contents&nbsp;</a></font>#{table_close}</center></td><td width="20%">&nbsp;#{table_close}}
+    end
+    def banner_band
+      %{<table summary="band" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#ffffff"><a href="#{url_hp}/" target="_top">#{png_home}</a>#{table_close}}
+    end
+    def banner_home_guide
+    end
+    #% credits
+    def credits_splash
+      %{<center><table summary="credits" align="center"bgcolor="#ffffff"><tr><td>#{widget_sisu}#{widget_wayBetter}#{widget_browsers}#{widget_pdfviewers}#{table_close}</center>}
+    end
+  end
+  class TeX
+    def header_center
+	    "\\chead{\\href{#{@vz.url_site}/}{www.jus.uio.no/sisu/}}"
+    end
+    def home_url
+	    "\\href{#{@vz.url_site}/}{www.fsf.org}"
+    end
+    def home
+	    "\\href{#{@vz.url_site}/}{Free Software Foundation}"
+    end
+    def owner_chapter
+      "Document owner details"
+    end
+  end
+  class Stamp
+    def stmp
+  	  "\\copyright Ralph Amissah to be released under the GPL (or QT License equivalent as to be decided) \\\\\n ralph@amissah.com \\\\\n www.jus.uio.no/sisu/"
+    end
+  end
+end
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_rms.rb b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_rms.rb
new file mode 100644
index 00000000..2ec6c841
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc/skin_rms.rb
@@ -0,0 +1,105 @@
+=begin
+ * Name: SiSU - Simple information Structuring Universe - Structured information, Serialized Units
+ * Author: Ralph Amissah
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+ * Description: Document skin used for Free as in Freedom 
+ * License: Same as SiSU see http://www.jus.uio.no/sisu
+ * Notes: Site default appearance variables set in defaults.rb
+     Generic site wide modifications set here scribe_skin.rb, and this file required by other "scribes" instead of defaults.rb
+=end
+module SiSU_Viz
+  require "#{SiSU_lib}/defaults"
+  class Skin
+    #% promo
+    def promo_promo
+      ['sisu_icon','sisu','sisu_search_libre','open_society','fsf','ruby']
+    end
+    ##% home
+    #def home_index
+    #end
+    #def home_toc
+    #end
+    ##% path
+    #def path_root                                                                     # the only parameter that cannot be changed here
+    #  './sisu/'
+    #end
+    #def path_rel
+    #  '../'
+    #end
+    #% url
+    def url_home
+      'http://www.gnu.org'
+    end
+    def url_site                                                                     # used in pdf header
+      'http://www.gnu.org'
+    end
+    def url_txt                                                                      # text to go with url usually stripped url
+      'www.gnu.org'
+    end
+    def url_home_url
+      '../index.html'
+    end
+    #def url_root_http
+      #root server path info, used in document information
+    #end
+    #% color
+    def color_band1
+      '"#cccccc"'      
+      #'"#000070"'      
+    end
+    #% txt
+    def txt_hp
+    	'Free as in Freedom'
+    end
+    def txt_home                                                                     # this should be the name of the site eg. Lex Mercatoria or if you prefer to see a url the url in text form copy & ...
+      #"www.jus.uio.no/sisu/" 
+    	'Free as in Freedom'
+    end
+    #% icon
+    def icon_home_button
+      'free_as_in_freedom.png'
+    end
+    def icon_home_banner
+      icon_home_button
+    end
+    #% banner
+    def banner_home_button
+		  %{<table summary="home button" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#cccccc"><a href="#{url_site}/">#{png_home}</a></td></tr></table>\n}
+    end
+    def banner_home_and_index_buttons
+	    %{<table><tr><td width="20%"><table summary="home and index buttons" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#cccccc"><a href="#{url_site}/" target="_top">#{png_home}</a>#{table_close}</td><td width="60%"><center><center><table summary="buttons" border="1" cellpadding="3" cellspacing="0"><tr><td align="center" bgcolor="#f1e8de"><font face="arial" size="2"><a href="toc" target="_top">&nbsp;This&nbsp;text&nbsp;sub-&nbsp;<br />&nbsp;Table&nbsp;of&nbsp;Contents&nbsp;</a></font>#{table_close}</center></center></td><td width="20%">&nbsp;#{table_close}}
+    end
+    def banner_band
+      %{<table summary="band" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#cccccc"><a href="#{url_site}/" target="_top">#{png_home}</a>#{table_close}}
+    end
+    def banner_home_guide
+    end
+    #% credits
+    def insert_levitating_gnu #used locally this skin only
+      %{<center><a href="http://www.fsf.org/"><img border="0" height="133" width="135" src="#{url_path_image_base}/levitating_gnu.png" alt="RMS/FSF - Levitating Gnu --&gt;" /></a></center>}
+    end
+    def credits_splash
+      %{<center><table summary="credits" align="center"bgcolor="#ffffff"><tr><td><font color="#666666">#{insert_levitating_gnu}#{widget_sisu}#{widget_wayBetter}#{widget_browsers}#{widget_pdfviewers}</font></center></td></tr></table></center>}
+    end
+  end
+  class TeX
+    def header_center
+	    "\\chead{\\href{#{@vz.url_site}/}{www.jus.uio.no/sisu/}}"
+    end
+    def home_url
+	    "\\href{#{@vz.url_site}/}{www.gnu.org}"
+    end
+    def home
+	    "\\href{#{@vz.url_site}/}{GNU - Free Software Foundation}"
+    end
+    def owner_chapter
+      "Document owner details"
+    end
+  end
+  class Stamp
+    def stmp
+  	  "\\copyright Ralph Amissah to be released under the GPL (or QT License equivalent as to be decided) \\\\\n ralph@amissah.com \\\\\n www.jus.uio.no/sisu/"
+    end
+  end
+end
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/site/skin_sisu.rb b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/site/skin_sisu.rb
new file mode 100644
index 00000000..66786cea
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/site/skin_sisu.rb
@@ -0,0 +1,105 @@
+=begin
+ * Name: SiSU information Structuring Universe - Structured information, Serialized Units
+ * Author: Ralph@Amissah.com
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+ * Description: Document skin for SiSU descriptive pages, ... 
+ * License: Same as SiSU see http://www.jus.uio.no/sisu
+ * Notes: Site default appearance variables set in defaults.rb
+     Generic site wide modifications set here scribe_skin.rb, and this file required by other "scribes" instead of defaults.rb
+=end
+module SiSU_Viz
+  require SiSU_lib + '/defaults'
+  class Skin
+    #% widget
+    def widget_search
+      true
+    end
+    def widget_promo
+#put  s "#{__LINE__} #{__FILE__}"
+      #['sisu','ruby','sisu_search_libre','ruby','open_society']
+    end
+    #% path
+    def path_root
+#puts "#{__LINE__} #{__FILE__}"
+      './sisu/'                                                                  # the only parameter that cannot be changed here
+    end
+    def path_rel
+#puts "#{__LINE__} #{__FILE__}"
+      '../'
+    end
+    #% url
+    def url_home
+#puts "#{__LINE__} #{__FILE__}"
+      'http://www.jus.uio.no/sisu/'
+    end
+    def url_site                                                                     # used in pdf header
+#puts "#{__LINE__} #{__FILE__}"
+      'http://www.jus.uio.no/sisu' 
+    end
+    def url_txt                                                                      # text to go with url usually stripped url
+#puts "#{__LINE__} #{__FILE__}"
+      'www.jus.uio.no/sisu/'
+    end
+    def url_home_url
+#puts "#{__LINE__} #{__FILE__}"
+      '../index.html'
+    end
+    #def url_root_http
+      #root server path info, used in document information
+    #end
+    #% color
+    def color_band1
+      '"#ffffff"'      
+    end
+    def color_band2
+      '"#ffffff"'
+    end
+    #% text
+    def text_hp
+    	'&nbsp;SiSU'
+    end
+    def text_home
+      'SiSU' 
+    end
+    #% icon
+    def icon_home_button
+      'sisu.png'
+    end
+    def icon_home_banner
+      icon_home_button
+    end
+    #% banner
+    def banner_home_button
+  	  %{<table summary="home button" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#ffffff"><a href="#{url_site}/">#{png_home}</a></td></tr></table>\n}
+    end
+    def banner_home_and_index_buttons
+      %{<table><tr><td width="20%"><table summary="home and index buttons" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#ffffff"><a href="#{url_site}/" target="_top">#{png_home}</a>#{table_close}</td><td width="60%"><center><center><table summary="buttons" border="1" cellpadding="3" cellspacing="0"><tr><td align="center" bgcolor="#ffffff"><font face="arial" size="2"><a href="toc" target="_top">&nbsp;This&nbsp;text&nbsp;sub-&nbsp;<br />&nbsp;Table&nbsp;of&nbsp;Contents&nbsp;</a></font>#{table_close}</center></center></td><td width="20%">&nbsp;#{table_close}}
+    end
+    def banner_band
+      %{<table summary="band" border="0" cellpadding="3" cellspacing="0"><tr><td align="left" bgcolor="#ffffff"><a href="#{url_site}/" target="_top">#{png_home}</a>#{table_close}}
+    end
+    #% credits
+    def credits_splash
+      %{<center><table summary="credits" align="center"bgcolor="#ffffff"><tr><td>#{widget_sisu}#{widget_wayBetter}#{widget_browsers}#{widget_pdfviewers}</td></tr></table></center>}
+    end
+    #% stamp
+    def stamp_stmp
+  	  "\\copyright Ralph Amissah, released under the GPL \\\\\n ralph@amissah.com \\\\\n www.jus.uio.no/sisu/"
+    end
+  end
+  class TeX
+    def header_center
+	    "\\chead{\\href{#{@vz.url_site}/}{www.jus.uio.no/sisu/}}"
+    end
+    def home_url
+	    "\\href{#{@vz.url_site}/}{www.jus.uio.no/sisu/}"
+    end
+    def home
+	    "\\href{#{@vz.url_site}/}{Ralph Amissah}"
+    end
+    def owner_chapter
+      'Document owner details'
+    end
+  end
+end
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/list.yml b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/list.yml
new file mode 100644
index 00000000..1deded88
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/list.yml
@@ -0,0 +1,23 @@
+sisu:
+  site:
+  - sisu
+open_society:
+  site:
+  - twon
+  - fc
+  - faif
+# - ffa
+  - catb
+sisu_icon:
+  site:
+  - sisu_icon
+fsf:
+  site:
+  - fsf
+gpl:
+  site:
+  - gpl
+sample_search:
+  search:
+  - sample
+
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/promo.yml b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/promo.yml
new file mode 100644
index 00000000..88497d41
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/promo.yml
@@ -0,0 +1,142 @@
+# Author: Ralph@Amissah.com
+site:
+  sisu_icon:
+    url:        SiSU
+    image:      sisu.png
+    blurb:      ~
+  sisu:
+    title:      SiSU
+    url:        index.html
+    blurb:      ~
+    links:
+    -
+      title:    What does SiSU do? Summary
+      url:      SiSU/1.html#summary
+    -
+      title:    SiSU Book Samples and Markup Examples
+      url:      SiSU/2.html
+    -
+      title:    SiSU Download
+      url:      SiSU/download.html
+    -
+      title:    SiSU Changelog
+      url:      SiSU/changelog.html
+      blurb:    ~
+    -
+      title:    Wikipedia entry
+      url:      http://en.wikipedia.org/wiki/SiSU
+      blurb:    ~
+    -
+      title:    Freshmeat
+      url:      http://freshmeat.net/projects/sisu/
+    -
+      title:    Ruby Application Archive
+      url:      http://raa.ruby-lang.org/project/sisu/
+  twon:
+    title:      The Wealth of Networks
+    subtitle:   How Social Production Transforms Markets and Freedom
+    author:     Yochai Benkler
+    year:       2006
+    url:        the_wealth_of_networks.yochai_benkler
+    links:
+    -
+      title:    Wikipedia entry
+      url:      http://en.wikipedia.org/wiki/The_Wealth_of_Networks
+    -
+      title:    Source Wiki
+      url:      http://www.benkler.org/wealth_of_networks/index.php/Main_Page
+  fc:
+    title:      Free Culture
+    subtitle:   How Big Media Uses Technology and the Law to Lock Down Culture and Control Creativity
+    author:     Lawrence Lessig
+    year:       2004
+    url:        free_culture.lawrence_lessig
+    links:
+    -
+      title:    Wikipedia entry
+      url:      http://en.wikipedia.org/wiki/Free_Culture_%28book%29
+    -
+      title:    Creative Commons
+      url:      http://creativecommons.org/
+    -
+      title:    Source
+      url:      http://www.free-culture.cc/
+  faif:
+    title:      Free As In Freedom
+    subtitle:   Richard Stallman's Crusade for Free Software
+    author:     Sam Williams
+    year:       2002
+    url:        free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams
+    links:
+    -
+      title:    Wikipedia entry
+      url:      http://en.wikipedia.org/wiki/Free_as_in_Freedom:_Richard_Stallman%27s_Crusade_for_Free_Software
+    -
+      title:    Source
+      url:      http://faifzilla.org/
+    -
+      title:    FSF
+      url:      http://www.fsf.org/
+    -
+      title:    FSF Wikipedia
+      url:      http://en.wikipedia.org/wiki/Free_Software_Foundation
+    -
+      title:    GPL
+      url:      http://www.gnu.org/copyleft/gpl.html
+    -
+      title:    GPL Wikipedia
+      url:      http://en.wikipedia.org/wiki/GNU_General_Public_License
+  ffa:
+    title:      Free For All
+    subtitle:   How Linux and the Free Software Movement Undercut the High Tech Titans
+    author:     Peter Wayner
+    year:       2002
+    url:        free_for_all.peter_wayner
+    links:
+    -
+      title:    Source
+      url:      http://www.wayner.org/books/ffa/
+  catb:
+    title:      The Cathedral & the Bazaar
+    subtitle:   Musings on Linux and Open Source by an Accidental Revolutionary
+    author:     Erik S. Raymond
+    year:       1999
+    url:        the_cathedral_and_the_bazaar.eric_s_raymond
+    links:
+    -
+      title:    Wikipedia entry
+      url:      http://en.wikipedia.org/wiki/Cathedral_and_the_bazaar
+    -
+      title:    Source
+      url:      http://www.catb.org/~esr/writings/cathedral-bazaar/cathedral-bazaar/
+  fsf:
+    title:      Free Software Foundation
+    subtitle:   FSF
+    url:        http://www.fsf.org/
+    links:
+    -
+      title:    Wikipedia entry
+      url:      http://en.wikipedia.org/wiki/Free_Software_Foundation
+    -
+      title:    GPL
+      subtitle: GNU General Public License
+      url:      http://www.gnu.org/copyleft/gpl.html
+  gpl:
+    title:      GNU General Public License
+    subtitle:   GPL
+    url:        http://www.gnu.org/copyleft/gpl.html
+    links:
+    -
+      title:   Wikipedia entry
+      url:     http://en.wikipedia.org/wiki/GNU_General_Public_License
+    -
+      title:    GPL 3
+      url:      http://gplv3.fsf.org/
+    -
+      title:    Software License List
+      url:      http://www.fsf.org/licensing/licenses/
+search:
+  sample:
+    action:    http://search.sisudoc.org
+    target:    _top
+    db:        sisu
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/skin_countries.yml b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/skin_countries.yml
new file mode 100644
index 00000000..a68903e1
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/skin_countries.yml
@@ -0,0 +1,482 @@
+# arch-tag: yaml country list 
+# Author: Ralph@Amissah.com
+# License: Same as SiSU see http://www.jus.uio.no/sisu
+id: AF
+  name: Afghanistan
+id: AL
+  name: Albania
+id: DZ
+  name: Algeria
+id: AS
+  name: American Samoa
+id: AD
+  name: Andorra
+id: AO
+  name: Angola
+id: AI
+  name: Anguilla
+id: AQ
+  name: Antarctica
+id: AG
+  name: Antigua and Barbuda
+id: AR
+  name: Argentina
+id: AM
+  name: Armenia
+id: AW
+  name: Aruba
+id: AU
+  name: Australia
+id: AT
+  name: Austria
+id: AZ
+  name: Azerbaijan
+id: BS
+  name: Bahamas
+id: BH
+  name: Bahrain
+id: BD
+  name: Bangladesh
+id: BB
+  name: Barbados
+id: BY
+  name: Belarus
+id: BE
+  name: Belgium
+id: BZ
+  name: Belize
+id: BJ
+  name: Benin
+id: BM
+  name: Bermuda
+id: BT
+  name: Bhutan
+id: BO
+  name: Bolivia
+id: BA
+  name: Bosnia and Herzegovina
+id: BW
+  name: Botswana
+id: BV
+  name: Bouvet Island
+id: BR
+  name: Brazil
+id: IO
+  name: British Indian Ocean Territory
+id: BN
+  name: Brunei Darussalam
+id: BG
+  name: Bulgaria
+id: BF
+  name: Burkina Faso
+id: BI
+  name: Burundi
+id: KH
+  name: Cambodia
+id: CM
+  name: Cameroon
+id: CA
+  name: Canada
+id: CV
+  name: Cape Verde
+id: KY
+  name: Cayman Islands
+id: CF
+  name: Central African Republic
+id: TD
+  name: Chad
+id: CL
+  name: Chile
+id: CN
+  name: China
+id: CX
+  name: Christmas Island
+id: CC
+  name: Cocos (Keeling) Islands
+id: CO
+  name: Colombia
+id: KM
+  name: Comoros
+id: CG
+  name: Congo
+id: CK
+  name: Cook Islands
+id: CR
+  name: Costa Rica
+id: HR
+  name: Croatia (Hrvatska)
+id: CU
+  name: Cuba
+id: CY
+  name: Cyprus
+id: CZ
+  name: Czech Republic
+id: CS
+  name: Czechoslovakia
+id: DK
+  name: Denmark
+id: DJ
+  name: Djibouti
+id: DM
+  name: Dominica
+id: DO
+  name: Dominican Republic
+id: TP
+  name: East Timor
+id: EC
+  name: Ecuador
+id: EG
+  name: Egypt
+id: SV
+  name: El Salvador
+id: GQ
+  name: Equatorial Guinea
+id: ER
+  name: Eritrea
+id: EE
+  name: Estonia
+id: ET
+  name: Ethiopia
+id: FK
+  name: Falkland Islands (Malvinas)
+id: FO
+  name: Faroe Islands
+id: FJ
+  name: Fiji
+id: FI
+  name: Finland
+id: FR
+  name: France
+id: FX
+  name: France, Metroplitan
+id: GF
+  name: French Guiana
+id: PF
+  name: French Polynesia
+id: TF
+  name: French Southern Territories
+id: GA
+  name: Gabon
+id: GM
+  name: Gambia
+id: GE
+  name: Georgia
+id: DE
+  name: Germany
+id: GH
+  name: Ghana
+id: GI
+  name: Gibraltar
+id: GB
+  name: Great Britain (UK)
+id: GR
+  name: Greece
+id: GL
+  name: Greenland
+id: GD
+  name: Grenada
+id: GP
+  name: Guadeloupe
+id: GU
+  name: Guam
+id: GT
+  name: Guatemala
+id: GN
+  name: Guinea
+id: GW
+  name: Guinea-Bissau
+id: GY
+  name: Guyana
+id: HT
+  name: Haiti
+id: HM
+  name: Heard and McDonald Islands
+id: HN
+  name: Honduras
+id: HK
+  name: Hong Kong
+id: HU
+  name: Hungary
+id: IS
+  name: Iceland
+id: IN
+  name: India
+id: ID
+  name: Indonesia
+id: IR
+  name: Iran
+id: IQ
+  name: Iraq
+id: IE
+  name: Ireland
+id: IL
+  name: Israel
+id: IT
+  name: Italy
+id: CI
+  name: Ivory Coast
+id: JM
+  name: Jamaica
+id: JP
+  name: Japan
+id: JO
+  name: Jordan
+id: KZ
+  name: Kazakhstan
+id: KE
+  name: Kenya
+id: KI
+  name: Kiribati
+id: KP
+  name: Korea (North)
+id: KR
+  name: Korea (South)
+id: KW
+  name: Kuwait
+id: KG
+  name: Kyrgyzstan
+id: LA
+  name: Laos
+id: LV
+  name: Latvia
+id: LB
+  name: Lebanon
+id: LS
+  name: Lesotho
+id: LR
+  name: Liberia
+id: LY
+  name: Libya
+id: LI
+  name: Liechtenstein
+id: LT
+  name: Lithuania
+id: LU
+  name: Luxembourg
+id: MO
+  name: Macau
+id: ME
+  name: Macedonia
+id: MG
+  name: Madagascar
+id: MW
+  name: Malawi
+id: MY
+  name: Malaysia
+id: MV
+  name: Maldives
+id: ML
+  name: Mali
+id: MT
+  name: Malta
+id: MB
+  name: Marshall Islands
+id: MQ
+  name: Martinique
+id: MR
+  name: Mauritania
+id: MU
+  name: Mauritius
+id: YT
+  name: Mayotte
+id: MX
+  name: Mexico
+id: FM
+  name: Micronesia
+id: MD
+  name: Moldova
+id: MC
+  name: Monaco
+id: MN
+  name: Mongolia
+id: MS
+  name: Montserrat
+id: MA
+  name: Morocco
+id: MZ
+  name: Mozambique
+id: MM
+  name: Myanmar
+id: NA
+  name: Namibia
+id: NR
+  name: Nauru
+id: NP
+  name: Nepal
+id: NL
+  name: Netherlands
+id: AN
+  name: Netherlands Antilles
+id: NT
+  name: Neutral Zone
+id: NC
+  name: New Caledonia
+id: NZ
+  name: New Zealand (Aotearoa)
+id: NI
+  name: Nicaragua
+id: NE
+  name: Niger
+id: NG
+  name: Nigeria
+id: NU
+  name: Niue
+id: NF
+  name: Norfolk Island
+id: MP
+  name: Northern Mariana Islands
+id: NO
+  name: Norway
+id: OM
+  name: Oman
+id: 00
+  name: Other
+id: PK
+  name: Pakistan
+id: PW
+  name: Palau
+id: PA
+  name: Panama
+id: PG
+  name: Papua New Guinea
+id: PY
+  name: Paraguay
+id: PE
+  name: Peru
+id: PH
+  name: Philippines
+id: PN
+  name: Pitcairn
+id: PL
+  name: Poland
+id: PT
+  name: Portugal
+id: PR
+  name: Puerto Rico
+id: QA
+  name: Qatar
+id: RE
+  name: Reunion
+id: RO
+  name: Romania
+id: RU
+  name: Russian Federation
+id: RW
+  name: Rwanda
+id: GS
+  name: S. Georgia and S. Sandwich Isls.
+id: KN
+  name: Saint Kitts and Nevis
+id: LC
+  name: Saint Lucia
+id: VC
+  name: Saint Vincent and the Grenadines
+id: WS
+  name: Samoa
+id: SM
+  name: San Marino
+id: ST
+  name: Sao Tome and Principe
+id: SA
+  name: Saudi Arabia
+id: SN
+  name: Senegal
+id: SC
+  name: Seychelles
+id: SL
+  name: Sierra Leone
+id: SG
+  name: Singapore
+id: SK
+  name: Slovak Republic
+id: SI
+  name: Slovenia
+id: SB
+  name: Solomon Islands
+id: SO
+  name: Somalia
+id: ZA
+  name: South Africa
+id: ES
+  name: Spain
+id: LK
+  name: Sri Lanka
+id: SH
+  name: St. Helena
+id: PM
+  name: St. Pierre and Miquelon
+id: SD
+  name: Sudan
+id: SR
+  name: Suriname
+id: SJ
+  name: Svalbard and Jan Mayen Islands
+id: SZ
+  name: Swaziland
+id: SE
+  name: Sweden
+id: CH
+  name: Switzerland
+id: SY
+  name: Syria
+id: TW
+  name: Taiwan
+id: TJ
+  name: Tajikistan
+id: TZ
+  name: Tanzania
+id: TH
+  name: Thailand
+id: TG
+  name: Togo
+id: TK
+  name: Tokelau
+id: TO
+  name: Tonga
+id: TT
+  name: Trinidad and Tobago
+id: TN
+  name: Tunisia
+id: TR
+  name: Turkey
+id: TM
+  name: Turkmenistan
+id: TC
+  name: Turks and Caicos Islands
+id: TV
+  name: Tuvalu
+id: UM
+  name: US Minor Outlying Islands
+id: SU
+  name: USSR (former)
+id: UG
+  name: Uganda
+id: UA
+  name: Ukraine
+id: AE
+  name: United Arab Emirates
+id: UK
+  name: United Kingdom
+id: US
+  name: United States
+id: UY
+  name: Uruguay
+id: UZ
+  name: Uzbekistan
+id: VU
+  name: Vanuatu
+id: VA
+  name: Vatican City State (Holy See)
+id: VE
+  name: Venezuela
+id: VN
+  name: Viet Nam
+id: VG
+  name: Virgin Islands (British)
+id: VI
+  name: Virgin Islands (U.S.)
+id: WF
+  name: Wallis and Futuna Islands
+id: EH
+  name: Western Sahara
+
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/skin_country.yml b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/skin_country.yml
new file mode 100644
index 00000000..ebaf8ace
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml/skin_country.yml
@@ -0,0 +1,735 @@
+# arch-tag: yaml country list array 
+# Author: Ralph@Amissah.com
+# License: Same as SiSU see http://www.jus.uio.no/sisu
+-
+  - AF
+  - Afghanistan
+-
+  - AL
+  - Albania
+-
+  - DZ
+  - Algeria
+-
+  - AS
+  - American Samoa
+-
+  - AD
+  - Andorra
+-
+  - AO
+  - Angola
+-
+  - AI
+  - Anguilla
+-
+  - AQ
+  - Antarctica
+-
+  - AG
+  - Antigua and Barbuda
+-
+  - AR
+  - Argentina
+-
+  - AM
+  - Armenia
+-
+  - AW
+  - Aruba
+-
+  - AU
+  - Australia
+-
+  - AT
+  - Austria
+-
+  - AZ
+  - Azerbaijan
+-
+  - BS
+  - Bahamas
+-
+  - BH
+  - Bahrain
+-
+  - BD
+  - Bangladesh
+-
+  - BB
+  - Barbados
+-
+  - BY
+  - Belarus
+-
+  - BE
+  - Belgium
+-
+  - BZ
+  - Belize
+-
+  - BJ
+  - Benin
+-
+  - BM
+  - Bermuda
+-
+  - BT
+  - Bhutan
+-
+  - BO
+  - Bolivia
+-
+  - BA
+  - Bosnia and Herzegovina
+-
+  - BW
+  - Botswana
+-
+  - BV
+  - Bouvet Island
+-
+  - BR
+  - Brazil
+-
+  - IO
+  - British Indian Ocean Territory
+-
+  - BN
+  - Brunei Darussalam
+-
+  - BG
+  - Bulgaria
+-
+  - BF
+  - Burkina Faso
+-
+  - BI
+  - Burundi
+-
+  - KH
+  - Cambodia
+-
+  - CM
+  - Cameroon
+-
+  - CA
+  - Canada
+-
+  - CV
+  - Cape Verde
+-
+  - KY
+  - Cayman Islands
+-
+  - CF
+  - Central African Republic
+-
+  - TD
+  - Chad
+-
+  - CL
+  - Chile
+-
+  - CN
+  - China
+-
+  - CX
+  - Christmas Island
+-
+  - CC
+  - Cocos (Keeling) Islands
+-
+  - CO
+  - Colombia
+-
+  - KM
+  - Comoros
+-
+  - CG
+  - Congo
+-
+  - CK
+  - Cook Islands
+-
+  - CR
+  - Costa Rica
+-
+  - HR
+  - Croatia (Hrvatska)
+-
+  - CU
+  - Cuba
+-
+  - CY
+  - Cyprus
+-
+  - CZ
+  - Czech Republic
+-
+  - CS
+  - Czechoslovakia (former)
+-
+  - DK
+  - Denmark
+-
+  - DJ
+  - Djibouti
+-
+  - DM
+  - Dominica
+-
+  - DO
+  - Dominican Republic
+-
+  - TP
+  - East Timor
+-
+  - EC
+  - Ecuador
+-
+  - EG
+  - Egypt
+-
+  - SV
+  - El Salvador
+-
+  - GQ
+  - Equatorial Guinea
+-
+  - ER
+  - Eritrea
+-
+  - EE
+  - Estonia
+-
+  - ET
+  - Ethiopia
+-
+  - FK
+  - Falkland Islands (Malvinas)
+-
+  - FO
+  - Faroe Islands
+-
+  - FJ
+  - Fiji
+-
+  - FI
+  - Finland
+-
+  - FR
+  - France
+-
+  - FX
+  - France, Metropolitan
+-
+  - GF
+  - French Guiana
+-
+  - PF
+  - French Polynesia
+-
+  - TF
+  - French Southern Territories
+-
+  - GA
+  - Gabon
+-
+  - GM
+  - Gambia
+-
+  - GE
+  - Georgia
+-
+  - DE
+  - Germany
+-
+  - GH
+  - Ghana
+-
+  - GI
+  - Gibraltar
+-
+  - GB
+  - Great Britain (UK)
+-
+  - GR
+  - Greece
+-
+  - GL
+  - Greenland
+-
+  - GD
+  - Grenada
+-
+  - GP
+  - Guadeloupe
+-
+  - GU
+  - Guam
+-
+  - GT
+  - Guatemala
+-
+  - GN
+  - Guinea
+-
+  - GW
+  - Guinea-Bissau
+-
+  - GY
+  - Guyana
+-
+  - HT
+  - Haiti
+-
+  - HM
+  - Heard and McDonald Islands
+-
+  - HN
+  - Honduras
+-
+  - HK
+  - Hong Kong
+-
+  - HU
+  - Hungary
+-
+  - IS
+  - Iceland
+-
+  - IN
+  - India
+-
+  - ID
+  - Indonesia
+-
+  - IR
+  - Iran
+-
+  - IQ
+  - Iraq
+-
+  - IE
+  - Ireland
+-
+  - IL
+  - Israel
+-
+  - IT
+  - Italy
+-
+  - CI
+  - Ivory Coast
+-
+  - JM
+  - Jamaica
+-
+  - JP
+  - Japan
+-
+  - JO
+  - Jordan
+-
+  - KZ
+  - Kazakhstan
+-
+  - KE
+  - Kenya
+-
+  - KI
+  - Kiribati
+-
+  - KP
+  - Korea (North)
+-
+  - KR
+  - Korea (South)
+-
+  - KW
+  - Kuwait
+-
+  - KG
+  - Kyrgyzstan
+-
+  - LA
+  - Laos
+-
+  - LV
+  - Latvia
+-
+  - LB
+  - Lebanon
+-
+  - LS
+  - Lesotho
+-
+  - LR
+  - Liberia
+-
+  - LY
+  - Libya
+-
+  - LI
+  - Liechtenstein
+-
+  - LT
+  - Lithuania
+-
+  - LU
+  - Luxembourg
+-
+  - MO
+  - Macau
+-
+  - ME
+  - Macedonia
+-
+  - MG
+  - Madagascar
+-
+  - MW
+  - Malawi
+-
+  - MY
+  - Malaysia
+-
+  - MV
+  - Maldives
+-
+  - ML
+  - Mali
+-
+  - MT
+  - Malta
+-
+  - MB
+  - Marshall Islands
+-
+  - MQ
+  - Martinique
+-
+  - MR
+  - Mauritania
+-
+  - MU
+  - Mauritius
+-
+  - YT
+  - Mayotte
+-
+  - MX
+  - Mexico
+-
+  - FM
+  - Micronesia
+-
+  - MD
+  - Moldova
+-
+  - MC
+  - Monaco
+-
+  - MN
+  - Mongolia
+-
+  - MS
+  - Montserrat
+-
+  - MA
+  - Morocco
+-
+  - MZ
+  - Mozambique
+-
+  - MM
+  - Myanmar
+-
+  - NA
+  - Namibia
+-
+  - NR
+  - Nauru
+-
+  - NP
+  - Nepal
+-
+  - NL
+  - Netherlands
+-
+  - AN
+  - Netherlands Antilles
+-
+  - NT
+  - Neutral Zone
+-
+  - NC
+  - New Caledonia
+-
+  - NZ
+  - New Zealand (Aotearoa)
+-
+  - NI
+  - Nicaragua
+-
+  - NE
+  - Niger
+-
+  - NG
+  - Nigeria
+-
+  - NU
+  - Niue
+-
+  - NF
+  - Norfolk Island
+-
+  - MP
+  - Northern Mariana Islands
+-
+  - 'NO'
+  - Norway
+-
+  - OM
+  - Oman
+-
+  - '00'
+  - Other
+-
+  - PK
+  - Pakistan
+-
+  - PW
+  - Palau
+-
+  - PA
+  - Panama
+-
+  - PG
+  - Papua New Guinea
+-
+  - PY
+  - Paraguay
+-
+  - PE
+  - Peru
+-
+  - PH
+  - Philippines
+-
+  - PN
+  - Pitcairn
+-
+  - PL
+  - Poland
+-
+  - PT
+  - Portugal
+-
+  - PR
+  - Puerto Rico
+-
+  - QA
+  - Qatar
+-
+  - RE
+  - Reunion
+-
+  - RO
+  - Romania
+-
+  - RU
+  - Russian Federation
+-
+  - RW
+  - Rwanda
+-
+  - GS
+  - S. Georgia and S. Sandwich Isls.
+-
+  - KN
+  - Saint Kitts and Nevis
+-
+  - LC
+  - Saint Lucia
+-
+  - VC
+  - Saint Vincent and the Grenadines
+-
+  - WS
+  - Samoa
+-
+  - SM
+  - San Marino
+-
+  - ST
+  - Sao Tome and Principe
+-
+  - SA
+  - Saudi Arabia
+-
+  - SN
+  - Senegal
+-
+  - SC
+  - Seychelles
+-
+  - SL
+  - Sierra Leone
+-
+  - SG
+  - Singapore
+-
+  - SK
+  - Slovak Republic
+-
+  - SI
+  - Slovenia
+-
+  - SB
+  - Solomon Islands
+-
+  - SO
+  - Somalia
+-
+  - ZA
+  - South Africa
+-
+  - ES
+  - Spain
+-
+  - LK
+  - Sri Lanka
+-
+  - SH
+  - St. Helena
+-
+  - PM
+  - St. Pierre and Miquelon
+-
+  - SD
+  - Sudan
+-
+  - SR
+  - Suriname
+-
+  - SJ
+  - Svalbard and Jan Mayen Islands
+-
+  - SZ
+  - Swaziland
+-
+  - SE
+  - Sweden
+-
+  - CH
+  - Switzerland
+-
+  - SY
+  - Syria
+-
+  - TW
+  - Taiwan
+-
+  - TJ
+  - Tajikistan
+-
+  - TZ
+  - Tanzania
+-
+  - TH
+  - Thailand
+-
+  - TG
+  - Togo
+-
+  - TK
+  - Tokelau
+-
+  - TO
+  - Tonga
+-
+  - TT
+  - Trinidad and Tobago
+-
+  - TN
+  - Tunisia
+-
+  - TR
+  - Turkey
+-
+  - TM
+  - Turkmenistan
+-
+  - TC
+  - Turks and Caicos Islands
+-
+  - TV
+  - Tuvalu
+-
+  - UM
+  - US Minor Outlying Islands
+-
+  - SU
+  - USSR (former)
+-
+  - UG
+  - Uganda
+-
+  - UA
+  - Ukraine
+-
+  - AE
+  - United Arab Emirates
+-
+  - UK
+  - United Kingdom
+-
+  - US
+  - United States
+-
+  - UY
+  - Uruguay
+-
+  - UZ
+  - Uzbekistan
+-
+  - VU
+  - Vanuatu
+-
+  - VA
+  - Vatican City State (Holy See)
+-
+  - VE
+  - Venezuela
+-
+  - VN
+  - Viet Nam
+-
+  - VG
+  - Virgin Islands (British)
+-
+  - VI
+  - Virgin Islands (U.S.)
+-
+  - WF
+  - Wallis and Futuna Islands
+-
+  - EH
+  - Western Sahara
+-
+  - YE
+  - Yemen
+-
+  - YU
+  - Yugoslavia
+-
+  - ZR
+  - Zaire
+-
+  - ZM
+  - Zambia
+-
+  - ZW
+  - Zimbabwe
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst b/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
new file mode 100644
index 00000000..23cad62a
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
@@ -0,0 +1,2074 @@
+% SiSU 0.38
+
+@title: Free as in Freedom
+
+@subtitle: Richard Stallman's Crusade for Free Software
+
+@author: Sam Williams
+
+@rights: Copyright Sam Williams 2002, published under the GNU Free Documentation License. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Document License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being no invariant sections, with the Front-Cover Texts being no invariant sections, and with the Back-Cover Texts being no invariant sections. A copy of the license is included in Appendix C, GNU Free Documentation License. All images are to be included verbatim when the document is copied, distributed, or modified under the terms of the GFDL.
+
+@language: US
+
+@notes: March 2002
+
+% @catalogue: isbn=0596002874
+
+@links: { Home and Source }http://faifzilla.org/
+{Free as in Freedom (on Richard Stallman), Sam Williams @ SiSU}http://www.jus.uio.no/sisu/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams
+{@ Wikipedia}http://en.wikipedia.org/wiki/Free_as_in_Freedom:_Richard_Stallman%27s_Crusade_for_Free_Software
+{@ Amazon.com}http://www.amazon.com/gp/product/0596002874
+{@ Barnes & Noble}http://search.barnesandnoble.com/booksearch/isbnInquiry.asp?isbn=0596002874
+{The Wealth of Networks, Yochai Benkler @ SiSU}http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler
+{Free For All, Peter Wayner @ SiSU}http://www.jus.uio.no/sisu/free_for_all.peter_wayner
+{Free Culture, Lawrence Lessig @ SiSU}http://www.jus.uio.no/sisu/free_culture.lawrence_lessig
+{The Cathedral and the Bazaar, Eric S. Raymond @ SiSU }http://www.jus.uio.no/sisu/the_cathedral_and_the_bazaar.eric_s_raymond
+
+@skin: skin_rms
+
+@images: center
+
+@level: new=:A,:B,:C,1
+
+% @promo: sisu_icon, sample_search, fsf, open_society, sisu
+
+:A~ Free as in Freedom
+
+:B~ Richard Stallman's Crusade for Free Software
+
+:C~ By Sam Williams
+
+1~preface Preface
+
+The work of Richard M. Stallman literally speaks for itself. From the documented source code to the published papers to the recorded speeches, few people have expressed as much willingness to lay their thoughts and their work on the line.
+
+Such openness-if one can pardon a momentary un-Stallman adjective-is refreshing. After all, we live in a society that treats information, especially personal information, as a valuable commodity. The question quickly arises. Why would anybody want to part with so much information and yet appear to demand nothing in return?
+
+As we shall see in later chapters, Stallman does not part with his words or his work altruistically. Every program, speech, and on-the-record bon mot comes with a price, albeit not the kind of price most people are used to paying.
+
+I bring this up not as a warning, but as an admission. As a person who has spent the last year digging up facts on Stallman's personal history, it's more than a little intimidating going up against the Stallman oeuvre. "Never pick a fight with a man who buys his ink by the barrel," goes the old Mark Twain adage. In the case of Stallman, never attempt the definitive biography of a man who trusts his every thought to the public record.
+
+For the readers who have decided to trust a few hours of their time to exploring this book, I can confidently state that there are facts and quotes in here that one won't find in any Slashdot story or Google search. Gaining access to these facts involves paying a price, however. In the case of the book version, you can pay for these facts the traditional manner, i.e., by purchasing the book. In the case of the electronic versions, you can pay for these facts in the free software manner. Thanks to the folks at O'Reilly & Associates, this book is being distributed under the GNU Free Documentation License, meaning you can help to improve the work or create a personalized version and release that version under the same license.
+
+If you are reading an electronic version and prefer to accept the latter payment option, that is, if you want to improve or expand this book for future readers, I welcome your input. Starting in June, 2002, I will be publishing a bare bones HTML version of the book on the web site, http://www.faifzilla.org. My aim is to update it regularly and expand the Free as in Freedom story as events warrant. If you choose to take the latter course, please review Appendix C of this book. It provides a copy of your rights under the GNU Free Documentation License.
+
+For those who just plan to sit back and read, online or elsewhere, I consider your attention an equally valuable form of payment. Don't be surprised, though, if you, too, find yourself looking for other ways to reward the good will that made this work possible.
+
+One final note: this is a work of journalism, but it is also a work of technical documentation. In the process of writing and editing this book, the editors and I have weighed the comments and factual input of various participants in the story, including Richard Stallman himself. We realize there are many technical details in this story that may benefit from additional or refined information. As this book is released under the GFDL, we are accepting patches just like we would with any free software program. Accepted changes will be posted electronically and will eventually be incorporated into future printed versions of this work. If you would like to contribute to the further improvement of this book, you can reach me at sam@inow.com
+
+2~ Comments and Questions
+
+Please address comments and questions concerning this book to the publisher:
+
+poem{
+
+    O'Reilly & Associates, Inc.
+    1005 Gravenstein Highway North
+    Sebastopol, CA 95472
+    (800) 998-9938 (in the United States or Canada)
+    (707) 829-0515 (international/local)
+    (707) 829-0104 (fax)
+
+}poem
+
+There is a web page for this book, which lists errata, examples, or any additional information. The site also includes a link to a forum where you can discuss the book with the author and other readers. You can access this site at:
+
+_1 http://www.oreilly.com/catalog/freedom/
+
+To comment or ask technical questions about this book, send email to:
+
+_1 bookquestions@oreilly.com
+
+For more information about books, conferences, Resource Centers, and the O'Reilly Network, see the O'Reilly web site at:
+
+_1 http://www.oreilly.com
+
+2~ Acknowledgments
+
+Special thanks to Henning Gutmann for sticking by this book. Special thanks to Aaron Oas for suggesting the idea to Tracy in the first place. Thanks to Laurie Petrycki, Jeffrey Holcomb, and all the others at O'Reilly & Associates. Thanks to Tim O'Reilly for backing this book. Thanks to all the first-draft reviewers: Bruce Perens, Eric Raymond, Eric Allman, Jon Orwant, Julie and Gerald Jay Sussman, Hal Abelson, and Guy Steele. I hope you enjoy this typo-free version. Thanks to Alice Lippman for the interviews, cookies, and photographs. Thanks to my family, Steve, Jane, Tish, and Dave. And finally, last but not least: thanks to Richard Stallman for having the guts and endurance to "show us the code."
+
+Sam Williams
+
+1~ Chapter 1 - For Want of a Printer
+
+I fear the Greeks. Even when they bring gifts.
+---Virgil
+The Aeneid
+
+The new printer was jammed, again.
+
+Richard M. Stallman, a staff software programmer at the Massachusetts Institute of Technology's Artificial Intelligence Laboratory (AI Lab), discovered the malfunction the hard way. An hour after sending off a 50-page file to the office laser printer, Stallman, 27, broke off a productive work session to retrieve his documents. Upon arrival, he found only four pages in the printer's tray. To make matters even more frustrating, the four pages belonged to another user, meaning that Stallman's print job and the unfinished portion of somebody else's print job were still trapped somewhere within the electrical plumbing of the lab's computer network.
+
+Waiting for machines is an occupational hazard when you're a software programmer, so Stallman took his frustration with a grain of salt. Still, the difference between waiting for a machine and waiting on a machine is a sizable one. It wasn't the first time he'd been forced to stand over the printer, watching pages print out one by one. As a person who spent the bulk of his days and nights improving the efficiency of machines and the software programs that controlled them, Stallman felt a natural urge to open up the machine, look at the guts, and seek out the root of the problem.
+
+Unfortunately, Stallman's skills as a computer programmer did not extend to the mechanical-engineering realm. As freshly printed documents poured out of the machine, Stallman had a chance to reflect on other ways to circumvent the printing jam problem.
+
+How long ago had it been that the staff members at the AI Lab had welcomed the new printer with open arms? Stallman wondered. The machine had been a donation from the Xerox Corporation. A cutting edge prototype, it was a modified version of the popular Xerox photocopier. Only instead of making copies, it relied on software data piped in over a computer network to turn that data into professional-looking documents. Created by engineers at the world-famous Xerox Palo Alto Research Facility, it was, quite simply, an early taste of the desktop-printing revolution that would seize the rest of the computing industry by the end of the decade.
+
+Driven by an instinctual urge to play with the best new equipment, programmers at the AI Lab promptly integrated the new machine into the lab's sophisticated computing infrastructure. The results had been immediately pleasing. Unlike the lab's old laser printer, the new Xerox machine was fast. Pages came flying out at a rate of one per second, turning a 20-minute print job into a 2-minute print job. The new machine was also more precise. Circles came out looking like circles, not ovals. Straight lines came out looking like straight lines, not low-amplitude sine waves.
+
+It was, for all intents and purposes, a gift too good to refuse.
+
+It wasn't until a few weeks after its arrival that the machine's flaws began to surface. Chief among the drawbacks was the machine's inherent susceptibility to paper jams. Engineering-minded programmers quickly understood the reason behind the flaw. As a photocopier, the machine generally required the direct oversight of a human operator. Figuring that these human operators would always be on hand to fix a paper jam, if it occurred, Xerox engineers had devoted their time and energies to eliminating other pesky problems. In engineering terms, user diligence was built into the system.
+
+In modifying the machine for printer use, Xerox engineers had changed the user-machine relationship in a subtle but profound way. Instead of making the machine subservient to an individual human operator, they made it subservient to an entire networked population of human operators. Instead of standing directly over the machine, a human user on one end of the network sent his print command through an extended bucket-brigade of machines, expecting the desired content to arrive at the targeted destination and in proper form. It wasn't until he finally went to check up on the final output that he realized how little of the desired content had made it through.
+
+Stallman himself had been of the first to identify the problem and the first to suggest a remedy. Years before, when the lab was still using its old printer, Stallman had solved a similar problem by opening up the software program that regulated the printer on the lab's PDP-11 machine. Stallman couldn't eliminate paper jams, but he could insert a software command that ordered the PDP-11 to check the printer periodically and report back to the PDP-10, the lab's central computer. To ensure that one user's negligence didn't bog down an entire line of print jobs, Stallman also inserted a software command that instructed the PDP-10 to notify every user with a waiting print job that the printer was jammed. The notice was simple, something along the lines of "The printer is jammed, please fix it," and because it went out to the people with the most pressing need to fix the problem, chances were higher that the problem got fixed in due time.
+
+As fixes go, Stallman's was oblique but elegant. It didn't fix the mechanical side of the problem, but it did the next best thing by closing the information loop between user and machine. Thanks to a few additional lines of software code, AI Lab employees could eliminate the 10 or 15 minutes wasted each week in running back and forth to check on the printer. In programming terms, Stallman's fix took advantage of the amplified intelligence of the overall network.
+
+"If you got that message, you couldn't assume somebody else would fix it," says Stallman, recalling the logic. "You had to go to the printer. A minute or two after the printer got in trouble, the two or three people who got messages arrive to fix the machine. Of those two or three people, one of them, at least, would usually know how to fix the problem."
+
+Such clever fixes were a trademark of the AI Lab and its indigenous population of programmers. Indeed, the best programmers at the AI Lab disdained the term programmer, preferring the more slangy occupational title of hacker instead. The job title covered a host of activities-everything from creative mirth making to the improvement of existing software and computer systems. Implicit within the title, however, was the old-fashioned notion of Yankee ingenuity. To be a hacker, one had to accept the philosophy that writing a software program was only the beginning. Improving a program was the true test of a hacker's skills.~{ For more on the term "hacker," see **Appendix B. }~
+
+Such a philosophy was a major reason why companies like Xerox made it a policy to donate their machines and software programs to places where hackers typically congregated. If hackers improved the software, companies could borrow back the improvements, incorporating them into update versions for the commercial marketplace. In corporate terms, hackers were a leveragable community asset, an auxiliary research-and-development division available at minimal cost.
+
+It was because of this give-and-take philosophy that when Stallman spotted the print-jam defect in the Xerox laser printer, he didn't panic. He simply looked for a way to update the old fix or " hack" for the new system. In the course of looking up the Xerox laser-printer software, however, Stallman made a troubling discovery. The printer didn't have any software, at least nothing Stallman or a fellow programmer could read. Until then, most companies had made it a form of courtesy to publish source-code files-readable text files that documented the individual software commands that told a machine what to do. Xerox, in this instance, had provided software files in precompiled, or binary, form. Programmers were free to open the files up if they wanted to, but unless they were an expert in deciphering an endless stream of ones and zeroes, the resulting text was pure gibberish.
+
+Although Stallman knew plenty about computers, he was not an expert in translating binary files. As a hacker, however, he had other resources at his disposal. The notion of information sharing was so central to the hacker culture that Stallman knew it was only a matter of time before some hacker in some university lab or corporate computer room proffered a version of the laser-printer source code with the desired source-code files.
+
+After the first few printer jams, Stallman comforted himself with the memory of a similar situation years before. The lab had needed a cross-network program to help the PDP-11 work more efficiently with the PDP-10. The lab's hackers were more than up to the task, but Stallman, a Harvard alumnus, recalled a similar program written by programmers at the Harvard computer-science department. The Harvard computer lab used the same model computer, the PDP-10, albeit with a different operating system. The Harvard computer lab also had a policy requiring that all programs installed on the PDP-10 had to come with published source-code files.
+
+Taking advantage of his access to the Harvard computer lab, Stallman dropped in, made a copy of the cross-network source code, and brought it back to the AI Lab. He then rewrote the source code to make it more suitable for the AI Lab's operating system. With no muss and little fuss, the AI Lab shored up a major gap in its software infrastructure. Stallman even added a few features not found in the original Harvard program, making the program even more useful. "We wound up using it for several years," Stallman says.
+
+From the perspective of a 1970s-era programmer, the transaction was the software equivalent of a neighbor stopping by to borrow a power tool or a cup of sugar from a neighbor. The only difference was that in borrowing a copy of the software for the AI Lab, Stallman had done nothing to deprive Harvard hackers the use of their original program. If anything, Harvard hackers gained in the process, because Stallman had introduced his own additional features to the program, features that hackers at Harvard were perfectly free to borrow in return. Although nobody at Harvard ever came over to borrow the program back, Stallman does recall a programmer at the private engineering firm, Bolt, Beranek & Newman, borrowing the program and adding a few additional features, which Stallman eventually reintegrated into the AI Lab's own source-code archive.
+
+"A program would develop the way a city develops," says Stallman, recalling the software infrastructure of the AI Lab. "Parts would get replaced and rebuilt. New things would get added on. But you could always look at a certain part and say, `Hmm, by the style, I see this part was written back in the early 60s and this part was written in the mid-1970s.'"
+
+Through this simple system of intellectual accretion, hackers at the AI Lab and other places built up robust creations. On the west coast, computer scientists at UC Berkeley, working in cooperation with a few low-level engineers at AT&T, had built up an entire operating system using this system. Dubbed Unix, a play on an older, more academically respectable operating system called Multics, the software system was available to any programmer willing to pay for the cost of copying the program onto a new magnetic tape and shipping it. Not every programmer participating in this culture described himself as a hacker, but most shared the sentiments of Richard M. Stallman. If a program or software fix was good enough to solve your problems, it was good enough to solve somebody else's problems. Why not share it out of a simple desire for good karma?
+
+The fact that Xerox had been unwilling to share its source-code files seemed a minor annoyance at first. In tracking down a copy of the source-code files, Stallman says he didn't even bother contacting Xerox. "They had already given us the laser printer," Stallman says. "Why should I bug them for more?"
+
+When the desired files failed to surface, however, Stallman began to grow suspicious. The year before, Stallman had experienced a blow up with a doctoral student at Carnegie Mellon University. The student, Brian Reid, was the author of a useful text-formatting program dubbed Scribe. One of the first programs that gave a user the power to define fonts and type styles when sending a document over a computer network, the program was an early harbinger of HTML, the lingua franca of the World Wide Web. In 1979, Reid made the decision to sell Scribe to a Pittsburgh-area software company called Unilogic. His graduate-student career ending, Reid says he simply was looking for a way to unload the program on a set of developers that would take pains to keep it from slipping into the public domain. To sweeten the deal, Reid also agreed to insert a set of time-dependent functions- "time bombs" in software-programmer parlance-that deactivated freely copied versions of the program after a 90-day expiration date. To avoid deactivation, users paid the software company, which then issued a code that defused the internal time-bomb feature.
+
+For Reid, the deal was a win-win. Scribe didn't fall into the public domain, and Unilogic recouped on its investment. For Stallman, it was a betrayal of the programmer ethos, pure and simple. Instead of honoring the notion of share-and-share alike, Reid had inserted a way for companies to compel programmers to pay for information access.
+
+As the weeks passed and his attempts to track down Xerox laser-printer source code hit a brick wall, Stallman began to sense a similar money-for-code scenario at work. Before Stallman could do or say anything about it, however, good news finally trickled in via the programmer grapevine. Word had it that a scientist at the computer-science department at Carnegie Mellon University had just departed a job at the Xerox Palo Alto Research Center. Not only had the scientist worked on the laser printer in question, but according to rumor, he was still working on it as part of his research duties at Carnegie Mellon.
+
+Casting aside his initial suspicion, Stallman made a firm resolution to seek out the person in question during his next visit to the Carnegie Mellon campus.
+
+He didn't have to wait long. Carnegie Mellon also had a lab specializing in artificial-intelligence research, and within a few months, Stallman had a business-related reason to visit the Carnegie Mellon campus. During that visit, he made sure to stop by the computer-science department. Department employees directed him to the office of the faculty member leading the Xerox project. When Stallman reached the office, he found the professor working there.
+
+In true engineer-to-engineer fashion, the conversation was cordial but blunt. After briefly introducing himself as a visitor from MIT, Stallman requested a copy of the laser-printer source code so that he could port it to the PDP-11. To his surprise, the professor refused to grant his request.
+
+"He told me that he had promised not to give me a copy," Stallman says.
+
+Memory is a funny thing. Twenty years after the fact, Stallman's mental history tape is notoriously blank in places. Not only does he not remember the motivating reason for the trip or even the time of year during which he took it, he also has no recollection of the professor or doctoral student on the other end of the conversation. According to Reid, the person most likely to have fielded Stallman's request is Robert Sproull, a former Xerox PARC researcher and current director of Sun Laboratories, a research division of the computer-technology conglomerate Sun Microsystems. During the 1970s, Sproull had been the primary developer of the laser-printer software in question while at Xerox PARC. Around 1980, Sproull took a faculty research position at Carnegie Mellon where he continued his laser-printer work amid other projects.
+
+"The code that Stallman was asking for was leading-edge state-of-the-art code that Sproull had written in the year or so before going to Carnegie Mellon," recalls Reid. "I suspect that Sproull had been at Carnegie Mellon less than a month before this request came in."
+
+When asked directly about the request, however, Sproull draws a blank. "I can't make a factual comment," writes Sproull via email. "I have absolutely no recollection of the incident."
+
+With both participants in the brief conversation struggling to recall key details-including whether the conversation even took place-it's hard to gauge the bluntness of Sproull's refusal, at least as recalled by Stallman. In talking to audiences, Stallman has made repeated reference to the incident, noting that Sproull's unwillingness to hand over the source code stemmed from a nondisclosure agreement, a contractual agreement between Sproull and the Xerox Corporation giving Sproull, or any other signatory, access the software source code in exchange for a promise of secrecy. Now a standard item of business in the software industry, the nondisclosure agreement, or NDA, was a novel development at the time, a reflection of both the commercial value of the laser printer to Xerox and the information needed to run it. "Xerox was at the time trying to make a commercial product out of the laser printer," recalls Reid. "They would have been insane to give away the source code."
+
+For Stallman, however, the NDA was something else entirely. It was a refusal on the part of Xerox and Sproull, or whomever the person was that turned down his source-code request that day, to participate in a system that, until then, had encouraged software programmers to regard programs as communal resources. Like a peasant whose centuries-old irrigation ditch had grown suddenly dry, Stallman had followed the ditch to its source only to find a brand-spanking-new hydroelectric dam bearing the Xerox logo.
+
+For Stallman, the realization that Xerox had compelled a fellow programmer to participate in this newfangled system of compelled secrecy took a while to sink in. At first, all he could focus on was the personal nature of the refusal. As a person who felt awkward and out of sync in most face-to-face encounters, Stallman's attempt to drop in on a fellow programmer unannounced had been intended as a demonstration of neighborliness. Now that the request had been refused, it felt like a major blunder. "I was so angry I couldn't think of a way to express it. So I just turned away and walked out without another word," Stallman recalls. "I might have slammed the door. Who knows? All I remember is wanting to get out of there."
+
+Twenty years after the fact, the anger still lingers, so much so that Stallman has elevated the event into a major turning point. Within the next few months, a series of events would befall both Stallman and the AI Lab hacker community that would make 30 seconds worth of tension in a remote Carnegie Mellon office seem trivial by comparison. Nevertheless, when it comes time to sort out the events that would transform Stallman from a lone hacker, instinctively suspicious of centralized authority, to a crusading activist applying traditional notions of liberty, equality, and fraternity to the world of software development, Stallman singles out the Carnegie Mellon encounter for special attention.
+
+"It encouraged me to think about something that I'd already been thinking about," says Stallman. "I already had an idea that software should be shared, but I wasn't sure how to think about that. My thoughts weren't clear and organized to the point where I could express them in a concise fashion to the rest of the world."
+
+Although previous events had raised Stallman's ire, he says it wasn't until his Carnegie Mellon encounter that he realized the events were beginning to intrude on a culture he had long considered sacrosanct. As an elite programmer at one of the world's elite institutions, Stallman had been perfectly willing to ignore the compromises and bargains of his fellow programmers just so long as they didn't interfere with his own work. Until the arrival of the Xerox laser printer, Stallman had been content to look down on the machines and programs other computer users grimly tolerated. On the rare occasion that such a program breached the AI Lab's walls-when the lab replaced its venerable Incompatible Time Sharing operating system with a commercial variant, the TOPS 20, for example-Stallman and his hacker colleagues had been free to rewrite, reshape, and rename the software according to personal taste.
+
+Now that the laser printer had insinuated itself within the AI Lab's network, however, something had changed. The machine worked fine, barring the occasional paper jam, but the ability to modify according to personal taste had disappeared. From the viewpoint of the entire software industry, the printer was a wake-up call. Software had become such a valuable asset that companies no longer felt the need to publicize source code, especially when publication meant giving potential competitors a chance to duplicate something cheaply. From Stallman's viewpoint, the printer was a Trojan Horse. After a decade of failure, privately owned software-future hackers would use the term " proprietary" software-had gained a foothold inside the AI Lab through the sneakiest of methods. It had come disguised as a gift.
+
+That Xerox had offered some programmers access to additional gifts in exchange for secrecy was also galling, but Stallman takes pains to note that, if presented with such a quid pro quo bargain at a younger age, he just might have taken the Xerox Corporation up on its offer. The awkwardness of the Carnegie Mellon encounter, however, had a firming effect on Stallman's own moral lassitude. Not only did it give him the necessary anger to view all future entreaties with suspicion, it also forced him to ask the uncomfortable question: what if a fellow hacker dropped into Stallman's office someday and it suddenly became Stallman's job to refuse the hacker's request for source code?
+
+"It was my first encounter with a nondisclosure agreement, and it immediately taught me that nondisclosure agreements have victims," says Stallman, firmly. "In this case I was the victim. [My lab and I] were victims."
+
+It was a lesson Stallman would carry with him through the tumultuous years of the 1980s, a decade during which many of his MIT colleagues would depart the AI Lab and sign nondisclosure agreements of their own. Because most nondisclosure aggreements (NDAs) had expiration dates, few hackers who did sign them saw little need for personal introspection. Sooner or later, they reasoned, the software would become public knowledge. In the meantime, promising to keep the software secret during its earliest development stages was all a part of the compromise deal that allowed hackers to work on the best projects. For Stallman, however, it was the first step down a slippery slope.
+
+"When somebody invited me to betray all my colleagues in that way, I remembered how angry I was when somebody else had done that to me and my whole lab," Stallman says. "So I said, `Thank you very much for offering me this nice software package, but I can't accept it on the conditions that you're asking for, so I'm going to do without it.'"
+
+As Stallman would quickly learn, refusing such requests involved more than personal sacrifice. It involved segregating himself from fellow hackers who, though sharing a similar distaste for secrecy, tended to express that distaste in a more morally flexible fashion. It wasn't long before Stallman, increasingly an outcast even within the AI Lab, began billing himself as "the last true hacker," isolating himself further and further from a marketplace dominated by proprietary software. Refusing another's request for source code, Stallman decided, was not only a betrayal of the scientific mission that had nurtured software development since the end of World War II, it was a violation of the Golden Rule, the baseline moral dictate to do unto others as you would have them do unto you.
+
+Hence the importance of the laser printer and the encounter that resulted from it. Without it, Stallman says, his life might have followed a more ordinary path, one balancing the riches of a commercial programmer with the ultimate frustration of a life spent writing invisible software code. There would have been no sense of clarity, no urgency to address a problem others weren't addressing. Most importantly, there would have been no righteous anger, an emotion that, as we soon shall see, has propelled Stallman's career as surely as any political ideology or ethical belief.
+
+"From that day forward, I decided this was something I could never participate in," says Stallman, alluding to the practice of trading personal liberty for the sake of convenience-Stallman's description of the NDA bargain-as well as the overall culture that encouraged such ethically suspect deal-making in the first place. "I decided never to make other people victims just like I had been a victim."
+
+1~ Chapter 2 - 2001: A Hacker's Odyssey
+
+The New York University computer-science department sits inside Warren Weaver Hall, a fortress-like building located two blocks east of Washington Square Park. Industrial-strength air-conditioning vents create a surrounding moat of hot air, discouraging loiterers and solicitors alike. Visitors who breach the moat encounter another formidable barrier, a security check-in counter immediately inside the building's single entryway.
+
+Beyond the security checkpoint, the atmosphere relaxes somewhat. Still, numerous signs scattered throughout the first floor preach the dangers of unsecured doors and propped-open fire exits. Taken as a whole, the signs offer a reminder: even in the relatively tranquil confines of pre-September 11, 2001, New York, one can never be too careful or too suspicious.
+
+The signs offer an interesting thematic counterpoint to the growing number of visitors gathering in the hall's interior atrium. A few look like NYU students. Most look like shaggy-aired concert-goers milling outside a music hall in anticipation of the main act. For one brief morning, the masses have taken over Warren Weaver Hall, leaving the nearby security attendant with nothing better to do but watch Ricki Lake on TV and shrug her shoulders toward the nearby auditorium whenever visitors ask about "the speech."
+
+Once inside the auditorium, a visitor finds the person who has forced this temporary shutdown of building security procedures. The person is Richard M. Stallman, founder of the GNU Project, original president of the Free Software Foundation, winner of the 1990 MacArthur Fellowship, winner of the Association of Computing Machinery's Grace Murray Hopper Award (also in 1990), corecipient of the Takeda Foundation's 2001 Takeda Award, and former AI Lab hacker. As announced over a host of hacker-related web sites, including the GNU Project's own http://www.gnu.org site, Stallman is in Manhattan, his former hometown, to deliver a much anticipated speech in rebuttal to the Microsoft Corporation's recent campaign against the GNU General Public License.
+
+The subject of Stallman's speech is the history and future of the free software movement. The location is significant. Less than a month before, Microsoft senior vice president Craig Mundie appeared at the nearby NYU Stern School of Business, delivering a speech blasting the General Public License, or GPL, a legal device originally conceived by Stallman 16 years before. Built to counteract the growing wave of software secrecy overtaking the computer industry-a wave first noticed by Stallman during his 1980 troubles with the Xerox laser printer-the GPL has evolved into a central tool of the free software community. In simplest terms, the GPL locks software programs into a form of communal ownership-what today's legal scholars now call the "digital commons"-through the legal weight of copyright. Once locked, programs remain unremovable. Derivative versions must carry the same copyright protection-even derivative versions that bear only a small snippet of the original source code. For this reason, some within the software industry have taken to calling the GPL a "viral" license, because it spreads itself to every software program it touches.~{ Actually, the GPL's powers are not quite that potent. According to section 10 of the GNU General Public License, Version 2 (1991), the viral nature of the license depends heavily on the Free Software Foundation's willingness to view a program as a derivative work, not to mention the existing license the GPL would replace.<br>If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software that is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.<br>"To compare something to a virus is very harsh," says Stallman. "A spider plant is a more accurate comparison; it goes to another place if you actively take a cutting."<br>For more information on the GNU General Public License, visit http://www.gnu.org/copyleft/gpl.html }~
+
+In an information economy increasingly dependent on software and increasingly beholden to software standards, the GPL has become the proverbial "big stick." Even companies that once laughed it off as software socialism have come around to recognize the benefits. Linux, the Unix-like kernel developed by Finnish college student Linus Torvalds in 1991, is licensed under the GPL, as are many of the world's most popular programming tools: GNU Emacs, the GNU Debugger, the GNU C Compiler, etc. Together, these tools form the components of a free software operating system developed, nurtured, and owned by the worldwide hacker community. Instead of viewing this community as a threat, high-tech companies like IBM, Hewlett Packard, and Sun Microsystems have come to rely upon it, selling software applications and services built to ride atop the ever-growing free software infrastructure.
+
+They've also come to rely upon it as a strategic weapon in the hacker community's perennial war against Microsoft, the Redmond, Washington-based company that, for better or worse, has dominated the PC-software marketplace since the late 1980s. As owner of the popular Windows operating system, Microsoft stands to lose the most in an industry-wide shift to the GPL license. Almost every line of source code in the Windows colossus is protected by copyrights reaffirming the private nature of the underlying source code or, at the very least, reaffirming Microsoft's legal ability to treat it as such. From the Microsoft viewpoint, incorporating programs protected by the "viral" GPL into the Windows colossus would be the software equivalent of Superman downing a bottle of Kryptonite pills. Rival companies could suddenly copy, modify, and sell improved versions of Windows, rendering the company's indomitable position as the No. 1 provider of consumer-oriented software instantly vulnerable. Hence the company's growing concern over the GPL's rate of adoption. Hence the recent Mundie speech blasting the GPL and the " open source" approach to software development and sales. And hence Stallman's decision to deliver a public rebuttal to that speech on the same campus here today.
+
+20 years is a long time in the software industry. Consider this: in 1980, when Richard Stallman was cursing the AI Lab's Xerox laser printer, Microsoft, the company modern hackers view as the most powerful force in the worldwide software industry, was still a privately held startup. IBM, the company hackers used to regard as the most powerful force in the worldwide software industry, had yet to to introduce its first personal computer, thereby igniting the current low-cost PC market. Many of the technologies we now take for granted-the World Wide Web, satellite television, 32-bit video-game consoles-didn't even exist. The same goes for many of the companies that now fill the upper echelons of the corporate establishment, companies like AOL, Sun Microsystems, Amazon.com, Compaq, and Dell. The list goes on and on.
+
+The fact that the high-technology marketplace has come so far in such little time is fuel for both sides of the GPL debate. GPL-proponents point to the short lifespan of most computer hardware platforms. Facing the risk of buying an obsolete product, consumers tend to flock to companies with the best long-term survival. As a result, the software marketplace has become a winner-take-all arena.~{ See Shubha Ghosh, "Revealing the Microsoft Windows Source Code," Gigalaw.com (January, 2000).<br> http://www.gigalaw.com/articles/ghosh-2000-01-p1.html }~ The current, privately owned software environment, GPL-proponents say, leads to monopoly abuse and stagnation. Strong companies suck all the oxygen out of the marketplace for rival competitors and innovative startups.
+
+GPL-opponents argue just the opposite. Selling software is just as risky, if not more risky, than buying software, they say. Without the legal guarantees provided by private software licenses, not to mention the economic prospects of a privately owned "killer app" (i.e., a breakthrough technology that launches an entirely new market),~{ Killer apps don't have to be proprietary. Witness, of course, the legendary Mosaic browser, a program whose copyright permits noncommercial derivatives with certain restrictions. Still, I think the reader gets the point: the software marketplace is like the lottery. The bigger the potential payoff, the more people want to participate. For a good summary of the killer-app phenomenon, see Philip Ben-David, "Whatever Happened to the `Killer App'?" e-Commerce News (December 7, 2000).<br> http://www.ecommercetimes.com/perl/story/5893.html }~ companies lose the incentive to participate. Once again, the market stagnates and innovation declines. As Mundie himself noted in his May 3 address on the same campus, the GPL's "viral" nature "poses a threat" to any company that relies on the uniqueness of its software as a competitive asset. Added Mundie:
+
+_1 It also fundamentally undermines the independent commercial software sector because it effectively makes it impossible to distribute software on a basis where recipients pay for the product rather than just the cost of distribution.~{ See Craig Mundie, "The Commercial Software Model," senior vice president, Microsoft Corp. Excerpted from an online transcript of Mundie's May 3, 2001, speech to the New York University Stern School of Business.<br> http://www.microsoft.com/presspass/exec/craig/05-03sharedsource.asp }~
+
+The mutual success of GNU/ Linux, the amalgamated operating system built around the GPL-protected Linux kernel, and Windows over the last 10 years reveals the wisdom of both perspectives. Nevertheless, the battle for momentum is an important one in the software industry. Even powerful vendors such as Microsoft rely on the support of third-party software developers whose tools, programs, and computer games make an underlying software platform such as Windows more attractive to the mainstream consumer. Citing the rapid evolution of the technology marketplace over the last 20 years, not to mention his own company's admirable track record during that period, Mundie advised listeners to not get too carried away by the free software movement's recent momentum:
+
+_1 Two decades of experience have shown that an economic model that protects intellectual property and a business model that recoups research and development costs can create impressive economic benefits and distribute them very broadly. ^5^
+
+Such admonitions serve as the backdrop for Stallman's speech today. Less than a month after their utterance, Stallman stands with his back to one of the chalk boards at the front of the room, edgy to begin.
+
+If the last two decades have brought dramatic changes to the software marketplace, they have brought even more dramatic changes to Stallman himself. Gone is the skinny, clean-shaven hacker who once spent his entire days communing with his beloved PDP-10. In his place stands a heavy-set middle-aged man with long hair and rabbinical beard, a man who now spends the bulk of his time writing and answering email, haranguing fellow programmers, and giving speeches like the one today. Dressed in an aqua-colored T-shirt and brown polyester pants, Stallman looks like a desert hermit who just stepped out of a Salvation Army dressing room.
+
+The crowd is filled with visitors who share Stallman's fashion and grooming tastes. Many come bearing laptop computers and cellular modems, all the better to record and transmit Stallman's words to a waiting Internet audience. The gender ratio is roughly 15 males to 1 female, and 1 of the 7 or 8 females in the room comes in bearing a stuffed penguin, the official Linux mascot, while another carries a stuffed teddy bear.
+
+{free_as_in_freedom_01_rms.png 381x321 "Richard Stallman, circa 2000. 'I decided I would develop a free software operating system or die trying ... of old age of course.' Photo courtesy of http://www.stallman.org " }http://www.free-culture.cc/
+
+Agitated, Stallman leaves his post at the front of the room and takes a seat in a front-row chair, tapping a few commands into an already-opened laptop. For the next 10 minutes Stallman is oblivious to the growing number of students, professors, and fans circulating in front of him at the foot of the auditorium stage.
+
+Before the speech can begin, the baroque rituals of academic formality must be observed. Stallman's appearance merits not one but two introductions. Mike Uretsky, codirector of the Stern School's Center for Advanced Technology, provides the first.
+
+"The role of a university is to foster debate and to have interesting discussions," Uretsky says. "This particular presentation, this seminar falls right into that mold. I find the discussion of open source particularly interesting."
+
+Before Uretsky can get another sentence out, Stallman is on his feet waving him down like a stranded motorist.
+
+"I do free software," Stallman says to rising laughter. "Open source is a different movement."
+
+The laughter gives way to applause. The room is stocked with Stallman partisans, people who know of his reputation for verbal exactitude, not to mention his much publicized 1998 falling out with the open source software proponents. Most have come to anticipate such outbursts the same way radio fans once waited for Jack Benny's trademark, "Now cut that out!" phrase during each radio program.
+
+Uretsky hastily finishes his introduction and cedes the stage to Edmond Schonberg, a professor in the NYU computer-science department. As a computer programmer and GNU Project contributor, Schonberg knows which linguistic land mines to avoid. He deftly summarizes Stallman's career from the perspective of a modern-day programmer.
+
+"Richard is the perfect example of somebody who, by acting locally, started thinking globally [about] problems concerning the unavailability of source code," says Schonberg. "He has developed a coherent philosophy that has forced all of us to reexamine our ideas of how software is produced, of what intellectual property means, and of what the software community actually represents."
+
+Schonberg welcomes Stallman to more applause. Stallman takes a moment to shut off his laptop, rises out of his chair, and takes the stage.
+
+At first, Stallman's address seems more Catskills comedy routine than political speech. "I'd like to thank Microsoft for providing me the opportunity to be on this platform," Stallman wisecracks. "For the past few weeks, I have felt like an author whose book was fortuitously banned somewhere."
+
+For the uninitiated, Stallman dives into a quick free software warm-up analogy. He likens a software program to a cooking recipe. Both provide useful step-by-step instructions on how to complete a desired task and can be easily modified if a user has special desires or circumstances. "You don't have to follow a recipe exactly," Stallman notes. "You can leave out some ingredients. Add some mushrooms, 'cause you like mushrooms. Put in less salt because your doctor said you should cut down on salt-whatever."
+
+Most importantly, Stallman says, software programs and recipes are both easy to share. In giving a recipe to a dinner guest, a cook loses little more than time and the cost of the paper the recipe was written on. Software programs require even less, usually a few mouse-clicks and a modicum of electricity. In both instances, however, the person giving the information gains two things: increased friendship and the ability to borrow interesting recipes in return.
+
+"Imagine what it would be like if recipes were packaged inside black boxes," Stallman says, shifting gears. "You couldn't see what ingredients they're using, let alone change them, and imagine if you made a copy for a friend. They would call you a pirate and try to put you in prison for years. That world would create tremendous outrage from all the people who are used to sharing recipes. But that is exactly what the world of proprietary software is like. A world in which common decency towards other people is prohibited or prevented."
+
+With this introductory analogy out of the way, Stallman launches into a retelling of the Xerox laser-printer episode. Like the recipe analogy, the laser-printer story is a useful rhetorical device. With its parable-like structure, it dramatizes just how quickly things can change in the software world. Drawing listeners back to an era before Amazon.com one-click shopping, Microsoft Windows, and Oracle databases, it asks the listener to examine the notion of software ownership free of its current corporate logos.
+
+Stallman delivers the story with all the polish and practice of a local district attorney conducting a closing argument. When he gets to the part about the Carnegie Mellon professor refusing to lend him a copy of the printer source code, Stallman pauses.
+
+"He had betrayed us," Stallman says. "But he didn't just do it to us. Chances are he did it to you."
+
+On the word "you," Stallman points his index finger accusingly at an unsuspecting member of the audience. The targeted audience member's eyebrows flinch slightly, but Stallman's own eyes have moved on. Slowly and deliberately, Stallman picks out a second listener to nervous titters from the crowd. "And I think, mostly likely, he did it to you, too," he says, pointing at an audience member three rows behind the first.
+
+By the time Stallman has a third audience member picked out, the titters have given away to general laughter. The gesture seems a bit staged, because it is. Still, when it comes time to wrap up the Xerox laser-printer story, Stallman does so with a showman's flourish. "He probably did it to most of the people here in this room-except a few, maybe, who weren't born yet in 1980," Stallman says, drawing more laughs. "[That's] because he had promised to refuse to cooperate with just about the entire population of the planet Earth."
+
+Stallman lets the comment sink in for a half-beat. "He had signed a nondisclosure agreement," Stallman adds.
+
+Richard Matthew Stallman's rise from frustrated academic to political leader over the last 20 years speaks to many things. It speaks to Stallman's stubborn nature and prodigious will. It speaks to the clearly articulated vision and values of the free software movement Stallman helped build. It speaks to the high-quality software programs Stallman has built, programs that have cemented Stallman's reputation as a programming legend. It speaks to the growing momentum of the GPL, a legal innovation that many Stallman observers see as his most momentous accomplishment.
+
+Most importantly, it speaks to the changing nature of political power in a world increasingly beholden to computer technology and the software programs that power that technology.
+
+Maybe that's why, even at a time when most high-technology stars are on the wane, Stallman's star has grown. Since launching the GNU Project in 1984,~{ The acronym GNU stands for "GNU's not Unix." In another portion of the May 29, 2001, NYU speech, Stallman summed up the acronym's origin:<br>_1 We hackers always look for a funny or naughty name for a program, because naming a program is half the fun of writing the program. We also had a tradition of recursive acronyms, to say that the program that you're writing is similar to some existing program . . . I looked for a recursive acronym for Something Is Not UNIX. And I tried all 26 letters and discovered that none of them was a word. I decided to make it a contraction. That way I could have a three-letter acronym, for Something's Not UNIX. And I tried letters, and I came across the word "GNU." That was it.<br>_1 Although a fan of puns, Stallman recommends that software users pronounce the "g" at the beginning of the acronym (i.e., "gah-new"). Not only does this avoid confusion with the word "gnu," the name of the African antelope, Connochaetes gnou, it also avoids confusion with the adjective "new." "We've been working on it for 17 years now, so it is not exactly new any more," Stallman says.<br>Source: author notes and online transcript of "Free Software: Freedom and Cooperation," Richard Stallman's May 29, 2001, speech at New York University.<br> http://www.gnu.org/events/rms-nyu-2001-transcript.txt }~ Stallman has been at turns ignored, satirized, vilified, and attacked-both from within and without the free software movement. Through it all, the GNU Project has managed to meet its milestones, albeit with a few notorious delays, and stay relevant in a software marketplace several orders of magnitude more complex than the one it entered 18 years ago. So too has the free software ideology, an ideology meticulously groomed by Stallman himself.
+
+To understand the reasons behind this currency, it helps to examine Richard Stallman both in his own words and in the words of the people who have collaborated and battled with him along the way. The Richard Stallman character sketch is not a complicated one. If any person exemplifies the old adage "what you see is what you get," it's Stallman.
+
+"I think if you want to understand Richard Stallman the human being, you really need to see all of the parts as a consistent whole," advises Eben Moglen, legal counsel to the Free Software Foundation and professor of law at Columbia University Law School. "All those personal eccentricities that lots of people see as obstacles to getting to know Stallman really are Stallman: Richard's strong sense of personal frustration, his enormous sense of principled ethical commitment, his inability to compromise, especially on issues he considers fundamental. These are all the very reasons Richard did what he did when he did."
+
+Explaining how a journey that started with a laser printer would eventually lead to a sparring match with the world's richest corporation is no easy task. It requires a thoughtful examination of the forces that have made software ownership so important in today's society. It also requires a thoughtful examination of a man who, like many political leaders before him, understands the malleability of human memory. It requires an ability to interpret the myths and politically laden code words that have built up around Stallman over time. Finally, it requires an understanding of Stallman's genius as a programmer and his failures and successes in translating that genius to other pursuits.
+
+When it comes to offering his own summary of the journey, Stallman acknowledges the fusion of personality and principle observed by Moglen. "Stubbornness is my strong suit," he says. "Most people who attempt to do anything of any great difficulty eventually get discouraged and give up. I never gave up."
+
+He also credits blind chance. Had it not been for that run-in over the Xerox laser printer, had it not been for the personal and political conflicts that closed out his career as an MIT employee, had it not been for a half dozen other timely factors, Stallman finds it very easy to picture his life following a different career path. That being said, Stallman gives thanks to the forces and circumstances that put him in the position to make a difference.
+
+"I had just the right skills," says Stallman, summing up his decision for launching the GNU Project to the audience. "Nobody was there but me, so I felt like, `I'm elected. I have to work on this. If not me , who?'"
+
+1~ Chapter 3 - A Portrait of the Hacker as a Young Man
+
+Richard Stallman's mother, Alice Lippman, still remembers the moment she realized her son had a special gift.
+
+"I think it was when he was eight," Lippman recalls.
+
+The year was 1961, and Lippman, a recently divorced single mother, was wiling away a weekend afternoon within the family's tiny one-bedroom apartment on Manhattan's Upper West Side. Leafing through a copy of Scientific American, Lippman came upon her favorite section, the Martin Gardner-authored column titled "Mathematical Games." A substitute art teacher, Lippman always enjoyed Gardner's column for the brain-teasers it provided. With her son already ensconced in a book on the nearby sofa, Lippman decided to take a crack at solving the week's feature puzzle.
+
+"I wasn't the best person when it came to solving the puzzles," she admits. "But as an artist, I found they really helped me work through conceptual barriers."
+
+Lippman says her attempt to solve the puzzle met an immediate brick wall. About to throw the magazine down in disgust, Lippman was surprised by a gentle tug on her shirt sleeve.
+
+"It was Richard," she recalls, "He wanted to know if I needed any help."
+
+Looking back and forth, between the puzzle and her son, Lippman says she initially regarded the offer with skepticism. "I asked Richard if he'd read the magazine," she says. "He told me that, yes, he had and what's more he'd already solved the puzzle. The next thing I know, he starts explaining to me how to solve it."
+
+Hearing the logic of her son's approach, Lippman's skepticism quickly gave way to incredulity. "I mean, I always knew he was a bright boy," she says, "but this was the first time I'd seen anything that suggested how advanced he really was."
+
+Thirty years after the fact, Lippman punctuates the memory with a laugh. "To tell you the truth, I don't think I ever figured out how to solve that puzzle," she says. "All I remember is being amazed he knew the answer."
+
+Seated at the dining-room table of her second Manhattan apartment-the same spacious three-bedroom complex she and her son moved to following her 1967 marriage to Maurice Lippman, now deceased-Alice Lippman exudes a Jewish mother's mixture of pride and bemusement when recalling her son's early years. The nearby dining-room credenza offers an eight-by-ten photo of Stallman glowering in full beard and doctoral robes. The image dwarfs accompanying photos of Lippman's nieces and nephews, but before a visitor can make too much of it, Lippman makes sure to balance its prominent placement with an ironic wisecrack.
+
+"Richard insisted I have it after he received his honorary doctorate at the University of Glasgow," says Lippman. "He said to me, `Guess what, mom? It's the first graduation I ever attended.'"~{ See Michael Gross, "Richard Stallman: High School Misfit, Symbol of Free Software, MacArthur-certified Genius" (1999). This interview is one of the most candid Stallman interviews on the record. I recommend it highly.<br> http://www.mgross.com/interviews/stallman1.html }~
+
+Such comments reflect the sense of humor that comes with raising a child prodigy. Make no mistake, for every story Lippman hears and reads about her son's stubbornness and unusual behavior, she can deliver at least a dozen in return.
+
+"He used to be so conservative," she says, throwing up her hands in mock exasperation. "We used to have the worst arguments right here at this table. I was part of the first group of public city school teachers that struck to form a union, and Richard was very angry with me. He saw unions as corrupt. He was also very opposed to social security. He thought people could make much more money investing it on their own. Who knew that within 10 years he would become so idealistic? All I remember is his stepsister coming to me and saying, `What is he going to be when he grows up? A fascist?'"
+
+As a single parent for nearly a decade-she and Richard's father, Daniel Stallman, were married in 1948, divorced in 1958, and split custody of their son afterwards-Lippman can attest to her son's aversion to authority. She can also attest to her son's lust for knowledge. It was during the times when the two forces intertwined, Lippman says, that she and her son experienced their biggest battles.
+
+"It was like he never wanted to eat," says Lippman, recalling the behavior pattern that set in around age eight and didn't let up until her son's high-school graduation in 1970. "I'd call him for dinner, and he'd never hear me. I'd have to call him 9 or 10 times just to get his attention. He was totally immersed."
+
+Stallman, for his part, remembers things in a similar fashion, albeit with a political twist.
+
+"I enjoyed reading," he says. "If I wanted to read, and my mother told me to go to the kitchen and eat or go to sleep, I wasn't going to listen. I saw no reason why I couldn't read. No reason why she should be able to tell me what to do, period. Essentially, what I had read about, ideas such as democracy and individual freedom, I applied to myself. I didn't see any reason to exclude children from these principles."
+
+The belief in individual freedom over arbitrary authority extended to school as well. Two years ahead of his classmates by age 11, Stallman endured all the usual frustrations of a gifted public-school student. It wasn't long after the puzzle incident that his mother attended the first in what would become a long string of parent-teacher conferences.
+
+"He absolutely refused to write papers," says Lippman, recalling an early controversy. "I think the last paper he wrote before his senior year in high school was an essay on the history of the number system in the west for a fourth-grade teacher."
+
+Gifted in anything that required analytical thinking, Stallman gravitated toward math and science at the expense of his other studies. What some teachers saw as single-mindedness, however, Lippman saw as impatience. Math and science offered simply too much opportunity to learn, especially in comparison to subjects and pursuits for which her son seemed less naturally inclined. Around age 10 or 11, when the boys in Stallman's class began playing a regular game of touch football, she remembers her son coming home in a rage. "He wanted to play so badly, but he just didn't have the coordination skills," Lippman recalls. "It made him so angry."
+
+The anger eventually drove her son to focus on math and science all the more. Even in the realm of science, however, her son's impatience could be problematic. Poring through calculus textbooks by age seven, Stallman saw little need to dumb down his discourse for adults. Sometime, during his middle-school years, Lippman hired a student from nearby Columbia University to play big brother to her son. The student left the family's apartment after the first session and never came back. "I think what Richard was talking about went over his head," Lippman speculates.
+
+Another favorite maternal anecdote dates back to the early 1960s, shortly after the puzzle incident. Around age seven, two years after the divorce and relocation from Queens, Richard took up the hobby of launching model rockets in nearby Riverside Drive Park. What started as aimless fun soon took on an earnest edge as her son began recording the data from each launch. Like the interest in mathematical games, the pursuit drew little attention until one day, just before a major NASA launch, Lippman checked in on her son to see if he wanted to watch.
+
+"He was fuming," Lippman says. "All he could say to me was, `But I'm not published yet.' Apparently he had something that he really wanted to show NASA."
+
+Such anecdotes offer early evidence of the intensity that would become Stallman's chief trademark throughout life. When other kids came to the table, Stallman stayed in his room and read. When other kids played Johnny Unitas, Stallman played Werner von Braun. "I was weird," Stallman says, summing up his early years succinctly in a 1999 interview. "After a certain age, the only friends I had were teachers." ^7^
+
+Although it meant courting more run-ins at school, Lippman decided to indulge her son's passion. By age 12, Richard was attending science camps during the summer and private school during the school year. When a teacher recommended her son enroll in the Columbia Science Honors Program, a post-Sputnik program designed for gifted middle- and high-school students in New York City, Stallman added to his extracurriculars and was soon commuting uptown to the Columbia University campus on Saturdays.
+
+Dan Chess, a fellow classmate in the Columbia Science Honors Program, recalls Richard Stallman seeming a bit weird even among the students who shared a similar lust for math and science. "We were all geeks and nerds, but he was unusually poorly adjusted," recalls Chess, now a mathematics professor at Hunter College. "He was also smart as shit. I've known a lot of smart people, but I think he was the smartest person I've ever known."
+
+Seth Breidbart, a fellow Columbia Science Honors Program alumnus, offers bolstering testimony. A computer programmer who has kept in touch with Stallman thanks to a shared passion for science fiction and science-fiction conventions, he recalls the 15-year-old, buzz-cut-wearing Stallman as "scary," especially to a fellow 15-year-old.
+
+"It's hard to describe," Breidbart says. "It wasn't like he was unapproachable. He was just very intense. [He was] very knowledgeable but also very hardheaded in some ways."
+
+Such descriptions give rise to speculation: are judgment-laden adjectives like "intense" and "hardheaded" simply a way to describe traits that today might be categorized under juvenile behavioral disorder? A December, 2001, Wired magazine article titled "The Geek Syndrome" paints the portrait of several scientifically gifted children diagnosed with high-functioning autism or Asperger Syndrome. In many ways, the parental recollections recorded in the Wired article are eerily similar to the ones offered by Lippman. Even Stallman has indulged in psychiatric revisionism from time to time. During a 2000 profile for the Toronto Star, Stallman described himself to an interviewer as "borderline autistic,"~{ See Judy Steed, Toronto Star, BUSINESS, (October 9, 2000): C03.<br>His vision of free software and social cooperation stands in stark contrast to the isolated nature of his private life. A Glenn Gould-like eccentric, the Canadian pianist was similarly brilliant, articulate, and lonely. Stallman considers himself afflicted, to some degree, by autism: a condition that, he says, makes it difficult for him to interact with people. }~ a description that goes a long way toward explaining a lifelong tendency toward social and emotional isolation and the equally lifelong effort to overcome it.
+
+Such speculation benefits from the fast and loose nature of most so-called " behavioral disorders" nowadays, of course. As Steve Silberman, author of " The Geek Syndrome," notes, American psychiatrists have only recently come to accept Asperger Syndrome as a valid umbrella term covering a wide set of behavioral traits. The traits range from poor motor skills and poor socialization to high intelligence and an almost obsessive affinity for numbers, computers, and ordered systems.~{ See Steve Silberman, "The Geek Syndrome," Wired (December, 2001).<br> http://www.wired.com/wired/archive/9.12/aspergers_pr.html }~ Reflecting on the broad nature of this umbrella, Stallman says its possible that, if born 40 years later, he might have merited just such a diagnosis. Then again, so would many of his computer-world colleagues.
+
+"It's possible I could have had something like that," he says. "On the other hand, one of the aspects of that syndrome is difficulty following rhythms. I can dance. In fact, I love following the most complicated rhythms. It's not clear cut enough to know."
+
+Chess, for one, rejects such attempts at back-diagnosis. "I never thought of him [as] having that sort of thing," he says. "He was just very unsocialized, but then, we all were."
+
+Lippman, on the other hand, entertains the possibility. She recalls a few stories from her son's infancy, however, that provide fodder for speculation. A prominent symptom of autism is an oversensitivity to noises and colors, and Lippman recalls two anecdotes that stand out in this regard. "When Richard was an infant, we'd take him to the beach," she says. "He would start screaming two or three blocks before we reached the surf. It wasn't until the third time that we figured out what was going on: the sound of the surf was hurting his ears." She also recalls a similar screaming reaction in relation to color: "My mother had bright red hair, and every time she'd stoop down to pick him up, he'd let out a wail."
+
+In recent years, Lippman says she has taken to reading books about autism and believes that such episodes were more than coincidental. "I do feel that Richard had some of the qualities of an autistic child," she says. "I regret that so little was known about autism back then."
+
+Over time, however, Lippman says her son learned to adjust. By age seven, she says, her son had become fond of standing at the front window of subway trains, mapping out and memorizing the labyrinthian system of railroad tracks underneath the city. It was a hobby that relied on an ability to accommodate the loud noises that accompanied each train ride. "Only the initial noise seemed to bother him," says Lippman. "It was as if he got shocked by the sound but his nerves learned how to make the adjustment."
+
+For the most part, Lippman recalls her son exhibiting the excitement, energy, and social skills of any normal boy. It wasn't until after a series of traumatic events battered the Stallman household, she says, that her son became introverted and emotionally distant.
+
+The first traumatic event was the divorce of Alice and Daniel Stallman, Richard's father. Although Lippman says both she and her ex-husband tried to prepare their son for the blow, she says the blow was devastating nonetheless. "He sort of didn't pay attention when we first told him what was happening," Lippman recalls. "But the reality smacked him in the face when he and I moved into a new apartment. The first thing he said was, `Where's Dad's furniture?'"
+
+For the next decade, Stallman would spend his weekdays at his mother's apartment in Manhattan and his weekends at his father's home in Queens. The shuttling back and forth gave him a chance to study a pair of contrasting parenting styles that, to this day, leaves Stallman firmly opposed to the idea of raising children himself. Speaking about his father, a World War II vet who passed away in early 2001, Stallman balances respect with anger. On one hand, there is the man whose moral commitment led him to learn French just so he could be more helpful to Allies when they'd finally come. On the other hand, there was the parent who always knew how to craft a put-down for cruel effect.~{ Regrettably, I did not get a chance to interview Daniel Stallman for this book. During the early research for this book, Stallman informed me that his father suffered from Alzheimer's. When I resumed research in late 2001, I learned, sadly, that Daniel Stallman had died earlier in the year. }~
+
+"My father had a horrible temper," Stallman says. "He never screamed, but he always found a way to criticize you in a cold, designed-to-crush way."
+
+As for life in his mother's apartment, Stallman is less equivocal. "That was war," he says. "I used to say in my misery, `I want to go home,' meaning to the nonexistent place that I'll never have."
+
+For the first few years after the divorce, Stallman found the tranquility that eluded him in the home of his paternal grandparents. Then, around age 10 his grandparents passed away in short succession. For Stallman, the loss was devastating. "I used to go and visit and feel I was in a loving, gentle environment," Stallman recalls. "It was the only place I ever found one, until I went away to college."
+
+Lippman lists the death of Richard's paternal grandparents as the second traumatic event. "It really upset him," she says. He was very close to both his grandparents. Before they died, he was very outgoing, almost a leader-of-the-pack type with the other kids. After they died, he became much more emotionally withdrawn."
+
+From Stallman's perspective, the emotional withdrawal was merely an attempt to deal with the agony of adolescence. Labeling his teenage years a "pure horror," Stallman says he often felt like a deaf person amid a crowd of chattering music listeners.
+
+"I often had the feeling that I couldn't understand what other people were saying," says Stallman, recalling the emotional bubble that insulated him from the rest of the adolescent and adult world. "I could understand the words, but something was going on underneath the conversations that I didn't understand. I couldn't understand why people were interested in the things other people said."
+
+For all the agony it produced, adolescence would have a encouraging effect on Stallman's sense of individuality. At a time when most of his classmates were growing their hair out, Stallman preferred to keep his short. At a time when the whole teenage world was listening to rock and roll, Stallman preferred classical music. A devoted fan of science fiction, Mad magazine, and late-night TV, Stallman cultivated a distinctly off-the-wall personality that fed off the incomprehension of parents and peers alike.
+
+"Oh, the puns," says Lippman, still exasperated by the memory of her son's teenage personality. "There wasn't a thing you could say at the dinner table that he couldn't throw back at you as a pun."
+
+Outside the home, Stallman saved the jokes for the adults who tended to indulge his gifted nature. One of the first was a summer-camp counselor who handed Stallman a print-out manual for the IBM 7094 computer during his 12th year. To a preteenager fascinated with numbers and science, the gift was a godsend.~{ Stallman, an atheist, would probably quibble with this description. Suffice it to say, it was something Stallman welcomed. See previous note 1: "As soon as I heard about computers, I wanted to see one and play with one." }~ By the end of summer, Stallman was writing out paper programs according to the 7094's internal specifications, anxiously anticipating getting a chance to try them out on a real machine.
+
+With the first personal computer still a decade away, Stallman would be forced to wait a few years before getting access to his first computer. His first chance finally came during his junior year of high school. Hired on at the IBM New York Scientific Center, a now-defunct research facility in downtown Manhattan, Stallman spent the summer after high-school graduation writing his first program, a pre-processor for the 7094 written in the programming language PL/I. "I first wrote it in PL/I, then started over in assembler language when the PL/I program was too big to fit in the computer," he recalls.
+
+After that job at the IBM Scientific Center, Stallman had held a laboratory-assistant position in the biology department at Rockefeller University. Although he was already moving toward a career in math or physics, Stallman's analytical mind impressed the lab director enough that a few years after Stallman departed for college, Lippman received an unexpected phone call. "It was the professor at Rockefeller," Lippman says. "He wanted to know how Richard was doing. He was surprised to learn that he was working in computers. He'd always thought Richard had a great future ahead of him as a biologist."
+
+Stallman's analytical skills impressed faculty members at Columbia as well, even when Stallman himself became a target of their ire. "Typically once or twice an hour [Stallman] would catch some mistake in the lecture," says Breidbart. "And he was not shy about letting the professors know it immediately. It got him a lot of respect but not much popularity."
+
+Hearing Breidbart's anecdote retold elicits a wry smile from Stallman. "I may have been a bit of a jerk sometimes," he admits. "But I found kindred spirits among the teachers, because they, too, liked to learn. Kids, for the most part, didn't. At least not in the same way."
+
+Hanging out with the advanced kids on Saturday nevertheless encouraged Stallman to think more about the merits of increased socialization. With college fast approaching, Stallman, like many in his Columbia Science Honors Program, had narrowed his list of desired schools down to two choices: Harvard and MIT. Hearing of her son's desire to move on to the Ivy League, Lippman became concerned. As a 15-year-old high-school junior, Stallman was still having run-ins with teachers and administrators. Only the year before, he had pulled straight A's in American History, Chemistry, French, and Algebra, but a glaring F in English reflected the ongoing boycott of writing assignments. Such miscues might draw a knowing chuckle at MIT, but at Harvard, they were a red flag.
+
+During her son's junior year, Lippman says she scheduled an appointment with a therapist. The therapist expressed instant concern over Stallman's unwillingness to write papers and his run-ins with teachers. Her son certainly had the intellectual wherewithal to succeed at Harvard, but did he have the patience to sit through college classes that required a term paper? The therapist suggested a trial run. If Stallman could make it through a full year in New York City public schools, including an English class that required term papers, he could probably make it at Harvard. Following the completion of his junior year, Stallman promptly enrolled in summer school at Louis D. Brandeis High School, a public school located on 84th Street, and began making up the mandatory art classes he had shunned earlier in his high-school career.
+
+By fall, Stallman was back within the mainstream population of New York City high-school students. It wasn't easy sitting through classes that seemed remedial in comparison with his Saturday studies at Columbia, but Lippman recalls proudly her son's ability to toe the line.
+
+"He was forced to kowtow to a certain degree, but he did it," Lippman says. "I only got called in once, which was a bit of a miracle. It was the calculus teacher complaining that Richard was interrupting his lesson. I asked how he was interrupting. He said Richard was always accusing the teacher of using a false proof. I said, `Well, is he right?' The teacher said, `Yeah, but I can't tell that to the class. They wouldn't understand.'"
+
+By the end of his first semester at Brandeis, things were falling into place. A 96 in English wiped away much of the stigma of the 60 earned 2 years before. For good measure, Stallman backed it up with top marks in American History, Advanced Placement Calculus, and Microbiology. The crowning touch was a perfect 100 in Physics. Though still a social outcast, Stallman finished his 11 months at Brandeis as the fourth-ranked student in a class of 789.
+
+{free_as_in_freedom_02_rms_snr_year_report.png 381x286 "Stallman's senior-year transcript at Louis D. Brandeis H.S., November, 1969. Note turnaround in English class performance. 'He was forced to kowtow to a certain degree,' says his mother, 'but he did it.'" }http://www.free-culture.cc/
+
+Outside the classroom, Stallman pursued his studies with even more diligence, rushing off to fulfill his laboratory-assistant duties at Rockefeller University during the week and dodging the Vietnam protesters on his way to Saturday school at Columbia. It was there, while the rest of the Science Honors Program students sat around discussing their college choices, that Stallman finally took a moment to participate in the preclass bull session.
+
+Recalls Breidbart, "Most of the students were going to Harvard and MIT, of course, but you had a few going to other Ivy League schools. As the conversation circled the room, it became apparent that Richard hadn't said anything yet. I don't know who it was, but somebody got up the courage to ask him what he planned to do."
+
+Thirty years later, Breidbart remembers the moment clearly. As soon as Stallman broke the news that he, too, would be attending Harvard University in the fall, an awkward silence filled the room. Almost as if on cue, the corners of Stallman's mouth slowly turned upward into a self-satisfied smile.
+
+Says Breidbart, "It was his silent way of saying, `That's right. You haven't got rid of me yet.'"
+
+1~ Chapter 4 - Impeach God
+
+Although their relationship was fraught with tension, Richard Stallman would inherit one noteworthy trait from his mother: a passion for progressive politics.
+
+It was an inherited trait that would take several decades to emerge, however. For the first few years of his life, Stallman lived in what he now admits was a "political vacuum."~{ See Michael Gross, "Richard Stallman: High School Misfit, Symbol of Free Software, MacArthur-certified Genius" (1999). }~ Like most Americans during the Eisenhower age, the Stallman family spent the 50s trying to recapture the normalcy lost during the wartime years of the 1940s.
+
+"Richard's father and I were Democrats but happy enough to leave it at that," says Lippman, recalling the family's years in Queens. "We didn't get involved much in local or national politics."
+
+That all began to change, however, in the late 1950s when Alice divorced Daniel Stallman. The move back to Manhattan represented more than a change of address; it represented a new, independent identity and a jarring loss of tranquility.
+
+"I think my first taste of political activism came when I went to the Queens public library and discovered there was only a single book on divorce in the whole library," recalls Lippman. "It was very controlled by the Catholic church, at least in Elmhurst, where we lived. I think that was the first inkling I had of the forces that quietly control our lives."
+
+Returning to her childhood neighborhood, Manhattan's Upper West Side, Lippman was shocked by the changes that had taken place since her departure to Hunter College a decade and a half before. The skyrocketing demand for postwar housing had turned the neighborhood into a political battleground. On one side stood the pro-development city-hall politicians and businessmen hoping to rebuild many of the neighborhood's blocks to accommodate the growing number of white-collar workers moving into the city. On the other side stood the poor Irish and Puerto Rican tenants who had found an affordable haven in the neighborhood.
+
+At first, Lippman didn't know which side to choose. As a new resident, she felt the need for new housing. As a single mother with minimal income, however, she shared the poorer tenants' concern over the growing number of development projects catering mainly to wealthy residents. Indignant, Lippman began looking for ways to combat the political machine that was attempting to turn her neighborhood into a clone of the Upper East Side.
+
+Lippman says her first visit to the local Democratic party headquarters came in 1958. Looking for a day-care center to take care of her son while she worked, she had been appalled by the conditions encountered at one of the city-owned centers that catered to low-income residents. "All I remember is the stench of rotten milk, the dark hallways, the paucity of supplies. I had been a teacher in private nursery schools. The contrast was so great. We took one look at that room and left. That stirred me up."
+
+The visit to the party headquarters proved disappointing, however. Describing it as "the proverbial smoke-filled room," Lippman says she became aware for the first time that corruption within the party might actually be the reason behind the city's thinly disguised hostility toward poor residents. Instead of going back to the headquarters, Lippman decided to join up with one of the many clubs aimed at reforming the Democratic party and ousting the last vestiges of the Tammany Hall machine. Dubbed the Woodrow Wilson/FDR Reform Democratic Club, Lippman and her club began showing up at planning and city-council meetings, demanding a greater say.
+
+"Our primary goal was to fight Tammany Hall, Carmine DeSapio and his henchman,"~{ Carmine DeSapio holds the dubious distinction of being the first Italian-American boss of Tammany Hall, the New York City political machine. For more information on DeSapio and the politics of post-war New York, see John Davenport, "Skinning the Tiger: Carmine DeSapio and the End of the Tammany Era," New York Affairs (1975): 3:1. }~ says Lippman. "I was the representative to the city council and was very much involved in creating a viable urban-renewal plan that went beyond simply adding more luxury housing to the neighborhood."
+
+Such involvement would blossom into greater political activity during the 1960s. By 1965, Lippman had become an "outspoken" supporter for political candidates like William Fitts Ryan, a Democratic elected to Congress with the help of reform clubs and one of the first U.S. representatives to speak out against the Vietnam War.
+
+It wasn't long before Lippman, too, was an outspoken opponent of U.S. involvement in Indochina. "I was against the Vietnam war from the time Kennedy sent troops," she says. "I had read the stories by reporters and journalists sent to cover the early stages of the conflict. I really believed their forecast that it would become a quagmire."
+
+Such opposition permeated the Stallman-Lippman household. In 1967, Lippman remarried. Her new husband, Maurice Lippman, a major in the Air National Guard, resigned his commission to demonstrate his opposition to the war. Lippman's stepson, Andrew Lippman, was at MIT and temporarily eligible for a student deferment. Still, the threat of induction should that deferment disappear, as it eventually did, made the risk of U.S. escalation all the more immediate. Finally, there was Richard who, though younger, faced the prospect of choosing between Vietnam or Canada when the war lasted into the 1970s.
+
+"Vietnam was a major issue in our household," says Lippman. "We talked about it constantly: what would we do if the war continued, what steps Richard or his stepbrother would take if they got drafted. We were all opposed to the war and the draft. We really thought it was immoral."
+
+For Stallman, the Vietnam War elicited a complex mixture of emotions: confusion, horror, and, ultimately, a profound sense of political impotence. As a kid who could barely cope in the mild authoritarian universe of private school, Stallman experienced a shiver whenever the thought of Army boot camp presented itself.
+
+"I was devastated by the fear, but I couldn't imagine what to do and didn't have the guts to go demonstrate," recalls Stallman, whose March 18th birthday earned him a dreaded low number in the draft lottery when the federal government finally eliminated college deferments in 1971. "I couldn't envision moving to Canada or Sweden. The idea of getting up by myself and moving somewhere. How could I do that? I didn't know how to live by myself. I wasn't the kind of person who felt confident in approaching things like that."
+
+Stallman says he was both impressed and shamed by the family members who did speak out. Recalling a bumper sticker on his father's car likening the My Lai massacre to similar Nazi atrocities in World War II, he says he was "excited" by his father's gesture of outrage. "I admired him for doing it," Stallman says. "But I didn't imagine that I could do anything. I was afraid that the juggernaut of the draft was going to destroy me."
+
+Although descriptions of his own unwillingness to speak out carry a tinge of nostalgic regret, Stallman says he was ultimately turned off by the tone and direction of the anti-war movement. Like other members of the Science Honors Program, he saw the weekend demonstrations at Columbia as little more than a distracting spectacle.~{ Chess, another Columbia Science Honors Program alum, describes the protests as "background noise." "We were all political," he says, "but the SHP was imporant. We would never have skipped it for a demonstration." }~ Ultimately, Stallman says, the irrational forces driving the anti-war movement became indistinguishable from the irrational forces driving the rest of youth culture. Instead of worshiping the Beatles, girls in Stallman's age group were suddenly worshiping firebrands like Abbie Hoffman and Jerry Rubin. To a kid already struggling to comprehend his teenage peers, escapist slogans like "make love not war" had a taunting quality. Not only was it a reminder that Stallman, the short-haired outsider who hated rock 'n' roll, detested drugs, and didn't participate in campus demonstrations, wasn't getting it politically; he wasn't "getting it" sexually either.
+
+"I didn't like the counter culture much," Stallman admits. "I didn't like the music. I didn't like the drugs. I was scared of the drugs. I especially didn't like the anti-intellectualism, and I didn't like the prejudice against technology. After all, I loved a computer. And I didn't like the mindless anti-Americanism that I often encountered. There were people whose thinking was so simplistic that if they disapproved of the conduct of the U.S. in the Vietnam War, they had to support the North Vietnamese. They couldn't imagine a more complicated position, I guess."
+
+Such comments alleviate feelings of timidity. They also underline a trait that would become the key to Stallman's own political maturation. For Stallman, political confidence was directly proportionate to personal confidence. By 1970, Stallman had become confident in few things outside the realm of math and science. Nevertheless, confidence in math gave him enough of a foundation to examine the anti-war movement in purely logical terms. In the process of doing so, Stallman had found the logic wanting. Although opposed to the war in Vietnam, Stallman saw no reason to disavow war as a means for defending liberty or correcting injustice. Rather than widen the breach between himself and his peers, however, Stallman elected to keep the analysis to himself.
+
+In 1970, Stallman left behind the nightly dinnertime conversations about politics and the Vietnam War as he departed for Harvard. Looking back, Stallman describes the transition from his mother's Manhattan apartment to life in a Cambridge dorm as an "escape." Peers who watched Stallman make the transition, however, saw little to suggest a liberating experience.
+
+"He seemed pretty miserable for the first while at Harvard," recalls Dan Chess, a classmate in the Science Honors Program who also matriculated at Harvard. "You could tell that human interaction was really difficult for him, and there was no way of avoiding it at Harvard. Harvard was an intensely social kind of place."
+
+To ease the transition, Stallman fell back on his strengths: math and science. Like most members of the Science Honors Program, Stallman breezed through the qualifying exam for Math 55, the legendary "boot camp" class for freshman mathematics "concentrators" at Harvard. Within the class, members of the Science Honors Program formed a durable unit. "We were the math mafia," says Chess with a laugh. "Harvard was nothing, at least compared with the SHP."
+
+To earn the right to boast, however, Stallman, Chess, and the other SHP alumni had to get through Math 55. Promising four years worth of math in two semesters, the course favored only the truly devout. "It was an amazing class," says David Harbater, a former "math mafia" member and now a professor of mathematics at the University of Pennsylvania. "It's probably safe to say there has never been a class for beginning college students that was that intense and that advanced. The phrase I say to people just to get it across is that, among other things, by the second semester we were discussing the differential geometry of Banach manifolds. That's usually when their eyes bug out, because most people don't start talking about Banach manifolds until their second year of graduate school."
+
+Starting with 75 students, the class quickly melted down to 20 by the end of the second semester. Of that 20, says Harbater, "only 10 really knew what they were doing." Of that 10, 8 would go on to become future mathematics professors, 1 would go on to teach physics.
+
+"The other one," emphasizes Harbater, "was Richard Stallman."
+
+Seth Breidbart, a fellow Math 55 classmate, remembers Stallman distinguishing himself from his peers even then.
+
+"He was a stickler in some very strange ways," says Breidbart. There is a standard technique in math which everybody does wrong. It's an abuse of notation where you have to define a function for something and what you do is you define a function and then you prove that it's well defined. Except the first time he did and presented it, he defined a relation and proved that it's a function. It's the exact same proof, but he used the correct terminology, which no one else did. That's just the way he was."
+
+It was in Math 55 that Richard Stallman began to cultivate a reputation for brilliance. Breidbart agrees, but Chess, whose competitive streak refused to yield, says the realization that Stallman might be the best mathematician in the class didn't set in until the next year. "It was during a class on Real Analysis, which I took with Richard the next year," says Chess, now a math professor at Hunter College. "I actually remember in a proof about complex valued measures that Richard came up with an idea that was basically a metaphor from the calculus of variations. It was the first time I ever saw somebody solve a problem in a brilliantly original way."
+
+Chess makes no bones about it: watching Stallman's solution unfold on the chalkboard was a devastating blow. As a kid who'd always taken pride in being the smartest mathematician the room, it was like catching a glimpse of his own mortality. Years later, as Chess slowly came to accept the professional rank of a good-but-not-great mathematician, he had Stallman's sophomore-year proof to look back on as a taunting early indicator.
+
+"That's the thing about mathematics," says Chess. "You don't have to be a first-rank mathematician to recognize first-rate mathematical talent. I could tell I was up there, but I could also tell I wasn't at the first rank. If Richard had chosen to be a mathematician, he would have been a first-rank mathematician."
+
+For Stallman, success in the classroom was balanced by the same lack of success in the social arena. Even as other members of the math mafia gathered to take on the Math 55 problem sets, Stallman preferred to work alone. The same went for living arrangements. On the housing application for Harvard, Stallman clearly spelled out his preferences. "I said I preferred an invisible, inaudible, intangible roommate," he says. In a rare stroke of bureaucratic foresight, Harvard's housing office accepted the request, giving Stallman a one-room single for his freshman year.
+
+Breidbart, the only math-mafia member to share a dorm with Stallman that freshman year, says Stallman slowly but surely learned how to interact with other students. He recalls how other dorm mates, impressed by Stallman's logical acumen, began welcoming his input whenever an intellectual debate broke out in the dining club or dorm commons.
+
+"We had the usual bull sessions about solving the world's problems or what would be the result of something," recalls Breidbart. "Say somebody discovers an immortality serum. What do you do? What are the political results? If you give it to everybody, the world gets overcrowded and everybody dies. If you limit it, if you say everyone who's alive now can have it but their children can't, then you end up with an underclass of people without it. Richard was just better able than most to see the unforeseen circumstances of any decision."
+
+Stallman remembers the discussions vividly. "I was always in favor of immortality," he says. "I was shocked that most people regarded immortality as a bad thing. How else would we be able to see what the world is like 200 years from now?"
+
+Although a first-rank mathematician and first-rate debater, Stallman shied away from clear-cut competitive events that might have sealed his brilliant reputation. Near the end of freshman year at Harvard, Breidbart recalls how Stallman conspicuously ducked the Putnam exam, a prestigious test open to math students throughout the U.S. and Canada. In addition to giving students a chance to measure their knowledge in relation to their peers, the Putnam served as a chief recruiting tool for academic math departments. According to campus legend, the top scorer automatically qualified for a graduate fellowship at any school of his choice, including Harvard.
+
+Like Math 55, the Putnam was a brutal test of merit. A six-hour exam in two parts, it seemed explicitly designed to separate the wheat from the chaff. Breidbart, a veteran of both the Science Honors Program and Math 55, describes it as easily the most difficult test he ever took. "Just to give you an idea of how difficult it was," says Breidbart, "the top score was a 120, and my score the first year was in the 30s. That score was still good enough to place me 101st in the country."
+
+Surprised that Stallman, the best student in the class, had passed on the test, Breidbart says he and a fellow classmate cornered him in the dining common and demanded an explanation. "He said he was afraid of not doing well," Breidbart recalls.
+
+Breidbart and the friend quickly wrote down a few problems from memory and gave them to Stallman. "He solved all of them," Breidbart says, "leading me to conclude that by not doing well, he either meant coming in second or getting something wrong."
+
+Stallman remembers the episode a bit differently. "I remember that they did bring me the questions and it's possible that I solved one of them, but I'm pretty sure I didn't solve them all," he says. Nevertheless, Stallman agrees with Breidbart's recollection that fear was the primary reason for not taking the test. Despite a demonstrated willingness to point out the intellectual weaknesses of his peers and professors in the classroom, Stallman hated the notion of head-to-head competition.
+
+"It's the same reason I never liked chess," says Stallman. "Whenever I'd play, I would become so consumed by the fear of making a single mistake that I would start making stupid mistakes very early in the game. The fear became a self-fulfilling prophecy."
+
+Whether such fears ultimately prompted Stallman to shy away from a mathematical career is a moot issue. By the end of his freshman year at Harvard, Stallman had other interests pulling him away from the field. Computer programming, a latent fascination throughout Stallman's high-school years, was becoming a full-fledged passion. Where other math students sought occasional refuge in art and history classes, Stallman sought it in the computer-science laboratory.
+
+For Stallman, the first taste of real computer programming at the IBM New York Scientific Center had triggered a desire to learn more. "Toward the end of my first year at Harvard school, I started to have enough courage to go visit computer labs and see what they had. I'd ask them if they had extra copies of any manuals that I could read."
+
+Taking the manuals home, Stallman would examine machine specifications, compare them with other machines he already knew, and concoct a trial program, which he would then bring back to the lab along with the borrowed manual. Although some labs balked at the notion of a strange kid coming off the street and working on the lab machinery, most recognized competence when they saw it and let Stallman run the programs he had created.
+
+One day, near the end of freshman year, Stallman heard about a special laboratory near MIT. The laboratory was located on the ninth floor an off-campus building in Tech Square, the newly built facility dedicated to advanced research. According to the rumors, the lab itself was dedicated to the cutting-edge science of artificial intelligence and boasted the cutting-edge machines and software programs to match.
+
+Intrigued, Stallman decided to pay a visit.
+
+The trip was short, about 2 miles on foot, 10 minutes by train, but as Stallman would soon find out, MIT and Harvard can feel like opposite poles of the same planet. With its maze-like tangle of interconnected office buildings, the Institute's campus offered an aesthetic yin to Harvard's spacious colonial-village yang. The same could be said for the student body, a geeky collection of ex-high school misfits known more for its predilection for pranks than its politically powerful alumni.
+
+The yin-yang relationship extended to the AI Lab as well. Unlike Harvard computer labs, there was no grad-student gatekeeper, no clipboard waiting list for terminal access, no explicit atmosphere of "look but don't touch." Instead, Stallman found only a collection of open terminals and robotic arms, presumably the artifacts of some A.I. experiment.
+
+Although the rumors said anybody could sit down at the terminals, Stallman decided to stick with the original plan. When he encountered a lab employee, he asked if the lab had any spare manuals it could loan to an inquisitive student. "They had some, but a lot of things weren't documented," Stallman recalls. "They were hackers after all."
+
+Stallman left with something even better than a manual: a job. Although he doesn't remember what the first project was, he does remember coming back to the AI Lab the next week, grabbing an open terminal and writing software code.
+
+Looking back, Stallman sees nothing unusual in the AI Lab's willingness to accept an unproven outsider at first glance. "That's the way it was back then," he says. "That's the way it still is now. I'll hire somebody when I meet him if I see he's good. Why wait? Stuffy people who insist on putting bureaucracy into everything really miss the point. If a person is good, he shouldn't have to go through a long, detailed hiring process; he should be sitting at a computer writing code."
+
+To get a taste of "bureaucratic and stuffy," Stallman need only visit the computer labs at Harvard. There, access to the terminals was doled out according to academic rank. As an undergrad, Stallman usually had to sign up or wait until midnight, about the time most professors and grad students finished their daily work assignments. The waiting wasn't difficult, but it was frustrating. Waiting for a public terminal, knowing all the while that a half dozen equally usable machines were sitting idle inside professors' locked offices, seemed the height of illogic. Although Stallman paid the occasional visit to the Harvard computer labs, he preferred the more egalitarian policies of the AI Lab. "It was a breath of fresh air," he says. "At the AI Lab, people seemed more concerned about work than status."
+
+Stallman quickly learned that the AI Lab's first-come, first-served policy owed much to the efforts of a vigilant few. Many were holdovers from the days of Project MAC, the Department of Defense-funded research program that had given birth to the first time-share operating systems. A few were already legends in the computing world. There was Richard Greenblatt, the lab's in-house Lisp expert and author of MacHack, the computer chess program that had once humbled A.I. critic Hubert Dreyfus. There was Gerald Sussman, original author of the robotic block-stacking program HACKER. And there was Bill Gosper, the in-house math whiz already in the midst of an 18-month hacking bender triggered by the philosophical implications of the computer game LIFE.~{ See Steven Levy, Hackers (Penguin USA [paperback], 1984): 144.<br>Levy devotes about five pages to describing Gosper's fascination with LIFE, a math-based software game first created by British mathematician John Conway. I heartily recommend this book as a supplement, perhaps even a prerequisite, to this one. }~
+
+Members of the tight-knit group called themselves " hackers." Over time, they extended the "hacker" description to Stallman as well. In the process of doing so, they inculcated Stallman in the ethical traditions of the "hacker ethic ." To be a hacker meant more than just writing programs, Stallman learned. It meant writing the best possible programs. It meant sitting at a terminal for 36 hours straight if that's what it took to write the best possible programs. Most importantly, it meant having access to the best possible machines and the most useful information at all times. Hackers spoke openly about changing the world through software, and Stallman learned the instinctual hacker disdain for any obstacle that prevented a hacker from fulfilling this noble cause. Chief among these obstacles were poor software, academic bureaucracy, and selfish behavior.
+
+Stallman also learned the lore, stories of how hackers, when presented with an obstacle, had circumvented it in creative ways. Stallman learned about " lock hacking," the art of breaking into professors' offices to "liberate" sequestered terminals. Unlike their pampered Harvard counterparts, MIT faculty members knew better than to treat the AI Lab's terminal as private property. If a faculty member made the mistake of locking away a terminal for the night, hackers were quick to correct the error. Hackers were equally quick to send a message if the mistake repeated itself. "I was actually shown a cart with a heavy cylinder of metal on it that had been used to break down the door of one professor's office,"~{ Gerald Sussman, an MIT faculty member and hacker whose work at the AI Lab predates Stallman's, disputes this memory. According to Sussman, the hackers never broke any doors to retrieve terminals. }~ Stallman says.
+
+Such methods, while lacking in subtlety, served a purpose. Although professors and administrators outnumbered hackers two-to-one inside the AI Lab, the hacker ethic prevailed. Indeed, by the time of Stallman's arrival at the AI Lab, hackers and the AI Lab administration had coevolved into something of a symbiotic relationship. In exchange for fixing the machines and keeping the software up and running, hackers earned the right to work on favorite pet projects. Often, the pet projects revolved around improving the machines and software programs even further. Like teenage hot-rodders, most hackers viewed tinkering with machines as its own form of entertainment.
+
+Nowhere was this tinkering impulse better reflected than in the operating system that powered the lab's central PDP-6 mini-computer. Dubbed ITS, short for the Incompatible Time Sharing system, the operating system incorporated the hacking ethic into its very design. Hackers had built it as a protest to Project MAC's original operating system, the Compatible Time Sharing System, CTSS, and named it accordingly. At the time, hackers felt the CTSS design too restrictive, limiting programmers' power to modify and improve the program's own internal architecture if needed. According to one legend passed down by hackers, the decision to build ITS had political overtones as well. Unlike CTSS, which had been designed for the IBM 7094, ITS was built specifically for the PDP-6. In letting hackers write the systems themselves, AI Lab administrators guaranteed that only hackers would feel comfortable using the PDP-6. In the feudal world of academic research, the gambit worked. Although the PDP-6 was co-owned in conjunction with other departments, A.I. researchers soon had it to themselves.~{ I apologize for the whirlwind summary of ITS' genesis, an operating system many hackers still regard as the epitome of the hacker ethos. For more information on the program's political significance, see Simson Garfinkel, Architects of the Information Society: Thirty-Five Years of the Laboratory for Computer Science at MIT (MIT Press, 1999). }~
+
+ITS boasted features most commercial operating systems wouldn't offer for years, features such as multitasking, debugging, and full-screen editing capability. Using it and the PDP-6 as a foundation, the Lab had been able to declare independence from Project MAC shortly before Stallman's arrival. ^17^
+
+As an apprentice hacker, Stallman quickly became enamored with ITS. Although forbidding to most newcomers, the program contained many built-in features that provided a lesson in software development to hacker apprentices such as himself.
+
+"ITS had a very elegant internal mechanism for one program to examine another," says Stallman, recalling the program. "You could examine all sorts of status about another program in a very clean, well-specified way."
+
+Using this feature, Stallman was able to watch how programs written by hackers processed instructions as they ran. Another favorite feature would allow the monitoring program to freeze the monitored program's job between instructions. In other operating systems, such a command would have resulted in half-computed gibberish or an automatic systems crash. In ITS, it provided yet another way to monitor the step-by-step performance.
+
+"If you said, `Stop the job,' it would always be stopped in user mode. It would be stopped between two user-mode instructions, and everything about the job would be consistent for that point," Stallman says. "If you said, `Resume the job,' it would continue properly. Not only that, but if you were to change the status of the job and then change it back, everything would be consistent. There was no hidden status anywhere."
+
+By the end of 1970, hacking at the AI Lab had become a regular part of Stallman's weekly schedule. From Monday to Thursday, Stallman devoted his waking hours to his Harvard classes. As soon as Friday afternoon arrived, however, he was on the T, heading down to MIT for the weekend. Stallman usually timed his arrival to coincide with the ritual food run. Joining five or six other hackers in their nightly quest for Chinese food, he would jump inside a beat-up car and head across the Harvard Bridge into nearby Boston. For the next two hours, he and his hacker colleagues would discuss everything from ITS to the internal logic of the Chinese language and pictograph system. Following dinner, the group would return to MIT and hack code until dawn.
+
+For the geeky outcast who rarely associated with his high-school peers, it was a heady experience, suddenly hanging out with people who shared the same predilection for computers, science fiction, and Chinese food. "I remember many sunrises seen from a car coming back from Chinatown," Stallman would recall nostalgically, 15 years after the fact in a speech at the Swedish Royal Technical Institute. "It was actually a very beautiful thing to see a sunrise, 'cause that's such a calm time of day. It's a wonderful time of day to get ready to go to bed. It's so nice to walk home with the light just brightening and the birds starting to chirp; you can get a real feeling of gentle satisfaction, of tranquility about the work that you have done that night."~{ See Richard Stallman, "RMS lecture at KTH (Sweden)," (October 30, 1986).<br> http://www.gnu.org/philosophy/stallman-kth.html }~
+
+The more Stallman hung out with the hackers, the more he adopted the hacker worldview. Already committed to the notion of personal liberty, Stallman began to infuse his actions with a sense of communal responsibility. When others violated the communal code, Stallman was quick to speak out. Within a year of his first visit, Stallman was the one breaking into locked offices, trying to recover the sequestered terminals that belonged to the lab community as a whole. In true hacker fashion, Stallman also sought to make his own personal contribution to the art of lock hacking. One of the most artful door-opening tricks, commonly attributed to Greenblatt, involved bending a stiff wire into a cane and attaching a loop of tape to the long end. Sliding the wire under the door, a hacker could twist and rotate the wire so that the long end touched the door knob. Provided the adhesive on the tape held, a hacker could open the doorknob with a few sharp twists.
+
+When Stallman tried the trick, he found it good but wanting in a few places. Getting the tape to stick wasn't always easy, and twisting the wire in a way that turned the doorknob was similarly difficult. Stallman remembered that the hallway ceiling possessed tiles that could be slid away. Some hackers, in fact, had used the false ceiling as a way to get around locked doors, an approach that generally covered the perpetrator in fiberglass but got the job done.
+
+Stallman considered an alternative approach. What if, instead of slipping a wire under the door, a hacker slid away one of the panels and stood over the door jamb?
+
+Stallman took it upon himself to try it out. Instead of using a wire, Stallman draped out a long U-shaped loop of magnetic tape, fastening a loop of adhesive tape at the base of the U. Standing over the door jamb, he dangled the tape until it looped under the doorknob. Lifting the tape until the adhesive fastened, he then pulled on the left end of the tape, twisting the doorknob counter-clockwise. Sure enough, the door opened. Stallman had added a new twist to the art of lock hacking.
+
+"Sometimes you had to kick the door after you turned the door knob," says Stallman, recalling the lingering bugginess of the new method. "It took a little bit of balance to pull it off."
+
+Such activities reflected a growing willingness on Stallman's part to speak and act out in defense of political beliefs. The AI Lab's spirit of direct action had proved inspirational enough for Stallman to break out of the timid impotence of his teenage years. Breaking into an office to free a terminal wasn't the same as taking part in a protest march, but it was effective in ways that most protests weren't. It solved the problem at hand.
+
+By the time of his last years at Harvard, Stallman was beginning to apply the whimsical and irreverent lessons of the AI Lab back at school.
+
+"Did he tell you about the snake?" his mother asks at one point during an interview. "He and his dorm mates put a snake up for student election. Apparently it got a considerable number of votes."
+
+Stallman verifies the snake candidacy with a few caveats. The snake was a candidate for election within Currier House, Stallman's dorm, not the campus-wide student council. Stallman does remember the snake attracting a fairly significant number of votes, thanks in large part to the fact that both the snake and its owner both shared the same last name. "People may have voted for it, because they thought they were voting for the owner," Stallman says. "Campaign posters said that the snake was `slithering for' the office. We also said it was an `at large' candidate, since it had climbed into the wall through the ventilating unit a few weeks before and nobody knew where it was."
+
+Running a snake for dorm council was just one of several election-related pranks. In a later election, Stallman and his dorm mates nominated the house master's son. "His platform was mandatory retirement at age seven," Stallman recalls. Such pranks paled in comparison to the fake-candidate pranks on the MIT campus, however. One of the most successful fake-candidate pranks was a cat named Woodstock, which actually managed to outdraw most of the human candidates in a campus-wide election. "They never announced how many votes Woodstock got, and they treated those votes as spoiled ballots," Stallman recalls. "But the large number of spoiled ballots in that election suggested that Woodstock had actually won. A couple of years later, Woodstock was suspiciously run over by a car. Nobody knows if the driver was working for the MIT administration." Stallman says he had nothing to do with Woodstock's candidacy, "but I admired it."~{ In an email shortly after this book went into its final edit cycle, Stallman says he drew political inspiration from the Harvard campus as well. "In my first year of Harvard, in a Chinese History class, I read the story of the first revolt against the Chin dynasty," he says. "The story is not reliable history, but it was very moving." }~
+
+At the AI Lab, Stallman's political activities had a sharper-edged tone. During the 1970s, hackers faced the constant challenge of faculty members and administrators pulling an end-run around ITS and its hacker-friendly design. One of the first attempts came in the mid-1970s, as more and more faculty members began calling for a file security system to protect research data. Most other computer labs had installed such systems during late 1960s, but the AI Lab, through the insistence of Stallman and other hackers, remained a security-free zone.
+
+For Stallman, the opposition to security was both ethical and practical. On the ethical side, Stallman pointed out that the entire art of hacking relied on intellectual openness and trust. On the practical side, he pointed to the internal structure of ITS being built to foster this spirit of openness, and any attempt to reverse that design required a major overhaul.
+
+"The hackers who wrote the Incompatible Timesharing System decided that file protection was usually used by a self-styled system manager to get power over everyone else," Stallman would later explain. "They didn't want anyone to be able to get power over them that way, so they didn't implement that kind of a feature. The result was, that whenever something in the system was broken, you could always fix it."~{ See Richard Stallman (1986). }~
+
+Through such vigilance, hackers managed to keep the AI Lab's machines security-free. Over at the nearby MIT Laboratory for Computer Sciences, however, security-minded faculty members won the day. The LCS installed its first password-based system in 1977. Once again, Stallman took it upon himself to correct what he saw as ethical laxity. Gaining access to the software code that controlled the password system, Stallman implanted a software command that sent out a message to any LCS user who attempted to choose a unique password. If a user entered "starfish," for example, the message came back something like:
+
+_1 I see you chose the password "starfish." I suggest that you switch to the password "carriage return." It's much easier to type, and also it stands up to the principle that there should be no passwords.~{ See Steven Levy, Hackers (Penguin USA [paperback], 1984): 417. I have modified this quote, which Levy also uses as an excerpt, to illustrate more directly how the program might reveal the false security of the system. Levy uses the placeholder "[such and such]." }~
+
+Users who did enter "carriage return"-that is, users who simply pressed the Enter or Return button, entering a blank string instead of a unique password-left their accounts accessible to the world at large. As scary as that might have been for some users, it reinforced the hacker notion that Institute computers, and even Institute computer files, belonged to the public, not private individuals. Stallman, speaking in an interview for the 1984 book Hackers, proudly noted that one-fifth of the LCS staff accepted this argument and employed the blank-string password.~{ See Steven Levy, Hackers (Penguin USA [paperback], 1984): 417. }~
+
+Stallman's null-string crusade would prove ultimately futile. By the early 1980s, even the AI Lab's machines were sporting password-based security systems. Even so, it represents a major milestone in terms of Stallman's personal and political maturation. To the objective observer familiar with Stallman's later career, it offers a convenient inflection point between the timid teenager afraid to speak out even on issues of life-threatening importance and the adult activist who would soon turn needling and cajoling into a full-time occupation.
+
+In voicing his opposition to computer security, Stallman drew on many of the forces that had shaped his early life: hunger for knowledge, distaste for authority, and frustration over hidden procedures and rules that rendered some people clueless outcasts. He would also draw on the ethical concepts that would shape his adult life: communal responsibility, trust, and the hacker spirit of direct action. Expressed in software-computing terms, the null string represents the 1.0 version of the Richard Stallman political worldview-incomplete in a few places but, for the most part, fully mature.
+
+Looking back, Stallman hesitates to impart too much significance to an event so early in his hacking career. "In that early stage there were a lot of people who shared my feelings," he says. "The large number of people who adopted the null string as their password was a sign that many people agreed that it was the proper thing to do. I was simply inclined to be an activist about it."
+
+Stallman does credit the AI Lab for awakening that activist spirit, however. As a teenager, Stallman had observed political events with little idea as to how a single individual could do or say anything of importance. As a young adult, Stallman was speaking out on matters in which he felt supremely confident, matters such as software design, communal responsibility, and individual freedom. "I joined this community which had a way of life which involved respecting each other's freedom," he says. "It didn't take me long to figure out that that was a good thing. It took me longer to come to the conclusion that this was a moral issue."
+
+Hacking at the AI Lab wasn't the only activity helping to boost Stallman's esteem. During the middle of his sophomore year at Harvard, Stallman had joined up with a dance troupe that specialized in folk dances . What began as a simple attempt to meet women and expand his social horizons soon expanded into yet another passion alongside hacking. Dancing in front of audiences dressed in the native garb of a Balkan peasant, Stallman no longer felt like the awkward, uncoordinated 10-year-old whose attempts to play football had ended in frustration. He felt confident, agile, and alive. For a brief moment, he even felt a hint of emotional connection. He soon found being in front of an audience fun, and it wasn't long thereafter that he began craving the performance side of dancing almost as much as the social side.
+
+Although the dancing and hacking did little to improve Stallman's social standing, they helped him overcome the feelings of weirdness that had clouded his pre-Harvard life. Instead of lamenting his weird nature, Stallman found ways to celebrate it. In 1977, while attending a science-fiction convention, he came across a woman selling custom-made buttons. Excited, Stallman ordered a button with the words "Impeach God" emblazoned on it.
+
+For Stallman, the "Impeach God" message worked on many levels. An atheist since early childhood, Stallman first saw it as an attempt to set a "second front" in the ongoing debate on religion. "Back then everybody was arguing about God being dead or alive," Stallman recalls. "`Impeach God' approached the subject of God from a completely different viewpoint. If God was so powerful as to create the world and yet do nothing to correct the problems in it, why would we ever want to worship such a God? Wouldn't it be better to put him on trial?"
+
+At the same time, "Impeach God" was a satirical take on America and the American political system. The Watergate scandal of the 1970s affected Stallman deeply. As a child, Stallman had grown up mistrusting authority. Now, as an adult, his mistrust had been solidified by the culture of the AI Lab hacker community. To the hackers, Watergate was merely a Shakespearean rendition of the daily power struggles that made life such a hassle for those without privilege. It was an outsized parable for what happened when people traded liberty and openness for security and convenience.
+
+Buoyed by growing confidence, Stallman wore the button proudly. People curious enough to ask him about it received the same well-prepared spiel. "My name is Jehovah," Stallman would say. "I have a special plan to save the universe, but because of heavenly security reasons I can't tell you what that plan is. You're just going to have to put your faith in me, because I see the picture and you don't. You know I'm good because I told you so. If you don't believe me, I'll throw you on my enemies list and throw you in a pit where Infernal Revenue Service will audit your taxes for eternity."
+
+Those who interpreted the spiel as a word-for-word parody of the Watergate hearings only got half the message. For Stallman, the other half of the message was something only his fellow hackers seemed to be hearing. One hundred years after Lord Acton warned about absolute power corrupting absolutely, Americans seemed to have forgotten the first part of Acton's truism: power, itself, corrupts. Rather than point out the numerous examples of petty corruption, Stallman felt content voicing his outrage toward an entire system that trusted power in the first place.
+
+"I figured why stop with the small fry," says Stallman, recalling the button and its message. "If we went after Nixon, why not going after Mr. Big. The way I see it, any being that has power and abuses it deserves to have that power taken away."
+
+1~ Chapter 5 - Small Puddle of Freedom
+
+Ask anyone who's spent more than a minute in Richard Stallman's presence, and you'll get the same recollection: forget the long hair. Forget the quirky demeanor. The first thing you notice is the gaze. One look into Stallman's green eyes, and you know you're in the presence of a true believer.
+
+To call the Stallman gaze intense is an understatement. Stallman's eyes don't just look at you; they look through you. Even when your own eyes momentarily shift away out of simple primate politeness, Stallman's eyes remain locked-in, sizzling away at the side of your head like twin photon beams.
+
+Maybe that's why most writers, when describing Stallman, tend to go for the religious angle. In a 1998 Salon.com article titled "The Saint of Free Software," Andrew Leonard describes Stallman's green eyes as "radiating the power of an Old Testament prophet."~{ See Andrew Leonard, "The Saint of Free Software," Salon.com (August 1998).<br> http://www.salon.com/21st/feature/1998/08/cov_31feature.html }~ A 1999 Wired magazine article describes the Stallman beard as "Rasputin-like,"~{ See Leander Kahney, "Linux's Forgotten Man," Wired News (March 5, 1999).<br> http://www.wired.com/news/print/0,1294,18291,00.html }~ while a London Guardian profile describes the Stallman smile as the smile of "a disciple seeing Jesus."~{ See "Programmer on moral high ground; Free software is a moral issue for Richard Stallman believes in freedom and free software." London Guardian (November 6, 1999).<br>These are just a small sampling of the religious comparisons. To date, the most extreme comparison has to go to Linus Torvalds, who, in his autobiography-see Linus Torvalds and David Diamond, Just For Fun: The Story of an Accidentaly Revolutionary (HarperCollins Publishers, Inc., 2001): 58-writes "Richard Stallman is the God of Free Software."<br>Honorable mention goes to Larry Lessig, who, in a footnote description of Stallman in his book-see Larry Lessig, The Future of Ideas (Random House, 2001): 270-likens Stallman to Moses:<br>_1 ... as with Moses, it was another leader, Linus Torvalds, who finally carried the movement into the promised land by facilitating the development of the final part of the OS puzzle. Like Moses, too, Stallman is both respected and reviled by allies within the movement. He is [an] unforgiving, and hence for many inspiring, leader of a critically important aspect of modern culture. I have deep respect for the principle and commitment of this extraordinary individual, though I also have great respect for those who are courageous enough to question his thinking and then sustain his wrath.<br>In a final interview with Stallman, I asked him his thoughts about the religious comparisons. "Some people do compare me with an Old Testament prophent, and the reason is Old Testament prophets said certain social practices were wrong. They wouldn't compromise on moral issues. They couldn't be bought off, and they were usually treated with contempt." }~
+
+Such analogies serve a purpose, but they ultimately fall short. That's because they fail to take into account the vulnerable side of the Stallman persona. Watch the Stallman gaze for an extended period of time, and you will begin to notice a subtle change. What appears at first to be an attempt to intimidate or hypnotize reveals itself upon second and third viewing as a frustrated attempt to build and maintain contact. If, as Stallman himself has suspected from time to time, his personality is the product of autism or Asperger Syndrome, his eyes certainly confirm the diagnosis. Even at their most high-beam level of intensity, they have a tendency to grow cloudy and distant, like the eyes of a wounded animal preparing to give up the ghost.
+
+My own first encounter with the legendary Stallman gaze dates back to the March, 1999, LinuxWorld Convention and Expo in San Jose, California. Billed as a "coming out party" for the Linux software community, the convention also stands out as the event that reintroduced Stallman to the technology media. Determined to push for his proper share of credit, Stallman used the event to instruct spectators and reporters alike on the history of the GNU Project and the project's overt political objectives.
+
+As a reporter sent to cover the event, I received my own Stallman tutorial during a press conference announcing the release of GNOME 1.0, a free software graphic user interface. Unwittingly, I push an entire bank of hot buttons when I throw out my very first question to Stallman himself: do you think GNOME's maturity will affect the commercial popularity of the Linux operating system?
+
+"I ask that you please stop calling the operating system Linux," Stallman responds, eyes immediately zeroing in on mine. "The Linux kernel is just a small part of the operating system. Many of the software programs that make up the operating system you call Linux were not developed by Linus Torvalds at all. They were created by GNU Project volunteers, putting in their own personal time so that users might have a free operating system like the one we have today. To not acknowledge the contribution of those programmers is both impolite and a misrepresentation of history. That's why I ask that when you refer to the operating system, please call it by its proper name, GNU/Linux."
+
+Taking the words down in my reporter's notebook, I notice an eerie silence in the crowded room. When I finally look up, I find Stallman's unblinking eyes waiting for me. Timidly, a second reporter throws out a question, making sure to use the term " GNU/Linux" instead of Linux. Miguel de Icaza, leader of the GNOME project, fields the question. It isn't until halfway through de Icaza's answer, however, that Stallman's eyes finally unlock from mine. As soon as they do, a mild shiver rolls down my back. When Stallman starts lecturing another reporter over a perceived error in diction, I feel a guilty tinge of relief. At least he isn't looking at me, I tell myself.
+
+For Stallman, such face-to-face moments would serve their purpose. By the end of the first LinuxWorld show, most reporters know better than to use the term "Linux" in his presence, and wired.com is running a story comparing Stallman to a pre-Stalinist revolutionary erased from the history books by hackers and entrepreneurs eager to downplay the GNU Project's overly political objectives. ^24^ Other articles follow, and while few reporters call the operating system GNU/Linux in print, most are quick to credit Stallman for launching the drive to build a free software operating system 15 years before.
+
+I won't meet Stallman again for another 17 months. During the interim, Stallman will revisit Silicon Valley once more for the August, 1999 LinuxWorld show. Although not invited to speak, Stallman does managed to deliver the event's best line. Accepting the show's Linus Torvalds Award for Community Service-an award named after Linux creator Linus Torvalds-on behalf of the Free Software Foundation, Stallman wisecracks, "Giving the Linus Torvalds Award to the Free Software Foundation is a bit like giving the Han Solo Award to the Rebel Alliance."
+
+This time around, however, the comments fail to make much of a media dent. Midway through the week, Red Hat, Inc., a prominent GNU/Linux vendor, goes public. The news merely confirms what many reporters such as myself already suspect: "Linux" has become a Wall Street buzzword, much like "e-commerce" and "dot-com" before it. With the stock market approaching the Y2K rollover like a hyperbola approaching its vertical asymptote, all talk of free software or open source as a political phenomenon falls by the wayside.
+
+Maybe that's why, when LinuxWorld follows up its first two shows with a third LinuxWorld show in August, 2000, Stallman is conspicuously absent.
+
+My second encounter with Stallman and his trademark gaze comes shortly after that third LinuxWorld show. Hearing that Stallman is going to be in Silicon Valley, I set up a lunch interview in Palo Alto, California. The meeting place seems ironic, not only because of the recent no-show but also because of the overall backdrop. Outside of Redmond, Washington, few cities offer a more direct testament to the economic value of proprietary software. Curious to see how Stallman, a man who has spent the better part of his life railing against our culture's predilection toward greed and selfishness, is coping in a city where even garage-sized bungalows run in the half-million-dollar price range, I make the drive down from Oakland.
+
+I follow the directions Stallman has given me, until I reach the headquarters of Art.net, a nonprofit "virtual artists collective." Located in a hedge-shrouded house in the northern corner of the city, the Art.net headquarters are refreshingly run-down. Suddenly, the idea of Stallman lurking in the heart of Silicon Valley doesn't seem so strange after all.
+
+I find Stallman sitting in a darkened room, tapping away on his gray laptop computer. He looks up as soon as I enter the room, giving me a full blast of his 200-watt gaze. When he offers a soothing "Hello," I offer a return greeting. Before the words come out, however, his eyes have already shifted back to the laptop screen.
+
+"I'm just finishing an article on the spirit of hacking," Stallman says, fingers still tapping. "Take a look."
+
+I take a look. The room is dimly lit, and the text appears as greenish-white letters on a black background, a reversal of the color scheme used by most desktop word-processing programs, so it takes my eyes a moment to adjust. When they do, I find myself reading Stallman's account of a recent meal at a Korean restaurant. Before the meal, Stallman makes an interesting discovery: the person setting the table has left six chopsticks instead of the usual two in front of Stallman's place setting. Where most restaurant goers would have ignored the redundant pairs, Stallman takes it as challenge: find a way to use all six chopsticks at once. Like many software hacks, the successful solution is both clever and silly at the same time. Hence Stallman's decision to use it as an illustration.
+
+As I read the story, I feel Stallman watching me intently. I look over to notice a proud but child-like half smile on his face. When I praise the essay, my comment barely merits a raised eyebrow.
+
+"I'll be ready to go in a moment," he says.
+
+Stallman goes back to tapping away at his laptop. The laptop is gray and boxy, not like the sleek, modern laptops that seemed to be a programmer favorite at the recent LinuxWorld show. Above the keyboard rides a smaller, lighter keyboard, a testament to Stallman's aging hands. During the late 1980s, when Stallman was putting in 70- and 80-hour work weeks writing the first free software tools and programs for the GNU Project, the pain in Stallman's hands became so unbearable that he had to hire a typist. Today, Stallman relies on a keyboard whose keys require less pressure than a typical computer keyboard.
+
+Stallman has a tendency to block out all external stimuli while working. Watching his eyes lock onto the screen and his fingers dance, one quickly gets the sense of two old friends locked in deep conversation.
+
+The session ends with a few loud keystrokes and the slow disassembly of the laptop.
+
+"Ready for lunch?" Stallman asks.
+
+We walk to my car. Pleading a sore ankle, Stallman limps along slowly. Stallman blames the injury on a tendon in his left foot. The injury is three years old and has gotten so bad that Stallman, a huge fan of folk dancing, has been forced to give up all dancing activities. "I love folk dancing inherently," Stallman laments. "Not being able to dance has been a tragedy for me."
+
+Stallman's body bears witness to the tragedy. Lack of exercise has left Stallman with swollen cheeks and a pot belly that was much less visible the year before. You can tell the weight gain has been dramatic, because when Stallman walks, he arches his back like a pregnant woman trying to accommodate an unfamiliar load.
+
+The walk is further slowed by Stallman's willingness to stop and smell the roses, literally. Spotting a particularly beautiful blossom, he tickles the innermost petals with his prodigious nose, takes a deep sniff and steps back with a contented sigh.
+
+"Mmm, rhinophytophilia,"~{ At the time, I thought Stallman was referring to the flower's scientific name. Months later, I would learn that rhinophytophilia was in fact a humorous reference to the activity, i.e., Stallman sticking his nose into a flower and enjoying the moment. For another humorous Stallman flower incident, visit:<br> http://www.stallman.org/texas.html }~ he says, rubbing his back.
+
+The drive to the restaurant takes less than three minutes. Upon recommendation from Tim Ney, former executive director of the Free Software Foundation, I have let Stallman choose the restaurant. While some reporters zero in on Stallman's monk-like lifestyle, the truth is, Stallman is a committed epicure when it comes to food. One of the fringe benefits of being a traveling missionary for the free software cause is the ability to sample delicious food from around the world. "Visit almost any major city in the world, and chances are Richard knows the best restaurant in town," says Ney. "Richard also takes great pride in knowing what's on the menu and ordering for the entire table."
+
+For today's meal, Stallman has chosen a Cantonese-style dim sum restaurant two blocks off University Avenue, Palo Alto's main drag. The choice is partially inspired by Stallman's recent visit to China, including a lecture stop in Guangdong province, in addition to Stallman's personal aversion to spicier Hunanese and Szechuan cuisine. "I'm not a big fan of spicy," Stallman admits.
+
+We arrive a few minutes after 11 a.m. and find ourselves already subject to a 20-minute wait. Given the hacker aversion to lost time, I hold my breath momentarily, fearing an outburst. Stallman, contrary to expectations, takes the news in stride.
+
+"It's too bad we couldn't have found somebody else to join us," he tells me. "It's always more fun to eat with a group of people."
+
+During the wait, Stallman practices a few dance steps. His moves are tentative but skilled. We discuss current events. Stallman says his only regret about not attending LinuxWorld was missing out on a press conference announcing the launch of the GNOME Foundation. Backed by Sun Microsystems and IBM, the foundation is in many ways a vindication for Stallman, who has long championed that free software and free-market economics need not be mutually exclusive. Nevertheless, Stallman remains dissatisfied by the message that came out.
+
+"The way it was presented, the companies were talking about Linux with no mention of the GNU Project at all," Stallman says.
+
+Such disappointments merely contrast the warm response coming from overseas, especially Asia, Stallman notes. A quick glance at the Stallman 2000 travel itinerary bespeaks the growing popularity of the free software message. Between recent visits to India, China, and Brazil, Stallman has spent 12 of the last 115 days on United States soil. His travels have given him an opportunity to see how the free software concept translates into different languages of cultures.
+
+"In India many people are interested in free software, because they see it as a way to build their computing infrastructure without spending a lot of money," Stallman says. "In China, the concept has been much slower to catch on. Comparing free software to free speech is harder to do when you don't have any free speech. Still, the level of interest in free software during my last visit was profound."
+
+The conversation shifts to Napster, the San Mateo, California software company, which has become something of a media cause cÈlËbre in recent months. The company markets a controversial software tool that lets music fans browse and copy the music files of other music fans. Thanks to the magnifying powers of the Internet, this so-called "peer-to-peer" program has evolved into a de facto online juke box, giving ordinary music fans a way to listen to MP3 music files over the computer without paying a royalty or fee, much to record companies' chagrin.
+
+Although based on proprietary software, the Napster system draws inspiration from the long-held Stallman contention that once a work enters the digital realm-in other words, once making a copy is less a matter of duplicating sounds or duplicating atoms and more a matter of duplicating information-the natural human impulse to share a work becomes harder to restrict. Rather than impose additional restrictions, Napster execs have decided to take advantage of the impulse. Giving music listeners a central place to trade music files, the company has gambled on its ability to steer the resulting user traffic toward other commercial opportunities.
+
+The sudden success of the Napster model has put the fear in traditional record companies, with good reason. Just days before my Palo Alto meeting with Stallman, U.S. District Court Judge Marilyn Patel granted a request filed by the Recording Industry Association of America for an injunction against the file-sharing service. The injunction was subsequently suspended by the U.S. Ninth District Court of Appeals, but by early 2001, the Court of Appeals, too, would find the San Mateo-based company in breach of copyright law,~{ See Cecily Barnes and Scott Ard, "Court Grants Stay of Napster Injunction," News.com (July 28, 2000).<br> http://news.cnet.com/news/0-1005-200-2376465.html }~ a decision RIAA spokesperson Hillary Rosen would later proclaim proclaim a "clear victory for the creative content community and the legitimate online marketplace."~{ See "A Clear Victory for Recording Industry in Napster Case," RIAA press release (February 12, 2001).<br> http://www.riaa.com/PR_story.cfm?id=372 }~
+
+For hackers such as Stallman, the Napster business model is scary in different ways. The company's eagerness to appropriate time-worn hacker principles such as file sharing and communal information ownership, while at the same time selling a service based on proprietary software, sends a distressing mixed message. As a person who already has a hard enough time getting his own carefully articulated message into the media stream, Stallman is understandably reticent when it comes to speaking out about the company. Still, Stallman does admit to learning a thing or two from the social side of the Napster phenomenon.
+
+"Before Napster, I thought it might be OK for people to privately redistribute works of entertainment," Stallman says. "The number of people who find Napster useful, however, tells me that the right to redistribute copies not only on a neighbor-to-neighbor basis, but to the public at large, is essential and therefore may not be taken away."
+
+No sooner does Stallman say this than the door to the restaurant swings open and we are invited back inside by the host. Within a few seconds, we are seated in a side corner of the restaurant next to a large mirrored wall.
+
+The restaurant's menu doubles as an order form, and Stallman is quickly checking off boxes before the host has even brought water to the table. "Deep-fried shrimp roll wrapped in bean-curd skin," Stallman reads. "Bean-curd skin. It offers such an interesting texture. I think we should get it."
+
+This comment leads to an impromptu discussion of Chinese food and Stallman's recent visit to China. "The food in China is utterly exquisite," Stallman says, his voice gaining an edge of emotion for the first time this morning. "So many different things that I've never seen in the U.S., local things made from local mushrooms and local vegetables. It got to the point where I started keeping a journal just to keep track of every wonderful meal."
+
+The conversation segues into a discussion of Korean cuisine. During the same June, 2000, Asian tour, Stallman paid a visit to South Korea. His arrival ignited a mini-firestorm in the local media thanks to a Korean software conference attended by Microsoft founder and chairman Bill Gates that same week. Next to getting his photo above Gates's photo on the front page of the top Seoul newspaper, Stallman says the best thing about the trip was the food. "I had a bowl of naeng myun, which is cold noodles," says Stallman. "These were a very interesting feeling noodle. Most places don't use quite the same kind of noodles for your naeng myun, so I can say with complete certainty that this was the most exquisite naeng myun I ever had."
+
+The term "exquisite" is high praise coming from Stallman. I know this, because a few moments after listening to Stallman rhapsodize about naeng myun, I feel his laser-beam eyes singeing the top of my right shoulder.
+
+"There is the most exquisite woman sitting just behind you," Stallman says.
+
+I turn to look, catching a glimpse of a woman's back. The woman is young, somewhere in her mid-20s, and is wearing a white sequinned dress. She and her male lunch companion are in the final stages of paying the check. When both get up from the table to leave the restaurant, I can tell without looking, because Stallman's eyes suddenly dim in intensity.
+
+"Oh, no," he says. "They're gone. And to think, I'll probably never even get to see her again."
+
+After a brief sigh, Stallman recovers. The moment gives me a chance to discuss Stallman's reputation vis-ý-vis the fairer sex. The reputation is a bit contradictory at times. A number of hackers report Stallman's predilection for greeting females with a kiss on the back of the hand.~{ See Mae Ling Mak, "Mae Ling's Story" (December 17, 1998).<br> http://www.crackmonkey.org/pipermail/crackmonkey/1998q4/003006.htm <br>So far, Mak is the only person I've found willing to speak on the record in regard to this practice, although I've heard this from a few other female sources. Mak, despite expressing initial revulsion at it, later managed to put aside her misgivings and dance with Stallman at a 1999 LinuxWorld show.<br> http://www.linux.com/interact/potd.phtml?potd_id=44 }~ A May 26, 2000 Salon.com article, meanwhile, portrays Stallman as a bit of a hacker lothario. Documenting the free software-free love connection, reporter Annalee Newitz presents Stallman as rejecting traditional family values, telling her, "I believe in love, but not monogamy."~{ See Annalee Newitz, "If Code is Free Why Not Me?" Salon.com (May 26, 2000).<br> http://www.salon.com/tech/feature/2000/05/26/free_love/print.html }~
+
+Stallman lets his menu drop a little when I bring this up. "Well, most men seem to want sex and seem to have a rather contemptuous attitude towards women," he says. "Even women they're involved with. I can't understand it at all."
+
+I mention a passage from the 1999 book Open Sources in which Stallman confesses to wanting to name the ill-fated GNU kernel after a girlfriend at the time. The girlfriend's name was Alix, a name that fit perfectly with the Unix developer convention of putting an "x" at the end of any new kernel name-e.g., "Linux." Because the woman was a Unix system administrator, Stallman says it would have been an even more touching tribute. Unfortunately, Stallman notes, the kernel project's eventual main developer renamed the kernel HURD.~{ See Richard Stallman, "The GNU Operating System and the Free Software Movement," Open Sources (O'Reilly & Associates, Inc., 1999): 65. }~ Although Stallman and the girlfriend later broke up, the story triggers an automatic question: for all the media imagery depicting him as a wild-eyed fanatic, is Richard Stallman really just a hopeless romantic, a wandering Quixote tilting at corporate windmills in an effort to impress some as-yet-unidentified Dulcinea?
+
+"I wasn't really trying to be romantic," Stallman says, recalling the Alix story. "It was more of a teasing thing. I mean, it was romantic, but it was also teasing, you know? It would have been a delightful surprise."
+
+For the first time all morning, Stallman smiles. I bring up the hand kissing. "Yes, I do do that," Stallman says. "I've found it's a way of offering some affection that a lot of women will enjoy. It's a chance to give some affection and to be appreciated for it."
+
+Affection is a thread that runs clear through Richard Stallman's life, and he is painfully candid about it when questions arise. "There really hasn't been much affection in my life, except in my mind," he says. Still, the discussion quickly grows awkward. After a few one-word replies, Stallman finally lifts up his menu, cutting off the inquiry.
+
+"Would you like some shimai?" he asks.
+
+When the food comes out, the conversation slaloms between the arriving courses. We discuss the oft-noted hacker affection for Chinese food, the weekly dinner runs into Boston's Chinatown district during Stallman's days as a staff programmer at the AI Lab, and the underlying logic of the Chinese language and its associated writing system. Each thrust on my part elicits a well-informed parry on Stallman's part.
+
+"I heard some people speaking Shanghainese the last time I was in China," Stallman says. "It was interesting to hear. It sounded quite different [from Mandarin]. I had them tell me some cognate words in Mandarin and Shanghainese. In some cases you can see the resemblance, but one question I was wondering about was whether tones would be similar. They're not. That's interesting to me, because there's a theory that the tones evolved from additional syllables that got lost and replaced. Their effect survives in the tone. If that's true, and I've seen claims that that happened within historic times, the dialects must have diverged before the loss of these final syllables."
+
+The first dish, a plate of pan-fried turnip cakes, has arrived. Both Stallman and I take a moment to carve up the large rectangular cakes, which smell like boiled cabbage but taste like potato latkes fried in bacon.
+
+I decide to bring up the outcast issue again, wondering if Stallman's teenage years conditioned him to take unpopular stands, most notably his uphill battle since 1994 to get computer users and the media to replace the popular term "Linux" with "GNU/Linux."
+
+"I believe it did help me," Stallman says, chewing on a dumpling. "I have never understood what peer pressure does to other people. I think the reason is that I was so hopelessly rejected that for me, there wasn't anything to gain by trying to follow any of the fads. It wouldn't have made any difference. I'd still be just as rejected, so I didn't try."
+
+Stallman points to his taste in music as a key example of his contrarian tendencies. As a teenager, when most of his high school classmates were listening to Motown and acid rock, Stallman preferred classical music. The memory leads to a rare humorous episode from Stallman's middle-school years. Following the Beatles' 1964 appearance on the Ed Sullivan Show, most of Stallman's classmates rushed out to purchase the latest Beatles albums and singles. Right then and there, Stallman says, he made a decision to boycott the Fab Four.
+
+"I liked some of the pre-Beatles popular music," Stallman says. "But I didn't like the Beatles. I especially disliked the wild way people reacted to them. It was like: who was going to have a Beatles assembly to adulate the Beatles the most?"
+
+When his Beatles boycott failed to take hold, Stallman looked for other ways to point out the herd-mentality of his peers. Stallman says he briefly considered putting together a rock band himself dedicated to satirizing the Liverpool group.
+
+"I wanted to call it Tokyo Rose and the Japanese Beetles."
+
+Given his current love for international folk music, I ask Stallman if he had a similar affinity for Bob Dylan and the other folk musicians of the early 1960s. Stallman shakes his head. "I did like Peter, Paul and Mary," he says. "That reminds me of a great filk."
+
+When I ask for a definition of "filk," Stallman explains the concept. A filk, he says, is a popular song whose lyrics have been replaced with parody lyrics. The process of writing a filk is called filking, and it is a popular activity among hackers and science-fiction aficionados. Classic filks include "On Top of Spaghetti," a rewrite of "On Top of Old Smokey," and "Yoda," filk-master "Weird" Al Yankovic's Star Wars-oriented rendition of the Kinks tune, "Lola."
+
+Stallman asks me if I would be interested in hearing the folk filk. As soon as I say yes, Stallman's voice begins singing in an unexpectedly clear tone:
+
+_1 How much wood could a woodchuck chuck,If a woodchuck could chuck wood? How many poles could a polak lock,If a polak could lock poles? How many knees could a negro grow, If a negro could grow knees? The answer, my dear, is stick it in your ear.The answer is to stick it in your ear.
+
+The singing ends, and Stallman's lips curl into another child-like half smile. I glance around at the nearby tables. The Asian families enjoying their Sunday lunch pay little attention to the bearded alto in their midst.~{ For more Stallman filks, visit<br> http://www.stallman.org/doggerel.html. To hear Stallman singing "The Free Software Song," visit<br> http://www.gnu.org/music/free-software-song.html. }~ After a few moments of hesitation, I finally smile too.
+
+"Do you want that last cornball?" Stallman asks, eyes twinkling. Before I can screw up the punch line, Stallman grabs the corn-encrusted dumpling with his two chopsticks and lifts it proudly. "Maybe I'm the one who should get the cornball," he says.
+
+The food gone, our conversation assumes the dynamics of a normal interview. Stallman reclines in his chair and cradles a cup of tea in his hands. We resume talking about Napster and its relation to the free software movement. Should the principles of free software be extended to similar arenas such as music publishing? I ask.
+
+"It's a mistake to transfer answers from one thing to another," says Stallman, contrasting songs with software programs. "The right approach is to look at each type of work and see what conclusion you get."
+
+When it comes to copyrighted works, Stallman says he divides the world into three categories. The first category involves "functional" works-e.g., software programs, dictionaries, and textbooks. The second category involves works that might best be described as "testimonial"-e.g., scientific papers and historical documents. Such works serve a purpose that would be undermined if subsequent readers or authors were free to modify the work at will. The final category involves works of personal expression-e.g., diaries, journals, and autobiographies. To modify such documents would be to alter a person's recollections or point of view-action Stallman considers ethically unjustifiable.
+
+Of the three categories, the first should give users the unlimited right to make modified versions, while the second and third should regulate that right according to the will of the original author. Regardless of category, however, the freedom to copy and redistribute noncommercially should remain unabridged at all times, Stallman insists. If that means giving Internet users the right to generate a hundred copies of an article, image, song, or book and then email the copies to a hundred strangers, so be it. "It's clear that private occasional redistribution must be permitted, because only a police state can stop that," Stallman says. "It's antisocial to come between people and their friends. Napster has convinced me that we also need to permit, must permit, even noncommercial redistribution to the public for the fun of it. Because so many people want to do that and find it so useful."
+
+When I ask whether the courts would accept such a permissive outlook, Stallman cuts me off.
+
+"That's the wrong question," he says. "I mean now you've changed the subject entirely from one of ethics to one of interpreting laws. And those are two totally different questions in the same field. It's useless to jump from one to the other. How the courts would interpret the existing laws is mainly in a harsh way, because that's the way these laws have been bought by publishers."
+
+The comment provides an insight into Stallman's political philosophy: just because the legal system currently backs up businesses' ability to treat copyright as the software equivalent of land title doesn't mean computer users have to play the game according to those rules. Freedom is an ethical issue, not a legal issue. "I'm looking beyond what the existing laws are to what they should be," Stallman says. "I'm not trying to draft legislation. I'm thinking about what should the law do? I consider the law prohibiting the sharing of copies with your friend the moral equivalent of Jim Crow. It does not deserve respect."
+
+The invocation of Jim Crow prompts another question. How much influence or inspiration does Stallman draw from past political leaders? Like the civil-rights movement of the 1950s and 1960s, his attempt to drive social change is based on an appeal to timeless values: freedom, justice, and fair play.
+
+Stallman divides his attention between my analogy and a particularly tangled strand of hair. When I stretch the analogy to the point where I'm comparing Stallman with Dr. Martin Luther King, Jr., Stallman, after breaking off a split end and popping it into his mouth, cuts me off.
+
+"I'm not in his league, but I do play the same game," he says, chewing.
+
+I suggest Malcolm X as another point of comparison. Like the former Nation of Islam spokesperson, Stallman has built up a reputation for courting controversy, alienating potential allies, and preaching a message favoring self-sufficiency over cultural integration.
+
+Chewing on another split end, Stallman rejects the comparison. "My message is closer to King's message," he says. "It's a universal message. It's a message of firm condemnation of certain practices that mistreat others. It's not a message of hatred for anyone. And it's not aimed at a narrow group of people. I invite anyone to value freedom and to have freedom."
+
+Even so, a suspicious attitude toward political alliances remains a fundamental Stallman character trait. In the case of his well-publicized distaste for the term "open source," the unwillingness to participate in recent coalition-building projects seems understandable. As a man who has spent the last two decades stumping on the behalf of free software, Stallman's political capital is deeply invested in the term. Still, comments such as the "Han Solo" wisecrack at the 1999 LinuxWorld have only reinforced the Stallman's reputation in the software industry as a disgrunted mossback unwilling to roll with political or marketing trends.
+
+"I admire and respect Richard for all the work he's done," says Red Hat president Robert Young, summing up Stallman's paradoxical political nature. "My only critique is that sometimes Richard treats his friends worse than his enemies."
+
+Stallman's unwillingness to seek alliances seems equally perplexing when you consider his political interests outside of the free software movement. Visit Stallman's offices at MIT, and you instantly find a clearinghouse of left-leaning news articles covering civil-rights abuses around the globe. Visit his web site, and you'll find diatribes on the Digital Millennium Copyright Act, the War on Drugs, and the World Trade Organization.
+
+Given his activist tendencies, I ask, why hasn't Stallman sought a larger voice? Why hasn't he used his visibility in the hacker world as a platform to boost rather than reduce his political voice.
+
+Stallman lets his tangled hair drop and contemplates the question for a moment.
+
+"I hesitate to exaggerate the importance of this little puddle of freedom," he says. "Because the more well-known and conventional areas of working for freedom and a better society are tremendously important. I wouldn't say that free software is as important as they are. It's the responsibility I undertook, because it dropped in my lap and I saw a way I could do something about it. But, for example, to end police brutality, to end the war on drugs, to end the kinds of racism we still have, to help everyone have a comfortable life, to protect the rights of people who do abortions, to protect us from theocracy, these are tremendously important issues, far more important than what I do. I just wish I knew how to do something about them."
+
+Once again, Stallman presents his political activity as a function of personal confidence. Given the amount of time it has taken him to develop and hone the free software movement's core tenets, Stallman is hesitant to jump aboard any issues or trends that might transport him into uncharted territory.
+
+"I wish I knew I how to make a major difference on those bigger issues, because I would be tremendously proud if I could, but they're very hard and lots of people who are probably better than I am have been working on them and have gotten only so far," he says. "But as I see it, while other people were defending against these big visible threats, I saw another threat that was unguarded. And so I went to defend against that threat. It may not be as big a threat, but I was the only one there."
+
+Chewing a final split end, Stallman suggests paying the check. Before the waiter can take it away, however, Stallman pulls out a white-colored dollar bill and throws it on the pile. The bill looks so clearly counterfeit, I can't help but pick it up and read it. Sure enough, it is counterfeit. Instead of bearing the image of a George Washington or Abe Lincoln, the bill's front side bears the image of a cartoon pig. Instead of the United States of America, the banner above the pig reads "United Swines of Avarice." The bill is for zero dollars, and when the waiter picks up the money, Stallman makes sure to tug on his sleeve.
+
+"I added an extra zero to your tip," Stallman says, yet another half smile creeping across his lips.
+
+The waiter, uncomprehending or fooled by the look of the bill, smiles and scurries away.
+
+"I think that means we're free to go," Stallman says.
+
+1~ Chapter 6 - The Emacs Commune
+
+The AI Lab of the 1970s was by all accounts a special place. Cutting-edge projects and top-flight researchers gave it an esteemed position in the world of computer science. The internal hacker culture and its anarchic policies lent a rebellious mystique as well. Only later, when many of the lab's scientists and software superstars had departed, would hackers fully realize the unique and ephemeral world they had once inhabited.
+
+"It was a bit like the Garden of Eden," says Stallman, summing up the lab and its software-sharing ethos in a 1998 Forbes article. "It hadn't occurred to us not to cooperate."~{ See Josh McHugh, "For the Love of Hacking," Forbes (August 10, 1998).<br> http://www.forbes.com/forbes/1998/0810/6203094a.html }~
+
+Such mythological descriptions, while extreme, underline an important fact. The ninth floor of 545 Tech Square was more than a workplace for many. For hackers such as Stallman, it was home.
+
+The word "home" is a weighted term in the Stallman lexicon. In a pointed swipe at his parents, Stallman, to this day, refuses to acknowledge any home before Currier House, the dorm he lived in during his days at Harvard. He has also been known to describe leaving that home in tragicomic terms. Once, while describing his years at Harvard, Stallman said his only regret was getting kicked out. It wasn't until I asked Stallman what precipitated his ouster, that I realized I had walked into a classic Stallman setup line.
+
+"At Harvard they have this policy where if you pass too many classes they ask you to leave," Stallman says.
+
+With no dorm and no desire to return to New York, Stallman followed a path blazed by Greenblatt, Gosper, Sussman, and the many other hackers before him. Enrolling at MIT as a grad student, Stallman rented an apartment in nearby Cambridge but soon viewed the AI Lab itself as his de facto home. In a 1986 speech, Stallman recalled his memories of the AI Lab during this period:
+
+_1 I may have done a little bit more living at the lab than most people, because every year or two for some reason or other I'd have no apartment and I would spend a few months living at the lab. And I've always found it very comfortable, as well as nice and cool in the summer. But it was not at all uncommon to find people falling asleep at the lab, again because of their enthusiasm; you stay up as long as you possibly can hacking, because you just don't want to stop. And then when you're completely exhausted, you climb over to the nearest soft horizontal surface. A very informal atmosphere.~{ See Stallman (1986). }~
+
+The lab's home-like atmosphere could be a problem at times. What some saw as a dorm, others viewed as an electronic opium den. In the 1976 book Computer Power and Human Reason, MIT researcher Joseph Weizenbaum offered a withering critique of the " computer bum," Weizenbaum's term for the hackers who populated computer rooms such as the AI Lab. "Their rumpled clothes, their unwashed hair and unshaved faces, and their uncombed hair all testify that they are oblivious to their bodies and to the world in which they move," Weizenbaum wrote. "[Computer bums] exist, at least when so engaged, only through and for the computers."~{ See Joseph Weizenbaum, Computer Power and Human Reason: From Judgment to Calculation (W. H. Freeman, 1976): 116. }~
+
+Almost a quarter century after its publication, Stallman still bristles when hearing Weizenbaum's "computer bum" description, discussing it in the present tense as if Weizenbaum himself was still in the room. "He wants people to be just professionals, doing it for the money and wanting to get away from it and forget about it as soon as possible," Stallman says. "What he sees as a normal state of affairs, I see as a tragedy."
+
+Hacker life, however, was not without tragedy. Stallman characterizes his transition from weekend hacker to full-time AI Lab denizen as a series of painful misfortunes that could only be eased through the euphoria of hacking. As Stallman himself has said, the first misfortune was his graduation from Harvard. Eager to continue his studies in physics, Stallman enrolled as a graduate student at MIT. The choice of schools was a natural one. Not only did it give Stallman the chance to follow the footsteps of great MIT alumni: William Shockley ('36), Richard P. Feynman ('39), and Murray Gell-Mann ('51), it also put him two miles closer to the AI Lab and its new PDP-10 computer. "My attention was going toward programming, but I still thought, well, maybe I can do both," Stallman says.
+
+Toiling in the fields of graduate-level science by day and programming in the monastic confines of the AI Lab by night, Stallman tried to achieve a perfect balance. The fulcrum of this geek teeter-totter was his weekly outing with the folk-dance troupe, his one social outlet that guaranteed at least a modicum of interaction with the opposite sex. Near the end of that first year at MIT, however, disaster struck. A knee injury forced Stallman to drop out of the troupe. At first, Stallman viewed the injury as a temporary problem, devoting the spare time he would have spent dancing to working at the AI Lab even more. By the end of the summer, when the knee still ached and classes reconvened, Stallman began to worry. "My knee wasn't getting any better," Stallman recalls, "which meant I had to stop dancing completely. I was heartbroken."
+
+With no dorm and no dancing, Stallman's social universe imploded. Like an astronaut experiencing the aftereffects of zero-gravity, Stallman found that his ability to interact with nonhackers, especially female nonhackers, had atrophied significantly. After 16 weeks in the AI Lab, the self confidence he'd been quietly accumulating during his 4 years at Harvard was virtually gone.
+
+"I felt basically that I'd lost all my energy," Stallman recalls. "I'd lost my energy to do anything but what was most immediately tempting. The energy to do something else was gone. I was in total despair."
+
+Stallman retreated from the world even further, focusing entirely on his work at the AI Lab. By October, 1975, he dropped out of MIT, never to go back. Software hacking, once a hobby, had become his calling.
+
+Looking back on that period, Stallman sees the transition from full-time student to full-time hacker as inevitable. Sooner or later, he believes, the siren's call of computer hacking would have overpowered his interest in other professional pursuits. "With physics and math, I could never figure out a way to contribute," says Stallman, recalling his struggles prior to the knee injury. "I would have been proud to advance either one of those fields, but I could never see a way to do that. I didn't know where to start. With software, I saw right away how to write things that would run and be useful. The pleasure of that knowledge led me to want to do it more."
+
+Stallman wasn't the first to equate hacking with pleasure. Many of the hackers who staffed the AI Lab boasted similar, incomplete academic rÈsumÈs. Most had come in pursuing degrees in math or electrical engineering only to surrender their academic careers and professional ambitions to the sheer exhilaration that came with solving problems never before addressed. Like St. Thomas Aquinas, the scholastic known for working so long on his theological summae that he sometimes achieved spiritual visions, hackers reached transcendent internal states through sheer mental focus and physical exhaustion. Although Stallman shunned drugs, like most hackers, he enjoyed the "high" that came near the end of a 20-hour coding bender.
+
+Perhaps the most enjoyable emotion, however, was the sense of personal fulfillment. When it came to hacking, Stallman was a natural. A childhood's worth of late-night study sessions gave him the ability to work long hours with little sleep. As a social outcast since age 10, he had little difficulty working alone. And as a mathematician with built-in gift for logic and foresight, Stallman possessed the ability to circumvent design barriers that left most hackers spinning their wheels.
+
+"He was special," recalls Gerald Sussman, an MIT faculty member and former AI Lab researcher. Describing Stallman as a "clear thinker and a clear designer," Sussman employed Stallman as a research-project assistant beginning in 1975. The project was complex, involving the creation of an AI program that could analyze circuit diagrams. Not only did it involve an expert's command of Lisp, a programming language built specifically for AI applications, but it also required an understanding of how a human might approach the same task.
+
+When he wasn't working on official projects such as Sussman's automated circuit-analysis program, Stallman devoted his time to pet projects. It was in a hacker's best interest to improve the lab's software infrastructure, and one of Stallman's biggest pet projects during this period was the lab's editor program TECO.
+
+The story of Stallman's work on TECO during the 1970s is inextricably linked with Stallman's later leadership of the free software movement. It is also a significant stage in the history of computer evolution, so much so that a brief recapitulation of that evolution is necessary. During the 1950s and 1960s, when computers were first appearing at universities, computer programming was an incredibly abstract pursuit. To communicate with the machine, programmers created a series of punch cards, with each card representing an individual software command. Programmers would then hand the cards over to a central system administrator who would then insert them, one by one, into the machine, waiting for the machine to spit out a new set of punch cards, which the programmer would then decipher as output. This process, known as " batch processing," was cumbersome and time consuming. It was also prone to abuses of authority. One of the motivating factors behind hackers' inbred aversion to centralization was the power held by early system operators in dictating which jobs held top priority.
+
+In 1962, computer scientists and hackers involved in MIT's Project MAC, an early forerunner of the AI Lab, took steps to alleviate this frustration. Time-sharing, originally known as "time stealing," made it possible for multiple programs to take advantage of a machine's operational capabilities. Teletype interfaces also made it possible to communicate with a machine not through a series of punched holes but through actual text. A programmer typed in commands and read the line-by-line output generated by the machine.
+
+During the late 1960s, interface design made additional leaps. In a famous 1968 lecture, Doug Engelbart, a scientist then working at the Stanford Research Institute, unveiled a prototype of the modern graphical interface. Rigging up a television set to the computer and adding a pointer device which Engelbart dubbed a " mouse," the scientist created a system even more interactive than the time-sharing system developed a MIT. Treating the video display like a high-speed printer, Engelbart's system gave a user the ability to move the cursor around the screen and see the cursor position updated by the computer in real time. The user suddenly had the ability to position text anywhere on the screen.
+
+Such innovations would take another two decades to make their way into the commercial marketplace. Still, by the 1970s, video screens had started to replace teletypes as display terminals, creating the potential for full-screen-as opposed to line-by-line-editing capabilities.
+
+One of the first programs to take advantage of this full-screen capability was the MIT AI Lab's TECO. Short for Text Editor and COrrector, the program had been upgraded by hackers from an old teletype line editor for the lab's PDP-6 machine.~{ According to the Jargon File, TECO's name originally stood for Tape Editor and Corrector.<br> http://www.tuxedo.org/~esr/jargon/html/entry/TECO.html }~
+
+TECO was a substantial improvement over old editors, but it still had its drawbacks. To create and edit a document, a programmer had to enter a series of software commands specifying each edit. It was an abstract process. Unlike modern word processors, which update text with each keystroke, TECO demanded that the user enter an extended series of editing instructions followed by an "end of command" sequence just to change the text.Over time, a hacker grew proficient enough to write entire documents in edit mode, but as Stallman himself would later point out, the process required "a mental skill like that of blindfold chess."~{ See Richard Stallman, "EMACS: The Extensible, Customizable, Display Editor," AI Lab Memo (1979). An updated HTML version of this memo, from which I am quoting, is available at<br> http://www.gnu.org/software/emacs/emacs-paper.html }~
+
+To facilitate the process, AI Lab hackers had built a system that displayed both the "source" and "display" modes on a split screen. Despite this innovative hack, switching from mode to mode was still a nuisance.
+
+TECO wasn't the only full-screen editor floating around the computer world at this time. During a visit to the Stanford Artificial Intelligence Lab in 1976, Stallman encountered an edit program named E. The program contained an internal feature, which allowed a user to update display text after each command keystroke. In the language of 1970s programming, E was one of the first rudimentary WYSIWYG editors. Short for "what you see is what you get," WYSIWYG meant that a user could manipulate the file by moving through the displayed text, as opposed to working through a back-end editor program."~{ See Richard Stallman, "Emacs the Full Screen Editor" (1987).<br> http://www.lysator.liu.se/history/garb/txt/87-1-emacs.txt }~
+
+Impressed by the hack, Stallman looked for ways to expand TECO's functionality in similar fashion upon his return to MIT. He found a TECO feature called Control-R, written by Carl Mikkelson and named after the two-key combination that triggered it. Mikkelson's hack switched TECO from its usual abstract command-execution mode to a more intuitive keystroke-by-keystroke mode. Stallman revised the feature in a subtle but significant way. He made it possible to trigger other TECO command strings, or " macros," using other, two-key combinations. Where users had once entered command strings and discarded them after entering then, Stallman's hack made it possible to save macro tricks on file and call them up at will. Mikkelson's hack had raised TECO to the level of a WYSIWYG editor. Stallman's hack had raised it to the level of a user-programmable WYSIWYG editor. "That was the real breakthrough," says Guy Steele, a fellow AI Lab hacker at the time. ^39^
+
+By Stallman's own recollection, the macro hack touched off an explosion of further innovation. "Everybody and his brother was writing his own collection of redefined screen-editor commands, a command for everything he typically liked to do," Stallman would later recall. "People would pass them around and improve them, making them more powerful and more general. The collections of redefinitions gradually became system programs in their own right." ^39^
+
+So many people found the macro innovations useful and had incorporated it into their own TECO programs that the TECO editor had become secondary to the macro mania it inspired. "We started to categorize it mentally as a programming language rather than as an editor," Stallman says. Users were experiencing their own pleasure tweaking the software and trading new ideas. ^39^
+
+Two years after the explosion, the rate of innovation began to exhibit dangerous side effects. The explosive growth had provided an exciting validation of the collaborative hacker approach, but it had also led to over-complexity. "We had a Tower of Babel effect," says Guy Steele.
+
+The effect threatened to kill the spirit that had created it, Steele says. Hackers had designed ITS to facilitate programmers' ability to share knowledge and improve each other's work. That meant being able to sit down at another programmer's desk, open up a programmer's work and make comments and modifications directly within the software. "Sometimes the easiest way to show somebody how to program or debug something was simply to sit down at the terminal and do it for them," explains Steele.
+
+The macro feature, after its second year, began to foil this capability. In their eagerness to embrace the new full-screen capabilities, hackers had customized their versions of TECO to the point where a hacker sitting down at another hacker's terminal usually had to spend the first hour just figuring out what macro commands did what.
+
+Frustrated, Steele took it upon himself to the solve the problem. He gathered together the four different macro packages and began assembling a chart documenting the most useful macro commands. In the course of implementing the design specified by the chart, Steele says he attracted Stallman's attention.
+
+"He started looking over my shoulder, asking me what I was doing," recalls Steele.
+
+For Steele, a soft-spoken hacker who interacted with Stallman infrequently, the memory still sticks out. Looking over another hacker's shoulder while he worked was a common activity at the AI Lab. Stallman, the TECO maintainer at the lab, deemed Steele's work "interesting" and quickly set off to complete it.
+
+"As I like to say, I did the first 0.001 percent of the implementation, and Stallman did the rest," says Steele with a laugh.
+
+The project's new name, Emacs, came courtesy of Stallman. Short for "editing macros," it signified the evolutionary transcendence that had taken place during the macros explosion two years before. It also took advantage of a gap in the software programming lexicon. Noting a lack of programs on ITS starting with the letter "E," Stallman chose Emacs, making it possible to reference the program with a single letter. Once again, the hacker lust for efficiency had left its mark. ^39^
+
+In the course of developing a standard system of macro commands, Stallman and Steele had to traverse a political tightrope. In creating a standard program, Stallman was in clear violation of the fundamental hacker tenet-"promote decentralization." He was also threatening to hobble the very flexibility that had fueled TECO's explosive innovation in the first place.
+
+"On the one hand, we were trying to make a uniform command set again; on the other hand, we wanted to keep it open ended, because the programmability was important," recalls Steele.
+
+To solve the problem, Stallman, Steele, and fellow hackers David Moon and Dan Weinreib limited their standardization effort to the WYSIWYG commands that controlled how text appeared on-screen. The rest of the Emacs effort would be devoted to retaining the program's Tinker Toy-style extensibility.
+
+Stallman now faced another conundrum: if users made changes but didn't communicate those changes back to the rest of the community, the Tower of Babel effect would simply emerge in other places. Falling back on the hacker doctrine of sharing innovation, Stallman embedded a statement within the source code that set the terms of use. Users were free to modify and redistribute the code on the condition that they gave back all the extensions they made. Stallman dubbed it the " Emacs Commune." Just as TECO had become more than a simple editor, Emacs had become more than a simple software program. To Stallman, it was a social contract. In an early memo documenting the project, Stallman spelled out the contract terms. "EMACS," he wrote, "was distributed on a basis of communal sharing, which means that all improvements must be given back to me to be incorporated and distributed."~{ See Stallman (1979): #SEC34. }~
+
+Not everybody accepted the contract. The explosive innovation continued throughout the decade, resulting in a host of Emacs-like programs with varying degrees of cross-compatibility. A few cited their relation to Stallman's original Emacs with humorously recursive names: Sine (Sine is not Emacs), Eine (Eine is not Emacs), and Zwei (Zwei was Eine initially). As a devoted exponent of the hacker ethic, Stallman saw no reason to halt this innovation through legal harassment. Still, the fact that some people would so eagerly take software from the community chest, alter it, and slap a new name on the resulting software displayed a stunning lack of courtesy.
+
+Such rude behavior was reflected against other, unsettling developments in the hacker community. Brian Reid's 1979 decision to embed "time bombs" in Scribe, making it possible for Unilogic to limit unpaid user access to the software, was a dark omen to Stallman. "He considered it the most Nazi thing he ever saw in his life," recalls Reid. Despite going on to later Internet fame as the cocreator of the Usenet alt heirarchy, Reid says he still has yet to live down that 1979 decision, at least in Stallman's eyes. "He said that all software should be free and the prospect of charging money for software was a crime against humanity."~{ In a 1996 interview with online magazine MEME, Stallman cited Scribe's sale as irksome, but hesitated to mention Reid by name. "The problem was nobody censured or punished this student for what he did," Stallman said. "The result was other people got tempted to follow his example." See MEME 2.04.<br> http://memex.org/meme2-04.html }~
+
+Although Stallman had been powerless to head off Reid's sale, he did possess the ability to curtail other forms of behavior deemed contrary to the hacker ethos. As central source-code maintainer for the Emacs "commune," Stallman began to wield his power for political effect. During his final stages of conflict with the administrators at the Laboratory for Computer Science over password systems, Stallman initiated a software " strike,"~{ See Steven Levy, Hackers (Penguin USA [paperback], 1984): 419. }~ refusing to send lab members the latest version of Emacs until they rejected the security system on the lab's computers. The move did little to improve Stallman's growing reputation as an extremist, but it got the point across: commune members were expected to speak up for basic hacker values.
+
+"A lot of people were angry with me, saying I was trying to hold them hostage or blackmail them, which in a sense I was," Stallman would later tell author Steven Levy. "I was engaging in violence against them because I thought they were engaging in violence to everyone at large." ^42^
+
+Over time, Emacs became a sales tool for the hacker ethic. The flexibility Stallman and built into the software not only encouraged collaboration, it demanded it. Users who didn't keep abreast of the latest developments in Emacs evolution or didn't contribute their contributions back to Stallman ran the risk of missing out on the latest breakthroughs. And the breakthroughs were many. Twenty years later, users had modified Emacs for so many different uses-using it as a spreadsheet, calculator, database, and web browser-that later Emacs developers adopted an overflowing sink to represent its versatile functionality. "That's the idea that we wanted to convey," says Stallman. "The amount of stuff it has contained within it is both wonderful and awful at the same time."
+
+Stallman's AI Lab contemporaries are more charitable. Hal Abelson, an MIT grad student who worked with Stallman during the 1970s and would later assist Stallman as a charter boardmember of the Free Software Foundation, describes Emacs as "an absolutely brilliant creation." In giving programmers a way to add new software libraries and features without messing up the system, Abelson says, Stallman paved the way for future large-scale collaborative software projects. "Its structure was robust enough that you'd have people all over the world who were loosely collaborating [and] contributing to it," Abelson says. "I don't know if that had been done before."~{ In writing this chapter, I've elected to focus more on the social significance of Emacs than the software significance. To read more about the software side, I recommend Stallman's 1979 memo. I particularly recommend the section titled "Research Through Development of Installed Tools" (#SEC27). Not only is it accessible to the nontechnical reader, it also sheds light on how closely intertwined Stallman's political philosophies are with his software-design philosophies. A sample excerpt follows:<br>_1 EMACS could not have been reached by a process of careful design, because such processes arrive only at goals which are visible at the outset, and whose desirability is established on the bottom line at the outset. Neither I nor anyone else visualized an extensible editor until I had made one, nor appreciated its value until he had experienced it. EMACS exists because I felt free to make individually useful small improvements on a path whose end was not in sight. }~
+
+Guy Steele expresses similar admiration. Currently a research scientist for Sun Microsystems, he remembers Stallman primarily as a "brilliant programmer with the ability to generate large quantities of relatively bug-free code." Although their personalities didn't exactly mesh, Steele and Stallman collaborated long enough for Steele to get a glimpse of Stallman's intense coding style. He recalls a notable episode in the late 1970s when the two programmers banded together to write the editor's "pretty print" feature. Originally conceived by Steele, pretty print was another keystroke-triggerd feature that reformatted Emacs' source code so that it was both more readable and took up less space, further bolstering the program's WYSIWIG qualities. The feature was strategic enough to attract Stallman's active interest, and it wasn't long before Steele wrote that he and Stallman were planning an improved version.
+
+"We sat down one morning," recalls Steele. "I was at the keyboard, and he was at my elbow," says Steele. "He was perfectly willing to let me type, but he was also telling me what to type.
+
+The programming session lasted 10 hours. Throughout that entire time, Steele says, neither he nor Stallman took a break or made any small talk. By the end of the session, they had managed to hack the pretty print source code to just under 100 lines. "My fingers were on the keyboard the whole time," Steele recalls, "but it felt like both of our ideas were flowing onto the screen. He told me what to type, and I typed it."
+
+The length of the session revealed itself when Steele finally left the AI Lab. Standing outside the building at 545 Tech Square, he was surprised to find himself surrounded by nighttime darkness. As a programmer, Steele was used to marathon coding sessions. Still, something about this session was different. Working with Stallman had forced Steele to block out all external stimuli and focus his entire mental energies on the task at hand. Looking back, Steele says he found the Stallman mind-meld both exhilarating and scary at the same time. "My first thought afterward was: it was a great experience, very intense, and that I never wanted to do it again in my life."
+
+1~ Chapter 7 - A Stark Moral Choice
+
+On September 27, 1983, computer programmers logging on to the Usenet newsgroup net.unix-wizards encountered an unusual message. Posted in the small hours of the morning, 12:30 a.m. to be exact, and signed by rms@mit-oz, the message's subject line was terse but attention-grabbing. "New UNIX implementation," it read. Instead of introducing a newly released version of Unix, however, the message's opening paragraph issued a call to arms:
+
+_1 Starting this Thanksgiving I am going to write a complete Unix-compatible software system called GNU (for Gnu's Not Unix), and give it away free to everyone who can use it. Contributions of time, money, programs and equipment are greatly needed.~{ See Richard Stallman, "Initial GNU Announcement" (September 1983).<br> http://www.gnu.ai.mit.edu/gnu/initial-announcement.html }~
+
+To an experienced Unix developer, the message was a mixture of idealism and hubris. Not only did the author pledge to rebuild the already mature Unix operating system from the ground up, he also proposed to improve it in places. The new GNU system, the author predicted, would carry all the usual components-a text editor, a shell program to run Unix-compatible applications, a compiler, "and a few other things." ^44^ It would also contain many enticing features that other Unix systems didn't yet offer: a graphic user interface based on the Lisp programming language, a crash-proof file system, and networking protocols built according to MIT's internal networking system.
+
+"GNU will be able to run Unix programs, but will not be identical to Unix," the author wrote. "We will make all improvements that are convenient, based on our experience with other operating systems."
+
+Anticipating a skeptical response on some readers' part, the author made sure to follow up his operating-system outline with a brief biographical sketch titled, "Who am I?":
+
+_1 I am Richard Stallman, inventor of the original much-imitated EMACS editor, now at the Artificial Intelligence Lab at MIT. I have worked extensively on compilers, editors, debuggers, command interpreters, the Incompatible Timesharing System and the Lisp Machine operating system. I pioneered terminal-independent display support in ITS. In addition I have implemented one crashproof file system and two window systems for Lisp machines. ^44^
+
+As fate would have it, Stallman's fanciful GNU Project missed its Thanksgiving launch date. By January, 1984, however, Stallman made good on his promise and fully immersed himself in the world of Unix software development. For a software architect raised on ITS, it was like designing suburban shopping malls instead of Moorish palaces. Even so, building a Unix-like operating system had its hidden advantages. ITS had been powerful, but it also possessed an Achilles' heel: MIT hackers had designed it to take specific advantage of the DEC-built PDP line. When AI Lab administrators elected to phase out the lab's powerful PDP-10 machine in the early 1980s, the operating system that hackers once likened to a vibrant city became an instant ghost town. Unix, on the other hand, was designed for mobility and long-term survival. Originally developed by junior scientists at AT&T, the program had slipped out under corporate-management radar, finding a happy home in the cash-strapped world of academic computer systems. With fewer resources than their MIT brethren, Unix developers had customized the software to ride atop a motley assortment of hardware systems: everything from the 16-bit PDP-11-a machine considered fit for only small tasks by most AI Lab hackers-to 32-bit mainframes such as the VAX 11/780. By 1983, a few companies, most notably Sun Microsystems, were even going so far as to develop a new generation of microcomputers, dubbed "workstations," to take advantage of the increasingly ubiquitous operating system.
+
+To facilitate this process, the developers in charge of designing the dominant Unix strains made sure to keep an extra layer of abstraction between the software and the machine. Instead of tailoring the operating system to take advantage of a specific machine's resources-as the AI Lab hackers had done with ITS and the PDP-10-Unix developers favored a more generic, off-the-rack approach. Focusing more on the interlocking standards and specifications that held the operating system's many subcomponents together, rather than the actual components themselves, they created a system that could be quickly modified to suit the tastes of any machine. If a user quibbled with a certain portion, the standards made it possible to pull out an individual subcomponent and either fix it or replace it with something better. Simply put, what the Unix approach lacked in terms of style or aesthetics, it more than made up for in terms of flexibility and economy, hence its rapid adoption.~{ See Marshall Kirk McKusick, "Twenty Years of Berkeley Unix," Open Sources (O'Reilly & Associates, Inc., 1999): 38. }~
+
+Stallman's decision to start developing the GNU system was triggered by the end of the ITS system that the AI Lab hackers had nurtured for so long. The demise of ITS had been a traumatic blow to Stallman. Coming on the heels of the Xerox laser printer episode, it offered further evidence that the AI Lab hacker culture was losing its immunity to business practices in the outside world.
+
+Like the software code that composed it, the roots of ITS' demise stretched way back. Defense spending, long a major font for computer-science research, had dried up during the post-Vietnam years. In a desperate quest for new funds, laboratories and universities turned to the private sector. In the case of the AI Lab, winning over private investors was an easy sell. Home to some of the most ambitious computer-science projects of the post-war era, the lab became a quick incubator of technology. Indeed, by 1980, most of the lab's staff, including many hackers, were dividing its time between Institute and commercial projects.
+
+What at first seemed like a win-win deal-hackers got to work on the best projects, giving the lab first look at many of the newest computer technologies coming down the pike-soon revealed itself as a Faustian bargain. The more time hackers devoted to cutting-edge commercial projects, the less time they had to devote to general maintenance on the lab's baroque software infrastructure. Soon, companies began hiring away hackers outright in an attempt to monopolize their time and attention. With fewer hackers to mind the shop, programs and machines took longer to fix. Even worse, Stallman says, the lab began to undergo a "demographic change." The hackers who had once formed a vocal minority within the AI Lab were losing membership while "the professors and the students who didn't really love the [PDP-10] were just as numerous as before."3
+
+The breaking point came in 1982. That was the year the lab's administration decided to upgrade its main computer, the PDP-10. Digital, the corporation that manufactured the PDP-10, had discontinued the line. Although the company still offered a high-powered mainframe, dubbed the KL-10, the new machine required a drastic rewrite or "port" of ITS if hackers wanted to continue running the same operating system. Fearful that the lab had lost its critical mass of in-house programming talent, AI Lab faculty members pressed for Twenex, a commercial operating system developed by Digital. Outnumbered, the hackers had no choice but to comply.
+
+"Without hackers to maintain the system, [faculty members] said, `We're going to have a disaster; we must have commercial software,'" Stallman would recall a few years later. "They said, `We can expect the company to maintain it.' It proved that they were utterly wrong, but that's what they did."~{ See Richard Stallman (1986). }~
+
+At first, hackers viewed the Twenex system as yet another authoritarian symbol begging to be subverted. The system's name itself was a protest. Officially dubbed TOPS-20 by DEC, it was a successor to TOPS-10, a commercial operating system DEC marketed for the PDP-10. Bolt Beranek Newman had deveoped an improved version, dubbed Tenex, which TOPS-20 drew upon.~{ Multiple sources: see Richard Stallman interview, Gerald Sussman email, and Jargon File 3.0.0.<br> http://www.clueless.com/jargon3.0.0/TWENEX.html }~ Stallman, the hacker who coined the Twenex term, says he came up with the name as a way to avoid using the TOPS-20 name. "The system was far from tops, so there was no way I was going to call it that," Stallman recalls. "So I decided to insert a `w' in the Tenex name and call it Twenex."
+
+The machine that ran the Twenex/TOPS-20 system had its own derisive nickname: Oz. According to one hacker legend, the machine got its nickname because it required a smaller PDP-11 machine to power its terminal. One hacker, upon viewing the KL-10-PDP-11 setup for the first time, likened it to the wizard's bombastic onscreen introduction in the Wizard of Oz. "I am the great and powerful Oz," the hacker intoned. "Pay no attention to the PDP-11 behind that console."~{ See http://www.as.cmu.edu/~geek/humor/See_Figure_1.txt }~
+
+If hackers laughed when they first encountered the KL-10, their laughter quickly died when they encountered Twenex. Not only did Twenex boast built-in security, but the system's software engineers had designed the tools and applications with the security system in mind. What once had been a cat-and-mouse game over passwords in the case of the Laboratory for Computer Science's security system, now became an out-and-out battle over system management. System administrators argued that without security, the Oz system was more prone to accidental crashes. Hackers argued that crashes could be better prevented by overhauling the source code. Unfortunately, the number of hackers with the time and inclination to perform this sort of overhaul had dwindled to the point that the system-administrator argument prevailed.
+
+Cadging passwords and deliberately crashing the system in order to glean evidence from the resulting wreckage, Stallman successfully foiled the system administrators' attempt to assert control. After one foiled "coup d'etat," Stallman issued an alert to the entire AI staff. ^46^
+
+"There has been another attempt to seize power," Stallman wrote. "So far, the aristocratic forces have been defeated." To protect his identity, Stallman signed the message "Radio Free OZ."
+
+The disguise was a thin one at best. By 1982, Stallman's aversion to passwords and secrecy had become so well known that users outside the AI Laboratory were using his account as a stepping stone to the ARPAnet, the research-funded computer network that would serve as a foundation for today's Internet. One such "tourist" during the early 1980s was Don Hopkins, a California programmer who learned through the hacking grapevine that all an outsider needed to do to gain access to MIT's vaunted ITS system was to log in under the initials RMS and enter the same three-letter monogram when the system requested a password.
+
+"I'm eternally grateful that MIT let me and many other people use their computers for free," says Hopkins. "It meant a lot to many people."
+
+This so-called "tourist" policy, which had been openly tolerated by MIT management during the ITS years,~{ See "MIT AI Lab Tourist Policy."<br> http://catalog.com/hopkins/text/tourist-policy.html }~ fell by the wayside when Oz became the lab's primary link to the ARPAnet. At first, Stallman continued his policy of repeating his login ID as a password so outside users could follow in his footsteps. Over time, however, the Oz's fragility prompted administrators to bar outsiders who, through sheer accident or malicious intent, might bring down the system. When those same administrators eventually demanded that Stallman stop publishing his password, Stallman, citing personal ethics, refused to do so and ceased using the Oz system altogether. ^46^
+
+"[When] passwords first appeared at the MIT AI Lab I [decided] to follow my belief that there should be no passwords," Stallman would later say. "Because I don't believe that it's really desirable to have security on a computer, I shouldn't be willing to help uphold the security regime." ^46^
+
+Stallman's refusal to bow before the great and powerful Oz symbolized the growing tension between hackers and AI Lab management during the early 1980s. This tension paled in comparison to the conflict that raged within the hacker community itself. By the time the KL-10 arrived, the hacker community had already divided into two camps. The first centered around a software company called Symbolics, Inc. The second centered around Symbolics chief rival, Lisp Machines, Inc. (LMI). Both companies were in a race to market the Lisp Machine, a device built to take full advantage of the Lisp programming language.
+
+Created by artificial-intelligence research pioneer John McCarthy, a MIT artificial-intelligence researcher during the late 1950s, Lisp is an elegant language well-suited for programs charged with heavy-duty sorting and processing. The language's name is a shortened version of LISt Processing. Following McCarthy's departure to the Stanford Artificial Intelligence Laboratory, MIT hackers refined the language into a local dialect dubbed MACLISP. The "MAC" stood for Project MAC, the DARPA-funded research project that gave birth to the AI Lab and the Laboratory for Computer Science. Led by AI Lab arch-hacker Richard Greenblatt, AI Lab programmers during the 1970s built up an entire Lisp-based operating system, dubbed the Lisp Machine operating system. By 1980, the Lisp Machine project had generated two commercial spin-offs. Symbolics was headed by Russell Noftsker, a former AI Lab administrator, and Lisp Machines, Inc., was headed by Greenblatt.
+
+The Lisp Machine software was hacker-built, meaning it was owned by MIT but available for anyone to copy as per hacker custom. Such a system limited the marketing advantage of any company hoping to license the software from MIT and market it as unique. To secure an advantage, and to bolster the aspects of the operating system that customers might consider attractive, the companies recruited various AI Lab hackers and set them working on various components of the Lisp Machine operating system outside the auspices of the AI Lab.
+
+The most aggressive in this strategy was Symbolics. By the end of 1980, the company had hired 14 AI Lab staffers as part-time consultants to develop its version of the Lisp Machine. Apart from Stallman, the rest signed on to help LMI.~{ See H. P. Newquist, The Brain Makers: Genius, Ego, and Greed in the Quest for Machines that Think (Sams Publishing, 1994): 172. }~
+
+At first, Stallman accepted both companies' attempt to commercialize the Lisp machine, even though it meant more work for him. Both licensed the Lisp Machine OS source code from MIT, and it was Stallman's job to update the lab's own Lisp Machine to keep pace with the latest innovations. Although Symbolics' license with MIT gave Stallman the right to review, but not copy, Symbolics' source code, Stallman says a "gentleman's agreement" between Symbolics management and the AI Lab made it possible to borrow attractive snippets in traditional hacker fashion.
+
+On March 16, 1982, a date Stallman remembers well because it was his birthday, Symbolics executives decided to end this gentlemen's agreement. The move was largely strategic. LMI, the primary competition in the Lisp Machine marketplace, was essentially using a copy of the AI Lab Lisp Machine. Rather than subsidize the development of a market rival, Symbolics executives elected to enforce the letter of the license. If the AI Lab wanted its operating system to stay current with the Symbolics operating system, the lab would have to switch over to a Symbolics machine and sever its connection to LMI.
+
+As the person responsible for keeping up the lab's Lisp Machine, Stallman was incensed. Viewing this announcement as an "ultimatum," he retaliated by disconnecting Symbolics' microwave communications link to the laboratory. He then vowed never to work on a Symbolics machine and pledged his immediate allegiance to LMI. "The way I saw it, the AI Lab was a neutral country, like Belgium in World War I," Stallman says. "If Germany invades Belgium, Belgium declares war on Germany and sides with Britain and France."
+
+The circumstances of the so-called "Symbolics War" of 1982-1983 depend heavily on the source doing the telling. When Symbolics executives noticed that their latest features were still appearing in the AI Lab Lisp Machine and, by extension, the LMI Lisp machine, they installed a "spy" program on Stallman's computer terminal. Stallman says he was rewriting the features from scratch, taking advantage of the license's review clause but also taking pains to make the source code as different as possible. Symbolics executives argued otherwise and took their case to MIT administration. According to 1994 book, The Brain Makers: Genius, Ego, and Greed, and the Quest for Machines That Think, written by Harvey Newquist, the administration responded with a warning to Stallman to "stay away" from the Lisp Machine project.~{ Ibid.: 196. }~ According to Stallman, MIT administrators backed Stallman up. "I was never threatened," he says. "I did make changes in my practices, though. Just to be ultra safe, I no longer read their source code. I used only the documentation and wrote the code from that."
+
+Whatever the outcome, the bickering solidified Stallman's resolve. With no source code to review, Stallman filled in the software gaps according to his own tastes and enlisted members of the AI Lab to provide a continuous stream of bug reports. He also made sure LMI programmers had direct access to the changes. "I was going to punish Symbolics if it was the last thing I did," Stallman says.
+
+Such statements are revealing. Not only do they shed light on Stallman's nonpacifist nature, they also reflect the intense level of emotion triggered by the conflict. According to another Newquist-related story, Stallman became so irate at one point that he issued an email threatening to "wrap myself in dynamite and walk into Symbolics' offices."~{ Ibid. Newquist, who says this anecdote was confirmed by several Symbolics executives, writes, "The message caused a brief flurry of excitement and speculation on the part of Symbolics' employees, but ultimately, no one took Stallman's outburst that seriously." }~ Although Stallman would deny any memory of the email and still describes its existence as a "vicious rumor," he acknowledges that such thoughts did enter his head. "I definitely did have fantasies of killing myself and destroying their building in the process," Stallman says. "I thought my life was over." ^48^
+
+The level of despair owed much to what Stallman viewed as the "destruction" of his "home"-i.e., the demise of the AI Lab's close-knit hacker subculture. In a later email interview with Levy, Stallman would liken himself to the historical figure Ishi, the last surviving member of the Yahi, a Pacific Northwest tribe wiped out during the Indian wars of the 1860s and 1870s. The analogy casts Stallman's survival in epic, almost mythical, terms. In reality, however, it glosses over the tension between Stallman and his fellow AI Lab hackers prior to the Symbolics-LMI schism. Instead of seeing Symbolics as an exterminating force, many of Stallman's colleagues saw it as a belated bid for relevance. In commercializing the Lisp Machine, the company pushed hacker principles of engineer-driven software design out of the ivory-tower confines of the AI Lab and into the corporate marketplace where manager-driven design principles held sway. Rather than viewing Stallman as a holdout, many hackers saw him as a troubling anachronism.
+
+Stallman does not dispute this alternate view of historical events. In fact, he says it was yet another reason for the hostility triggered by the Symbolics "ultimatum." Even before Symbolics hired away most of the AI Lab's hacker staff, Stallman says many of the hackers who later joined Symbolics were shunning him. "I was no longer getting invited to go to Chinatown," Stallman recalls. "The custom started by Greenblatt was that if you went out to dinner, you went around or sent a message asking anybody at the lab if they also wanted to go. Sometime around 1980-1981, I stopped getting asked. They were not only not inviting me, but one person later confessed that he had been pressured to lie to me to keep their going away to dinner without me a secret."
+
+Although Stallman felt anger toward the hackers who orchestrated this petty form of ostracism, the Symbolics controversy dredged up a new kind of anger, the anger of a person about to lose his home. When Symbolics stopped sending over its source-code changes, Stallman responded by holing up in his MIT offices and rewriting each new software feature and tool from scratch. Frustrating as it may have been, it guaranteed that future Lisp Machine users had unfettered access to the same features as Symbolics users.
+
+It also guaranteed Stallman's legendary status within the hacker community. Already renowned for his work with Emacs, Stallman's ability to match the output of an entire team of Symbolics programmers-a team that included more than a few legendary hackers itself-still stands has one of the major human accomplishments of the Information Age, or of any age for that matter. Dubbing it a "master hack" and Stallman himself a "virtual John Henry of computer code," author Steven Levy notes that many of his Symbolics-employed rivals had no choice but to pay their idealistic former comrade grudging respect. Levy quotes Bill Gosper, a hacker who eventually went to work for Symbolics in the company's Palo Alto office, expressing amazement over Stallman's output during this period:
+
+_1 I can see something Stallman wrote, and I might decide it was bad (probably not, but somebody could convince me it was bad), and I would still say, "But wait a minute-Stallman doesn't have anybody to argue with all night over there. He's working alone! It's incredible anyone could do this alone!"~{ See Steven Levy, Hackers (Penguin USA [paperback], 1984): 426. }~
+
+For Stallman, the months spent playing catch up with Symbolics evoke a mixture of pride and profound sadness. As a dyed-in-the-wool liberal whose father had served in World War II, Stallman is no pacifist. In many ways, the Symbolics war offered the rite of passage toward which Stallman had been careening ever since joining the AI Lab staff a decade before. At the same time, however, it coincided with the traumatic destruction of the AI Lab hacker culture that had nurtured Stallman since his teenage years. One day, while taking a break from writing code, Stallman experienced a traumatic moment passing through the lab's equipment room. There, Stallman encountered the hulking, unused frame of the PDP-10 machine. Startled by the dormant lights, lights that once actively blinked out a silent code indicating the status of the internal program, Stallman says the emotional impact was not unlike coming across a beloved family member's well-preserved corpse.
+
+"I started crying right there in the equipment room," he says. "Seeing the machine there, dead, with nobody left to fix it, it all drove home how completely my community had been destroyed."
+
+Stallman would have little opportunity to mourn. The Lisp Machine, despite all the furor it invoked and all the labor that had gone into making it, was merely a sideshow to the large battles in the technology marketplace. The relentless pace of computer miniaturization was bringing in newer, more powerful microprocessors that would soon incorporate the machine's hardware and software capabilities like a modern metropolis swallowing up an ancient desert village.
+
+Riding atop this microprocessor wave were hundreds-thousands-of commercial software programs, each protected by a patchwork of user licenses and nondisclosure agreements that made it impossible for hackers to review or share source code. The licenses were crude and ill-fitting, but by 1983 they had become strong enough to satisfy the courts and scare away would-be interlopers. Software, once a form of garnish most hardware companies gave away to make their expensive computer systems more flavorful, was quickly becoming the main dish. In their increasing hunger for new games and features, users were putting aside the traditional demand to review the recipe after every meal.
+
+Nowhere was this state of affairs more evident than in the realm of personal computer systems. Companies such as Apple Computer and Commodore were minting fresh millionaires selling machines with built-in operating systems. Unaware of the hacker culture and its distaste for binary-only software, many of these users saw little need to protest when these companies failed to attach the accompanying source-code files. A few anarchic adherents of the hacker ethic helped propel that ethic into this new marketplace, but for the most part, the marketplace rewarded the programmers speedy enough to write new programs and savvy enough to copyright them as legally protected works.
+
+One of the most notorious of these programmers was Bill Gates, a Harvard dropout two years Stallman's junior. Although Stallman didn't know it at the time, seven years before sending out his message to the n et.unix-wizards newsgroup, Gates, a budding entrepreneur and general partner with the Albuquerque-based software firm Micro-Soft, later spelled as Microsoft, had sent out his own open letter to the software-developer community. Written in response to the PC users copying Micro-Soft's software programs, Gates' " Open Letter to Hobbyists" had excoriated the notion of communal software development.
+
+"Who can afford to do professional work for nothing?" asked Gates. "What hobbyist can put three man-years into programming, finding all bugs, documenting his product, and distributing it for free?"~{ See Bill Gates, "An Open Letter to Hobbyists" (February 3, 1976).<br>To view an online copy of this letter, go to<br> http://www.blinkenlights.com/classiccmp/gateswhine.html. }~
+
+Although few hackers at the AI Lab saw the missive, Gates' 1976 letter nevertheless represented the changing attitude toward software both among commercial software companies and commercial software developers. Why treat software as a zero-cost commodity when the market said otherwise? As the 1970s gave way to the 1980s, selling software became more than a way to recoup costs; it became a political statement. At a time when the Reagan Administration was rushing to dismantle many of the federal regulations and spending programs that had been built up during the half century following the Great Depression, more than a few software programmers saw the hacker ethic as anticompetitive and, by extension, un-American. At best, it was a throwback to the anticorporate attitudes of the late 1960s and early 1970s. Like a Wall Street banker discovering an old tie-dyed shirt hiding between French-cuffed shirts and double-breasted suits, many computer programmers treated the hacker ethic as an embarrassing reminder of an idealistic age.
+
+For a man who had spent the entire 1960s as an embarrassing throwback to the 1950s, Stallman didn't mind living out of step with his peers. As a programmer used to working with the best machines and the best software, however, Stallman faced what he could only describe as a "stark moral choice": either get over his ethical objection for " proprietary" software-the term Stallman and his fellow hackers used to describe any program that carried private copyright or end-user license that restricted copying and modification-or dedicate his life to building an alternate, nonproprietary system of software programs. Given his recent months-long ordeal with Symbolics, Stallman felt more comfortable with the latter option. "I suppose I could have stopped working on computers altogether," Stallman says. "I had no special skills, but I'm sure I could have become a waiter. Not at a fancy restaurant, probably, but I could've been a waiter somewhere."
+
+Being a waiter-i.e., dropping out of programming altogether-would have meant completely giving up an activity, computer programming, that had given him so much pleasure. Looking back on his life since moving to Cambridge, Stallman finds it easy to identify lengthy periods when software programming provided the only pleasure. Rather than drop out, Stallman decided to stick it out.
+
+An atheist, Stallman rejects notions such as fate, dharma, or a divine calling in life. Nevertheless, he does feel that the decision to shun proprietary software and build an operating system to help others do the same was a natural one. After all, it was Stallman's own personal combination of stubbornness, foresight, and coding virtuosity that led him to consider a fork in the road most others didn't know existed. In describing the decision in a chapter for the 1999 book, Open Sources, Stallman cites the spirit encapsulated in the words of the Jewish sage Hillel:
+
+_1 If I am not for myself, who will be for me?If I am only for myself, what am I?If not now, when?~{ See Richard Stallman, Open Sources (O'Reilly & Associates, Inc., 1999): 56.<br>Stallman adds his own footnote to this statement, writing, "As an atheist, I don't follow any religious leaders, but I sometimes find I admire something one of them has said." }~
+
+Speaking to audiences, Stallman avoids the religious route and expresses the decision in pragmatic terms. "I asked myself: what could I, an operating-system developer, do to improve the situation? It wasn't until I examined the question for a while that I realized an operating-system developer was exactly what was needed to solve the problem."
+
+Once he reached that decision, Stallman says, everything else "fell into place." He would abstain from using software programs that forced him to compromise his ethical beliefs, while at the same time devoting his life to the creation of software that would make it easier for others to follow the same path. Pledging to build a free software operating system "or die trying-of old age, of course," Stallman quips, he resigned from the MIT staff in January, 1984, to build GNU.
+
+The resignation distanced Stallman's work from the legal auspices of MIT. Still, Stallman had enough friends and allies within the AI Lab to retain rent-free access to his MIT office. He also had the ability to secure outside consulting gigs to underwrite the early stages of the GNU Project. In resigning from MIT, however, Stallman negated any debate about conflict of interest or Institute ownership of the software. The man whose early adulthood fear of social isolation had driven him deeper and deeper into the AI Lab's embrace was now building a legal firewall between himself and that environment.
+
+For the first few months, Stallman operated in isolation from the Unix community as well. Although his announcement to the net.unix-wizards group had attracted sympathetic responses, few volunteers signed on to join the crusade in its early stages.
+
+"The community reaction was pretty much uniform," recalls Rich Morin, leader of a Unix user group at the time. "People said, `Oh, that's a great idea. Show us your code. Show us it can be done.'"
+
+In true hacker fashion, Stallman began looking for existing programs and tools that could be converted into GNU programs and tools. One of the first was a compiler named VUCK, which converted programs written in the popular C programming language into machine-readable code. Translated from the Dutch, the program's acronym stood for the Free University Compiler Kit. Optimistic, Stallman asked the program's author if the program was free. When the author informed him that the words "Free University" were a reference to the Vrije Universiteit in Amsterdam, Stallman was chagrined.
+
+"He responded derisively, stating that the university was free but the compiler was not," recalls Stallman. "I therefore decided that my first program for the GNU Project would be a multi-language, multi-platform compiler." ^46^
+
+Eventually Stallman found a Pastel language compiler written by programmers at Lawrence Livermore National Lab. According to Stallman's knowledge at the time, the compiler was free to copy and modify. Unfortunately, the program possessed a sizable design flaw: it saved each program into core memory, tying up precious space for other software activities. On mainframe systems this design flaw had been forgivable. On Unix systems it was a crippling barrier, since the machines that ran Unix were too small to handle the large files generated. Stallman made substantial progress at first, building a C-compatible frontend to the compiler. By summer, however, he had come to the conclusion that he would have to build a totally new compiler from scratch.
+
+In September of 1984, Stallman shelved compiler development for the near term and began searching for lower-lying fruit. He began development of a GNU version of Emacs, the program he himself had been supervising for a decade. The decision was strategic. Within the Unix community, the two native editor programs were vi, written by Sun Microsystems cofounder Bill Joy, and ed, written by Bell Labs scientist (and Unix cocreator) Ken Thompson. Both were useful and popular, but neither offered the endlessly expandable nature of Emacs. In rewriting Emacs for the Unix audience, Stallman stood a better chance of showing off his skills. It also stood to reason that Emacs users might be more attuned to the Stallman mentality.
+
+Looking back, Stallman says he didn't view the decision in strategic terms. "I wanted an Emacs, and I had a good opportunity to develop one."
+
+Once again, the notion of reinventing the wheel grated on Stallman's efficient hacker sensibilities. In writing a Unix version of Emacs, Stallman was soon following the footsteps of Carnegie Mellon graduate student James Gosling, author of a C-based version dubbed Gosling Emacs or GOSMACS. Gosling's version of Emacs included an interpreter that exploited a simplified offshoot of the Lisp language called MOCKLISP. Determined to build GNU Emacs on a similar Lisp foundation, Stallman borrowed copiously from Gosling's innovations. Although Gosling had put GOSMACS under copyright and had sold the rights to UniPress, a privately held software company, Stallman cited the assurances of a fellow developer who had participated in the early MOCKLISP interpreter. According to the developer, Gosling, while a Ph.D. student at Carnegie Mellon, had assured early collaborators that their work would remain accessible. When UniPress caught wind of Stallman's project, however, the company threatened to enforce the copyright. Once again, Stallman faced the prospect of building from the ground up.
+
+In the course of reverse-engineering Gosling's interpreter, Stallman would create a fully functional Lisp interpreter, rendering the need for Gosling's original interpreter moot. Nevertheless, the notion of developers selling off software rights-indeed, the very notion of developers having software rights to sell in the first place-rankled Stallman. In a 1986 speech at the Swedish Royal Technical Institute, Stallman cited the UniPress incident as yet another example of the dangers associated with proprietary software.
+
+"Sometimes I think that perhaps one of the best things I could do with my life is find a gigantic pile of proprietary software that was a trade secret, and start handing out copies on a street corner so it wouldn't be a trade secret any more," said Stallman. "Perhaps that would be a much more efficient way for me to give people new free software than actually writing it myself; but everyone is too cowardly to even take it."3
+
+Despite the stress it generated, the dispute over Gosling's innovations would assist both Stallman and the free software movement in the long term. It would force Stallman to address the weaknesses of the Emacs Commune and the informal trust system that had allowed problematic offshoots to emerge. It would also force Stallman to sharpen the free software movement's political objectives. Following the release of GNU Emacs in 1985, Stallman issued " The GNU Manifesto," an expansion of the original announcement posted in September, 1983. Stallman included within the document a lengthy section devoted to the many arguments used by commercial and academic programmers to justify the proliferation of proprietary software programs. One argument, "Don't programmers deserve a reward for their creativity," earned a response encapsulating Stallman's anger over the recent Gosling Emacs episode:
+
+"If anything deserves a reward, it is social contribution," Stallman wrote. "Creativity can be a social contribution, but only in so far [sic] as society is free to use the results. If programmers deserve to be rewarded for creating innovative programs, by the same token they deserve to be punished if they restrict the use of these programs."~{ See Richard Stallman, "The GNU Manifesto" (1985).<br> http://www.gnu.org/manifesto.html }~
+
+With the release of GNU Emacs, the GNU Project finally had code to show. It also had the burdens of any software-based enterprise. As more and more Unix developers began playing with the software, money, gifts, and requests for tapes began to pour in. To address the business side of the GNU Project, Stallman drafted a few of his colleagues and formed the Free Software Foundation (FSF), a nonprofit organization dedicated to speeding the GNU Project towards its goal. With Stallman as president and various hacker allies as board members, the FSF helped provide a corporate face for the GNU Project.
+
+Robert Chassell, a programmer then working at Lisp Machines, Inc., became one of five charter board members at the Free Software Foundation following a dinner conversation with Stallman. Chassell also served as the organization's treasurer, a role that started small but quickly grew.
+
+"I think in '85 our total expenses and revenue were something in the order of $23,000, give or take," Chassell recalls. "Richard had his office, and we borrowed space. I put all the stuff, especially the tapes, under my desk. It wasn't until sometime later LMI loaned us some space where we could store tapes and things of that sort."
+
+In addition to providing a face, the Free Software Foundation provided a center of gravity for other disenchanted programmers. The Unix market that had seemed so collegial even at the time of Stallman's initial GNU announcement was becoming increasingly competitive. In an attempt to tighten their hold on customers, companies were starting to close off access to Unix source code, a trend that only speeded the number of inquiries into ongoing GNU software projects. The Unix wizards who once regarded Stallman as a noisy kook were now beginning to see him as a software Cassandra.
+
+"A lot of people don't realize, until they've had it happen to them, how frustrating it can be to spend a few years working on a software program only to have it taken away," says Chassell, summarizing the feelings and opinions of the correspondents writing in to the FSF during the early years. "After that happens a couple of times, you start to say to yourself, `Hey, wait a minute.'"
+
+For Chassell, the decision to participate in the Free Software Foundation came down to his own personal feelings of loss. Prior to LMI, Chassell had been working for hire, writing an introductory book on Unix for Cadmus, Inc., a Cambridge-area software company. When Cadmus folded, taking the rights to the book down with it, Chassell says he attempted to buy the rights back with no success.
+
+"As far as I know, that book is still sitting on shelf somewhere, unusable, uncopyable, just taken out of the system," Chassell says. "It was quite a good introduction if I may say so myself. It would have taken maybe three or four months to convert [the book] into a perfectly usable introduction to GNU/Linux today. The whole experience, aside from what I have in my memory, was lost."
+
+Forced to watch his work sink into the mire while his erstwhile employer struggled through bankruptcy, Chassell says he felt a hint of the anger that drove Stallman to fits of apoplexy. "The main clarity, for me, was the sense that if you want to have a decent life, you don't want to have bits of it closed off," Chassell says. "This whole idea of having the freedom to go in and to fix something and modify it, whatever it may be, it really makes a difference. It makes one think happily that after you've lived a few years that what you've done is worthwhile. Because otherwise it just gets taken away and thrown out or abandoned or, at the very least, you no longer have any relation to it. It's like losing a bit of your life."
+
+1~ Chapter 8 - St. Ignucius
+
+The Maui High Performance Computing Center is located in a single-story building in the dusty red hills just above the town of Kihei. Framed by million-dollar views and the multimillion dollar real estate of the Silversword Golf Course, the center seems like the ultimate scientific boondoggle. Far from the boxy, sterile confines of Tech Square or even the sprawling research metropolises of Argonne, Illinois and Los Alamos, New Mexico, the MHPCC seems like the kind of place where scientists spend more time on their tans than their post-doctoral research projects.
+
+The image is only half true. Although researchers at the MHPCC do take advantage of the local recreational opportunities, they also take their work seriously. According to Top500.org, a web site that tracks the most powerful supercomputers in the world, the IBM SP Power3 supercomputer housed within the MHPCC clocks in at 837 billion floating-point operations per second, making it one of 25 most powerful computers in the world. Co-owned and operated by the University of Hawaii and the U.S. Air Force, the machine divides its computer cycles between the number crunching tasks associated with military logistics and high-temperature physics research.
+
+Simply put, the MHPCC is a unique place, a place where the brainy culture of science and engineering and the laid-back culture of the Hawaiian islands coexist in peaceful equilibrium. A slogan on the lab's 2000 web site sums it up: "Computing in paradise."
+
+It's not exactly the kind of place you'd expect to find Richard Stallman, a man who, when taking in the beautiful view of the nearby Maui Channel through the picture windows of a staffer's office, mutters a terse critique: "Too much sun." Still, as an emissary from one computing paradise to another, Stallman has a message to deliver, even if it means subjecting his pale hacker skin to the hazards of tropical exposure.
+
+The conference room is already full by the time I arrive to catch Stallman's speech. The gender breakdown is a little better than at the New York speech, 85% male, 15% female, but not by much. About half of the audience members wear khaki pants and logo-encrusted golf shirts. The other half seems to have gone native. Dressed in the gaudy flower-print shirts so popular in this corner of the world, their faces are a deep shade of ochre. The only residual indication of geek status are the gadgets: Nokia cell phones, Palm Pilots, and Sony VAIO laptops.
+
+Needless to say, Stallman, who stands in front of the room dressed in plain blue T-shirt, brown polyester slacks, and white socks, sticks out like a sore thumb. The fluorescent lights of the conference room help bring out the unhealthy color of his sun-starved skin. His beard and hair are enough to trigger beads of sweat on even the coolest Hawaiian neck. Short of having the words "mainlander" tattooed on his forehead, Stallman couldn't look more alien if he tried.
+
+As Stallman putters around the front of the room, a few audience members wearing T-shirts with the logo of the Maui FreeBSD Users Group (MFUG) race to set up camera and audio equipment. FreeBSD, a free software offshoot of the Berkeley Software Distribution, the venerable 1970s academic version of Unix, is technically a competitor to the GNU/Linux operating system. Still, in the hacking world, Stallman speeches are documented with a fervor reminiscent of the Grateful Dead and its legendary army of amateur archivists. As the local free software heads, it's up to the MFUG members to make sure fellow programmers in Hamburg, Mumbai, and Novosibirsk don't miss out on the latest pearls of RMS wisdom.
+
+The analogy to the Grateful Dead is apt. Often, when describing the business opportunities inherent within the free software model, Stallman has held up the Grateful Dead as an example. In refusing to restrict fans' ability to record live concerts, the Grateful Dead became more than a rock group. They became the center of a tribal community dedicated to Grateful Dead music. Over time, that tribal community became so large and so devoted that the band shunned record contracts and supported itself solely through musical tours and live appearances. In 1994, the band's last year as a touring act, the Grateful Dead drew $52 million in gate receipts alone.~{ See "Grateful Dead Time Capsule: 1985-1995 North American Tour Grosses."<br> http://www.accessplace.com/gdtc/1197.htm }~
+
+While few software companies have been able to match that success, the tribal aspect of the free software community is one reason many in the latter half of the 1990s started to accept the notion that publishing software source code might be a good thing. Hoping to build their own loyal followings, companies such as IBM, Sun Microsystems, and Hewlett Packard have come to accept the letter, if not the spirit, of the Stallman free software message. Describing the GPL as the information-technology industry's "Magna Carta," ZDNet software columnist Evan Leibovitch sees the growing affection for all things GNU as more than just a trend. "This societal shift is letting users take back control of their futures," Leibovitch writes. "Just as the Magna Carta gave rights to British subjects, the GPL enforces consumer rights and freedoms on behalf of the users of computer software."~{ See Evan Leibovitch, "Who's Afraid of Big Bad Wolves," ZDNet Tech Update (December 15, 2000).<br> http://techupdate.zdnet.com/techupdate/stories/main/0,14179,2664992,00.html }~
+
+The tribal aspect of the free software community also helps explain why 40-odd programmers, who might otherwise be working on physics projects or surfing the Web for windsurfing buoy reports, have packed into a conference room to hear Stallman speak.
+
+Unlike the New York speech, Stallman gets no introduction. He also offers no self-introduction. When the FreeBSD people finally get their equipment up and running, Stallman simply steps forward, starts speaking, and steamrolls over every other voice in the room.
+
+"Most of the time when people consider the question of what rules society should have for using software, the people considering it are from software companies, and they consider the question from a self-serving perspective," says Stallman, opening his speech. "What rules can we impose on everybody else so they have to pay us lots of money? I had the good fortune in the 1970s to be part of a community of programmers who shared software. And because of this I always like to look at the same issue from a different direction to ask: what kind of rules make possible a good society that is good for the people who are in it? And therefore I reach completely different answers."
+
+Once again, Stallman quickly segues into the parable of the Xerox laser printer, taking a moment to deliver the same dramatic finger-pointing gestures to the crowd. He also devotes a minute or two to the GNU/Linux name.
+
+"Some people say to me, `Why make such a fuss about getting credit for this system? After all, the important thing is the job is done, not whether you get recognition for it.' Well, this would be wise advice if it were true. But the job wasn't to build an operating system; the job is to spread freedom to the users of computers. And to do that we have to make it possible to do everything with computers in freedom."~{ For narrative purposes, I have hesitated to go in-depth when describing Stallman's full definition of software "freedom." The GNU Project web site lists four fundamental components:<br>The freedom to run a program, for any purpose (freedom 0).<br>The freedom to study how a program works, and adapt it to your needs (freedom 1).<br>The freedom to redistribute copies of a program so you can help your neighbor (freedom 2).<br>The freedom to improve the program, and release your improvements to the public, so that the whole community benefits (freedom 3).<br>For more information, please visit "The Free Software Definition" at http://www.gnu.org/philosophy/free-sw.html }~
+
+Adds Stallman, "There's a lot more work to do."
+
+For some in the audience, this is old material. For others, it's a little arcane. When a member of the golf-shirt contingent starts dozing off, Stallman stops the speech and asks somebody to wake the person up.
+
+"Somebody once said my voice was so soothing, he asked if I was some kind of healer," says Stallman, drawing a quick laugh from the crowd. "I guess that probably means I can help you drift gently into a blissful, relaxing sleep. And some of you might need that. I guess I shouldn't object if you do. If you need to sleep, by all means do."
+
+The speech ends with a brief discussion of software patents, a growing issue of concern both within the software industry and within the free software community. Like Napster, software patents reflect the awkward nature of applying laws and concepts written for the physical world to the frictionless universe of information technology. The difference between protecting a program under copyright and protecting a program under software patents is subtle but significant. In the case of copyright, a software creator can restrict duplication of the source code but not duplication of the idea or functionality that the source code addresses. In other words, if a developer chooses not to use a software program under the original developer's terms, that second developer is still free to reverse-engineer the program-i.e., duplicate the software program's functionality by rewriting the source code from scratch. Such duplication of ideas is common within the commercial software industry, where companies often isolate reverse-engineering teams to head off accusations of corporate espionage or developer hanky-panky. In the jargon of modern software development, companies refer to this technique as "clean room" engineering.
+
+Software patents work differently. According to the U.S. Patent Office, companies and individuals may secure patents for innovative algorithms provided they submit their claims to a public review. In theory, this allows the patent-holder to trade off disclosure of their invention for a limited monopoly of a minimum of 20 years after the patent filing. In practice, the disclosure is of limited value, since the operation of the program is often self-evident. Unlike copyright, a patent gives its holder the ability to head off the independent development of software programs with the same or similar functionality.
+
+In the software industry, where 20 years can cover the entire life cycle of a marketplace, patents take on a strategic weight. Where companies such as Microsoft and Apple once battled over copyright and the "look and feel" of various technologies, today's Internet companies use patents as a way to stake out individual applications and business models, the most notorious example being Amazon.com's 2000 attempt to patent the company's "one-click" online shopping process. For most companies, however, software patents have become a defensive tool, with cross-licensing deals balancing one set of corporate patents against another in a tense form of corporate detente. Still, in a few notable cases of computer encryption and graphic imaging algorithms, software vendors have successfully stifled rival technologies.
+
+For Stallman, the software-patent issue dramatizes the need for eternal hacker vigilance. It also underlines the importance of stressing the political benefits of free software programs over the competitive benefits. Pointing to software patents' ability to create sheltered regions in the marketplace, Stallman says competitive performance and price, two areas where free software operating systems such as GNU/Linux and FreeBSD already hold a distinct advantage over their proprietary counterparts, are red herrings compared to the large issues of user and developer freedom.
+
+"It's not because we don't have the talent to make better software," says Stallman. "It's because we don't have the right. Somebody has prohibited us from serving the public. So what's going to happen when users encounter these gaps in free software? Well, if they have been persuaded by the open source movement that these freedoms are good because they lead to more-powerful reliable software, they're likely to say, `You didn't deliver what you promised. This software's not more powerful. It's missing this feature. You lied to me.' But if they have come to agree with the free software movement, that the freedom is important in itself, then they will say, `How dare those people stop me from having this feature and my freedom too.' And with that kind of response, we may survive the hits that we're going to take as these patents explode."
+
+Such comments involve a hefty dose of spin, of course. Most open source advocates are equally, if not more, vociferous as Stallman when it comes to opposing software patents. Still, the underlying logic of Stallman's argument-that open source advocates emphasize the utilitarian advantages of free software over the political advantages-remains uncontested. Rather than stress the political significance of free software programs, open source advocates have chosen to stress the engineering integrity of the hacker development model. Citing the power of peer review, the open source argument paints programs such as GNU/Linux or FreeBSD as better built, better inspected and, by extension, more trushworthy to the average user.
+
+That's not to say the term "open source" doesn't have its political implications. For open source advocates, the term open source serves two purposes. First, it eliminates the confusion associated with the word "free," a word many businesses interpret as meaning "zero cost." Second, it allows companies to examine the free software phenomenon on a technological, rather than ethical, basis. Eric Raymond, cofounder of the Open Source Initiative and one of the leading hackers to endorse the term, effectively summed up the frustration of following Stallman down the political path in a 1999 essay, titled " Shut Up and Show Them the Code":
+
+_1 RMS's rhetoric is very seductive to the kind of people we are. We hackers are thinkers and idealists who readily resonate with appeals to "principle" and "freedom" and "rights." Even when we disagree with bits of his program, we want RMS's rhetorical style to work; we think it ought to work; we tend to be puzzled and disbelieving when it fails on the 95% of people who aren't wired like we are.~{ See Eric Raymond, "Shut Up and Show Them the Code," online essay, (June 28, 1999). }~
+
+Included among that 95%, Raymond writes, are the bulk of business managers, investors, and nonhacker computer users who, through sheer weight of numbers, tend to decide the overall direction of the commercial software marketplace. Without a way to win these people over, Raymond argues, programmers are doomed to pursue their ideology on the periphery of society:
+
+_1 When RMS insists that we talk about "computer users' rights," he's issuing a dangerously attractive invitation to us to repeat old failures. It's one we should reject-not because his principles are wrong, but because that kind of language, applied to software, simply does not persuade anybody but us. In fact, it confuses and repels most people outside our culture. ^60^
+
+Watching Stallman deliver his political message in person, it is hard to see anything confusing or repellent. Stallman's appearance may seem off-putting, but his message is logical. When an audience member asks if, in shunning proprietary software, free software proponents lose the ability to keep up with the latest technological advancements, Stallman answers the question in terms of his own personal beliefs. "I think that freedom is more important than mere technical advance," he says. "I would always choose a less advanced free program rather than a more advanced nonfree program, because I won't give up my freedom for something like that. My rule is, if I can't share it with you, I won't take it."
+
+Such answers, however, reinforce the quasi-religious nature of the Stallman message. Like a Jew keeping kosher or a Mormon refusing to drink alcohol, Stallman paints his decision to use free software in the place of proprietary in the color of tradition and personal belief. As software evangelists go, Stallman avoids forcing those beliefs down listeners' throats. Then again, a listener rarely leaves a Stallman speech not knowing where the true path to software righteousness lies.
+
+As if to drive home this message, Stallman punctuates his speech with an unusual ritual. Pulling a black robe out of a plastic grocery bag, Stallman puts it on. Out of a second bag, he pulls a reflective yellow computer disk and places it on his head. The crowd lets out a startled laugh.
+
+"I am St. Ignucius of the Church of Emacs," says Stallman, raising his right hand in mock-blessing. "I bless your computer, my child."
+
+{free_as_in_freedom_03_rms_st_ignucius.png 188x209 "Stallman dressed as St. Ignucius. Photo by Wouter van Oortmerssen." }http://www.free-culture.cc/
+
+The laughter turns into full-blown applause after a few seconds. As audience members clap, the computer disk on Stallman's head catches the glare of an overhead light, eliciting a perfect halo effect. In the blink of an eye, Stallman goes from awkward haole to Russian religious icon.
+
+" Emacs was initially a text editor," says Stallman, explaining the getup. "Eventually it became a way of life for many and a religion for some. We call this religion the Church of Emacs."
+
+The skit is a lighthearted moment of self-pardoy, a humorous return-jab at the many people who might see Stallman's form of software asceticism as religious fanaticism in disguise. It is also the sound of the other shoe dropping-loudly. It's as if, in donning his robe and halo, Stallman is finally letting listeners of the hook, saying, "It's OK to laugh. I know I'm weird."
+
+Discussing the St. Ignucius persona afterward, Stallman says he first came up with it in 1996, long after the creation of Emacs but well before the emergence of the "open source" term and the struggle for hacker-community leadership that precipitated it. At the time, Stallman says, he wanted a way to "poke fun at himself," to remind listeners that, though stubborn, Stallman was not the fanatic some made him out to be. It was only later, Stallman adds, that others seized the persona as a convenient way to play up his reputation as software ideologue, as Eric Raymond did in an 1999 interview with the linux.com web site:
+
+_1 When I say RMS calibrates what he does, I'm not belittling or accusing him of insincerity. I'm saying that like all good communicators he's got a theatrical streak. Sometimes it's conscious-have you ever seen him in his St. Ignucius drag, blessing software with a disk platter on his head? Mostly it's unconscious; he's just learned the degree of irritating stimulus that works, that holds attention without (usually) freaking people out.~{ See "Guest Interview: Eric S. Raymond," Linux.com (May 18, 1999).<br> http://www.linux.com/interviews/19990518/8/ }~
+
+Stallman takes issue with the Raymond analysis. "It's simply my way of making fun of myself," he says. "The fact that others see it as anything more than that is a reflection of their agenda, not mine."
+
+That said, Stallman does admit to being a ham. "Are you kidding?" he says at one point. "I love being the center of attention." To facilitate that process, Stallman says he once enrolled in Toastmasters, an organization that helps members bolster their public-speaking skills and one Stallman recommends highly to others. He possesses a stage presence that would be the envy of most theatrical performers and feels a link to vaudevillians of years past. A few days after the Maui High Performance Computing Center speech, I allude to the 1999 LinuxWorld performace and ask Stallman if he has a Groucho Marx complex-i.e., the unwillingness to belong to any club that would have him as a member. Stallman's response is immediate: "No, but I admire Groucho Marx in a lot of ways and certainly have been in some things I say inspired by him. But then I've also been inspired in some ways by Harpo."
+
+The Groucho Marx influence is certainly evident in Stallman's lifelong fondness for punning. Then again, punning and wordplay are common hacker traits. Perhaps the most Groucho-like aspect of Stallman's personality, however, is the deadpan manner in which the puns are delivered. Most come so stealthily-without even the hint of a raised eyebrow or upturned smile-you almost have to wonder if Stallman's laughing at his audience more than the audience is laughing at him.
+
+Watching members of the Maui High Performance Computer Center laugh at the St. Ignucius parody, such concerns evaporate. While not exactly a standup act, Stallman certainly possesses the chops to keep a roomful of engineers in stitches. "To be a saint in the Church of Emacs does not require celibacy, but it does require making a commitment to living a life of moral purity," he tells the Maui audience. "You must exorcise the evil proprietary operating system from all your computer and then install a wholly [holy] free operating system. And then you must install only free software on top of that. If you make this commitment and live by it, then you too will be a saint in the Church of Emacs, and you too may have a halo."
+
+The St. Ignucius skit ends with a brief inside joke. On most Unix systems and Unix-related offshoots, the primary competitor program to Emacs is vi, a text-editing program developed by former UC Berkeley student and current Sun Microsystems chief scientist, Bill Joy. Before doffing his "halo," Stallman pokes fun at the rival program. "People sometimes ask me if it is a sin in the Church of Emacs to use vi," he says. "Using a free version of vi is not a sin; it is a penance. So happy hacking."
+
+After a brief question-and-answer session, audience members gather around Stallman. A few ask for autographs. "I'll sign this," says Stallman, holding up one woman's print out of the GNU General Public License, "but only if you promise me to use the term GNU/Linux instead of Linux and tell all your friends to do likewise."
+
+The comment merely confirms a private observation. Unlike other stage performers and political figures, Stallman has no "off" mode. Aside from the St. Ignucius character, the ideologue you see onstage is the ideologue you meet backstage. Later that evening, during a dinner conversation in which a programmer mentions his affinity for "open source" programs, Stallman, between bites, upbraids his tablemate: "You mean free software. That's the proper way to refer to it."
+
+During the question-and-answer session, Stallman admits to playing the pedagogue at times. "There are many people who say, `Well, first let's invite people to join the community, and then let's teach them about freedom.' And that could be a reasonable strategy, but what we have is almost everybody's inviting people to join the community, and hardly anybody's teaching them about freedom once they come in."
+
+The result, Stallman says, is something akin to a third-world city. People move in, hoping to strike it rich or at the very least to take part in a vibrant, open culture, and yet those who hold the true power keep evolving new tricks and strategies-i.e., software patents-to keep the masses out. "You have millions of people moving in and building shantytowns, but nobody's working on step two: getting them out of those shantytowns. If you think talking about software freedom is a good strategy, please join in doing step two. There are plenty working on step one. We need more people working on step two."
+
+Working on "step two" means driving home the issue that freedom, not acceptance, is the root issue of the free software movement. Those who hope to reform the proprietary software industry from the inside are on a fool's errand. "Change from the inside is risky," Stallman stays. "Unless you're working at the level of a Gorbachev, you're going to be neutralized."
+
+Hands pop up. Stallman points to a member of the golf shirt-wearing contingent. "Without patents, how would you suggest dealing with commercial espionage?"
+
+"Well, those two questions have nothing to do with each other, really," says Stallman.
+
+"But I mean if someone wants to steal another company's piece of software."
+
+Stallman's recoils as if hit by a poisonous spray. "Wait a second," Stallman says. "Steal? I'm sorry, there's so much prejudice in that statement that the only thing I can say is that I reject that prejudice. Companies that develop nonfree software and other things keep lots and lots of trade secrets, and so that's not really likely to change. In the old days-even in the 1980s-for the most part programmers were not aware that there were even software patents and were paying no attention to them. What happened was that people published the interesting ideas, and if they were not in the free software movement, they kept secret the little details. And now they patent those broad ideas and keep secret the little details. So as far as what you're describing, patents really make no difference to it one way or another."
+
+"But if it doesn't affect their publication," a new audience member jumps in, his voice trailing off almost as soon as he starts speaking.
+
+"But it does," Stallman says. "Their publication is telling you that this is an idea that's off limits to the rest of the community for 20 years. And what the hell good is that? Besides, they've written it in such a hard way to read, both to obfuscate the idea and to make the patent as broad as possible, that it's basically useless looking at the published information to learn anything anyway. The only reason to look at patents is to see the bad news of what you can't do."
+
+The audience falls silent. The speech, which began at 3:15, is now nearing the 5:00 whistle, and most listeners are already squirming in their seats, antsy to get a jump start on the weekend. Sensing the fatigue, Stallman glances around the room and hastily shuts things down. "So it looks like we're done," he says, following the observation with an auctioneer's "going, going, gone" to flush out any last-minute questioners. When nobody throws their hand up, Stallman signs off with a traditional exit line.
+
+"Happy hacking," he says.
+
+1~ Chapter 9 - The GNU General Public License
+
+By the spring of 1985, Richard Stallman had settled on the GNU Project's first milestone-a Lisp-based free software version of Emacs. To meet this goal, however, he faced two challenges. First, he had to rebuild Emacs in a way that made it platform independent. Second, he had to rebuild the Emacs Commune in a similar fashion.
+
+The dispute with UniPress had highlighted a flaw in the Emacs Commune social contract. Where users relied on Stallman's expert insight, the Commune's rules held. In areas where Stallman no longer held the position of alpha hacker-pre-1984 Unix systems, for example-individuals and companies were free to make their own rules.
+
+The tension between the freedom to modify and the freedom to exert authorial privilege had been building before GOSMACS. The Copyright Act of 1976 had overhauled U.S. copyright law, extending the legal protection of copyright to software programs. According to Section 102(b) of the Act, individuals and companies now possessed the ability to copyright the "expression" of a software program but not the "actual processes or methods embodied in the program."~{ See Hal Abelson, Mike Fischer, and Joanne Costello, "Software and Copyright Law," updated version (1998).<br> http://www.swiss.ai.mit.edu/6805/articles/int-prop/software-copyright.html }~ Translated, programmers and companies had the ability to treat software programs like a story or song. Other programmers could take inspiration from the work, but to make a direct copy or nonsatirical derivative, they first had to secure permission from the original creator. Although the new law guaranteed that even programs without copyright notices carried copyright protection, programmers quickly asserted their rights, attaching coypright notices to their software programs.
+
+At first, Stallman viewed these notices with alarm. Rare was the software program that didn't borrow source code from past programs, and yet, with a single stroke of the president's pen, Congress had given programmers and companies the power to assert individual authorship over communally built programs. It also injected a dose of formality into what had otherwise been an informal system. Even if hackers could demonstrate how a given program's source-code bloodlines stretched back years, if not decades, the resources and money that went into battling each copyright notice were beyond most hackers' means. Simply put, disputes that had once been settled hacker-to-hacker were now settled lawyer-to-lawyer. In such a system, companies, not hackers, held the automatic advantage.
+
+Proponents of software copyright had their counter-arguments: without copyright, works might otherwise slip into the public domain. Putting a copyright notice on a work also served as a statement of quality. Programmers or companies who attached their name to the copyright attached their reputations as well. Finally, it was a contract, as well as a statement of ownership. Using copyright as a flexible form of license, an author could give away certain rights in exchange for certain forms of behavior on the part of the user. For example, an author could give away the right to suppress unauthorized copies just so long as the end user agreed not to create a commercial offshoot.
+
+It was this last argument that eventually softened Stallman's resistance to software copyright notices. Looking back on the years leading up to the GNU Project, Stallman says he began to sense the beneficial nature of copyright sometime around the release of Emacs 15.0, the last significant pre-GNU Project upgrade of Emacs. "I had seen email messages with copyright notices plus simple `verbatim copying permitted' licenses," Stallman recalls. "Those definitely were [an] inspiration."
+
+For Emacs 15, Stallman drafted a copyright that gave users the right to make and distribute copies. It also gave users the right to make modified versions, but not the right to claim sole ownership of those modified versions, as in the case of GOSMACS.
+
+Although helpful in codifying the social contract of the Emacs Commune, the Emacs 15 license remained too "informal" for the purposes of the GNU Project, Stallman says. Soon after starting work on a GNU version of Emacs, Stallman began consulting with the other members of the Free Software Foundation on how to shore up the license's language. He also consulted with the attorneys who had helped him set up the Free Software Foundation.
+
+Mark Fischer, a Boston attorney specializing in intellectual-property law, recalls discussing the license with Stallman during this period. "Richard had very strong views about how it should work," Fischer says, "He had two principles. The first was to make the software absolutely as open as possible. The second was to encourage others to adopt the same licensing practices."
+
+Encouraging others to adopt the same licensing practices meant closing off the escape hatch that had allowed privately owned versions of Emacs to emerge. To close that escape hatch, Stallman and his free software colleagues came up with a solution: users would be free to modify GNU Emacs just so long as they published their modifications. In addition, the resulting "derivative" works would also have carry the same GNU Emacs License.
+
+The revolutionary nature of this final condition would take a while to sink in. At the time, Fischer says, he simply viewed the GNU Emacs License as a simple contract. It put a price tag on GNU Emacs' use. Instead of money, Stallman was charging users access to their own later modifications. That said, Fischer does remember the contract terms as unique.
+
+"I think asking other people to accept the price was, if not unique, highly unusual at that time," he says.
+
+The GNU Emacs License made its debut when Stallman finally released GNU Emacs in 1985. Following the release, Stallman welcomed input from the general hacker community on how to improve the license's language. One hacker to take up the offer was future software activist John Gilmore, then working as a consultant to Sun Microsystems. As part of his consulting work, Gilmore had ported Emacs over to SunOS, the company's in-house version of Unix. In the process of doing so, Gilmore had published the changes as per the demands of the GNU Emacs License. Instead of viewing the license as a liability, Gilmore saw it as clear and concise expression of the hacker ethos. "Up until then, most licenses were very informal," Gilmore recalls.
+
+As an example of this informality, Gilmore cites a copyright notice for trn, a Unix utility. Written by Larry Wall, future creator of the Perl programming language, patch made it simple for Unix programmers to insert source-code fixes-" patches" in hacker jargon-into any large program. Recognizing the utility of this feature, Wall put the following copyright notice in the program's accompanying README file:
+
+% previous markup as 'poem' with footnote not satisfactory
+
+Copyright (c) 1985, Larry Wall<br>
+You may copy the trn kit in whole or in part as long as you don't try
+to make money off it, or pretend that you wrote it.~{ See Trn Kit README.<br> http://www.za.debian.org/doc/trn/trn-readme }~
+
+Such statements, while reflective of the hacker ethic, also reflected the difficulty of translating the loose, informal nature of that ethic into the rigid, legal language of copyright. In writing the GNU Emacs License, Stallman had done more than close up the escape hatch that permitted proprietary offshoots. He had expressed the hacker ethic in a manner understandable to both lawyer and hacker alike.
+
+It wasn't long, Gilmore says, before other hackers began discussing ways to "port" the GNU Emacs License over to their own programs. Prompted by a conversation on Usenet, Gilmore sent an email to Stallman in November, 1986, suggesting modification:
+
+_1 You should probably remove "EMACS" from the license and replace it with "SOFTWARE" or something. Soon, we hope, Emacs will not be the biggest part of the GNU system, and the license applies to all of it.~{ See John Gilmore, quoted from email to author. }~
+
+Gilmore wasn't the only person suggesting a more general approach. By the end of 1986, Stallman himself was at work with GNU Project's next major milestone, a source-code debugger, and was looking for ways to revamp the Emacs license so that it might apply to both programs. Stallman's solution: remove all specific references to Emacs and convert the license into a generic copyright umbrella for GNU Project software. The GNU General Public License, GPL for short, was born.
+
+In fashioning the GPL, Stallman followed the software convention of using decimal numbers to indicate prototype versions and whole numbers to indicate mature versions. Stallman published Version 1.0 of the GPL in 1989 (a project Stallman was developing in 1985), almost a full year after the release of the GNU Debugger, Stallman's second major foray into the realm of Unix programming. The license contained a preamble spelling out its political intentions:
+
+poem{
+
+The General Public License is designed to make sure that you have
+the freedom to give away or sell copies of free software, that you
+receive source code or can get it if you want it, that you can change
+the software or use pieces of it in new free programs; and that you
+know you can do these things.
+
+To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the
+rights. These restrictions translate to certain responsibilities for
+you if you distribute copies of the software, or if you modify it.
+
+}poem ~{ See Richard Stallman, et al., "GNU General Public License: Version 1," (February, 1989).<br> http://www.gnu.org/copyleft/copying-1.0.html }~
+
+In fashioning the GPL, Stallman had been forced to make an additional adjustment to the informal tenets of the old Emacs Commune. Where he had once demanded that Commune members publish any and all changes, Stallman now demanded publication only in instances when programmers circulated their derivative versions in the same public manner as Stallman. In other words, programmers who simply modified Emacs for private use no longer needed to send the source-code changes back to Stallman. In what would become a rare compromise of free software doctrine, Stallman slashed the price tag for free software. Users could innovate without Stallman looking over their shoulders just so long as they didn't bar Stallman and the rest of the hacker community from future exchanges of the same program.
+
+Looking back, Stallman says the GPL compromise was fueled by his own dissatisfaction with the Big Brother aspect of the original Emacs Commune social contract. As much as he liked peering into other hackers' systems, the knowledge that some future source-code maintainer might use that power to ill effect forced him to temper the GPL.
+
+"It was wrong to require people to publish all changes," says Stallman. "It was wrong to require them to be sent to one privileged developer. That kind of centralization and privilege for one was not consistent with a society in which all had equal rights."
+
+As hacks go, the GPL stands as one of Stallman's best. It created a system of communal ownership within the normally proprietary confines of copyright law. More importantly, it demonstrated the intellectual similarity between legal code and software code. Implicit within the GPL's preamble was a profound message: instead of viewing copyright law with suspicion, hackers should view it as yet another system begging to be hacked.
+
+"The GPL developed much like any piece of free software with a large community discussing its structure, its respect or the opposite in their observation, needs for tweaking and even to compromise it mildly for greater acceptance," says Jerry Cohen, another attorney who helped Stallman with the creation of the license. "The process worked very well and GPL in its several versions has gone from widespread skeptical and at times hostile response to widespread acceptance."
+
+In a 1986 interview with Byte magazine, Stallman summed up the GPL in colorful terms. In addition to proclaiming hacker values, Stallman said, readers should also "see it as a form of intellectual jujitsu, using the legal system that software hoarders have set up against them."~{ See David Betz and Jon Edwards, "Richard Stallman discusses his public-domain [sic] Unix-compatible software system with BYTE editors," BYTE (July, 1996). (Reprinted on the GNU Project web site: http://www.gnu.org/gnu/byte-interview.html )<br>This interview offers an interesting, not to mention candid, glimpse at Stallman's political attitudes during the earliest days of the GNU Project. It is also helpful in tracing the evolution of Stallman's rhetoric.<br>Describing the purpose of the GPL, Stallman says, "I'm trying to change the way people approach knowledge and information in general. I think that to try to own knowledge, to try to control whether people are allowed to use it, or to try to stop other people from sharing it, is sabotage."<br>Contrast this with a statement to the author in August 2000: "I urge you not to use the term `intellectual property' in your thinking. It will lead you to misunderstand things, because that term generalizes about copyrights, patents, and trademarks. And those things are so different in their effects that it is entirely foolish to try to talk about them at once. If you hear somebody saying something about intellectual property, without quotes, then he's not thinking very clearly and you shouldn't join." }~ Years later, Stallman would describe the GPL's creation in less hostile terms. "I was thinking about issues that were in a sense ethical and in a sense political and in a sense legal," he says. "I had to try to do what could be sustained by the legal system that we're in. In spirit the job was that of legislating the basis for a new society, but since I wasn't a government, I couldn't actually change any laws. I had to try to do this by building on top of the existing legal system, which had not been designed for anything like this."
+
+About the time Stallman was pondering the ethical, political, and legal issues associated with free software, a California hacker named Don Hopkins mailed him a manual for the 68000 microprocessor. Hopkins, a Unix hacker and fellow science-fiction buff, had borrowed the manual from Stallman a while earlier. As a display of gratitude, Hopkins decorated the return envelope with a number of stickers obtained at a local science-fiction convention. One sticker in particular caught Stallman's eye. It read, "Copyleft (L), All Rights Reversed." Following the release of the first version of GPL, Stallman paid tribute to the sticker, nicknaming the free software license "Copyleft." Over time, the nickname and its shorthand symbol, a backwards "C," would become an official Free Software Foundation synonym for the GPL.
+
+The German sociologist Max Weber once proposed that all great religions are built upon the "routinization" or "institutionalization" of charisma. Every successful religion, Weber argued, converts the charisma or message of the original religious leader into a social, political, and ethical apparatus more easily translatable across cultures and time.
+
+While not religious per se, the GNU GPL certainly qualifies as an interesting example of this "routinization" process at work in the modern, decentralized world of software development. Since its unveiling, programmers and companies who have otherwise expressed little loyalty or allegiance to Stallman have willingly accepted the GPL bargain at face value. A few have even accepted the GPL as a preemptive protective mechanism for their own software programs. Even those who reject the GPL contract as too compulsory, still credit it as influential.
+
+One hacker falling into this latter group was Keith Bostic, a University of California employee at the time of the GPL 1.0 release. Bostic's department, the Computer Systems Research Group (SRG), had been involved in Unix development since the late 1970s and was responsible for many key parts of Unix, including the TCP/IP networking protocol, the cornerstone of modern Internet communications. By the late 1980s, AT&T, the original owner of the Unix brand name, began to focus on commercializing Unix and began looking to the Berkeley Software Distribution, or BSD, the academic version of Unix developed by Bostic and his Berkeley peers, as a key source of commercial technology.
+
+Although the Berkeley BSD source code was shared among researchers and commercial programmers with a source-code license, this commercialization presented a problem. The Berkeley code was intermixed with proprietary AT&T code. As a result, Berkeley distributions were available only to institutions that already had a Unix source license from AT&T. As AT&T raised its license fees, this arrangement, which had at first seemed innocuous, became increasingly burdensome.
+
+Hired in 1986, Bostic had taken on the personal project of porting BSD over to the Digital Equipment Corporation's PDP-11 computer. It was during this period, Bostic says, that he came into close interaction with Stallman during Stallman's occasional forays out to the west coast. "I remember vividly arguing copyright with Stallman while he sat at borrowed workstations at CSRG," says Bostic. "We'd go to dinner afterward and continue arguing about copyright over dinner."
+
+The arguments eventually took hold, although not in the way Stallman would have liked. In June, 1989, Berkeley separated its networking code from the rest of the AT&T-owned operating system and distributed it under a University of California license. The contract terms were liberal. All a licensee had to do was give credit to the university in advertisements touting derivative programs.~{ The University of California's "obnoxious advertising clause" would later prove to be a problem. Looking for a less restrictive alternative to the GPL, some hackers used the University of California, replacing "University of California" with the name of their own instution. The result: free software programs that borrowed from dozens of other programs would have to cite dozens of institutions in advertisements. In 1999, after a decade of lobbying on Stallman's part, the University of California agreed to drop this clause.<br>See "The BSD License Problem" at http://www.gnu.org/philosophy/bsd.html. }~ In contrast to the GPL, proprietary offshoots were permissible. Only one problem hampered the license's rapid adoption: the BSD Networking release wasn't a complete operating system. People could study the code, but it could only be run in conjunction with other proprietary-licensed code.
+
+Over the next few years, Bostic and other University of California employees worked to replace the missing components and turn BSD into a complete, freely redistributable operating system. Although delayed by a legal challenge from Unix Systems Laboratories-the AT&T spin-off that retained ownership of the Unix brand name-the effort would finally bear fruit in the early 1990s. Even before then, however, many of the Berkeley utilities would make their way into Stallman's GNU Project.
+
+"I think it's highly unlikely that we ever would have gone as strongly as we did without the GNU influence," says Bostic, looking back. "It was clearly something where they were pushing hard and we liked the idea."
+
+By the end of the 1980s, the GPL was beginning to exert a gravitational effect on the free software community. A program didn't have to carry the GPL to qualify as free software-witness the case of the BSD utilities-but putting a program under the GPL sent a definite message. "I think the very existence of the GPL inspired people to think through whether they were making free software, and how they would license it," says Bruce Perens, creator of Electric Fence, a popular Unix utility, and future leader of the Debian GNU/Linux development team. A few years after the release of the GPL, Perens says he decided to discard Electric Fence's homegrown license in favor of Stallman's lawyer-vetted copyright. "It was actually pretty easy to do," Perens recalls.
+
+Rich Morin, the programmer who had viewed Stallman's initial GNU announcement with a degree of skepticism, recalls being impressed by the software that began to gather under the GPL umbrella. As the leader of a SunOS user group, one of Morin's primary duties during the 1980s had been to send out distribution tapes containing the best freeware or free software utilities. The job often mandated calling up original program authors to verify whether their programs were copyright protected or whether they had been consigned to the public domain. Around 1989, Morin says, he began to notice that the best software programs typically fell under the GPL license. "As a software distributor, as soon as I saw the word GPL, I knew I was home free," recalls Morin.
+
+To compensate for the prior hassles that went into compiling distribution tapes to the Sun User Group, Morin had charged recipients a convenience fee. Now, with programs moving over to the GPL, Morin was suddenly getting his tapes put together in half the time, turning a tidy profit in the process. Sensing a commercial opportunity, Morin rechristened his hobby as a business: Prime Time Freeware.
+
+Such commercial exploitation was completely within the confines of the free software agenda. "When we speak of free software, we are referring to freedom, not price," advised Stallman in the GPL's preamble. By the late 1980s, Stallman had refined it to a more simple mnemonic: "Don't think free as in free beer; think free as in free speech."
+
+For the most part, businesses ignored Stallman's entreaties. Still, for a few entrepreneurs, the freedom associated with free software was the same freedom associated with free markets. Take software ownership out of the commercial equation, and you had a situation where even the smallest software company was free to compete against the IBMs and DECs of the world.
+
+One of the first entrepreneurs to grasp this concept was Michael Tiemann, a software programmer and graduate student at Stanford University. During the 1980s, Tiemann had followed the GNU Project like an aspiring jazz musician following a favorite artist. It wasn't until the release of the GNU C Compiler in 1987, however, that he began to grasp the full potential of free software. Dubbing GCC a "bombshell," Tiemann says the program's own existence underlined Stallman's determination as a programmer.
+
+"Just as every writer dreams of writing the great American novel, every programmer back in the 1980s talked about writing the great American compiler," Tiemman recalls. "Suddenly Stallman had done it. It was very humbling."
+
+"You talk about single points of failure, GCC was it," echoes Bostic. "Nobody had a compiler back then, until GCC came along."
+
+Rather than compete with Stallman, Tiemann decided to build on top of his work. The original version of GCC weighed in at 110,000 lines of code, but Tiemann recalls the program as surprisingly easy to understand. So easy in fact that Tiemann says it took less than five days to master and another week to port the software to a new hardware platform, National Semiconductor's 32032 microchip. Over the next year, Tiemann began playing around with the source code, creating a native compiler for the C+ programming language. One day, while delivering a lecture on the program at Bell Labs, Tiemann ran into some AT&T developers struggling to pull off the same thing.
+
+"There were about 40 or 50 people in the room, and I asked how many people were working on the native code compiler," Tiemann recalls. "My host said the information was confidential but added that if I took a look around the room I might get a good general idea."
+
+It wasn't long after, Tiemann says, that the light bulb went off in his head. "I had been working on that project for six months," Tiemann says. I just thought to myself, whether it's me or the code this is a level of efficiency that the free market should be ready to reward."
+
+Tiemann found added inspiration in the GNU Manifesto, which, while excoriating the greed of some software vendors, encourages other vendors to consider the advantages of free software from a consumer point of view. By removing the power of monopoly from the commerical software question, the GPL makes it possible for the smartest vendors to compete on the basis of service and consulting, the two most profit-rich corners of the software marketplace.
+
+In a 1999 essay, Tiemann recalls the impact of Stallman's Manifesto. "It read like a socialist polemic, but I saw something different. I saw a business plan in disguise."~{ See Michael Tiemann, "Future of Cygnus Solutions: An Entrepreneur's Account," Open Sources (O'Reilly & Associates, Inc., 1999): 139. }~
+
+Teaming up with John Gilmore, another GNU Project fan, Tiemann launched a software consulting service dedicated to customizing GNU programs. Dubbed Cygnus Support, the company signed its first development contract in February, 1990. By the end of the year, the company had $725,000 worth of support and development contracts.
+
+GNU Emacs, GDB, and GCC were the "big three" of developer-oriented tools, but they weren't the only ones developed by Stallman during the GNU Project's first half decade. By 1990, Stallman had also generated GNU versions of the Bourne Shell (rechristened the Bourne Again Shell, or BASH), YACC (rechristened Bison), and awk (rechristened gawk). Like GCC , every GNU program had to be designed to run on multiple systems, not just a single vendor's platform. In the process of making programs more flexible, Stallman and his collaborators often made them more useful as well.
+
+Recalling the GNU universalist approach, Prime Time Freeware's Morin points to a critical, albeit mundane, software package called hello. "It's the hello world program which is five lines of C, packaged up as if it were a GNU distribution," Morin says. "And so it's got the Texinfo stuff and the configure stuff. It's got all the other software engineering goo that the GNU Project has come up with to allow packages to port to all these different environments smoothly. That's tremendously important work, and it affects not only all of [Stallman's] software, but also all of the other GNU Project software."
+
+According to Stallman, improving software programs was secondary to building them in the first place. "With each piece I may or may not find a way to improve it," said Stallman to Byte. "To some extent I am getting the benefit of reimplementation, which makes many systems much better. To some extent it's because I have been in the field a long time and worked on many other systems. I therefore have many ideas to bring to bear."~{ See Richard Stallman, BYTE (1986). }~
+
+Nevertheless, as GNU tools made their mark in the late 1980s, Stallman's AI Lab-honed reputation for design fastidiousness soon became legendary throughout the entire software-development community.
+
+Jeremy Allison, a Sun user during the late 1980s and programmer destined to run his own free software project, Samba, in the 1990s, recalls that reputation with a laugh. During the late 1980s, Allison began using Emacs. Inspired by the program's community-development model, Allison says he sent in a snippet of source code only to have it rejected by Stallman.
+
+"It was like the Onion headline," Allison says. "`Child's prayers to God answered: No.'"
+
+Stallman's growing stature as a software programmer, however, was balanced by his struggles as a project manager. Although the GNU Project moved from success to success in creation of developer-oriented tools, its inability to generate a working kernel-the central "traffic cop" program in all Unix systems that determines which devices and applications get access to the microprocessor and when-was starting to elicit grumbles as the 1980s came to a close. As with most GNU Project efforts, Stallman had started kernel development by looking for an existing program to modify. According to a January 1987 "Gnusletter," Stallman was already working to overhaul TRIX, a Unix kernel developed at MIT.
+
+A review of GNU Project "GNUsletters" of the late 1980s reflects the management tension. In January, 1987, Stallman announced to the world that the GNU Project was working to overhaul TRIX, a Unix kernel developed at MIT. A year later, in February of 1988, the GNU Project announced that it had shifted its attentions to Mach, a lightweight "micro-kernel" developed at Carnegie Mellon. All told, however, official GNU Project kernel development wouldn't commence until 1990.~{ See "HURD History."<br> http://www.gnu.org/software/hurd/history.html }~
+
+The delays in kernel development were just one of many concerns weighing on Stallman during this period. In 1989, Lotus Development Corporation filed suit against rival software company, Paperback Software International, for copying menu commands in Lotus' popular 1-2-3 Spreadsheet program. Lotus' suit, coupled with the Apple -Microsoft "look and feel" battle, provided a troublesome backdrop for the GNU Project. Although both suits fell outside the scope of the GNU Project, both revolved around operating systems and software applications developed for the personal computer, not Unix-compatible hardware systems-they threatened to impose a chilling effect on the entire culture of software development. Determined to do something, Stallman recruited a few programmer friends and composed a magazine ad blasting the lawsuits. He then followed up the ad by helping to organize a group to protest the corporations filing the suit. Calling itself the League of Programming Freedom, the group held protests outside the offices of Lotus, Inc. and the Boston courtroom hosting the Lotus trial.
+
+The protests were notable.~{ According to a League of Programming Freedom Press, the protests were notable for featuring the first hexadecimal protest chant:<br>1-2-3-4, toss the lawyers out the door;<br>5-6-7-8, innovate don't litigate;<br>9-A-B-C, 1-2-3 is not for me;<br>D-E-F-O, look and feel have got to go<br> http://lpf.ai.mit.edu/Links/prep.ai.mit.edu/demo.final.release }~ They document the evolving nature of software industry. Applications had quietly replaced operating systems as the primary corporate battleground. In its unfulfilled quest to build a free software operating system, the GNU Project seemed hopelessly behind the times. Indeed, the very fact that Stallman had felt it necessary to put together an entirely new group dedicated to battling the "look and feel" lawsuits reinforced that obsolescence in the eyes of some observers.
+
+In 1990, the John D. and Catherine T. MacArthur Foundation cerified Stallman's genius status when it granted Stallman a MacArthur fellowship, therefore making him a recipient for the organization's so-called "genius grant." The grant, a $240,000 reward for launching the GNU Project and giving voice to the free software philosophy, relieved a number of short-term concerns. First and foremost, it gave Stallman, a nonsalaried employee of the FSF who had been supporting himself through consulting contracts, the ability to devote more time to writing GNU code.~{ I use the term "writing" here loosely. About the time of the MacArthur award, Stallman began suffering chronic pain in his hands and was dictating his work to FSF-employed typists. Although some have speculated that the hand pain was the result of repetitive stress injury, or RSI, an injury common among software programmers, Stallman is not 100% sure. "It was NOT carpal tunnel syndrome," he writes. "My hand problem was in the hands themselves, not in the wrists." Stallman has since learned to work without typists after switching to a keyboard with a lighter touch. }~
+
+Ironically, the award also made it possible for Stallman to vote. Months before the award, a fire in Stallman's apartment house had consumed his few earthly possessions. By the time of the award, Stallman was listing himself as a "squatter"~{ See Reuven Lerner, "Stallman wins $240,000 MacArthur award," MIT, The Tech (July 18, 1990).
+http://the-tech.mit.edu/V110/N30/rms.30n.html }~ at 545 Technology Square. "[The registrar of voters] didn't want to accept that as my address," Stallman would later recall. "A newspaper article about the MacArthur grant said that and then they let me register."~{ See Michael Gross, "Richard Stallman: High School Misfit, Symbol of Free Software, MacArthur-certified Genius" (1999). }~
+
+Most importantly, the MacArthur money gave Stallman more freedom. Already dedicated to the issue of software freedom, Stallman chose to use the additional freedom to increase his travels in support of the GNU Project mission.
+
+Interestingly, the ultimate success of the GNU Project and the free software movement in general would stem from one of these trips. In 1990, Stallman paid a visit to the Polytechnic University in Helsinki, Finland. Among the audience members was 21-year-old Linus Torvalds, future developer of the Linux kernel-the free software kernel destined to fill the GNU Project's most sizable gap.
+
+A student at the nearby University of Helsinki at the time, Torvalds regarded Stallman with bemusement. "I saw, for the first time in my life, the stereotypical long-haired, bearded hacker type," recalls Torvalds in his 2001 autobiography Just for Fun. "We don't have much of them in Helsinki."~{ See Linus Torvalds and David Diamond, Just For Fun: The Story of an Accidentaly Revolutionary (HarperCollins Publishers, Inc., 2001): 58-59. }~
+
+While not exactly attuned to the "sociopolitical" side of the Stallman agenda, Torvalds nevertheless appreciated the agenda's underlying logic: no programmer writes error-free code. By sharing software, hackers put a program's improvement ahead of individual motivations such as greed or ego protection.
+
+Like many programmers of his generation, Torvalds had cut his teeth not on mainframe computers like the IBM 7094, but on a motley assortment of home-built computer systems. As university student, Torvalds had made the step up from C programming to Unix, using the university's MicroVAX. This ladder-like progression had given Torvalds a different perspective on the barriers to machine access. For Stallman, the chief barriers were bureaucracy and privilege. For Torvalds, the chief barriers were geography and the harsh Helsinki winter. Forced to trek across the University of Helsinki just to log in to his Unix account, Torvalds quickly began looking for a way to log in from the warm confines of his off-campus apartment.
+
+The search led Torvalds to the operating system Minix, a lightweight version of Unix developed for instructional purposes by Dutch university professor Andrew Tanenbaum. The program fit within the memory confines of a 386 PC, the most powerful machine Torvalds could afford, but still lacked a few necessary features. It most notably lacked terminal emulation, the feature that allowed Torvalds' machine to mimic a university terminal, making it possible to log in to the MicroVAX from home.
+
+During the summer of 1991, Torvalds rewrote Minix from the ground up, adding other features as he did so. By the end of the summer, Torvalds was referring to his evolving work as the "GNU/Emacs of terminal emulation programs."~{ See Linus Torvalds and David Diamond, Just For Fun: The Story of an Accidentaly Revolutionary (HarperCollins Publishers, Inc., 2001): 78. }~ Feeling confident, he solicited a Minix newsgroup for copies of the POSIX standards, the software blue prints that determined whether a program was Unix compatible. A few weeks later, Torvalds was posting a message eerily reminiscent of Stallman's original 1983 GNU posting:
+
+poem{
+
+Hello everybody out there using minix-
+
+I'm doing a (free) operating system (just a hobby, won't be big and
+professional like gnu for 386 (486) AT clones). This has been brewing
+since April, and is starting to get ready. I'd like any feedback on
+things people like/dislike in minix, as my OS resembles it somewhat
+(same physical layout of the file-system (due to practical reasons)
+among other things).
+
+}poem~{ See "Linux 10th Anniversary."<br> http://www.linux10.org/history/ }~
+
+The posting drew a smattering of responses and within a month, Torvalds had posted a 0.01 version of the operating system-i.e., the earliest possible version fit for outside review-on an Internet FTP site. In the course of doing so, Torvalds had to come up with a name for the new system. On his own PC hard drive, Torvalds had saved the program as Linux, a name that paid its respects to the software convention of giving each Unix variant a name that ended with the letter X. Deeming the name too "egotistical," Torvalds changed it to Freax, only to have the FTP site manager change it back.
+
+Although Torvalds had set out build a full operating system, both he and other developers knew at the time that most of the functional tools needed to do so were already available, thanks to the work of GNU, BSD, and other free software developers. One of the first tools the Linux development team took advantage of was the GNU C Compiler, a tool that made it possible to process programs written in the C programming language.
+
+Integrating GCC improved the performance of Linux. It also raised issues. Although the GPL's "viral" powers didn't apply to the Linux kernel, Torvald's willingness to borrow GCC for the purposes of his own free software operating system indicated a certain obligation to let other users borrow back. As Torvalds would later put it: "I had hoisted myself up on the shoulders of giants."~{ See Linus Torvalds and David Diamond, Just For Fun: The Story of an Accidentaly Revolutionary (HarperCollins Publishers, Inc., 2001): 96-97. }~ Not surprisingly, he began to think about what would happen when other people looked to him for similar support. A decade after the decision, Torvalds echoes the Free Software Foundation's Robert Chassel when he sums up his thoughts at the time:
+
+_1 You put six months of your life into this thing and you want to make it available and you want to get something out of it, but you don't want people to take advantage of it. I wanted people to be able to see [Linux], and to make changes and improvements to their hearts' content. But I also wanted to make sure that what I got out of it was to see what they were doing. I wanted to always have access to the sources so that if they made improvements, I could make those improvements myself.~{ See Linus Torvalds and David Diamond, Just For Fun: The Story of an Accidentaly Revolutionary (HarperCollins Publishers, Inc., 2001): 94-95. }~
+
+When it was time to release the 0.12 version of Linux, the first to include a fully integrated version of GCC, Torvalds decided to voice his allegiance with the free software movement. He discarded the old kernel license and replaced it with the GPL. The decision triggered a porting spree, as Torvalds and his collaborators looked to other GNU programs to fold into the growing Linux stew. Within three years, Linux developers were offering their first production release, Linux 1.0, including fully modified versions of GCC, GDB, and a host of BSD tools.
+
+By 1994, the amalgamated operating system had earned enough respect in the hacker world to make some observers wonder if Torvalds hadn't given away the farm by switching to the GPL in the project's initial months. In the first issue of Linux Journal, publisher Robert Young sat down with Torvalds for an interview. When Young asked the Finnish programmer if he felt regret at giving up private ownership of the Linux source code, Torvalds said no. "Even with 20/20 hindsight," Torvalds said, he considered the GPL "one of the very best design decisions" made during the early stages of the Linux project.~{ See Robert Young, "Interview with Linus, the Author of Linux," Linux Journal (March 1, 1994).<br> http://www.linuxjournal.com/article.php?sid=2736 }~
+
+That the decision had been made with zero appeal or deference to Stallman and the Free Software Foundation speaks to the GPL's growing portability. Although it would take a few years to be recognized by Stallman, the explosiveness of Linux development conjured flashbacks of Emacs. This time around, however, the innovation triggering the explosion wasn't a software hack like Control-R but the novelty of running a Unix-like system on the PC architecture. The motives may have been different, but the end result certainly fit the ethical specifications: a fully functional operating system composed entirely of free software.
+
+As his initial email message to the comp.os.minix newsgroup indicates, it would take a few months before Torvalds saw Linux as anything less than a holdover until the GNU developers delivered on the HURD kernel. This initial unwillingness to see Linux in political terms would represent a major blow to the Free Software Foundation.
+
+As far as Torvalds was concerned, he was simply the latest in a long line of kids taking apart and reassembling things just for fun. Nevertheless, when summing up the runaway success of a project that could have just as easily spent the rest of its days on an abandoned computer hard drive, Torvalds credits his younger self for having the wisdom to give up control and accept the GPL bargain.
+
+"I may not have seen the light," writes Torvalds, reflecting on Stallman's 1991 Polytechnic University speech and his subsequent decision to switch to the GPL. "But I guess something from his speech sunk in ."~{ See Linus Torvalds and David Diamond, Just For Fun: The Story of an Accidentaly Revolutionary (HarperCollins Publishers, Inc., 2001): 59. }~
+
+1~ Chapter 10 - GNU/Linux
+
+By 1993, the free software movement was at a crossroads. To the optimistically inclined, all signs pointed toward success for the hacker culture. Wired magazine, a funky, new publication offering stories on data encryption, Usenet, and software freedom, was flying off magazine racks. The Internet, once a slang term used only by hackers and research scientists, had found its way into mainstream lexicon. Even President Clinton was using it. The personal computer, once a hobbyist's toy, had grown to full-scale respectability, giving a whole new generation of computer users access to hacker-built software. And while the GNU Project had not yet reached its goal of a fully intact, free software operating system, curious users could still try Linux in the interim.
+
+Any way you sliced it, the news was good, or so it seemed. After a decade of struggle, hackers and hacker values were finally gaining acceptance in mainstream society. People were getting it.
+
+Or were they? To the pessimistically inclined, each sign of acceptance carried its own troubling countersign. Sure, being a hacker was suddenly cool, but was cool good for a community that thrived on alienation? Sure, the White House was saying all the right things about the Internet, even going so far as to register its own domain name, whitehouse.gov, but it was also meeting with the companies, censorship advocates, and law-enforcement officials looking to tame the Internet's Wild West culture. Sure, PCs were more powerful, but in commoditizing the PC marketplace with its chips, Intel had created a situation in which proprietary software vendors now held the power. For every new user won over to the free software cause via Linux, hundreds, perhaps thousands, were booting up Microsoft Windows for the first time.
+
+Finally, there was the curious nature of Linux itself. Unrestricted by design bugs (like GNU) and legal disputes (like BSD), Linux' high-speed evolution had been so unplanned, its success so accidental, that programmers closest to the software code itself didn't know what to make of it. More compilation album than operating system, it was comprised of a hacker medley of greatest hits: everything from GCC, GDB, and glibc (the GNU Project's newly developed C Library) to X (a Unix-based graphic user interface developed by MIT's Laboratory for Computer Science) to BSD-developed tools such as BIND (the Berkeley Internet Naming Daemon, which lets users substitute easy-to-remember Internet domain names for numeric IP addresses) and TCP/IP. The arch's capstone, of course, was the Linux kernel-itself a bored-out, super-charged version of Minix. Rather than building their operating system from scratch, Torvalds and his rapidly expanding Linux development team had followed the old Picasso adage, "good artists borrow; great artists steal." Or as Torvalds himself would later translate it when describing the secret of his success: "I'm basically a very lazy person who likes to take credit for things other people actually do."~{ Torvalds has offered this quote in many different settings. To date, however, the quote's most notable appearance is in the Eric Raymond essay, "The Cathedral and the Bazaar" (May, 1997).<br> http://www.tuxedo.org/~esr/writings/cathedral-bazaar/cathedral-bazaar/index.html }~
+
+Such laziness, while admirable from an efficiency perspective, was troubling from a political perspective. For one thing, it underlined the lack of an ideological agenda on Torvalds' part. Unlike the GNU developers, Torvalds hadn't built an operating system out of a desire to give his fellow hackers something to work with; he'd built it to have something he himself could play with. Like Tom Sawyer whitewashing a fence, Torvalds' genius lay less in the overall vision and more in his ability to recruit other hackers to speed the process.
+
+That Torvalds and his recruits had succeeded where others had not raised its own troubling question: what, exactly, was Linux? Was it a manifestation of the free software philosophy first articulated by Stallman in the GNU Manifesto? Or was it simply an amalgamation of nifty software tools that any user, similarly motivated, could assemble on his own home system?
+
+By late 1993, a growing number of Linux users had begun to lean toward the latter definition and began brewing private variations on the Linux theme. They even became bold enough to bottle and sell their variations-or "distributions"-to fellow Unix aficionados. The results were spotty at best.
+
+"This was back before Red Hat and the other commercial distributions," remembers Ian Murdock, then a computer science student at Purdue University. "You'd flip through Unix magazines and find all these business card-sized ads proclaiming `Linux.' Most of the companies were fly-by-night operations that saw nothing wrong with slipping a little of their own source code into the mix."
+
+Murdock, a Unix programmer, remembers being "swept away" by Linux when he first downloaded and installed it on his home PC system. "It was just a lot of fun," he says. "It made me want to get involved." The explosion of poorly built distributions began to dampen his early enthusiasm, however. Deciding that the best way to get involved was to build a version of Linux free of additives, Murdock set about putting a list of the best free software tools available with the intention of folding them into his own distribution. "I wanted something that would live up to the Linux name," Murdock says.
+
+In a bid to "stir up some interest," Murdock posted his intentions on the Internet, including Usenet's comp.os.linux newsgroup. One of the first responding email messages was from rms@ai.mit.edu. As a hacker, Murdock instantly recognized the address. It was Richard M. Stallman, founder of the GNU Project and a man Murdock knew even back then as "the hacker of hackers." Seeing the address in his mail queue, Murdock was puzzled. Why on Earth would Stallman, a person leading his own operating-system project, care about Murdock's gripes over Linux?
+
+Murdock opened the message.
+
+"He said the Free Software Foundation was starting to look closely at Linux and that the FSF was interested in possibly doing a Linux system, too. Basically, it looked to Stallman like our goals were in line with their philosophy."
+
+The message represented a dramatic about-face on Stallman's part. Until 1993, Stallman had been content to keep his nose out of the Linux community's affairs. In fact, he had all but shunned the renegade operating system when it first appeared on the Unix programming landscape in 1991. After receiving the first notification of a Unix-like operating system that ran on PCs, Stallman says he delegated the task of examining the new operating system to a friend. Recalls Stallman, "He reported back that the software was modeled after System V, which was the inferior version of Unix. He also told me it wasn't portable."
+
+The friend's report was correct. Built to run on 386-based machines, Linux was firmly rooted to its low-cost hardware platform. What the friend failed to report, however, was the sizable advantage Linux enjoyed as the only freely modifiable operating system in the marketplace. In other words, while Stallman spent the next three years listening to bug reports from his HURD team, Torvalds was winning over the programmers who would later uproot and replant the operating system onto new platforms.
+
+By 1993, the GNU Project's inability to deliver a working kernel was leading to problems both within the GNU Project and within the free software movement at large. A March, 1993, a Wired magazine article by Simson Garfinkel described the GNU Project as "bogged down" despite the success of the project's many tools.~{ See Simson Garfinkel, "Is Stallman Stalled?" Wired (March, 1993). }~ Those within the project and its nonprofit adjunct, the Free Software Foundation, remember the mood as being even worse than Garfinkel's article let on. "It was very clear, at least to me at the time, that there was a window of opportunity to introduce a new operating system," says Chassell. "And once that window was closed, people would become less interested. Which is in fact exactly what happened."~{ Chassel's concern about there being a 36-month "window" for a new operating system is not unique to the GNU Project. During the early 1990s, free software versions of the Berkeley Software Distribution were held up by Unix System Laboratories' lawsuit restricting the release of BSD-derived software. While many users consider BSD offshoots such as FreeBSD and OpenBSD to be demonstrably superior to GNU/Linux both in terms of performance and security, the number of FreeBSD and OpenBSD users remains a fraction of the total GNU/Linux user population.<br>To view a sample analysis of the relative success of GNU/Linux in relation to other free software operating systems, see the essay by New Zealand hacker, Liam Greenwood, "Why is Linux Successful" (1999). }~
+
+Much has been made about the GNU Project's struggles during the 1990-1993 period. While some place the blame on Stallman for those struggles, Eric Raymond, an early member of the GNU Emacs team and later Stallman critic, says the problem was largely institutional. "The FSF got arrogant," Raymond says. "They moved away from the goal of doing a production-ready operating system to doing operating-system research." Even worse, "They thought nothing outside the FSF could affect them."
+
+Murdock, a person less privy to the inner dealings of the GNU Project, adopts a more charitable view. "I think part of the problem is they were a little too ambitious and they threw good money after bad," he says. "Micro-kernels in the late 80s and early 90s were a hot topic. Unfortunately, that was about the time that the GNU Project started to design their kernel. They ended up with alot of baggage and it would have taken a lot of backpedaling to lose it."
+
+Stallman cites a number of issues when explaining the delay. The Lotus and Apple lawsuits had provided political distractions, which, coupled with Stallman's inability to type, made it difficult for Stallman to lend a helping hand to the HURD team. Stallman also cites poor communication between various portions of the GNU Project. "We had to do a lot of work to get the debugging environment to work," he recalls. "And the people maintaining GDB at the time were not that cooperative." Mostly, however, Stallman says he and the other members of the GNU Project team underestimated the difficulty of expanding the Mach microkernal into a full-fledged Unix kernel.
+
+"I figured, OK, the [Mach] part that has to talk to the machine has already been debugged," Stallman says, recalling the HURD team's troubles in a 2000 speech. "With that head start, we should be able to get it done faster. But instead, it turned out that debugging these asynchronous multithreaded programs was really hard. There were timing books that would clobber the files, and that's no fun. The end result was that it took many, many years to produce a test version."~{ See Maui High Performance Computing Center Speech. }~
+
+Whatever the excuse, or excuses, the concurrent success of the Linux-kernel team created a tense situation. Sure, the Linux kernel had been licensed under the GPL, but as Murdock himself had noted, the desire to treat Linux as a purely free software operating system was far from uniform. By late 1993, the total Linux user population had grown from a dozen or so Minix enthusiasts to somewhere between 20,000 and 100,000.~{ GNU/Linux user-population numbers are sketchy at best, which is why I've provided such a broad range. The 100,000 total comes from the Red Hat "Milestones" site,<br> http://www.redhat.com/about/corporate/milestones.html }~ What had once been a hobby was now a marketplace ripe for exploitation. Like Winston Churchill watching Soviet troops sweep into Berlin, Stallman felt an understandable set of mixed emotions when it came time to celebrate the Linux "victory."~{ I wrote this Winston Churchill analogy before Stallman himself sent me his own unsolicited comment on Churchill:<br>_1 World War II and the determination needed to win it was a very strong memory as I was growing up. Statements such as Churchill's, "We will fight them in the landing zones, we will fight them on the beaches . . . we will never surrender," have always resonated for me. }~
+
+Although late to the party, Stallman still had clout. As soon as the FSF announced that it would lend its money and moral support to Murdock's software project, other offers of support began rolling in. Murdock dubbed the new project Debian-a compression of his and his wife, Deborah's, names-and within a few weeks was rolling out the first distribution. "[Richard's support] catapulted Debian almost overnight from this interesting little project to something people within the community had to pay attention to," Murdock says.
+
+In January of 1994, Murdock issued the " Debian Manifesto." Written in the spirit of Stallman's "GNU Manifesto" from a decade before, it explained the importance of working closely with the Free Software Foundation. Murdock wrote:
+
+_1 The Free Software Foundation plays an extremely important role in the future of Debian. By the simple fact that they will be distributing it, a message is sent to the world that Linux is not a commercial product and that it never should be, but that this does not mean that Linux will never be able to compete commercially. For those of you who disagree, I challenge you to rationalize the success of GNU Emacs and GCC, which are not commercial software but which have had quite an impact on the commercial market regardless of that fact.
+
+_1 The time has come to concentrate on the future of Linux rather than on the destructive goal of enriching oneself at the expense of the entire Linux community and its future. The development and distribution of Debian may not be the answer to the problems that I have outlined in the Manifesto, but I hope that it will at least attract enough attention to these problems to allow them to be solved.~{ See Ian Murdock, "A Brief History of Debian," (January 6, 1994): Appendix A, "The Debian Manifesto."<br> http://www.debian.org/doc/manuals/project-history/apA.html }~
+
+Shortly after the Manifesto's release, the Free Software Foundation made its first major request. Stallman wanted Murdock to call its distribution "GNU/Linux." At first, Murdock says, Stallman had wanted to use the term " Lignux"-"as in Linux with GNU at the heart of it"-but a sample testing of the term on Usenet and in various impromptu hacker focus groups had merited enough catcalls to convince Stallman to go with the less awkward GNU/Linux.
+
+Although some would dismiss Stallman's attempt to add the "GNU" prefix as a belated quest for credit, Murdock saw it differently. Looking back, Murdock saw it as an attempt to counteract the growing tension between GNU Project and Linux-kernel developers. "There was a split emerging," Murdock recalls. "Richard was concerned."
+
+The deepest split, Murdock says, was over glibc. Short for GNU C Library, glibc is the package that lets programmers make "system calls" directed at the kernel. Over the course of 1993-1994, glibc emerged as a troublesome bottleneck in Linux development. Because so many new users were adding new functions to the Linux kernel, the GNU Project's glibc maintainers were soon overwhelmed with suggested changes. Frustrated by delays and the GNU Project's growing reputation for foot-dragging, some Linux developers suggested creating a " fork"-i.e., a Linux-specific C Library parallel to glibc.
+
+In the hacker world, forks are an interesting phenomenon. Although the hacker ethic permits a programmer to do anything he wants with a given program's source code, most hackers prefer to pour their innovations into a central source-code file or " tree" to ensure compatibility with other people's programs. To fork glibc this early in the development of Linux would have meant losing the potential input of hundreds, even thousands, of Linux developers. It would also mean growing incompatibility between Linux and the GNU system that Stallman and the GNU team still hoped to develop.
+
+As leader of the GNU Project, Stallman had already experienced the negative effects of a software fork in 1991. A group of Emacs developers working for a software company named Lucid had a falling out over Stallman's unwillingness to fold changes back into the GNU Emacs code base. The fork had given birth to a parallel version, Lucid Emacs, and hard feelings all around.~{ Jamie Zawinski, a former Lucid programmer who would go on to head the Mozilla development team, has a web site that documents the Lucid/GNU Emacs fork, titled, "The Lemacs/FSFmacs Schism."<br> http://www.jwz.org/doc/lemacs.html }~
+
+Murdock says Debian was mounting work on a similar fork in glibc source code that motivated Stallman to insist on adding the GNU prefix when Debian rolled out its software distribution. "The fork has since converged. Still, at the time, there was a concern that if the Linux community saw itself as a different thing as the GNU community, it might be a force for disunity."
+
+Stallman seconds Murdock's recollection. In fact, he says there were nascent forks appearing in relation to every major GNU component. At first, Stallman says he considered the forks to be a product of sour grapes. In contrast to the fast and informal dynamics of the Linux-kernel team, GNU source-code maintainers tended to be slower and more circumspect in making changes that might affect a program's long-term viability. They also were unafraid of harshly critiquing other people's code. Over time, however, Stallman began to sense that there was an underlying lack of awareness of the GNU Project and its objectives when reading Linux developers' emails.
+
+"We discovered that the people who considered themselves Linux users didn't care about the GNU Project," Stallman says. "They said, `Why should I bother doing these things? I don't care about the GNU Project. It's working for me. It's working for us Linux users, and nothing else matters to us.' And that was quite surprising given that people were essentially using a variant of the GNU system, and they cared so little. They cared less than anybody else about GNU."
+
+While some viewed descriptions of Linux as a "variant" of the GNU Project as politically grasping, Murdock, already sympathetic to the free software cause, saw Stallman's request to call Debian's version GNU/Linux as reasonable. "It was more for unity than for credit," he says.
+
+Requests of a more technical nature quickly followed. Although Murdock had been accommodating on political issues, he struck a firmer pose when it came to the design and development model of the actual software. What had begun as a show of solidarity soon became of model of other GNU projects.
+
+"I can tell you that I've had my share of disagreements with him," says Murdock with a laugh. "In all honesty Richard can be a fairly difficult person to work with."
+
+In 1996, Murdock, following his graduation from Purdue, decided to hand over the reins of the growing Debian project. He had already been ceding management duties to Bruce Perens, the hacker best known for his work on Electric Fence, a Unix utility released under the GPL. Perens, like Murdock, was a Unix programmer who had become enamored of GNU/Linux as soon as the program's Unix-like abilities became manifest. Like Murdock, Perens sympathized with the political agenda of Stallman and the Free Software Foundation, albeit from afar.
+
+"I remember after Stallman had already come out with the GNU Manifesto, GNU Emacs, and GCC, I read an article that said he was working as a consultant for Intel," says Perens, recalling his first brush with Stallman in the late 1980s. "I wrote him asking how he could be advocating free software on the one hand and working for Intel on the other. He wrote back saying, `I work as a consultant to produce free software.' He was perfectly polite about it, and I thought his answer made perfect sense."
+
+As a prominent Debian developer, however, Perens regarded Murdock's design battles with Stallman with dismay. Upon assuming leadership of the development team, Perens says he made the command decision to distance Debian from the Free Software Foundation. "I decided we did not want Richard's style of micro-management," he says.
+
+According to Perens, Stallman was taken aback by the decision but had the wisdom to roll with it. "He gave it some time to cool off and sent a message that we really needed a relationship. He requested that we call it GNU/Linux and left it at that. I decided that was fine. I made the decision unilaterally. Everybody breathed a sigh of relief."
+
+Over time, Debian would develop a reputation as the hacker's version of Linux, alongside Slackware, another popular distribution founded during the same 1993-1994 period. Outside the realm of hacker-oriented systems, however, Linux was picking up steam in the commercial Unix marketplace. In North Carolina, a Unix company billing itself as Red Hat was revamping its business to focus on Linux. The chief executive officer was Robert Young, the former Linux Journal editor who in 1994 had put the question to Linus Torvalds, asking whether he had any regrets about putting the kernel under the GPL. To Young, Torvalds' response had a "profound" impact on his own view toward Linux. Instead of looking for a way to corner the GNU/Linux market via traditional software tactics, Young began to consider what might happen if a company adopted the same approach as Debian-i.e., building an operating system completely out of free software parts. Cygnus Solutions, the company founded by Michael Tiemann and John Gilmore in 1990, was already demonstrating the ability to sell free software based on quality and customizability. What if Red Hat took the same approach with GNU/Linux?
+
+"In the western scientific tradition we stand on the shoulders of giants," says Young, echoing both Torvalds and Sir Isaac Newton before him. "In business, this translates to not having to reinvent wheels as we go along. The beauty of [the GPL] model is you put your code into the public domain.~{ Young uses the term "public domain" incorrectly here. Public domain means not protected by copyright. GPL-protected programs are by definition protected by copyright. }~ If you're an independent software vendor and you're trying to build some application and you need a modem-dialer, well, why reinvent modem dialers? You can just steal PPP off of Red Hat Linux and use that as the core of your modem-dialing tool. If you need a graphic tool set, you don't have to write your own graphic library. Just download GTK. Suddenly you have the ability to reuse the best of what went before. And suddenly your focus as an application vendor is less on software management and more on writing the applications specific to your customer's needs."
+
+Young wasn't the only software executive intrigued by the business efficiencies of free software. By late 1996, most Unix companies were starting to wake up and smell the brewing source code. The Linux sector was still a good year or two away from full commercial breakout mode, but those close enough to the hacker community could feel it: something big was happening. The Intel 386 chip, the Internet, and the World Wide Web had hit the marketplace like a set of monster waves, and Linux-and the host of software programs that echoed it in terms of source-code accessibility and permissive licensing-seemed like the largest wave yet.
+
+For Ian Murdock, the programmer courted by Stallman and then later turned off by Stallman's micromanagement style, the wave seemed both a fitting tribute and a fitting punishment for the man who had spent so much time giving the free software movement an identity. Like many Linux aficionados, Murdock had seen the original postings. He'd seen Torvalds's original admonition that Linux was "just a hobby." He'd also seen Torvalds's admission to Minix creator Andrew Tanenbaum: "If the GNU kernel had been ready last spring, I'd not have bothered to even start my project."~{ This quote is taken from the much-publicized Torvalds-Tanenbaum "flame war" following the initial release of Linux. In the process of defending his choice of a nonportable monolithic kernel design, Torvalds says he started working on Linux as a way to learn more about his new 386 PC. "If the GNU kernel had been ready last spring, I'd not have bothered to even start my project." See Chris DiBona et al., Open Sources (O'Reilly & Associates, Inc., 1999): 224. }~ Like many, Murdock knew the opportunities that had been squandered. He also knew the excitement of watching new opportunities come seeping out of the very fabric of the Internet.
+
+"Being involved with Linux in those early days was fun," recalls Murdock. "At the same time, it was something to do, something to pass the time. If you go back and read those old [comp.os.minix] exchanges, you'll see the sentiment: this is something we can play with until the HURD is ready. People were anxious. It's funny, but in a lot of ways, I suspect that Linux would never have happened if the HURD had come along more quickly."
+
+By the end of 1996, however, such "what if" questions were already moot. Call it Linux, call it GNU/Linux; the users had spoken. The 36-month window had closed, meaning that even if the GNU Project had rolled out its HURD kernel, chances were slim anybody outside the hard-core hacker community would have noticed. The first Unix-like free software operating system was here, and it had momentum. All hackers had left to do was sit back and wait for the next major wave to come crashing down on their heads. Even the shaggy-haired head of one Richard M. Stallman.
+
+Ready or not.
+
+1~ Chapter 11 - Open Source
+
+In November , 1995, Peter Salus, a member of the Free Software Foundation and author of the 1994 book, A Quarter Century of Unix, issued a call for papers to members of the GNU Project's "system-discuss" mailing list. Salus, the conference's scheduled chairman, wanted to tip off fellow hackers about the upcoming Conference on Freely Redistributable Software in Cambridge, Massachusetts. Slated for February, 1996 and sponsored by the Free Software Foundation, the event promised to be the first engineering conference solely dedicated to free software and, in a show of unity with other free software programmers, welcomed papers on "any aspect of GNU, Linux, NetBSD, 386BSD, FreeBSD, Perl, Tcl/tk, and other tools for which the code is accessible and redistributable." Salus wrote:
+
+_1 Over the past 15 years, free and low-cost software has become ubiquitous. This conference will bring together implementers of several different types of freely redistributable software and publishers of such software (on various media). There will be tutorials and refereed papers, as well as keynotes by Linus Torvalds and Richard Stallman.~{ See Peter Salus, "FYI-Conference on Freely Redistributable Software, 2/2, Cambridge" (1995) (archived by Terry Winograd).<br> http://hci.stanford.edu/pcd-archives/pcd-fyi/1995/0078.html }~
+
+One of the first people to receive Salus' email was conference committee member Eric S. Raymond. Although not the leader of a project or company like the various other members of the list, Raymond had built a tidy reputation within the hacker community as a major contributor to GNU Emacs and as editor of The New Hacker Dictionary, a book version of the hacking community's decade-old Jargon File.
+
+For Raymond, the 1996 conference was a welcome event. Active in the GNU Project during the 1980s, Raymond had distanced himself from the project in 1992, citing, like many others before him, Stallman's "micro-management" style. "Richard kicked up a fuss about my making unauthorized modifications when I was cleaning up the Emacs LISP libraries," Raymond recalls. "It frustrated me so much that I decided I didn't want to work with him anymore."
+
+Despite the falling out, Raymond remained active in the free software community. So much so that when Salus suggested a conference pairing Stallman and Torvalds as keynote speakers, Raymond eagerly seconded the idea. With Stallman representing the older, wiser contingent of ITS/Unix hackers and Torvalds representing the younger, more energetic crop of Linux hackers, the pairing indicated a symbolic show of unity that could only be beneficial, especially to ambitious younger (i.e., below 40) hackers such as Raymond. "I sort of had a foot in both camps," Raymond says.
+
+By the time of the conference, the tension between those two camps had become palpable. Both groups had one thing in common, though: the conference was their first chance to meet the Finnish wunderkind in the flesh. Surprisingly, Torvalds proved himself to be a charming, affable speaker. Possessing only a slight Swedish accent, Torvalds surprised audience members with his quick, self-effacing wit.~{ Although Linus Torvalds is Finnish, his mother tongue is Swedish. "The Rampantly Unofficial Linus FAQ" offers a brief explanation:<br>_1 Finland has a significant (about 6%) Swedish-speaking minority population. They call themselves "finlandssvensk" or "finlandssvenskar" and consider themselves Finns; many of their families have lived in Finland for centuries. Swedish is one of Finland's two official languages.<br> http://tuxedo.org/~esr/faqs/linus/ }~ Even more surprising, says Raymond, was Torvalds' equal willingness to take potshots at other prominent hackers, including the most prominent hacker of all, Richard Stallman. By the end of the conference, Torvalds' half-hacker, half-slacker manner was winning over older and younger conference-goers alike.
+
+"It was a pivotal moment," recalls Raymond. "Before 1996, Richard was the only credible claimant to being the ideological leader of the entire culture. People who dissented didn't do so in public. The person who broke that taboo was Torvalds."
+
+The ultimate breach of taboo would come near the end of the show. During a discussion on the growing market dominance of Microsoft Windows or some similar topic, Torvalds admitted to being a fan of Microsoft's PowerPoint slideshow software program. From the perspective of old-line software purists, it was like a Mormon bragging in church about his fondness of whiskey. From the perspective of Torvalds and his growing band of followers, it was simply common sense. Why shun worthy proprietary software programs just to make a point? Being a hacker wasn't about suffering, it was about getting the job done.
+
+"That was a pretty shocking thing to say," Raymond remembers. "Then again, he was able to do that, because by 1995 and 1996, he was rapidly acquiring clout."
+
+Stallman, for his part, doesn't remember any tension at the 1996 conference, but he does remember later feeling the sting of Torvalds' celebrated cheekiness. "There was a thing in the Linux documentation which says print out the GNU coding standards and then tear them up," says Stallman, recalling one example. "OK, so he disagrees with some of our conventions. That's fine, but he picked a singularly nasty way of saying so. He could have just said `Here's the way I think you should indent your code.' Fine. There should be no hostility there."
+
+For Raymond, the warm reception other hackers gave to Torvalds' comments merely confirmed his suspicions. The dividing line separating Linux developers from GNU/Linux developers was largely generational. Many Linux hackers, like Torvalds, had grown up in a world of proprietary software. Unless a program was clearly inferior, most saw little reason to rail against a program on licensing issues alone. Somewhere in the universe of free software systems lurked a program that hackers might someday turn into a free software alternative to PowerPoint. Until then, why begrudge Microsoft the initiative of developing the program and reserving the rights to it?
+
+As a former GNU Project member, Raymond sensed an added dynamic to the tension between Stallman and Torvalds. In the decade since launching the GNU Project, Stallman had built up a fearsome reputation as a programmer. He had also built up a reputation for intransigence both in terms of software design and people management. Shortly before the 1996 conference, the Free Software Foundation would experience a full-scale staff defection, blamed in large part on Stallman. Brian Youmans, a current FSF staffer hired by Salus in the wake of the resignations, recalls the scene: "At one point, Peter [Salus] was the only staff member working in the office."
+
+For Raymond, the defection merely confirmed a growing suspicion: recent delays such as the HURD and recent troubles such as the Lucid-Emacs schism reflected problems normally associated with software project management, not software code development. Shortly after the Freely Redistributable Software Conference, Raymond began working on his own pet software project, a popmail utility called " fetchmail." Taking a cue from Torvalds, Raymond issued his program with a tacked-on promise to update the source code as early and as often as possible. When users began sending in bug reports and feature suggestions, Raymond, at first anticipating a tangled mess, found the resulting software surprisingly sturdy. Analyzing the success of the Torvalds approach, Raymond issued a quick analysis: using the Internet as his "petri dish" and the harsh scrutiny of the hacker community as a form of natural selection, Torvalds had created an evolutionary model free of central planning.
+
+What's more, Raymond decided, Torvalds had found a way around Brooks' Law. First articulated by Fred P. Brooks, manager of IBM's OS/360 project and author of the 1975 book, The Mythical Man-Month, Brooks' Law held that adding developers to a project only resulted in further project delays. Believing as most hackers that software, like soup, benefits from a limited number of cooks, Raymond sensed something revolutionary at work. In inviting more and more cooks into the kitchen, Torvalds had actually found away to make the resulting software better.~{ Brooks' Law is the shorthand summary of the following quote taken from Brooks' book:<br>_1 Since software construction is inherently a systems effort-an exercise in complex interrelationships-communication effort is great, and it quickly dominates the decrease in individual task time brought about by partitioning. Adding more men then lengthens, not shortens, the schedule.<br>See Fred P. Brooks, The Mythical Man-Month (Addison Wesley Publishing, 1995) }~
+
+Raymond put his observations on paper. He crafted them into a speech, which he promptly delivered before a group of friends and neighbors in Chester County, Pennsylvania. Dubbed " The Cathedral and the Bazaar," the speech contrasted the management styles of the GNU Project with the management style of Torvalds and the kernel hackers. Raymond says the response was enthusiastic, but not nearly as enthusiastic as the one he received during the 1997 Linux Kongress, a gathering of Linux users in Germany the next spring.
+
+"At the Kongress, they gave me a standing ovation at the end of the speech," Raymond recalls. "I took that as significant for two reasons. For one thing, it meant they were excited by what they were hearing. For another thing, it meant they were excited even after hearing the speech delivered through a language barrier."
+
+Eventually, Raymond would convert the speech into a paper, also titled "The Cathedral and the Bazaar." The paper drew its name from Raymond's central analogy. GNU programs were "cathedrals," impressive, centrally planned monuments to the hacker ethic, built to stand the test of time. Linux, on the other hand, was more like "a great babbling bazaar," a software program developed through the loose decentralizing dynamics of the Internet.
+
+Implicit within each analogy was a comparison of Stallman and Torvalds. Where Stallman served as the classic model of the cathedral architect-i.e., a programming "wizard" who could disappear for 18 months and return with something like the GNU C Compiler-Torvalds was more like a genial dinner-party host. In letting others lead the Linux design discussion and stepping in only when the entire table needed a referee, Torvalds had created a development model very much reflective of his own laid-back personality. From the Torvalds' perspective, the most important managerial task was not imposing control but keeping the ideas flowing.
+
+Summarized Raymond, "I think Linus's cleverest and most consequential hack was not the construction of the Linux kernel itself, but rather his invention of the Linux development model."~{ See Eric Raymond, "The Cathredral and the Bazaar" (1997). }~
+
+In summarizing the secrets of Torvalds' managerial success, Raymond himself had pulled off a coup. One of the audience members at the Linux Kongress was Tim O'Reilly, publisher of O'Reilly & Associates, a company specializing in software manuals and software-related books (and the publisher of this book). After hearing Raymond's Kongress speech, O'Reilly promptly invited Raymond to deliver it again at the company's inaugural Perl Conference later that year in Monterey, California.
+
+Although the conference was supposed to focus on Perl, a scripting language created by Unix hacker Larry Wall, O'Reilly assured Raymond that the conference would address other free software technologies. Given the growing commercial interest in Linux and Apache, a popular free software web server, O'Reilly hoped to use the event to publicize the role of free software in creating the entire infrastructure of the Internet. From web-friendly languages such as Perl and Python to back-room programs such as BIND (the Berkeley Internet Naming Daemon), a software tool that lets users replace arcane IP numbers with the easy-to-remember domain-name addresses (e.g., amazon.com), and sendmail, the most popular mail program on the Internet, free software had become an emergent phenomenon. Like a colony of ants creating a beautiful nest one grain of sand at a time, the only thing missing was the communal self-awareness. O'Reilly saw Raymond's speech as a good way to inspire that self-awareness, to drive home the point that free software development didn't start and end with the GNU Project. Programming languages, such as Perl and Python, and Internet software, such as BIND, sendmail, and Apache, demonstrated that free software was already ubiquitous and influential. He also assured Raymond an even warmer reception than the one at Linux Kongress.
+
+O'Reilly was right. "This time, I got the standing ovation before the speech," says Raymond, laughing.
+
+As predicted, the audience was stocked not only with hackers, but with other people interested in the growing power of the free software movement. One contingent included a group from Netscape, the Mountain View, California startup then nearing the end game of its three-year battle with Microsoft for control of the web-browser market.
+
+Intrigued by Raymond's speech and anxious to win back lost market share, Netscape executives took the message back to corporate headquarters. A few months later, in January, 1998, the company announced its plan to publish the source code of its flagship Navigator web browser in the hopes of enlisting hacker support in future development.
+
+When Netscape CEO Jim Barksdale cited Raymond's "Cathedral and the Bazaar" essay as a major influence upon the company's decision, the company instantly elevated Raymond to the level of hacker celebrity. Determined not to squander the opportunity, Raymond traveled west to deliver interviews, advise Netscape executives, and take part in the eventual party celebrating the publication of Netscape Navigator's source code. The code name for Navigator's source code was "Mozilla": a reference both to the program's gargantuan size-30 million lines of code-and to its heritage. Developed as a proprietary offshoot of Mosaic, the web browser created by Marc Andreessen at the University of Illinois, Mozilla was proof, yet again, that when it came to building new programs, most programmers preferred to borrow on older, modifiable programs.
+
+While in California, Raymond also managed to squeeze in a visit to VA Research, a Santa Clara-based company selling workstations with the GNU/Linux operating system preinstalled. Convened by Raymond, the meeting was small. The invite list included VA founder Larry Augustin, a few VA employees, and Christine Peterson, president of the Foresight Institute, a Silicon Valley think tank specializing in nanotechnology.
+
+"The meeting's agenda boiled down to one item: how to take advantage of Netscape's decision so that other companies might follow suit?" Raymond doesn't recall the conversation that took place, but he does remember the first complaint addressed. Despite the best efforts of Stallman and other hackers to remind people that the word "free" in free software stood for freedom and not price, the message still wasn't getting through. Most business executives, upon hearing the term for the first time, interpreted the word as synonymous with "zero cost," tuning out any follow up messages in short order. Until hackers found a way to get past this cognitive dissonance, the free software movement faced an uphill climb, even after Netscape.
+
+Peterson, whose organization had taken an active interest in advancing the free software cause, offered an alternative: open source.
+
+Looking back, Peterson says she came up with the open source term while discussing Netscape's decision with a friend in the public relations industry. She doesn't remember where she came upon the term or if she borrowed it from another field, but she does remember her friend disliking the term.~{ See Malcolm Maclachlan, "Profit Motive Splits Open Source Movement," TechWeb News (August 26, 1998).<br> http://content.techweb.com/wire/story/TWB19980824S0012 }~
+
+At the meeting, Peterson says, the response was dramatically different. "I was hesitant about suggesting it," Peterson recalls. "I had no standing with the group, so started using it casually, not highlighting it as a new term." To Peterson's surprise, the term caught on. By the end of the meeting, most of the attendees, including Raymond, seemed pleased by it.
+
+Raymond says he didn't publicly use the term "open source" as a substitute for free software until a day or two after the Mozilla launch party, when O'Reilly had scheduled a meeting to talk about free software. Calling his meeting "the Freeware Summit," O'Reilly says he wanted to direct media and community attention to the other deserving projects that had also encouraged Netscape to release Mozilla. "All these guys had so much in common, and I was surprised they didn't all know each other," says O'Reilly. "I also wanted to let the world know just how great an impact the free software culture had already made. People were missing out on a large part of the free software tradition."
+
+In putting together the invite list, however, O'Reilly made a decision that would have long-term political consequences. He decided to limit the list to west-coast developers such as Wall, Eric Allman, creator of sendmail, and Paul Vixie, creator of BIND. There were exceptions, of course: Pennsylvania-resident Raymond, who was already in town thanks to the Mozilla launch, earned a quick invite. So did Virginia-resident Guido van Rossum, creator of Python. "Frank Willison, my editor in chief and champion of Python within the company, invited him without first checking in with me," O'Reilly recalls. "I was happy to have him there, but when I started, it really was just a local gathering."
+
+For some observers, the unwillingness to include Stallman's name on the list qualified as a snub. "I decided not to go to the event because of it," says Perens, remembering the summit. Raymond, who did go, says he argued for Stallman's inclusion to no avail. The snub rumor gained additional strength from the fact that O'Reilly, the event's host, had feuded publicly with Stallman over the issue of software-manual copyrights. Prior to the meeting, Stallman had argued that free software manuals should be as freely copyable and modifiable as free software programs. O'Reilly, meanwhile, argued that a value-added market for nonfree books increased the utility of free software by making it more accessible to a wider community. The two had also disputed the title of the event, with Stallman insisting on "Free Software" over the less politically laden "Freeware."
+
+Looking back, O'Reilly doesn't see the decision to leave Stallman's name off the invite list as a snub. "At that time, I had never met Richard in person, but in our email interactions, he'd been inflexible and unwilling to engage in dialogue. I wanted to make sure the GNU tradition was represented at the meeting, so I invited John Gilmore and Michael Tiemann, whom I knew personally, and whom I knew were passionate about the value of the GPL but seemed more willing to engage in a frank back-and-forth about the strengths and weaknesses of the various free software projects and traditions. Given all the later brouhaha, I do wish I'd invited Richard as well, but I certainly don't think that my failure to do so should be interpreted as a lack of respect for the GNU Project or for Richard personally."
+
+Snub or no snub, both O'Reilly and Raymond say the term "open source" won over just enough summit-goers to qualify as a success. The attendees shared ideas and experiences and brainstormed on how to improve free software's image. Of key concern was how to point out the successes of free software, particularly in the realm of Internet infrastructure, as opposed to playing up the GNU/Linux challenge to Microsoft Windows. But like the earlier meeting at VA, the discussion soon turned to the problems associated with the term "free software." O'Reilly, the summit host, remembers a particularly insightful comment from Torvalds, a summit attendee.
+
+"Linus had just moved to Silicon Valley at that point, and he explained how only recently that he had learned that the word `free' had two meanings-free as in `libre' and free as in `gratis'-in English."
+
+Michael Tiemann, founder of Cygnus, proposed an alternative to the troublesome "free software" term: sourceware. "Nobody got too excited about it," O'Reilly recalls. "That's when Eric threw out the term `open source.'"
+
+Although the term appealed to some, support for a change in official terminology was far from unanimous. At the end of the one-day conference, attendees put the three terms-free software, open source, or sourceware-to a vote. According to O'Reilly, 9 out of the 15 attendees voted for "open source." Although some still quibbled with the term, all attendees agreed to use it in future discussions with the press. "We wanted to go out with a solidarity message," O'Reilly says.
+
+The term didn't take long to enter the national lexicon. Shortly after the summit, O'Reilly shepherded summit attendees to a press conference attended by reporters from the New York Times, the Wall Street Journal, and other prominent publications. Within a few months, Torvalds' face was appearing on the cover of Forbes magazine, with the faces of Stallman, Perl creator Larry Wall, and Apache team leader Brian Behlendorf featured in the interior spread. Open source was open for business.
+
+For summit attendees such as Tiemann, the solidarity message was the most important thing. Although his company had achieved a fair amount of success selling free software tools and services, he sensed the difficulty other programmers and entrepreneurs faced.
+
+"There's no question that the use of the word free was confusing in a lot of situations," Tiemann says. "Open source positioned itself as being business friendly and business sensible. Free software positioned itself as morally righteous. For better or worse we figured it was more advantageous to align with the open source crowd.
+
+For Stallman, the response to the new "open source" term was slow in coming. Raymond says Stallman briefly considered adopting the term, only to discard it. "I know because I had direct personal conversations about it," Raymond says.
+
+By the end of 1998, Stallman had formulated a position: open source, while helpful in communicating the technical advantages of free software, also encouraged speakers to soft-pedal the issue of software freedom. Given this drawback, Stallman would stick with the term free software.
+
+Summing up his position at the 1999 LinuxWorld Convention and Expo, an event billed by Torvalds himself as a "coming out party" for the Linux community, Stallman implored his fellow hackers to resist the lure of easy compromise.
+
+"Because we've shown how much we can do, we don't have to be desperate to work with companies or compromise our goals," Stallman said during a panel discussion. "Let them offer and we'll accept. We don't have to change what we're doing to get them to help us. You can take a single step towards a goal, then another and then more and more and you'll actually reach your goal. Or, you can take a half measure that means you don't ever take another step and you'll never get there."
+
+Even before the LinuxWorld show, however, Stallman was showing an increased willingness to alienate his more conciliatory peers. A few months after the Freeware Summit, O'Reilly hosted its second annual Perl Conference. This time around, Stallman was in attendance. During a panel discussion lauding IBM's decision to employ the free software Apache web server in its commercial offerings, Stallman, taking advantage of an audience microphone, disrupted the proceedings with a tirade against panelist John Ousterhout, creator of the Tcl scripting language. Stallman branded Ousterhout a "parasite" on the free software community for marketing a proprietary version of Tcl via Ousterhout's startup company, Scriptics. "I don't think Scriptics is necessary for the continued existence of Tcl," Stallman said to hisses from the fellow audience members. ^98^
+
+"It was a pretty ugly scene," recalls Prime Time Freeware's Rich Morin. "John's done some pretty respectable things: Tcl, Tk, Sprite. He's a real contributor."
+
+Despite his sympathies for Stallman and Stallman's position, Morin felt empathy for those troubled by Stallman's discordant behavior.
+
+Stallman's Perl Conference outburst would momentarily chase off another potential sympathizer, Bruce Perens. In 1998, Eric Raymond proposed launching the Open Source Initiative, or OSI, an organization that would police the use of the term "open source" and provide a definition for companies interested in making their own programs. Raymond recruited Perens to draft the definition.~{ See Bruce Perens et al., "The Open Source Definition," The Open Source Initiative (1998).
+http://www.opensource.org/docs/definition.html }~
+
+Perens would later resign from the OSI, expressing regret that the organization had set itself up in opposition to Stallman and the FSF. Still, looking back on the need for a free software definition outside the Free Software Foundation's auspices, Perens understands why other hackers might still feel the need for distance. "I really like and admire Richard," says Perens. "I do think Richard would do his job better if Richard had more balance. That includes going away from free software for a couple of months."
+
+Stallman's monomaniacal energies would do little to counteract the public-relations momentum of open source proponents. In August of 1998, when chip-maker Intel purchased a stake in GNU/Linux vendor Red Hat, an accompanying New York Times article described the company as the product of a movement "known alternatively as free software and open source."~{ See Amy Harmon, "For Sale: Free Operating System," New York Times (September 28, 1998).<br> http://www.nytimes.com/library/tech/98/09/biztech/articles/28linux.html }~ Six months later, a John Markoff article on Apple Computer was proclaiming the company's adoption of the "open source" Apache server in the article headline.~{ See John Markoff, "Apple Adopts `Open Source' for its Server Computers," New York Times (March 17, 1999).<br> http://www.nytimes.com/library/tech/99/03/biztech/articles/17apple.html }~
+
+Such momentum would coincide with the growing momentum of companies that actively embraced the "open source" term. By August of 1999, Red Hat, a company that now eagerly billed itself as "open source," was selling shares on Nasdaq. In December, VA Linux-formerly VA Research-was floating its own IPO to historical effect. Opening at $30 per share, the company's stock price exploded past the $300 mark in initial trading only to settle back down to the $239 level. Shareholders lucky enough to get in at the bottom and stay until the end experienced a 698% increase in paper wealth, a Nasdaq record.
+
+Among those lucky shareholders was Eric Raymond, who, as a company board member since the Mozilla launch, had received 150,000 shares of VA Linux stock. Stunned by the realization that his essay contrasting the Stallman-Torvalds managerial styles had netted him $36 million in potential wealth, Raymond penned a follow-up essay. In it, Raymond mused on the relationship between the hacker ethic and monetary wealth:
+
+_1 Reporters often ask me these days if I think the open-source community will be corrupted by the influx of big money. I tell them what I believe, which is this: commercial demand for programmers has been so intense for so long that anyone who can be seriously distracted by money is already gone. Our community has been self-selected for caring about other things-accomplishment, pride, artistic passion, and each other.~{ See Eric Raymond, "Surprised by Wealth," Linux Today (December 10, 1999).<br> http://linuxtoday.com/news_story.php3?ltsn=1999-12-10-001-05-NW-LF }~
+
+Whether or not such comments allayed suspicions that Raymond and other open source proponents had simply been in it for the money, they drove home the open source community's ultimate message: all you needed to sell the free software concept is a friendly face and a sensible message. Instead of fighting the marketplace head-on as Stallman had done, Raymond, Torvalds, and other new leaders of the hacker community had adopted a more relaxed approach-ignoring the marketplace in some areas, leveraging it in others. Instead of playing the role of high-school outcasts, they had played the game of celebrity, magnifying their power in the process.
+
+"On his worst days Richard believes that Linus Torvalds and I conspired to hijack his revolution," Raymond says. "Richard's rejection of the term open source and his deliberate creation of an ideological fissure in my view comes from an odd mix of idealism and territoriality. There are people out there who think it's all Richard's personal ego. I don't believe that. It's more that he so personally associates himself with the free software idea that he sees any threat to that as a threat to himself."
+
+Ironically, the success of open source and open source advocates such as Raymond would not diminish Stallman's role as a leader. If anything, it gave Stallman new followers to convert. Still, the Raymond territoriality charge is a damning one. There are numerous instances of Stallman sticking to his guns more out of habit than out of principle: his initial dismissal of the Linux kernel, for example, and his current unwillingness as a political figure to venture outside the realm of software issues.
+
+Then again, as the recent debate over open source also shows, in instances when Stallman has stuck to his guns, he's usually found a way to gain ground because of it. "One of Stallman's primary character traits is the fact he doesn't budge," says Ian Murdock. "He'll wait up to a decade for people to come around to his point of view if that's what it takes."
+
+Murdock, for one, finds that unbudgeable nature both refreshing and valuable. Stallman may no longer be the solitary leader of the free software movement, but he is still the polestar of the free software community. "You always know that he's going to be consistent in his views," Murdock says. "Most people aren't like that. Whether you agree with him or not, you really have to respect that."
+
+1~ Chapter 12 - A Brief Journey Through Hacker Hell
+
+Richard Stallman stares, unblinking, through the windshield of a rental car, waiting for the light to change as we make our way through downtown Kihei.
+
+The two of us are headed to the nearby town of Pa'ia, where we are scheduled to meet up with some software programmers and their wives for dinner in about an hour or so.
+
+It's about two hours after Stallman's speech at the Maui High Performance Center, and Kihei, a town that seemed so inviting before the speech, now seems profoundly uncooperative. Like most beach cities, Kihei is a one-dimensional exercise in suburban sprawl. Driving down its main drag, with its endless succession of burger stands, realty agencies, and bikini shops, it's hard not to feel like a steel-coated morsel passing through the alimentary canal of a giant commercial tapeworm. The feeling is exacerbated by the lack of side roads. With nowhere to go but forward, traffic moves in spring-like lurches. 200 yards ahead, a light turns green. By the time we are moving, the light is yellow again.
+
+For Stallman, a lifetime resident of the east coast, the prospect of spending the better part of a sunny Hawaiian afternoon trapped in slow traffic is enough to trigger an embolism. Even worse is the knowledge that, with just a few quick right turns a quarter mile back, this whole situation easily could have been avoided. Unfortunately, we are at the mercy of the driver ahead of us, a programmer from the lab who knows the way and who has decided to take us to Pa'ia via the scenic route instead of via the nearby Pilani Highway.
+
+"This is terrible," says Stallman between frustrated sighs. "Why didn't we take the other route?"
+
+Again, the light a quarter mile ahead of us turns green. Again, we creep forward a few more car lengths. This process continues for another 10 minutes, until we finally reach a major crossroad promising access to the adjacent highway.
+
+The driver ahead of us ignores it and continues through the intersection.
+
+"Why isn't he turning?" moans Stallman, throwing up his hands in frustration. "Can you believe this?"
+
+I decide not to answer either. I find the fact that I am sitting in a car with Stallman in the driver seat, in Maui no less, unbelievable enough. Until two hours ago, I didn't even know Stallman knew how to drive. Now, listening to Yo-Yo Ma's cello playing the mournful bass notes of "Appalachian Journey" on the car stereo and watching the sunset pass by on our left, I do my best to fade into the upholstery.
+
+When the next opportunity to turn finally comes up, Stallman hits his right turn signal in an attempt to cue the driver ahead of us. No such luck. Once again, we creep slowly through the intersection, coming to a stop a good 200 yards before the next light. By now, Stallman is livid.
+
+"It's like he's deliberately ignoring us," he says, gesturing and pantomiming like an air craft carrier landing-signals officer in a futile attempt to catch our guide's eye. The guide appears unfazed, and for the next five minutes all we see is a small portion of his head in the rearview mirror.
+
+I look out Stallman's window. Nearby Kahoolawe and Lanai Islands provide an ideal frame for the setting sun. It's a breathtaking view, the kind that makes moments like this a bit more bearable if you're a Hawaiian native, I suppose. I try to direct Stallman's attention to it, but Stallman, by now obsessed by the inattentiveness of the driver ahead of us, blows me off.
+
+When the driver passes through another green light, completely ignoring a "Pilani Highway Next Right," I grit my teeth. I remember an early warning relayed to me by BSD programmer Keith Bostic. "Stallman does not suffer fools gladly," Bostic warned me. "If somebody says or does something stupid, he'll look them in the eye and say, `That's stupid.'"
+
+Looking at the oblivious driver ahead of us, I realize that it's the stupidity, not the inconvenience, that's killing Stallman right now.
+
+"It's as if he picked this route with absolutely no thought on how to get there efficiently," Stallman says.
+
+The word "efficiently" hangs in the air like a bad odor. Few things irritate the hacker mind more than inefficiency. It was the inefficiency of checking the Xerox laser printer two or three times a day that triggered Stallman's initial inquiry into the printer source code. It was the inefficiency of rewriting software tools hijacked by commercial software vendors that led Stallman to battle Symbolics and to launch the GNU Project. If, as Jean Paul Sartre once opined, hell is other people, hacker hell is duplicating other people's stupid mistakes, and it's no exaggeration to say that Stallman's entire life has been an attempt to save mankind from these fiery depths.
+
+This hell metaphor becomes all the more apparent as we take in the slowly passing scenery. With its multitude of shops, parking lots, and poorly timed street lights, Kihei seems less like a city and more like a poorly designed software program writ large. Instead of rerouting traffic and distributing vehicles through side streets and expressways, city planners have elected to run everything through a single main drag. From a hacker perspective, sitting in a car amidst all this mess is like listening to a CD rendition of nails on a chalkboard at full volume.
+
+"Imperfect systems infuriate hackers," observes Steven Levy, another warning I should have listened to before climbing into the car with Stallman. "This is one reason why hackers generally hate driving cars-the system of randomly programmed red lights and oddly laid out one-way streets causes delays which are so goddamn unnecessary [Levy's emphasis] that the impulse is to rearrange signs, open up traffic-light control boxes . . . redesign the entire system."~{ See Steven Levy, Hackers (Penguin USA [paperback], 1984): 40. }~
+
+More frustrating, however, is the duplicity of our trusted guide. Instead of searching out a clever shortcut-as any true hacker would do on instinct-the driver ahead of us has instead chosen to play along with the city planners' game. Like Virgil in Dante's Inferno, our guide is determined to give us the full guided tour of this hacker hell whether we want it or not.
+
+Before I can make this observation to Stallman, the driver finally hits his right turn signal. Stallman's hunched shoulders relax slightly, and for a moment the air of tension within the car dissipates. The tension comes back, however, as the driver in front of us slows down. "Construction Ahead" signs line both sides of the street, and even though the Pilani Highway lies less than a quarter mile off in the distance, the two-lane road between us and the highway is blocked by a dormant bulldozer and two large mounds of dirt.
+
+It takes Stallman a few seconds to register what's going on as our guide begins executing a clumsy five-point U-turn in front of us. When he catches a glimpse of the bulldozer and the "No Through Access" signs just beyond, Stallman finally boils over.
+
+"Why, why, why?" he whines, throwing his head back. "You should have known the road was blocked. You should have known this way wouldn't work. You did this deliberately."
+
+The driver finishes the turn and passes us on the way back toward the main drag. As he does so, he shakes his head and gives us an apologetic shrug. Coupled with a toothy grin, the driver's gesture reveals a touch of mainlander frustration but is tempered with a protective dose of islander fatalism. Coming through the sealed windows of our rental car, it spells out a succinct message: "Hey, it's Maui; what are you gonna do?"
+
+Stallman can take it no longer.
+
+"Don't you fucking smile!" he shouts, fogging up the glass as he does so. "It's your fucking fault. This all could have been so much easier if we had just done it my way."
+
+Stallman accents the words "my way" by gripping the steering wheel and pulling himself towards it twice. The image of Stallman's lurching frame is like that of a child throwing a temper tantrum in a car seat, an image further underlined by the tone of Stallman's voice. Halfway between anger and anguish, Stallman seems to be on the verge of tears.
+
+Fortunately, the tears do not arrive. Like a summer cloudburst, the tantrum ends almost as soon as it begins. After a few whiny gasps, Stallman shifts the car into reverse and begins executing his own U-turn. By the time we are back on the main drag, his face is as impassive as it was when we left the hotel 30 minutes earlier.
+
+It takes less than five minutes to reach the next cross-street. This one offers easy highway access, and within seconds, we are soon speeding off toward Pa'ia at a relaxing rate of speed. The sun that once loomed bright and yellow over Stallman's left shoulder is now burning a cool orange-red in our rearview mirror. It lends its color to the gauntlet wili wili trees flying past us on both sides of the highway.
+
+For the next 20 minutes, the only sound in our vehicle, aside from the ambient hum of the car's engine and tires, is the sound of a cello and a violin trio playing the mournful strains of an Appalachian folk tune.
+
+1~ Chapter 13 - Continuing the Fight
+
+For Richard Stallman, time may not heal all wounds, but it does provide a convenient ally.
+
+Four years after " The Cathedral and the Bazaar," Stallman still chafes over the Raymond critique. He also grumbles over Linus Torvalds' elevation to the role of world's most famous hacker. He recalls a popular T-shirt that began showing at Linux tradeshows around 1999. Designed to mimic the original promotional poster for Star Wars, the shirt depicted Torvalds brandishing a lightsaber like Luke Skywalker, while Stallman's face rides atop R2D2. The shirt still grates on Stallmans nerves not only because it depicts him as a Torvalds' sidekick, but also because it elevates Torvalds to the leadership role in the free software/open source community, a role even Torvalds himself is loath to accept. "It's ironic," says Stallman mournfully. "Picking up that sword is exactly what Linus refuses to do. He gets everybody focusing on him as the symbol of the movement, and then he won't fight. What good is it?"
+
+Then again, it is that same unwillingness to "pick up the sword," on Torvalds part, that has left the door open for Stallman to bolster his reputation as the hacker community's ethical arbiter. Despite his grievances, Stallman has to admit that the last few years have been quite good, both to himself and to his organization. Relegated to the periphery by the unforeseen success of GNU/Linux, Stallman has nonetheless successfully recaptured the initiative. His speaking schedule between January 2000 and December 2001 included stops on six continents and visits to countries where the notion of software freedom carries heavy overtones-China and India, for example.
+
+Outside the bully pulpit, Stallman has also learned how to leverage his power as costeward of the GNU General Public License (GPL). During the summer of 2000, while the air was rapidly leaking out of the 1999 Linux IPO bubble, Stallman and the Free Software Foundation scored two major victories. In July, 2000, Troll Tech, a Norwegian software company and developer of Qt, a valuable suite of graphics tools for the GNU/Linux operating system, announced it was licensing its software under the GPL. A few weeks later, Sun Microsystems, a company that, until then, had been warily trying to ride the open source bandwagon without giving up total control of its software properties, finally relented and announced that it, too, was dual licensing its new OpenOffice application suite under the Lesser GNU Public License (LGPL) and the Sun Industry Standards Source License (SISSL).
+
+Underlining each victory was the fact that Stallman had done little to fight for them. In the case of Troll Tech, Stallman had simply played the role of free software pontiff. In 1999, the company had come up with a license that met the conditions laid out by the Free Software Foundation, but in examining the license further, Stallman detected legal incompatibles that would make it impossible to bundle Qt with GPL-protected software programs. Tired of battling Stallman, Troll Tech management finally decided to split the Qt into two versions, one GPL-protected and one QPL-protected, giving developers a way around the compatibility issues cited by Stallman.
+
+In the case of Sun, they desired to play according to the Free Software Foundation's conditions. At the 1999 O'Reilly Open Source Conference, Sun Microsystems cofounder and chief scientist Bill Joy defended his company's "community source" license, essentially a watered-down compromise letting users copy and modify Sun-owned software but not charge a fee for said software without negotiating a royalty agreement with Sun. A year after Joy's speech, Sun Microsystems vice president Marco Boerries was appearing on the same stage spelling out the company's new licensing compromise in the case of OpenOffice, an office-application suite designed specifically for the GNU/Linux operating system.
+
+"I can spell it out in three letters," said Boerries. "GPL."
+
+At the time, Boerries said his company's decision had little to do with Stallman and more to do with the momentum of GPL-protected programs. "What basically happened was the recognition that different products attracted different communities, and the license you use depends on what type of community you want to attract," said Boerries. "With [OpenOffice], it was clear we had the highest correlation with the GPL community."~{ See Marco Boerries, interview with author (July, 2000). }~
+
+Such comments point out the under-recognized strength of the GPL and, indirectly, the political genius of man who played the largest role in creating it. "There isn't a lawyer on earth who would have drafted the GPL the way it is," says Eben Moglen, Columbia University law professor and Free Software Foundation general counsel. "But it works. And it works because of Richard's philosophy of design."
+
+A former professional programmer, Moglen traces his pro bono work with Stallman back to 1990 when Stallman requested Moglen's legal assistance on a private affair. Moglen, then working with encryption expert Phillip Zimmerman during Zimmerman's legal battles with the National Security Administration, says he was honored by the request. "I told him I used Emacs every day of my life, and it would take an awful lot of lawyering on my part to pay off the debt."
+
+Since then, Moglen, perhaps more than any other individual, has had the best chance to observe the crossover of Stallman's hacker philosophies into the legal realm. Moglen says the difference between Stallman's approach to legal code and software code are largely the same. "I have to say, as a lawyer, the idea that what you should do with a legal document is to take out all the bugs doesn't make much sense," Moglen says. "There is uncertainty in every legal process, and what most lawyers want to do is to capture the benefits of uncertainty for their client. Richard's goal is the complete opposite. His goal is to remove uncertainty, which is inherently impossible. It is inherently impossible to draft one license to control all circumstances in all legal systems all over the world. But if you were to go at it, you would have to go at it his way. And the resulting elegance, the resulting simplicity in design almost achieves what it has to achieve. And from there a little lawyering will carry you quite far."
+
+As the person charged with pushing the Stallman agenda, Moglen understands the frustration of would-be allies. "Richard is a man who does not want to compromise over matters that he thinks of as fundamental," Moglen says, "and he does not take easily the twisting of words or even just the seeking of artful ambiguity, which human society often requires from a lot of people."
+
+Because of the Free Software Foundation's unwillingness to weigh in on issues outside the purview of GNU development and GPL enforcement, Moglen has taken to devoting his excess energies to assisting the Electronic Frontier Foundation, the organization providing legal aid to recent copyright defendants such as Dmitri Skylarov. In 2000, Moglen also served as direct counsel to a collection of hackers that were joined together from circulating the DVD decryption program deCSS. Despite the silence of his main client in both cases, Moglen has learned to appreciate the value of Stallman's stubbornness. "There have been times over the years where I've gone to Richard and said, `We have to do this. We have to do that. Here's the strategic situation. Here's the next move. Here's what he have to do.' And Richard's response has always been, `We don't have to do anything.' Just wait. What needs doing will get done."
+
+"And you know what?" Moglen adds. "Generally, he's been right."
+
+Such comments disavow Stallman's own self-assessment: "I'm not good at playing games," Stallman says, addressing the many unseen critics who see him as a shrewd strategist. "I'm not good at looking ahead and anticipating what somebody else might do. My approach has always been to focus on the foundation, to say `Let's make the foundation as strong as we can make it.'"
+
+The GPL's expanding popularity and continuing gravitational strength are the best tributes to the foundation laid by Stallman and his GNU colleagues. While no longer capable of billing himself as the "last true hacker," Stallman nevertheless can take sole credit for building the free software movement's ethical framework. Whether or not other modern programmers feel comfortable working inside that framework is immaterial. The fact that they even have a choice at all is Stallman's greatest legacy.
+
+Discussing Stallman's legacy at this point seems a bit premature. Stallman, 48 at the time of this writing, still has a few years left to add to or subtract from that legacy. Still, the autopilot nature of the free software movement makes it tempting to examine Stallman's life outside the day-to-day battles of the software industry and within a more august, historical setting.
+
+To his credit, Stallman refuses all opportunities to speculate. "I've never been able to work out detailed plans of what the future was going to be like," says Stallman, offering his own premature epitaph. "I just said `I'm going to fight. Who knows where I'll get?'"
+
+There's no question that in picking his fights, Stallman has alienated the very people who might otherwise have been his greatest champions. It is also a testament to his forthright, ethical nature that many of Stallman's erstwhile political opponents still manage to put in a few good words for him when pressed. The tension between Stallman the ideologue and Stallman the hacker genius, however, leads a biographer to wonder: how will people view Stallman when Stallman's own personality is no longer there to get in the way?
+
+In early drafts of this book, I dubbed this question the "100 year" question. Hoping to stimulate an objective view of Stallman and his work, I asked various software-industry luminaries to take themselves out of the current timeframe and put themselves in a position of a historian looking back on the free software movement 100 years in the future. From the current vantage point, it is easy to see similarities between Stallman and past Americans who, while somewhat marginal during their lifetime, have attained heightened historical importance in relation to their age. Easy comparisons include Henry David Thoreau, transcendentalist philosopher and author of On Civil Disobedience, and John Muir, founder of the Sierra Club and progenitor of the modern environmental movement. It is also easy to see similarities in men like William Jennings Bryan, a.k.a. "The Great Commoner," leader of the populist movement, enemy of monopolies, and a man who, though powerful, seems to have faded into historical insignificance.
+
+Although not the first person to view software as public property, Stallman is guaranteed a footnote in future history books thanks to the GPL. Given that fact, it seems worthwhile to step back and examine Richard Stallman's legacy outside the current time frame. Will the GPL still be something software programmers use in the year 2102, or will it have long since fallen by the wayside? Will the term "free software" seem as politically quaint as "free silver" does today, or will it seem eerily prescient in light of later political events?
+
+Predicting the future is risky sport, but most people, when presented with the question, seemed eager to bite. "One hundred years from now, Richard and a couple of other people are going to deserve more than a footnote," says Moglen. "They're going to be viewed as the main line of the story."
+
+The "couple other people" Moglen nominates for future textbook chapters include John Gilmore, Stallman's GPL advisor and future founder of the Electronic Frontier Foundation, and Theodor Holm Nelson, a.k.a. Ted Nelson, author of the 1982 book, Literary Machines. Moglen says Stallman, Nelson, and Gilmore each stand out in historically significant, nonoverlapping ways. He credits Nelson, commonly considered to have coined the term "hypertext," for identifying the predicament of information ownership in the digital age. Gilmore and Stallman, meanwhile, earn notable credit for identifying the negative political effects of information control and building organizations-the Electronic Frontier Foundation in the case of Gilmore and the Free Software Foundation in the case of Stallman-to counteract those effects. Of the two, however, Moglen sees Stallman's activities as more personal and less political in nature.
+
+"Richard was unique in that the ethical implications of unfree software were particularly clear to him at an early moment," says Moglen. "This has a lot to do with Richard's personality, which lots of people will, when writing about him, try to depict as epiphenomenal or even a drawback in Richard Stallman's own life work."
+
+Gilmore, who describes his inclusion between the erratic Nelson and the irascible Stallman as something of a "mixed honor," nevertheless seconds the Moglen argument. Writes Gilmore:
+
+_1 My guess is that Stallman's writings will stand up as well as Thomas Jefferson's have; he's a pretty clear writer and also clear on his principles . . . Whether Richard will be as influential as Jefferson will depend on whether the abstractions we call "civil rights" end up more important a hundred years from now than the abstractions that we call "software" or "technically imposed restrictions."
+
+Another element of the Stallman legacy not to be overlooked, Gilmore writes, is the collaborative software-development model pioneered by the GNU Project. Although flawed at times, the model has nevertheless evolved into a standard within the software-development industry. All told, Gilmore says, this collaborative software-development model may end up being even more influential than the GNU Project, the GPL License, or any particular software program developed by Stallman:
+
+_1 Before the Internet, it was quite hard to collaborate over distance on software, even among teams that know and trust each other. Richard pioneered collaborative development of software, particularly by disorganized volunteers who seldom meet each other. Richard didn't build any of the basic tools for doing this (the TCP protocol, email lists, diff and patch, tar files, RCS or CVS or remote-CVS), but he used the ones that were available to form social groups of programmers who could effectively collaborate.
+
+Lawrence Lessig, Stanford law professor and author of the 2001 book, The Future of Ideas, is similarly bullish. Like many legal scholars, Lessig sees the GPL as a major bulwark of the current so-called "digital commons," the vast agglomeration of community-owned software programs, network and telecommunication standards that have triggered the Internet's exponential growth over the last three decades. Rather than connect Stallman with other Internet pioneers, men such as Vannevar Bush, Vinton Cerf, and J. C. R. Licklider who convinced others to see computer technology on a wider scale, Lessig sees Stallman's impact as more personal, introspective, and, ultimately, unique:
+
+_1 [Stallman] changed the debate from is to ought. He made people see how much was at stake, and he built a device to carry these ideals forward . . . That said, I don't quite know how to place him in the context of Cerf or Licklider. The innovation is different. It is not just about a certain kind of code, or enabling the Internet. [It's] much more about getting people to see the value in a certain kind of Internet. I don't think there is anyone else in that class, before or after.
+
+Not everybody sees the Stallman legacy as set in stone, of course. Eric Raymond, the open source proponent who feels that Stallman's leadership role has diminished significantly since 1996, sees mixed signals when looking into the 2102 crystal ball:
+
+_1 I think Stallman's artifacts (GPL, Emacs, GCC) will be seen as revolutionary works, as foundation-stones of the information world. I think history will be less kind to some of the theories from which RMS operated, and not kind at all to his personal tendency towards territorial, cult-leader behavior.
+
+As for Stallman himself, he, too, sees mixed signals:
+
+_1 What history says about the GNU Project, twenty years from now, will depend on who wins the battle of freedom to use public knowledge. If we lose, we will be just a footnote. If we win, it is uncertain whether people will know the role of the GNU operating system-if they think the system is "Linux," they will build a false picture of what happened and why.
+
+_1 But even if we win, what history people learn a hundred years from now is likely to depend on who dominates politically.
+
+Searching for his own 19th-century historical analogy, Stallman summons the figure of John Brown, the militant abolitionist regarded as a hero on one side of the Mason Dixon line and a madman on the other.
+
+John Brown's slave revolt never got going, but during his subsequent trial he effectively roused national demand for abolition. During the Civil War, John Brown was a hero; 100 years after, and for much of the 1900s, history textbooks taught that he was crazy. During the era of legal segregation, while bigotry was shameless, the US partly accepted the story that the South wanted to tell about itself, and history textbooks said many untrue things about the Civil War and related events.
+
+Such comparisons document both the self-perceived peripheral nature of Stallman's current work and the binary nature of his current reputation. Although it's hard to see Stallman's reputation falling to the level of infamy as Brown's did during the post-Reconstruction period-Stallman, despite his occasional war-like analogies, has done little to inspire violence-it's easy to envision a future in which Stallman's ideas wind up on the ash-heap. In fashioning the free software cause not as a mass movement but as a collection of private battles against the forces of proprietary temptation, Stallman seems to have created a unwinnable situation, especially for the many acolytes with the same stubborn will.
+
+Then again, it is that very will that may someday prove to be Stallman's greatest lasting legacy. Moglen, a close observer over the last decade, warns those who mistake the Stallman personality as counter-productive or epiphenomenal to the "artifacts" of Stallman's life. Without that personality, Moglen says, there would be precious few artifiacts to discuss. Says Moglen, a former Supreme Court clerk:
+
+_1 Look, the greatest man I ever worked for was Thurgood Marshall. I knew what made him a great man. I knew why he had been able to change the world in his possible way. I would be going out on a limb a little bit if I were to make a comparison, because they could not be more different. Thurgood Marshall was a man in society, representing an outcast society to the society that enclosed it, but still a man in society. His skill was social skills. But he was all of a piece, too. Different as they were in every other respect, that the person I most now compare him to in that sense, all of a piece, compact, made of the substance that makes stars, all the way through, is Stallman.
+
+In an effort to drive that image home, Moglen reflects on a shared moment in the spring of 2000. The success of the VA Linux IPO was still resonating in the business media, and a half dozen free software-related issues were swimming through the news. Surrounded by a swirling hurricane of issues and stories each begging for comment, Moglen recalls sitting down for lunch with Stallman and feeling like a castaway dropped into the eye of the storm. For the next hour, he says, the conversation calmly revolved around a single topic: strengthening the GPL.
+
+"We were sitting there talking about what we were going to do about some problems in Eastern Europe and what we were going to do when the problem of the ownership of content began to threaten free software," Moglen recalls. "As we were talking, I briefly thought about how we must have looked to people passing by. Here we are, these two little bearded anarchists, plotting and planning the next steps. And, of course, Richard is plucking the knots from his hair and dropping them in the soup and behaving in his usual way. Anybody listening in on our conversation would have thought we were crazy, but I knew: I knew the revolution's right here at this table. This is what's making it happen. And this man is the person making it happen."
+
+Moglen says that moment, more than any other, drove home the elemental simplicity of the Stallman style.
+
+"It was funny," recalls Moglen. "I said to him, `Richard, you know, you and I are the two guys who didn't make any money out of this revolution.' And then I paid for the lunch, because I knew he didn't have the money to pay for it .'"
+
+1~ Chapter 14 - Epilogue: Crushing Loneliness
+
+Writing the biography of a living person is a bit like producing a play. The drama in front of the curtain often pales in comparison to the drama backstage.
+
+In The Autobiography of Malcolm X, Alex Haley gives readers a rare glimpse of that backstage drama. Stepping out of the ghostwriter role, Haley delivers the book's epilogue in his own voice. The epilogue explains how a freelance reporter originally dismissed as a "tool" and "spy" by the Nation of Islam spokesperson managed to work through personal and political barriers to get Malcolm X's life story on paper.
+
+While I hesitate to compare this book with The Autobiography of Malcolm X, I do owe a debt of gratitude to Haley for his candid epilogue. Over the last 12 months, it has served as a sort of instruction manual on how to deal with a biographical subject who has built an entire career on being disagreeable. From the outset, I envisioned closing this biography with a similar epilogue, both as an homage to Haley and as a way to let readers know how this book came to be.
+
+The story behind this story starts in an Oakland apartment, winding its way through the various locales mentioned in the book-Silicon Valley, Maui, Boston, and Cambridge. Ultimately, however, it is a tale of two cities: New York, New York, the book-publishing capital of the world, and Sebastopol, California, the book-publishing capital of Sonoma County.
+
+The story starts in April, 2000. At the time, I was writing stories for the ill-fated BeOpen web site ( http://www.beopen.com/ ). One of my first assignments was a phone interview with Richard M. Stallman. The interview went well, so well that Slashdot ( http://www.slashdot.org/ ), the popular "news for nerds" site owned by VA Software, Inc. (formerly VA Linux Systems and before that, VA Research), gave it a link in its daily list of feature stories. Within hours, the web servers at BeOpen were heating up as readers clicked over to the site.
+
+For all intents and purposes, the story should have ended there. Three months after the interview, while attending the O'Reilly Open Source Conference in Monterey, California, I received the following email message from Tracy Pattison, foreign-rights manager at a large New York publishing house:
+
+poem{
+
+To: sam@BeOpen.com Subject:
+
+RMS InterviewDate: Mon, 10 Jul 2000 15:56:37 -0400Dear Mr. Williams,
+
+I read your interview with Richard Stallman on BeOpen with great
+interest. I've been intrigued by RMS and his work for some time now
+and was delighted to find your piece which I really think you did a
+great job of capturing some of the spirit of what Stallman is trying
+to do with GNU-Linux and the Free Software Foundation.
+
+What I'd love to do, however, is read more - and I don't think I'm
+alone. Do you think there is more information and/or sources out there
+to expand and update your interview and adapt it into more of a
+profile of Stallman? Perhaps including some more anecdotal information
+about his personality and background that might really interest and
+enlighten readers outside the more hardcore programming scene?
+
+}poem
+
+The email asked that I give Tracy a call to discuss the idea further. I did just that. Tracy told me her company was launching a new electronic book line, and it wanted stories that appealed to an early-adopter audience. The e-book format was 30,000 words, about 100 pages, and she had pitched her bosses on the idea of profiling a major figure in the hacker community. Her bosses liked the idea, and in the process of searching for interesting people to profile, she had come across my BeOpen interview with Stallman. Hence her email to me.
+
+That's when Tracy asked me: would I be willing to expand the interview into a full-length feature profile?
+
+My answer was instant: yes. Before accepting it, Tracy suggested I put together a story proposal she could show her superiors. Two days later, I sent her a polished proposal. A week later, Tracy sent me a follow up email. Her bosses had given it the green light.
+
+I have to admit, getting Stallman to participate in an e-book project was an afterthought on my part. As a reporter who covered the open source beat, I knew Stallman was a stickler. I'd already received a half dozen emails at that point upbraiding me for the use of "Linux" instead of "GNU/Linux."
+
+Then again, I also knew Stallman was looking for ways to get his message out to the general public. Perhaps if I presented the project to him that way, he would be more receptive. If not, I could always rely upon the copious amounts of documents, interviews, and recorded online conversations Stallman had left lying around the Internet and do an unauthorized biography.
+
+During my research, I came across an essay titled "Freedom-Or Copyright?" Written by Stallman and published in the June, 2000, edition of the MIT Technology Review, the essay blasted e-books for an assortment of software sins. Not only did readers have to use proprietary software programs to read them, Stallman lamented, but the methods used to prevent unauthorized copying were overly harsh. Instead of downloading a transferable HTML or PDF file, readers downloaded an encrypted file. In essence, purchasing an e-book meant purchasing a nontransferable key to unscramble the encrypted content. Any attempt to open a book's content without an authorized key constituted a criminal violation of the Digital Millennium Copyright Act, the 1998 law designed to bolster copyright enforcement on the Internet. Similar penalties held for readers who converted a book's content into an open file format, even if their only intention was to read the book on a different computer in their home. Unlike a normal book, the reader no longer held the right to lend, copy, or resell an e-book. They only had the right to read it on an authorized machine, warned Stallman:
+
+_1 We still have the same old freedoms in using paper books. But if e-books replace printed books, that exception will do little good. With "electronic ink," which makes it possible to download new text onto an apparently printed piece of paper, even newspapers could become ephemeral. Imagine: no more used book stores; no more lending a book to your friend; no more borrowing one from the public library-no more "leaks" that might give someone a chance to read without paying. (And judging from the ads for Microsoft Reader, no more anonymous purchasing of books either.) This is the world publishers have in mind for us.~{ See "Safari Tech Books Online; Subscriber Agreement: Terms of Service."<br> http://safari.oreilly.com/mainhlp.asp?help=service }~
+
+Needless to say, the essay caused some concern. Neither Tracy nor I had discussed the software her company would use nor had we discussed the type of copyright that would govern the e-book's usage. I mentioned the Technology Review article and asked if she could give me information on her company's e-book policies. Tracy promised to get back to me.
+
+Eager to get started, I decided to call Stallman anyway and mention the book idea to him. When I did, he expressed immediate interest and immediate concern. "Did you read my essay on e-books?" he asked.
+
+When I told him, yes, I had read the essay and was waiting to hear back from the publisher, Stallman laid out two conditions: he didn't want to lend support to an e-book licensing mechanism he fundamentally opposed, and he didn't want to come off as lending support. "I don't want to participate in anything that makes me look like a hypocrite," he said.
+
+For Stallman, the software issue was secondary to the copyright issue. He said he was willing to ignore whatever software the publisher or its third-party vendors employed just so long as the company specified within the copyright that readers were free to make and distribute verbatim copies of the e-book's content. Stallman pointed to Stephen King's The Plant as a possible model. In June, 2000, King announced on his official web site that he was self-publishing The Plant in serial form. According to the announcement, the book's total cost would be $13, spread out over a series of $1 installments. As long as at least 75% of the readers paid for each chapter, King promised to continue releasing new installments. By August, the plan seemed to be working, as King had published the first two chapters with a third on the way.
+
+"I'd be willing to accept something like that," Stallman said. "As long as it also permitted verbatim copying."
+
+I forwarded the information to Tracy. Feeling confident that she and I might be able to work out an equitable arrangement, I called up Stallman and set up the first interview for the book. Stallman agreed to the interview without making a second inquiry into the status issue. Shortly after the first interview, I raced to set up a second interview (this one in Kihei), squeezing it in before Stallman headed off on a 14-day vacation to Tahiti.
+
+It was during Stallman's vacation that the bad news came from Tracy. Her company's legal department didn't want to adjust its copyright notice on the e-books. Readers who wanted to make their books transferable would either have to crack the encryption code or convert the book to an open format such as HTML. Either way, the would be breaking the law and facing criminal penalties.
+
+With two fresh interviews under my belt, I didn't see any way to write the book without resorting to the new material. I quickly set up a trip to New York to meet with my agent and with Tracy to see if there was a compromise solution.
+
+When I flew to New York, I met my agent, Henning Guttman. It was our first face-to-face meeting, and Henning seemed pessimistic about our chances of forcing a compromise, at least on the publisher's end. The large, established publishing houses already viewed the e-book format with enough suspicion and weren't in the mood to experiment with copyright language that made it easier for readers to avoid payment. As an agent who specialized in technology books, however, Henning was intrigued by the novel nature of my predicament. I told him about the two interviews I'd already gathered and the promise not to publish the book in a way that made Stallman "look like a hypocrite." Agreeing that I was in an ethical bind, Henning suggested we make that our negotiating point.
+
+Barring that, Henning said, we could always take the carrot-and-stick approach. The carrot would be the publicity that came with publishing an e-book that honored the hacker community's internal ethics. The stick would be the risks associated with publishing an e-book that didn't. Nine months before Dmitri Skylarov became an Internet cause cÈlËbre, we knew it was only a matter of time before an enterprising programmer revealed how to hack e-books. We also knew that a major publishing house releasing an encryption-protected e-book on Richard M. Stallman was the software equivalent of putting "Steal This E-Book" on the cover.
+
+After my meeting with Henning, I put a call into Stallman. Hoping to make the carrot more enticing, I discussed a number of potential compromises. What if the publisher released the book's content under a split license, something similar to what Sun Microsystems had done with Open Office, the free software desktop applications suite? The publisher could then release commercial versions of the e-book under a normal format, taking advantage of all the bells and whistles that went with the e-book software, while releasing the copyable version under a less aesthetically pleasing HTML format.
+
+Stallman told me he didn't mind the split-license idea, but he did dislike the idea of making the freely copyable version inferior to the restricted version. Besides, he said, the idea was too cumbersome. Split licenses worked in the case of Sun's Open Office only because he had no control over the decision making. In this case, Stallman said, he did have a way to control the outcome. He could refuse to cooperate.
+
+I made a few more suggestions with little effect. About the only thing I could get out of Stallman was a concession that the e-book's copyright restrict all forms of file sharing to "noncommercial redistribution."
+
+Before I signed off, Stallman suggested I tell the publisher that I'd promised Stallman that the work would be free. I told Stallman I couldn't agree to that statement but that I did view the book as unfinishable without his cooperation. Seemingly satisfied, Stallman hung up with his usual sign-off line: "Happy hacking."
+
+Henning and I met with Tracy the next day. Tracy said her company was willing to publish copyable excerpts in a unencrypted format but would limit the excerpts to 500 words. Henning informed her that this wouldn't be enough for me to get around my ethical obligation to Stallman. Tracy mentioned her own company's contractual obligation to online vendors such as Amazon.com. Even if the company decided to open up its e-book content this one time, it faced the risk of its partners calling it a breach of contract. Barring a change of heart in the executive suite or on the part of Stallman, the decision was up to me. I could use the interviews and go against my earlier agreement with Stallman, or I could plead journalistic ethics and back out of the verbal agreement to do the book.
+
+Following the meeting, my agent and I relocated to a pub on Third Ave. I used his cell phone to call Stallman, leaving a message when nobody answered. Henning left for a moment, giving me time to collect my thoughts. When he returned, he was holding up the cell phone.
+
+"It's Stallman," Henning said.
+
+The conversation got off badly from the start. I relayed Tracy's comment about the publisher's contractual obligations.
+
+"So," Stallman said bluntly. "Why should I give a damn about their contractual obligations?"
+
+Because asking a major publishing house to risk a legal battle with its vendors over a 30,000 word e-book is a tall order, I suggested.
+
+"Don't you see?" Stallman said. "That's exactly why I'm doing this. I want a signal victory. I want them to make a choice between freedom and business as usual."
+
+As the words "signal victory" echoed in my head, I felt my attention wander momentarily to the passing foot traffic on the sidewalk. Coming into the bar, I had been pleased to notice that the location was less than half a block away from the street corner memorialized in the 1976 Ramones song, "53rd and 3rd," a song I always enjoyed playing in my days as a musician. Like the perpetually frustrated street hustler depicted in that song, I could feel things falling apart as quickly as they had come together. The irony was palpable. After weeks of gleefully recording other people's laments, I found myself in the position of trying to pull off the rarest of feats: a Richard Stallman compromise.
+
+When I continued hemming and hawing, pleading the publisher's position and revealing my growing sympathy for it, Stallman, like an animal smelling blood, attacked.
+
+"So that's it? You're just going to screw me? You're just going to bend to their will?"
+
+I brought up the issue of a dual-copyright again.
+
+"You mean license," Stallman said curtly.
+
+"Yeah, license. Copyright. Whatever," I said, feeling suddenly like a wounded tuna trailing a rich plume of plasma in the water.
+
+"Aw, why didn't you just fucking do what I told you to do!" he shouted.
+
+I must have been arguing on behalf of the publisher to the very end, because in my notes I managed to save a final Stallman chestnut: "I don't care. What they're doing is evil. I can't support evil. Good-bye."
+
+As soon as I put the phone down, my agent slid a freshly poured Guinness to me. "I figured you might need this," he said with a laugh. "I could see you shaking there towards the end."
+
+I was indeed shaking. The shaking wouldn't stop until the Guinness was more than halfway gone. It felt weird, hearing myself characterized as an emissary of "evil." It felt weirder still, knowing that three months before, I was sitting in an Oakland apartment trying to come up with my next story idea. Now, I was sitting in a part of the world I'd only known through rock songs, taking meetings with publishing executives and drinking beer with an agent I'd never even laid eyes on until the day before. It was all too surreal, like watching my life reflected back as a movie montage.
+
+About that time, my internal absurdity meter kicked in. The initial shaking gave way to convulsions of laughter. To my agent, I must have looked like a another fragile author undergoing an untimely emotional breakdown. To me, I was just starting to appreciate the cynical beauty of my situation. Deal or no deal, I already had the makings of a pretty good story. It was only a matter of finding a place to tell it. When my laughing convulsions finally subsided, I held up my drink in a toast.
+
+"Welcome to the front lines, my friend," I said, clinking pints with my agent. "Might as well enjoy it."
+
+If this story really were a play, here's where it would take a momentary, romantic interlude. Disheartened by the tense nature of our meeting, Tracy invited Henning and I to go out for drinks with her and some of her coworkers. We left the bar on Third Ave., headed down to the East Village, and caught up with Tracy and her friends.
+
+Once there, I spoke with Tracy, careful to avoid shop talk. Our conversation was pleasant, relaxed. Before parting, we agreed to meet the next night. Once again, the conversation was pleasant, so pleasant that the Stallman e-book became almost a distant memory.
+
+When I got back to Oakland, I called around to various journalist friends and acquaintances. I recounted my predicament. Most upbraided me for giving up too much ground to Stallman in the preinterview negotiation. A former j-school professor suggested I ignore Stallman's "hypocrite" comment and just write the story. Reporters who knew of Stallman's media-savviness expressed sympathy but uniformly offered the same response: it's your call.
+
+I decided to put the book on the back burner. Even with the interviews, I wasn't making much progress. Besides, it gave me a chance to speak with Tracy without running things past Henning first. By Christmas we had traded visits: she flying out to the west coast once, me flying out to New York a second time. The day before New Year's Eve, I proposed. Deciding which coast to live on, I picked New York. By February, I packed up my laptop computer and all my research notes related to the Stallman biography, and we winged our way to JFK Airport. Tracy and I were married on May 11. So much for failed book deals.
+
+During the summer, I began to contemplate turning my interview notes into a magazine article. Ethically, I felt in the clear doing so, since the original interview terms said nothing about traditional print media. To be honest, I also felt a bit more comfortable writing about Stallman after eight months of radio silence. Since our telephone conversation in September, I'd only received two emails from Stallman. Both chastised me for using "Linux" instead of "GNU/Linux" in a pair of articles for the web magazine Upside Today. Aside from that, I had enjoyed the silence. In June, about a week after the New York University speech, I took a crack at writing a 5,000-word magazine-length story about Stallman. This time, the words flowed. The distance had helped restore my lost sense of emotional perspective, I suppose.
+
+In July, a full year after the original email from Tracy, I got a call from Henning. He told me that O'Reilly & Associates, a publishing house out of Sebastopol, California, was interested in the running the Stallman story as a biography. The news pleased me. Of all the publishing houses in the world, O'Reilly, the same company that had published Eric Raymond's The Cathedral and the Bazaar, seemed the most sensitive to the issues that had killed the earlier e-book. As a reporter, I had relied heavily on the O'Reilly book Open Sources as a historical reference. I also knew that various chapters of the book, including a chapter written by Stallman, had been published with copyright notices that permitted redistribution. Such knowledge would come in handy if the issue of electronic publication ever came up again.
+
+Sure enough, the issue did come up. I learned through Henning that O'Reilly intended to publish the biography both as a book and as part of its new Safari Tech Books Online subscription service. The Safari user license would involve special restrictions,1 Henning warned, but O'Reilly was willing to allow for a copyright that permitted users to copy and share and the book's text regardless of medium. Basically, as author, I had the choice between two licenses: the Open Publication License or the GNU Free Documentation License.
+
+I checked out the contents and background of each license. The Open Publication License (OPL)~{ See "The Open Publication License: Draft v1.0" (June 8, 1999).<br> http://opencontent.org/openpub/ }~ gives readers the right to reproduce and distribute a work, in whole or in part, in any medium "physical or electronic," provided the copied work retains the Open Publication License. It also permits modification of a work, provided certain conditions are met. Finally, the Open Publication License includes a number of options, which, if selected by the author, can limit the creation of "substantively modified" versions or book-form derivatives without prior author approval.
+
+The GNU Free Documentation License (GFDL),~{ See "The GNU Free Documentation License: Version 1.1" (March, 2000).<br> http://www.gnu.org/copyleft/fdl.html }~ meanwhile, permits the copying and distribution of a document in any medium, provided the resulting work carries the same license. It also permits the modification of a document provided certain conditions. Unlike the OPL, however, it does not give authors the option to restrict certain modifications. It also does not give authors the right to reject modifications that might result in a competitive book product. It does require certain forms of front- and back-cover information if a party other than the copyright holder wishes to publish more than 100 copies of a protected work, however.
+
+In the course of researching the licenses, I also made sure to visit the GNU Project web page titled "Various Licenses and Comments About Them."~{ See http://www.gnu.org/philosophy/license-list.html }~ On that page, I found a Stallman critique of the Open Publication License. Stallman's critique related to the creation of modified works and the ability of an author to select either one of the OPL's options to restrict modification. If an author didn't want to select either option, it was better to use the GFDL instead, Stallman noted, since it minimized the risk of the nonselected options popping up in modified versions of a document.
+
+The importance of modification in both licenses was a reflection of their original purpose-namely, to give software-manual owners a chance to improve their manuals and publicize those improvements to the rest of the community. Since my book wasn't a manual, I had little concern about the modification clause in either license. My only concern was giving users the freedom to exchange copies of the book or make copies of the content, the same freedom they would have enjoyed if they purchased a hardcover book. Deeming either license suitable for this purpose, I signed the O'Reilly contract when it came to me.
+
+Still, the notion of unrestricted modification intrigued me. In my early negotiations with Tracy, I had pitched the merits of a GPL-style license for the e-book's content. At worst, I said, the license would guarantee a lot of positive publicity for the e-book. At best, it would encourage readers to participate in the book-writing process. As an author, I was willing to let other people amend my work just so long as my name always got top billing. Besides, it might even be interesting to watch the book evolve. I pictured later editions looking much like online versions of the Talmud, my original text in a central column surrounded by illuminating, third-party commentary in the margins.
+
+My idea drew inspiration from Project Xanadu ( http://www.xanadu.com/ ), the legendary software concept originally conceived by Ted Nelson in 1960. During the O'Reilly Open Source Conference in 1999, I had seen the first demonstration of the project's open source offshoot Udanax and had been wowed by the result. In one demonstration sequence, Udanax displayed a parent document and a derivative work in a similar two-column, plain-text format. With a click of the button, the program introduced lines linking each sentence in the parent to its conceptual offshoot in the derivative. An e-book biography of Richard M. Stallman didn't have to be Udanax-enabled, but given such technological possibilities, why not give users a chance to play around?~{ Anybody willing to "port" this book over to Udanax, the free software version of Xanadu, will receive enthusiastic support from me. To find out more about this intriguing technology, visit http://www.udanax.com/. }~
+
+When Laurie Petrycki, my editor at O'Reilly, gave me a choice between the OPL or the GFDL, I indulged the fantasy once again. By September of 2001, the month I signed the contract, e-books had become almost a dead topic. Many publishing houses, Tracy's included, were shutting down their e-book imprints for lack of interest. I had to wonder. If these companies had treated e-books not as a form of publication but as a form of community building, would those imprints have survived?
+
+After I signed the contract, I notified Stallman that the book project was back on. I mentioned the choice O'Reilly was giving me between the Open Publication License and the GNU Free Documentation License. I told him I was leaning toward the OPL, if only for the fact I saw no reason to give O'Reilly's competitors a chance to print the same book under a different cover. Stallman wrote back, arguing in favor of the GFDL, noting that O'Reilly had already used it several times in the past. Despite the events of the past year, I suggested a deal. I would choose the GFDL if it gave me the possibility to do more interviews and if Stallman agreed to help O'Reilly publicize the book. Stallman agreed to participate in more interviews but said that his participation in publicity-related events would depend on the content of the book. Viewing this as only fair, I set up an interview for December 17, 2001 in Cambridge.
+
+I set up the interview to coincide with a business trip my wife Tracy was taking to Boston. Two days before leaving, Tracy suggested I invite Stallman out to dinner.
+
+"After all," she said, "he is the one who brought us together."
+
+I sent an email to Stallman, who promptly sent a return email accepting the offer. When I drove up to Boston the next day, I met Tracy at her hotel and hopped the T to head over to MIT. When we got to Tech Square, I found Stallman in the middle of a conversation just as we knocked on the door.
+
+"I hope you don't mind," he said, pulling the door open far enough so that Tracy and I could just barely hear Stallman's conversational counterpart. It was a youngish woman, mid-20s I'd say, named Sarah.
+
+"I took the liberty of inviting somebody else to have dinner with us," Stallman said, matter-of-factly, giving me the same cat-like smile he gave me back in that Palo Alto restaurant.
+
+To be honest, I wasn't too surprised. The news that Stallman had a new female friend had reached me a few weeks before, courtesy of Stallman's mother. "In fact, they both went to Japan last month when Richard went over to accept the Takeda Award," Lippman told me at the time.~{ Alas, I didn't find out about the Takeda Foundation's decision to award Stallman, along with Linus Torvalds and Ken Sakamura, with its first-ever award for "Techno-Entrepreneurial Achievement for Social/Economic Well-Being" until after Stallman had made the trip to Japan to accept the award. For more information about the award and its accompanying $1 million prize, visit the Takeda site, http://www.takeda-foundation.jp/ }~
+
+On the way over to the restaurant, I learned the circumstances of Sarah and Richard's first meeting. Interestingly, the circumstances were very familiar. Working on her own fictional book, Sarah said she heard about Stallman and what an interesting character he was. She promptly decided to create a character in her book on Stallman and, in the interests of researching the character, set up an interview with Stallman. Things quickly went from there. The two had been dating since the beginning of 2001, she said.
+
+"I really admired the way Richard built up an entire political movement to address an issue of profound personal concern," Sarah said, explaining her attraction to Stallman.
+
+My wife immediately threw back the question: "What was the issue?"
+
+"Crushing loneliness."
+
+During dinner, I let the women do the talking and spent most of the time trying to detect clues as to whether the last 12 months had softened Stallman in any significant way. I didn't see anything to suggest they had. Although more flirtatious than I remembered-a flirtatiousness spoiled somewhat by the number of times Stallman's eyes seemed to fixate on my wife's chest-Stallman retained the same general level of prickliness. At one point, my wife uttered an emphatic "God forbid" only to receive a typical Stallman rebuke.
+
+"I hate to break it to you, but there is no God," Stallman said.
+
+Afterwards, when the dinner was complete and Sarah had departed, Stallman seemed to let his guard down a little. As we walked to a nearby bookstore, he admitted that the last 12 months had dramatically changed his outlook on life. "I thought I was going to be alone forever," he said. "I'm glad I was wrong."
+
+Before parting, Stallman handed me his "pleasure card," a business card listing Stallman's address, phone number, and favorite pastimes ("sharing good books, good food and exotic music and dance") so that I might set up a final interview.
+
+{free_as_in_freedom_04_rms_pleasure_card.png 355x207 "Stallman's 'pleasure' card, handed to me the night of our dinner." }http://www.free-culture.cc/
+
+The next day, over another meal of dim sum, Stallman seemed even more lovestruck than the night before. Recalling his debates with Currier House dorm maters over the benefits and drawbacks of an immortality serum, Stallman expressed hope that scientists might some day come up with the key to immortality. "Now that I'm finally starting to have happiness in my life, I want to have more," he said.
+
+When I mentioned Sarah's "crushing loneliness" comment, Stallman failed to see a connection between loneliness on a physical or spiritual level and loneliness on a hacker level. "The impulse to share code is about friendship but friendship at a much lower level," he said. Later, however, when the subject came up again, Stallman did admit that loneliness, or the fear of perpetual loneliness, had played a major role in fueling his determination during the earliest days of the GNU Project.
+
+"My fascination with computers was not a consequence of anything else," he said. "I wouldn't have been less fascinated with computers if I had been popular and all the women flocked to me. However, it's certainly true the experience of feeling I didn't have a home, finding one and losing it, finding another and having it destroyed, affected me deeply. The one I lost was the dorm. The one that was destroyed was the AI Lab. The precariousness of not having any kind of home or community was very powerful. It made me want to fight to get it back."
+
+After the interview, I couldn't help but feel a certain sense of emotional symmetry. Hearing Sarah describe what attracted her to Stallman and hearing Stallman himself describe the emotions that prompted him to take up the free software cause, I was reminded of my own reasons for writing this book. Since July, 2000, I have learned to appreciate both the seductive and the repellent sides of the Richard Stallman persona. Like Eben Moglen before me, I feel that dismissing that persona as epiphenomenal or distracting in relation to the overall free software movement would be a grievous mistake. In many ways the two are so mutually defining as to be indistinguishable.
+
+While I'm sure not every reader feels the same level of affinity for Stallman-indeed, after reading this book, some might feel zero affinity-I'm sure most will agree. Few individuals offer as singular a human portrait as Richard M. Stallman. It is my sincere hope that, with this initial portrait complete and with the help of the GFDL, others will feel a similar urge to add their own perspective to that portrait.
+
+1~appendix_a Appendix A - Terminology
+
+For the most part, I have chosen to use the term GNU/Linux in reference to the free software operating system and Linux when referring specifically to the kernel that drives the operating system. The most notable exception to this rule comes in Chapter 9. In the final part of that chapter, I describe the early evolution of Linux as an offshoot of Minix. It is safe to say that during the first two years of the project's development, the operating system Torvalds and his colleagues were working on bore little similarity to the GNU system envisioned by Stallman, even though it gradually began to share key components, such as the GNU C Compiler and the GNU Debugger.
+
+This decision further benefits from the fact that, prior to 1993, Stallman saw little need to insist on credit.
+
+Some might view the decision to use GNU/Linux for later versions of the same operating system as arbitrary. I would like to point out that it was in no way a prerequisite for gaining Stallman's cooperation in the making of this book. I came to it of my own accord, partly because of the operating system's modular nature and the community surrounding it, and partly because of the apolitical nature of the Linux name. Given that this is a biography of Richard Stallman, it seemed inappropriate to define the operating system in apolitical terms.
+
+In the final phases of the book, when it became clear that O'Reilly & Associates would be the book's publisher, Stallman did make it a condition that I use "GNU/Linux" instead of Linux if O'Reilly expected him to provide promotional support for the book after publication. When informed of this, I relayed my earlier decision and left it up to Stallman to judge whether the resulting book met this condition or not. At the time of this writing, I have no idea what Stallman's judgment will be.
+
+A similar situation surrounds the terms "free software" and "open source." Again, I have opted for the more politically laden "free software" term when describing software programs that come with freely copyable and freely modifiable source code. Although more popular, I have chosen to use the term "open source" only when referring to groups and businesses that have championed its usage. But for a few instances, the terms are completely interchangeable, and in making this decision I have followed the advice of Christine Peterson, the person generally credited with coining the term. "The `free software' term should still be used in circumstances where it works better," Peterson writes. "[`Open source'] caught on mainly because a new term was greatly needed, not because it's ideal."
+
+1~appendix_b Appendix B - Hack, Hackers, and Hacking
+
+To understand the full meaning of the word " hacker," it helps to examine the word's etymology over the years.
+
+The New Hacker Dictionary, an online compendium of software-programmer jargon, officially lists nine different connotations of the word "hack" and a similar number for "hacker." Then again, the same publication also includes an accompanying essay that quotes Phil Agre, an MIT hacker who warns readers not to be fooled by the word's perceived flexibility. "Hack has only one meaning," argues Agre. "An extremely subtle and profound one which defies articulation."
+
+Regardless of the width or narrowness of the definition, most modern hackers trace the word back to MIT, where the term bubbled up as popular item of student jargon in the early 1950s. In 1990 the MIT Museum put together a journal documenting the hacking phenomenon. According to the journal, students who attended the institute during the fifties used the word "hack" the way a modern student might use the word "goof." Hanging a jalopy out a dormitory window was a "hack," but anything harsh or malicious-e.g., egging a rival dorm's windows or defacing a campus statue-fell outside the bounds. Implicit within the definition of "hack" was a spirit of harmless, creative fun.
+
+This spirit would inspire the word's gerund form: "hacking." A 1950s student who spent the better part of the afternoon talking on the phone or dismantling a radio might describe the activity as "hacking." Again, a modern speaker would substitute the verb form of "goof"-"goofing" or "goofing off"-to describe the same activity.
+
+As the 1950s progressed, the word "hack" acquired a sharper, more rebellious edge. The MIT of the 1950s was overly competitive, and hacking emerged as both a reaction to and extension of that competitive culture. Goofs and pranks suddenly became a way to blow off steam, thumb one's nose at campus administration, and indulge creative thinking and behavior stifled by the Institute's rigorous undergraduate curriculum. With its myriad hallways and underground steam tunnels, the Institute offered plenty of exploration opportunities for the student undaunted by locked doors and "No Trespassing" signs. Students began to refer to their off-limits explorations as "tunnel hacking." Above ground, the campus phone system offered similar opportunities. Through casual experimentation and due diligence, students learned how to perform humorous tricks. Drawing inspiration from the more traditional pursuit of tunnel hacking, students quickly dubbed this new activity "phone hacking."
+
+The combined emphasis on creative play and restriction-free exploration would serve as the basis for the future mutations of the hacking term. The first self-described computer hackers of the 1960s MIT campus originated from a late 1950s student group called the Tech Model Railroad Club. A tight clique within the club was the Signals and Power (S&P) Committee-the group behind the railroad club's electrical circuitry system. The system was a sophisticated assortment of relays and switches similar to the kind that controlled the local campus phone system. To control it, a member of the group simply dialed in commands via a connected phone and watched the trains do his bidding.
+
+The nascent electrical engineers responsible for building and maintaining this system saw their activity as similar in spirit to phone hacking. Adopting the hacking term, they began refining it even further. From the S&P hacker point of view, using one less relay to operate a particular stretch of track meant having one more relay for future play. Hacking subtly shifted from a synonym for idle play to a synonym for idle play that improved the overall performance or efficiency of the club's railroad system at the same time. Soon S&P committee members proudly referred to the entire activity of improving and reshaping the track's underlying circuitry as "hacking" and to the people who did it as "hackers."
+
+Given their affinity for sophisticated electronics-not to mention the traditional MIT-student disregard for closed doors and "No Trespassing" signs-it didn't take long before the hackers caught wind of a new machine on campus. Dubbed the TX-0, the machine was one of the first commercially marketed computers. By the end of the 1950s, the entire S&P clique had migrated en masse over to the TX-0 control room, bringing the spirit of creative play with them. The wide-open realm of computer programming would encourage yet another mutation in etymology. "To hack" no longer meant soldering unusual looking circuits, but cobbling together software programs with little regard to "official" methods or software-writing procedures. It also meant improving the efficiency and speed of already-existing programs that tended to hog up machine resources. True to the word's roots, it also meant writing programs that served no other purpose than to amuse or entertain.
+
+A classic example of this expanded hacking definition is the game Spacewar, the first interactive video game. Developed by MIT hackers in the early 1960s, Spacewar had all the traditional hacking definitions: it was goofy and random, serving little useful purpose other than providing a nightly distraction for the dozen or so hackers who delighted in playing it. From a software perspective, however, it was a monumental testament to innovation of programming skill. It was also completely free. Because hackers had built it for fun, they saw no reason to guard their creation, sharing it extensively with other programmers. By the end of the 1960s, Spacewar had become a favorite diversion for mainframe programmers around the world.
+
+This notion of collective innovation and communal software ownership distanced the act of computer hacking in the 1960s from the tunnel hacking and phone hacking of the 1950s. The latter pursuits tended to be solo or small-group activities. Tunnel and phone hackers relied heavily on campus lore, but the off-limits nature of their activity discouraged the open circulation of new discoveries. Computer hackers, on the other hand, did their work amid a scientific field biased toward collaboration and the rewarding of innovation. Hackers and "official" computer scientists weren't always the best of allies, but in the rapid evolution of the field, the two species of computer programmer evolved a cooperative-some might say symbiotic-relationship.
+
+It is a testament to the original computer hackers' prodigious skill that later programmers, including Richard M. Stallman, aspired to wear the same hacker mantle. By the mid to late 1970s, the term "hacker" had acquired elite connotations. In a general sense, a computer hacker was any person who wrote software code for the sake of writing software code. In the particular sense, however, it was a testament to programming skill. Like the term "artist," the meaning carried tribal overtones. To describe a fellow programmer as hacker was a sign of respect. To describe oneself as a hacker was a sign of immense personal confidence. Either way, the original looseness of the computer-hacker appellation diminished as computers became more common.
+
+As the definition tightened, "computer" hacking acquired additional semantic overtones. To be a hacker, a person had to do more than write interesting software; a person had to belong to the hacker "culture" and honor its traditions the same way a medieval wine maker might pledge membership to a vintners' guild. The social structure wasn't as rigidly outlined as that of a guild, but hackers at elite institutions such as MIT, Stanford, and Carnegie Mellon began to speak openly of a "hacker ethic": the yet-unwritten rules that governed a hacker's day-to-day behavior. In the 1984 book Hackers, author Steven Levy, after much research and consultation, codified the hacker ethic as five core hacker tenets.
+
+In many ways, the core tenets listed by Levy continue to define the culture of computer hacking. Still, the guild-like image of the hacker community was undermined by the overwhelmingly populist bias of the software industry. By the early 1980s, computers were popping up everywhere, and programmers who once would have had to travel to top-rank institutions or businesses just to gain access to a machine suddenly had the ability to rub elbows with major-league hackers via the ARPAnet. The more these programmers rubbed elbows, the more they began to appropriate the anarchic philosophies of the hacker culture in places like MIT. Lost within the cultural transfer, however, was the native MIT cultural taboo against malicious behavior. As younger programmers began employing their computer skills to harmful ends-creating and disseminating computer viruses, breaking into military computer systems, deliberately causing machines such as MIT Oz, a popular ARPAnet gateway, to crash-the term "hacker" acquired a punk, nihilistic edge. When police and businesses began tracing computer-related crimes back to a few renegade programmers who cited convenient portions of the hacking ethic in defense of their activities, the word "hacker" began appearing in newspapers and magazine stories in a negative light. Although books like Hackers did much to document the original spirit of exploration that gave rise to the hacking culture, for most news reporters, "computer hacker" became a synonym for "electronic burglar."
+
+Although hackers have railed against this perceived misusage for nearly two decades, the term's rebellious connotations dating back to the 1950s make it hard to discern the 15-year-old writing software programs that circumvent modern encryption programs from the 1960s college student, picking locks and battering down doors to gain access to the lone, office computer terminal. One person's creative subversion of authority is another person's security headache, after all. Even so, the central taboo against malicious or deliberately harmful behavior remains strong enough that most hackers prefer to use the term " cracker"-i.e., a person who deliberately cracks a computer security system to steal or vandalize data-to describe the subset of hackers who apply their computing skills maliciously.
+
+This central taboo against maliciousness remains the primary cultural link between the notion of hacking in the early 21st century and hacking in the 1950s. It is important to note that, as the idea of computer hacking has evolved over the last four decades, the original notion of hacking-i.e., performing pranks or exploring underground tunnels-remains intact. In the fall of 2000, the MIT Museum paid tradition to the Institute's age-old hacking tradition with a dedicated exhibit, the Hall of Hacks. The exhibit includes a number of photographs dating back to the 1920s, including one involving a mock police cruiser. In 1993, students paid homage to the original MIT notion of hacking by placing the same police cruiser, lights flashing, atop the Institute's main dome. The cruiser's vanity license plate read IHTFP, a popular MIT acronym with many meanings. The most noteworthy version, itself dating back to the pressure-filled world of MIT student life in the 1950s, is "I hate this fucking place." In 1990, however, the Museum used the acronym as a basis for a journal on the history of hacks. Titled, The Institute for Hacks Tomfoolery and Pranks, the journal offers an adept summary of the hacking.
+
+"In the culture of hacking, an elegant, simple creation is as highly valued as it is in pure science," writes Boston Globe reporter Randolph Ryan in a 1993 article attached to the police car exhibit. "A Hack differs from the ordinary college prank in that the event usually requires careful planning, engineering and finesse, and has an underlying wit and inventiveness," Ryan writes. "The unwritten rule holds that a hack should be good-natured, non-destructive and safe. In fact, hackers sometimes assist in dismantling their own handiwork."
+
+The urge to confine the culture of computer hacking within the same ethical boundaries is well-meaning but impossible. Although most software hacks aspire to the same spirit of elegance and simplicity, the software medium offers less chance for reversibility. Dismantling a police cruiser is easy compared with dismantling an idea, especially an idea whose time has come. Hence the growing distinction between "black hat" and "white hat"-i.e., hackers who turn new ideas toward destructive, malicious ends versus hackers who turn new ideas toward positive or, at the very least, informative ends.
+
+Once a vague item of obscure student jargon, the word "hacker" has become a linguistic billiard ball, subject to political spin and ethical nuances. Perhaps this is why so many hackers and journalists enjoy using it. Where that ball bounces next, however, is anybody's guess.
+
+1~appendix_c Appendix C - GNU Free Documentation License (GFDL)
+
+GNU Free Documentation License Version 1.1, March 2000 Copyright (C) 2000 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,~{ FSF address changed from: 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA }~ USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+!_ PREAMBLE
+
+The purpose of this License is to make a manual, textbook, or other written document "free" in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.
+
+This License is a kind of "copyleft," which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
+
+We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.
+
+!_ APPLICABILITY AND DEFINITIONS
+
+This License applies to any manual or other work that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. The "Document", below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as "you."
+
+A "Modified Version" of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
+
+A "Secondary Section" is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (For example, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.) The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
+
+The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License.
+
+The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License.
+
+A "Transparent" copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, whose contents can be viewed and edited directly and straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup has been designed to thwart or discourage subsequent modification by readers is not Transparent. A copy that is not "Transparent" is called "Opaque."
+
+Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML designed for human modification. Opaque formats include PostScript, PDF, proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML produced by some word processors for output purposes only.
+
+The "Title Page" means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, "Title Page" means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
+
+!_ VERBATIM COPYING
+
+You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3.
+
+You may also lend copies, under the same conditions stated above, and you may publicly display copies.
+
+!_ COPYING IN QUANTITY
+
+If you publish printed copies of the Document numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects.
+
+If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.
+
+If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a publicly-accessible computer-network location containing a complete Transparent copy of the Document, free of added material, which the general network-using public has access to download anonymously at no charge using public-standard network protocols. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
+
+It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
+
+!_ MODIFICATIONS
+
+You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
+
+_1 1. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
+
+_1 2. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has less than five).
+
+_1 3. State on the Title page the name of the publisher of the Modified Version, as the publisher.
+
+_1 4. Preserve all the copyright notices of the Document.
+
+_1 5. Add an appropriate copyright notice for your modifications adjacent to the other copyright notices.
+
+_1 6. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
+
+_1 7. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice.
+
+_1 8. Include an unaltered copy of this License.
+
+_1 9. Preserve the section entitled "History," and its title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section entitled "History" in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
+
+_1 10. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the "History" section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
+
+_1 11. In any section entitled "Acknowledgements" or "Dedications," preserve the section's title, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
+
+_1 12. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
+
+_1 13. Delete any section entitled "Endorsements." Such a section may not be included in the Modified Version.
+
+_1 14. Do not retitle any existing section as "Endorsements" or to conflict in title with any Invariant Section.
+
+If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.
+
+You may add a section entitled "Endorsements," provided it contains nothing but endorsements of your Modified Version by various parties-for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
+
+You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
+
+The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version.
+
+!_ COMBINING DOCUMENTS
+
+You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice.
+
+The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
+
+In the combination, you must combine any sections entitled "History" in the various original documents, forming one section entitled "History"; likewise combine any sections entitled "Acknowledgements," and any sections entitled "Dedications." You must delete all sections entitled "Endorsements."
+
+!_ COLLECTIONS OF DOCUMENTS
+
+You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
+
+You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.
+
+!_ AGGREGATION WITH INDEPENDENT WORKS
+
+A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, does not as a whole count as a Modified Version of the Document, provided no compilation copyright is claimed for the compilation. Such a compilation is called an "aggregate," and this License does not apply to the other self-contained works thus compiled with the Document, on account of their being thus compiled, if they are not themselves derivative works of the Document.
+
+If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one quarter of the entire aggregate, the Document's Cover Texts may be placed on covers that surround only the Document within the aggregate. Otherwise they must appear on covers around the whole aggregate.
+
+!_ TRANSLATION
+
+Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License provided that you also include the original English version of this License. In case of a disagreement between the translation and the original English version of this License, the original English version will prevail.
+
+!_ TERMINATION
+
+You may not copy, modify, sublicense, or distribute the Document except as expressly provided for under this License. Any other attempt to copy, modify, sublicense or distribute the Document is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
+
+!_ FUTURE REVISIONS OF THIS LICENSE
+
+The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/
+
+Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License "or any later version" applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation.
+
+!_ ADDENDUM: How to Use This License for Your Documents
+
+To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:
+
+_1 Copyright (C) YEAR YOUR NAME.Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. A copy of the license is included in the section entitled "GNU Free Documentation License".
+
+If you have no Invariant Sections, write "with no Invariant Sections" instead of saying which ones are invariant. If you have no Front-Cover Texts, write "no Front-Cover Texts" instead of "Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
+
+If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software.
+
+%% SiSU markup sample Notes:
+% SiSU http://www.jus.uio.no/sisu
+% SiSU markup for 0.16 and later:
+%   0.20.4 header 0~links
+%   0.22 may drop image dimensions (rmagick)
+%   0.23 utf-8 ß
+%   0.38 or later, may use alternative notation for headers, e.g. @title: (instead of 0~title)
+%   0.38 document structure alternative markup, experimental (rad) A,B,C,1,2,3 maps to 1,2,3,4,5,6
+% Output: http://www.jus.uio.no/sisu/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams/sisu_manifest.html
+% SiSU 0.38 experimental (alternative structure) markup used for this document
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst b/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst
new file mode 100644
index 00000000..1b161087
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst
@@ -0,0 +1,161 @@
+% SiSU 0.38
+
+@title: GNU GENERAL PUBLIC LICENSE
+
+@author: Free Software Foundation
+
+@rights: Copyright Copyright 1989, 1991 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+@links: {Free Software Foundation}http://www.fsf.org
+{GPL @ SiSU}http://www.jus.uio.no/sisu/gpl2.fsf
+{Markup}http://www.jus.uio.no/sisu/sample/markup/gpl2.fsf.sst
+{Syntax}http://www.jus.uio.no/sisu/sample/syntax/gpl2.fsf.sst.html
+{ Free as In Freedom - Richard Stallman's Crusade for Free Software }http://www.jus.uio.no/sisu/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams
+
+@skin: skin_gnu
+
+% @promo: sisu_icon, fsf, open_society, sisu
+
+:A~ GNU GENERAL PUBLIC LICENSE
+
+:B~ Version 2, June 1991
+
+1~ [note] -#
+
+Copyright (C) 1989, 1991 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+1~ Preamble
+
+The licenses for most software are designed to take away your freedom to share
+and change it. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the GNU Library General Public License instead.) You can apply it to your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things.
+
+To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
+
+We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software.
+
+Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations.
+
+Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all.
+
+The precise terms and conditions for copying, distribution and modification follow.
+
+:C~ GNU GENERAL PUBLIC LICENSE
+
+1~ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term "modification".) Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does.
+
+1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee.
+
+2. You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:
+
+a) You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change.
+
+b) You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License.
+
+c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License.
+
+3. You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following:
+
+a) Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
+
+b) Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
+
+c) Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable.
+
+If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code.
+
+4. You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
+
+5. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it.
+
+6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License.
+
+7. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice.
+
+This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.
+
+8. If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License.
+
+9. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation.
+
+10. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.
+
+2~ NO WARRANTY
+
+11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+:C~ END OF TERMS AND CONDITIONS
+
+1~ How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found.
+
+&lt;one line to give the program's name and a brief idea of what it does.&gt;
+
+Copyright (C) &lt;year &gt; &lt;name of author&gt;
+
+This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA~{ FSF address changed from: 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA }~
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this when it starts in an interactive mode:
+
+Gnomovision version 69, Copyright (C) year name of author
+
+Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type 'show w'. This is free software, and you are welcome to redistribute it under certain conditions; type 'show c' for details.
+
+The hypothetical commands 'show w' and 'show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than 'show w' and 'show c'; they could even be mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names:
+
+Yoyodyne, Inc., hereby disclaims all copyright interest in the program 'Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+&lt;signature of Ty Coon&gt;, 1 April 1989
+
+Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License.
+
+%% SiSU markup sample Notes:
+% SiSU http://www.jus.uio.no/sisu
+% SiSU markup for 0.16 and later:
+%   0.20.4 header 0~links
+%   0.22 may drop image dimensions (rmagick)
+%   0.23 utf-8 ß
+%   0.38 or later, may use alternative notation for headers, e.g. @title: (instead of 0~title)
+%   0.38 document structure alternative markup, experimental (rad) A,B,C,1,2,3 maps to 1,2,3,4,5,6
+% Output: http://www.jus.uio.no/sisu/gpl2.fsf/sisu_manifest.html
+% SiSU 0.38 experimental (alternative structure) markup used for this document
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/gpl3_draft3.fsf.sst b/data/doc/sisu/sisu_markup_samples/dfsg/gpl3_draft3.fsf.sst
new file mode 100644
index 00000000..160a6058
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/gpl3_draft3.fsf.sst
@@ -0,0 +1,293 @@
+SiSU 0.52
+
+@title: GNU GENERAL PUBLIC LICENSE
+
+@author: Free Software Foundation
+
+@rights: THIS IS A DRAFT, NOT A PUBLISHED VERSION OF THE GNU GENERAL PUBLIC LICENSE.<br>Copyright (C) 2007 Free Software Foundation, Inc. (http://fsf.org) 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA<br>Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+% @rights: THIS IS A DRAFT, NOT A PUBLISHED VERSION OF THE GNU GENERAL PUBLIC LICENSE.<br>Copyright (C) 2007 Free Software Foundation, Inc. (http://fsf.org) 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA<br>Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+@links: {Free Software Foundation}http://www.fsf.org
+{GPL @ SiSU}http://www.jus.uio.no/sisu/gpl2.fsf
+{Markup}http://www.jus.uio.no/sisu/sample/markup/gpl2.fsf.sst
+{Syntax}http://www.jus.uio.no/sisu/sample/syntax/gpl2.fsf.sst.html
+{ Free as In Freedom - Richard Stallman's Crusade for Free Software }http://www.jus.uio.no/sisu/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams
+
+@skin: skin_gnu
+
+% @promo: sisu_icon, fsf, open_society, sisu
+
+:A~ GPLv3 - Third discussion draft
+
+% by brett — last modified 2007-03-28 09:51
+
+:B~ GNU GENERAL PUBLIC LICENSE
+
+:C~ Discussion Draft 3 of Version 3, 28 March 2007
+
+1~ [note] -#
+
+THIS IS A DRAFT, NOT A PUBLISHED VERSION OF THE GNU GENERAL PUBLIC LICENSE.
+
+poem{
+
+Copyright (C) 2007 Free Software Foundation, Inc. ( http://fsf.org )
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+}poem
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+1~ Preamble
+
+The GNU General Public License is a free, copyleft license for software and other kinds of works.
+
+The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other program whose authors commit to using it. You can apply it to your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things.
+
+To protect your rights, we need to make requirements that forbid anyone to deny you these rights or to ask you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
+
+Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License which gives you legal permission to copy, distribute and/or modify the software.
+
+For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be associated erroneously with the previous versions.
+
+Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the purpose of the GPL, which is to protect users' freedom to change the software where changes are possible. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users.
+
+Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in places where they do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free.
+
+The precise terms and conditions for copying, distribution and modification follow.
+
+:C~ TERMS AND CONDITIONS
+
+1~0 0. Definitions.
+
+"This License" refers to version 3 of the GNU General Public License.
+
+"Copyright" also means copyright-like laws that apply to other kinds of works, such as semiconductor masks.
+
+"The Program" refers to any copyrightable work licensed under this License. Each licensee is addressed as "you." "Licensees" and "recipients" may be individuals or organizations.
+
+To "modify" a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of a verbatim copy. The resulting work is called a "modified version" of the earlier work or a work "based on" the earlier work. A "covered work" means either the unmodified Program or a work based on the Program.
+
+A "contributor" is a party who licenses under this License a work on which the Program is based. Such a work is called the party's "contribution."
+
+To "propagate" a work means to do (or cause others to do) anything with it that requires permission under applicable copyright law, except executing it on a computer or making modifications that you do not share. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To "convey" a work means any kind of propagation that enables other parties to make or receive copies, excluding sublicensing. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying.
+
+A party's "essential patent claims" in a work are all patent claims owned or controlled by the party, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling the work, but do not include claims that would be infringed only as a consequence of further modification of the work. For purposes of this definition, "control" includes the right to grant sublicenses in a manner consistent with the requirements of this License.
+
+1~1 1. Source Code.
+
+The "source code" for a work means the preferred form of the work for making modifications to it. "Object code" means any non-source form of a work.
+
+A "Standard Interface" means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language.
+
+The "System Libraries" of an executable work include anything, other than the work as a whole, that (a) is normally included in the distribution of a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A "Major Component", in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it.
+
+The "Corresponding Source" for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work.
+
+The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source.
+
+The Corresponding Source for a work in source code form is that same work.
+
+1~2 2. Basic Permissions.
+
+All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law.
+
+Propagation of covered works that you do not convey, and making modified versions of the Program that you do not convey, are permitted without conditions, so long as your license otherwise remains in force. Conveying is permitted under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
+
+1~3 3. No Denying Users' Rights through Technical Measures.
+
+No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures.
+
+When you convey a covered work, you waive any legal power to forbid circumvention of technical measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technical measures.
+
+1~4 4.[1] Conveying Verbatim Copies.
+
+You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program.
+
+You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee.
+
+1~5 5.[2] Conveying Modified Source Versions.
+
+You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4 above, provided that you also meet all of these conditions:
+
+_1* a) The work must carry prominent notices stating that you modified it, and giving a relevant date.
+
+_1* b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to "keep intact all notices".
+
+_1* c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, unmodified except as permitted by section 7, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it.
+
+_1* d) If the work has interactive user interfaces, each must include a convenient feature that displays an appropriate copyright notice, and tells the user that there is no warranty for the work (unless you provide a warranty), that licensees may convey the work under this License, and how to view a copy of this License. Specifically, if the interface presents a list of user commands or options, such as a menu, a command to display this information must be prominent in the list; otherwise, the work must display this information at startup. However, if the Program has interactive interfaces that do not comply with this subsection, your work need not make them comply.
+
+A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, in or on a volume of a storage or distribution medium, is called an "aggregate" if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate.
+
+1~6 6.[3] Conveying Non-Source Forms.
+
+You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways:
+
+_1* a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange.
+
+_1* b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, either (1) to give anyone who possesses the object code a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) to provide access to copy the Corresponding Source from a network server at no charge.
+
+_1* c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b.
+
+_1* d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements.
+
+_1* e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d.
+
+A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work.
+
+A "User Product" is either (1) a "consumer product", which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. [In cases of doubt concerning whether an item is a "consumer product", the interpretation of the Magnuson-Moss Warranty Act, 15 U.S.C. 2301 et seq., shall provide the basis for interpretation, regardless of the choice of law determination for this License as a whole.]
+
+"Installation Information" for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made.
+
+If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM).
+
+The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient. Network access may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network.
+
+Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented, with an implementation available to the public in source code form, and must require no special password or key for unpacking, reading or copying.
+
+1~7 7. Additional Terms.
+
+"Additional permissions" are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions.
+
+When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission.
+
+Notwithstanding any other provision of this License, you may supplement the terms of this License with terms effective under, or drafted for compatibility with, local law:
+
+_1* a. disclaiming warranty or limiting liability differently from the terms of section 15 of this License; or
+
+_1* b. requiring preservation of specified reasonable legal notices or author attributions in source or object code forms of material added by you to a covered work; or
+
+_1* c. prohibiting misrepresentation of the origin of material added by you to a covered work, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or
+
+_1* d. limiting the use for publicity purposes of specified names of licensors or authors, or of specified trade names, trademarks, or service marks, to the extent otherwise permitted by law.
+
+All other non-permissive additional terms are considered "further restrictions" within the meaning of section 10. If the Program as you received it, or any part of it, purports to be governed by this License, supplemented by a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying.
+
+If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms.
+
+1~8 8.[4] Termination.
+
+You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void. If you violate this License, any copyright holder may put you on notice by notifying you of the violation, by any reasonable means, provided 60 days have not elapsed since the most recent violation. Having put you on notice, the copyright holder may, at any time, terminate the rights (including any patent rights) that the copyright holder has granted to you under this License.
+
+However, if this is your first violation of this License with respect to a given copyright holder, and you cure the violation within 30 days following your receipt of the notice, then your license is automatically reinstated.
+
+In the event that your rights are terminated under this section, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as they remain in full compliance.
+
+1~9 9.[5] Acceptance Not Required for Having Copies.
+
+You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so.
+
+1~10 10.[6] Automatic Licensing of Downstream Recipients.
+
+Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License.
+
+An "entity transaction" is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest.
+
+You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program (or the contribution of any contributor).
+
+1~11 11. Patents.
+
+Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims in its contribution, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contribution.
+
+For purposes of the following three paragraphs, a "patent license" means a patent license, a covenant not to bring suit for patent infringement, or any other express agreement or commitment, however denominated, not to enforce a patent.
+
+If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) disclaim the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. "Knowingly relying" means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid.
+
+If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license providing freedom to use, propagate, modify or convey a specific copy of the covered work to any of the parties receiving the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it.
+
+You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a patent license (a) in connection with copies of the covered work conveyed by you, and/or copies made from those, or (b) primarily for and in connection with specific products or compilations that contain the covered work, which license does not cover, prohibits the exercise of, or is conditioned on the non-exercise of any of the rights that are specifically granted to recipients of the covered work under this License[, unless you entered into that arrangement, or that patent license was granted, prior to March 28, 2007].
+
+Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law.
+
+1~12 12.[7] No Surrender of Others' Freedom.
+
+If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey the Program, or other covered work, so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program.
+
+1~13 13. Use with the Affero General Public License.
+
+Notwithstanding any other provision of this License, you have permission to link any covered work with a work licensed under version 2 of the Affero General Public License, and to convey the resulting combination. The terms of this License will continue to apply to your covered work but will not apply to the work with which it is linked, which will remain governed by the Affero General Public License.
+
+1~14 14.[9] Revised Versions of this License.
+
+The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation.
+
+If the Program specifies that a proxy can decide whether future versions of the GNU General Public License shall apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Program.
+
+1~15 15.[11, 12] Disclaimer of Warranty and Limitation of Liability.
+
+THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.
+
+END OF TERMS AND CONDITIONS
+
+1~ How to Apply These Terms to Your New Programs
+
+How to Apply These Terms to Your New Programs
+
+If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms.
+
+To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found.
+
+poem{
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year> <name of author>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, see http://www.gnu.org/licenses
+    or write to the Free Software Foundation,Inc., 51 Franklin Street,
+    Fifth Floor, Boston, MA 02110-1301 USA
+
+}poem
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode:
+
+poem{
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type 'show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type 'show c' for details.
+
+}poem
+
+The hypothetical commands 'show w' and 'show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than 'show w' and 'show c'; for a GUI interface, you would use an "About box" instead.
+
+You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample; alter the names:
+
+poem{
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  'Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+}poem
+
+For more information on how to apply and follow the GNU GPL, see http://www.gnu.org/licenses.
+
+The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License.
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/sisu_output_overview.ssi b/data/doc/sisu/sisu_markup_samples/dfsg/sisu_output_overview.ssi
new file mode 100644
index 00000000..4cc32196
--- /dev/null
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/sisu_output_overview.ssi
@@ -0,0 +1,61 @@
+% @title: SiSU overview of status of features available in various outputs
+
+% @date.created: 2005-10-31
+
+% @date.available: 2006-10-31
+
+% @date.modified: 2006-01-23
+
+% @date: 2006-01-23
+
+% :A~? SiSU overview of status of features available in various outputs
+
+!_ A Checklist of Output Features
+
+This table gives an indication of the features that are available
+for various forms of output of SiSU.~{ updated for sisu-0.36.6 on 2006-01-23 }~
+
+{t~h}
+feature                   |txt|ltx/pdf|HTML|XHTML|XML/s|XML/d|ODF|SQLite|pgSQL
+headings                  | * | *     | *  | *   | *   | *   | * | *    | *
+footnotes                 | * | *     | *  | *   | *   | *   | * | *    | *
+bold, underscore, italics | . | *     | *  | *   | *   | *   | * | *    | *
+strikethrough             | . | *     | *  | *   | *   | *   | * |      |
+superscript, subscript    | . | *     | *  | *   | *   | *   | * |      |
+extended ascii set (utf-8)| * | *     | *  | *   | *   | *   | * |      | *
+indents                   | * | *     | *  | *   | *   | *   | * |      |
+bullets                   | . | *     | *  | *   | *   | *   | . |      |
+groups                    |   |       |    |     |     |     |   |      |
+* tables                  |   | *     | *  | .   | .   | .   | . | .    | .
+* poem                    | * | *     | *  | .   | .   | .   | * | .    | .
+* code                    | * | *     | *  | .   | .   | .   | * | .    | .
+url                       | * | *     | *  | *   | *   | *   | * | .    | .
+links                     | * | *     | *  | *   | *   | *   | * | .    | .
+images                    | - | *     | *  | T   | T   | T   | * | T    | T
+image caption             | - | *     | *  |     |     |     |   |      |
+table of contents         |   | *     | *  | *   | *   | *   | . |      |
+page header/footer?       | - | *     | *  | *   | *   | *   | t |      |
+line break                | * | *     | *  | *   | *   | *   | * |      |
+page break                |   | *     |    |     |     |     | * |      |
+segments                  |   |       | *  |     |     |     |   |      |
+skins                     | * | *     | *  | *   | *   | *   |   |      |
+ocn                       | . | *     | *  | *   | *   | *   | -?| *    | *
+auto-heading numbers      | * | *     | *  | *   | *   | *   | * | *    | *
+minor list numbering      | * | *     | *  | *   | *   | *   | * | *    | *
+special characters        | . | .     | .  |     |     |     |   |      |
+
+group{
+
+  Done
+  * yes/done
+  . partial
+  
+  - not available/appropriate
+
+  Not Done
+  T task todo
+  t lesser task/todo
+    not done
+
+}group
+
diff --git a/data/doc/sisu/sisu_output_overview.sst b/data/doc/sisu/sisu_output_overview.sst
new file mode 100644
index 00000000..7a522582
--- /dev/null
+++ b/data/doc/sisu/sisu_output_overview.sst
@@ -0,0 +1,61 @@
+0~title SiSU overview of status of features available in various outputs
+
+0~date.created 2005-10-31
+
+0~date.available 2006-10-31
+
+0~date.modified 2006-01-23
+
+0~date 2006-01-23
+
+1~? SiSU overview of status of features available in various outputs
+
+4~ A Checklist of Output Features
+
+This table gives an indication of the features that are available
+for various forms of output of SiSU.~{ updated for sisu-0.36.6 on 2006-01-23 }~
+
+{t~h}
+feature                   |txt|ltx/pdf|HTML|XHTML|XML/s|XML/d|ODF|SQLite|pgSQL
+headings                  | * | *     | *  | *   | *   | *   | * | *    | *
+footnotes                 | * | *     | *  | *   | *   | *   | * | *    | *
+bold, underscore, italics | . | *     | *  | *   | *   | *   | * | *    | *
+strikethrough             | . | *     | *  | *   | *   | *   | * |      |
+superscript, subscript    | . | *     | *  | *   | *   | *   | * |      |
+extended ascii set (utf-8)| * | *     | *  | *   | *   | *   | * |      | *
+indents                   | * | *     | *  | *   | *   | *   | * |      |
+bullets                   | . | *     | *  | *   | *   | *   | . |      |
+groups                    |   |       |    |     |     |     |   |      |
+* tables                  |   | *     | *  | .   | .   | .   | . | .    | .
+* poem                    | * | *     | *  | .   | .   | .   | * | .    | .
+* code                    | * | *     | *  | .   | .   | .   | * | .    | .
+url                       | * | *     | *  | *   | *   | *   | * | .    | .
+links                     | * | *     | *  | *   | *   | *   | * | .    | .
+images                    | - | *     | *  | T   | T   | T   | * | T    | T
+image caption             | - | *     | *  |     |     |     |   |      |
+table of contents         |   | *     | *  | *   | *   | *   | . |      |
+page header/footer?       | - | *     | *  | *   | *   | *   | t |      |
+line break                | * | *     | *  | *   | *   | *   | * |      |
+page break                |   | *     |    |     |     |     | * |      |
+segments                  |   |       | *  |     |     |     |   |      |
+skins                     | * | *     | *  | *   | *   | *   |   |      |
+ocn                       | . | *     | *  | *   | *   | *   | -?| *    | *
+auto-heading numbers      | * | *     | *  | *   | *   | *   | * | *    | *
+minor list numbering      | * | *     | *  | *   | *   | *   | * | *    | *
+special characters        | . | .     | .  |     |     |     |   |      |
+
+group{
+
+  Done
+  * yes/done
+  . partial
+  
+  - not available/appropriate
+
+  Not Done
+  T task todo
+  t lesser task/todo
+    not done
+
+}group
+
diff --git a/data/sisu/README b/data/sisu/README
new file mode 100644
index 00000000..3f11295e
--- /dev/null
+++ b/data/sisu/README
@@ -0,0 +1,8 @@
+This directory contains shared data that sisu uses
+e.g. shared images, and odf file structure
+
+documentation is elsewhere
+try:
+/usr/share/doc/sisu
+man sisu
+sisu help
diff --git a/data/sisu/conf/cgi-bin/sisu_search_pgsql.cgi b/data/sisu/conf/cgi-bin/sisu_search_pgsql.cgi
new file mode 100644
index 00000000..0d2ed982
--- /dev/null
+++ b/data/sisu/conf/cgi-bin/sisu_search_pgsql.cgi
@@ -0,0 +1,923 @@
+#!/usr/bin/env ruby
+=begin
+ * Name: SiSU information Structuring Universe   
+ * Author: Ralph Amissah
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+
+ * Description: generates naive cgi search form for search of sisu database (pgsql)
+   * $Id$
+
+ Copyright (C) 2006 Ralph Amissah
+ Copyright (C) 2005 Ralph Amissah (first release edition)
+ Copyright (C) 1997 Ralph Amissah (first edition)
+
+ * License: GPL 2 or later
+
+  Summary of GPL 2
+
+  This program is free software; you can redistribute it and/or modify it
+  under the terms of the GNU General Public License as published by the Free
+  Software Foundation; either version 2 of the License, or (at your option)
+  any later version.
+
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+  more details.
+
+  You should have received a copy of the GNU General Public License along
+  with this program; if not, write to the Free Software Foundation, Inc.,
+  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+  If you have Internet connection, the latest version of the GPL should be
+  available at these locations:
+    http://www.fsf.org/licenses/gpl.html
+    http://www.gnu.org/copyleft/gpl.html
+    http://www.jus.uio.no/sisu/gpl2.fsf
+
+  SiSU was first released to the public on January 4th 2005
+
+  SiSU uses:
+  
+  *  Standard SiSU markup syntax,
+  *  Standard SiSU meta-markup syntax, and the
+  *  Standard SiSU object citation numbering and system
+  
+  © Ralph Amissah 1997, current 2006.
+  All Rights Reserved.
+
+ * Ralph Amissah ralph@amissah.com
+   Ralph Amissah ralph.amissah@gmail.com
+
+=end
+require 'cgi'
+require 'fcgi'
+require 'dbi'
+@version='sisu_search_pgsql'
+@url_base="http://corundum:8081/_sisu/image"
+host=%x{echo $HOSTNAME}.chomp!
+@hosturl="http://#{host}" +
+  ':8081'
+@base="#@hosturl/cgi-bin/#@version.cgi"
+user='ralph'
+class Form
+  def initialize(base,search_field,selected_db,checked_index,checked_text,checked_tip,checked_searched,checked_url,checked_echo,checked_sql,checked_all,checked_none,checked_ignore,search_note,the_can='')
+    search_note='' if checked_searched !~/\S/
+    the_can='' if checked_url !~/\S/
+    search_field='' if checked_echo !~/\S/
+    @base,@search_field,@selected_db,@checked_index,@checked_text,@checked_tip,@checked_searched,@checked_url,@checked_echo,@checked_sql,@checked_all,@checked_none,@checked_ignore,@search_note,@the_can=base,search_field,selected_db,checked_index,checked_text,checked_tip,checked_searched,checked_url,checked_echo,checked_sql,checked_all,checked_none,checked_ignore,search_note,the_can
+    @tip=if checked_tip =~/\S/
+      '<font size="2" color="#666666">text:__; keywords:__; title:__; author:__; subject:__; description:__; publisher:__; contributor:__; date:__; type:__; format:__; identifier:__; source:__; language:__; relation:__; coverage:__; rights:__; comment:__; abstract:__; </font>'
+    else '' 
+    end
+  end
+  def submission_form
+      search_form=<<-WOK
+<label for="find"><b>SiSU PgSQL Search Form (sample):</b></label>
+<table cellpadding="2">
+<tr><td valign=\"top\">
+  <table cellpadding="2">
+    <form action="#@base" id="Test Form" method="post">
+    <tr><td valign=\"top\">
+      <!input type="text" id="find" name="find" value="#@search_field" />
+      <!input type="text" id="find" name="find" value="" />
+      <textarea id="find" name="find" type="text" rows="4" cols="30" maxlength="256">#@search_field</textarea><br />
+    </td><td valign=\"top\"><p>
+      <select name="db" size="1">
+        #@selected_db
+        <option value="SiSU_sisu">sisu</option>
+        <option value="SiSU_document_samples_sisu_markup">document_samples_sisu_markup</option>
+      </select><br />
+      <font size="2" color="#222222">
+      <input type="radio" name="view" value="index" #@checked_index> index
+      <input type="radio" name="view" value="text" #@checked_text>  text
+      </font>
+      </p>
+      <p><input type="submit" value="submit" /></p>
+    </td></tr>
+  </table>
+    #@search_note
+  </td><td valign=\"top\">
+    #@tip
+  </td></tr>
+</table>           
+      <font size="2" color="#222222">
+      <input type="checkbox" name="echo" #@checked_echo> echo
+      <input type="checkbox" name="searched" #@checked_searched> searched
+      <input type="checkbox" name="url" #@checked_url> url
+      <input type="checkbox" name="tip" #@checked_tip> search fields available
+      <input type="checkbox" name="sql" #@checked_sql> sql statement
+      </font>
+      <br />
+      <input type="radio" name="checks" value="check_ignore" #@checked_ignore> use selected
+      <input type="radio" name="checks" value="check_all" #@checked_all> check all
+      <input type="radio" name="checks" value="check_none" #@checked_none> check none
+      <br />
+  </form>
+#@the_can
+WOK
+  end
+end
+class Search_request                                                       #% search_for
+  attr_accessor :text1,:keywords,:title,:author,:subject,:description,:publisher,:contributor,:date,:type,:format,:identifier,:source,:language,:relation,:coverage,:rights,:comment,:abstract,:owner,:date_created,:date_issued,:date_modified,:date_available,:date_valid
+  def initialize(search_field='',q='')
+    @search_field,@q=search_field,q
+    @text1=@keywords=@title=@author=@subject=@description=@publisher=@contributor=@date=@type=@format=@identifier=@source=@language=@relation=@coverage=@rights=@comment=@abstract=@owner=@date_created=@date_issued=@date_modified=@date_available=@date_valid=''
+    if @search_field=~/\S/
+      @text1=text_to_match('text:')
+      @keywords=text_to_match('key(?:words?)?:')
+      @title=text_to_match('title:')                  # DublinCore 1  - title
+      @author=text_to_match('(?:author|creator)s?:')  # DublinCore 2  - creator/author
+      @subject=text_to_match('subj(?:ect)?:')         # DublinCore 3  - subject
+      @description=text_to_match('description:')      # DublinCore 4  - description
+      @publisher=text_to_match('pub(?:lisher)?:')     # DublinCore 5  - publisher
+      @contributor=text_to_match('contributor:')      # DublinCore 6  - contributor
+      @date=text_to_match('date:')                    # DublinCore 7  - date dd-mm-yy
+      @type=text_to_match('type:')                    # DublinCore 8  - type
+      @format=text_to_match('format:')                # DublinCore 9  - format
+      @identifier=text_to_match('identifier:')        # DublinCore 10 - identifier
+      @source=text_to_match('source:')                # DublinCore 11 - source
+      @language=text_to_match('language:')            # DublinCore 12 - language
+      @relation=text_to_match('relation:')            # DublinCore 13 - relation
+      @coverage=text_to_match('coverage:')            # DublinCore 14 - coverage
+      @rights=text_to_match('rights:')                # DublinCore 15 - rights
+      @comment=text_to_match('comment:')
+      @abstract=text_to_match('abs(?:tract)?:')
+      @owner=text_to_match('owner:')
+      @date_created=text_to_match('date_created:')
+      @date_issued=text_to_match('date_issued:')
+      @date_modified=text_to_match('date_modified:')
+      @date_available=text_to_match('date_available:')
+      @date_valid=text_to_match('date_valid:')
+      @text1=text_to_match unless @keywords or @author or @title or @text1 or @comment or @abstract or @rights or @subject or @publisher or @date
+    else
+      @text1=q['s1'] if q['s1']=~/\S/
+      @keywords=q['key'] if q['key']=~/\S/
+      @title=q['ti'] if q['ti']=~/\S/
+      @author=q['au'] if q['au']=~/\S/
+      @subject=q['sj'] if q['sj']=~/\S/
+      @description=q['dsc'] if q['dsc']=~/\S/
+      @publisher=q['pb'] if q['pb']=~/\S/
+      @contributor=q['cntr'] if q['cntr']=~/\S/
+      @date=q['dt'] if q['dt']=~/\S/
+      @type=q['ty'] if q['ty']=~/\S/
+      @identifier=q['id'] if q['id']=~/\S/
+      @source=q['src'] if q['src']=~/\S/
+      @language=q['lang'] if q['lang']=~/\S/
+      @relation=q['rel'] if q['rel']=~/\S/
+      @coverage=q['cov'] if q['cov']=~/\S/
+      @rights=q['cr'] if q['cr']=~/\S/
+      @comment=q['co'] if q['co']=~/\S/
+      @abstract=q['ab'] if q['ab']=~/\S/
+      @date_created=q['dtc'] if q['dtc']=~/\S/
+      @date_issued=q['dti'] if q['dti']=~/\S/
+      @date_modified=q['dtm'] if q['dtm']=~/\S/
+      @date_available=q['dta'] if q['dta']=~/\S/
+      @date_valid=q['dtv'] if q['dtv']=~/\S/
+    end
+  end
+  def text_to_match(identifier='')
+    m=Hash.new
+    m[:string]=/#{identifier}\s*(.+?)/
+    m[:string]=/#{identifier}\s*(.+?)(?:;|\n|\r|$)/
+    m[:word]=/#{identifier}[\s(]*(\S+)/
+    search_string=if @search_field =~m[:word]
+      search_string=if @search_field =~m[:braces]: m[:braces].match(@search_field)[1]
+      elsif @search_field =~m[:string]:            m[:string].match(@search_field)[1]
+      else
+        str=m[:word].match(@search_field)[1]
+        str.gsub!(/[()]/,'')
+        str
+      end
+      search_string.strip!
+      search_string.gsub!(/\s+/,'+')
+      search_string
+    #else
+    #  "__"
+    end
+  end
+end
+class Dbi_search_string
+  def initialize(l,t,q)
+    @l,@t,@q=l,t,q
+  end
+  def string
+    search=Hash.new
+    search[:search]=Array.new
+    search[:flag]=false
+    if @t =~/\S+/ or @q =~/\S+/
+      if @t =~/\S+/:     unescaped_search=CGI.unescape(@t)
+      elsif @q =~/\S+/:  unescaped_search=CGI.unescape(@q)
+      end
+      search_construct=Array.new
+      unescaped_search.gsub!(/\s*(AND|OR)\s*/,"' \) \\1 #@l~\( '")
+      unescaped_search.gsub!(/(.+)/,"#@l~\( '\\1' \)")
+      search_construct << unescaped_search
+      search_construct=search_construct.join(' ')
+      search[:search]                    << search_construct
+      search[:flag]=true
+      search
+    end
+    search
+  end
+end
+class Dbi_search_statement
+  attr_reader :text_search_flag,:sql_select_body_format,:sql_select_endnotes_format
+  def initialize(conn,search_for,q)
+    @conn=conn
+    @text_search_flag=false
+    search=Hash.new
+    search[:text],search[:endnotes]=Array.new,Array.new
+    st=Dbi_search_string.new('documents.clean',search_for.text1,q['s1']).string
+    se=Dbi_search_string.new('endnotes.clean',search_for.text1,q['s1']).string
+    @text_search_flag=st[:flag]
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << se[:search]
+    end
+    st=Dbi_search_string.new('metadata.keywords',search_for.keywords,q['key']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.title',search_for.title,q['ti']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.creator',search_for.author,q['au']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.subject',search_for.subject,q['sj']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.description',search_for.description,q['dsc']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.publisher',search_for.publisher,q['pb']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.contributor',search_for.contributor,q['cntr']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.date',search_for.date,q['dt']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.type',search_for.type,q['ty']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.identifier',search_for.identifier,q['id']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.source',search_for.source,q['src']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.language',search_for.language,q['lang']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.relation',search_for.relation,q['rel']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.coverage',search_for.coverage,q['cov']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.rights',search_for.rights,q['cr']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.comment',search_for.comment,q['co']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.abstract',search_for.abstract,q['ab']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    @search_text,@search_endnotes=Array.new,Array.new
+                                                                           #%
+    search[:text].each{|x| @search_text << "#{x} AND " }
+    search[:endnotes].each{|x| @search_endnotes << "#{x} AND " }
+    @search_text=@search_text.to_s.gsub!(/AND\s+$/,'')
+    @search_endnotes=@search_endnotes.to_s.gsub!(/AND\s+$/,'')
+  end
+  def sql_select_body
+    %{SELECT metadata.title, metadata.creator, metadata.filename, metadata.suffix, documents.body, documents.seg, documents.ocn, metadata.tid FROM documents, metadata WHERE (#@search_text) AND documents.metadata_tid = metadata.tid ORDER BY metadata.title, documents.ocn ;}
+  end
+  def sql_select_endnotes
+    %{SELECT metadata.title, metadata.creator, metadata.filename, endnotes.body, endnotes.nr, endnotes.ocn, endnotes.metadata_tid FROM metadata, endnotes WHERE (#@search_endnotes) AND metadata.tid = endnotes.metadata_tid ORDER BY metadata.title, endnotes.nr ;}
+  end
+  def sql_select_body_format
+    %{<font color="#666666" size="2">#{sql_select_body}</font>} 
+  end
+  def sql_select_endnotes_format
+    %{<font color="#666666" size="2">#{sql_select_endnotes}</font>} 
+  end
+  def contents
+    @conn.select_all(sql_select_body)
+  end
+  def endnotes
+    @conn.select_all(sql_select_endnotes)
+  end
+end
+class Tail
+  def tail
+    <<-'WOK'
+<br /><hr /><br />
+<center><table align="center"bgcolor="#ffffff"><tr><td><font color="#666666"><table summary="" bgcolor="#ffffff" cellpadding="4" border="0" align="center">
+
+<tr align="center">
+  <td align="center"><p class="center"><font color="#666666" size="2">
+  presentations' look and feel<br />
+  generated by<br />
+  <a href="http://www.jus.uio.no/sisu" ><img border="0" src="http://corundum:8081/_sisu/image/sisu.png" alt="SiSU on Debian/Gnu/Linux or a FreeBSD &amp; Ruby - better ways, well actually, Way Better!" width="120" height="38"></a><br />
+  <a href="http://www.jus.uio.no/sisu" >SiSU</a><br />
+  version 0.36<br />2006w07/6 (20060218)<br />
+
+  <table summary="SiSU rights" bgcolor="#ffffff" cellpadding="4" border="0" align="center" width="40%">
+    <sup>&copy;</sup> Ralph Amissah<br />
+  1993, current 2006<br />
+  GPL 2<br />
+  <i>w3 since October 3 1993</i><br />
+  <a href="mailto://ralph@amissah.com" >ralph@amissah.com</a><br />
+</font></p>
+</td></tr></table>
+
+<p><center><font color="#666666" size="2">Developed<br />using <a href="http://www.ruby-lang.org/en/">Ruby</a><br />on <a href="http://www.debian.org/">Debian/Gnu/Linux</a> software infrastructure,<br />with the usual GPL (or OSS) suspects.<br />Better - "performance, reliability, scalability, security<br />& total cost of ownership"<br />[not to mention flexibility &amp; choice]<br /><br />&lt;&lt;<a href="http://www.jus.uio.no/sisu/">Way Better!</a>&gt;&gt;</font></center></p><tr align="center"><td align="center">
+
+<table summary="browser suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+<tr>
+  <td><p><font color="#666666" size="2">
+    If you have problems viewing pages on this site please update your browser:
+  </font></p>
+</td></tr></table>
+
+<table summary="browser suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+<tr><td>
+<p>
+<font color="#666666" size="2">
+If you have problems viewing pages on this site please update your browser:
+</font>
+</p>
+</td></tr>
+</table>
+
+<table summary="browser suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+<tr><td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.gnome.org/projects/epiphany/" target="external">
+<img border="0" width="25" height="25" src="http://corundum:8081/_sisu/image/gnome.png" alt="Epiphany">
+&nbsp;Epiphany
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://galeon.sourceforge.net/" target="external">
+<img border="0" width="24" height="24" src="http://corundum:8081/_sisu/image/galeon.png" alt="Galeon">
+&nbsp;Galeon
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.microsoft.com/windows/ie/default.asp" target="external">
+<img border="0" width="29" height="25" src="http://corundum:8081/_sisu/image/internet.explorer.png" alt="MS I-Explorer">
+I-Explorer
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://kazehakase.sourceforge.jp/" target="external">
+Kazehakase</a>
+<sup>&reg;</sup>&nbsp;|</font></p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.konqueror.org/" target="external">
+<img border="0" width="29" height="25" src="http://corundum:8081/_sisu/image/konqueror.png" alt="Konqueror">
+Konqueror</a>
+<sup>&reg;</sup>&nbsp;|</font></p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.mozilla.org/" target="external">
+<img border="0" width="30" height="24" src="http://corundum:8081/_sisu/image/mozilla.png" alt="Mozilla">
+Mozilla
+</a>
+<a href="http://www.mozilla.org/products/firefox/" target="external">
+<img border="0" width="25" height="25" src="http://corundum:8081/_sisu/image/firefox.png" alt="Firefox">
+<b>Firefox</b>
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://home.netscape.com/comprod/mirror/client_download.html" target="external">
+<img border="0" width="29" height="25" src="http://corundum:8081/_sisu/image/netscape.png" alt="Netscape">
+Netscape
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.opera.com/" target="external">
+<img border="0" width="29" height="25" src="http://corundum:8081/_sisu/image/opera.png" alt="Opera">
+Opera
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.apple.com/safari/" target="external">
+<img border="0" width="24" height="25" src="http://corundum:8081/_sisu/image/safari.png" alt="Safari">
+Safari
+</a>
+<sup>&reg;</sup>
+</font>
+</p>
+</td></tr>
+</table>
+
+<table summary="lightweight browser and text browser suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+<tr><td>
+<p>
+<font color="#666666" size="1">
+for console/text viewing:
+</font>
+</p>
+</td>
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://elinks.or.cz/" target="external">
+<b>elinks</b>
+</a>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://atrey.karlin.mff.cuni.cz/~clock/twibright/links" target="external">
+<b>links2</b>
+</a>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://w3m.sourceforge.net/" target="external">
+<b>w3m</b>
+</a>
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+for lightweight gui (X) viewing try:
+</font>
+</p>
+</td>
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.dillo.org/" target="external">
+Dillo
+</a>&nbsp;|</font></p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.gnome.org/projects/epiphany/" target="external">
+<img border="0" width="25" height="25" src="http://corundum:8081/_sisu/image/gnome.png" alt="Epiphany">
+&nbsp;Epiphany
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://galeon.sourceforge.net/" target="external">
+<img border="0" width="24" height="24" src="http://corundum:8081/_sisu/image/galeon.png" alt="Galeon">
+&nbsp;Galeon
+</a>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://atrey.karlin.mff.cuni.cz/~clock/twibright/links" target="external">
+<b>links2 -g</b>
+</a>
+</font>
+</p>
+</td></tr>
+</table>
+</td></tr>
+
+<tr align="center"><td align="center">
+
+<table summary="pdf viewer suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+
+<tr><td>
+<p class="center">
+<font color="#666666" size="1">
+&amp; for
+<a href="http://www.adobe.com/products/acrobat/adobepdf.html" target="external">
+pdf
+</a>
+viewings of this site we recommend stand alone viewers
+<br />
+(rather than web browser plugins):
+</font>
+</p>
+</td></tr>
+</table>
+
+<table summary="" bgcolor="#ffffff" cellpadding="4" border="0" align="center">
+<tr align="center"><td align="center">
+<p class="center">
+<font color="#666666" size="1">
+<a href="http://www.adobe.com/products/acrobat/readstep2.html" target="external">
+<img border="0" height="18" width="15" src="http://corundum:8081/_sisu/image/b_pdf.png" alt="Adobe Acrobat Reader">
+Acrobat Reader
+</a>
+<sup>&reg;</sup>
+&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p class="center">
+<font color="#666666" size="1">
+<a href="http://www.gnome.org/projects/evince/" target="external">
+<img border="0" width="25" height="25" src="http://corundum:8081/_sisu/image/gnome.png" alt="Evince">
+<b>Evince</b>
+</a>
+<sup>&reg;</sup>
+</font>
+</p>
+</td>
+
+<td>
+<p class="center"><font color="#666666" size="1">
+<a href="http://www.cs.wisc.edu/~ghost/gv/" target="external">
+&nbsp;GhostView<sup>&reg;</sup>&nbsp;</a>,
+<a href="http://wwwthep.physik.uni-mainz.de/~plass/gv/" target="external">
+GV<sup>&reg;</sup>
+</a>
+&amp;
+<a href="http://www.cs.wisc.edu/~ghost/gsview/" target="external">
+GSview<sup>&reg;</sup>
+</a>
+&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p class="center">
+<font color="#666666" size="1">
+<a href="http://www.foolabs.com/xpdf/" target="external">
+<img border="0" width="16" height="16" src="http://corundum:8081/_sisu/image/xpdf.png" alt="Xpdf">
+&nbsp;Xpdf
+</a>
+<sup>&reg;</sup>
+</font>
+</p>
+</td></tr>
+</table>
+
+</font></center></td></tr></table></center> <a name="bottom" id="bottom"></a><a name="down" id="down"></a><a name="end" id="end"></a><a name="finish" id="finish"></a><a name="stop" id="stop"></a><a name="credits" id="credits"></a>
+</body></html>
+WOK
+  end
+end
+@counter_txt_doc,@counter_txt_ocn,@counter_endn_doc,@counter_endn_ocn=0,0,0,0
+@counters_txt,@counters_endn,@sql_select_body,@sql_select_endnotes='','','',''
+FCGI.each_cgi do |cgi|
+  begin # all code goes in begin section
+    @search=Hash.new
+    @search[:text],@search[:endnotes]=Array.new,Array.new
+    q=CGI.new
+    @db=if cgi['db'] =~/\S+/: 
+      @stub=/SiSU_(\S+)/.match(cgi['db'])[1] 
+      cgi['db']
+    else
+      @stub='sisu'
+      'SiSU_sisu'
+    end
+    checked_url,checked_searched,checked_tip,checked_echo,checked_sql,checked_all,checked_none,checked_ignore,selected_db='','','','','','','',''
+    if cgi['view']=~/text/: checked_index,checked_text='','checked'
+    else                    checked_index,checked_text='checked',''
+    end
+    checked_url='checked' if cgi['url'] =~/\S/ or cgi['u'].to_i==1 
+    checked_searched='checked' if cgi['searched'] =~/\S/ 
+    checked_tip='checked' if cgi['tip'] =~/\S/ 
+    checked_echo='checked' if cgi['echo'] =~/\S/ 
+    checked_sql='checked' if cgi['sql'] =~/\S/ 
+    if cgi['checks'] =~/check_all/ or cgi['check_all'] =~/\S/ or cgi['a'].to_i==1 
+      checked_all=checked_url=checked_searched=checked_tip=checked_echo=checked_sql='checked'
+      checked_none='' 
+    elsif cgi['checks'] =~/check_none/ #or cgi['a'].to_i==0 
+      checked_none='checked'
+      checked_all=checked_url=checked_searched=checked_tip=checked_echo=checked_sql='' 
+    else checked_ignore='checked'
+    end
+    selected_db=case cgi['db']
+    when /SiSU_document_samples_sisu_markup/:        '<option value="SiSU_document_samples_sisu_markup">document_samples_sisu_markup</option>'
+    when /SiSU_sisu/:        '<option value="SiSU_sisu">sisu</option>'
+    end
+    dbi="dbi:Pg:database=#{@db};port=5432"
+    @conn=DBI.connect(dbi,user) 
+    search_field=cgi['find'] if cgi['find'] # =~/\S+/
+    @search_for=Search_request.new(search_field,q) #.analyze               #% search_for
+                                                                           #% searches
+    #Canned_search.new(@base,@search_for.text1,cgi)
+    if @search_for.text1=~/\S+/ or @search_for.author=~/\S+/ #and search_field =~/\S/
+      s1='s1=' + CGI.escape(@search_for.text1) if @search_for.text1=~/\S/
+      key='key=' + CGI.escape(@search_for.keywords) if @search_for.keywords=~/\S/
+      ti='&ti=' + CGI.escape(@search_for.title) if @search_for.title=~/\S/
+      au='&au=' + CGI.escape(@search_for.author) if @search_for.author=~/\S/
+      sj='&sj=' + CGI.escape(@search_for.subject) if @search_for.subject=~/\S/
+      dsc='&dsc=' + CGI.escape(@search_for.description) if @search_for.description=~/\S/
+      pb='&pb=' + CGI.escape(@search_for.publisher) if @search_for.publisher=~/\S/
+      cntr='&cntr=' + CGI.escape(@search_for.contributor) if @search_for.contributor=~/\S/
+      dt='&dt=' + CGI.escape(@search_for.date) if @search_for.date=~/\S/
+      ty='&ty=' + CGI.escape(@search_for.type) if @search_for.type=~/\S/
+      id='&id=' + CGI.escape(@search_for.identifier) if @search_for.identifier=~/\S/
+      src='&src=' + CGI.escape(@search_for.source) if @search_for.source=~/\S/
+      lang='&lang=' + CGI.escape(@search_for.language) if @search_for.language=~/\S/
+      rel='&rel=' + CGI.escape(@search_for.relation) if @search_for.relation=~/\S/
+      cov='&cov=' + CGI.escape(@search_for.coverage) if @search_for.coverage=~/\S/
+      cr='&cr=' + CGI.escape(@search_for.rights) if @search_for.rights=~/\S/
+      co='&co=' + CGI.escape(@search_for.comment) if @search_for.comment=~/\S/
+      ab='&ab=' + CGI.escape(@search_for.abstract) if @search_for.abstract=~/\S/
+      dtc='&dtc=' + CGI.escape(@search_for.date_created) if @search_for.date_created=~/\S/
+      dti='&dti=' + CGI.escape(@search_for.date_issued) if @search_for.date_issued=~/\S/
+      dtm='&dtm=' + CGI.escape(@search_for.date_modified) if @search_for.date_modified=~/\S/
+      dta='&dta=' + CGI.escape(@search_for.date_available) if @search_for.date_available=~/\S/
+      dtv='&dtv=' + CGI.escape(@search_for.date_valid) if @search_for.date_valid=~/\S/
+      canned_search_url=if checked_all =~/checked/
+        "#@base?#{s1}#{key}#{ti}#{au}#{sj}#{dsc}#{pb}#{cntr}#{dt}#{ty}#{id}#{src}#{lang}#{rel}#{cov}#{cr}#{co}#{ab}#{dtc}#{dti}#{dtm}#{dta}#{dtv}&db=#{cgi['db']}&view=#{cgi['view']}&a=1"
+      else "#@base?#{s1}#{key}#{ti}#{au}#{sj}#{dsc}#{pb}#{cntr}#{dt}#{ty}#{id}#{src}#{lang}#{rel}#{cov}#{cr}#{co}#{ab}#{dtc}#{dti}#{dtm}#{dta}#{dtv}&db=#{cgi['db']}&view=#{cgi['view']}&u=1&e=1"
+      end      
+      @search[:text][1]=%{documents.clean~'#{@search_for.text1}'} #s1
+      @search[:endnotes][1]=%{endnotes.clean~'#{@search_for.text1}'} #s1
+      canned_note='previous search url:'
+    else
+      canned_search_url="#@base?s1=United+Nations&db=documents&view=index"
+      canned_note='search url example:'
+    end
+    if search_field =~/\S+/
+      analyze_format=search_field.gsub(/\s*\n/,'; ')
+    elsif checked_all =~/checked/ or checked_url =~/checked/
+      canned_search=canned_search_url.scan(/(?:s1|au|ti)=[^&]+/)
+      af=canned_search.join('; ')
+      af.gsub!(/s1=/,'text: ')
+      af.gsub!(/au=/,'author: ')
+      af.gsub!(/ti=/,'title: ')
+      af.gsub!(/%2B/,' ')
+      analyze_format=af
+      st=af.split(/\s*;\s*/)
+      search_field=st.join("\n")      
+    end
+    green=%{<font size="2" color="#004000">}
+    the_can=%{<font size="2" color="#666666">#{canned_note}<br> <a href="#{canned_search_url}">#{canned_search_url}</a></font><br>}
+    p_text=p_keywords=p_title=p_author=p_subject=p_description=p_publisher=p_contributor=p_date=p_type=p_format=p_identifier=p_source=p_language=p_relation=p_coverage=p_rights=p_comment=p_abstract=p_subject=''
+    p_text=%{text: #{green}#{@search_for.text1}</font><br>} if @search_for.text1 =~/\S+/
+    p_keywords=%{keywords: #{green}#{@search_for.keywords}</font><br>} if @search_for.keywords =~/\S+/
+    p_title=%{title: #{green}#{@search_for.title}</font><br>} if @search_for.title =~/\S+/
+    p_author=%{author: #{green}#{@search_for.author}</font><br>} if @search_for.author =~/\S+/
+    p_subject=%{subject: #{green}#{@search_for.subject}</font><br>} if @search_for.subject =~/\S+/
+    p_description=%{description: #{green}#{@search_for.description}</font><br>} if @search_for.description =~/\S+/
+    p_publisher=%{publisher: #{green}#{@search_for.publisher}</font><br>} if @search_for.publisher =~/\S+/
+    p_contributor=%{contributor: #{green}#{@search_for.contributor}</font><br>} if @search_for.contributor =~/\S+/
+    p_date=%{date: #{green}#{@search_for.date}</font><br>} if @search_for.date =~/\S+/
+    p_type=%{type: #{green}#{@search_for.type}</font><br>} if @search_for.type =~/\S+/
+    p_format=%{format: #{green}#{@search_for.format}</font><br>} if @search_for.format =~/\S+/
+    p_identifier=%{identifier: #{green}#{@search_for.identifier}</font><br>} if @search_for.identifier =~/\S+/
+    p_source=%{source: #{green}#{@search_for.source}</font><br>} if @search_for.source =~/\S+/
+    p_language=%{language: #{green}#{@search_for.language}</font><br>} if @search_for.language =~/\S+/
+    p_relation=%{relation: #{green}#{@search_for.relation}</font><br>} if @search_for.relation =~/\S+/
+    p_coverage=%{coverage: #{green}#{@search_for.coverage}</font><br>} if @search_for.coverage =~/\S+/
+    p_rights=%{rights: #{green}#{@search_for.rights}</font><br>} if @search_for.rights =~/\S+/
+    p_comment=%{comment: #{green}#{@search_for.comment}</font><br>} if @search_for.comment =~/\S+/
+    p_abstract=%{abstract: #{green}#{@search_for.abstract}</font><br>} if @search_for.abstract =~/\S+/
+    search_note=<<-WOK
+<font size="2" color="#666666">
+<br><b>previous selection</b>:<br>
+database: #{green}#@db</font>; selected view: #{green}#{cgi['view']}</font><br>
+search string: "#{green}#{analyze_format}</font>"<br>
+#{p_text} #{p_keywords} #{p_title} #{p_author} #{p_subject} #{p_description} #{p_publisher} #{p_contributor} #{p_date} #{p_type} #{p_format} #{p_identifier} #{p_source} #{p_language} #{p_relation} #{p_coverage} #{p_rights} #{p_comment} #{p_abstract}
+</font>
+WOK
+    #eg = %{canned search e.g.:<br> <a href="#{url}">#{url}</a><br>find: #{analyze}<br>database: #{database}}
+    #dbi_canning
+    @header=Form.new(@base,search_field,selected_db,checked_index,checked_text,checked_tip,checked_searched,checked_url,checked_echo,checked_sql,checked_all,checked_none,checked_ignore,search_note,the_can).submission_form #% form
+    @tail=Tail.new.tail
+    unless q['s1'] =~/\S/ or q['au'] =~/\S/ or @search[:text][1] =~/\S/ 
+      print "Content-type: text/html\n\n"
+      puts (@header+@tail)
+    else #% searches
+      s1=if @search_for.text1 =~/\S/
+        @search_for.text1
+      else 'Unavailable'
+      end
+      @search[:text]<<%{documents.clean~'#{CGI.unescape(s1)}'}
+      @search[:endnotes]<<%{endnotes.clean~'#{CGI.unescape(s1)}'}
+    #dbi_request
+      dbi_statement=Dbi_search_statement.new(@conn,@search_for,q)
+      @text_search_flag=false
+      @text_search_flag=dbi_statement.text_search_flag
+      s_contents=dbi_statement.contents
+      s_endnotes=dbi_statement.endnotes
+      @body_main=Array.new
+      @endnotes=Array.new
+      oldtid=0
+      if @text_search_flag 
+        if checked_sql =~/\S/
+          sql_select_body=dbi_statement.sql_select_body_format
+          sql_select_endnotes=dbi_statement.sql_select_endnotes_format
+        else sql_select_body,sql_select_endnotes='',''
+        end
+        @body_main << "<p><hr><br><b>Main Text:</b><br>" << sql_select_body
+        @endnotes  << "<p><hr><br><b>Endnotes:</b><br>"  << sql_select_endnotes
+      else
+      end
+      #text_objects_body
+      s_contents.each do |c|                                               #% text body
+        location=c["filename"][/(.+?)\.ss[ftms]/, 1]
+        file_suffix=c["filename"][/.+?\.(ss[ftms])/, 1]
+      #metadata_found_body
+        if c["tid"].to_i != oldtid.to_i
+          title=%{<a href="#@hosturl/#@stub/#{location}/">#{c["title"]}</a> by #{c["creator"]} <a href="#@hosturl/#@stub/#{location}/portrait.pdf"><img border="0" width="15" height="18" src="#@url_base/b_pdf.png" alt="pdf portrait"></a><a href="#@hosturl/#@stub/#{location}/landscape.pdf"><img border="0" width="18" height="15" src="#@url_base/b_pdf.png" alt="pdf landscape"></a><br>}  if file_suffix=~/s/ #hmm watch file_suffix
+           if @text_search_flag: title='<br><hr>'+title 
+           else                  title='<br>'+title 
+           end
+           @counter_txt_doc+=1
+           oldtid=c["tid"].to_i
+          else                    title=''
+          end
+          if @text_search_flag 
+            if cgi['view']=~/text/                                         #% txt body
+              text=if c["suffix"] !~/1/ #seg
+                if @search_for.text1 =~/\S+/ or q['s1'] =~/\S+/                         #% only this branch is working !!
+                  if @search_for.text1 =~/\S+/:     unescaped_search=CGI.unescape(@search_for.text1)
+                  elsif q['s1'] =~/\S+/:           unescaped_search=CGI.unescape(q['s1'])
+                  end
+                  search_regex=Array.new
+                  build=unescaped_search.scan(/\S+/).each do |g|
+                     if g.to_s =~/(AND|OR)/
+                       search_regex << '|'
+                     else search_regex << %{#{g.to_s}}
+                     end
+                  end
+                  search_regex=search_regex.join(' ')
+                  search_regex=search_regex.gsub(/\s*\|\s*/,'|')
+                  @search_regx=search_regex.to_s
+                end
+                matched_para=c["body"].gsub(/(#@search_regx)/i,%{<span style="background-color: #ffff48">\\1</span>})
+                %{<hr><p><font size="2">ocn <b><a href="#@hosturl/#@stub/#{location}/#{c["seg"]}.html##{c["ocn"]}">#{c["ocn"]}</a></b>:</font></p>#{matched_para}} 
+              elsif c["suffix"] =~/1/ #doc
+                %{#{title}<hr><p><font size="2">ocn #{c["ocn"]}:#{c["body"]}}
+              end
+              @counter_txt_ocn+=1
+              output=if c["seg"] =~/\S+/: title+text
+              else                        text 
+              end
+            elsif cgi['view']=~/index/                                     #% idx body
+              if c["suffix"] !~/1/ #seg
+                index=%{<a href="#@hosturl/#@stub/#{location}/#{c["seg"]}.html##{c["ocn"]}">#{c["ocn"]}</a>, } if @text_search_flag 
+              elsif c["suffix"] =~/1/ #doc
+                index=%{<a href="#@hosturl/#@stub/#{location}/doc.html##{c["ocn"]}">#{c["ocn"]}</a>, } 
+              end
+              if c["seg"] =~/\S+/ 
+                if @text_search_flag 
+                  @counter_txt_ocn+=1
+                  output=title+index
+                end
+              else
+                @counter_txt_ocn+=1
+                output=unless c["suffix"] =~/1/: title+index
+                else %{#{title}#{c["ocn"].sort}, }
+                end
+              end
+            end
+          else output=title 
+          end 
+        @counters_txt=if @counter_txt_doc > 0
+          %{<font size="2" color="#666666">Found in the main body of #@counter_txt_doc documents, and at #@counter_txt_ocn locations within.</font><br />}
+        else ''
+        end
+        @body_main << output #+ details
+      end
+      #text_objects_endnote
+      oldtid = 0
+      s_endnotes.each do |e|                                               #% endnotes
+        location=e["filename"][/(.+?)\.ss[ftms]/, 1]
+        file_suffix=e["filename"][/.+?\.(ss[ftms])/, 1]
+      #metadata_found_endnotes
+        if @text_search_flag
+          if e["metadata_tid"].to_i != oldtid.to_i 
+            title=%{<br><hr><a href="#@hosturl/#@stub/#{location}/">#{e["title"]}</a> by #{e["creator"]} <a href="#@hosturl/#@stub/#{location}/portrait.pdf"><img border="0" width="15" height="18" src="#@url_base/b_pdf.png" alt="pdf portrait"></a><a href="#@hosturl/#@stub/#{location}/landscape.pdf"><img border="0" width="18" height="15" src="#@url_base/b_pdf.png" alt="pdf landscape"></a><br>}  if file_suffix=~/s/
+            @counter_endn_doc+=1
+            oldtid=e["metadata_tid"].to_i
+          else title = ''
+          end
+          if cgi['view']=~/text/                                           #% txt endnotes
+            @counter_endn_ocn+=1
+            matched_endnote=e["body"].gsub(/(#@search_regx)/i,%{<span style="background-color: #ffff48">\\1</span>})
+            output=%{#{title}<hr><font size="2">note <b><a href="#@hosturl/#@stub/#{location}/endnotes.html##{e["nr"]}">#{e["nr"]}</a></b> referred to from ocn <a href="#@hosturl/#@stub/#{location}/doc.html##{e["ocn"]}">#{e["ocn"]}</a>:</font> #{matched_endnote}} 
+          elsif cgi['view']=~/index/                                       #% idx endnotes
+            @counter_endn_ocn+=1
+            output=%{#{title}<a href="#@hosturl/#@stub/#{location}/endnotes.html#_#{e["nr"]}">#{e["nr"]}</a> [&sect; <a href="#@hosturl/#@stub/#{location}/doc.html##{e["ocn"]}">#{e["ocn"]}</a>], }
+          end
+          @counters_endn=if @counter_endn_doc > 0
+          %{<font size="2" color="#666666">Found in the endnotes of #@counter_endn_doc documents, and at #@counter_endn_ocn locations within.</font><br />}
+          end
+          @endnotes << output #+ details
+        else @endnotes=Array.new #does not take out yet
+        end
+      end
+      cgi.out{@header + @counters_txt + @counters_endn + @body_main.join + @endnotes.join + @tail} #% print cgi_output_header+counters+body+endnotes
+    end
+  rescue Exception => e
+    s='<pre>' + CGI::escapeHTML(e.backtrace.reverse.join("\n"))
+    s << CGI::escapeHTML(e.message) + '</pre>'
+    cgi.out{s}
+    next
+  ensure # eg. disconnect from server
+    @conn.disconnect if @conn
+  end
+end
diff --git a/data/sisu/conf/cgi-bin/sisu_search_sqlite.cgi b/data/sisu/conf/cgi-bin/sisu_search_sqlite.cgi
new file mode 100644
index 00000000..f4c5382a
--- /dev/null
+++ b/data/sisu/conf/cgi-bin/sisu_search_sqlite.cgi
@@ -0,0 +1,932 @@
+#!/usr/bin/env ruby
+=begin
+ * Name: SiSU information Structuring Universe   
+ * Author: Ralph Amissah
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+
+ * Description: generates naive cgi search form for search of sisu database (sqlite)
+   * $Id$
+
+ Copyright (C) 2006 Ralph Amissah
+ Copyright (C) 2005 Ralph Amissah (first release edition)
+ Copyright (C) 1997 Ralph Amissah (first edition)
+
+ * License: GPL 2 or later
+
+  Summary of GPL 2
+
+  This program is free software; you can redistribute it and/or modify it
+  under the terms of the GNU General Public License as published by the Free
+  Software Foundation; either version 2 of the License, or (at your option)
+  any later version.
+
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+  more details.
+
+  You should have received a copy of the GNU General Public License along
+  with this program; if not, write to the Free Software Foundation, Inc.,
+  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+  If you have Internet connection, the latest version of the GPL should be
+  available at these locations:
+    http://www.fsf.org/licenses/gpl.html
+    http://www.gnu.org/copyleft/gpl.html
+    http://www.jus.uio.no/sisu/gpl2.fsf
+
+  SiSU was first released to the public on January 4th 2005
+
+  SiSU uses:
+  
+  *  Standard SiSU markup syntax,
+  *  Standard SiSU meta-markup syntax, and the
+  *  Standard SiSU object citation numbering and system
+  
+  © Ralph Amissah 1997, current 2006.
+  All Rights Reserved.
+
+ * Ralph Amissah ralph@amissah.com
+   Ralph Amissah ralph.amissah@gmail.com
+
+=end
+require 'cgi'
+require 'fcgi'
+require 'dbi'
+@version='sisu_search_sqlite'
+@url_base="http://corundum:8081/_sisu/image"
+host=%x{echo $HOSTNAME}.chomp!
+@hosturl="http://#{host}" +
+  ':8081'
+@base="#@hosturl/cgi-bin/#@version.cgi"
+class Form
+  def initialize(base,search_field,selected_db,checked_index,checked_text,checked_tip,checked_searched,checked_url,checked_echo,checked_sql,checked_all,checked_none,checked_ignore,search_note,the_can='')
+    search_note='' if checked_searched !~/\S/
+    the_can='' if checked_url !~/\S/
+    search_field='' if checked_echo !~/\S/
+    @base,@search_field,@selected_db,@checked_index,@checked_text,@checked_tip,@checked_searched,@checked_url,@checked_echo,@checked_sql,@checked_all,@checked_none,@checked_ignore,@search_note,@the_can=base,search_field,selected_db,checked_index,checked_text,checked_tip,checked_searched,checked_url,checked_echo,checked_sql,checked_all,checked_none,checked_ignore,search_note,the_can
+    @tip=if checked_tip =~/\S/
+      '<font size="2" color="#666666">text:__; keywords:__; title:__; author:__; subject:__; description:__; publisher:__; contributor:__; date:__; type:__; format:__; identifier:__; source:__; language:__; relation:__; coverage:__; rights:__; comment:__; abstract:__; </font>'
+    else '' 
+    end
+  end
+  def submission_form
+      search_form=<<-WOK
+<label for="find"><b>SiSU SQLite Search Form (sample):</b></label>
+<table cellpadding="2">
+<tr><td valign=\"top\">
+  <table cellpadding="2">
+    <form action="#@base" id="Test Form" method="post">
+    <tr><td valign=\"top\">
+      <!input type="text" id="find" name="find" value="#@search_field" />
+      <!input type="text" id="find" name="find" value="" />
+      <textarea id="find" name="find" type="text" rows="4" cols="30" maxlength="256">#@search_field</textarea><br />
+    </td><td valign=\"top\"><p>
+      <select name="db" size="1">
+        #@selected_db
+        <option value="SiSU_document_samples_sisu_markup">SiSU examples</option>
+        <option value="SiSU_sisu">SiSU</option>
+        <option value="SiSU_sisu-dev">SiSU dev</option>
+        <option value="SiSU_books">Books</option>
+        <option value="SiSU_articles">Articles</option>
+        <option value="SiSU_agreements">Agreements</option>
+        <option value="SiSU_conventions">Conventions</option>
+      </select><br />
+      <font size="2" color="#222222">
+      <input type="radio" name="view" value="index" #@checked_index> index
+      <input type="radio" name="view" value="text" #@checked_text>  text
+      </font>
+      </p>
+      <p><input type="submit" value="submit" /></p>
+    </td></tr>
+  </table>
+    #@search_note
+  </td><td valign=\"top\">
+    #@tip
+  </td></tr>
+</table>           
+      <font size="2" color="#222222">
+      <input type="checkbox" name="echo" #@checked_echo> echo
+      <input type="checkbox" name="searched" #@checked_searched> searched
+      <input type="checkbox" name="url" #@checked_url> url
+      <input type="checkbox" name="tip" #@checked_tip> search fields available
+      <input type="checkbox" name="sql" #@checked_sql> sql statement
+      </font>
+      <br />
+      <input type="radio" name="checks" value="check_ignore" #@checked_ignore> use selected
+      <input type="radio" name="checks" value="check_all" #@checked_all> check all
+      <input type="radio" name="checks" value="check_none" #@checked_none> check none
+      <br />
+  </form>
+#@the_can
+WOK
+  end
+end
+class Search_request                                                       #% search_for
+  attr_accessor :text1,:keywords,:title,:author,:subject,:description,:publisher,:contributor,:date,:type,:format,:identifier,:source,:language,:relation,:coverage,:rights,:comment,:abstract,:owner,:date_created,:date_issued,:date_modified,:date_available,:date_valid
+  def initialize(search_field='',q='')
+    @search_field,@q=search_field,q
+    @text1=@keywords=@title=@author=@subject=@description=@publisher=@contributor=@date=@type=@format=@identifier=@source=@language=@relation=@coverage=@rights=@comment=@abstract=@owner=@date_created=@date_issued=@date_modified=@date_available=@date_valid=''
+    if @search_field=~/\S/
+      @text1=text_to_match('text:')
+      @keywords=text_to_match('key(?:words?)?:')
+      @title=text_to_match('title:')                  # DublinCore 1  - title
+      @author=text_to_match('(?:author|creator)s?:')  # DublinCore 2  - creator/author
+      @subject=text_to_match('subj(?:ect)?:')         # DublinCore 3  - subject
+      @description=text_to_match('description:')      # DublinCore 4  - description
+      @publisher=text_to_match('pub(?:lisher)?:')     # DublinCore 5  - publisher
+      @contributor=text_to_match('contributor:')      # DublinCore 6  - contributor
+      @date=text_to_match('date:')                    # DublinCore 7  - date dd-mm-yy
+      @type=text_to_match('type:')                    # DublinCore 8  - type
+      @format=text_to_match('format:')                # DublinCore 9  - format
+      @identifier=text_to_match('identifier:')        # DublinCore 10 - identifier
+      @source=text_to_match('source:')                # DublinCore 11 - source
+      @language=text_to_match('language:')            # DublinCore 12 - language
+      @relation=text_to_match('relation:')            # DublinCore 13 - relation
+      @coverage=text_to_match('coverage:')            # DublinCore 14 - coverage
+      @rights=text_to_match('rights:')                # DublinCore 15 - rights
+      @comment=text_to_match('comment:')
+      @abstract=text_to_match('abs(?:tract)?:')
+      @owner=text_to_match('owner:')
+      @date_created=text_to_match('date_created:')
+      @date_issued=text_to_match('date_issued:')
+      @date_modified=text_to_match('date_modified:')
+      @date_available=text_to_match('date_available:')
+      @date_valid=text_to_match('date_valid:')
+      @text1=text_to_match unless @keywords or @author or @title or @text1 or @comment or @abstract or @rights or @subject or @publisher or @date
+    else
+      @text1=q['s1'] if q['s1']=~/\S/
+      @keywords=q['key'] if q['key']=~/\S/
+      @title=q['ti'] if q['ti']=~/\S/
+      @author=q['au'] if q['au']=~/\S/
+      @subject=q['sj'] if q['sj']=~/\S/
+      @description=q['dsc'] if q['dsc']=~/\S/
+      @publisher=q['pb'] if q['pb']=~/\S/
+      @contributor=q['cntr'] if q['cntr']=~/\S/
+      @date=q['dt'] if q['dt']=~/\S/
+      @type=q['ty'] if q['ty']=~/\S/
+      @identifier=q['id'] if q['id']=~/\S/
+      @source=q['src'] if q['src']=~/\S/
+      @language=q['lang'] if q['lang']=~/\S/
+      @relation=q['rel'] if q['rel']=~/\S/
+      @coverage=q['cov'] if q['cov']=~/\S/
+      @rights=q['cr'] if q['cr']=~/\S/
+      @comment=q['co'] if q['co']=~/\S/
+      @abstract=q['ab'] if q['ab']=~/\S/
+      @date_created=q['dtc'] if q['dtc']=~/\S/
+      @date_issued=q['dti'] if q['dti']=~/\S/
+      @date_modified=q['dtm'] if q['dtm']=~/\S/
+      @date_available=q['dta'] if q['dta']=~/\S/
+      @date_valid=q['dtv'] if q['dtv']=~/\S/
+    end
+  end
+  def text_to_match(identifier='')
+    m=Hash.new
+    m[:string]=/#{identifier}\s*(.+?)/
+    m[:string]=/#{identifier}\s*(.+?)(?:;|\n|\r|$)/
+    m[:word]=/#{identifier}[\s(]*(\S+)/
+    search_string=if @search_field =~m[:word]
+      search_string=if @search_field =~m[:braces]: m[:braces].match(@search_field)[1]
+      elsif @search_field =~m[:string]:            m[:string].match(@search_field)[1]
+      else
+        str=m[:word].match(@search_field)[1]
+        str.gsub!(/[()]/,'')
+        str
+      end
+      search_string.strip!
+      search_string.gsub!(/\s+/,'+')
+      search_string
+    #else
+    #  "__"
+    end
+  end
+end
+class Dbi_search_string
+  def initialize(l,t,q)
+    @l,@t,@q=l,t,q
+  end
+  def string
+    search=Hash.new
+    search[:search]=Array.new
+    search[:flag]=false
+    if @t =~/\S+/ or @q =~/\S+/
+      if @t =~/\S+/:     unescaped_search=CGI.unescape(@t)
+      elsif @q =~/\S+/:  unescaped_search=CGI.unescape(@q)
+      end
+      search_construct=Array.new
+      unescaped_search.gsub!(/\s*(AND|OR)\s*/,"%' \) \\1 #@l LIKE \( '%")
+      unescaped_search.gsub!(/(.+)/,"#@l LIKE \( '%\\1%' \)")
+      search_construct << unescaped_search
+      search_construct=search_construct.join(' ')
+      search[:search]                    << search_construct
+      search[:flag]=true
+      search
+    end
+    search
+  end
+end
+class Dbi_search_statement
+  attr_reader :text_search_flag,:sql_select_body_format,:sql_select_endnotes_format
+  def initialize(conn,search_for,q)
+    @conn=conn
+    @text_search_flag=false
+    search=Hash.new
+    search[:text],search[:endnotes]=Array.new,Array.new
+    st=Dbi_search_string.new('documents.clean',search_for.text1,q['s1']).string
+    se=Dbi_search_string.new('endnotes.clean',search_for.text1,q['s1']).string
+    @text_search_flag=st[:flag]
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << se[:search]
+    end
+    st=Dbi_search_string.new('metadata.keywords',search_for.keywords,q['key']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.title',search_for.title,q['ti']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.creator',search_for.author,q['au']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.subject',search_for.subject,q['sj']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.description',search_for.description,q['dsc']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.publisher',search_for.publisher,q['pb']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.contributor',search_for.contributor,q['cntr']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.date',search_for.date,q['dt']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.type',search_for.type,q['ty']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.identifier',search_for.identifier,q['id']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.source',search_for.source,q['src']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.language',search_for.language,q['lang']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.relation',search_for.relation,q['rel']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.coverage',search_for.coverage,q['cov']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.rights',search_for.rights,q['cr']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.comment',search_for.comment,q['co']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    st=Dbi_search_string.new('metadata.abstract',search_for.abstract,q['ab']).string
+    if st[:flag]
+      search[:text]                    << st[:search]
+      search[:endnotes]                << st[:search]
+    end
+    @search_text,@search_endnotes=Array.new,Array.new
+                                                                           #%
+    search[:text].each{|x| @search_text << "#{x} AND " }
+    search[:endnotes].each{|x| @search_endnotes << "#{x} AND " }
+    @search_text=@search_text.to_s.gsub!(/AND\s+$/,'')
+    @search_endnotes=@search_endnotes.to_s.gsub!(/AND\s+$/,'')
+  end
+  def sql_select_body
+    %{SELECT metadata.title, metadata.creator, metadata.filename, metadata.suffix, documents.body, documents.seg, documents.ocn, metadata.tid FROM documents, metadata WHERE #{@search_text} AND documents.metadata_tid = metadata.tid ORDER BY metadata.title, documents.ocn ;}
+  end
+  def sql_select_endnotes
+    %{SELECT metadata.title, metadata.creator, metadata.filename, endnotes.body, endnotes.nr, endnotes.ocn, endnotes.metadata_tid FROM metadata, endnotes WHERE #{@search_endnotes} AND metadata.tid = endnotes.metadata_tid ORDER BY metadata.title, endnotes.nr ;}
+  end
+  def sql_select_body_format
+    %{<font color="#666666" size="2">#{sql_select_body}</font>} 
+  end
+  def sql_select_endnotes_format
+    %{<font color="#666666" size="2">#{sql_select_endnotes}</font>} 
+  end
+  def contents
+    @conn.select_all(sql_select_body)
+  end
+  def endnotes
+    @conn.select_all(sql_select_endnotes)
+  end
+end
+class Tail
+  def tail
+    <<-'WOK'
+<br /><hr /><br />
+<center><table align="center"bgcolor="#ffffff"><tr><td><font color="#666666"><table summary="" bgcolor="#ffffff" cellpadding="4" border="0" align="center">
+
+<tr align="center">
+  <td align="center"><p class="center"><font color="#666666" size="2">
+  presentations' look and feel<br />
+  generated by<br />
+  <a href="http://www.jus.uio.no/sisu" ><img border="0" src="http://corundum:8081/_sisu/image/sisu.png" alt="SiSU on Debian/Gnu/Linux or a FreeBSD &amp; Ruby - better ways, well actually, Way Better!" width="120" height="38"></a><br />
+  <a href="http://www.jus.uio.no/sisu" >SiSU</a><br />
+  version 0.36<br />2006w07/6 (20060218)<br />
+
+  <table summary="SiSU rights" bgcolor="#ffffff" cellpadding="4" border="0" align="center" width="40%">
+    <sup>&copy;</sup> Ralph Amissah<br />
+  1993, current 2006<br />
+  GPL 2<br />
+  <i>w3 since October 3 1993</i><br />
+  <a href="mailto://ralph@amissah.com" >ralph@amissah.com</a><br />
+</font></p>
+</td></tr></table>
+
+<p><center><font color="#666666" size="2">Developed<br />using <a href="http://www.ruby-lang.org/en/">Ruby</a><br />on <a href="http://www.debian.org/">Debian/Gnu/Linux</a> software infrastructure,<br />with the usual GPL (or OSS) suspects.<br />Better - "performance, reliability, scalability, security<br />& total cost of ownership"<br />[not to mention flexibility &amp; choice]<br /><br />&lt;&lt;<a href="http://www.jus.uio.no/sisu/">Way Better!</a>&gt;&gt;</font></center></p><tr align="center"><td align="center">
+
+<table summary="browser suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+<tr>
+  <td><p><font color="#666666" size="2">
+    If you have problems viewing pages on this site please update your browser:
+  </font></p>
+</td></tr></table>
+
+<table summary="browser suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+<tr><td>
+<p>
+<font color="#666666" size="2">
+If you have problems viewing pages on this site please update your browser:
+</font>
+</p>
+</td></tr>
+</table>
+
+<table summary="browser suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+<tr><td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.gnome.org/projects/epiphany/" target="external">
+<img border="0" width="25" height="25" src="http://corundum:8081/_sisu/image/gnome.png" alt="Epiphany">
+&nbsp;Epiphany
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://galeon.sourceforge.net/" target="external">
+<img border="0" width="24" height="24" src="http://corundum:8081/_sisu/image/galeon.png" alt="Galeon">
+&nbsp;Galeon
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.microsoft.com/windows/ie/default.asp" target="external">
+<img border="0" width="29" height="25" src="http://corundum:8081/_sisu/image/internet.explorer.png" alt="MS I-Explorer">
+I-Explorer
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://kazehakase.sourceforge.jp/" target="external">
+Kazehakase</a>
+<sup>&reg;</sup>&nbsp;|</font></p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.konqueror.org/" target="external">
+<img border="0" width="29" height="25" src="http://corundum:8081/_sisu/image/konqueror.png" alt="Konqueror">
+Konqueror</a>
+<sup>&reg;</sup>&nbsp;|</font></p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.mozilla.org/" target="external">
+<img border="0" width="30" height="24" src="http://corundum:8081/_sisu/image/mozilla.png" alt="Mozilla">
+Mozilla
+</a>
+<a href="http://www.mozilla.org/products/firefox/" target="external">
+<img border="0" width="25" height="25" src="http://corundum:8081/_sisu/image/firefox.png" alt="Firefox">
+<b>Firefox</b>
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://home.netscape.com/comprod/mirror/client_download.html" target="external">
+<img border="0" width="29" height="25" src="http://corundum:8081/_sisu/image/netscape.png" alt="Netscape">
+Netscape
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.opera.com/" target="external">
+<img border="0" width="29" height="25" src="http://corundum:8081/_sisu/image/opera.png" alt="Opera">
+Opera
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.apple.com/safari/" target="external">
+<img border="0" width="24" height="25" src="http://corundum:8081/_sisu/image/safari.png" alt="Safari">
+Safari
+</a>
+<sup>&reg;</sup>
+</font>
+</p>
+</td></tr>
+</table>
+
+<table summary="lightweight browser and text browser suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+<tr><td>
+<p>
+<font color="#666666" size="1">
+for console/text viewing:
+</font>
+</p>
+</td>
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://elinks.or.cz/" target="external">
+<b>elinks</b>
+</a>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://atrey.karlin.mff.cuni.cz/~clock/twibright/links" target="external">
+<b>links2</b>
+</a>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://w3m.sourceforge.net/" target="external">
+<b>w3m</b>
+</a>
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+for lightweight gui (X) viewing try:
+</font>
+</p>
+</td>
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.dillo.org/" target="external">
+Dillo
+</a>&nbsp;|</font></p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://www.gnome.org/projects/epiphany/" target="external">
+<img border="0" width="25" height="25" src="http://corundum:8081/_sisu/image/gnome.png" alt="Epiphany">
+&nbsp;Epiphany
+</a>
+<sup>&reg;</sup>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://galeon.sourceforge.net/" target="external">
+<img border="0" width="24" height="24" src="http://corundum:8081/_sisu/image/galeon.png" alt="Galeon">
+&nbsp;Galeon
+</a>&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p>
+<font color="#666666" size="1">
+<a href="http://atrey.karlin.mff.cuni.cz/~clock/twibright/links" target="external">
+<b>links2 -g</b>
+</a>
+</font>
+</p>
+</td></tr>
+</table>
+</td></tr>
+
+<tr align="center"><td align="center">
+
+<table summary="pdf viewer suggestions" bgcolor="#ffffff" cellpadding="4" border="0">
+
+<tr><td>
+<p class="center">
+<font color="#666666" size="1">
+&amp; for
+<a href="http://www.adobe.com/products/acrobat/adobepdf.html" target="external">
+pdf
+</a>
+viewings of this site we recommend stand alone viewers
+<br />
+(rather than web browser plugins):
+</font>
+</p>
+</td></tr>
+</table>
+
+<table summary="" bgcolor="#ffffff" cellpadding="4" border="0" align="center">
+<tr align="center"><td align="center">
+<p class="center">
+<font color="#666666" size="1">
+<a href="http://www.adobe.com/products/acrobat/readstep2.html" target="external">
+<img border="0" height="18" width="15" src="http://corundum:8081/_sisu/image/b_pdf.png" alt="Adobe Acrobat Reader">
+Acrobat Reader
+</a>
+<sup>&reg;</sup>
+&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p class="center">
+<font color="#666666" size="1">
+<a href="http://www.gnome.org/projects/evince/" target="external">
+<img border="0" width="25" height="25" src="http://corundum:8081/_sisu/image/gnome.png" alt="Evince">
+<b>Evince</b>
+</a>
+<sup>&reg;</sup>
+</font>
+</p>
+</td>
+
+<td>
+<p class="center"><font color="#666666" size="1">
+<a href="http://www.cs.wisc.edu/~ghost/gv/" target="external">
+&nbsp;GhostView<sup>&reg;</sup>&nbsp;</a>,
+<a href="http://wwwthep.physik.uni-mainz.de/~plass/gv/" target="external">
+GV<sup>&reg;</sup>
+</a>
+&amp;
+<a href="http://www.cs.wisc.edu/~ghost/gsview/" target="external">
+GSview<sup>&reg;</sup>
+</a>
+&nbsp;|
+</font>
+</p>
+</td>
+
+<td>
+<p class="center">
+<font color="#666666" size="1">
+<a href="http://www.foolabs.com/xpdf/" target="external">
+<img border="0" width="16" height="16" src="http://corundum:8081/_sisu/image/xpdf.png" alt="Xpdf">
+&nbsp;Xpdf
+</a>
+<sup>&reg;</sup>
+</font>
+</p>
+</td></tr>
+</table>
+
+</font></center></td></tr></table></center> <a name="bottom" id="bottom"></a><a name="down" id="down"></a><a name="end" id="end"></a><a name="finish" id="finish"></a><a name="stop" id="stop"></a><a name="credits" id="credits"></a>
+</body></html>
+WOK
+  end
+end
+@counter_txt_doc,@counter_txt_ocn,@counter_endn_doc,@counter_endn_ocn=0,0,0,0
+@counters_txt,@counters_endn,@sql_select_body,@sql_select_endnotes='','','',''
+FCGI.each_cgi do |cgi|
+  begin # all code goes in begin section
+    @search=Hash.new
+    @search[:text],@search[:endnotes]=Array.new,Array.new
+    q=CGI.new
+    @db=if cgi['db'] =~/\S+/: 
+      @stub=/SiSU_(\S+)/.match(cgi['db'])[1] 
+      cgi['db']
+    else
+      @stub='sisu'
+      'SiSU_sisu'
+    end
+    checked_url,checked_searched,checked_tip,checked_echo,checked_sql,checked_all,checked_none,checked_ignore,selected_db='','','','','','','',''
+    if cgi['view']=~/text/: checked_index,checked_text='','checked'
+    else                    checked_index,checked_text='checked',''
+    end
+    checked_url='checked' if cgi['url'] =~/\S/ or cgi['u'].to_i==1 
+    checked_searched='checked' if cgi['searched'] =~/\S/ 
+    checked_tip='checked' if cgi['tip'] =~/\S/ 
+    checked_echo='checked' if cgi['echo'] =~/\S/ 
+    checked_sql='checked' if cgi['sql'] =~/\S/ 
+    if cgi['checks'] =~/check_all/ or cgi['check_all'] =~/\S/ or cgi['a'].to_i==1 
+      checked_all=checked_url=checked_searched=checked_tip=checked_echo=checked_sql='checked'
+      checked_none='' 
+    elsif cgi['checks'] =~/check_none/ #or cgi['a'].to_i==0 
+      checked_none='checked'
+      checked_all=checked_url=checked_searched=checked_tip=checked_echo=checked_sql='' 
+    else checked_ignore='checked'
+    end
+    selected_db=case cgi['db']
+     when /SiSU_document_samples_sisu_markup/: '<option value="SiSU_document_samples_sisu_markup">document_samples_sisu_markup</option>'
+     when /SiSU_sisu/: '<option value="SiSU_sisu">sisu</option>'
+    end
+    db_name='sisu_sqlite.db'
+    db_sqlite=case cgi['db']
+    when /SiSU_document_samples_sisu_markup/:                      "/home/ralph/sisu_www/document_samples_sisu_markup/sisu_sqlite.db"
+    when /SiSU_sisu/:                      "/home/ralph/sisu_www/sisu/sisu_sqlite.db"
+    end
+    @dbi="DBI:SQLite:#{db_sqlite}" #sqlite3 ?
+    @conn=DBI.connect(@dbi) 
+    search_field=cgi['find'] if cgi['find'] # =~/\S+/
+    @search_for=Search_request.new(search_field,q) #.analyze               #% search_for
+                                                                           #% searches
+    #Canned_search.new(@base,@search_for.text1,cgi)
+    if @search_for.text1=~/\S+/ or @search_for.author=~/\S+/ #and search_field =~/\S/
+      s1='s1=' + CGI.escape(@search_for.text1) if @search_for.text1=~/\S/
+      key='key=' + CGI.escape(@search_for.keywords) if @search_for.keywords=~/\S/
+      ti='&ti=' + CGI.escape(@search_for.title) if @search_for.title=~/\S/
+      au='&au=' + CGI.escape(@search_for.author) if @search_for.author=~/\S/
+      sj='&sj=' + CGI.escape(@search_for.subject) if @search_for.subject=~/\S/
+      dsc='&dsc=' + CGI.escape(@search_for.description) if @search_for.description=~/\S/
+      pb='&pb=' + CGI.escape(@search_for.publisher) if @search_for.publisher=~/\S/
+      cntr='&cntr=' + CGI.escape(@search_for.contributor) if @search_for.contributor=~/\S/
+      dt='&dt=' + CGI.escape(@search_for.date) if @search_for.date=~/\S/
+      ty='&ty=' + CGI.escape(@search_for.type) if @search_for.type=~/\S/
+      id='&id=' + CGI.escape(@search_for.identifier) if @search_for.identifier=~/\S/
+      src='&src=' + CGI.escape(@search_for.source) if @search_for.source=~/\S/
+      lang='&lang=' + CGI.escape(@search_for.language) if @search_for.language=~/\S/
+      rel='&rel=' + CGI.escape(@search_for.relation) if @search_for.relation=~/\S/
+      cov='&cov=' + CGI.escape(@search_for.coverage) if @search_for.coverage=~/\S/
+      cr='&cr=' + CGI.escape(@search_for.rights) if @search_for.rights=~/\S/
+      co='&co=' + CGI.escape(@search_for.comment) if @search_for.comment=~/\S/
+      ab='&ab=' + CGI.escape(@search_for.abstract) if @search_for.abstract=~/\S/
+      dtc='&dtc=' + CGI.escape(@search_for.date_created) if @search_for.date_created=~/\S/
+      dti='&dti=' + CGI.escape(@search_for.date_issued) if @search_for.date_issued=~/\S/
+      dtm='&dtm=' + CGI.escape(@search_for.date_modified) if @search_for.date_modified=~/\S/
+      dta='&dta=' + CGI.escape(@search_for.date_available) if @search_for.date_available=~/\S/
+      dtv='&dtv=' + CGI.escape(@search_for.date_valid) if @search_for.date_valid=~/\S/
+      canned_search_url=if checked_all =~/checked/
+        "#@base?#{s1}#{key}#{ti}#{au}#{sj}#{dsc}#{pb}#{cntr}#{dt}#{ty}#{id}#{src}#{lang}#{rel}#{cov}#{cr}#{co}#{ab}#{dtc}#{dti}#{dtm}#{dta}#{dtv}&db=#{cgi['db']}&view=#{cgi['view']}&a=1"
+      else "#@base?#{s1}#{key}#{ti}#{au}#{sj}#{dsc}#{pb}#{cntr}#{dt}#{ty}#{id}#{src}#{lang}#{rel}#{cov}#{cr}#{co}#{ab}#{dtc}#{dti}#{dtm}#{dta}#{dtv}&db=#{cgi['db']}&view=#{cgi['view']}&u=1&e=1"
+      end      
+      @search[:text][1]=%{documents.clean~'#{@search_for.text1}'} #s1
+      @search[:endnotes][1]=%{endnotes.clean~'#{@search_for.text1}'} #s1
+      canned_note='previous search url:'
+    else
+      canned_search_url="#@base?s1=United+Nations&db=documents&view=index"
+      canned_note='search url example:'
+    end
+    if search_field =~/\S+/
+      analyze_format=search_field.gsub(/\s*\n/,'; ')
+    elsif checked_all =~/checked/ or checked_url =~/checked/
+      canned_search=canned_search_url.scan(/(?:s1|au|ti)=[^&]+/)
+      af=canned_search.join('; ')
+      af.gsub!(/s1=/,'text: ')
+      af.gsub!(/au=/,'author: ')
+      af.gsub!(/ti=/,'title: ')
+      af.gsub!(/%2B/,' ')
+      analyze_format=af
+      st=af.split(/\s*;\s*/)
+      search_field=st.join("\n")      
+    end
+    green=%{<font size="2" color="#004000">}
+    the_can=%{<font size="2" color="#666666">#{canned_note}<br> <a href="#{canned_search_url}">#{canned_search_url}</a></font><br>}
+    p_text=p_keywords=p_title=p_author=p_subject=p_description=p_publisher=p_contributor=p_date=p_type=p_format=p_identifier=p_source=p_language=p_relation=p_coverage=p_rights=p_comment=p_abstract=p_subject=''
+    p_text=%{text: #{green}#{@search_for.text1}</font><br>} if @search_for.text1 =~/\S+/
+    p_keywords=%{keywords: #{green}#{@search_for.keywords}</font><br>} if @search_for.keywords =~/\S+/
+    p_title=%{title: #{green}#{@search_for.title}</font><br>} if @search_for.title =~/\S+/
+    p_author=%{author: #{green}#{@search_for.author}</font><br>} if @search_for.author =~/\S+/
+    p_subject=%{subject: #{green}#{@search_for.subject}</font><br>} if @search_for.subject =~/\S+/
+    p_description=%{description: #{green}#{@search_for.description}</font><br>} if @search_for.description =~/\S+/
+    p_publisher=%{publisher: #{green}#{@search_for.publisher}</font><br>} if @search_for.publisher =~/\S+/
+    p_contributor=%{contributor: #{green}#{@search_for.contributor}</font><br>} if @search_for.contributor =~/\S+/
+    p_date=%{date: #{green}#{@search_for.date}</font><br>} if @search_for.date =~/\S+/
+    p_type=%{type: #{green}#{@search_for.type}</font><br>} if @search_for.type =~/\S+/
+    p_format=%{format: #{green}#{@search_for.format}</font><br>} if @search_for.format =~/\S+/
+    p_identifier=%{identifier: #{green}#{@search_for.identifier}</font><br>} if @search_for.identifier =~/\S+/
+    p_source=%{source: #{green}#{@search_for.source}</font><br>} if @search_for.source =~/\S+/
+    p_language=%{language: #{green}#{@search_for.language}</font><br>} if @search_for.language =~/\S+/
+    p_relation=%{relation: #{green}#{@search_for.relation}</font><br>} if @search_for.relation =~/\S+/
+    p_coverage=%{coverage: #{green}#{@search_for.coverage}</font><br>} if @search_for.coverage =~/\S+/
+    p_rights=%{rights: #{green}#{@search_for.rights}</font><br>} if @search_for.rights =~/\S+/
+    p_comment=%{comment: #{green}#{@search_for.comment}</font><br>} if @search_for.comment =~/\S+/
+    p_abstract=%{abstract: #{green}#{@search_for.abstract}</font><br>} if @search_for.abstract =~/\S+/
+    search_note=<<-WOK
+<font size="2" color="#666666">
+<br><b>previous selection</b>:<br>
+database: #{green}#@db</font>; selected view: #{green}#{cgi['view']}</font><br>
+search string: "#{green}#{analyze_format}</font>"<br>
+#{p_text} #{p_keywords} #{p_title} #{p_author} #{p_subject} #{p_description} #{p_publisher} #{p_contributor} #{p_date} #{p_type} #{p_format} #{p_identifier} #{p_source} #{p_language} #{p_relation} #{p_coverage} #{p_rights} #{p_comment} #{p_abstract}
+</font>
+WOK
+    #eg = %{canned search e.g.:<br> <a href="#{url}">#{url}</a><br>find: #{analyze}<br>database: #{database}}
+    #dbi_canning
+    @header=Form.new(@base,search_field,selected_db,checked_index,checked_text,checked_tip,checked_searched,checked_url,checked_echo,checked_sql,checked_all,checked_none,checked_ignore,search_note,the_can).submission_form #% form
+    @tail=Tail.new.tail
+    unless q['s1'] =~/\S/ or q['au'] =~/\S/ or @search[:text][1] =~/\S/ 
+      print "Content-type: text/html\n\n"
+      puts (@header+@tail)
+    else #% searches
+      s1=if @search_for.text1 =~/\S/
+        @search_for.text1
+      else 'Unavailable'
+      end
+      @search[:text]<<%{documents.clean~'#{CGI.unescape(s1)}'}
+      @search[:endnotes]<<%{endnotes.clean~'#{CGI.unescape(s1)}'}
+    #dbi_request
+      dbi_statement=Dbi_search_statement.new(@conn,@search_for,q)
+      @text_search_flag=false
+      @text_search_flag=dbi_statement.text_search_flag
+      s_contents=dbi_statement.contents
+      s_endnotes=dbi_statement.endnotes
+      @body_main=Array.new
+      @endnotes=Array.new
+      oldtid=0
+      if @text_search_flag 
+        if checked_sql =~/\S/
+          sql_select_body=dbi_statement.sql_select_body_format
+          sql_select_endnotes=dbi_statement.sql_select_endnotes_format
+        else sql_select_body,sql_select_endnotes='',''
+        end
+        @body_main << "<p><hr><br><b>Main Text:</b><br>" << sql_select_body
+        @endnotes  << "<p><hr><br><b>Endnotes:</b><br>"  << sql_select_endnotes
+      else
+      end
+      #text_objects_body
+      s_contents.each do |c|                                               #% text body
+        location=c["filename"][/(.+?)\.ss[ftm]/, 1]
+        file_suffix=c["filename"][/.+?\.(ss[ftm])/, 1]
+      #metadata_found_body
+        if c["tid"].to_i != oldtid.to_i
+          title=%{<a href="#@hosturl/#@stub/#{location}/">#{c["title"]}</a> by #{c["creator"]} <a href="#@hosturl/#@stub/#{location}/portrait.pdf"><img border="0" width="15" height="18" src="#@url_base/b_pdf.png" alt="pdf portrait"></a><a href="#@hosturl/#@stub/#{location}/landscape.pdf"><img border="0" width="18" height="15" src="#@url_base/b_pdf.png" alt="pdf landscape"></a><br>}  if file_suffix=~/s/ #hmm watch file_suffix
+           if @text_search_flag: title='<br><hr>'+title 
+           else                  title='<br>'+title 
+           end
+           @counter_txt_doc+=1
+           oldtid=c["tid"].to_i
+          else                    title=''
+          end
+          if @text_search_flag 
+            if cgi['view']=~/text/                                         #% txt body
+              text=if c["suffix"] !~/1/ #seg
+                if @search_for.text1 =~/\S+/ or q['s1'] =~/\S+/                         #% only this branch is working !!
+                  if @search_for.text1 =~/\S+/:     unescaped_search=CGI.unescape(@search_for.text1)
+                  elsif q['s1'] =~/\S+/:           unescaped_search=CGI.unescape(q['s1'])
+                  end
+                  search_regex=Array.new
+                  build=unescaped_search.scan(/\S+/).each do |g|
+                     if g.to_s =~/(AND|OR)/
+                       search_regex << '|'
+                     else search_regex << %{#{g.to_s}}
+                     end
+                  end
+                  search_regex=search_regex.join(' ')
+                  search_regex=search_regex.gsub(/\s*\|\s*/,'|')
+                  @search_regx=search_regex.to_s
+                end
+                matched_para=c["body"].gsub(/(#@search_regx)/i,%{<span style="background-color: #ffff48">\\1</span>})
+                %{<hr><p><font size="2">ocn <b><a href="#@hosturl/#@stub/#{location}/#{c["seg"]}.html##{c["ocn"]}">#{c["ocn"]}</a></b>:</font></p>#{matched_para}} 
+              elsif c["suffix"] =~/1/ #doc
+                %{#{title}<hr><p><font size="2">ocn #{c["ocn"]}:#{c["body"]}}
+              end
+              @counter_txt_ocn+=1
+              output=if c["seg"] =~/\S+/: title+text
+              else                        text 
+              end
+            elsif cgi['view']=~/index/                                     #% idx body
+              if c["suffix"] !~/1/ #seg
+                index=%{<a href="#@hosturl/#@stub/#{location}/#{c["seg"]}.html##{c["ocn"]}">#{c["ocn"]}</a>, } if @text_search_flag 
+              elsif c["suffix"] =~/1/ #doc
+                index=%{<a href="#@hosturl/#@stub/#{location}/doc.html##{c["ocn"]}">#{c["ocn"]}</a>, } 
+              end
+              if c["seg"] =~/\S+/ 
+                if @text_search_flag 
+                  @counter_txt_ocn+=1
+                  output=title+index
+                end
+              else
+                @counter_txt_ocn+=1
+                output=unless c["suffix"] =~/1/: title+index
+                else %{#{title}#{c["ocn"].sort}, }
+                end
+              end
+            end
+          else output=title 
+          end 
+        @counters_txt=if @counter_txt_doc > 0
+          %{<font size="2" color="#666666">Found in the main body of #@counter_txt_doc documents, and at #@counter_txt_ocn locations within.</font><br />}
+        else ''
+        end
+        @body_main << output #+ details
+      end
+      #text_objects_endnote
+      oldtid = 0
+      s_endnotes.each do |e|                                               #% endnotes
+        location=e["filename"][/(.+?)\.ss[ftm]/, 1]
+        file_suffix=e["filename"][/.+?\.(ss[ftm])/, 1]
+      #metadata_found_endnotes
+        if @text_search_flag
+          if e["metadata_tid"].to_i != oldtid.to_i 
+            title=%{<br><hr><a href="#@hosturl/#@stub/#{location}/">#{e["title"]}</a> by #{e["creator"]} <a href="#@hosturl/#@stub/#{location}/portrait.pdf"><img border="0" width="15" height="18" src="#@url_base/b_pdf.png" alt="pdf portrait"></a><a href="#@hosturl/#@stub/#{location}/landscape.pdf"><img border="0" width="18" height="15" src="#@url_base/b_pdf.png" alt="pdf landscape"></a><br>}  if file_suffix=~/s/
+            @counter_endn_doc+=1
+            oldtid=e["metadata_tid"].to_i
+          else title = ''
+          end
+          if cgi['view']=~/text/                                           #% txt endnotes
+            @counter_endn_ocn+=1
+            matched_endnote=e["body"].gsub(/(#@search_regx)/i,%{<span style="background-color: #ffff48">\\1</span>})
+            output=%{#{title}<hr><font size="2">note <b><a href="#@hosturl/#@stub/#{location}/endnotes.html##{e["nr"]}">#{e["nr"]}</a></b> referred to from ocn <a href="#@hosturl/#@stub/#{location}/doc.html##{e["ocn"]}">#{e["ocn"]}</a>:</font> #{matched_endnote}} 
+          elsif cgi['view']=~/index/                                       #% idx endnotes
+            @counter_endn_ocn+=1
+            output=%{#{title}<a href="#@hosturl/#@stub/#{location}/endnotes.html#_#{e["nr"]}">#{e["nr"]}</a> [&sect; <a href="#@hosturl/#@stub/#{location}/doc.html##{e["ocn"]}">#{e["ocn"]}</a>], }
+          end
+          @counters_endn=if @counter_endn_doc > 0
+          %{<font size="2" color="#666666">Found in the endnotes of #@counter_endn_doc documents, and at #@counter_endn_ocn locations within.</font><br />}
+          end
+          @endnotes << output #+ details
+        else @endnotes=Array.new #does not take out yet
+        end
+      end
+      cgi.out{@header + @counters_txt + @counters_endn + @body_main.join + @endnotes.join + @tail} #% print cgi_output_header+counters+body+endnotes
+    end
+  rescue Exception => e
+    s='<pre>' + CGI::escapeHTML(e.backtrace.reverse.join("\n"))
+    s << CGI::escapeHTML(e.message) + '</pre>'
+    cgi.out{s}
+    next
+  ensure # eg. disconnect from server
+    @conn.disconnect if @conn
+  end
+end
diff --git a/data/sisu/conf/completion/README b/data/sisu/conf/completion/README
new file mode 100644
index 00000000..d723a140
--- /dev/null
+++ b/data/sisu/conf/completion/README
@@ -0,0 +1,7 @@
+_sisu (naive zsh completion for SiSU)
+  on Debian file is located at /usr/share/sisu/conf/completion
+  installation: works if copied somewhere within your $fpath
+    do it yourself on Debian copy to ~/.zfunc or
+    /usr/local/share/zsh/site-functions and run compinit
+
+  note zsh is not installed by default on a Debian system
diff --git a/data/sisu/conf/completion/_sisu b/data/sisu/conf/completion/_sisu
new file mode 100644
index 00000000..076795cb
--- /dev/null
+++ b/data/sisu/conf/completion/_sisu
@@ -0,0 +1,64 @@
+#compdef sisu
+# Copyright (C) 2006 Ralph Amissah
+# sisu, version 0.46.1
+# same license as Zsh or SiSU
+local curcontext="$curcontext" state line ret=1
+typeset -A opt_args
+_arguments -s -C -M 'r:|[_-]=* r:|=*' \
+  '(--convert --to -C)-U[prints to screen url output map of available output possibilities]' \
+  '(--convert --to -C)-u[url mapping of output files for requested processing flags]' \
+  '(--convert --to -C)-V[more verbose than -v]' \
+  '(--convert --to -C)-v[verbose]' \
+  '--no-ocn[-\[hHp\]switches off object citation numbering]' \
+  '--no-annotate[-\[mhHpoxXabN\] strips output text of additional editors endnotes]' \
+  '(--convert --to -C)-A[plaintext with dos line-feeds, footnotes follow paragraphs in which they occur]' \
+  '(--convert --to -C)-a[plaintext with Unix line-feeds, footnotes follow paragraphs in which they occur]' \
+  '(--convert --to -C)-b[XHTML output]' \
+  '(- *)-C[initialise site]' \
+  '(--convert --to -C)-c[toggle screen color on or off depending on set default]' \
+  '(--convert --to -C)-E[plaintext with dos line-feeds, endnotes following main text]' \
+  '(--convert --to -C)-e[plaintext with Unix line-feeds, endnotes following main text]' \
+  '(--convert --to -C)-F[generate sample cgi web search form \[--webserv=webrick for sisu webrick url\]]' \
+  '(--convert --to -C -h)-H[HTML output, without link suffixes]' \
+  '(--convert --to -C -H)-h[HTML output]' \
+  '(--convert --to -C)-I[texinfo output, not maintained]' \
+  '(--convert --to -C)-L[print license info]' \
+  '(--convert --to -C)-M[maintenance mode, retain intermediate processing files]' \
+  '(--convert --to -C)-m[create intermediate markup file, metaverse, assumed for most output instuctions]' \
+  '(--convert --to -C)-N[document content certificate, output document digests]' \
+  '(--convert --to -C)-n[skip intermediate markup, skip -m]' \
+  '(--convert --to -C)-o[Open Document text format output]' \
+  '(--convert --to -C)-p[LaTeX pdf output]' \
+  '(--convert --to -C)-q[quiet mode]' \
+  '(--convert --to -C)-R[post output to remote host using rsync, requires pre-configuration]' \
+  '(--convert --to -C)-r[post output to remote host using scp, requires pre-configuration]' \
+  '(--convert --to -C)-S[produces and shares tarred gzipped markup source document with associated images etc.]' \
+  '(--convert --to -C)-s[shares markup source]' \
+  '(--convert --to -C)-t[termsheet, preprocessing]' \
+  '(- *)-W[starts ruby webrick server]' \
+  '(--convert --to -C)-w[concordance file]' \
+  '(--convert --to -C)-X[XML dom style]' \
+  '(--convert --to -C)-x[XML sax style]' \
+  '(--convert --to -C)-y[output summary page, manifest of existing generated output]' \
+  '(--convert --to -C)-Z[Zap delete/destroy output]' \
+  '--import[-\[Dd\] imports document to database]' \
+  '--update[-\[Dd\] updates document in database]' \
+  '--remove[-\[Dd\] removes document from database]' \
+  '--dropall[-\[Dd\] drops database, tables, indexes, all!]' \
+  '--create[-\[Dd\] creates new database - tables, indexes, etc.]' \
+  '--recreate[-\[Dd\] drops database, killing data and creates new empty database - tables, indexes, etc.]' \
+  '(--convert --to -C)-D[postgresql database instruction]' \
+  '(--convert --to -C)-d[sqlite database instruction]' \
+  '(- *)--help[display help information]' \
+  '(--convert --to -C -2 -3 -4 -5)-1[shortcut, initial default -mNHwpy]' \
+  '(--convert --to -C -1 -3 -4 -5)-2[shortcut, initial default -mNHwpaoy]' \
+  '(--convert --to -C -1 -2 -4 -5)-3[shortcut, initial default -mNHwpaobxXy]' \
+  '(--convert --to -C -1 -2 -3 -5)-4[shortcut, initial default -mNHwpaobxXDy --import]' \
+  '(--convert --to -C -1 -2 -3 -4)-5[shortcut, initial default -mNHwpaobxXDy --update]' \
+  '--to=node[XML node based input representation, experimental]' \
+  '--to=sax[XML sax based input representation, experimental]' \
+  '--to=dom[XML dom based input representation, experimental]' \
+  '--convert=footnotes[embedded footnotes]' \
+  '--to=current[current markup]' \
+  '--to=xml2sst[from sisu xml to sst]' \
+  '*:SiSU files:_files -g "*.(sst|ssm)(.)"'
diff --git a/data/sisu/conf/convert/kdissert_to_sisu b/data/sisu/conf/convert/kdissert_to_sisu
new file mode 100644
index 00000000..aa651f80
--- /dev/null
+++ b/data/sisu/conf/convert/kdissert_to_sisu
@@ -0,0 +1,161 @@
+#!/usr/bin/env ruby
+=begin
+ * Name: modify.rb
+ * Author: Ralph Amissah
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+ * Description: Conversion script from kdissert .kdi to sisu markup .sst
+ * Copyright (C) 2004, 2006 Ralph Amissah
+ * Packaged with: SiSU information Structuring Universe -
+     Structured information, Serialized Units
+ * SiSU Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Ralph Amissah
+
+ * License: GPL 2 or later
+
+  Summary of GPL 2
+
+  This program is free software; you can redistribute it and/or modify it
+  under the terms of the GNU General Public License as published by the Free
+  Software Foundation; either version 2 of the License, or (at your option)
+  any later version.
+
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+  more details.
+
+  You should have received a copy of the GNU General Public License along
+  with this program; if not, write to the Free Software Foundation, Inc.,
+  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+  If you have Internet connection, the latest version of the GPL should be
+  available at these locations:
+    http://www.fsf.org/licenses/gpl.html
+    http://www.gnu.org/copyleft/gpl.html
+    http://www.jus.uio.no/sisu/gpl2.fsf
+  
+  © Ralph Amissah 1997, current 2006.
+  All Rights Reserved.
+
+ * Ralph Amissah: ralph@amissah.com
+                  ralph.amissah@gmail.com
+=end
+require 'rexml/document'
+include REXML
+argv=$*
+@sisu,@sisu_base=Array.new,Array.new
+unless argv.empty?
+  argv.each do |kdi|
+    if kdi =~/\.kdi$/
+      system("cp #{kdi} #{kdi}.tar.gz && tar xzvf #{kdi}.tar.gz && rm #{kdi}.tar.gz")
+      file=File.new("maindoc.xml")
+      #system("cp #{kdi} /tmp/. && cd /tmp && tar xzvf /tmp/#{kdi} && cd -")
+      #file=File.new("/tmp/maindoc.xml")
+      @output=File.new("#{kdi}.sst",'w')
+      doc=Document.new(file)
+      root=doc.root
+      @el=Array.new
+      root.each do |x|
+      end
+      root.each_with_index do |content,idx|
+        if root.elements["item[#{idx}]/summary"]
+          id,ma,ch=nil,nil,Array.new
+          if root.elements["item[#{idx}]/id"]
+            id=root.elements["item[#{idx}]/id"].text.to_i
+          end
+          if root.elements["item[#{idx}]/parent"]
+            ma=root.elements["item[#{idx}]/parent"].text.to_s
+          end
+          if root.elements["item[#{idx}]/child"] #problem only get one child, even where several
+            root.get_elements("item[#{idx}]/child").each do |x|
+              ch << x.text
+            end
+          end
+          if root.elements["item[#{idx}]/summary"]
+            sum=root.elements["item[#{idx}]/summary"].text.to_s.strip
+          end
+          if root.elements["item[#{idx}]/text"]
+            txt=root.elements["item[#{idx}]/text"].text.to_s.strip
+          end
+          @el[id]=Hash.new
+          @el[id][:id]=id
+          @el[id][:ma]=ma
+          @el[id][:ch]=ch
+          @el[id][:sum]=sum
+          @el[id][:txt]=txt
+          if ma == '-1'
+            @el[id][:lev]=':A'
+            @top=id
+          end
+        end
+      end  
+      @doc=Array.new
+      @title=@el[@top][:sum]
+      p @el[@top][:sum]
+      @doc << ':A~ ' + @el[@top][:sum]
+      @el[@top][:ch].each do |x|
+        @el[x.to_i][:lev]='1'
+        @doc << '1~ ' + @el[x.to_i][:sum]
+        @doc << @el[x.to_i][:txt]
+        @el[x.to_i][:ch].each do |y|
+          @el[y.to_i][:lev]='2'
+          @doc << '2~ ' + @el[y.to_i][:sum]
+          @doc << @el[y.to_i][:txt]
+          @el[y.to_i][:ch].each do |z|
+            @el[z.to_i][:lev]='3'
+            @doc << '3~ ' + @el[z.to_i][:sum]
+            @doc << @el[z.to_i][:txt]
+            @el[z.to_i][:ch].each do |za|  #unsupported... consder
+              @el[za.to_i][:lev]='4'
+              @doc << '!_ ' + @el[za.to_i][:sum]
+              @doc << @el[za.to_i][:txt]
+            end
+          end
+        end
+      end
+      #@el.each_with_index do |x,i|
+      #  if x: puts "#{i}: lev: #{x[:lev]}, id: #{x[:id]}, ma: #{x[:ma]}, ch: #{x[:ch].join(',')}"
+      #  end
+      #end
+# regexs strip most kdissert markup, and provide minimal info for sisu markup -->       
+      @doc.each do |c,idx|
+        c.gsub!(/<\/summary>/,'')
+        c.gsub!(/<html>.+?\n|<\/body>|<\/html>|<p>/m,'')
+        c.gsub!(/<\/p>/,"\n")
+        c.gsub!(/<span style="font-weight:600">(.+?)<\/span>/," *{ \\1 }* ")
+        c.gsub!(/<span style="text-decoration:underline">(.+?)<\/span>/," _{ \\1 }_ ")
+        c.gsub!(/<span style="font-style:italic">(.+?)<\/span>/," /{ \\1 }/ ")
+        c.gsub!(/<ul type="disc">/,'_* ')
+        c.gsub!(/<\S+?>/,'')
+        c.gsub!(/&lt;(:p[bn])&gt;/,"<\\1>")
+        c.gsub!(/&lt;&lt;(|.?|@|.?|)/,"<<\\1")
+        c.gsub!(/&quot;/,'"')
+        c.gsub!(/ \s+/,' ')
+        @sisu_base << c.strip + "\n\n"
+      end  
+    else puts ".kdi extension expected, filename not recognised: << #{kdi} >>"
+    end
+  end
+else puts '.kdi file for conversion to sisu expected'
+end
+sisu_head=<<WOK
+% converted from Kdissert to SiSU
+
+@title: #@title
+
+@prefix: Kdissert mind/topic mapping auto conversion to SiSU markup
+
+@links: {Kdissert}http://freehackers.org/~tnagy/kdissert/
+
+@base_program: kdissert
+
+% @date: 
+
+@rcs: $Id$
+
+@level: num_top=1
+
+WOK
+#puts @sisu_base
+@output << sisu_head << @sisu_base
+__END__
diff --git a/data/sisu/conf/convert/modify.rb b/data/sisu/conf/convert/modify.rb
new file mode 100644
index 00000000..f00da1a9
--- /dev/null
+++ b/data/sisu/conf/convert/modify.rb
@@ -0,0 +1,250 @@
+#!/usr/bin/env ruby
+=begin
+ * Name: modify.rb
+ * Author: Ralph Amissah
+   * http://www.jus.uio.no/sisu
+   * http://www.jus.uio.no/sisu/SiSU/download
+ * Description: A conversion script for canned substitutions,
+     a fairly generic simple tool that can be used to store other canned conversions,
+     used here for altering SiSU markup
+ * Copyright (C) 2004, 2006 Ralph Amissah
+ * Packaged with: SiSU information Structuring Universe -
+     Structured information, Serialized Units
+ * SiSU Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Ralph Amissah
+
+ * License: GPL 2 or later
+
+  Summary of GPL 2
+
+  This program is free software; you can redistribute it and/or modify it
+  under the terms of the GNU General Public License as published by the Free
+  Software Foundation; either version 2 of the License, or (at your option)
+  any later version.
+
+  This program is distributed in the hope that it will be useful, but WITHOUT
+  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+  more details.
+
+  You should have received a copy of the GNU General Public License along
+  with this program; if not, write to the Free Software Foundation, Inc.,
+  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
+
+  If you have Internet connection, the latest version of the GPL should be
+  available at these locations:
+    http://www.fsf.org/licenses/gpl.html
+    http://www.gnu.org/copyleft/gpl.html
+    http://www.jus.uio.no/sisu/gpl2.fsf
+  
+  © Ralph Amissah 1997, current 2006.
+  All Rights Reserved.
+
+ * Ralph Amissah: ralph@amissah.com
+                  ralph.amissah@gmail.com
+
+ * Notes: configure rc in ~/.sisu/sisurc.yaml
+=end
+module SiSU_Modify
+  class Convert_markup
+    def initialize(cf,files)
+      @cf,@files=cf,files
+      @description="This is a script that contains canned text conversions for reuse"
+    end
+    def current_match_and_replace #Disable, edit manually
+      #convert_pre_37_to_38_experimental
+    end
+    def message(text)
+      response=''
+      while response !~/yes/
+        print %{
+    #{text}
+    to continue type "yes" [to exit type "no" or "quit"]: }
+        response=File.new('/dev/tty').gets.strip
+        exit if response =~/^(?:quit|no)$/
+      end
+    end
+    def help
+    print <<WOK
+
+#@description
+
+modify.rb --default [filename/wildcard]
+  performs the current default conversion that is set
+  [handle with care, (may be disabled)]
+
+modify.rb --to38 [filename/wildcard]
+  converts pre 0.37 sisu markup to 0.38 experimental
+
+modify.rb --to37 [filename/wildcard]
+  converts pre 0.37 sisu markup to 0.38 experimental
+
+note converting twice in a single direction will result
+in markup inconsistency
+
+An alternative script has been introduced,
+try 'sisu --convert'
+
+modify.rb --default
+  performs the current default conversion that is set
+  on the files matched in default the settings
+  [handle with care, (may be disabled)]
+
+WOK
+      exit
+    end
+    #%% substitutions to be made
+    def convert_pre_37_to_38_experimental
+      message('convert sisu markup from 0.37 to 0.38 experimental (rad)')
+      [
+        [/^0~(\S+?)([+-])\s+/,    "@\\1:\\2 "],
+        [/^0~(\S+)\s+/,           "@\\1: "],
+        [/^@toc:\s+/,             "@structure: "],
+        [/^1~/,                   ':A~'],
+        [/^2~/,                   ':B~'],
+        [/^3~/,                   ':C~'],
+        [/^4~/,                   '1~'],
+        [/^5~/,                   '2~'],
+        [/^6~/,                   '3~']
+      ]
+    end
+    def convert_38_experimental_to_37
+      message('convert sisu markup from 0.38 experimental (rad) to 0.37')
+      [
+        [/^@(\S+?):([+-])\s+/,    "0~\\1\\2 "],
+        [/^@(\S+?):\s+/,          "0~\\1 "],
+        [/^0~structure\s+/,       "0~toc "],
+        [/^1~/,                   '4~'],
+        [/^2~/,                   '5~'],
+        [/^3~/,                   '6~'],
+        [/^:?A~/,                 '1~'],
+        [/^:?B~/,                 '2~'],
+        [/^:?C~/,                 '3~']
+      ]
+    end
+    def markup_version?(i)
+      file=File.open(i,'r')
+      cont=file.readlines
+      file.close
+      markup_version=nil
+      cont.each do |y|
+        if y =~/^:?A~/
+          markup_version='0.38'
+          break
+        end
+        if y =~/^1~/
+          markup_version='0.37'
+          break
+        end
+        #if y =~/^1{~/
+        #  markup_version='0.16'
+        #  break
+        #end
+        markup_version='0.37'
+      end
+      markup_version
+    end
+    def conversion
+      #%% do it                                   -------------------------->
+      if @files and @files.length > 0
+        p @files
+        mr=nil
+        #%% changes to make m match, r replace      -------------------------->
+        if @cf =~/--help/: help
+        else
+          message("WARNING, proceed at your own risk,\npermanent changes requested for the above named files\n  best that you check (manually) what this file is set to do\n  conversions set are at the top of the file")
+          mr=case @cf
+          when /--convert|default/:     current_match_and_replace
+          when /--(?:(?:37)?to38|rad)/: convert_pre_37_to_38_experimental
+          when /--(?:(?:38)?to37)/:     convert_38_experimental_to_37
+          else help
+          end
+        end
+        match_and_replace=mr
+        #start_processing =/not used in this example/i
+        end_processing =/END\s+OF\s+FILE/
+        @files.each do |i|
+          @new,@matched,@flag_start,@flag_end,@empty1,@empty2=true,false,false,false,false,false
+          o="#{i}.bk" #o is for old
+          file=File.open(i,'r')
+          cont=file.readlines
+          file.close
+          cont.each do |y|
+          #p y
+          #p y if y =~/^[1-6]~/
+            match_and_replace.each do |m,r|
+              if y =~m
+                if @new
+                  @new=false
+                  File.unlink(o) if File.exists?(o)
+                  #system("lv #{i} > #{o}")
+                  File.rename(i,o)
+                  File.unlink(i) if File.exists?(i)
+        	    @file=File.new(i,'w')
+                  @matched=true
+                  break
+                end
+              end
+            end
+          end
+          if @matched
+            puts "match in #{i}"
+            @flag_start=true
+            cont.each do |y|
+              if y =~end_processing: @flag_end=true
+              end
+              if @flag_start and not @flag_end
+                match_and_replace.each do |m,r|
+                  if y =~m
+                    p m.to_s + ' -> ' + r
+                    puts "in:  #{y}"
+                    y.gsub!(m,r) if m and r
+                    puts "out: #{y}"
+                  end
+                end
+              end
+              #if y =~start_processing: @flag_start=true
+              #end
+              #if y =~m1
+              #end
+              if y=~/^\s*$/: @empty1=true
+              else           @empty1=false
+              end
+              @file.puts y unless (@empty1==true and @empty2==true)
+              if y=~/^\s*$/: @empty2=true
+              else           @empty2=false
+              end
+              #@file << y + "\n"
+            end
+            @file.close
+          else puts "NO match in #{f}"
+          end
+        end
+      else puts "this routine makes permanent changes to the contents of the files matched, as instructed within [no matches]"
+      end
+    end
+  end
+end
+#%% files to match for this conversion set  ------------------------->
+f=$*
+p $*
+cf=f[0].to_s
+f.shift
+match_and_replace=Array.new
+#unless cf and cf =~/--/
+#  puts <<WOK
+#
+##@description
+#
+#usage:
+#  modify.rb --convert [filename/wildcard]
+#for help
+#  modify.rb --help
+#WOK
+#  exit
+#end
+unless f.length > 0: f=Dir.glob("[a-z]*.ss?")  #restricted to sisu type files, it need not be
+end
+#f=Dir.glob("{bin,conf,data,lib}/**/*.rb")     #sisu development
+#f=Dir.glob("[^_]/**/*")                       #all files subdirectories beneath pwd except those starting with _
+SiSU_Modify::Convert_markup.new(cf,f).conversion
+__END__
diff --git a/data/sisu/conf/convert/sisu_convert b/data/sisu/conf/convert/sisu_convert
new file mode 100644
index 00000000..d7876083
--- /dev/null
+++ b/data/sisu/conf/convert/sisu_convert
@@ -0,0 +1,392 @@
+#!/usr/bin/env ruby
+# = sisu - SiSU information Structuring Universe
+#
+# Copyright (c) Ralph Amissah 1997,2004
+#
+# Ralph Amissah mailto:ralph@amissah.com
+#
+# * Name: SiSU information Structuring Universe   
+# * Author: Ralph@Amissah.com
+# * Description: document conversion tool, to sisu from other formats
+#   * arch-tag: document conversion tool to sisu markup
+#   * $Date: 2004/10/16 15:51:06 $
+#   * $Id: sisu_convert,v 1.37 2004/10/16 15:51:06 ralph Exp $
+# *  License: GPL 2 or later
+# * Notes: word conversion uses wvWare and wvSiSU.xml (a modified/stripped wvHtml.xml) 
+#   * http://wvware.sourceforge.net/
+#   * http://sourceforge.net/projects/wvware
+# * <url:sisu.lnk>|sisu.lnk|@|^| 
+# * <url:sisu>
+# * <url:zxy_param.rb>|zxy_param.rb|@|^| 
+module CONVERT
+  class MyOutput
+    def initialize(data, filename, instruct)
+      @data=data.compact
+      @filename=filename
+      @instruct=instruct
+    end
+	  def headerBasic
+      <<WOK
+0~title 
+
+0~subtitle 
+
+0~creator 
+
+0~type 
+
+0~subject
+
+0~date
+
+0~date.available
+
+0~publisher SiSU
+
+0~rights 
+
+0~level
+
+WOK
+	  end
+	  def headerDefault
+      <<WOK
+0~title 
+
+0~subtitle 
+
+0~creator 
+
+0~type 
+
+0~subject
+
+0~date
+
+0~date.available
+
+0~publisher SiSU
+
+0~rights ...
+
+WOK
+    end
+	  def hardOutput
+      pre = Array.new
+      case @instruct
+      when /default/
+        pre << headerDefault
+      else
+        pre << headerBasic
+      end
+	  	@filename_wv=File.new(%{,,#{@filename}.er9}, "w+")
+      @filename_wv << pre
+      @data.each do |x| 
+        y = x.split("\n")
+        y.each do |z| # cleaner output this way
+          z.strip!
+          @filename_wv.puts "#{z}\n\n" unless z =~/^$/
+        end
+      end
+	  end
+  end
+  class WareWord97
+    def initialize(data, filename, instruct)
+      @data=data
+      @filename=filename
+      @instruct=instruct
+    end
+	  def songsheet
+      data=@data
+    	print "Convert to SiSU file from Word97 << gvim ,,#{@filename}.er9 >\n" #: <<#{@@html_title}>>
+	    data=WareWord97.new(data.collect, @filename, @instruct).strip
+	    data=WareWord97.new(data.collect, @filename, @instruct).strip
+	    data=WareWord97.new(data.collect, @filename, @instruct).markup_rules
+	  	data=MyOutput.new(data.collect, @filename, @instruct).hardOutput
+	  end
+    def strip
+      data=@data
+      tuned_file=Array.new
+      endnote_no=1
+      data.each do |para|
+		  	para.strip!
+        para.gsub!(/<u>\s*<\/u>/, '')
+        para.gsub!(/<\/u>\s*<u>/, '')
+        para.gsub!(/<b>\s*<\/b>/, '')
+        para.gsub!(/<\/b>\s*<b>/, '')
+        para.gsub!(/<i>\s*<\/i>/, '')
+        para.gsub!(/<\/i>\s*<i>/, '')
+      	tuned_file << para unless para == nil
+		  end
+      tuned_file
+    end
+    def markup_rules
+      data=@data
+      tuned_file=Array.new
+      endnote_no=1
+      data.each do |para|
+		  	para.strip!
+        para.gsub!(/\s+/, ' ')
+        para.gsub!(/^<b>(Chapter|Article)(.+?)<\/b>/i, "4{ \\1 \\2") #watch case insensitivity
+        para.gsub!(/^<b>(Part|Section|Book)(.+?)<\/b>/i, "3{ \\1 \\2") #watch case insensitivity
+        para.gsub!(/^<b>(\d+\.\d+\.\d+)(.+?)<\/b>/i, "6{ \\1 \\2") #numeric, decide what to do, can be different
+        para.gsub!(/^<b>(\d+\.\d+)(.+?)<\/b>/i, "5{ \\1 \\2") #numeric, decide what to do, can be different
+        para.gsub!(/^<b>(\d+)(.+?)<\/b>/i, "4{ \\1 \\2") #numeric, decide what to do, can be different
+        para.gsub!(/<u>(.+?)<\/u>/, "_{\\1}_")
+        para.gsub!(/<b>(.+?)<\/b>/, "*{\\1}*")
+        para.gsub!(/<i>(.+?)<\/i>/, "/{\\1}/")
+      	tuned_file << para unless para == nil
+		  end
+      tuned_file
+    end
+  end
+  class Html
+    def initialize(data, filename, instruct)
+      @data=data
+      @filename=filename
+      @instruct=instruct
+    end
+	  def songsheet
+      data=@data
+    	print "Convert to SiSU file from #{@filename}.html << gvim ,,#{@filename}.er9 >\n" #: <<#{@@html_title}>>
+      #data=Html.new(data.collect, @filename, @instruct).space_paragraphs
+      #data=Html.new(data.split(''), @filename, @instruct).space_paragraphs
+      data=Html.new(data.split("\n"), @filename, @instruct).space_paragraphs
+      #data=Html.new(data.collect.join.split("\n"), @filename, @instruct).space_paragraphs
+      data=Html.new(data.collect, @filename, @instruct).multiline
+      data=Html.new(data.collect.join.split("\n\n"), @filename, @instruct).markup_rules
+	  	data=MyOutput.new(data.collect, @filename, @instruct).hardOutput
+	  end
+    def space_paragraphs
+      #data=@data.join.split(/\n/)
+      data=@data
+      #p data.length
+      tuned_file=Array.new
+      data.each do |para|
+		  	para.strip!
+        para.gsub!(/\r/, '')
+        #para.gsub!(/\n/, ' ') #PROBLEM, serious time issues on a few files also for \n (or multiline matches which is less surprising), edit out if necessary
+        para.gsub!(/<\/?p>/i, 'zZz')
+        para.gsub!(/<\/?\s*p(?:\s+ALIGN=.+?)?>/i, "zZz") #all manner of <p> para.gsub!(/<\/?p>/i, "\n\n")
+        para.gsub!(/<p\s+(class|align).+?>/i, "zZz") #
+        para.gsub!(/<\/p>/i, "zZz") # repeat actually
+        para.gsub!(/<(?:dir|tr|br)>/i, "zZz") #
+        #para.gsub!(/<(?:\/\s*)?(?:dir|tr|br)>/i, "zZz") #
+        para.gsub!(/(<\/center>)/i, "\\1zZz")
+        para.gsub!(/(<\/h[1-6]>)/i, "\\1zZz")
+        para.gsub!(/ \s+/i, ' ')
+        para.gsub!(/(?:\s*zZz\s*)+/i, "zZz") #
+      	tuned_file << para unless para == nil
+      end
+      tuned_file
+    end
+    def blockquotes(sub='') # SERIOUS PROBLEM INTRODUCED, some blockquotes go missing !, quite unacceptable, debug, for now not used
+      res=Array.new
+      sub.each do |x|
+        if x=~/(<\/blockquote>)/i
+          m = $1
+          res << x[/(.+?)#{m}/mi, 1].gsub!(/zZz/,"zZz_1 ") if x =~/.+?#{m}/mi 
+          res << x[/#{m}(.+)/mi, 1]
+        else
+          res << x #[/(.+)/mi, 1]
+        end
+      end
+      res.join
+    end
+    def multiline
+      data=@data
+      tuned_file=Array.new
+      data.each do |para|
+        para.gsub!(/\n/, ' ')
+        para.gsub!(/ \s+/mi, ' ')
+       #ALL HERE could be very time EXPENSIVE but tamed? compromise ... /mi
+        para.gsub!(/<([biu]|h[1-6])>(?:zZz)?([^<]+)?zZz(.+?)<\/\1>/i, "zZz<\\1>\\2 \\3</\\1>")
+        para.gsub!(/<([biu]|h[1-6])>(?:<center>|zZz)+(.+?)(?:<\/center>)?zZz(.+?)?<\/\1>/i, "zZz<\\1>\\2 \\3</\\1>")
+        #para.gsub!(/<([biu]|h[1-6])>(?:<center>|zZz)+(.+?)<\/center>zZz(.+?)?<\/\1>/i, "zZz<\\1>\\2 \\3</\\1>")
+        para.gsub!(/<([biu]|h[1-6])>(?:<center>|zZz)+(.+?)<\/\1>/i, "zZz<\\1>\\2</\\1>")
+        para.gsub!(/<(h[1-6])>(.+?)(?:<center>|zZz)+<\/\1>/i, "zZz<\\1>\\2</\\1>zZz") #does catch some h1, h2 etc, too expensive to have biu
+        #para.gsub!(/<([biu]|h[1-6])>(.+?)(?:<center>|zZz)+<\/\1>/i, "zZz<\\1>\\2 \\3</\\1>") #may go too far? useful for h1 h2 etc, remove biu?
+        #para.gsub!(/<([biu]|h[1-6])>([^<]+)?zZz(.+?)<\/\1>/i, "zZz<\\1>\\2 \\3</\\1>")
+        #para.gsub!(/<([biu]|h[1-6])>([^<]+)?zZz(.+?)<\/\1>/i, "zZz<\\1>\\2 \\3</\\1>")
+       ### SERIOUS PROBLEM INTRODUCED
+       # sub = para.split(/<blockquote>/i)
+       # para = blockquotes(sub) if sub.length > 0 #check was on >1 could have serious repercussions 2004w29
+        para.gsub!(/zZz(\s*zZz)*/, "\n\n")
+      	tuned_file << para << "\n\n" unless para == nil
+      end
+      tuned_file
+    end
+    def markup_rules
+      data=@data
+      tuned_file=Array.new
+      data.each do |para|
+        if para=~/<a href="(http:\/\/.+?)">/i
+          #p para.grep(/<a href="(http:\/\/.+?)">/i)
+          #m=$1
+          #para.gsub!(/(?:&lt;\s*)?<a href="#{m}">#{m}<\/a>(?:\s*&gt;)?\.?/i, "#{m}")
+          para.gsub!(/(?:&lt;\s*)?<a href="(http:\/\/.+?)">http:\/\/.+?<\/a>(?:\s*&gt;)?\.?/i, "\\1") #risk that url & url are not to match
+          #para.gsub!(/(?:&lt;\s*)?<a href="(\w+\.html)">(http:\/\/.+?\/\1)<\/a>(?:\s*&gt;)?\.?/i, "\\2") #does not match
+        end
+        ### clean
+        para.gsub!(/^\s+/i, '')
+        para.gsub!(/<([bui]|em|su[pb])>\s*<\/\1>/i, '')
+        para.gsub!(/<\/?center>/i, '')
+        para.gsub!(/\s*<\/dir>/i, '')
+        para.gsub!(/<hr>/i, '')
+        para.gsub!(/\s*<a href=".+?\.html#(?:[a-z_]+)?(?:[a-z0-9_-]|\*)+">\[(\*+)\]<\/a>/i, "^{[\\1]}^ ") #other endnote marker
+        para.gsub!(/<a href=".+?\.html#(?:[a-z_$]+)?[0-9_-]+"(?:\s+name=".+?")?>\[[a-z]?\d+\](?:<\/[bi]>)?<\/a>/i, '~e ') #endnote marker
+        para.gsub!(/<a name=".+?"\s+href=".+?\.html#(?:[a-z_$]+)?[0-9_-]+"?>\[[a-z]?\d+\](?:<\/[bi]>)?<\/a>/i, '~e ') #endnote marker
+        para.gsub!(/<a name="(?:[a-z$]+)?[0-9_-]+">\s*(<\/a>)?\s*\d+\.?\s*(<\/a>)?\s*/i, '~{{ ') #endnote
+        #para.gsub!(/<h([1-6])>\s*(.+?)\s*<\/h\1>\s*/i, "\\1{ \\2") #
+        para.gsub!(/<h([1-6])(?: align=.+?)?>\s*(.+?)\s*<\/h\1>\s*/i, "\\1{ \\2") #
+        para.gsub!(/^<b>(Chapter|Article)(.+?)<\/b>/i, "4{ \\1 \\2") #watch case insensitivity
+        para.gsub!(/^<b>(Part|Section|Book)(.+?)<\/b>/i, "3{ \\1 \\2") #watch case insensitivity
+        para.gsub!(/^<b>(\d+\.\d+\.\d+)(.+?)<\/b>/i, "6{ \\1 \\2") #numeric, decide what to do, can be different
+        para.gsub!(/^<b>(\d+\.\d+)(.+?)<\/b>/i, "5{ \\1 \\2") #numeric, decide what to do, can be different
+        para.gsub!(/^<b>(\d+)(.+?)<\/b>/i, "4{ \\1 \\2") #numeric, decide what to do, can be different
+        #<a name="ii"></a><B>
+        para.gsub!(/^(<a name=".+?">)(?:<small>)?<(?:b|strong)>\s*(.+?)\s*<\/(?:b|strong)>/i, "5{ \\2 \\1") #watch
+        para.gsub!(/^(<(a name|A NAME)=".+?">)(\s*|<\/[aA]>)?([A-Z][A-Z])+/, "5{ \\2 \\1") #watch
+        para.gsub!(/^(\s+|<p>)?(<a name=".+?">)(\s*|<\/a>)?<b>/i, "5{ \\2 \\1") #watch
+        para.gsub!(/<h([1-6])>\s*(.+?)\s*<\/h\1>\s*/i, "\\1{ \\2") #
+        para.gsub!(/^<b>\s*(.+?)<\/b>\s*(<\/i>\s*)?$/i, "4{ \\1\\2") # wish it all were less messy
+        para.gsub!(/^<i>\s*([^"(].+?)<\/i>\s*(<\/b>\s*)?$/i, "5{ \\1\\2") # wish it all were less messy
+        para.gsub!(/<\/?[biu]>/i, '') if para =~/[1-6]\{/
+        para.gsub!(/<u>\s*(.+?)\s*<\/u>/i, "_{\\1}_")
+        para.gsub!(/<(b|strong)>\s*(.+?)\s*<\/\1>/i, "*{\\2}*")
+        para.gsub!(/<(i|em)>\s*(.+?)\s*<\/\1>/i, "/{\\2}/")
+        para.gsub!(/<sup>\s*(.+?)\s*<\/sup>/i, "^{\\1}^")
+        para.gsub!(/(([\/\*!_])\{.+?\}\2)\s\s+/i, "\\1 ")
+        para.gsub!(/(([\/\*!_])\{.+?\}\2)\s+([.,;?\)])\s+/i, "\\1\\3 ")
+        para.gsub!(/(([\/\*!_])\{.+?\}\2)(["'])\s+/i, "\\1\\3 ")
+        para.gsub!(/(([\/\*!_])\{.+?\}\2)\s*([a-z0-9])/i, "\\1 \\3")
+        para.gsub!(/(([\/\*_])\{.+?\}\2)\s*([a-z0-9])/i, "\\1 \\3")
+        para.gsub!(/([a-z0-9])(([\/\*_])\{.+?\}\3)/i, " \\1 \\2") #eg this/{problem}/
+        para.gsub!(/([\/\*_])\{([,.;; ]+)\}\1/i, "\\2") #eg /{,}/ or *{ }* etc.
+        para.gsub!(/ \s+/i, ' ')
+        #para.gsub!(/\/\{\*\{/i, '*{/{')
+        #para.gsub!(/\}\*\}\//i, '}/}*')
+        para.gsub!(/&quot;/i, '"')
+        para.gsub!(/&amp;/i, 'and')
+        para.gsub!(/<!doctype html public .+/i, '')
+        para.gsub!(/<\/?(?:html|head|body|font|small)>/i, '')
+        para.gsub!(/<\/(?:title)>/i, '')
+        para.gsub!(/<title>/i, '#{~title? ')
+        para.gsub!(/<blockquote>(.+?)<\/blockquote>/mi, "\n\n_1 \\1\n\n")
+        para.gsub!(/<div align=.+?>|<\/div>|<font size=.+?>|<\/a><\/em><\/strong>/i, '')
+        para.gsub!(/~e\s+\.\s*/i, ".~e ") #check vim equiv # %s/\~e\s\+\.\s*/.\~e /c
+        para.gsub!(/\s+~e\s+/i, "~e ")
+        para.gsub!(/ \s+/i, ' ')
+        para.gsub!(/\s+$/i, '')
+        para.gsub!(/^(?:<\/[bi]>)+$/i, '')
+        para.gsub!(/^(?:(?:<i>)+<b>|(?:<b>)+<i>)\s*([^"(].+?)/i, "5{ \\1\\2") # wish it all were less messy
+        para.gsub!(/^(?:<\/?(?:[ib]|em)>\s*)+$/i, '') # cleaning up left over <i> etc.
+        para.gsub!(/<(?:i|em)>\s*(.+)/i, "/{\\1}/") # using up left over <i>
+        para.gsub!(/<b>\s*(.+)/i, "*{\\1}*") # using up left over <b>
+        #para.gsub!(/^(?:<(?:\/)?[bi]>)+$/i, '')
+      	tuned_file << para unless para == nil
+		  end
+      tuned_file
+    end
+  end
+  class Default < Html
+    def initialize(data, filename, instruct)
+      @data=data
+      @filename=filename
+      @instruct=instruct
+    end
+	  def songsheet
+      data=@data
+    	print "Convert to SiSU file from #{@filename}.html << gvim ,,#{@filename}.er9 >\n" #: <<#{@@html_title}>>
+	    data=Default.new(data.collect, @filename, @instruct).space_paragraphs
+      data=Default.new(data.collect, @filename, @instruct).multiline
+      data=Default.new(data.collect.join.split("\n\n"), @filename, @instruct).markup_rules
+	    data=Default.new(data.collect, @filename, @instruct).markup_default
+	  	data=MyOutput.new(data.collect, @filename, @instruct).hardOutput
+	  end
+    def markup_default
+      data=@data
+      tuned_file=Array.new
+      data.each do |para|
+        para.gsub!(/<i>(Id\.?)(\s|$)/i, "/\{\\1\}\\2/")
+        para.gsub!(/^(~\{\{ .+?)(<\/LI>\s*|<\/OL>\s*)+$/i, "\\1")
+        para.gsub!(/\/\{Id\.\s*<\/LI>\s*\}\//i, '/{Id.}/')
+      	tuned_file << para unless para == nil
+		  end
+      tuned_file
+    end
+  end
+end
+def help
+      puts <<WOK
+conversion program
+initial SiSU markup from other file formats
+
+  zxy_convert --word    does initial conversion from word97 to sisu markup, expects [filename].doc (can also use --doc)
+  zxy_convert --html    does initial conversion from html to sisu markup, expects [filename].html
+  zxy_convert --default does initial conversion from defalt html to sisu markup, expects [filename].html
+
+WOK
+end
+def doWord(argv, instruct)
+  argv.each do  |f|
+    if f =~/.+?\.doc$/
+      @argv << f[/(.+?)\.doc$/, 1]
+    else
+      print "not .doc? << #{f} >> "
+    end
+  end
+  @argv.each do |filename|
+    system(%{wvWare -x #{@dir.home}/.sisu/convert/wvSiSU.xml #{filename}.doc > #{filename}.wv})
+    file_array=IO.readlines("#{filename}.wv", "")
+  	CONVERT::WareWord97.new(file_array, filename, instruct).songsheet # metaverse created here
+  end
+end
+def doHtml(argv, instruct)
+  argv.each do  |f|
+    if f =~/.+?\.html$/
+      @argv << f[/(.+?)\.html$/, 1]
+    else
+      print "not .html? << #{f} >> "
+    end
+  end
+  @argv.each do |filename|
+    file_array=IO.readlines("#{filename}.html", "\n\r")
+  	CONVERT::Html.new(file_array, filename, instruct).songsheet # metaverse created here
+  end
+end
+def doDefault(argv, instruct)
+  argv.each do  |f|
+    if f =~/.+?\.html$/
+      @argv << f[/(.+?)\.html$/, 1]
+    else
+      print "not .html? << #{f} >> "
+    end
+  end
+  @argv.each do |filename|
+    file_array=IO.readlines("#{filename}.html", "\n\r")
+  	CONVERT::Default.new(file_array, filename, instruct).songsheet # metaverse created here
+  end
+end
+def cases(argv, instruct)
+	case instruct
+		when/^--(word(97)?|doc)$/i #creates minimal sisu_small.gz package to send
+      doWord(argv, instruct)
+		when/^--(html)$/i #creates sisu.gz package to send
+      doHtml(argv, instruct)
+		when/^--(default)$/i #creates sisu.gz package to send
+      doDefault(argv, instruct)
+		else
+      help
+	end
+end
+require 'zxy_sysenv.rb'
+include SiSU_Env
+@dir=SiSU_Env::Info_dir.new
+@argv=Array.new
+argv=$*
+instruct = "#{argv[0].to_s}"
+argv.shift
+instruct.chomp!
+instruct = "help" if instruct.nil? or instruct == ""; 
+cases(argv, instruct)
diff --git a/data/sisu/conf/convert/wvHtml.xml b/data/sisu/conf/convert/wvHtml.xml
new file mode 100644
index 00000000..ec04dc33
--- /dev/null
+++ b/data/sisu/conf/convert/wvHtml.xml
@@ -0,0 +1,388 @@
+<main>
+<charentity>
+<begin>HTML</begin>
+</charentity>
+
+<document>
+<begin>&lt;!DOCTYPE HTML PUBLIC &quot;-//W3C//DTD HTML 4.0 Transitional//EN&quot; &quot;http://www.w3.org/TR/REC-html40/loose.dtd&quot;&gt;
+&lt;html&gt; 
+&lt;head&gt; 
+&lt;META HTTP-EQUIV=&quot;Content-Type&quot; CONTENT=&quot;text/html; charset=<charset/>&quot;&gt;
+&lt;META NAME=&quot;GENERATOR&quot; CONTENT=&quot;wvWare/<version/>&quot;&gt;
+&lt;title&gt; 
+<title/>
+&lt;/title&gt; 
+&lt;/head&gt; 
+&lt;body bgcolor=&quot;#FFFFFF&quot; text=&quot;#000000&quot; link=&quot;#0000ee&quot; vlink=&quot;#551a8b&quot;&gt;
+</begin>
+<end>
+&lt;!--
+&lt;hr&gt;
+&lt;address&gt;
+&lt;a href=&quot;http://wvware.sourceforge.net/&quot;&gt;&lt;img
+src=&quot;wvSmall.gif&quot; height=31 width=47
+align=left border=0 alt=&quot;wvWare&quot;&gt;&lt;/a&gt;
+&lt;a href=&quot;http://validator.w3.org/check/referer&quot;&gt;&lt;img
+src=&quot;vh40.gif&quot; height=31 width=88
+align=right border=0 alt=&quot;Valid HTML 4.0!&quot;&gt;&lt;/a&gt;
+Document created with &lt;a href=&quot;http://wvware.sourceforge.net/&quot;&gt;wvWare/<version/>&lt;/a&gt;&lt;br&gt;
+&lt;/address&gt;
+--&gt;
+&lt;/body&gt;
+&lt;/html&gt;
+</end>
+</document>
+
+<section>
+<begin>
+&lt;!--Section Begins--&gt;&lt;br&gt;
+</begin>
+<end>
+&lt;!--Section Ends--&gt;
+</end>
+</section>
+
+<justification>
+<left>left</left>
+<right>right</right>
+<center>center</center>
+<block>left</block>
+<asian>&lt;!--Could Someone who sees this tag tell me what was is this type of justification, asian languages only i thing--&gt;</asian>
+</justification>
+
+<numbering>
+<Arabic>type=&quot;1&quot;</Arabic>
+<UpperRoman>type=&quot;I&quot;</UpperRoman>
+<LowerRoman>type=&quot;i&quot;</LowerRoman>
+<UpperCaseN>type=&quot;A&quot;</UpperCaseN>
+<LowerCaseN>type=&quot;a&quot;</LowerCaseN>
+</numbering>
+
+<border>
+<noned>none</noned>
+<singled>solid</singled>
+<thickd>solid</thickd>
+<doubled>double</doubled>
+<number4d>double</number4d>
+<hairlined>solid</hairlined>
+<dotd>dotted</dotd>
+<dashlargegapd>dashed</dashlargegapd>
+<dotdashd>dotted</dotdashd>
+<dotdotdashd>dotted</dotdotdashd>
+<tripled>double</tripled>
+<thin-thicksmallgapd>dashed</thin-thicksmallgapd>
+<thick-thinsmallgapd>dashed</thick-thinsmallgapd>
+<thin-thick-thinsmallgapd>dashed</thin-thick-thinsmallgapd>
+<thin-thickmediumgapd>dashed</thin-thickmediumgapd>
+<thick-thinmediumgapd>dashed</thick-thinmediumgapd>
+<thin-thick-thinmediumgapd>dashed</thin-thick-thinmediumgapd>
+<thin-thicklargegapd>dashed</thin-thicklargegapd>
+<thick-thinlargegapd>dashed</thick-thinlargegapd>
+<thin-thick-thinlargegapd>dashed</thin-thick-thinlargegapd>
+<waved>solid</waved>
+<doublewaved>double</doublewaved>
+<dashsmallgapd>sashed</dashsmallgapd>
+<dashdotstrokedd>dashed</dashdotstrokedd>
+<emboss3Dd>ridge</emboss3Dd>
+<engrave3Dd>groove</engrave3Dd>
+<defaultd>ridge</defaultd>
+</border>
+
+<!-- <begin>&lt;ol <nfc/> start=&quot;<start/>&quot;&gt; -->
+<olist>
+<begin>&lt;ol <nfc/>&gt;
+</begin>
+<end>&lt;/ol&gt;</end>
+</olist>
+
+<ulist>
+<begin>&lt;ul&gt;
+</begin>
+<end>&lt;/ul&gt;</end>
+</ulist>
+
+<!-- <begin>&lt;li&gt;</begin> -->
+<entry>
+<begin>&lt;li value=&quot;<start/>&quot;&gt;</begin>
+<end>&lt;/li&gt;</end>
+</entry>
+
+
+<!-- 
+this tableoverride option can be used to turn off handling of
+these tags in tables, which I find is necessary for at least netscape
+-->
+<tableoverrides>
+<ParaBefore>0</ParaBefore>
+<ParaRight>0</ParaRight>
+<ParaAfter>0</ParaAfter>
+<ParaLeft>0</ParaLeft>
+<ParaLeft1>0</ParaLeft1>
+<VertMergedCells>0</VertMergedCells>
+</tableoverrides>
+
+<table>
+<begin>&lt;table width=&quot;<tablerelwidth/>%&quot; border=&quot;1&quot; cols=&quot;<no_cols/>&quot; rows=&quot;<no_rows/>&quot;&gt;</begin>
+<end>&lt;/table&gt;</end>
+</table>
+
+<row>
+<begin>&lt;tr&gt;</begin>
+<end>&lt;/tr&gt;</end>
+</row>
+
+<cell>
+<begin>&lt;td bgcolor=&quot;<cellbgcolor/>&quot; width=&quot;<cellrelwidth/>%&quot; rowspan=&quot;<rowspan/>&quot; colspan=&quot;<colspan/>&quot;&gt;</begin>
+<end>&lt;/td&gt;</end>
+</cell>
+
+<paragraph>
+<begin>
+<table.end/>
+<table.begin/>
+<row.begin/><cell.begin/><olist.end/><olist.begin/><ulist.end/><ulist.begin/><entry.begin/><text.begin/>
+</begin>
+<end>
+<text.end/><entry.end/><olist.end/><ulist.end/><cell.end/><row.end/>
+</end>
+</paragraph>
+
+<!-- these are all the character properties that can show up in word -->
+<bold><begin>&lt;b&gt;</begin><end>&lt;/b&gt;</end></bold>
+<italic><begin>&lt;i&gt;</begin><end>&lt;/i&gt;</end></italic>
+
+<!--
+text that has been deleted and will be displayed with strikethrough when
+revision marked text is to be displayed
+
+use either this line...
+--> 
+<RMarkDel><begin>&lt;s&gt;</begin><end>&lt;/s&gt;&lt;a href=&quot;#author<ibstRMarkDel/>&quot;&gt;[Author ID<ibstRMarkDel/>: at <dttmRMarkDel/> ]&lt;/a&gt;</end></RMarkDel>
+
+<!--
+or uncomment below to make deleted text dissappear (well, become commented out)
+-->
+<!--
+<RMarkDel><begin>&lt;!-&#45;</begin><end>-&#45;&gt;</end></RMarkDel>
+-->
+
+<!-- Overwriting char props. like CaPs->CAPS SmallCaps->smallcaps -->
+<outline><begin></begin><end></end></outline>
+<smallcaps><begin>&lt;span style=&quot;text-transform:lowercase&quot;&gt;</begin><end>&lt;/span&gt;</end></smallcaps>
+<caps><begin>&lt;span style=&quot;text-transform:uppercase&quot;&gt;</begin><end>&lt;/span&gt;</end></caps>
+<vanish><begin></begin><end></end></vanish>
+
+<!--If you uncomment this then the annotation text links will become commented out by html tags-->
+<!--
+<vanish><begin>&lt;!-&#45;</begin><end>-&#45;&gt;</end></vanish>
+-->
+
+<!--
+text that has been newly typed since the last time revision marks have been accepted
+and will be displayed with underline when revision marked text is to be displayed
+
+use either this line...
+-->
+<RMark><begin>&lt;u&gt;</begin><end>&lt;/u&gt;&lt;a href=&quot;#author<ibstRMark/>&quot;&gt;[Author ID<ibstRMark/>: at <dttmRMark/>]&lt;/a&gt;</end></RMark>
+
+<!--
+or uncomment below to make the underline dissappear
+-->
+<!--
+<RMark><begin></begin><end></end></RMark>
+-->
+
+
+<strike><begin>&lt;s&gt;</begin><end>&lt;/s&gt;</end></strike>
+<shadow><begin></begin><end></end></shadow>
+<lowercase><begin></begin><end></end></lowercase>
+<emboss><begin></begin><end></end></emboss>
+<imprint><begin></begin><end></end></imprint>
+<!--double strike-->
+<dstrike><begin>&lt;s&gt;</begin><end>&lt;/s&gt;</end></dstrike>
+
+<!--
+ftc's
+&
+hps
+
+keep them for font face and do that later.
+-->
+
+<super><begin>&lt;sup&gt;</begin><end>&lt;/sup&gt;</end></super>
+<sub><begin>&lt;sub&gt;</begin><end>&lt;/sub&gt;</end></sub>
+
+<singleu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></singleu>
+<wordu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></wordu>
+<doubleu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></doubleu>
+<dottedu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dottedu>
+<hiddenu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></hiddenu>
+<thicku><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></thicku>
+<dashu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dashu>
+<dotu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dotu>
+<dotdashu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dotdashu>
+<dotdotdashu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dotdotdashu>
+<waveu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></waveu>
+
+<!--
+text whose properties have been changed since the last time revision marks have been accepted
+and will be displayed with a note showing the change points.
+
+use either this line (which admit it a bit scary looking, but harmless)...
+--> 
+<PropRMark><begin>&lt;a href=&quot;#author<ibstPropRMark/>&quot;&gt;-&#45;&amp;gt;&lt;/a&gt;</begin><end>&lt;a href=&quot;#author<ibstPropRMark/>&quot;&gt;[Author ID<ibstPropRMark/>: at <dttmPropRMark/>]&lt;/a&gt;</end></PropRMark>
+
+<!--
+or uncomment below to make the notes dissappear
+-->
+<!--
+<PropRMark><begin></begin><end></end></PropRMark>
+-->
+
+<!--
+<color>
+-->
+<Black><begin>Black</begin><end></end></Black>
+<Blue><begin>Blue</begin><end></end></Blue>
+<Cyan><begin>Cyan</begin><end></end></Cyan>
+<Green><begin>Green</begin><end></end></Green>
+<Magenta><begin>Magenta</begin><end></end></Magenta>
+<Red><begin>Red</begin><end></end></Red>
+<Yellow><begin>Yellow</begin><end></end></Yellow>
+<White><begin>White</begin><end></end></White>
+<DkBlue><begin>DarkBlue</begin><end></end></DkBlue>
+<DkCyan><begin>DarkCyan</begin><end></end></DkCyan>
+<DkGreen><begin>DarkGreen</begin><end></end></DkGreen>
+<DkMagenta><begin>DarkMagenta</begin><end></end></DkMagenta>
+<DkRed><begin>DarkRed</begin><end></end></DkRed>
+<DkYellow><begin>#8b8b00</begin><end></end></DkYellow>
+<DkGray><begin>DarkGray</begin><end></end></DkGray>
+<LtGray><begin>LightGrey</begin><end></end></LtGray>
+<!--
+</color>
+-->
+
+<!--
+<animation>
+-->
+<LasVegas><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></LasVegas>
+<BackgroundBlink><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></BackgroundBlink>
+<SparkleText><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></SparkleText>
+<MarchingAnts><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></MarchingAnts>
+<MarchingRedAnts><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></MarchingRedAnts>
+<Shimmer><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></Shimmer>
+<!--
+</animation>
+-->
+
+<!--
+I dont understand what this one is, and ive never come across it
+
+use this sample line (which admit it a bit scary looking, but harmless)...
+-->
+<DispFldRMark><begin>&lt;a href=&quot;#author<ibstDispFldRMark/>&quot;&gt;--&amp;gt;&lt;/a&gt;</begin><end>&lt;a href=&quot;#author<ibstDispFldRMark/>&quot;&gt;[Author ID<ibstDispFldRMark/>: at <dttmDispFldRMark/> (<xstDispFldRMark/>)]&lt;/a&gt;</end></DispFldRMark>
+
+<!--
+or uncomment below to ignore it, the previous might even crash wv ?
+-->
+<!--
+<DispFldRMark><begin></begin><end></end></DispFldRMark>
+-->
+
+<animation>
+<begin><LasVegas.begin/><BackgroundBlink.begin/><SparkleText.begin/><MarchingAnts.begin/><MarchingRedAnts.begin/><Shimmer.begin/></begin>
+<end><Shimmer.end/><MarchingRedAnts.end/><MarchingAnts.end/><SparkleText.end/><BackgroundBlink.end/><LasVegas.end/></end>
+</animation>
+
+<fontstr>
+<begin>&lt;font color=&quot;<black.begin/><blue.begin/><cyan.begin/><green.begin/><magenta.begin/><red.begin/><yellow.begin/><white.begin/><dkblue.begin/><dkcyan.begin/><dkgreen.begin/><dkmagenta.begin/><dkred.begin/><dkyellow.begin/><dkgray.begin/><ltgray.begin/>&quot;&gt;</begin>
+<end><ltgray.end/><dkgray.end/><dkyellow.end/><dkred.end/><dkmagenta.end/><dkgreen.end/><dkcyan.end/><dkblue.end/><white.end/><yellow.end/><red.end/><magenta.end/><green.end/><cyan.end/><blue.end/><black.end/>&lt;/font&gt;</end>
+</fontstr>
+
+<comment>
+<begin>
+&lt;a href=&quot;#comment<ibstAnno/> &quot;&gt;-&#45;&amp;gt;&lt;/a&gt;
+</begin>
+<end>&lt;a href=&quot;#comment<ibstAnno/> &quot;&gt;[Author:<xstUsrInitl/>]&lt;/a&gt;
+</end>
+</comment>
+
+<style name="Normal">
+<character>
+<begin><PropRMark.begin/><DispFldRMark.begin/><animation.begin/><fontstr.begin/><bold.begin/><italic.begin/><strike.begin/><RMarkDel.begin/><outline.begin/><smallcaps.begin/><caps.begin/><vanish.begin/><RMark.begin/><shadow.begin/><lowercase.begin/><emboss.begin/><imprint.begin/><dstrike.begin/><super.begin/><sub.begin/><singleu.begin/><wordu.begin/><doubleu.begin/><dottedu.begin/><hiddenu.begin/><thicku.begin/><dashu.begin/><dotu.begin/><dotdashu.begin/><dotdotdashu.begin/><waveu.begin/></begin>
+<end><waveu.end/><dotdotdashu.end/><dotdashu.end/><dotu.end/><dashu.end/><thicku.end/><hiddenu.end/><dottedu.end/><doubleu.end/><wordu.end/><singleu.end/><sub.end/><super.end/><dstrike.end/><imprint.end/><emboss.end/><lowercase.end/><shadow.end/><RMark.end/><vanish.end/><caps.end/><smallcaps.end/><outline.end/><RMarkDel.end/><strike.end/><italic.end/><bold.end/><fontstr.end/><animation.end/><DispFldRMark.end/><PropRMark.end/></end>
+</character>
+
+<!-- Netscape does handle this correctly yet, here is how each different side of the border should work.
+border-top: thin <bordertopstyle/> <bordertopcolor/>;
+border-left: thin <borderleftstyle/> <borderleftcolor/>;
+border-right: thin <borderrightstyle/> <borderrightcolor/>;
+border-bottom: thin <borderbottomstyle/> <borderbottomcolor/>
+-->
+
+
+<pmargin>
+<begin>margin: <mmParaBefore/> <mmParaRight/> <mmParaAfter/> <mmParaLeft/>;</begin>
+</pmargin>
+
+<pborder>
+<begin>
+border: thin <borderleftstyle/> <borderleftcolor/>;
+<!--
+border-top: thin <bordertopstyle/> <bordertopcolor/>;
+border-left: thin <borderleftstyle/> <borderleftcolor/>;
+border-right: thin <borderrightstyle/> <borderrightcolor/>;
+border-bottom: thin <borderbottomstyle/> <borderbottomcolor/>
+-->
+</begin>
+</pborder>
+
+<text>	
+<begin>&lt;p&gt;&lt;div name=&quot;<stylename/>&quot; align=&quot;<just/>&quot; style=&quot;<paramargin/> <paraborder/> padding: <mmPadTop/> <mmPadRight/> <mmPadBottom/> <mmPadLeft/>; &quot;&gt; 
+
+&lt;p style=&quot;text-indent: <mmParaLeft1/>; text-align: <just/>; line-height: <mmLineHeight/>; color: <parafgcolor/>; background-color: <parabgcolor/>; &quot;&gt;</begin>
+
+<end>&lt;/p&gt;&lt;/div&gt;</end>
+</text>
+
+<picture>
+<begin>
+&lt;img <htmlAlignGuess/> width=&quot;<pixPicWidth/>&quot; height=&quot;<pixPicHeight/>&quot; alt=&quot;0x01 graphic&quot; src=&quot;placeholder.png&quot;&gt;<htmlNextLineGuess/>
+</begin>
+</picture>
+
+</style>
+
+<!--we need to be override the character properties-->
+<!--
+<style name="Normal">
+<character>
+<begin><PropRMark.begin/><DispFldRMark.begin/><animation.begin/><fontstr.begin/><bold.begin/><italic.begin/><strike.begin/><RMarkDel.begin/><outline.begin/><smallcaps.begin/><caps.begin/><vanish.begin/><RMark.begin/><shadow.begin/><lowercase.begin/><emboss.begin/><imprint.begin/><dstrike.begin/><super.begin/><sub.begin/><singleu.begin/><wordu.begin/><doubleu.begin/><dottedu.begin/><hiddenu.begin/><thicku.begin/><dashu.begin/><dotu.begin/><dotdashu.begin/><dotdotdashu.begin/><waveu.begin/></begin>
+<end><waveu.end/><dotdotdashu.end/><dotdashu.end/><dotu.end/><dashu.end/><thicku.end/><hiddenu.end/><dottedu.end/><doubleu.end/><wordu.end/><singleu.end/><sub.end/><super.end/><dstrike.end/><imprint.end/><emboss.end/><lowercase.end/><shadow.end/><RMark.end/><vanish.end/><caps.end/><smallcaps.end/><outline.end/><RMarkDel.end/><strike.end/><italic.end/><bold.end/><fontstr.end/><animation.end/><DispFldRMark.end/><PropRMark.end/></end>
+</character>
+
+<text>	
+<begin>&lt;div name=&quot;<stylename/>&quot;  align=&quot;<just/>&quot;&gt;&lt;p&gt;</begin>
+<end>&lt;/p&gt;&lt;/div&gt;</end>
+</text>
+
+</style>
+
+<style name="Heading 1">
+
+<character>
+<begin></begin>
+<end></end>
+</character>
+
+<text>	
+<begin>&lt;div name=&quot;<stylename/>&quot;  align=&quot;<just/>&quot;&gt;&lt;H1&gt;</begin>
+<end>&lt;/H1&gt;&lt;/div&gt;</end>
+</text>
+
+
+
+</style>
+-->
+
+</main>
diff --git a/data/sisu/conf/convert/wvSiSU.xml b/data/sisu/conf/convert/wvSiSU.xml
new file mode 100644
index 00000000..8d9f913e
--- /dev/null
+++ b/data/sisu/conf/convert/wvSiSU.xml
@@ -0,0 +1,360 @@
+<main>
+<charentity>
+<begin>HTML</begin>
+</charentity>
+<!--  wvWare -x wvSiSU.xml [inputfile.doc] [outputfile.html] -->
+
+<document>
+<begin>
+</begin>
+<end>
+</end>
+</document>
+
+<section>
+<begin>
+</begin>
+<end>
+</end>
+</section>
+
+<justification>
+<left>left</left>
+<right>right</right>
+<center>center</center>
+<block>left</block>
+<asian>&lt;!--Could Someone who sees this tag tell me what was is this type of justification, asian languages only i thing--&gt;</asian>
+</justification>
+
+<numbering>
+<Arabic>type=&quot;1&quot;</Arabic>
+<UpperRoman>type=&quot;I&quot;</UpperRoman>
+<LowerRoman>type=&quot;i&quot;</LowerRoman>
+<UpperCaseN>type=&quot;A&quot;</UpperCaseN>
+<LowerCaseN>type=&quot;a&quot;</LowerCaseN>
+</numbering>
+
+<border>
+<noned>none</noned>
+<singled>solid</singled>
+<thickd>solid</thickd>
+<doubled>double</doubled>
+<number4d>double</number4d>
+<hairlined>solid</hairlined>
+<dotd>dotted</dotd>
+<dashlargegapd>dashed</dashlargegapd>
+<dotdashd>dotted</dotdashd>
+<dotdotdashd>dotted</dotdotdashd>
+<tripled>double</tripled>
+<thin-thicksmallgapd>dashed</thin-thicksmallgapd>
+<thick-thinsmallgapd>dashed</thick-thinsmallgapd>
+<thin-thick-thinsmallgapd>dashed</thin-thick-thinsmallgapd>
+<thin-thickmediumgapd>dashed</thin-thickmediumgapd>
+<thick-thinmediumgapd>dashed</thick-thinmediumgapd>
+<thin-thick-thinmediumgapd>dashed</thin-thick-thinmediumgapd>
+<thin-thicklargegapd>dashed</thin-thicklargegapd>
+<thick-thinlargegapd>dashed</thick-thinlargegapd>
+<thin-thick-thinlargegapd>dashed</thin-thick-thinlargegapd>
+<waved>solid</waved>
+<doublewaved>double</doublewaved>
+<dashsmallgapd>sashed</dashsmallgapd>
+<dashdotstrokedd>dashed</dashdotstrokedd>
+<emboss3Dd>ridge</emboss3Dd>
+<engrave3Dd>groove</engrave3Dd>
+<defaultd>ridge</defaultd>
+</border>
+
+<!-- <begin>&lt;ol <nfc/> start=&quot;<start/>&quot;&gt; -->
+<olist>
+<begin>
+</begin>
+<end></end>
+</olist>
+
+<ulist>
+<begin>
+</begin>
+<end></end>
+</ulist>
+
+<!-- <begin>&lt;li&gt;</begin> -->
+<entry>
+<begin></begin>
+<end></end>
+</entry>
+
+
+<!-- 
+this tableoverride option can be used to turn off handling of
+these tags in tables, which I find is necessary for at least netscape
+-->
+<tableoverrides>
+<ParaBefore>0</ParaBefore>
+<ParaRight>0</ParaRight>
+<ParaAfter>0</ParaAfter>
+<ParaLeft>0</ParaLeft>
+<ParaLeft1>0</ParaLeft1>
+<VertMergedCells>0</VertMergedCells>
+</tableoverrides>
+
+<table>
+<begin></begin>
+<end></end>
+</table>
+
+<row>
+<begin>&lt;tr&gt;</begin>
+<end>&lt;/tr&gt;</end>
+</row>
+
+<cell>
+<begin></begin>
+<end></end>
+</cell>
+
+<!-- EDITING OUT DID MUCH OF TRICK -->
+<paragraph>
+<begin>
+</begin>
+<end>
+</end>
+</paragraph>
+
+<!-- these are all the character properties that can show up in word -->
+<bold><begin>&lt;b&gt;</begin><end>&lt;/b&gt;</end></bold>
+<italic><begin>&lt;i&gt;</begin><end>&lt;/i&gt;</end></italic>
+
+<!--
+text that has been deleted and will be displayed with strikethrough when
+revision marked text is to be displayed
+
+use either this line...
+--> 
+<RMarkDel><begin>&lt;s&gt;</begin><end>&lt;/s&gt;&lt;a href=&quot;#author<ibstRMarkDel/>&quot;&gt;[Author ID<ibstRMarkDel/>: at <dttmRMarkDel/> ]&lt;/a&gt;</end></RMarkDel>
+
+<!--
+or uncomment below to make deleted text dissappear (well, become commented out)
+-->
+<!--
+<RMarkDel><begin>&lt;!-&#45;</begin><end>-&#45;&gt;</end></RMarkDel>
+-->
+
+<!-- Overwriting char props. like CaPs->CAPS SmallCaps->smallcaps -->
+<outline><begin></begin><end></end></outline>
+<smallcaps><begin></begin><end></end></smallcaps>
+<caps><begin></begin><end></end></caps>
+<vanish><begin></begin><end></end></vanish>
+
+<!--If you uncomment this then the annotation text links will become commented out by html tags-->
+<!--
+<vanish><begin>&lt;!-&#45;</begin><end>-&#45;&gt;</end></vanish>
+-->
+
+<!--
+text that has been newly typed since the last time revision marks have been accepted
+and will be displayed with underline when revision marked text is to be displayed
+
+use either this line...
+-->
+<RMark><begin></begin><end></end></RMark>
+
+<!--
+or uncomment below to make the underline dissappear
+-->
+<!--
+<RMark><begin></begin><end></end></RMark>
+-->
+
+
+<strike><begin>&lt;s&gt;</begin><end>&lt;/s&gt;</end></strike>
+<shadow><begin></begin><end></end></shadow>
+<lowercase><begin></begin><end></end></lowercase>
+<emboss><begin></begin><end></end></emboss>
+<imprint><begin></begin><end></end></imprint>
+<!--double strike-->
+<dstrike><begin>&lt;s&gt;</begin><end>&lt;/s&gt;</end></dstrike>
+
+<!--
+ftc's
+&
+hps
+
+keep them for font face and do that later.
+-->
+
+<super><begin>&lt;sup&gt;</begin><end>&lt;/sup&gt;</end></super>
+<sub><begin>&lt;sub&gt;</begin><end>&lt;/sub&gt;</end></sub>
+
+<singleu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></singleu>
+<wordu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></wordu>
+<doubleu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></doubleu>
+<dottedu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dottedu>
+<hiddenu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></hiddenu>
+<thicku><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></thicku>
+<dashu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dashu>
+<dotu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dotu>
+<dotdashu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dotdashu>
+<dotdotdashu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></dotdotdashu>
+<waveu><begin>&lt;u&gt;</begin><end>&lt;/u&gt;</end></waveu>
+
+<!--
+text whose properties have been changed since the last time revision marks have been accepted
+and will be displayed with a note showing the change points.
+
+use either this line (which admit it a bit scary looking, but harmless)...
+--> 
+<PropRMark><begin></begin><end></end></PropRMark>
+
+<!--
+or uncomment below to make the notes dissappear
+-->
+<!--
+<PropRMark><begin></begin><end></end></PropRMark>
+-->
+
+<!--
+<color>
+-->
+<Black><begin>Black</begin><end></end></Black>
+<Blue><begin>Blue</begin><end></end></Blue>
+<Cyan><begin>Cyan</begin><end></end></Cyan>
+<Green><begin>Green</begin><end></end></Green>
+<Magenta><begin>Magenta</begin><end></end></Magenta>
+<Red><begin>Red</begin><end></end></Red>
+<Yellow><begin>Yellow</begin><end></end></Yellow>
+<White><begin>White</begin><end></end></White>
+<DkBlue><begin>DarkBlue</begin><end></end></DkBlue>
+<DkCyan><begin>DarkCyan</begin><end></end></DkCyan>
+<DkGreen><begin>DarkGreen</begin><end></end></DkGreen>
+<DkMagenta><begin>DarkMagenta</begin><end></end></DkMagenta>
+<DkRed><begin>DarkRed</begin><end></end></DkRed>
+<DkYellow><begin>#8b8b00</begin><end></end></DkYellow>
+<DkGray><begin>DarkGray</begin><end></end></DkGray>
+<LtGray><begin>LightGrey</begin><end></end></LtGray>
+<!--
+</color>
+-->
+
+<!--
+<animation>
+-->
+<LasVegas><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></LasVegas>
+<BackgroundBlink><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></BackgroundBlink>
+<SparkleText><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></SparkleText>
+<MarchingAnts><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></MarchingAnts>
+<MarchingRedAnts><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></MarchingRedAnts>
+<Shimmer><begin>&lt;blink&gt;</begin><end>&lt;/blink&gt;</end></Shimmer>
+<!--
+</animation>
+-->
+
+<!--
+I dont understand what this one is, and ive never come across it
+
+use this sample line (which admit it a bit scary looking, but harmless)...
+-->
+<DispFldRMark><begin></begin><end></end></DispFldRMark>
+
+<!--
+or uncomment below to ignore it, the previous might even crash wv ?
+-->
+<!--
+<DispFldRMark><begin></begin><end></end></DispFldRMark>
+-->
+
+<animation>
+<begin></begin>
+<end></end>
+</animation>
+
+<fontstr>
+<begin></begin>
+<end></end>
+</fontstr>
+
+<comment>
+<begin>
+</begin>
+<end>
+</end>
+</comment>
+
+<style name="Normal">
+<character>
+<begin><bold.begin/><italic.begin/><strike.begin/><RMarkDel.begin/><outline.begin/><smallcaps.begin/><caps.begin/><vanish.begin/><RMark.begin/><shadow.begin/><lowercase.begin/><emboss.begin/><imprint.begin/><dstrike.begin/><super.begin/><sub.begin/><singleu.begin/><wordu.begin/><doubleu.begin/><dottedu.begin/><hiddenu.begin/><thicku.begin/><dashu.begin/><dotu.begin/><dotdashu.begin/><dotdotdashu.begin/><waveu.begin/></begin>
+<end><waveu.end/><dotdotdashu.end/><dotdashu.end/><dotu.end/><dashu.end/><thicku.end/><hiddenu.end/><dottedu.end/><doubleu.end/><wordu.end/><singleu.end/><sub.end/><super.end/><dstrike.end/><imprint.end/><emboss.end/><lowercase.end/><shadow.end/><RMark.end/><vanish.end/><caps.end/><smallcaps.end/><outline.end/><RMarkDel.end/><strike.end/><italic.end/><bold.end/></end>
+</character>
+
+<!-- KEEP
+<style name="Normal">
+<character>
+<begin><PropRMark.begin/><DispFldRMark.begin/><animation.begin/><fontstr.begin/><bold.begin/><italic.begin/><strike.begin/><RMarkDel.begin/><outline.begin/><smallcaps.begin/><caps.begin/><vanish.begin/><RMark.begin/><shadow.begin/><lowercase.begin/><emboss.begin/><imprint.begin/><dstrike.begin/><super.begin/><sub.begin/><singleu.begin/><wordu.begin/><doubleu.begin/><dottedu.begin/><hiddenu.begin/><thicku.begin/><dashu.begin/><dotu.begin/><dotdashu.begin/><dotdotdashu.begin/><waveu.begin/></begin>
+<end><waveu.end/><dotdotdashu.end/><dotdashu.end/><dotu.end/><dashu.end/><thicku.end/><hiddenu.end/><dottedu.end/><doubleu.end/><wordu.end/><singleu.end/><sub.end/><super.end/><dstrike.end/><imprint.end/><emboss.end/><lowercase.end/><shadow.end/><RMark.end/><vanish.end/><caps.end/><smallcaps.end/><outline.end/><RMarkDel.end/><strike.end/><italic.end/><bold.end/><fontstr.end/><animation.end/><DispFldRMark.end/><PropRMark.end/></end>
+</character>
+-->
+
+<!-- Netscape does handle this correctly yet, here is how each different side of the border should work.
+border-top: thin <bordertopstyle/> <bordertopcolor/>;
+border-left: thin <borderleftstyle/> <borderleftcolor/>;
+border-right: thin <borderrightstyle/> <borderrightcolor/>;
+border-bottom: thin <borderbottomstyle/> <borderbottomcolor/>
+-->
+
+
+<pmargin>
+<begin></begin>
+</pmargin>
+
+<pborder>
+<begin>
+</begin>
+</pborder>
+
+<text>	
+<begin> 
+
+<mmParaLeft1/></begin>
+
+<end></end>
+</text>
+
+<picture>
+<begin>
+</begin>
+</picture>
+
+</style>
+
+<!--we need to be override the character properties-->
+<!--
+<style name="Normal">
+<character>
+<begin><PropRMark.begin/><DispFldRMark.begin/><animation.begin/><fontstr.begin/><bold.begin/><italic.begin/><strike.begin/><RMarkDel.begin/><outline.begin/><smallcaps.begin/><caps.begin/><vanish.begin/><RMark.begin/><shadow.begin/><lowercase.begin/><emboss.begin/><imprint.begin/><dstrike.begin/><super.begin/><sub.begin/><singleu.begin/><wordu.begin/><doubleu.begin/><dottedu.begin/><hiddenu.begin/><thicku.begin/><dashu.begin/><dotu.begin/><dotdashu.begin/><dotdotdashu.begin/><waveu.begin/></begin>
+<end><waveu.end/><dotdotdashu.end/><dotdashu.end/><dotu.end/><dashu.end/><thicku.end/><hiddenu.end/><dottedu.end/><doubleu.end/><wordu.end/><singleu.end/><sub.end/><super.end/><dstrike.end/><imprint.end/><emboss.end/><lowercase.end/><shadow.end/><RMark.end/><vanish.end/><caps.end/><smallcaps.end/><outline.end/><RMarkDel.end/><strike.end/><italic.end/><bold.end/><fontstr.end/><animation.end/><DispFldRMark.end/><PropRMark.end/></end>
+</character>
+
+<text>	
+<begin>&lt;div name=&quot;<stylename/>&quot;  align=&quot;<just/>&quot;&gt;&lt;p&gt;</begin>
+<end>&lt;/p&gt;&lt;/div&gt;</end>
+</text>
+
+</style>
+
+<style name="Heading 1">
+
+<character>
+<begin></begin>
+<end></end>
+</character>
+
+<text>	
+<begin>&lt;div name=&quot;<stylename/>&quot;  align=&quot;<just/>&quot;&gt;&lt;H1&gt;</begin>
+<end>&lt;/H1&gt;&lt;/div&gt;</end>
+</text>
+
+
+
+</style>
+-->
+
+</main>
diff --git a/data/sisu/conf/lighttpd/lighttpd.cfg.sisu b/data/sisu/conf/lighttpd/lighttpd.cfg.sisu
new file mode 100644
index 00000000..a8819e3c
--- /dev/null
+++ b/data/sisu/conf/lighttpd/lighttpd.cfg.sisu
@@ -0,0 +1,115 @@
+# lighttpd configuration file
+# 
+# use a it as base for lighttpd 1.0.0 and above
+#
+#%%  Options you really have to take care of
+#% 
+# modules to load
+# at least mod_access and mod_accesslog should be loaded
+# all other module should only be loaded if really neccesary
+# - saves some time
+# - saves memory
+server.dir-listing = "disable" 
+server.modules = ( "mod_rewrite",
+                   "mod_access",
+                   "mod_fastcgi",
+                   "mod_compress",
+                   "mod_accesslog")
+#%% a static document-root, for virtual-hosting take look at the
+#% server.virtual-* options
+server.document-root  = "/var/www/" 
+#server.document-root        = "/home/*username*/web/public/" 
+## 'Parent' domain on any server except davie.
+#server.document-root = "/home/*username*/public_html/" 
+##'Parent' domain for those of you currently on davie.textdrive.com, and all future servers. 
+#server.document-root = "/home/*username*/web/public/"
+#% where to send error-messages to
+server.errorlog       = "/home/[*username*]/var/lighttpd/log/lighttpd.error.log" 
+#% files to check for if .../ is requested
+server.indexfiles  = ( "index.php", "index.html",
+                       "index.htm", "index.rb")
+##% mimetype mapping
+##include "mime.types.conf"
+##include_shell "/usr/local/bin/confmimetype /etc/mime.types"
+#% mimetype mapping
+mimetype.assign    = (
+  ".pdf"           =>      "application/pdf",
+  ".gz"            =>      "application/x-gzip",
+  ".tar.gz"        =>      "application/x-tgz",
+  ".tgz"           =>      "application/x-tgz",
+  ".zip"           =>      "application/zip",
+  ".gif"           =>      "image/gif",
+  ".jpg"           =>      "image/jpeg",
+  ".jpeg"          =>      "image/jpeg",
+  ".png"           =>      "image/png",
+  ".css"           =>      "text/css",
+  ".html"          =>      "text/html",
+  ".htm"           =>      "text/html",
+  ".js"            =>      "text/javascript",
+  ".text"          =>      "text/plain",
+  ".txt"           =>      "text/plain",
+  ".s1"            =>      "text/plain",
+  ".s2"            =>      "text/plain",
+  ".s3"            =>      "text/plain",
+  ".dtd"           =>      "text/xml",
+  ".xml"           =>      "text/xml",
+  ".odt"           =>      "application/vnd.oasis.opendocument.text",
+  ".bz2"           =>      "application/x-bzip",
+  ".tbz"           =>      "application/x-bzip-compressed-tar",
+  ".tar.bz2"       =>      "application/x-bzip-compressed-tar" 
+ )
+# text/x-server-parsed-html
+#%Server ID Header
+server.tag         = "lighttpd | TextDriven" 
+#%### accesslog module
+accesslog.filename = "/home/[*username*]/var/lighttpd/log/access_log" 
+#% deny access the file-extensions
+#
+# ~    is for backupfiles from vi, emacs, joe, ...
+# .inc is often used for code includes which should in general not be part
+#      of the document-root
+url.access-deny    = ( "~", ".inc" )
+
+#%% Options that are good to be but not neccesary to be changed
+##% bind to port (default: 80)
+server.port                = 81
+#server.port                = 8111
+#server.port        =  8965
+##% bind to localhost (default: all interfaces)
+server.bind                = "localhost" 
+#server.bind                = "corundum" 
+##server.bind                = "grisu.home.kneschke.de" 
+##% to help the rc.scripts
+server.pid-file    = "/home/[*username*]/var/lighttpd/run/lighttpd.pid" 
+#$HTTP["host"] =~ "\.corundum\.(name|com|net|org)" {
+$HTTP["host"] == "localhost" {
+  server.document-root = "/var/www/" 
+  server.errorlog = "/home/[*username*]/var/lighttpd/log/lighttpd-error.log" 
+  accesslog.filename = "/home/[*username*]/var/lighttpd/log/access_log" 
+  url.rewrite-repeat = (
+    "^.*/$"                       => "index.html",
+    "^(.*/(landscape|portrait))$" => "$1.pdf",
+    "^(.*/(opendocument))$"       => "$1.odt",
+    "^(.*/(sax|dom))$"            => "$1.xml",
+    "^([^.]+)$"                   => "$1.html"
+  )
+  server.error-handler-404 = "/dispatch.fcgi" 
+#  fastcgi.server = ( ".fcgi" =>
+#    ( "localhost" =>
+#       (
+#         "socket"   => "/home/[*username*]/var/lighttpd/cgi/lighttpd-fcgi.socket",
+#         "bin-path" => "/home/[*username*]/var/lighttpd/public/dispatch.fcgi",
+#         "min-procs" => 1,
+#         "max-procs" => 2,
+#         "idle-timeout" => 60
+#       )
+#    )
+#  )
+} 
+#% change uid to <uid> (default: don't care)
+server.username            = "[*username*]" 
+#% change uid to <uid> (default: don't care)
+server.groupname           = "[*username*]" 
+#%## compress module
+compress.cache-dir         = "/home/[*username*]/var/lighttpd/cache/compress/" 
+compress.filetype          = ("text/plain", "text/html")
diff --git a/data/sisu/conf/lighttpd/lighttpd.cfg.sisu_www b/data/sisu/conf/lighttpd/lighttpd.cfg.sisu_www
new file mode 100644
index 00000000..d23c12ce
--- /dev/null
+++ b/data/sisu/conf/lighttpd/lighttpd.cfg.sisu_www
@@ -0,0 +1,115 @@
+# lighttpd configuration file
+# 
+# use a it as base for lighttpd 1.0.0 and above
+#
+#%%  Options you really have to take care of
+#% 
+# modules to load
+# at least mod_access and mod_accesslog should be loaded
+# all other module should only be loaded if really neccesary
+# - saves some time
+# - saves memory
+server.dir-listing = "disable" 
+server.modules = ( "mod_rewrite",
+                   "mod_access",
+                   "mod_fastcgi",
+                   "mod_compress",
+                   "mod_accesslog")
+#%% a static document-root, for virtual-hosting take look at the
+#% server.virtual-* options
+server.document-root  = "/home/[user home]/sisu_www/" 
+#server.document-root        = "/home/*username*/web/public/" 
+## 'Parent' domain on any server except davie.
+#server.document-root = "/home/*username*/public_html/" 
+##'Parent' domain for those of you currently on davie.textdrive.com, and all future servers. 
+#server.document-root = "/home/*username*/web/public/"
+#% where to send error-messages to
+server.errorlog       = "/home/[*username*]/var/lighttpd/log/lighttpd.error.log" 
+#% files to check for if .../ is requested
+server.indexfiles  = ( "index.php", "index.html",
+                       "index.htm", "index.rb")
+##% mimetype mapping
+##include "mime.types.conf"
+##include_shell "/usr/local/bin/confmimetype /etc/mime.types"
+#% mimetype mapping
+mimetype.assign    = (
+  ".pdf"           =>      "application/pdf",
+  ".gz"            =>      "application/x-gzip",
+  ".tar.gz"        =>      "application/x-tgz",
+  ".tgz"           =>      "application/x-tgz",
+  ".zip"           =>      "application/zip",
+  ".gif"           =>      "image/gif",
+  ".jpg"           =>      "image/jpeg",
+  ".jpeg"          =>      "image/jpeg",
+  ".png"           =>      "image/png",
+  ".css"           =>      "text/css",
+  ".html"          =>      "text/html",
+  ".htm"           =>      "text/html",
+  ".js"            =>      "text/javascript",
+  ".text"          =>      "text/plain",
+  ".txt"           =>      "text/plain",
+  ".s1"            =>      "text/plain",
+  ".s2"            =>      "text/plain",
+  ".s3"            =>      "text/plain",
+  ".dtd"           =>      "text/xml",
+  ".xml"           =>      "text/xml",
+  ".odt"           =>      "application/vnd.oasis.opendocument.text",
+  ".bz2"           =>      "application/x-bzip",
+  ".tbz"           =>      "application/x-bzip-compressed-tar",
+  ".tar.bz2"       =>      "application/x-bzip-compressed-tar" 
+ )
+# text/x-server-parsed-html
+#%Server ID Header
+server.tag         = "lighttpd | TextDriven" 
+#%### accesslog module
+accesslog.filename = "/home/[*username*]/var/lighttpd/log/access_log" 
+#% deny access the file-extensions
+#
+# ~    is for backupfiles from vi, emacs, joe, ...
+# .inc is often used for code includes which should in general not be part
+#      of the document-root
+url.access-deny    = ( "~", ".inc" )
+
+#%% Options that are good to be but not neccesary to be changed
+##% bind to port (default: 80)
+server.port                = 8111
+#server.port                = 8111
+#server.port        =  8965
+##% bind to localhost (default: all interfaces)
+server.bind                = "localhost" 
+#server.bind                = "corundum" 
+##server.bind                = "grisu.home.kneschke.de" 
+##% to help the rc.scripts
+server.pid-file    = "/home/[*username*]/var/lighttpd/run/lighttpd.pid" 
+#$HTTP["host"] =~ "\.corundum\.(name|com|net|org)" {
+$HTTP["host"] == "localhost" {
+  server.document-root = "/home/[*username*]/sisu_www/" 
+  server.errorlog = "/home/[*username*]/var/lighttpd/log/lighttpd-error.log" 
+  accesslog.filename = "/home/[*username*]/var/lighttpd/log/access_log" 
+  url.rewrite-repeat = (
+    "^.*/$"                       => "index.html",
+    "^(.*/(landscape|portrait))$" => "$1.pdf",
+    "^(.*/(opendocument))$"       => "$1.odt",
+    "^(.*/(sax|dom))$"            => "$1.xml",
+    "^([^.]+)$"                   => "$1.html"
+  )
+  server.error-handler-404 = "/dispatch.fcgi" 
+#  fastcgi.server = ( ".fcgi" =>
+#    ( "localhost" =>
+#       (
+#         "socket"   => "/home/[*username*]/var/lighttpd/cgi/lighttpd-fcgi.socket",
+#         "bin-path" => "/home/[*username*]/var/lighttpd/public/dispatch.fcgi",
+#         "min-procs" => 1,
+#         "max-procs" => 2,
+#         "idle-timeout" => 60
+#       )
+#    )
+#  )
+} 
+#% change uid to <uid> (default: don't care)
+server.username            = "[*username*]" 
+#% change uid to <uid> (default: don't care)
+server.groupname           = "[*username*]" 
+#%## compress module
+compress.cache-dir         = "/home/[*username*]/var/lighttpd/cache/compress/" 
+compress.filetype          = ("text/plain", "text/html")
diff --git a/data/sisu/conf/ruby/irbrc b/data/sisu/conf/ruby/irbrc
new file mode 100644
index 00000000..b585faf6
--- /dev/null
+++ b/data/sisu/conf/ruby/irbrc
@@ -0,0 +1,19 @@
+require 'irb/completion'
+IRB.conf[:use_readline] = true
+IRB.conf[:PROMPT_MODE] = :XMP
+#IRB.conf[:PROMPT] = 
+#simple-prompt
+def ri arg
+  puts `ri #{arg}`
+end
+def ri(*names)
+  system(%{ri #{names.map {|name| name.to_s}.join(" ")}})
+end
+#require 'rdoc/ri/ri_driver'
+#def ri(*names)
+#  oargv = Object.const_get(:ARGV)
+#  Object.const_set(:ARGV, names)
+#  RiDriver.new.process_args
+#  Object.const_set(:ARGV, oargv)
+#end
+
diff --git a/data/sisu/conf/syntax/README b/data/sisu/conf/syntax/README
new file mode 100644
index 00000000..04c0ea09
--- /dev/null
+++ b/data/sisu/conf/syntax/README
@@ -0,0 +1,92 @@
+This directory
+  sisu-examples/sisu-examples/config/syntax_hi/
+  /usr/share/sisu-examples/sisu-examples/config/syntax_hi
+contains rudimentary sisu syntax highlighting files for:
+
+* (g)vim http://www.vim.org
+  * package: sisu-vim
+  * status: largely done
+  * comments: not found here
+    a vim syntax highlighting and folds component of sisu exists,
+    see sisu-vim
+
+* gedit http://www.gnome.org/projects/gedit
+* gobby http://gobby.0x539.de/
+  file: sisu.lang
+  place in:
+    /usr/share/gtksourceview-1.0/language-specs
+  or
+    ~/.gnome2/gtksourceview-1.0/language-specs
+  * status: very basic syntax highlighting
+  * comments: this editor features display line wrap and is used by Goby!
+
+* nano http://www.nano-editor.org
+  file: nanorc
+  save as:
+    ~/.nanorc
+  includes:
+  * status: basic syntax highlighting
+  * comments: assumes dark background
+    no display line-wrap
+    does line breaks
+
+* diakonos (an editor written in ruby) http://purepistos.net/diakonos
+  file: diakonos.conf
+  save as:
+    ~/.diakonos/diakonos.conf
+  includes:
+  * status: basic syntax highlighting
+  * comments: assumes dark background
+    no display line-wrap
+
+* kate & kwrite http://kate.kde.org
+  file: sisu.xml
+  place in:
+    /usr/share/apps/katepart/syntax
+  or
+    ~/.kde/share/apps/katepart/syntax
+  [settings::configure kate::{highlighting,filetypes}]
+  [tools::highlighting::{markup,scripts}::SiSU]
+
+* nedit http://www.nedit.org
+  file: sisu_nedit.pats
+  nedit -import sisu_nedit.pats
+  * status: a very clumsy first attempt
+  [not really done]
+  * comments: this editor features display line wrap
+
+* emacs http://www.gnu.org/software/emacs/emacs.html
+  files: sisu-mode.el
+  to file ~/.emacs add the following 2 lines:
+    (add-to-list 'load-path "/usr/share/sisu-examples/config/syntax_hi")
+    (require 'sisu-mode.el)
+  [not done / not yet included]
+
+* vim & gvim http://www.vim.org
+  files: sisu-vim http://www.jus.uio.no/sisu/SiSU/download
+  package is the most comprehensive sisu syntax highlighting and editor
+  environment provided to date (is for vim/ gvim, and is separate from the
+  contents of this directory)
+  on debian:
+    aptitude install sisu-vim
+  * status: this includes:
+    syntax highlighting
+    vim folds
+    some error checking
+  * comments: this editor features display line wrap
+
+NOTE: 
+
+[SiSU parses files with long lines or line breaks, 
+but, display linewrap (without line-breaks) is a 
+convenient editor feature to have for sisu markup]
+
+kde-config --prefix
+KDEDIR/share/apps/katepart/syntax/ 
+KDEHOME/share/apps/katepart/syntax
+[In the configure dialog in kate, go to the "Editor->highlighting" page and 
+>select a highlight to change the mimetype/pattern associations for it.]    
+/etc/mime.types
+/usr/share/mime/text
+# 
+# * aeditor (an editor written in ruby)
diff --git a/data/sisu/conf/syntax/diakonos.conf b/data/sisu/conf/syntax/diakonos.conf
new file mode 100644
index 00000000..212ed5b8
--- /dev/null
+++ b/data/sisu/conf/syntax/diakonos.conf
@@ -0,0 +1,979 @@
+logfile ~/.diakonos/diakonos.log
+
+# When the cursor is view.margin.y lines or less from the top or
+# bottom line, repeatedly scroll the screen view.jump.y lines until
+# the cursor is more than view.margin.y lines from the top and
+# bottom line.
+# Similarly for view.margin.x and view.jump.x, with respect to the
+# left-most and right-most screen columns.
+view.margin.x 10
+view.margin.y 5
+view.jump.x 10
+view.jump.y 5
+view.scroll_amount 3
+view.lookback 200
+view.nonfilelines.visible false
+view.nonfilelines.character ~
+
+# bol_behaviour: This specifies where the cursor should go when the
+# beginning-of-line key (the default is the Home key) is pressed.
+#    zero: Always move to the left-most column of the line
+#    first-char: Always move to the left-most non-whitespace character
+#    alternating-zero: As with 'zero', unless the cursor is
+#        already there, in which case, as with 'first-char'.
+#    alternating-first-char: As with 'first-char', unless the cursor is
+#        already there, in which case, as with 'zero'.
+# bol_behavior is a synonym for bol_behaviour.
+bol_behaviour alternating-first-char
+
+# Ensures saved files end with a newline character by adding it if necessary.
+eof_newline false
+
+# Specifies whether the cursor should be at the end (false) of found text, or the
+# beginning (true).  
+found_cursor_start false
+
+max_clips 30
+
+# The maximum number of undo lines held in memory per file
+# Smaller files will be able to have more undo levels.
+max_undo_lines 100000
+
+convert_tabs false
+
+diff_command diff -U 5
+
+# Whether or not to use /usr/bin/file to determine whether files are readable
+# before opening them.
+use_magic_file false
+
+# ---------------------------------------------------------------------
+# Status Line
+
+# Use "% syntax" as placeholders
+# e.g. %d for decimal integers, %s for strings
+status.left -- %s %s%s%s -- (%s) -
+status.right - Buf %d of %d --- L%3d/%3d C%2d --
+# The string to use to fill in the space between the left and right sides
+# of the status line.
+status.filler -
+status.modified_str (modified)
+status.selecting_str (selecting)
+status.unnamed_str (unnamed file)
+status.read_only_str (read-only)
+# status.vars: any subset of:
+# line row num_lines col filename modified type buffer_number num_buffers selecting read_only
+status.vars filename modified read_only selecting type buffer_number num_buffers row num_lines col
+status.format inverse
+
+# ---------------------------------------------------------------------
+# Context Line
+
+# The context line shows the wrapping context of the cursor, with respect to
+# indentation.  This shows the current code block(s) that the cursor is in.
+
+context.visible false
+context.combined false
+context.max_levels 4
+context.format inverse
+context.separator |
+context.separator.format red inverse
+#context.max_segment_width 10
+
+# ---------------------------------------------------------------------
+# Interaction Line
+
+# Duration of "alert" blink (in seconds) when user has made an invalid choice
+interaction.blink_duration 0.05
+interaction.blink_string ***********************************************************
+# Time to wait (in seconds) before accepting user keystrokes when prompting for
+# a choice which has no default
+interaction.choice_delay 3
+
+# ---------------------------------------------------------------------
+# Key Configuration
+# key <keystroke> [<keystroke>...];<function> [<arg>[,<arg>...]]
+# If no function is specified, it unmaps any previous mapping.
+# i.e. key <keystroke> [<keystroke>...];
+# <keystroke> can be "keycode##" to specify specific keycodes.
+# e.g. key keycode8;delete
+# Note the lack of space after the word keycode.
+
+# To obtain the string to use for any keychain, use the printKeychain command
+# (default alt+k).
+
+# The shell, execute and pasteShellResult commands can take variables:
+
+# $f  current buffer's filepath
+# $F  all current buffer filepaths, space-separated
+# $i  get a string from user input
+# $c  temp file containing current clipboard text
+# $s  temp file containing currently selected text
+
+key left;cursorLeft
+key esc [ D;cursorLeft
+key right;cursorRight
+key esc [ C;cursorRight
+key up;cursorUp
+key esc [ A;cursorUp
+key down;cursorDown
+key esc [ B;cursorDown
+key home;cursorBOL
+key esc O H;cursorBOL
+key esc [ H;cursorBOL
+key esc [ 1 ~   cursorBOL
+key end;cursorEOL
+key esc O F;cursorEOL
+key esc [ F;cursorEOL
+key esc [ 4 ~;cursorEOL
+key pageup;pageUp
+key pagedown;pageDown
+key ctrl+a;cursorBOL
+key ctrl+e;cursorEOL
+key alt+<;cursorBOF
+key alt+>;cursorEOF
+key alt+,;cursorTOV
+key alt+.;cursorBOV
+key ctrl+j;cursorReturn
+key ctrl+l;cursorReturn "forward"
+key alt+n;scrollDown
+key alt+p;scrollUp
+key esc up;scrollUp
+key esc [ 1 ; 3 A    scrollUp
+key esc [ 1 ; 5 A    scrollUp
+key keycode520       scrollUp
+key esc down;scrollDown
+key esc [ 1 ; 3 B    scrollDown
+key esc [ 1 ; 5 B    scrollDown
+key keycode513       scrollDown
+key esc right;seek /(?:^|\W)(\w)|\w(\W|$)/
+key esc [ 1 ; 3 C    seek /\w(\W|$)|(?:^|\W)(\w)/
+key esc [ 1 ; 5 C    seek /\w(\W|$)|(?:^|\W)(\w)/
+key keycode517       seek /\w(\W|$)|(?:^|\W)(\w)/
+key esc left;seek /\w(\W|$)|(?:^|\W)(\w)/, "up"
+key esc [ 1 ; 3 D    seek /\w(\W|$)|(?:^|\W)(\w)/, "up"
+key esc [ 1 ; 5 D    seek /\w(\W|$)|(?:^|\W)(\w)/, "up"
+key keycode515       seek /\w(\W|$)|(?:^|\W)(\w)/, "up"
+
+key ctrl+g;goToLineAsk
+key alt+b alt+b;toggleBookmark
+key alt+b alt+n;goToNextBookmark
+key alt+b alt+p;goToPreviousBookmark
+key alt+b alt+a;addNamedBookmark
+key alt+b alt+r;removeNamedBookmark
+key alt+b alt+g;goToNamedBookmark
+key alt+b alt+!;addNamedBookmark 1
+key alt+b alt+@;addNamedBookmark 2
+key alt+b alt+#;addNamedBookmark 3
+key alt+b alt+$;addNamedBookmark 4
+key alt+b alt+%;addNamedBookmark 5
+key alt+b alt+1;goToNamedBookmark 1
+key alt+b alt+2;goToNamedBookmark 2
+key alt+b alt+3;goToNamedBookmark 3
+key alt+b alt+4;goToNamedBookmark 4
+key alt+b alt+5;goToNamedBookmark 5
+key alt+t;goToTag
+key alt+);goToTagUnderCursor
+key alt+(;popTag
+
+key backspace;backspace
+key ctrl+h;backspace
+key del;delete
+#key ctrl+k;deleteLine
+key ctrl+k;deleteAndStoreLine
+key ctrl+alt+k;deleteToEOL
+key esc del;collapseWhitespace
+key esc [ 3 ; 3 ~    collapseWhitespace
+key enter;carriageReturn
+key tab;parsedIndent
+#key tab;indent
+#key ctrl+alt+l;unindent
+key alt+i;indent
+key esc i;indent
+key esc I;unindent
+key keycode353    unindent
+#key tab;insertSpaces 4
+#key tab;insertTab
+key ctrl+t;insertTab
+
+key f1            help
+key esc O P       help
+key esc [ 1 1 ~   help
+key esc [ [ A     help
+key f11;loadConfiguration
+key esc [ 2 3 ~;loadConfiguration
+key f12;openFile "~/.diakonos/diakonos.conf"
+key esc [ 2 4 ~;openFile "~/.diakonos/diakonos.conf"
+
+key ctrl+alt+r;redraw
+key esc C;toggleSessionSetting 'context.visible', DO_REDRAW
+key ctrl+alt+d;toggleSessionSetting 'display'
+
+key ctrl+n;newFile
+key ctrl+o;openFileAsk
+key ctrl+s;saveFile
+key alt+s;saveFileAs
+key ctrl+w;closeFile
+key ctrl+alt+o;revert
+key alt+!;setReadOnly
+key ctrl+q;quit
+key esc T;setBufferType
+
+key alt+1;switchToBufferNumber 1
+key alt+2;switchToBufferNumber 2
+key alt+3;switchToBufferNumber 3
+key alt+4;switchToBufferNumber 4
+key alt+5;switchToBufferNumber 5
+key alt+6;switchToBufferNumber 6
+key alt+7;switchToBufferNumber 7
+key alt+8;switchToBufferNumber 8
+key alt+9;switchToBufferNumber 9
+key alt+0;switchToBufferNumber 10
+key alt+-;switchToPreviousBuffer
+key alt+=;switchToNextBuffer
+
+key ctrl+space;anchorSelection
+#key ctrl+space;toggleSelection
+key ctrl+c;copySelection
+key ctrl+x;cutSelection
+key alt+u;removeSelection
+key ctrl+alt+v;showClips
+key ctrl+v;paste
+key ctrl+y;unundo
+key ctrl+z;undo
+#key ctrl+z;suspend
+key suspend;undo
+#key suspend;suspend
+
+key ctrl+f;find
+#key ctrl+f;find "down", CASE_SENSITIVE
+key alt+f;find "down", CASE_SENSITIVE
+#key alt+f;findExact
+key ctrl+alt+f;find "up"
+#key ctrl+alt+f;find "up", CASE_SENSITIVE
+key f3;findAgain "down"
+key esc [ [ C        findAgain "down"
+key esc O R;findAgain "down"
+key esc [ 1 3 ~;findAgain "down"
+key f15;findAgain "up"
+key esc [ 2 8 ~   findAgain "up"
+key esc O 2 R;findAgain "up"
+key ctrl+r;searchAndReplace
+key ctrl+alt+u;clearMatches
+
+key f2            shell
+key esc O Q       shell
+key esc [ 1 2 ~   shell
+key esc [ [ B     shell
+key f8;execute
+key esc F;execute "glark '$i' $F | less"
+key esc d         shell "diff -U 5 -w -b $c $s"
+#key esc F;shell "grep -n '$i' $F"
+#key esc F;execute "grep -n '$i' $F | less"
+key f14         evaluate
+key esc O 2 Q   evaluate
+esc [ 2 6 ~     evaluate
+key ctrl+alt+c;shell "ruby -c $f"
+key ctrl+alt+d;shell "php -l $f"
+
+# To use the following:
+# 1) Copy to the clipboard some Ruby code which operates on stdin text and outputs to stdout.
+# 2) Select (highlight) some text to operate on.
+# 3) Activate this pasteShellResult command.
+# 4) The selected text should now be replaced with the script's results.
+key ctrl+alt+p;pasteShellResult "cat $s | ruby $c"
+#key ctrl+alt+p;pasteShellResult "cat $s | perl $c"
+#key ctrl+alt+p;pasteShellResult "cat $s | python $c"
+#key ctrl+alt+p;pasteShellResult "cat $s | sed -f $c"
+#key ctrl+alt+p;pasteShellResult "cat $s | awk -f $c"
+
+key alt+k        printKeychain
+key alt+m;toggleMacroRecording
+key f4            playMacro
+key esc O S       playMacro
+key esc [ 1 4 ~   playMacro
+key esc [ [ D     playMacro
+key f5            loadScript
+key esc [ 1 5 ~   loadScript
+key esc [ [ E     loadScript
+key f6;repeatLast
+key esc [ 1 7 ~;repeatLast
+key f7;operateOnEachLine
+key f19;operateOnString
+key esc f7;operateOnLines
+
+# Emacs-like keychains
+
+#key ctrl+s;find
+#key ctrl+x ctrl+c;quit
+#key ctrl+x ctrl+f;openFileAsk
+#key ctrl+x ctrl+s;saveFile
+
+# ---------------------------------------------------------------------
+# Colour Definitions
+#
+# colour <integer greater than 7> <foreground colour> <background colour>
+#
+# For a list of colour names, see the list of format codes in the
+# Language Definitions section, below.
+# This colour command is only used when you want to set a different background
+# colour than the terminal default.
+#
+# color is a synonym for colour.
+colour 8 white blue
+colour 9 white red
+colour 10 white magenta
+colour 11 yellow blue
+colour 12 white green
+colour 13 white brown
+colour 14 black cyan
+colour 15 yellow red
+
+# ---------------------------------------------------------------------
+# Language Definitions
+# For syntax highlighting and indentation.
+
+# lang.<language>.tokens.<any name>[.case_insensitive] <regexp with one pair of parentheses identifying the token>
+# lang.<language>.tokens.<any name>.format <format codes>
+# <format codes> can be any subset of:
+#     normal black red green brown blue magenta cyan white standout underline inverse blink dim bold
+# The numbers of colour pairs (as defined by the configuration command "colour")
+# can also be used as format codes.
+#
+# indent.roundup: If a line's indentation is not evenly divisible by the
+# indent.size, and indent.roundup is true, then the non-integer indentation
+# level will be rounded up.  If indent.roundup is false, then it will be
+# rounded down.
+# e.g. given an indent.size of 4, and a line with 6 spaces, indent.roundup
+# true will make Diakonos consider the line indented 2 levels.  With
+# indent.roundup false, it will be considered indented 1 level.
+#
+# The filemask can also be used to specify specific filenames which
+# don't conform to the standard extensions for a language.
+
+# Text (default)
+
+lang.text.format.default white
+lang.text.format.selection inverse
+lang.text.format.found yellow inverse
+lang.text.indent.size 2
+lang.text.indent.auto true
+lang.text.indent.roundup false
+#lang.text.indent.using_tabs true
+lang.text.tabsize 8
+
+lang.xml.filemask \.(xml|rdl|aiml|xhtml)$
+lang.xml.format.default white
+lang.xml.format.selection inverse
+lang.xml.format.found yellow inverse
+lang.xml.tabsize 8
+lang.xml.indent.size 4
+lang.xml.indent.auto true
+lang.xml.indent.roundup true
+#lang.xml.indent.using_tabs true
+lang.xml.tokens.entities &\S+?;
+lang.xml.tokens.entities.format magenta bold
+lang.xml.tokens.code.open (<)(?:[^%]|$)
+lang.xml.tokens.code.close (?:[^%]|^)(>)
+lang.xml.tokens.code.format white bold
+lang.xml.tokens.code.change_to xml_tag
+lang.xml.tokens.comments.open (<!--)
+lang.xml.tokens.comments.close (-->)
+lang.xml.tokens.comments.format 8
+lang.xml.tokens.comments.change_to xml_comment
+lang.xml.tokens.template.open \[@--
+lang.xml.tokens.template.close --@\]
+lang.xml.tokens.template.format brown
+lang.xml.tokens.template.change_to perl
+lang.xml_tag.format.default white bold
+lang.xml_tag.format.selection inverse
+lang.xml_tag.format.found yellow inverse
+lang.xml_tag.tabsize 8
+lang.xml_tag.indent.size 4
+lang.xml_tag.indent.auto true
+lang.xml_tag.indent.roundup true
+#lang.xml_tag.indent.using_tabs true
+lang.xml_tag.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.xml_tag.tokens.doublequoted_strings.format green bold
+lang.xml_tag.tokens.singlequoted_strings ('.*?[^\\]')
+lang.xml_tag.tokens.singlequoted_strings.format green bold
+lang.xml_tag.tokens.symbols ([@!#$%^&*()\[\]{}/?=+\-\\|,<.>;:])
+lang.xml_tag.tokens.symbols.format white
+lang.xml_comment.format.default 8
+lang.xml_comment.format.selection inverse
+lang.xml_comment.format.found yellow inverse
+lang.xml_comment.tabsize 8
+lang.xml_comment.indent.size 4
+lang.xml_comment.indent.auto true
+lang.xml_comment.indent.roundup true
+#lang.xml_comment.indent.using_tabs true
+
+lang.html.filemask \.(r?html?|php|asp)$
+lang.html.format.default white
+lang.html.format.selection inverse
+lang.html.format.found yellow inverse
+lang.html.tabsize 8
+lang.html.indent.size 4
+lang.html.indent.auto true
+lang.html.indent.roundup true
+#lang.html.indent.using_tabs true
+lang.html.tokens.code.open (<)(?:[^%]|$)
+lang.html.tokens.code.close (?:[^%]|^)(>)
+lang.html.tokens.code.format white bold
+lang.html.tokens.code.change_to html_tag
+lang.html.tokens.entities &\S+?;
+lang.html.tokens.entities.format magenta bold
+lang.html.tokens.eruby.open <%
+lang.html.tokens.eruby.close %>
+lang.html.tokens.eruby.format 9 bold
+lang.html.tokens.eruby.change_to ruby
+lang.html.tokens.php.open <\?(?:php)?
+lang.html.tokens.php.close \?>
+lang.html.tokens.php.format 10 bold
+lang.html.tokens.php.change_to php
+lang.html.tokens.comments.open (<!--)
+lang.html.tokens.comments.close (-->)
+lang.html.tokens.comments.format 8
+lang.html.tokens.comments.change_to html_comment
+lang.html_tag.format.default white bold
+lang.html_tag.format.selection inverse
+lang.html_tag.format.found yellow inverse
+lang.html_tag.tabsize 8
+lang.html_tag.indent.size 4
+lang.html_tag.indent.auto true
+lang.html_tag.indent.roundup true
+#lang.html_tag.indent.using_tabs true
+lang.html_tag.tokens.attribute (href)
+lang.html_tag.tokens.attribute.format green bold
+lang.html_tag.tokens.elements.case_insensitive \b(A|ABBR|ACRONYM|ADDRES|APPLET|AREA|B|BASE|BASEFONT|BDO|BIG|BLOCKQUOTE|BODY|BR|BUTTON|CAPTION|CENTER|CITE|CODE|COL|COLGROUP|DD|DEL|DFN|DIR|DIV|DL|DT|EM|FIELDSET|FONT|FORM|FRAME|FRAMESET|H1|H2|H3|H4|H5|H6|HEAD|HR|HTML|I|IFRAME|IMG|INPUT|INS|ISINDEX|KBD|LABEL|LEGEND|LI|LINK|MAP|MENU|META|NOFRAMES|NOSCRIPT|OBJECT|OL|OPTGROUP|OPTION|P|PARAM|PRE|Q|S|SAMP|SCRIPT|SELECT|SMALL|SPAN|STRIKE|STRONG|STYLE|SUB|SUP|TABLE|TBODY|TD|TEXTAREA|TFOOT|TH|THEAD|TITLE|TR|TT|U|UL|VA)\b
+lang.html_tag.tokens.elements.format cyan
+lang.html_tag.tokens.attributes.case_insensitive \b(abbr|accept-charset|accept|accesskey|action|align|alink|alt|archive|axis|background|bgcolor|border|cellpadding|cellspacing|char|charoff|charset|checked|cite|class|classid|clear|code|codebase|codetype|color|cols|colspan|compact|content|coords|data|datetime|declare|defer|dir|disabled|enctype|face|for|frame|frameborder|headers|height|href|href|hreflang|hspace|http-equiv|id|ismap|label|lang|language|link|longdesc|marginheight|marginwidth|maxlength|media|method|multiple|name|nohref|noresize|noshade|nowrap|object|onblur|onchange|onclick|ondblclick|onfocus|onkeydown|onkeypress|onkeyup|onload|onmousedown|onmousemove|onmouseout|onmouseover|onmouseup|onreset|onselect|onsubmit|onunload|profile|prompt|readonly|rel|rev|rows|rowspan|rules|scheme|scope|scrolling|selected|shape|size|span|src|standby|start|style|summary|tabindex|target|text|title|type|usemap|valign|value|valuetype|version|vlink|vspace|width)\b
+lang.html_tag.tokens.attributes.format white
+lang.html_tag.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.html_tag.tokens.doublequoted_strings.format green bold
+lang.html_tag.tokens.singlequoted_strings ('.*?[^\\]')
+lang.html_tag.tokens.singlequoted_strings.format green bold
+lang.html_tag.tokens.symbols ([@!#$%^&*()\[\]{}/?=+\-\\|,<.>;:])
+lang.html_tag.tokens.symbols.format white
+lang.html_comment.format.default 8
+lang.html_comment.format.selection inverse
+lang.html_comment.format.found yellow inverse
+lang.html_comment.tabsize 8
+lang.html_comment.indent.size 4
+lang.html_comment.indent.auto true
+lang.html_comment.indent.roundup true
+#lang.html_comment.indent.using_tabs true
+
+# CSS
+
+lang.css.filemask \.css$
+lang.css.format.default white
+lang.css.format.selection inverse
+lang.css.format.found yellow inverse
+lang.css.tabsize 8
+lang.css.indent.size 4
+lang.css.indent.auto true
+lang.css.indent.roundup true
+#lang.css.indent.using_tabs true
+lang.css.indent.indenters (\{)
+lang.css.indent.unindenters (\})
+lang.css.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(\/\/.*)
+lang.css.tokens.properties \b(azimuth|background-attachment|background-color|background-image|background-position|background-repeat|background|border-collapse|border-color|border-spacing|border-style|border-top|border-bottom|border-right|border-left|border-top-color|border-top-style|border-top-width|border-width|border|bottom|caption-side|clear|clip|color|content|counter-increment|counter-reset|cue-after|cue-before|cue|cursor|direction|display|elevation|empty-cells|float|font-family|font-size|font-style|font-variant|font-weight|font|height|left|letter-spacing|line-height|list-style-image|list-style-position|list-style-type|list-style|margin-right|margin-top|margin-left|margin-bottom|margin|max-height|max-width|min-height|min-width|orphans|outline-color|outline-style|outline-width|outline|overflow|padding-top|padding-left|padding-right|padding-bottom|padding|page-break-after|page-break-before|page-break-inside|pause-after|pause-before|pause|pitch-range|pitch|play-during|position|quotes|richness|right|speak-header|speak-numeral|speak-punctuation|speak|speech-rate|stress|table-layout|text-align|text-decoration|text-indent|text-transform|top|unicode-bidi|vertical-align|visibility|voice-family|volume|white-space|widows|width|word-spacing|z-index):
+lang.css.tokens.properties.format white bold
+lang.css.tokens.colours #[A-Fa-f0-9]{6}|\b(?:aqua|black|blue|fuchsia|gray|green|lime|maroon|navy|olive|orange|purple|red|silver|teal|white|yellow)\b
+lang.css.tokens.colours.format yellow bold
+lang.css.tokens.long_comments.open \/\*
+lang.css.tokens.long_comments.close \*\/
+lang.css.tokens.long_comments.format 8 bold
+lang.css.tokens.numbers \b([0-9]+\.[0-9]+|[0-9]+)
+lang.css.tokens.numbers.format blue bold
+lang.css.tokens.units [^A-Za-z](em|pt|px)\b
+lang.css.tokens.units.format cyan
+lang.css.tokens.html_elements.case_insensitive \b(A|ABBR|ACRONYM|ADDRES|APPLET|AREA|B|BASE|BASEFONT|BDO|BIG|BLOCKQUOTE|BODY|BR|BUTTON|CAPTION|CENTER|CITE|CODE|COL|COLGROUP|DD|DEL|DFN|DIR|DIV|DL|DT|FIELDSET|FORM|FRAME|FRAMESET|H1|H2|H3|H4|H5|H6|HEAD|HR|HTML|I|IFRAME|IMG|INPUT|INS|ISINDEX|KBD|LABEL|LEGEND|LI|LINK|MAP|MENU|META|NOFRAMES|NOSCRIPT|OBJECT|OL|OPTGROUP|OPTION|P|PARAM|PRE|Q|S|SAMP|SCRIPT|SELECT|SMALL|SPAN|STRIKE|STRONG|STYLE|SUB|SUP|TABLE|TBODY|TD|TEXTAREA|TFOOT|TH|THEAD|TITLE|TR|TT|U|UL|VA)\b
+lang.css.tokens.html_elements.format green
+lang.css.tokens.values \b(auto|block|inherit|inline|larger|none|smaller|solid)\b
+lang.css.tokens.values.format blue bold
+
+# Ruby
+
+lang.ruby.filemask (?:[Rr]akefile)|(?:\.(?:rb|gem(?:spec)?)$)
+lang.ruby.bangmask ruby
+lang.ruby.format.default white bold
+lang.ruby.format.selection inverse
+lang.ruby.format.found yellow inverse
+lang.ruby.tokens.reserved_words \b(__FILE__|and|def|end|in|or|self|unless|__LINE__|begin|defined\?|ensure|module|redo|super|until|BEGIN|break|do|false|next|rescue|then|when|END|case|else|for|nil|retry|true|while|alias|class|elsif|if|not|return|undef|yield)\b
+lang.ruby.tokens.reserved_words.format white
+lang.ruby.tokens.constants \b([A-Z_]+|[A-Z_][A-Z0-9_]+)\b
+lang.ruby.tokens.constants.format yellow bold
+lang.ruby.tokens.symbols [@!#$%^&*()\[\]{}/?=+\-\\|,<.>;:~]
+lang.ruby.tokens.symbols.format white
+lang.ruby.tokens.class_variables (@[A-Za-z_][A-Za-z_0-9]*)
+lang.ruby.tokens.class_variables.format white bold
+lang.ruby.tokens.comments (#.*)
+lang.ruby.tokens.comments.format 8 bold
+lang.ruby.tokens.regular_expressions (\/.+?[^\\]\/)
+lang.ruby.tokens.regular_expressions.format red bold
+lang.ruby.tokens.doublequoted_strings (\".*?[^\\]\"|\"\")
+lang.ruby.tokens.doublequoted_strings.format green bold
+lang.ruby.tokens.singlequoted_strings ('.*?[^\\]'|'')
+lang.ruby.tokens.singlequoted_strings.format green bold
+lang.ruby.tokens.backquoted_strings (`.*?[^\\]`|``)
+lang.ruby.tokens.backquoted_strings.format red bold
+lang.ruby.tokens.character_codes \W(\?\S)
+lang.ruby.tokens.character_codes.format magenta bold
+lang.ruby.tokens.long_comments.open ^=begin
+lang.ruby.tokens.long_comments.close ^=end
+lang.ruby.tokens.long_comments.format 8 bold
+lang.ruby.tokens.sql_string.open (<<-EOSQL)
+lang.ruby.tokens.sql_string.close (EOSQL)
+lang.ruby.tokens.sql_string.format 1
+lang.ruby.tokens.sql_string.change_to sql
+lang.ruby.indent.size 4
+lang.ruby.indent.auto true
+lang.ruby.indent.roundup true
+#lang.ruby.indent.using_tabs true
+lang.ruby.indent.indenters \b(do|def|begin|ensure|when|case|else|for|while|elsif|if|class|module|rescue)\b|([{\[(]$|\{\s*\|[\w\s,]*\|\s*$)
+lang.ruby.indent.unindenters \b(end|else|when|rescue)\b|(^\s+[\]})])
+lang.ruby.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(`.+?[^\\]`)|(\/.+?[^\\]\/)|(^\s*#.*)|\S\s+if
+lang.ruby.indent.ignore ^\s*$
+lang.ruby.context.ignore ^=(begin|end)$
+
+# PHP
+
+lang.php.filemask \.php\d?$
+lang.php.bangmask php
+lang.php.format.default white bold
+lang.php.format.selection inverse
+lang.php.format.found yellow inverse
+lang.php.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.php.tokens.doublequoted_strings.format green bold
+lang.php.tokens.singlequoted_strings ('.*?[^\\]')
+lang.php.tokens.singlequoted_strings.format green bold
+lang.php.tokens.reserved_words \b(NULL|E_ALL|__wakeup|not|endwhile|__sleep|new|endswitch|__LINE__|list|endif|__FILE__|global|endforeach|while|include_once|endfor|virtual|include|enddeclare|xor|if|empty|var|elseif|TRUE|else|this|echo|stdClass|die|switch|do|static|default|return|function|declare|require_once|foreach|continue|require|for|class|print|FALSE|cfunction|PHP_VERSION|extends|case|exit|break|PHP_OS|eval|argc|parent|E_WARNING|as|or|E_ERROR|argv|old_function|E_PARSE|and)\b
+lang.php.tokens.reserved_words.format white
+lang.php.tokens.constants \b([A-Z_]+|[A-Z_][A-Z0-9_]+)\b
+lang.php.tokens.constants.format yellow bold
+lang.php.tokens.comments (\/\/.*)
+lang.php.tokens.comments.format 8 bold
+lang.php.tokens.preprocessor (^\s*#.*)
+lang.php.tokens.preprocessor.format yellow bold
+lang.php.tokens.symbols ([!@#$%\^&*()\[\]{}/?=+\-\\|,<.>;:])
+lang.php.tokens.symbols.format white
+lang.php.tokens.long_comments.open \/\*
+lang.php.tokens.long_comments.close \*\/
+lang.php.tokens.long_comments.format 8 bold
+lang.php.tokens.sql_string.open (<<<EOS)
+lang.php.tokens.sql_string.close (EOS)
+lang.php.tokens.sql_string.format 1
+lang.php.tokens.sql_string.change_to sql
+lang.php.tokens.js.open (<<<EOJS)
+lang.php.tokens.js.close (EOJS)
+lang.php.tokens.js.format 12 bold
+lang.php.tokens.js.change_to java
+lang.php.indent.size 4
+lang.php.indent.auto true
+lang.php.indent.roundup false
+#lang.php.indent.using_tabs true
+lang.php.indent.indenters ([{\[(]$)
+lang.php.indent.unindenters (^\s+[\]})])
+lang.php.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(\/\/.*)
+lang.php.indent.ignore ^(.+:|\s*?)$
+lang.php.context.ignore ^(.+:|\s*\{?)$
+
+# Perl
+
+lang.perl.filemask \.(?:pl|pm)$
+lang.perl.bangmask perl
+lang.perl.format.default white bold
+lang.perl.format.selection inverse
+lang.perl.format.found yellow inverse
+lang.perl.tokens.comments (#.*)
+lang.perl.tokens.comments.format 8 bold
+lang.perl.tokens.constants \b([A-Z_]+|[A-Z_][A-Z0-9_]+)\b
+lang.perl.tokens.constants.format yellow bold
+lang.perl.tokens.symbols [!#^&*()\[\]{}/?=+\-\\|,<.>;:~]
+lang.perl.tokens.symbols.format white
+lang.perl.tokens.regular_expressions (\/.+?[^\\]\/)
+lang.perl.tokens.regular_expressions.format red bold
+lang.perl.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.perl.tokens.doublequoted_strings.format green bold
+lang.perl.tokens.singlequoted_strings ('.*?[^\\]')
+lang.perl.tokens.singlequoted_strings.format green bold
+lang.perl.tokens.backquoted_strings (`.*?[^\\]`)
+lang.perl.tokens.backquoted_strings.format red bold
+lang.perl.tokens.reserved_words \b(unless|until|else|for|while|foreach|if|return|do|next|elsif|last|redo|continue|sub|goto)\b
+lang.perl.tokens.reserved_words.format white
+lang.perl.tokens.builtins \b(abs|accept|alarm|atan2|bind|binmode|bless|caller|chdir|chmod|chomp|chop|chown|chr|chroot|close|closedir|connect|continue|cos|crypt|dbmclose|dbmopen|defined|delete|die|do|dump|each|endgrent|endhostent|endnetent|endprotoent|endpwent|endservent|eof|eval|exec|exists|exit|exp|fcntl|fileno|flock|fork|format|formline|getc|getgrent|getgrgid|getgrnam|gethostbyaddr|gethostbyname|gethostent|getlogin|getnetbyaddr|getnetbyname|getnetent|getpeername|getpgrp|getppid|getpriority|getprotobyname|getprotobynumber|getprotoent|getpwent|getpwnam|getpwuid|getservbyname|getservbyport|getservent|getsockname|getsockopt|glob|gmtime|goto|grep|hex|import|index|int|ioctl|join|keys|kill|last|lc|lcfirst|length|link|listen|local|localtime|lock|log|lstat|m|map|mkdir|msgctl|msgget|msgrcv|msgsnd|my|next|no|oct|open|opendir|ord|our|pack|package|pipe|pop|pos|print|printf|prototype|push|q|qq|qr|quotemeta|qw|qx|rand|read|readdir|readline|readlink|readpipe|recv|redo|ref|rename|require|reset|return|reverse|rewinddir|rindex|rmdir|s|scalar|seek|seekdir|select|semctl|semget|semop|send|setgrent|sethostent|setnetent|setpgrp|setpriority|setprotoent|setpwent|setservent|setsockopt|shift|shmctl|shmget|shmread|shmwrite|shutdown|sin|sleep|socket|socketpair|sort|splice|split|sprintf|sqrt|srand|stat|study|sub|substr|symlink|syscall|sysopen|sysread|sysseek|system|syswrite|tell|telldir|tie|tied|time|times|tr|truncate|uc|ucfirst|umask|undef|unlink|unpack|unshift|untie|use|utime|values|vec|wait|waitpid|wantarray|warn|write|y)\b
+lang.perl.tokens.builtins.format cyan bold
+lang.perl.tokens.array_variables \s(@[A-Za-z_][A-Za-z_0-9]*)\b
+lang.perl.tokens.array_variables.format red bold
+lang.perl.tokens.hash_variables \s(%[A-Za-z_][A-Za-z_0-9]*)\b
+lang.perl.tokens.hash_variables.format magenta bold
+lang.perl.indent.size 4
+lang.perl.indent.auto true
+lang.perl.indent.roundup true
+#lang.perl.indent.using_tabs true
+lang.perl.indent.indenters (case|[{\[(]$)
+lang.perl.indent.unindenters (case|^\s+[\]})])
+#lang.perl.indent.indenters \b(unless|else|for|while|foreach|if|do|elsif|sub)\b
+#lang.perl.indent.unindenters \b(else)\b
+lang.perl.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(`.+?[^\\]`)|(\/.+?[^\\]\/)|(^\s*#.*)
+lang.perl.indent.ignore ^\s*$
+lang.perl.context.ignore ^(.+:|\s*\{?)$
+
+# Python
+
+lang.python.filemask \.py$
+lang.python.bangmask python
+lang.python.format.default white bold
+lang.python.format.selection inverse
+lang.python.format.found yellow inverse
+lang.python.tokens.constants \b([A-Z_]+|[A-Z_][A-Z0-9_]+)\b
+lang.python.tokens.constants.format yellow bold
+lang.python.tokens.symbols [@!#$%^&*()\[\]{}/?=+\-\\|,<.>;:~]
+lang.python.tokens.symbols.format white
+lang.python.tokens.comments (#.*)
+lang.python.tokens.comments.format 8 bold
+lang.python.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.python.tokens.doublequoted_strings.format green bold
+lang.python.tokens.singlequoted_strings ('.*?[^\\]')
+lang.python.tokens.singlequoted_strings.format green bold
+lang.python.tokens.backquoted_strings (`.*?[^\\]`)
+lang.python.tokens.backquoted_strings.format red bold
+lang.python.tokens.reserved_words \b(and|assert|break|class|continue|def|del|elif|else|except|exec|finally|for|from|global|if|import|in|is|lambda|not|or|pass|print|raise|return|try|while|yield)\b
+lang.python.tokens.reserved_words.format white
+lang.python.indent.size 4
+lang.python.indent.auto true
+lang.python.indent.roundup true
+#lang.python.indent.using_tabs true
+lang.python.indent.indenters \b(class|def|elif|else|except|finally|for|if|try|while)\b
+#lang.python.indent.indenters :
+lang.python.indent.unindenters \b(else|elif|except)\b
+lang.python.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(`.+?[^\\]`)|(^\s*#.*)
+lang.python.indent.ignore ^\s*$
+
+# Java
+
+lang.java.filemask \.java$
+lang.java.format.default white bold
+lang.java.format.selection inverse
+lang.java.format.found yellow inverse
+lang.java.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.java.tokens.doublequoted_strings.format green bold
+lang.java.tokens.singlequoted_strings ('.*?[^\\]')
+lang.java.tokens.singlequoted_strings.format green bold
+lang.java.tokens.reserved_words \b(abstract|do|if|package|synchronized|boolean|double|implements|private|this|break|else|import|protected|throw|byte|extends|instanceof|public|throws|case|false|int|return|transient|catch|final|interface|short|true|char|finally|long|static|try|class|float|native|strictfp|void|const|for|new|super|volatile|continue|goto|null|switch|while|default|assert)\b
+lang.java.tokens.reserved_words.format white
+lang.java.tokens.constants \b([A-Z_]+|[A-Z_][A-Z0-9_]+)\b
+lang.java.tokens.constants.format yellow bold
+lang.java.tokens.comments (\/\/.*)
+lang.java.tokens.comments.format 8 bold
+lang.java.tokens.symbols ([!@#$%\^&*()\[\]{}/?=+\-\\|,<.>;:])
+lang.java.tokens.symbols.format white
+lang.java.tokens.long_comments.open \/\*
+lang.java.tokens.long_comments.close \*\/
+lang.java.tokens.long_comments.format 8 bold
+lang.java.indent.size 4
+lang.java.indent.auto true
+lang.java.indent.roundup false
+#lang.java.indent.using_tabs true
+lang.java.indent.indenters (\{)
+lang.java.indent.unindenters (\})
+lang.java.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(\/\/.*)
+lang.java.indent.ignore ^(.+:|\s*?)$
+lang.java.context.ignore ^(.+:|\s*\{?)$
+
+# C
+
+lang.c.filemask \.(c(pp|xx)?|h)$
+lang.c.format.default white bold
+lang.c.format.selection inverse
+lang.c.format.found yellow inverse
+lang.c.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.c.tokens.doublequoted_strings.format green bold
+lang.c.tokens.singlequoted_strings ('.*?[^\\]')
+lang.c.tokens.singlequoted_strings.format green bold
+lang.c.tokens.reserved_words \b(if|double|break|else|byte|case|int|return|short|char|long|static|void|for|super|continue|goto|switch|while)\b
+lang.c.tokens.reserved_words.format white
+lang.c.tokens.constants \b([A-Z_]+|[A-Z_][A-Z0-9_]+)\b
+lang.c.tokens.constants.format yellow bold
+lang.c.tokens.comments (\/\/.*)
+lang.c.tokens.comments.format 8 bold
+lang.c.tokens.preprocessor (^\s*#.*)
+lang.c.tokens.preprocessor.format yellow bold
+lang.c.tokens.symbols ([!@#$%\^&*()\[\]{}/?=+\-\\|,<.>;:])
+lang.c.tokens.symbols.format white
+lang.c.tokens.long_comments.open \/\*
+lang.c.tokens.long_comments.close \*\/
+lang.c.tokens.long_comments.format 8 bold
+lang.c.indent.size 4
+lang.c.indent.auto true
+lang.c.indent.roundup false
+#lang.c.indent.using_tabs true
+lang.c.indent.indenters (case|[{\[(]$)
+lang.c.indent.unindenters (case|^\s+[\]})])
+lang.c.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(\/\/.*)
+lang.c.indent.ignore ^(.+:|\s*?)$
+lang.c.context.ignore ^(.+:|\s*\{?)$
+
+# Configuration files
+
+lang.conf.filemask (?:\.conf(?:ig)?|\.cfg|\.cnf|user_prefs|XF86Config)$
+lang.conf.format.default white
+lang.conf.format.selection inverse
+lang.conf.format.found yellow inverse
+lang.conf.tokens.commands ^\s*([^\s=]+)
+lang.conf.tokens.commands.format cyan bold
+lang.conf.tokens.comments (^\s*#.*)
+lang.conf.tokens.comments.format yellow bold
+lang.conf.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.conf.tokens.doublequoted_strings.format green bold
+lang.conf.tokens.singlequoted_strings ('.*?[^\\]')
+lang.conf.tokens.singlequoted_strings.format green bold
+lang.conf.indent.size 4
+lang.conf.indent.auto true
+lang.conf.indent.roundup true
+#lang.conf.indent.using_tabs true
+
+# crontab
+
+lang.crontab.filemask (?:^|\/)crontab$
+lang.crontab.format.default white
+lang.crontab.format.selection inverse
+lang.crontab.format.found yellow inverse
+lang.crontab.tokens.comments (^\s*#.*)
+lang.crontab.tokens.comments.format yellow bold
+lang.crontab.tokens.schedule ^((?:[0-9\/*,-]+\s+){5})
+lang.crontab.tokens.schedule.format cyan bold
+lang.crontab.tokens.commands ^(\S+=.+)
+lang.crontab.tokens.commands.format cyan
+lang.crontab.indent.size 4
+lang.crontab.indent.auto true
+lang.crontab.indent.roundup true
+#lang.crontab.indent.using_tabs true
+
+lang.fstab.filemask ^fstab$
+lang.fstab.format.default white
+lang.fstab.format.selection inverse
+lang.fstab.format.found yellow inverse
+lang.fstab.tokens.comments (^\s*#.*)
+lang.fstab.tokens.comments.format yellow bold
+lang.fstab.indent.size 4
+lang.fstab.indent.auto true
+lang.fstab.indent.roundup true
+#lang.fstab.indent.using_tabs true
+
+# SQL
+
+lang.sql.filemask \.sql$
+lang.sql.format.default white bold
+lang.sql.format.selection inverse
+lang.sql.format.found yellow inverse
+lang.sql.indent.size 4
+lang.sql.indent.auto true
+lang.sql.indent.roundup true
+#lang.sql.indent.using_tabs true
+lang.sql.tokens.reserved_words.case_insensitive \b(ABSOLUTE|ACCESS|ACTION|ADD|ADMIN|AFTER|ALIAS|ALL|ALLOCATE|AND|ANY|ARE|AS|ASC|ASSERTION|AT|AUDIT|AUTHORIZATION|AVG|BEFORE|BEGIN|BETWEEN|BIT_LENGTH|BOTH|BREADTH|BY|CASCADE|CASCADED|CASE|CAST|CATALOG|CHAR_LENGTH|CHARACTER_LENGTH|CHECK|CLASS|CLOSE|CLUSTER|COALESCE|COBOL|COLLATE|COLLATION|COLUMN|COMPLETION|COMPRESS|COMPUTED|CONCAT|CONNECT|CONNECTION|CONSTRAINT|CONSTRAINTS|CONSTRUCTOR|CONTINUE|CONVERT|CORRESPONDING|COUNT|CROSS|CURRENT_DATE|CURRENT_TIME|CURRENT_TIMESTAMP|CURRENT_USER|CURRENT|CURSOR|CYCLE|DATA|DAY|DBHIGH|DBKEY|DBLOW|DBMAC|DEALLOCATE|DECLARE|DECODE|DEFAULT|DEFERRABLE|DEFERRED|DEPTH|DEREF|DESC|DESCRIBE|DESCRIPTOR|DESTROY|DESTRUCTOR|DIAGNOSTICS|DICTIONARY|DISCONNECT|DISTINCT|DO|DOMAIN|EACH|ELEMENT|ELSE|ELSEIF|END-EXEC|END|EQUALS|ESCAPE|EXCEPT|EXCEPTION|EXCEPTIONS|EXCLUSIVE|EXISTS|EXTERNAL|EXTERNALLY|EXTRACT|FALSE|FILE|FIRST|FOR|FOREIGN|FORTRAN|FOUND|FROM|FULL|FUNCTION|GENERAL|GET|GLOBAL|GO|GOTO|GROUP|HAVING|HOUR|IDENTIFIED|IDENTITY|IF|IGNORE|IMMEDIATE|IN|INCREMENT|INDEX|INDICATOR|INITIAL|INITIALLY|INNER|INOUT|INPUT|INSENSITIVE|INSTEAD|INTERSECT|INTERVAL|INTO|IS|ISOLATION|JOIN|KEY|LABEL|LANGUAGE|LAST|LEADING|LEAVE|LEFT|LESS|LEVEL|LIKE|LIMIT|LOCAL|LOCK|LOOP|LOWER|MATCH|MAX|MAXEXTENTS|MIN|MINUS|MINUTE|MLSLABEL|MLS_LABEL_FORMAT|MODE|MODIFY|MODULE|MONTH|MOVE|MULTISET|NAMES|NATIONAL|NATURAL|NEW_TABLE|NEXT|NO|NOAUDIT|NOCOMPRESS|NONE|NOT|NOWAIT|NULL|NULLIF|NUMBER|NVL|OCTET_LENGTH|OF|OFF|OFFLINE|OID|OLD|OLD_TABLE|ON|ONLINE|ONLY|OPEN|OPERATION|OPERATORS|OPTION|OR|ORDER|OTHERS|OUT|OUTER|OUTPUT|OVERLAPS|PAD|PARAMETER|PARTIAL|PASCAL|PCTFREE|PENDANT|PLI|POSITION|PRECISION|PREORDER|PRESERVE|PRIMARY|PRIOR|PRIVATE|PRIVILEGES|PROCEDURE|PROTECTED|PUBLIC|RAW|READ|READUP|REAL|RECORD|RECURSIVE|REF|REFERENCES|REFERENCING|RELATIVE|RENAME|REPLACE|REPRESENTATION|RESIGNAL|RESOURCE|RESTRICT|RETURN|RETURNS|RIGHT|ROLE|ROUTINE|ROW|ROWID|ROWNUM|ROWS|SAVEPOINT|SCHEMA|SCROLL|SEARCH|SECOND|SECTION|SENSITIVE|SEQUENCE|SESSION|SESSION_USER|SET|SHARE|SIGNAL|SIMILAR|SIZE|SOME|SPACE|SPECIFIC|SQL|SQLCODE|SQLERROR|SQLEXCEPTION|SQLSTATE|SQLWARNING|START|STRUCTURE|SUBSTRING|SUCCESSFUL|SUM|SYNONYM|SYSDATE|SYSTEM_USER|TABLE|TEMPLATE|TEMPORARY|TEST|THAN|THEN|THERE|SQ92|TIMEZONE_HOUR|TIMEZONE_MINUTE|TO|TRAILING|TRANSACTION|TRANSLATE|TRANSLATION|TRIGGER|TRIM|TRUE|TUPLE|TYPE|UID|UNDER|UNION|UNIQUE|UNKNOWN|UPPER|USAGE|USER|USING|VALIDATE|VALUE|VALUES|VARIABLE|VARIANT|VIRTUAL|VARYING|VIEW|VISIBLE|VOID|WAIT|WHEN|WHENEVER|WHERE|WHILE|WITH|WITHOUT|WORK|WRITE|WRITEDOWN|WRITEUP|YEAR|ZONE)\b
+lang.sql.tokens.reserved_words.format white
+lang.sql.tokens.commands.case_insensitive \b(ALTER|COMMENT|COMMIT|CREATE|DELETE|DROP|EXEC|EXECUTE|FETCH|GRANT|INSERT|PERFORM|PREPARE|REVOKE|ROLLBACK|SELECT|UPDATE)\b
+lang.sql.tokens.commands.format cyan
+lang.sql.tokens.data_types.case_insensitive \b(BIT|BOOLEAN|CHAR|CHARACTER|DATE|DEC|DECIMAL|DOUBLE|FLOAT|INT|INTEGER|INTERVAL|LONG|NCHAR|NUMBER|NUMERIC|REAL|RECORD|ROW|SMALLINT|STRUCTURE|TIME|TIMESTAMP|TUPLE|VARCHAR|VARCHAR2)\b
+lang.sql.tokens.data_types.format brown
+lang.sql.tokens.comments (--.*)
+lang.sql.tokens.comments.format 8 bold
+lang.sql.tokens.singlequoted_strings ('.*?[^\\]')
+lang.sql.tokens.singlequoted_strings.format green bold
+lang.sql.tokens.symbols ([!@#$%\^&*()\[\]{}/?=+\-\\|,<.>;:])
+lang.sql.tokens.symbols.format white
+lang.sql.tokens.typos (==)
+lang.sql.tokens.typos.format 15 bold
+lang.sql.indent.indenters ((?:\(|BEGIN|DECLARE|FROM|LOOP|ORDER BY|SELECT|SET|WHERE)$)
+lang.sql.indent.unindenters (^\s+(?:\)|;|BEGIN|DECLARE|END))
+lang.sql.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')
+lang.sql.context.ignore ^(\W+)$
+
+# Bash
+
+lang.bash.filemask (?:\.(?:ebuild|bash_profile|bashrc))$
+lang.bash.bangmask (?:ba)?sh\b
+lang.bash.format.default white bold
+lang.bash.format.selection inverse
+lang.bash.format.found yellow inverse
+lang.bash.indent.size 4
+lang.bash.indent.auto true
+lang.bash.indent.roundup true
+#lang.bash.indent.using_tabs true
+lang.bash.tabsize 4
+lang.bash.tokens.comments (^\s*#.*)
+lang.bash.tokens.comments.format 8 bold
+lang.bash.tokens.singlequoted_strings ('.*?[^\\]')
+lang.bash.tokens.singlequoted_strings.format green bold
+lang.bash.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.bash.tokens.doublequoted_strings.format green bold
+lang.bash.tokens.backquoted_strings (`.*?[^\\]`)
+lang.bash.tokens.backquoted_strings.format red bold
+lang.bash.indent.indenters (\{)
+lang.bash.indent.unindenters (\})
+lang.bash.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(\/\/.*)
+lang.bash.indent.ignore ^(.+:|\s*?)$
+
+# Tcl
+
+lang.tcl.filemask \.tcl$
+lang.tcl.bangmask tcl
+lang.tcl.format.default white bold
+lang.tcl.format.selection inverse
+lang.tcl.format.found yellow inverse
+lang.tcl.indent.size 4
+lang.tcl.indent.auto true
+lang.tcl.indent.roundup true
+#lang.tcl.indent.using_tabs true
+lang.tcl.tabsize 4
+lang.tcl.tokens.comments (^\s*#.*)
+lang.tcl.tokens.comments.format 8 bold
+lang.tcl.tokens.reserved_words \b(encoding|incr|pid|tcl_endOfWord|Tcl|eof|info|tcl_findLibrary|after|error|interp|pkg_mkIndex|tcl_startOfNextWord|append|eval|join|proc|tcl_startOfPreviousWord|array|exec|lappend|puts|tcl_wordBreakAfter|auto_execok|exit|lassign|pwd|tcl_wordBreakBefore|auto_import|expr|lindex|re_syntax|tcltest|auto_load|fblocked|linsert|read|tclvars|auto_mkindex|fconfigure|list|regexp|tell|auto_mkindex_old|fcopy|llength|registry|time|auto_qualify|file|load|regsub|trace|auto_reset|fileevent|lrange|rename|unknown|bgerror|filename|lrepeat|resource|unload|binary|flush|lreplace|return|unset|break|for|lsearch|scan|update|catch|foreach|lset|seek|uplevel|cd|format|lsort|set|upvar|clock|gets|memory|socket|variable|close|glob|msgcat|source|vwait|concat|global|namespace|split|while|continue|history|open|string|dde|http|package|subst|dict|if|parray|switch)\b
+lang.tcl.tokens.reserved_words.format white
+lang.tcl.tokens.symbols ([!@#$%\^&*()\[\]{}/?=+\-\\|,<.>;:])
+lang.tcl.tokens.symbols.format white
+lang.tcl.tokens.variables (\$[A-Za-z_][A-Za-z_0-9]*)\b
+lang.tcl.tokens.variables.format yellow bold
+lang.tcl.tokens.doublequoted_strings (\".*?[^\\]\")
+lang.tcl.tokens.doublequoted_strings.format green bold
+lang.tcl.indent.indenters (\{)
+lang.tcl.indent.unindenters (\})
+lang.tcl.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(\/\/.*)
+
+lang.diff.filemask (?:\.(?:diff|patch))$
+lang.diff.format.default white
+lang.diff.format.selection inverse
+lang.diff.format.found yellow inverse
+lang.diff.indent.size 4
+lang.diff.indent.auto false
+#lang.diff.indent.using_tabs true
+lang.diff.tabsize 4
+lang.diff.tokens.oldfile (^--- .+$)
+lang.diff.tokens.oldfile.format red bold
+lang.diff.tokens.newfile (^\+\+\+ .+$)
+lang.diff.tokens.newfile.format green bold
+lang.diff.tokens.oldline (^-.+$)
+lang.diff.tokens.oldline.format red bold
+lang.diff.tokens.newline (^\+.+$)
+lang.diff.tokens.newline.format green bold
+lang.diff.tokens.location (^@@.+$)
+lang.diff.tokens.location.format green
+lang.diff.tokens.filediff (^Only in .+$)
+lang.diff.tokens.filediff.format magenta bold
+lang.diff.tokens.diff_command (^diff .+$)
+lang.diff.tokens.diff_command.format 13 bold
+
+lang.yaml.filemask (?:\.ya?ml)$
+lang.yaml.bangmask ^---
+lang.yaml.format.default white bold
+lang.yaml.format.selection inverse
+lang.yaml.format.found yellow inverse
+lang.yaml.indent.size 4
+lang.yaml.indent.auto false
+lang.yaml.indent.roundup false
+lang.yaml.tabsize 8
+lang.yaml.tokens.value_indicator (:)(?: |$)
+lang.yaml.tokens.value_indicator.format white
+lang.yaml.tokens.key_indicator (\? )
+lang.yaml.tokens.key_indicator.format white
+lang.yaml.tokens.nested_series (?:^|[^-])(- )
+lang.yaml.tokens.nested_series.format magenta bold
+lang.yaml.tokens.series_separator (,)
+lang.yaml.tokens.series_separator.format white
+lang.yaml.tokens.inline_series ([\[\]])
+lang.yaml.tokens.inline_series.format white
+lang.yaml.tokens.inline_keyed ([{}])
+lang.yaml.tokens.inline_keyed.format white
+lang.yaml.tokens.doublequoted_strings (\".*?[^\\]\"|\"\")
+lang.yaml.tokens.doublequoted_strings.format green bold
+lang.yaml.tokens.singlequoted_strings ('.*?[^\\]'|'')
+lang.yaml.tokens.singlequoted_strings.format green bold
+lang.yaml.tokens.block_scalar (\|[0-9+-]*)$
+lang.yaml.tokens.block_scalar.format blue bold
+lang.yaml.tokens.folded_scalar (>[0-9+-]*)$
+lang.yaml.tokens.folded_scalar.format blue bold
+lang.yaml.tokens.document_header ^(---.*)$
+lang.yaml.tokens.document_header.format 10 bold
+lang.yaml.tokens.document_terminator ^(\.\.\.)
+lang.yaml.tokens.document_terminator.format 10
+lang.yaml.tokens.directive_indicator ^(%.*)
+lang.yaml.tokens.directive_indicator.format 10
+lang.yaml.tokens.comment_indicator (#.+)
+lang.yaml.tokens.comment_indicator.format 8 bold
+lang.yaml.tokens.anchor_indicator (&\w+)
+lang.yaml.tokens.anchor_indicator.format red bold
+lang.yaml.tokens.alias_indicator (\*\w+)
+lang.yaml.tokens.alias_indicator.format yellow
+lang.yaml.tokens.tag (!\w*)
+lang.yaml.tokens.tag.format yellow bold
+lang.yaml.tokens.null (~|null)
+lang.yaml.tokens.null.format red
+lang.yaml.indent.size 4
+lang.yaml.indent.auto true
+lang.yaml.indent.roundup true
+lang.yaml.indent.indenters :$
+lang.yaml.indent.preventers (\".+?[^\\]\")|('.+?[^\\]')|(`.+?[^\\]`)|(^\s*#.*)
+lang.yaml.indent.ignore ^\s*$
+
+#% SiSU
+lang.sisu.filemask \.(?:sst|ssm|ssi|[_-]sst)$
+lang.sisu.format.default white 
+lang.sisu.tokens.comment ^%+\s+.*
+lang.sisu.tokens.comment.format 8
+#langsisu.tokens.comments.format 8 bold
+lang.sisu.tokens.header ^(@\S+?:|0~\S+)\s+.*
+lang.sisu.tokens.header.format cyan
+lang.sisu.tokens.heading ^:?[A-C1-9]~(?:\S+)?\s+.*
+lang.sisu.tokens.heading.format yellow bold
+#lang.sisu.tokens.heading.format white inverse
+lang.sisu.tokens.headings.case_insensitive ^(?:Chapter|Part|Section|Book|Article|Preamble|Appendix)\s.*
+lang.sisu.tokens.headings.format white bold
+lang.sisu.tokens.bullet ^_[12]?\*\s+
+lang.sisu.tokens.bullet.format yellow
+lang.sisu.tokens.indent ^_[12]\s+
+lang.sisu.tokens.indent.format yellow
+lang.sisu.tokens.link \{.+?\}(?:http:\/\/\S+|image)
+lang.sisu.tokens.link.format yellow
+lang.sisu.tokens.url http:\/\/\S+
+lang.sisu.tokens.url.format blue bold
+lang.sisu.tokens.line_bold ^!_\s+.*
+lang.sisu.tokens.line_bold.format white bold
+lang.sisu.tokens.font_bold [!*]\{.+?\}[!*]
+lang.sisu.tokens.font_bold.format white bold
+lang.sisu.tokens.font_modify [/_+-^,]\{.+?\}[/_+-^,]
+lang.sisu.tokens.font_modify.format brown
+lang.sisu.tokens.page_break <:(?:pb|np)>
+lang.sisu.tokens.page_break.format white bold inverse
+lang.sisu.tokens.br <(?:\/\s*)?br>
+lang.sisu.tokens.br.format white bold inverse
+lang.sisu.tokens.endnote_mark ~\^(?:\s|$)
+lang.sisu.tokens.endnote_mark.format green
+lang.sisu.tokens.endnote_content ^\^~\s.+
+lang.sisu.tokens.endnote_content.format green
+
+lang.sisu.tokens.endnote.open ~\{
+lang.sisu.tokens.endnote.close \}~
+lang.sisu.tokens.endnote.format green
+#lang.sisu.tokens.endnotes ~\{.+?\}~
+#lang.sisu.tokens.endnotes.format green
+lang.sisu.tokens.group.open ^group\{
+lang.sisu.tokens.group.close ^\}group
+lang.sisu.tokens.group.format green
+lang.sisu.tokens.poem.open ^poem\{
+lang.sisu.tokens.poem.close ^\}poem
+lang.sisu.tokens.poem.format green
+lang.sisu.tokens.code.open ^code\{
+lang.sisu.tokens.code.close ^\}code
+lang.sisu.tokens.code.format green
+
+lang.sisu.tokens.error [a-zA-Z0-9,.::?!&]+http:\/\/\S+
+lang.sisu.tokens.error.format magenta
+
+# Custom configuration files can be included.
+# If a setting is specified again, it overrides the previous setting given
+# higher up in the configuration file(s).
+
+include ~/.diakonos/cucumber.conf
diff --git a/data/sisu/conf/syntax/nanorc b/data/sisu/conf/syntax/nanorc
new file mode 100644
index 00000000..82183131
--- /dev/null
+++ b/data/sisu/conf/syntax/nanorc
@@ -0,0 +1,220 @@
+## Sample initialization file for GNU nano
+## Please note that you must have configured nano with --enable-nanorc
+## for this file to be read!  Also note that characters specially
+## interpreted by the shell should not be escaped here.
+##
+## To make sure a value is not enabled, use "unset <option>"
+##
+## For the options that take parameters, the default value is given.
+## Other options are unset by default.
+
+## Use auto-indentation.
+# set autoindent
+
+## Backup files to filename~.
+# set backup
+
+## The directory to put unique backup files in.
+# set backupdir ""
+
+## Do backwards searches by default.
+# set backwards
+
+## The characters treated as closing brackets.  They cannot contain
+## blank characters.  Only closing punctuation, optionally followed by
+## closing brackets, can end sentences.
+##
+# set brackets "'")}]>"
+
+## Do case sensitive searches by default.
+# set casesensitive
+
+## Constantly display the cursor position in the statusbar.  Note that
+## this cancels out "quickblank".
+# set const
+
+## Use cut to end of line by default.
+# set cut
+
+## Set the line length for wrapping text and justifying paragraphs.
+## If fill is 0 or less, the line length will be the screen width less
+## this number.
+##
+# set fill -8
+
+## Enable ~/.nano_history for saving and reading search/replace strings.
+# set historylog
+
+## Use the blank line below the titlebar as extra editing space.
+# set morespace
+
+## Enable mouse support, so that mouse clicks can be used to set the
+## mark and run shortcuts.
+# set mouse
+
+## Allow multiple file buffers (inserting a file will put it into a
+## separate buffer).  You must have configured with --enable-multibuffer
+## for this to work.
+##
+# set multibuffer
+
+## Don't convert files from DOS/Mac format.
+# set noconvert
+
+## Don't follow symlinks when writing files.
+# set nofollow
+
+## Don't display the helpful shortcut lists at the bottom of the screen.
+# set nohelp
+
+## Don't wrap text at all.
+# set nowrap
+
+## Set operating directory.  nano will not read or write files outside
+## this directory and its subdirectories.  Also, the current directory
+## is changed to here, so files are inserted from this dir.  A blank
+## string means the operating directory feature is turned off.
+##
+# set operatingdir ""
+
+## Preserve the XON and XOFF keys (^Q and ^S).
+# set preserve
+
+## The characters treated as closing punctuation.  They cannot contain
+## blank characters.  Only closing punctuation, optionally followed by
+## closing brackets, can end sentences.
+##
+# set punct ".?!"
+
+## Do quick statusbar blanking.  Statusbar messages will disappear after
+## 1 keystroke instead of 25.  Note that "const" cancels this out.
+##
+# set quickblank
+
+## The email-quote string, used to justify email-quoted paragraphs.
+## This is an extended regular expression if your system supports them,
+## otherwise a literal string.  Default:
+# set quotestr "^([ 	]*[\|>:}#])+"
+## if you have regexps, otherwise:
+# set quotestr "> "
+## You can get old nano quoted-justify behavior via:
+# set quotestr "(> )+"
+
+## Fix Backspace/Delete confusion problem.
+# set rebinddelete
+
+## Do extended regular expression searches by default.
+# set regexp
+
+## Make the Home key smarter.  When Home is pressed anywhere but at the
+## very beginning of non-whitespace characters on a line, the cursor
+## will jump to that beginning (either forwards or backwards).  If the
+## cursor is already at that position, it will jump to the true
+## beginning of the line.
+# set smarthome
+
+## Use smooth scrolling as the default.
+# set smooth
+
+## Use this spelling checker instead of the internal one.  This option
+## does not properly have a default value.
+##
+# set speller "aspell -x -c"
+
+## Allow nano to be suspended.
+# set suspend
+
+## Use this tab size instead of the default; it must be greater than 0.
+# set tabsize 8
+
+## Convert typed tabs to spaces.
+# set tabstospaces
+
+## Save automatically on exit, don't prompt.
+# set tempfile
+
+## Disallow file modification; why would you want this in an rcfile? ;)
+# set view
+
+## The two single-column characters used to display the first characters
+## of tabs and spaces.  187 decimal (00BB hexadecimal) and 183 decimal
+## (00B7 hexadecimal) seem to be good values for these.
+# set whitespace "  "
+
+## Color setup
+##
+## Format:
+##
+## syntax "short description" ["filename regex" ...]
+##
+## color foreground,background "regex" ["regex"...]
+## or
+## icolor foreground,background "regex" ["regex"...]
+##
+## "color" will do case sensitive matches, while "icolor" will do case
+## insensitive matches.
+##
+## Legal colors: white, black, red, blue, green, yellow, magenta, cyan.
+## You may use the prefix "bright" to mean a stronger color highlight
+## for the foreground.
+##
+## To use multi-line regexes, use the start="regex" end="regex" format.
+##
+## If your system supports transparency, not specifying a background
+## color will use a transparent color.  If you don't want this, be sure
+## to set the background color to black or white.
+##
+# syntax "c-file" "\.(c|C|cc|cpp|cxx|h|H|hh|hpp|hxx)$"
+# color red "\<[A-Z_]{2,}\>" 
+# color green "\<(float|double|bool|char|int|short|long|sizeof|enum|void|static|const|struct|union|typedef|extern|signed|unsigned|inline)\>"
+# color green "\<(class|namespace|template|public|protected|private|typename|this|friend|virtual|using|mutable|volatile|register|explicit)\>"
+# color brightyellow "\<(for|if|while|do|else|case|default|switch|goto|continue|break|return)\>"
+# color brightyellow "\<(try|throw|catch|operator|new|delete)\>"
+# color brightcyan "^[[:space:]]*#[[:space:]]*(define|undef|include|ifn?def|endif|elif|else|if|warning|error)"
+# color brightmagenta "'([^\]|(\\['abfnrtv\\]))'" "'\\(([0-7][0-7]?)|([0-3][0-7][0-7]))'" "'\\x[0-9A-Fa-f][0-9A-Fa-f]?'"
+## color foreground,background "regex" ["regex"...]
+##
+#% sisu
+syntax "sisu" "\.ss[tmi]$"
+#color white,black ".*"
+color cyan start="^0~" end="^$"
+color cyan start="^@\S+:" end="^$"
+#color cyan "^0~.*"
+color brightyellow "^[1-6]~.*"
+color brightyellow "^:?[A-C]~.*"
+icolor brightwhite "^(Chapter|Part|Section|Book|Article|Preamble|Appendix)\s.*"
+color brightyellow "^!_\s.*"
+color brightyellow "[!*]\{.+?\}[!*]"
+color yellow "[/_+-^,]\{.+?\}[/_+-^,]"
+color green "~\{.+?\}~"
+color green "~\^(\s|$)"
+color green "^\^~\s.+"
+#color green start="~\{" end="\}~"
+color yellow "\{.+?\}http:\/\/\S+"
+color brightblue "http:\/\/\S+"
+color yellow "^(_[12]?\*|_[12])"
+color magenta "^%+\s+.*"
+color green start="^poem\{$" end="^\}poem$"
+color green start="^code\{$" end="^\}code$"
+color green start="^group\{$" end="^\}group$"
+color green start="^alt\{$" end="^\}alt$"
+color magenta "<:(pb|np)>"
+color magenta "<(\/\s*)?br>"
+color magenta "[a-zA-Z0-9,.::?!&]+http:\/\/\S+"
+
+# .nanorc
+#
+ syntax "nanorc" "(\.|/|)nanorc$"
+# highlight possible errors and parameters
+ icolor brightwhite "^[[:space:]]*(set|unset|syntax|i?color).*$"
+# set, unset and syntax
+ icolor cyan "^[[:space:]]*(set|unset)[[:space:]]+(autoindent|backup|backupdir|backwards|brackets|casesensitive|const|cut|fill|historylog|morespace|mouse|multibuffer|noconvert|nofollow|nohelp|nowrap|operatingdir|preserve|punct|quickblank|quotestr|rebinddelete)\>" "^[[:space:]]*(set|unset)[[:space:]]+(regexp|smarthome|smooth|speller|suspend|tabsize|tabstospaces|tempfile|view|whitespace)\>"
+ icolor green "^[[:space:]]*(set|unset|syntax)\>"
+# colors
+ icolor yellow "^[[:space:]]*i?color[[:space:]]*(bright)?(white|black|red|blue|green|yellow|magenta|cyan)?(,(white|black|red|blue|green|yellow|magenta|cyan))?\>"
+ icolor magenta "^[[:space:]]*i?color\>" "\<(start|end)="
+# strings
+ icolor white "\"(\\.|[^\"])*\""
+# comments
+ icolor blue "^[[:space:]]*#.*$"
+
diff --git a/data/sisu/conf/syntax/sisu-mode.el b/data/sisu/conf/syntax/sisu-mode.el
new file mode 100644
index 00000000..3f56de1c
--- /dev/null
+++ b/data/sisu/conf/syntax/sisu-mode.el
@@ -0,0 +1,235 @@
+;;; sisu-mode.el.el --- Major mode for editing .sisu-files
+
+;;; It mainly defines a grammar for syntax highlighting.
+;;; SiSU http://www.jus.uio.no/sisu
+
+;;; Copyright 2005 Ralph Amissah
+
+;;; Author: Ralph Amissah <ralph.amissah@gmail.com>
+;;; Version: $Id$
+;;; Keywords: perl sisu
+
+;;; This program is free software; you can redistribute it and/or modify
+;;; it under the terms of the GNU General Public License as published by
+;;; the Free Software Foundation; either version 2, or (at your option)
+;;; any later version.
+;;;
+;;; This program is distributed in the hope that it will be useful,
+;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;;; GNU General Public License for more details.
+;;;
+;;; You should have received a copy of the GNU General Public License
+;;; along with this program; if not, write to the Free Software
+;;; Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+
+;;; Commentary:
+
+;;; This mode is built with help of the
+;;; "Emacs language mode creation tutorial" at
+;;; http://two-wugs.net/emacs/mode-tutorial.html
+;;;
+;;; Regexes are defined for the following font-lock-faces:
+;;;
+;;;   font-lock-keyword-face
+;;;   font-lock-type-face
+;;;   font-lock-comment-face
+;;;   font-lock-reference-face
+;;;   font-lock-doc-string-face
+;;;   font-lock-function-name-face
+;;;
+
+;;; Usage:
+
+;;; Put this file into your load-path and the following into your ~/.emacs:
+;;;
+;;;    (require 'sisu-mode.el)
+;;;
+;;;
+;;; To associate sisu-mode.el with .s[tmi] files add the following to your ~/.emacs
+;;;
+;;;    (setq auto-mode-alist
+;;;       (append auto-mode-alist
+;;;         '(("\\.ss[tmi]$" . sisu-mode.el))))
+;;;
+;;;
+;;; To automatically turn on font-lock-mode add the following to your ~/.emacs
+;;;
+;;;    (add-hook 'sisu-mode.el-hook 'font-lock-mode)
+;;;
+;;; Code:
+
+;; ;; default variables
+;; (defvar sisu-mode.el-hook nil)
+;; 
+;; (defvar sisu-mode-map
+;;   (let ((sisu-mode-map (make-keymap)))
+;;     (define-key wpdl-mode-map "\C-j" 'newline-and-indent)
+;;     sisu-mode-map)
+;;   "Keymap for SiSU major mode")
+;; 
+;; (add-to-list 'auto-mode-alist '("\\.ss[tmi]\\'" . sisu-mode))
+
+(defvar sisu-mode-hook nil)
+
+(defvar sisu-mode-map
+  (let ((sisu-mode-map (make-keymap)))
+    (define-key sisu-mode-map "\C-j" 'newline-and-indent)
+    sisu-mode-map)
+  "Keymap for SiSU major mode")
+(add-to-list 'auto-mode-alist '("\\.ss[tmi]\\'" . sisu-mode))
+
+(defconst sisu-font-lock-keywords-1
+  (list
+   '("\\<\\(BOOK\\|CHAPTER\\).+" . font-lock-builtin-face)
+;   '("\\<\\(BOOK\\|CHAPTER\\)\\>" . font-lock-builtin-face)
+   '("\\('\\w*'\\)" . font-lock-variable-name-face))
+  "Minimal highlighting expressions for SiSU mode")
+
+(defconst sisu-font-lock-keywords-2
+  (append sisu-font-lock-keywords-1
+		  (list
+; header
+		   '("^0~.+" . font-lock-keyword-face)
+; heading
+		   '("^[1-6]~.+" . font-lock-keyword-face)
+; bullet
+		   '("\\<\\(_\\*\\|_[12]\\|_\\*[12]\\) " . font-lock-constant-face)
+; font, bold italics etc.
+		   '("^!_ .+" . font-lock-constant-face)
+		   '("[/_+-^,]{.+?}[/_+-^,]" . font-lock-constant-face)
+		   '("[!*]{.+?}[!*]" . font-lock-constant-face)
+; endnotes
+		   '("~{.+?}~" . font-lock-constant-face)
+		   '("~\\^(\s\\|$)" . font-lock-constant-face)
+		   '("^\\^~\s.+" . font-lock-constant-face)
+; links
+		   '("{.+?}http://[^ \n]+" . font-lock-constant-face)
+		   '("http://[^ \n]+" . font-lock-constant-face)
+; breaks
+		   '("<:\\(pb\\|np\\)>" . font-lock-constant-face)
+		   '("<\\(\s*/\\)?br>" . font-lock-constant-face)
+; comments
+		   '("[a-zA-Z0-9,.::?!&]+http://[^ \n]+" . font-lock-constant-face)
+		   '("^%+ .+" . font-lock-constant-face)
+; errors
+       '("[a-zA-Z0-9,.::?!&]+http://[^ \n]+" . font-lock-constant-face)
+; not done
+; multiline matches !!
+; poem code group alt
+		   '("^code{.+?}code" . font-lock-constant-face)
+;		   '("\\http://[a-zA-Z0-9]+" . font-lock-constant-face)
+;		   '("\\<\\(\\_\\*\\|\\_[12]\\|\\_\\*[12]\\) \\>" . font-lock-constant-face)
+; select more appropriate matches
+      ))
+  "Additional Keywords to highlight in SiSU mode")
+ 
+ (defconst sisu-font-lock-keywords-3
+   (append sisu-font-lock-keywords-2
+ 		  (list
+; 		  '("\\<\\(0~\\|[1-6]~\\|!_ \\)\\>" . font-lock-constant-face)
+      ))
+   "Balls-out highlighting in SiSU mode")
+
+(defvar sisu-font-lock-keywords sisu-font-lock-keywords-3
+  "Default highlighting expressions for SiSU mode")
+ 
+ (defvar sisu-mode-syntax-table
+   (let ((sisu-mode-syntax-table (make-syntax-table)))
+     (modify-syntax-entry ?_ "w" sisu-mode-syntax-table)
+;     (modify-syntax-entry ?/ ". 124b" sisu-mode-syntax-table)
+     (modify-syntax-entry ?* ". 23" sisu-mode-syntax-table)
+     (modify-syntax-entry ?\n "> b" sisu-mode-syntax-table)
+    sisu-mode-syntax-table)
+  "Syntax table for sisu-mode")
+
+(defun sisu-mode ()
+  "Major mode for editing Workflow Process Description Language files"
+  (interactive)
+  (kill-all-local-variables)
+  (set-syntax-table sisu-mode-syntax-table)
+  (use-local-map sisu-mode-map)
+
+(set (make-local-variable 'font-lock-defaults) '(sisu-font-lock-keywords))
+(setq major-mode 'sisu-mode)
+(setq mode-name "SiSU")
+(run-hooks 'sisu-mode-hook))
+(provide 'sisu-mode.el)
+
+;; ;; keymap
+;; (defvar sisu-mode.el-map nil "Keymap for SiSU major mode.")
+;; (if sisu-mode.el-map nil
+;;   (let ((map (make-sparse-keymap)))
+;;     ;; insert (define-key map ...) stuff here
+;;     (setq sisu-mode.el-map map)))
+;; 
+;; syntax highlighting: standard keywords
+;; (defconst sisu-font-lock-keywords-1
+;;   '(
+;;     ("^\\(!_\\|_[12]\\|_*\\)" 0 font-lock-keyword-face)
+;;     ("^_[12]\\(.*\\)$" 1 font-lock-type-face)
+;; ;;   ("^[ \t]+\\(.*\\)$" 1 font-lock-type-face)
+;;     )
+;;   "Minimal highlighting expressions for SiSU mode.")
+;; 
+;; ;; syntax highlighting: additional keywords
+;; (defconst sisu-font-lock-keywords-2
+;;   (append sisu-font-lock-keywords-1
+;; 	  '(
+;; 	    ("%+ \\(.*\\)" 2 font-lock-comment-face)
+;; 	    ))
+;;   "Additional Keywords to highlight in SiSU mode.")
+;; 
+;; ;; syntax highlighting: even more keywords
+;; (defconst sisu-font-lock-keywords-3
+;;   (append sisu-font-lock-keywords-2
+;; 	  '(
+;; 	    ("^0~.+" 1 font-lock-reference-face)
+;; 	    ("^[1-6]~.+" 2 font-lock-reference-face)
+;; ;;	    ("[IBSCF]<\\([^>]*\\)>" 1 font-lock-reference-face)
+;; ;;	    ("L<\\([^|>]*|\\)?\\([^>]+\\)>" 2 font-lock-reference-face)
+;; 	    ("L<\\([^|>]*\\)|\\([^>]*\\)>" 1 font-lock-doc-string-face)
+;; 	    ("E<\\([^>]*\\)>" 1 font-lock-function-name-face)
+;; 	    ("\"\\([^\"]+\\)\"" 0 font-lock-string-face)
+;; 	    ))
+;;   "Balls-out highlighting in SiSU mode.")
+;; 
+;; ;; default level of highlight to maximum
+;; (defvar sisu-font-lock-keywords sisu-font-lock-keywords-3
+;;   "Default highlighting expressions for SiSU mode")
+;; 
+;; ;; no special indenting, just pure text mode
+;; (defun sisu-indent-line ()
+;;   "Indent current line as SiSU code. Does nothing yet."
+;;   (interactive)
+;;   )
+;; 
+;; ;; no special syntax table
+;; (defvar sisu-mode.el-syntax-table nil
+;;   "Syntax table for sisu-mode.el.")
+;; 
+;; ;; create and activate syntax table
+;; (defun sisu-create-syntax-table ()
+;;   (if sisu-mode.el-syntax-table
+;;       ()
+;;     (setq sisu-mode.el-syntax-table (make-syntax-table))
+;;     (set-syntax-table sisu-mode.el-syntax-table)
+;;     ))
+
+;; main
+; (defun sisu-mode.el ()
+;   "Major mode for editing SiSU files."
+;   (interactive)
+;   (kill-all-local-variables)
+;   (sisu-create-syntax-table)
+;   (use-local-map sisu-mode.el-map)
+;   (make-local-variable 'font-lock-defaults)
+;   (setq font-lock-defaults '(sisu-font-lock-keywords 't))
+;   ;; (make-local-variable 'indent-line-function)
+;   ;; (setq indent-line-function 'sisu-indent-line)
+;   (setq major-mode 'sisu-mode.el)
+;   (setq mode-name "SiSU")
+;   (run-hooks 'sisu-mode.el-hook))
+
+
+;;; sisu-mode.el ends here
diff --git a/data/sisu/conf/syntax/sisu.lang b/data/sisu/conf/syntax/sisu.lang
new file mode 100644
index 00000000..df126b23
--- /dev/null
+++ b/data/sisu/conf/syntax/sisu.lang
@@ -0,0 +1,90 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE language SYSTEM "language.dtd">
+<language _name="SiSU" version="1.0" _section="Markup" mimetypes="text/x-ruby">
+<!-- SiSU syntax highligting for gedit, place in:
+  /usr/share/gtksourceview-1.0/language-specs 
+or:
+  ~/gtksourceview-1.0/language-specs
+-->
+
+	<syntax-item _name="Header" style="Data Type">
+    <start-regex>^0~\S|^\@\S+:\s</start-regex>
+    <end-regex>\n\n</end-regex>
+	</syntax-item>
+
+	<pattern-item _name="Bold" style="Keyword" end-at-line-end = "TRUE">
+    <regex>^(:[A-C]|[1-6])~[ a-Z0-9,.;:!?"'\/()-]+</regex>
+	</pattern-item>
+
+  <pattern-item _name="Operators" style="Function">
+    <regex>^(!_|_[12]|_[12]?\*)\s</regex>
+	</pattern-item>
+
+	<syntax-item _name="Note Function" style="Function">
+    <start-regex>~\{</start-regex>
+    <end-regex>\}~</end-regex>
+	</syntax-item>
+
+	<syntax-item _name="Bold Function" style="Function">
+    <start-regex>[!*]\{</start-regex>
+    <end-regex>\}[!*]</end-regex>
+	</syntax-item>
+
+	<syntax-item _name="FontFace Function" style="Function">
+    <start-regex>[/_,^+-]\{</start-regex>
+    <end-regex>\}[/_,^+-]</end-regex>
+	</syntax-item>
+  
+  <pattern-item _name="Bold Single" style="String">
+    <regex>[*]\S+[*]</regex>
+	</pattern-item>
+  
+  <pattern-item _name="Link" style="String">
+    <regex>\{[^}]+\}(http:\/\/\S+|image)\s</regex>
+	</pattern-item>
+
+	<pattern-item _name="Url" style="String">
+    <regex>\bhttp:\/\/\S+</regex>
+	</pattern-item>
+
+	<line-comment _name="Line Comment" style="Comment">
+		<start-regex>^%+\s.</start-regex>
+	</line-comment>
+
+	<syntax-item _name="Multiline Code" style="Others">
+    <start-regex>^code\{\s*$</start-regex>
+    <end-regex>^\}code\s*$</end-regex>
+	</syntax-item>
+
+	<syntax-item _name="Multiline Poem" style="Others">
+    <start-regex>^poem\{\s*$</start-regex>
+    <end-regex>^\}poem\s*$</end-regex>
+	</syntax-item>
+
+	<syntax-item _name="Multiline Group" style="Others">
+    <start-regex>^group\{\s*$</start-regex>
+    <end-regex>^\}group\s*$</end-regex>
+	</syntax-item>
+
+	<syntax-item _name="Multiline Alt" style="Others">
+    <start-regex>^alt\{\s*$</start-regex>
+    <end-regex>^\}alt\s*$</end-regex>
+	</syntax-item>
+
+	<pattern-item _name="Page Break" style="Others 2" end-at-line-end = "TRUE">
+    <regex>&lt;:(pb|np)&gt;</regex>
+	</pattern-item>
+
+	<pattern-item _name="Line Break" style="Others 2" end-at-line-end = "TRUE">
+    <regex>&lt;(\/\s*)?br&gt;</regex>
+	</pattern-item>
+
+	<pattern-item _name="Footnote Reference" style="Others" end-at-line-end = "TRUE">
+    <regex>~\^(\s|$)</regex>
+	</pattern-item>
+
+	<pattern-item _name="Footnote Content" style="Others" end-at-line-end = "TRUE">
+    <regex>^\^~\s.+</regex>
+	</pattern-item>
+
+</language>
diff --git a/data/sisu/conf/syntax/sisu.xml b/data/sisu/conf/syntax/sisu.xml
new file mode 100644
index 00000000..d54483ac
--- /dev/null
+++ b/data/sisu/conf/syntax/sisu.xml
@@ -0,0 +1,157 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE language SYSTEM "language.dtd">
+<language name="SiSU" version="1.00" section="Markup" kateversion="2.4" extensions="*.sst; *.ssm; *.ssi; *._sst; *.-sst;" author="Ralph Amissah (ralph.amissah@gmail.com)" license="LGPL" >
+  <highlighting>
+    <list name="somename">
+      <item> class </item>
+      <item> const </item>
+    </list>
+    <contexts>
+    <context attribute="Normal Text" lineEndContext="#pop" name="Normal Text" >
+      <keyword attribute="Keyword" context="#stay" String="somename" />
+      <DetectChar attribute="String" context="string" char="&quot;" />
+      <RegExpr String="^(0~\S+|@\S+)\s.+$" attribute="Header" context="#pop" />
+      <RegExpr String="^:?[A-C1-6]~.+$" attribute="Heading" context="#pop" />
+      <StringDetect String="~{" attribute="Endnote" context="footnote"/>
+      <StringDetect String="^~" attribute="Endnote" context="endnote"/>
+      <StringDetect String="!{" attribute="Bold" context="emphasis"/>
+      <StringDetect String="*{" attribute="Bold" context="bold"/>
+      <StringDetect String="/{" attribute="Italic" context="italic"/>
+      <StringDetect String="_{" attribute="Underscore" context="underscore"/>
+      <StringDetect String="^{" attribute="Superscript" context="superscript"/>
+      <StringDetect String=",{" attribute="Subscript" context="subscript"/>
+      <StringDetect String="-{" attribute="Strike" context="strike"/>
+      <StringDetect String="+{" attribute="Insert" context="insert"/>
+      <StringDetect String="&lt;br&gt;" attribute="Break" context="#pop" />
+      <RegExpr String="\{.+?\}(http:\/\/\S+|image)" attribute="Link" context="#stay"/>
+      <RegExpr String="(^|\s)http:\/\/\S+" attribute="Link" context="#stay"/>
+      <RegExpr String="^!_ .+" attribute="Bold" context="boldline"/>
+      <RegExpr String="^(_[12]|_\*|_[12]\*)\s" attribute="Indent" context="#stay"/>
+      <RegExpr String="~\^" attribute="Endnote" context="#stay"/>
+      <RegExpr String="^%+\s.+$" attribute="Comment" context="#stay" endRegion="regionMarker" firstNonSpace="true" />
+    </context>
+    <context attribute="String" lineEndContext="#stay" name="string" >
+      <DetectChar attribute="String" context="#pop" char="&quot;" />
+    </context>
+    <context attribute="Endnote" lineEndContext="#stay" name="footnote" >
+      <StringDetect attribute="Endnote" context="#pop" String="}~" />
+      <StringDetect String="!{" attribute="Bold" context="emphasis"/>
+      <StringDetect String="*{" attribute="Bold" context="bold"/>
+      <StringDetect String="/{" attribute="Italic" context="italic"/>
+      <StringDetect String="_{" attribute="Underscore" context="underscore"/>
+      <StringDetect String="^{" attribute="Superscript" context="superscript"/>
+      <StringDetect String=",{" attribute="Subscript" context="subscript"/>
+      <StringDetect String="-{" attribute="Strike" context="strike"/>
+      <StringDetect String="+{" attribute="Insert" context="insert"/>
+    </context>
+    <context attribute="Bold" lineEndContext="#stay" name="bold" >
+      <StringDetect attribute="Bold" context="#pop" String="}*" />
+      <StringDetect String="/{" attribute="Italic" context="italic"/>
+      <StringDetect String="_{" attribute="Underscore" context="underscore"/>
+      <StringDetect String="^{" attribute="Superscript" context="superscript"/>
+      <StringDetect String=",{" attribute="Subscript" context="subscript"/>
+      <StringDetect String="-{" attribute="Strike" context="strike"/>
+      <StringDetect String="+{" attribute="Insert" context="insert"/>
+    </context>
+    <context attribute="Bold" lineEndContext="#stay" name="emphasis" >
+      <StringDetect attribute="Bold" context="#pop" String="}!" />
+      <StringDetect String="/{" attribute="Italic" context="italic"/>
+      <StringDetect String="_{" attribute="Underscore" context="underscore"/>
+      <StringDetect String="^{" attribute="Superscript" context="superscript"/>
+      <StringDetect String=",{" attribute="Subscript" context="subscript"/>
+      <StringDetect String="-{" attribute="Strike" context="strike"/>
+      <StringDetect String="+{" attribute="Insert" context="insert"/>
+    </context>
+    <context attribute="Italic" lineEndContext="#stay" name="italic" >
+      <StringDetect attribute="Italic" context="#pop" String="}/" />
+      <StringDetect String="!{" attribute="Bold" context="emphasis"/>
+      <StringDetect String="*{" attribute="Bold" context="bold"/>
+      <StringDetect String="_{" attribute="Underscore" context="underscore"/>
+      <StringDetect String="^{" attribute="Superscript" context="superscript"/>
+      <StringDetect String=",{" attribute="Subscript" context="subscript"/>
+      <StringDetect String="-{" attribute="Strike" context="strike"/>
+      <StringDetect String="+{" attribute="Insert" context="insert"/>
+    </context>
+    <context attribute="Underscore" lineEndContext="#stay" name="underscore" >
+      <StringDetect attribute="Underscore" context="#pop" String="}_" />
+      <StringDetect String="!{" attribute="Bold" context="emphasis"/>
+      <StringDetect String="*{" attribute="Bold" context="bold"/>
+      <StringDetect String="/{" attribute="Italic" context="italic"/>
+      <StringDetect String="^{" attribute="Superscript" context="superscript"/>
+      <StringDetect String=",{" attribute="Subscript" context="subscript"/>
+      <StringDetect String="-{" attribute="Strike" context="strike"/>
+      <StringDetect String="+{" attribute="Insert" context="insert"/>
+    </context>
+    <context attribute="Superscript" lineEndContext="#stay" name="superscript" >
+      <StringDetect attribute="Superscript" context="#pop" String="}^" />
+      <StringDetect String="!{" attribute="Bold" context="emphasis"/>
+      <StringDetect String="*{" attribute="Bold" context="bold"/>
+      <StringDetect String="/{" attribute="Italic" context="italic"/>
+      <StringDetect String="_{" attribute="Underscore" context="underscore"/>
+      <StringDetect String=",{" attribute="Subscript" context="subscript"/>
+      <StringDetect String="-{" attribute="Strike" context="strike"/>
+      <StringDetect String="+{" attribute="Insert" context="insert"/>
+    </context>
+    <context attribute="Subscript" lineEndContext="#stay" name="subscript" >
+      <StringDetect attribute="Subscript" context="#pop" String="}," />
+      <StringDetect String="!{" attribute="Bold" context="emphasis"/>
+      <StringDetect String="*{" attribute="Bold" context="bold"/>
+      <StringDetect String="/{" attribute="Italic" context="italic"/>
+      <StringDetect String="_{" attribute="Underscore" context="underscore"/>
+      <StringDetect String="^{" attribute="Superscript" context="superscript"/>
+      <StringDetect String="-{" attribute="Strike" context="strike"/>
+      <StringDetect String="+{" attribute="Insert" context="insert"/>
+    </context>
+    <context attribute="Strike" lineEndContext="#stay" name="strike" >
+      <StringDetect attribute="Strike" context="#pop" String="}-" />
+      <StringDetect String="!{" attribute="Bold" context="emphasis"/>
+      <StringDetect String="*{" attribute="Bold" context="bold"/>
+      <StringDetect String="/{" attribute="Italic" context="italic"/>
+      <StringDetect String="_{" attribute="Underscore" context="underscore"/>
+      <StringDetect String="^{" attribute="Superscript" context="superscript"/>
+      <StringDetect String=",{" attribute="Subscript" context="subscript"/>
+      <StringDetect String="+{" attribute="Insert" context="insert"/>
+    </context>
+    <context attribute="Insert" lineEndContext="#stay" name="insert" >
+      <StringDetect attribute="Insert" context="#pop" String="}+" />
+      <StringDetect String="!{" attribute="Bold" context="emphasis"/>
+      <StringDetect String="*{" attribute="Bold" context="bold"/>
+      <StringDetect String="/{" attribute="Italic" context="italic"/>
+      <StringDetect String="_{" attribute="Underscore" context="underscore"/>
+      <StringDetect String="^{" attribute="Superscript" context="superscript"/>
+      <StringDetect String=",{" attribute="Subscript" context="subscript"/>
+      <StringDetect String="-{" attribute="Strike" context="strike"/>
+    </context>
+    <context attribute="Endnote" lineEndContext="#pop" name="endnote" />
+    <context attribute="Bold" lineEndContext="#pop" name="boldline" />
+    <context attribute="Indent" lineEndContext="#pop" name="indent" />
+    </contexts>
+    <itemDatas>
+      <itemData name="Normal Text" defStyleNum="dsNormal" />
+      <itemData name="Header" defStyleNum="dsNormal" color="#1c869b" selColor="#60FFFF" bold="0" italic="0"/>
+      <itemData name="Heading" defStyleNum="dsNormal" color="#ff0000" selColor="#60FFFF" bold="1" italic="0"/>
+      <itemData name="Bold" defStyleNum="dsNormal" color="#800000" selColor="#60FFFF" bold="1" italic="0"/>
+      <itemData name="Italic" defStyleNum="dsNormal" color="#800000" selColor="#60FFFF" bold="0" italic="1"/>
+      <itemData name="Underscore" defStyleNum="dsNormal" color="#F00000" selColor="#80FFD0" bold="0" italic="0"/>
+      <itemData name="Superscript" defStyleNum="dsNormal" color="#F00000" selColor="#80FFD0" bold="0" italic="0"/>
+      <itemData name="Subscript" defStyleNum="dsNormal" color="#F00000" selColor="#80FFD0" bold="0" italic="0"/>
+      <itemData name="Strike" defStyleNum="dsNormal" color="#F00000" selColor="#80FFD0" bold="0" italic="0"/>
+      <itemData name="Insert" defStyleNum="dsNormal" color="#F00000" selColor="#80FFD0" bold="0" italic="0"/>
+      <itemData name="Keyword" defStyleNum="dsKeyword" />
+      <itemData name="Endnote" defStyleNum="dsNormal" color="#086800" selColor="#60FFFF" bold="0" italic="0"/>
+      <itemData name="Link" defStyleNum="dsNormal" color="#0000FF" selColor="#60FFFF" bold="0" italic="0"/>
+      <itemData name="String" defStyleNum="dsString" />
+      <itemData name="Comment" defStyleNum="dsComment"/>
+      <itemData name="Group" defStyleNum="dsRegionMarker"/>
+      <itemData name="Break" defStyleNum="dsNormal" color="#FF0000" selColor="#60FFFF" bold="0" italic="0"/>
+      <itemData name="Indent" defStyleNum="dsNormal" color="#F00000" selColor="#80FFD0" bold="0" italic="0"/>
+      <itemData name="Structure" defStyleNum="dsNormal" color="#F00000" selColor="#80FFD0" bold="0" italic="0"/>
+    </itemDatas>
+  </highlighting>  
+  <general>
+    <keywords weakDeliminator="\" wordWrapDeliminator=",{}[]"/>
+    <comments>
+      <comment name="singleLine" start="%" />
+    </comments>
+  </general>
+</language>
diff --git a/data/sisu/conf/syntax/sisu_nedit.pats b/data/sisu/conf/syntax/sisu_nedit.pats
new file mode 100644
index 00000000..8e12cd5c
--- /dev/null
+++ b/data/sisu/conf/syntax/sisu_nedit.pats
@@ -0,0 +1,79 @@
+! Nedit Syntax highlighting patterns and commenting for SiSU 
+! Version 0.1
+!
+! INSTALLATION
+!
+! Load this pattern by starting nedit with:
+!
+!       nedit -import <name of this file>
+!
+! Then, check that the patterns were loaded correctly, and choose Save Defaults
+! from the Preferences menu.  The new patterns will now be incorporated into
+! your own .nedit file, so the next time you start NEdit, you will no longer
+! need to use -import.
+!
+! These comments will not appear in your ~/.nedit
+!
+nedit.macroCommands: \
+	SiSU Comments>Comment Out Lines@SiSU:::R: {\n\
+		                replace_in_selection("^.*$", "%+ &", "regex")\n\
+		        }\n\
+	SiSU Comments>Uncomment Lines@SiSU:::R: {\n\
+		                replace_in_selection("(^[ \\\\t]*# ?)(.*)$", "\\\\2", "regex")\n\
+		        }\n\
+	SiSU Comments>Comment Out Sel.@SiSU:::R: {\n\
+		                beginning-of-selection()\n\
+		                mark("1")\n\
+		                deselect-all()\n\
+		                insert-string("=begin\\n")\n\
+		                goto-mark("1")\n\
+		                beginning-of-selection()\n\
+		                backward-character("extend")\n\
+		                backward-character("extend")\n\
+		                backward-character("extend")\n\
+		                backward-character("extend")\n\
+		                backward-character("extend")\n\
+		                backward-character("extend")\n\
+		                backward-character("extend")\n\
+		                mark("1")\n\
+		                end-of-selection()\n\
+		                deselect-all()\n\
+		                insert-string("\\n=end")\n\
+		                goto-mark("1")\n\
+		        }\n\
+	SiSU Comments>Uncomment Sel.@SiSU:::R: {\n\
+		                beginning-of-selection()\n\
+		                mark("1")\n\
+		                deselect-all()\n\
+		                replace("=begin\\n","")\n\
+		                goto-mark("1")\n\
+		                deselect-all()\n\
+		                replace("\\n=end","","backward")\n\
+		                goto-mark("1")\n\
+		        }\n
+nedit.highlightPatterns: SiSU:1:0{\n\
+		comment:"^%+ ":"$"::Comment::\n\
+		endnote1:"~\\^(\s|$)":::Keyword::D\n\
+		endnote2:"^\\^~ ":"$"::Comment::\n\
+		header:"^0~":"$"::Keyword::\n\
+		bold_line:"^!_ ":"$"::Keyword::\n\
+		heading:"^[1-6]~":"$"::Keyword::\n\
+		code_block:"^code\\{":"^\\}code"::Comment::\n\
+		poem_block:"^poem\\{":"^\\}poem"::Comment::\n\
+		group_block:"^group\\{":"^\\}group"::Comment::\n\
+		alt_block:"^alt\\{":"^\\}alt"::Comment::\n\
+		endnote:"~\\{":"\\}~":"\\n":String::\n\
+		string2:"'":"'":"\\n":String1::\n\
+		string escape chars:"\\\\(.|\\n)":::String1:endnote:\n\
+		character constant:"'":"'":"[^\\\\][^']":Character Const::\n\
+		numeric constant:"<((0(x|X)[0-9a-fA-F]*)|(([0-9]+\\.?[0-9]*)|(\\.[0-9]+))((e|E)(\\+|-)?[0-9]+)?)(L|l|UL|ul|u|U|F|f)?>":::Plain::D\n\
+		storage keyword:"<(class)>":::Storage Type::D\n\
+		line:"^(_[12]|_\\*|_[12]\\*)":::Keyword::D\n\
+		link:"[{}](http://[a-zA-Z0-9?.!+\\-_/&=#]+)?":::Keyword::D\n\
+		url:"http://[a-zA-Z0-9?.!+\\-_/&=#]+":::Keyword::D\n\
+	}
+!		endnote:"~\\{":"\\}~"::Keyword::\n\
+!		link:"\\{":"\\}http://\S+"::Keyword::D\n\
+nedit.languageModes: SiSU:.sst::::::".,/\\`'!|@#%^&*()-=+{}[]"":;<>?~"
+! nedit.languageModes: SiSU:.sst::::::".,/\\`'!|@#%^&*()-=+{}[]"":;<>?~"
+! nedit.languageModes: SiSU:.ss[tmi]::::::
diff --git a/data/sisu/conf/vim/addons/colors/slate.vim b/data/sisu/conf/vim/addons/colors/slate.vim
new file mode 100644
index 00000000..8350017e
--- /dev/null
+++ b/data/sisu/conf/vim/addons/colors/slate.vim
@@ -0,0 +1,55 @@
+"%% SiSU Vim color file
+" Slate Maintainer: Ralph Amissah <ralph@amissah.com>
+" (originally looked at desert Hans Fugal <hans@fugal.net> http://hans.fugal.net/vim/colors/desert.vim (April/May 2003)
+:set background=dark
+:highlight clear
+if version > 580
+ hi clear
+ if exists("syntax_on")
+ syntax reset
+ endif
+endif
+:hi Normal guifg=White guibg=grey15
+:hi Cursor guibg=khaki guifg=slategrey
+:hi VertSplit guibg=#c2bfa5 guifg=grey40 gui=none cterm=reverse
+:hi Folded guibg=black guifg=grey40 ctermfg=grey ctermbg=darkgrey
+:hi FoldColumn guibg=black guifg=grey20 ctermfg=4 ctermbg=7
+:hi IncSearch guifg=green guibg=black cterm=none ctermfg=yellow ctermbg=green
+:hi ModeMsg guifg=goldenrod cterm=none ctermfg=brown
+:hi MoreMsg guifg=SeaGreen ctermfg=darkgreen
+:hi NonText guifg=RoyalBlue guibg=grey15 cterm=bold ctermfg=blue
+:hi Question guifg=springgreen ctermfg=green
+:hi Search guibg=peru guifg=wheat cterm=none ctermfg=grey ctermbg=blue
+:hi SpecialKey guifg=yellowgreen ctermfg=darkgreen
+:hi StatusLine guibg=#c2bfa5 guifg=black gui=none cterm=bold,reverse
+:hi StatusLineNC guibg=#c2bfa5 guifg=grey40 gui=none cterm=reverse
+:hi Title guifg=gold gui=bold cterm=bold ctermfg=yellow
+:hi Statement guifg=CornflowerBlue ctermfg=lightblue
+:hi Visual gui=none guifg=khaki guibg=olivedrab cterm=reverse
+:hi WarningMsg guifg=salmon ctermfg=1
+:hi String guifg=SkyBlue ctermfg=darkcyan
+:hi Comment term=bold ctermfg=11 guifg=grey40
+:hi Constant guifg=#ffa0a0 ctermfg=brown
+:hi Special guifg=darkkhaki ctermfg=brown
+:hi Identifier guifg=salmon ctermfg=red
+:hi Include guifg=red ctermfg=red
+:hi PreProc guifg=red guibg=white ctermfg=red
+:hi Operator guifg=Red ctermfg=Red
+:hi Define guifg=gold gui=bold ctermfg=yellow
+:hi Type guifg=CornflowerBlue ctermfg=2
+:hi Function guifg=navajowhite ctermfg=brown
+:hi Structure guifg=green ctermfg=green
+:hi LineNr guifg=grey50 ctermfg=3
+:hi Ignore guifg=grey40 cterm=bold ctermfg=7
+:hi Todo guifg=orangered guibg=yellow2
+:hi Directory ctermfg=darkcyan
+:hi ErrorMsg cterm=bold guifg=White guibg=Red cterm=bold ctermfg=7 ctermbg=1
+:hi VisualNOS cterm=bold,underline
+:hi WildMenu ctermfg=0 ctermbg=3
+:hi DiffAdd ctermbg=4
+:hi DiffChange ctermbg=5
+:hi DiffDelete cterm=bold ctermfg=4 ctermbg=6
+:hi DiffText cterm=bold ctermbg=1
+:hi Underlined cterm=underline ctermfg=5
+:hi Error guifg=White guibg=Red cterm=bold ctermfg=7 ctermbg=1
+:hi SpellErrors guifg=White guibg=Red cterm=bold ctermfg=7 ctermbg=1
diff --git a/data/sisu/conf/vim/addons/filetype.vim b/data/sisu/conf/vim/addons/filetype.vim
new file mode 100644
index 00000000..917c3e04
--- /dev/null
+++ b/data/sisu/conf/vim/addons/filetype.vim
@@ -0,0 +1,8 @@
+" SiSU filetype file
+if exists("did_load_filetypes")
+  finish
+endif
+augroup filetypedetect
+  au! BufNewFile,BufRead *.sst,*.ssm,*.ssi,*.-sst setf sisu
+  au! BufNewFile,BufRead *._sst,*.sst.meta,*.-sst.meta,*._sst.meta setf sisu
+augroup END
diff --git a/data/sisu/conf/vim/addons/ftplugin/sisu.vim b/data/sisu/conf/vim/addons/ftplugin/sisu.vim
new file mode 100644
index 00000000..8526206c
--- /dev/null
+++ b/data/sisu/conf/vim/addons/ftplugin/sisu.vim
@@ -0,0 +1,177 @@
+"%% SiSU Vim ftplugin
+" SiSU Maintainer: Ralph Amissah <ralph@amissah.com>
+" SiSU Markup:     SiSU (sisu-0.38)
+" an ftplugin setting defaults for editing sisu markup files
+:syntax on
+:filetype on
+:filetype indent on
+":let dialect='UK'
+:if version >= 700
+:  setlocal spell spelllang=en_us
+:endif
+:autocmd FileType sisu :set nonumber
+:set encoding=utf-8 fileencodings=
+:set ff=unix 
+:set autowrite          " Automatically save before commands like :next and :make
+:set nocompatible
+:set tabstop=2
+:set expandtab
+:set shiftwidth=2
+:set autoindent
+:set showcmd            " Show (partial) command in status line.
+:set showmatch          " Show matching brackets.
+:set ignorecase         " Do case insensitive matching
+:set smartcase
+:set incsearch
+:set hlsearch
+:set gdefault
+:set guioptions=agmr
+:set paste
+:set laststatus=2       " status line always on
+"% textwrap
+:set whichwrap=<,>,h,l,[,]
+:set nolinebreak        " only affects display not buffer
+:set wrap
+:set wrapmargin=0
+"% map
+":let mapleader = ","    " consider
+:map <leader>paste :set invpaste<cr>
+"% wrap/formatting paragraph according to the current 'textwidth' with ^J (control-j):
+:imap <C-J> <C-O>gqap
+:nmap <C-J>      gqap
+:vmap <C-J>      gq
+"% save file, go to next file in buffer
+:map <leader>nf :w <enter> :n <enter>
+"% vimdiff q exits
+:if &diff
+:  cmap q qa
+:endif
+"% directory files, placed in vertical split window
+:map <leader>dir :vs<cr><C-W><C-R> :Explore<cr>
+:map <leader>nn :set nonumber paste<cr>
+:map <leader>nu :set number paste<cr>
+:map <leader>no :set number nopaste<cr>
+"% vimdiff q exits
+:if &diff
+:  cmap q qa
+:endif 
+"% remapping lines make cursor jump a line at a time within wrapped text
+:nnoremap j gj
+:nnoremap k gk
+:vnoremap j gj
+:vnoremap k gk
+:nnoremap <Down> gj
+:nnoremap <Up> gk
+:vnoremap <Down> gj
+:vnoremap <Up> gk
+:inoremap <Down> <C-o>gj
+:inoremap  <Up> <C-o>gk
+"% colorscheme slate
+:map <C-C> :syntax on <cr> :colorscheme slate<cr>
+"% search and replace
+:map <C-S> :.,$s///c "search and replace down
+:map <c-G> :%s///c "search and replace whole file
+:map <c-X> :rubyd gsub!(//, "")
+"% pwd t64 working directory set to that of the file you're editing
+"changes pwd to directory of file in current buffer
+:function! CHANGE_CURR_DIR()
+:  let _dir = expand("%:p:h")
+:    exec "cd " . _dir
+:    unlet _dir
+:endfunction
+"% Change to the directory the file in your current buffer is in
+:if has("autocmd")
+   autocmd BufEnter * :lcd %:p:h
+:endif
+"% autocompletefilenames To search for files in the current directory
+:set path=,,
+"auto-completion for file to edit in current dir, used in normal mode
+:map <leader>e :e <c-r>=expand("%:p:h") . "/" <cr>
+:map <leader>pwd :exe 'cd ' . expand ("%:p:h")<cr>
+"% searchhighlight t93: Toggle search highlight <C-n>
+:function! ToggleHLSearched()
+:  if &hls
+:    set nohls
+:  else
+:    set hls
+:  endif
+:endfun
+:nmap <silent> <C-n> :silent call ToggleHLSearched()<cr>
+"%% SiSU vim folds
+"% foldsearchx FoldSearch (opens result of search all else closed) t77
+:map fs :set foldmethod=expr foldcolumn=2 foldlevel=0 <cr>
+:map <C-F> :F<cr>  "consider, is a remapping
+:map <leader>ff :F<cr>
+:map <leader>fe :F<cr> zE
+"% foldtoggle Fold Toggle mapped to <space>
+:fun! ToggleFold()
+:  if foldlevel('.') == 0
+:    normal! l
+:  else
+:    if foldclosed('.') < 0
+:      foldclose
+:    else
+:      foldopen
+:    endif
+:  endif
+"  Clear status line
+:  echo
+:endfun
+" Map this function to Space key.
+:noremap <space> :call ToggleFold()<cr>
+"% foldtype Fold? set foldtext
+:set foldtext=v:folddashes.substitute(getline(v:foldstart),'\\=','','g',)
+:set foldexpr=getline(v:lnum-1)!~@/&&getline(v:lnum)!~@/&&getline(v:lnum+1)!~@/
+"% foldsearch t77: Fold on search result 
+:function! FoldMake(search)
+:  set fdm=manual
+:  normal zE
+:  normal G$
+:  let folded = 0     "flag to set when a fold is found
+:  let flags = "w"    "allow wrapping in the search
+:  let line1 =  0     "set marker for beginning of fold
+:  while search(a:search, flags) > 0
+:    let  line2 = line(".")
+:      if (line2 -1 > line1)
+:        "echo line1 . ":" . (line2-1)
+:        "echo "a fold goes here."
+:        execute ":" . line1 . "," . (line2-1) . "fold"
+:        let folded = 1       "at least one fold has been found
+:     endif
+:     let line1 = line2     "update marker
+:     let flags = "W"       "turn off wrapping
+:  endwhile
+"  create the last fold which goes to the end of the file.
+:  normal $G
+:  let  line2 = line(".")
+:  if (line2  > line1 && folded == 1)
+:    execute ":". line1 . "," . line2 . "fold"
+:  endif
+:  normal 1G
+:endfunction
+"% folds Fold Patterns
+:command! -nargs=+ -complete=command FMake call FoldMake(<q-args>)
+:  if ( &filetype == "ruby" )
+:    command! F FMake ^# ==\?\|^\s*\(\(def\|class\|module\)\s\|\(public\|protected\|private\|__END__\)\s*$\)\|\(^\s*\|\s\+\)#%\s
+:    command! Fa FMake \(^# ==\?\|^\s*\(\(\(def\|class\|module\)\s\)\|\(\(public\|protected\|private\|__END__\)\(\s*$\)\)\)\)\|^[0-9]\~\|\([#%]\|^["]\)\{1,4\}\s*%\|{\({\|!!\)
+:    command! FD FMake \(^# ==\?\|^\s*\(\(def\|class\|module\)\s\)\)\|^\s*\([#%"0-9]\{0,4\}\~\(%\+\s\|!!\)\|#\s\+=\+\s\+\)
+:  else
+"% folds :F Fold Patterns SiSU Markup :F
+:    command! F FMake  ^\([1-8]\|:\?[A-C]\)\~\|\(^%\|\(^\|\s\+\)[#"]\)%\{1,2\}\(\s\|$\)\|^<<\s*|
+:    command! Fa FMake ^\([1-8]\|:\?[A-C]\)\~\|\(^%\|\(^\|\s\+\)[#"]\)%\{1,2\}\(\s\|$\)\|^<<\s*|\|^\(Book\|Part\|Chapter\|Section\|Article\|BOOK\|PART\|CHAPTER\|SECTION\|ARTICLE\)\s
+:    command! F0 FMake ^\(\s*0\~\|@\S\+:[+-]\?\s\+\)
+:    command! FA FMake ^:\?A\~
+:    command! FB FMake ^:\?[AB]\~
+:    command! FC FMake ^:\?[A-C]\~
+:    command! F1 FMake ^\(:\?[A-C]\|1\)\~
+:    command! F2 FMake ^\(:\?[A-C]\|[12]\)\~
+:    command! F3 FMake ^\(:\?[A-C]\|[1-3]\)\~
+:    command! F4 FMake ^[1-4]\~
+:    command! F5 FMake ^[4-5]\~
+:    command! F6 FMake ^[4-6]\~
+:    command! Fc FMake ^[%]\+\s\+ 
+:  endif
+"% folds Fold Patterns misc
+":command! Fp FMake ^\s*[A-Za-z0-9#]
+:command! Fp FMake ^\s*\S
+:command! Fo FMake ^[%\"]\s*[{>]
diff --git a/data/sisu/conf/vim/addons/syntax/sisu.vim b/data/sisu/conf/vim/addons/syntax/sisu.vim
new file mode 100644
index 00000000..13d22bb1
--- /dev/null
+++ b/data/sisu/conf/vim/addons/syntax/sisu.vim
@@ -0,0 +1,171 @@
+"%% SiSU Vim syntax file
+" SiSU Maintainer: Ralph Amissah <ralph@amissah.com>
+" SiSU Markup:     SiSU (sisu-0.47.6)
+" (originally looked at Ruby Vim by Mirko Nasato)
+if version < 600
+  syntax clear
+elseif exists("b:current_syntax")
+  finish
+else
+endif
+"% 11 Errors?
+syn match sisu_error contains=sisu_link,sisu_error_wspace "<![^ei]\S\+!>"
+"% 10 Markers: Endnote Identifiers, Pagebreaks etc.: 
+if !exists("sisu_no_identifiers")
+  syn match   sisu_mark_endnote                      "\~^"
+  syn match   sisu_contain       contains=@NoSpell   "</\?sub>"
+  syn match   sisu_break         contains=@NoSpell   "<br>\|<br />"
+  syn match   sisu_control       contains=@NoSpell   "<p>\|</p>\|<p />\|<:p[bn]>"
+  syn match   sisu_html                              "<center>\|</center>"
+  syn match   sisu_marktail                          "[~-]#"
+  syn match   sisu_html          contains=@NoSpell   "<td>\|<td \|<tr>\|</td>\|</tr>\|<table>\|<table \|</table>"
+  syn match   sisu_control                           "\""
+  syn match   sisu_underline                         "\(^\| \)_[a-zA-Z0-9]\+_\([ .,]\|$\)"
+  syn match   sisu_number        contains=@NoSpell   "[0-9a-f]\{32\}\|[0-9a-f]\{64\}"
+  syn match   sisu_link          contains=@NoSpell   "\(https\?://\|\.\.\/\)\S\+"
+  "metaverse specific
+  syn match   sisu_ocn           contains=@NoSpell   "<\~\d\+;\w\d\+;\w\d\+>"
+  syn match   sisu_marktail                          "<\~#>"
+  syn match   sisu_markpara      contains=@NoSpell   "<:i[12]>"
+  syn match   sisu_link                              " \*\~\S\+"
+  syn match   sisu_action                            "^<:insert\d\+>"
+  syn match   sisu_contain                           "<:e>"
+endif
+"% 9 URLs Numbers: and ASCII Codes
+syn match   sisu_number                              "\<\(0x\x\+\|0b[01]\+\|0\o\+\|0\.\d\+\|0\|[1-9][\.0-9_]*\)\>"
+syn match   sisu_number                              "?\(\\M-\\C-\|\\c\|\\C-\|\\M-\)\=\(\\\o\{3}\|\\x\x\{2}\|\\\=\w\)"
+"% 8 Tuned Error - is error if not already matched
+syn match sisu_error             contains=sisu_error "[\~/\*!_]{\|}[\~/\*!_]"
+syn match sisu_error             contains=sisu_error "<a href\|</a>]"
+"% 7 Simple Enclosed Markup:
+" Simple Markup:
+"%   url/link
+syn region sisu_link contains=sisu_error,sisu_error_wspace matchgroup=sisu_action start="^<<\s*|[a-zA-Z0-9^._-]\+|@|[a-zA-Z0-9^._-]\+|"rs=s+2 end="$"
+"%   header
+syn region sisu_header_content contains=sisu_error,sisu_error_wspace,sisu_content_alt,sisu_link,sisu_linked,sisu_break matchgroup=sisu_header start="^0\~\(\S\+\|[^-]\)" end="$"
+syn region sisu_header_content contains=sisu_error,sisu_error_wspace,sisu_content_alt,sisu_link,sisu_linked,sisu_break matchgroup=sisu_header start="^0\~\(tags\?\|date\)\s\+"rs=e-1 end="\n$"
+syn region sisu_header_content contains=sisu_error,sisu_error_wspace,sisu_content_alt,sisu_link,sisu_linked,sisu_break matchgroup=sisu_header start="^@\S\+:[+-]\?\s"rs=e-1 end="$"
+syn region sisu_header_content contains=sisu_error,sisu_error_wspace,sisu_content_alt,sisu_link,sisu_linked,sisu_break matchgroup=sisu_header start="^@\(tags\?\|date\):\s\+"rs=e-1 end="\n$"
+"%   headings
+syn region sisu_heading contains=sisu_mark_endnote,sisu_content_endnote,sisu_marktail,sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_ocn,sisu_error,sisu_error_wspace matchgroup=sisu_structure start="^\([1-8]\|:\?[A-C]\)\~\(\S\+\|[^-]\)" end="$"
+"%   grouped text
+syn region sisu_content_alt contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_contain start="^table{.\+" end="}table"
+syn region sisu_content_alt contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_contain start="^{\(t\|table\)\(\~h\)\?\(\sc[0-9]\+;\)\?[0-9; ]*}" end="\n\n"
+syn region sisu_content_alt contains=sisu_mark_endnote,sisu_content_endnote,sisu_link,sisu_mark,sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_contain start="^\(alt\|group\|poem\){" end="^}\(alt\|group\|poem\)"
+syn region sisu_content_alt contains=sisu_error matchgroup=sisu_contain start="^code{" end="^}code"
+"%   endnotes
+syn region sisu_content_endnote contains=sisu_link,sisu_strikeout,sisu_underline,sisu_number,sisu_control,sisu_identifier,sisu_error,sisu_error_wspace,sisu_mark,sisu_break matchgroup=sisu_mark_endnote start="\~{[*+]*" end="}\~" skip="\n"
+syn region sisu_content_endnote contains=sisu_link,sisu_strikeout,sisu_underline,sisu_number,sisu_control,sisu_identifier,sisu_error,sisu_error_wspace,sisu_mark,sisu_break matchgroup=sisu_mark_endnote start="\~\[[*+]*" end="\]\~" skip="\n"
+syn region sisu_content_endnote contains=sisu_strikeout,sisu_number,sisu_control,sisu_link,sisu_identifier,sisu_error,sisu_error_wspace,sisu_mark,sisu_break matchgroup=sisu_mark_endnote start="\^\~" end="\n\n"
+"%   links and images
+syn region sisu_linked contains=sisu_fontface,sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_link start="{\(\~^\s\)\?" end="}\(https\?:/\/\|\.\./\)\S\+" oneline
+syn region sisu_linked contains=sisu_fontface,sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_link start="{\(\~^\s\)\?" end="\[[1-5][sS]*\]}\S\+\.ss[tm]" oneline
+syn region sisu_linked contains=sisu_fontface,sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_link start="{" end="}image" oneline
+"%   some line operations
+syn region sisu_control contains=sisu_strikeout,sisu_identifier,sisu_content_endnote,sisu_mark_endnote,sisu_error,sisu_error_wspace matchgroup=sisu_control start="\(\(^\| \)!_ \|<:b>\)" end="$"
+syn region sisu_normal contains=sisu_strikeout,sisu_identifier,sisu_content_endnote,sisu_mark_endnote,sisu_link,sisu_linked,sisu_error,sisu_error_wspace matchgroup=sisu_markpara start="^_\([12*]\|[12]\*\) " end="$"
+syn region sisu_normal contains=sisu_strikeout,sisu_identifier,sisu_content_endnote,sisu_mark_endnote,sisu_link,sisu_linked,sisu_error,sisu_error_wspace matchgroup=sisu_markpara start="^\(#[ 1]\|_# \)" end="$"
+syn region sisu_comment matchgroup=sisu_comment start="^%\{1,2\} " end="$"
+"%   font face curly brackets
+syn region sisu_control contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_fontface start="\*{" end="}\*"
+syn region sisu_control contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_fontface start="!{" end="}!"
+syn region sisu_underline contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_fontface start="_{" end="}_"
+syn region sisu_identifier contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_fontface start="/{" end="}/"
+syn region sisu_underline contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_fontface start="+{" end="}+"
+syn region sisu_identifier contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_fontface start="\^{" end="}\^"
+syn region sisu_identifier contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_fontface start=",{" end="},"
+syn region sisu_strikeout contains=sisu_error matchgroup=sisu_fontface start="-{" end="}-" 
+syn region sisu_html contains=sisu_error contains=sisu_strikeout matchgroup=sisu_contain start="<a href=\".\{-}\">" end="</a>" oneline
+"%   single words bold italicise etc. "workon
+syn region sisu_control contains=sisu_error matchgroup=sisu_control start="\([ (]\|^\)\*[^\|{\n\~\\]"hs=e-1 end="\*"he=e-0 skip="[a-zA-Z0-9']" oneline
+syn region sisu_identifier contains=sisu_error matchgroup=sisu_content_alt start="\([ ]\|^\)/[^{ \|\n\\]"hs=e-1 end="/\[ \.\]" skip="[a-zA-Z0-9']" oneline
+"%   misc
+syn region sisu_identifier contains=sisu_error matchgroup=sisu_fontface start="\^[^ {\|\n\\]"rs=s+1 end="\^[ ,.;:'})\\\n]" skip="[a-zA-Z0-9']" oneline
+"%   metaverse html (flagged as errors for filetype sisu)
+syn region sisu_control contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error,sisu_mark matchgroup=sisu_html start="<b>" end="</b>" skip="\n" oneline
+syn region sisu_control contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error,sisu_mark matchgroup=sisu_html start="<em>" end="</em>" skip="\n" oneline
+syn region sisu_content_alt contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error,sisu_mark matchgroup=sisu_html start="<i>" end="</i>" skip="\n" oneline
+syn region sisu_content_alt contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error,sisu_mark matchgroup=sisu_html start="<u>" end="</u>" skip="\n" oneline
+syn region sisu_identifier contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error,sisu_mark matchgroup=sisu_html start="<ins>" end="</ins>" skip="\\\\\|\\'" oneline
+syn region sisu_identifier contains=sisu_error matchgroup=sisu_html start="<del>" end="</del>" oneline
+"%   metaverse <:>
+syn region sisu_content_alt contains=sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_contain start="<:Table.\{-}>" end="<:Table[-_]end>"
+syn region sisu_content_alt contains=sisu_error matchgroup=sisu_contain start="<:code>" end="<:code[-_]end>"
+syn region sisu_content_alt contains=sisu_mark_endnote,sisu_content_endnote,sisu_link,sisu_mark,sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_contain start="<:alt>" end="<:alt[-_]end>"
+syn region sisu_content_alt contains=sisu_mark_endnote,sisu_content_endnote,sisu_link,sisu_mark,sisu_strikeout,sisu_number,sisu_control,sisu_identifier,sisu_error matchgroup=sisu_contain start="<:poem>" end="<:poem[-_]end>"
+"% 6 Expensive Mode
+" Expensive Mode:
+if !exists("sisu_no_expensive")
+else " not Expensive
+  syn region  sisu_content_alt  matchgroup=sisu_control start="^\s*def\s" matchgroup=NONE end="[?!]\|\>" skip="\.\|\(::\)" oneline
+endif " Expensive?
+"% 5 Headers: and Headings (Document Instructions)
+syn match sisu_control contains=sisu_error,sisu_error_wspace "4\~! \S\+"
+syn region  sisu_markpara contains=sisu_error,sisu_error_wspace start="^=begin" end="^=end.*$"
+"% 4 Errors?
+syn match sisu_error_wspace contains=sisu_error_wspace "^\s\+"
+syn match sisu_error_wspace contains=sisu_error_wspace "\s\s\+"
+syn match sisu_error_wspace contains=sisu_error_wspace  " \s*$"
+syn match sisu_error contains=sisu_error,sisu_error_wspace "[^ (}]https\?:\S\+"
+syn match sisu_error contains=sisu_error_wspace "\t\+"
+syn match sisu_error contains=sisu_error "https\?:\S\+[}><]"
+syn match sisu_error contains=sisu_error "\([!*/_\+,^]\){\([^(\}\1)]\)\{-}\n\n"
+syn match sisu_error contains=sisu_error "^[\~]{[^{]\{-}\n\n"
+syn match sisu_error contains=sisu_error "\s\+.{{"
+syn match sisu_error contains=sisu_error "^\~\s*$"
+syn match sisu_error contains=sisu_error "^[0-9]\~\s*$"
+syn match sisu_error contains=sisu_error "^[0-9]\~\S\+\s*$"
+syn match sisu_error contains=sisu_error "[^{]\~\^[^ \)]"
+syn match sisu_error contains=sisu_error "\~\^\s\+\.\s*"
+syn match sisu_error contains=sisu_error "{\~^\S\+"
+syn match sisu_error contains=sisu_error "[_/\*!^]{[ .,:;?><]*}[_/\*!^]"
+syn match sisu_error contains=sisu_error "[^ (\"'(\[][_/\*!]{\|}[_/\*!][a-zA-Z0-9)\]\"']"
+syn match sisu_error contains=sisu_error "<dir>"
+"errors for filetype sisu, though not error in 'metaverse':
+syn match sisu_error contains=sisu_error,sisu_match,sisu_strikeout,sisu_contain,sisu_content_alt,sisu_mark,sisu_break,sisu_number "<[a-zA-Z\/]\+>"
+syn match sisu_error  "/\?<\([biu]\)>[^(</\1>)]\{-}\n\n"
+"% 3 Error Exceptions?
+syn match sisu_control "\n\n" "contains=ALL
+syn match sisu_control " //"
+syn match sisu_error  "%{"
+syn match sisu_error "<br>https\?:\S\+\|https\?:\S\+<br>"
+syn match sisu_error "[><]https\?:\S\+\|https\?:\S\+[><]"
+"% 2 Definitions - Define the default highlighting.
+if version >= 508 || !exists("did_sisu_syntax_inits")
+  if version < 508
+    let did_sisu_syntax_inits = 1
+    command -nargs=+ HiLink hi link <args>
+  else
+    command -nargs=+ HiLink hi def link <args>
+  endif
+"% 1 Defined
+  HiLink sisu_normal          Normal
+  HiLink sisu_header          PreProc
+  HiLink sisu_header_content  Statement
+  HiLink sisu_heading         Title
+  HiLink sisu_structure       Operator
+  HiLink sisu_contain         Include
+  HiLink sisu_mark_endnote    Include
+  HiLink sisu_link            NonText
+  HiLink sisu_linked          String
+  HiLink sisu_fontface        Include
+  HiLink sisu_strikeout       DiffDelete
+  HiLink sisu_content_alt     Special
+  HiLink sisu_content_endnote Special
+  HiLink sisu_control         Define
+  HiLink sisu_ocn             Include
+  HiLink sisu_number          Number
+  HiLink sisu_identifier      Function
+  HiLink sisu_underline       Underlined
+  HiLink sisu_markpara        Include
+  HiLink sisu_marktail        Include
+  HiLink sisu_mark            Identifier
+  HiLink sisu_break           Structure
+  HiLink sisu_html            Type
+  HiLink sisu_action          Identifier
+  HiLink sisu_comment         Comment
+  HiLink sisu_error_wspace    Error
+  HiLink sisu_error           Error
+  delcommand HiLink
+endif
+let b:current_syntax = "sisu"
diff --git a/data/sisu/image/DebTuxRubySiSU.png b/data/sisu/image/DebTuxRubySiSU.png
new file mode 100644
index 00000000..06109cd9
--- /dev/null
+++ b/data/sisu/image/DebTuxRubySiSU.png
diff --git a/data/sisu/image/arrow_next_blue.png b/data/sisu/image/arrow_next_blue.png
new file mode 100644
index 00000000..64e126bd
--- /dev/null
+++ b/data/sisu/image/arrow_next_blue.png
diff --git a/data/sisu/image/arrow_next_red.png b/data/sisu/image/arrow_next_red.png
new file mode 100644
index 00000000..436a086d
--- /dev/null
+++ b/data/sisu/image/arrow_next_red.png
diff --git a/data/sisu/image/arrow_prev_blue.png b/data/sisu/image/arrow_prev_blue.png
new file mode 100644
index 00000000..3e8f12fe
--- /dev/null
+++ b/data/sisu/image/arrow_prev_blue.png
diff --git a/data/sisu/image/arrow_prev_red.png b/data/sisu/image/arrow_prev_red.png
new file mode 100644
index 00000000..2dac0ba7
--- /dev/null
+++ b/data/sisu/image/arrow_prev_red.png
diff --git a/data/sisu/image/arrow_up_blue.png b/data/sisu/image/arrow_up_blue.png
new file mode 100644
index 00000000..2db1ce62
--- /dev/null
+++ b/data/sisu/image/arrow_up_blue.png
diff --git a/data/sisu/image/arrow_up_red.png b/data/sisu/image/arrow_up_red.png
new file mode 100644
index 00000000..dc803f0a
--- /dev/null
+++ b/data/sisu/image/arrow_up_red.png
diff --git a/data/sisu/image/b_bluebell.png b/data/sisu/image/b_bluebell.png
new file mode 100644
index 00000000..19be72b5
--- /dev/null
+++ b/data/sisu/image/b_bluebell.png
diff --git a/data/sisu/image/b_doc.png b/data/sisu/image/b_doc.png
new file mode 100644
index 00000000..13ca8ebe
--- /dev/null
+++ b/data/sisu/image/b_doc.png
diff --git a/data/sisu/image/b_home.png b/data/sisu/image/b_home.png
new file mode 100644
index 00000000..19be72b5
--- /dev/null
+++ b/data/sisu/image/b_home.png
diff --git a/data/sisu/image/b_odf.png b/data/sisu/image/b_odf.png
new file mode 100644
index 00000000..6cac938f
--- /dev/null
+++ b/data/sisu/image/b_odf.png
diff --git a/data/sisu/image/b_pdf.png b/data/sisu/image/b_pdf.png
new file mode 100644
index 00000000..c5982246
--- /dev/null
+++ b/data/sisu/image/b_pdf.png
diff --git a/data/sisu/image/b_toc.png b/data/sisu/image/b_toc.png
new file mode 100644
index 00000000..3f9194d4
--- /dev/null
+++ b/data/sisu/image/b_toc.png
diff --git a/data/sisu/image/bluebell.png b/data/sisu/image/bluebell.png
new file mode 100644
index 00000000..99c572d4
--- /dev/null
+++ b/data/sisu/image/bluebell.png
diff --git a/data/sisu/image/bullet_doc.png b/data/sisu/image/bullet_doc.png
new file mode 100644
index 00000000..6b883d6b
--- /dev/null
+++ b/data/sisu/image/bullet_doc.png
diff --git a/data/sisu/image/bullet_red.png b/data/sisu/image/bullet_red.png
new file mode 100644
index 00000000..c94b8687
--- /dev/null
+++ b/data/sisu/image/bullet_red.png
diff --git a/data/sisu/image/c_Copyleft.png b/data/sisu/image/c_Copyleft.png
new file mode 100644
index 00000000..5b3865b8
--- /dev/null
+++ b/data/sisu/image/c_Copyleft.png
diff --git a/data/sisu/image/c_Euro.png b/data/sisu/image/c_Euro.png
new file mode 100644
index 00000000..8e5c13a9
--- /dev/null
+++ b/data/sisu/image/c_Euro.png
diff --git a/data/sisu/image/dot_clear.png b/data/sisu/image/dot_clear.png
new file mode 100644
index 00000000..72593400
--- /dev/null
+++ b/data/sisu/image/dot_clear.png
diff --git a/data/sisu/image/dot_white.png b/data/sisu/image/dot_white.png
new file mode 100644
index 00000000..3d718d14
--- /dev/null
+++ b/data/sisu/image/dot_white.png
diff --git a/data/sisu/image/next.png b/data/sisu/image/next.png
new file mode 100644
index 00000000..088ff0fb
--- /dev/null
+++ b/data/sisu/image/next.png
diff --git a/data/sisu/image/previous.png b/data/sisu/image/previous.png
new file mode 100644
index 00000000..ea21f26a
--- /dev/null
+++ b/data/sisu/image/previous.png
diff --git a/data/sisu/image/rb7.ico b/data/sisu/image/rb7.ico
new file mode 100644
index 00000000..08d810bc
--- /dev/null
+++ b/data/sisu/image/rb7.ico
diff --git a/data/sisu/image/sisu.png b/data/sisu/image/sisu.png
new file mode 100644
index 00000000..b449fa6b
--- /dev/null
+++ b/data/sisu/image/sisu.png
diff --git a/data/sisu/image/toctoc.png b/data/sisu/image/toctoc.png
new file mode 100644
index 00000000..a15a06cd
--- /dev/null
+++ b/data/sisu/image/toctoc.png
diff --git a/data/sisu/odf/odt.zip b/data/sisu/odf/odt.zip
new file mode 100644
index 00000000..8f855535
--- /dev/null
+++ b/data/sisu/odf/odt.zip
author	Ralph Amissah <ralph.amissah@gmail.com>	2007-05-22 02:06:46 +0100
committer	Ralph Amissah <ralph.amissah@gmail.com>	2007-05-22 02:06:46 +0100
commit	65477054fd798728bf186aa2938727ddddbe86a5 (patch)
tree	612da47b57ad4c4157f495dcf10710d32cdc6ead /data