primarily todo with sisu documentation, changelog reproduced below:

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

* help related edits

* manpage, work on ability to generate manpages, improved

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

* plaintext changes made

* shared_txt, line wrap visited

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

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

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

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

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

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

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

1 files changed, 356 insertions, 0 deletions

diff --git a/data/doc/manuals_generated/sisu_manual/_sisu/xml/rng/sisu_dom.rng b/data/doc/manuals_generated/sisu_manual/_sisu/xml/rng/sisu_dom.rng
new file mode 100644
index 00000000..811d2bb9
--- /dev/null
+++ b/data/doc/manuals_generated/sisu_manual/_sisu/xml/rng/sisu_dom.rng
@@ -0,0 +1,356 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- % dom 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>
+          <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="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>
+  </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>