help and changelog update

2 files changed, 22 insertions, 17 deletions

diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html
index 1848611b..c17fecc6 100644
--- a/data/doc/sisu/html/sisu.1.html
+++ b/data/doc/sisu/html/sisu.1.html
@@ -723,13 +723,13 @@ up files are available as html with syntax highlighting for viewing: &lt;<a href
 <p>/usr/share/doc/sisu/sisu_markup_samples/non-free 
 <p> 8. MARKUP OF HEADERS  
 <p>
- Headers consist of semantic meta-data about a document, which can be used
-by any output module of the program; and may in addition include extra
-processing instructions. 
-<p>  Note: the first line of a document may include
-information on the markup version used in the form of a comment. Comments
-are a percentage mark at the start of a paragraph (and as the first character
-in a line of text) followed by a space and the comment: 
+ Headers contain either: semantic meta-data about a document, which can
+be used by any output module of the program, or; processing instructions.
+
+<p>  Note: the first line of a document may include information on the markup
+version used in the form of a comment. Comments are a percentage mark at
+the start of a paragraph (and as the first character in a line of text)
+followed by a space and the comment: 
 <p> 
 <p> <br>
 <pre>  % this would be a comment
@@ -742,13 +742,18 @@ one (without the comments):
 <pre>  % SiSU 0.57
   @title: SiSU
   @subtitle: Markup
-  @creator: Ralph Amissah
+  @creator: Amissah, Ralph
+  % note formatting on author / creator field, surname comma then other
+names, if more than one author separate by semi-colon
   @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
 License GPL 3
   @type: information
   @subject: ebook, epublishing, electronic book, electronic publishing,
 electronic document, electronic citation, data structure, citation systems,
 search
+  @topic_register: text markup language; application:text processing;output:html|xml|latex|pdf|sql
+  % note formatting for topic_register topic levels are separated by a
+colon, a semi-colon separates main topics
   @date.created: 2002-08-28
   @date.issued: 2002-08-28
   @date.available: 2002-08-28
@@ -1147,17 +1152,17 @@ is used there is neither decoration nor hyperlinking, code blocks are discussed
 <p>  <b>markup example:</b> 
 <p> 
 <p> <br>
-<pre>     &nbsp;[ tux.png ]
+<pre>  { tux.png 64x80 }image
   % various url linked images
-     &nbsp;[ tux.png ]
-     &nbsp;[ GnuDebianLinuxRubyBetterWay.png ]
+  {tux.png 64x80
+  {GnuDebianLinuxRubyBetterWay.png 100x101
   {~^ ruby_logo.png
 </pre>
 <p>  <b>resulting output:</b> 
 <p>  [ tux.png ] 
 <p>  tux.png 64x80 
 <p>  [ &nbsp;ruby_logo &nbsp;(png &nbsp;missing)
-&nbsp;] &nbsp;[^14] 
+&nbsp;] [^14] 
 <p>  GnuDebianLinuxRubyBetterWay.png 100x101 and Ruby 
 <p>  <b>linked url footnote
 
@@ -3378,15 +3383,15 @@ of this document: </dt>
 </dt>
 <dd></dd>
 
-<dt>* Generated by: SiSU 0.68.0 of 2008w29/1 (2008-07-21) </dt>
+<dt>* Generated by: SiSU 0.70.0 of 2008w48/3 (2008-12-03) </dt>
 <dd></dd>
 
 <dt>* Ruby version: ruby
-1.8.7 (2008-06-20 patchlevel 22) [i486-linux] </dt>
+1.8.7 (2008-08-11 patchlevel 72) [i486-linux] </dt>
 <dd></dd>
 
-<dt>* Last Generated on: Mon Jul 21
-02:54:35 -0400 2008 </dt>
+<dt>* Last Generated on: Tue Dec 09
+12:24:07 -0500 2008 </dt>
 <dd></dd>
 
 <dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
index 292bfe13..853b4124 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
@@ -127,7 +127,7 @@ code{
 
 @creator: Amissah, Ralph
 
-% note formatting on author / creator field, surname comma then other names, if more than one author separate by semi-colon
+% note formatting rules on author / creator field, "Surname, Other names", if more than one author separate by semi-colon (if name is of an institution just write name or the name contains a comma enclose in quotation marks)
 
 @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3