v4: documentation, sisu.1 manpage & minor

5 files changed, 412 insertions, 389 deletions

diff --git a/data/doc/sisu/markup-samples/v3/sisu_manual/sisu_markup.sst b/data/doc/sisu/markup-samples/v3/sisu_manual/sisu_markup.sst
index e3fbb226..3af84ad9 100644
--- a/data/doc/sisu/markup-samples/v3/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/markup-samples/v3/sisu_manual/sisu_markup.sst
@@ -119,37 +119,37 @@ code{
 % SiSU master 2.0
 
 @title: SiSU
- :subtitle: Manual
+  :subtitle: Manual
 
 @creator:
- :author: Amissah, Ralph
+  :author: Amissah, Ralph
 
 @publisher: [publisher name]
 
 @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
 
 @classify:
- :type: information
- :topic_register: SiSU:manual;electronic documents:SiSU:manual
- :subject: ebook, epublishing, electronic book, electronic publishing,
+  :type: information
+  :topic_register: SiSU:manual;electronic documents:SiSU:manual
+  :subject: ebook, epublishing, electronic book, electronic publishing,
     electronic document, electronic citation, data structure,
      citation systems, search
 
 % used_by: manual
 
 @date:
- :published: 2008-05-22
- :created: 2002-08-28
- :issued: 2002-08-28
- :available: 2002-08-28
- :modified: 2010-03-03
+  :published: 2008-05-22
+  :created: 2002-08-28
+  :issued: 2002-08-28
+  :available: 2002-08-28
+  :modified: 2010-03-03
 
 @make:
- :num_top: 1
- :breaks: new=C; break=1
- :skin: skin_sisu_manual
- :bold: /Gnu|Debian|Ruby|SiSU/
- :manpage: name=sisu - documents: markup, structuring, publishing in multiple standard formats, and search;
+  :num_top: 1
+  :breaks: new=C; break=1
+  :skin: skin_sisu_manual
+  :bold: /Gnu|Debian|Ruby|SiSU/
+  :manpage: name=sisu - documents: markup, structuring, publishing in multiple standard formats, and search;
      synopsis=sisu [-abcDdeFhIiMmNnopqRrSsTtUuVvwXxYyZz0-9] [filename/wildcard ]
      . sisu [-Ddcv] [instruction]
      . sisu [-CcFLSVvW]
@@ -157,16 +157,16 @@ code{
      . sisu --v3 [operations]
 
 @links:
- { SiSU Homepage }http://www.sisudoc.org/
- { SiSU Manual }http://www.sisudoc.org/sisu/sisu_manual/
- { Book Samples & Markup Examples }http://www.jus.uio.no/sisu/SiSU/examples.html
- { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
- { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
- { SiSU Git repo }http://git.sisudoc.org/?p=code/sisu.git;a=summary
- { SiSU List Archives }http://lists.sisudoc.org/pipermail/sisu/
- { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
- { SiSU Project @ Debian }http://qa.debian.org/developer.php?login=sisu@lists.sisudoc.org
- { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
+  { SiSU Homepage }http://www.sisudoc.org/
+  { SiSU Manual }http://www.sisudoc.org/sisu/sisu_manual/
+  { Book Samples & Markup Examples }http://www.jus.uio.no/sisu/SiSU/examples.html
+  { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
+  { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
+  { SiSU Git repo }http://git.sisudoc.org/?p=code/sisu.git;a=summary
+  { SiSU List Archives }http://lists.sisudoc.org/pipermail/sisu/
+  { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
+  { SiSU Project @ Debian }http://qa.debian.org/developer.php?login=sisu@lists.sisudoc.org
+  { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
 
 }code
 
@@ -174,10 +174,10 @@ code{
 
 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 the form @headername: or on the next line and indented by once space :subheadername: All Dublin Core meta tags are available
 
-!_ @indentifier:
+!_ @identifier:
 information or instructions
 
-where the "identifier" is a tag recognised by the program, and the "information" or "instructions" belong to the tag/indentifier specified
+where the "identifier" is a tag recognised by the program, and the "information" or "instructions" belong to the tag/identifier specified
 
 Note: a header where used should only be used once; all headers apart from @title: are optional; the @structure: header is used to describe document structure, and can be useful to know.
 
@@ -191,7 +191,6 @@ code{
 
 }code
 
-
 code{
 
 @title: [title text] [this header is the only one that is mandatory]
@@ -203,50 +202,50 @@ code{
 code{
 
 @creator:
- :author: [Lastname, First names]
- :illustrator: [Lastname, First names]
- :translator: [Lastname, First names]
- :prepared_by: [Lastname, First names]
+  :author: [Lastname, First names]
+  :illustrator: [Lastname, First names]
+  :translator: [Lastname, First names]
+  :prepared_by: [Lastname, First names]
 
 }code
 
 code{
 
 @date:
- :published: [year or yyyy-mm-dd]
- :created: [year or yyyy-mm-dd]
- :issued: [year or yyyy-mm-dd]
- :available: [year or yyyy-mm-dd]
- :modified: [year or yyyy-mm-dd]
- :valid: [year or yyyy-mm-dd]
- :added_to_site: [year or yyyy-mm-dd]
- :translated: [year or yyyy-mm-dd]
+  :published: [year or yyyy-mm-dd]
+  :created: [year or yyyy-mm-dd]
+  :issued: [year or yyyy-mm-dd]
+  :available: [year or yyyy-mm-dd]
+  :modified: [year or yyyy-mm-dd]
+  :valid: [year or yyyy-mm-dd]
+  :added_to_site: [year or yyyy-mm-dd]
+  :translated: [year or yyyy-mm-dd]
 
 }code
 
 code{
 
 @rights:
- :copyright: Copyright (C) [Year and Holder]
- :license: [Use License granted]
- :text: [Year and Holder]
- :translation: [Name, Year]
- :illustrations: [Name, Year]
+  :copyright: Copyright (C) [Year and Holder]
+  :license: [Use License granted]
+  :text: [Year and Holder]
+  :translation: [Name, Year]
+  :illustrations: [Name, Year]
 
 }code
 
 code{
 
 @classify:
- :topic_register: SiSU:markup sample:book;book:novel:fantasy
- :type:
- :subject:
- :description:
- :keywords:
- :abstract:
- :isbn: [ISBN]
- :loc: [Library of Congress classification]
- :dewey: [Dewey classification
+  :topic_register: SiSU:markup sample:book;book:novel:fantasy
+  :type:
+  :subject:
+  :description:
+  :keywords:
+  :abstract:
+  :isbn: [ISBN]
+  :loc: [Library of Congress classification]
+  :dewey: [Dewey classification
 
 }code
 
@@ -260,29 +259,29 @@ code{
 code{
 
 @make:
- :skin: skin_name [skins change default settings related to the appearance of documents generated]
- :num_top: 1
- :headings: [text to match for each level
-    (e.g. PART; Chapter; Section; Article; or another: none; BOOK|FIRST|SECOND; none; CHAPTER;)
- :breaks: new=:C; break=1
- :promo: sisu, ruby, sisu_search_libre, open_society
- :bold: [regular expression of words/phrases to be made bold]
- :italics: [regular expression of words/phrases to italicise]
+  :skin: skin_name [skins change default settings related to the appearance of documents generated]
+  :num_top: 1
+  :headings: [text to match for each level
+     (e.g. PART; Chapter; Section; Article; or another: none; BOOK|FIRST|SECOND; none; CHAPTER;)
+  :breaks: new=:C; break=1
+  :promo: sisu, ruby, sisu_search_libre, open_society
+  :bold: [regular expression of words/phrases to be made bold]
+  :italics: [regular expression of words/phrases to italicise]
 
 }code
 
 code{
 
 @original:
- :language: [language]
+  :language: [language]
 
 }code
 
 code{
 
 @notes:
- :comment:
- :prefix: [prefix is placed just after table of contents]
+  :comment:
+  :prefix: [prefix is placed just after table of contents]
 
 }code
 
@@ -458,12 +457,19 @@ in each case level may be 0-9
 
 !_ resulting output:
 
-_0_1 first line no indent, rest of paragraph indented one step
+_0_1 first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step;
 
-_1_0 first line indented, rest of paragraph no indent
+A regular paragraph.
+
+_1_0 first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent
 
 in each case level may be 0-9
 
+_0_1 *{live-build}* A collection of scripts used to build customized Debian Livesystems. /{live-build}/ was formerly known as live-helper, and even earlier known as live-package.
+
+_0_1 *{live-build}* \\
+A collection of scripts used to build customized Debian Livesystems. /{live-build}/ was formerly known as live-helper, and even earlier known as live-package.
+
 2~ Footnotes / Endnotes
 
 Footnotes and endnotes are marked up at the location where they would be indicated within a text. They are automatically numbered. The output type determines whether footnotes or endnotes will be produced
@@ -1266,232 +1272,4 @@ code{
 
 }code
 
-The form described above should be relied on. Within the Vim editor it results in the text thus linked becoming hyperlinked to the document it is calling in which is convenient for editing. Alternative markup for importation of documents under consideration, and occasionally supported have been.
-
-code{
-
-<< filename.ssi
-
-<<{filename.ssi}
-
-% using textlink alternatives
-
-<< |filename.ssi|@|^|
-
-}code
-
-1~syntax_history Markup Syntax History
-
-2~ Notes related to Files-types and Markup Syntax
-
-3.0 very minor additions to markup added, substantially the same as version 2.0
-
-2.0 introduced new headers and is therefore incompatible with 1.0 though otherwise the same with the addition of a couple of tags (i.e. a superset)
-
-0.38 is substantially current for version 1.0
-
-depreciated 0.16 supported, though file names were changed at 0.37
-
-_* sisu --query=[sisu version [0.38] or 'history]
-
-provides a short history of changes to SiSU markup
-
-!_ SiSU 2.0
-(2010-03-06:09/6)
-same as 1.0, apart from the changing of headers and the addition of a monospace tag related headers now grouped, e.g.
-
-code{
-
-@title:
- :subtitle:
-
-@creator:
- :author:
- :translator:
- :illustrator:
-
-@rights:
- :text:
- :illustrations:
-
-}code
-
-see document markup samples, and sisu --help headers
-
-the monospace tag takes the form of a hash '#'
-
-code{
-
-#{ this enclosed text would be monospaced }#
-
-}code
-
-!_  1.0
-(2009-12-19:50/6)
-same as 0.69
-
-!_ 0.69
-(2008-09-16:37/2)
-(same as 1.0) and as previous (0.57) with the addition of book index tags
-
-code{
-
-/^={.+?}$/
-
-}code
-
-e.g. appended to a paragraph, on a new-line (without a blank line in between) logical structure produced assuming this is the first text "object"
-
-code{
-
- ={GNU/Linux community distribution:Debian+2|Fedora|Gentoo;Free Software Foundation+5}
-
-}code
-
-code{
-
-Free Software Foundation, 1-6
-GNU/Linux community distribution, 1
-    Debian, 1-3
-    Fedora, 1
-    Gentoo,
-
-}code
-
-!_ 0.66
-(2008-02-24:07/7)
-same as previous, adds semantic tags, [experimental and not-used]
-
-code{
-
-/[:;]{.+?}[:;][a-z+]/
-
-}code
-
-!_ 0.57
-(2007w34/4)
-SiSU 0.57 is the same as 0.42 with the introduction of some a shortcut to use the headers @title and @creator in the first heading [expanded using the contents of the headers @title: and @author:]
-
-code{
-
-:A~ @title by @author
-
-}code
-
-!_ 0.52
-(2007w14/6)
-declared document type identifier at start of text/document:
-
-_1 SiSU 0.52
-
-or, backward compatible using the comment marker:
-
-_1 % SiSU 0.38
-
-variations include 'SiSU (text|master|insert) [version]' and 'sisu-[version]'
-
-!_ 0.51
-(2007w13/6)
-skins changed (simplified), markup unchanged
-
-!_ 0.42
-(2006w27/4)
-* (asterisk) type endnotes, used e.g. in relation to author
-
-SiSU 0.42 is the same as 0.38 with the introduction of some additional endnote types,
-
-Introduces some variations on endnotes, in particular the use of the asterisk
-
-code{
-
-~{* for example for describing an author }~ and ~{** for describing a second author }~
-
-}code
-
-* for example for describing an author
-
-** for describing a second author
-
-and
-
-code{
-
-~[* my note ]~ or ~[+ another note ]~
-
-}code
-
-which numerically increments an asterisk and plus respectively
-
-*1 my note
-+1 another note
-
-!_ 0.38
-(2006w15/7)
-introduced new/alternative notation for headers, e.g. @title: (instead of 0\~title), and accompanying document structure markup, :A,:B,:C,1,2,3 (maps to previous 1,2,3,4,5,6)
-
-SiSU 0.38 introduced alternative experimental header and heading/structure markers,
-
-code{
-
-@headername: and headers :A~ :B~ :C~ 1~ 2~ 3~
-
-}code
-
-as the equivalent of:
-
-code{
-
-0~headername and headers 1~ 2~ 3~ 4~ 5~ 6~
-
-}code
-
-The internal document markup of SiSU 0.16 remains valid and standard Though note that SiSU 0.37 introduced a new file naming convention
-
-SiSU has in effect two sets of levels to be considered, using 0.38 notation A-C headings/levels, pre-ordinary paragraphs /pre-substantive text, and 1-3 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 (using the 0.16 standard notation 1,2,3 and 4,5,6) on the positive side: the 0.38 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
-
-!_ 0.37
-(2006w09/7)
-introduced new file naming convention, .sst (text), .ssm (master), .ssi (insert), markup syntax unchanged
-
-SiSU 0.37 introduced new file naming convention, using the file extensions .sst .ssm and .ssi to replace .s1 .s2 .s3 .r1 .r2 .r3 and .si
-
-this is captured by the following file 'rename' instruction:
-
-code{
-
-rename 's/\.s[123]$/\.sst/' *.s{1,2,3}
-rename 's/\.r[123]$/\.ssm/' *.r{1,2,3}
-rename 's/\.si$/\.ssi/' *.si
-
-}code
-
-The internal document markup remains unchanged, from SiSU 0.16
-
-!_ 0.35
-(2005w52/3)
-sisupod, zipped content file introduced
-
-!_ 0.23
-(2005w36/2)
-utf-8 for markup file
-
-!_ 0.22
-(2005w35/3)
-image dimensions may be omitted if rmagick is available to be relied upon
-
-!_ 0.20.4
-(2005w33/4)
-header 0~links
-
-!_ 0.16
-(2005w25/2)
-substantial changes introduced to make markup cleaner, header 0\~title type, and headings [1-6]\~ introduced, also percentage sign (%) at start of a text line as comment marker
-
-SiSU 0.16 (0.15 development branch) introduced the use of
-
-the header 0~ and headings/structure 1~ 2~ 3~ 4~ 5~ 6~
-
-in place of the 0.1 header, heading/structure notation
-
-SiSU 0.1 headers and headings structure represented by
-header 0{~ and headings/structure 1{ 2{ 3{ 4{~ 5{ 6{
+The form described above should be relied on. Within the Vim editor it results in the text thus linked becoming hyperlinked to the document it is calling in which is convenient for editing.
diff --git a/data/doc/sisu/markup-samples/v3/sisu_manual/sisu_markup_syntax_history.sst b/data/doc/sisu/markup-samples/v3/sisu_manual/sisu_markup_syntax_history.sst
new file mode 100644
index 00000000..f0b621ff
--- /dev/null
+++ b/data/doc/sisu/markup-samples/v3/sisu_manual/sisu_markup_syntax_history.sst
@@ -0,0 +1,256 @@
+% SiSU 2.0
+
+@title: SiSU
+ :subtitle: Markup
+
+@creator:
+ :author: Amissah, Ralph
+
+@date:
+ :created: 2002-08-28
+ :issued: 2002-08-28
+ :available: 2002-08-28
+ :published: 2008-05-22
+ :modified: 2012-10-03
+
+@rights:
+ :copyright: Copyright (C) Ralph Amissah 2007
+ :license: GPL 3 (part of SiSU documentation)
+
+@classify:
+ :topic_register: electronic documents:SiSU:document:markup;SiSU:document:markup;SiSU:document:markup;SiSU:manual:markup;electronic documents:SiSU:manual:markup
+ :subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search
+
+@links:
+ { SiSU Homepage }http://www.sisudoc.org/
+ { SiSU Manual }http://www.sisudoc.org/sisu/sisu_manual/
+ { Book Samples & Markup Examples }http://www.jus.uio.no/sisu/SiSU/examples.html
+ { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
+ { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
+ { SiSU Git repo }http://git.sisudoc.org/?p=code/sisu.git;a=summary
+ { SiSU List Archives }http://lists.sisudoc.org/pipermail/sisu/
+ { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
+ { SiSU Project @ Debian }http://qa.debian.org/developer.php?login=sisu@lists.sisudoc.org
+ { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
+
+@make:
+ :num_top: 1
+ :breaks: new=C; break=1
+
+:A~? @title @creator
+
+1~syntax_history Markup Syntax History
+
+2~ Notes related to Files-types and Markup Syntax
+
+3.0 very minor additions to markup added, substantially the same as version 2.0
+
+2.0 introduced new headers and is therefore incompatible with 1.0 though otherwise the same with the addition of a couple of tags (i.e. a superset)
+
+0.38 is substantially current for version 1.0
+
+depreciated 0.16 supported, though file names were changed at 0.37
+
+_* sisu --query=[sisu version [0.38] or 'history]
+
+provides a short history of changes to SiSU markup
+
+!_ SiSU 2.0
+(2010-03-06:09/6)
+same as 1.0, apart from the changing of headers and the addition of a monospace tag related headers now grouped, e.g.
+
+code{
+
+@title:
+  :subtitle:
+
+@creator:
+  :author:
+  :translator:
+  :illustrator:
+
+@rights:
+  :text:
+  :illustrations:
+
+}code
+
+see document markup samples, and sisu --help headers
+
+the monospace tag takes the form of a hash '#'
+
+code{
+
+#{ this enclosed text would be monospaced }#
+
+}code
+
+!_  1.0
+(2009-12-19:50/6)
+same as 0.69
+
+!_ 0.69
+(2008-09-16:37/2)
+(same as 1.0) and as previous (0.57) with the addition of book index tags
+
+code{
+
+/^={.+?}$/
+
+}code
+
+e.g. appended to a paragraph, on a new-line (without a blank line in between) logical structure produced assuming this is the first text "object"
+
+code{
+
+ ={GNU/Linux community distribution:Debian+2|Fedora|Gentoo;Free Software Foundation+5}
+
+}code
+
+code{
+
+Free Software Foundation, 1-6
+GNU/Linux community distribution, 1
+    Debian, 1-3
+    Fedora, 1
+    Gentoo,
+
+}code
+
+!_ 0.66
+(2008-02-24:07/7)
+same as previous, adds semantic tags, [experimental and not-used]
+
+code{
+
+/[:;]{.+?}[:;][a-z+]/
+
+}code
+
+!_ 0.57
+(2007w34/4)
+SiSU 0.57 is the same as 0.42 with the introduction of some a shortcut to use the headers @title and @creator in the first heading [expanded using the contents of the headers @title: and @author:]
+
+code{
+
+:A~ @title by @author
+
+}code
+
+!_ 0.52
+(2007w14/6)
+declared document type identifier at start of text/document:
+
+_1 SiSU 0.52
+
+or, backward compatible using the comment marker:
+
+_1 % SiSU 0.38
+
+variations include 'SiSU (text|master|insert) [version]' and 'sisu-[version]'
+
+!_ 0.51
+(2007w13/6)
+skins changed (simplified), markup unchanged
+
+!_ 0.42
+(2006w27/4)
+* (asterisk) type endnotes, used e.g. in relation to author
+
+SiSU 0.42 is the same as 0.38 with the introduction of some additional endnote types,
+
+Introduces some variations on endnotes, in particular the use of the asterisk
+
+code{
+
+~{* for example for describing an author }~ and ~{** for describing a second author }~
+
+}code
+
+* for example for describing an author
+
+** for describing a second author
+
+and
+
+code{
+
+~[* my note ]~ or ~[+ another note ]~
+
+}code
+
+which numerically increments an asterisk and plus respectively
+
+*1 my note
++1 another note
+
+!_ 0.38
+(2006w15/7)
+introduced new/alternative notation for headers, e.g. @title: (instead of 0\~title), and accompanying document structure markup, :A,:B,:C,1,2,3 (maps to previous 1,2,3,4,5,6)
+
+SiSU 0.38 introduced alternative experimental header and heading/structure markers,
+
+code{
+
+@headername: and headers :A~ :B~ :C~ 1~ 2~ 3~
+
+}code
+
+as the equivalent of:
+
+code{
+
+0~headername and headers 1~ 2~ 3~ 4~ 5~ 6~
+
+}code
+
+The internal document markup of SiSU 0.16 remains valid and standard Though note that SiSU 0.37 introduced a new file naming convention
+
+SiSU has in effect two sets of levels to be considered, using 0.38 notation A-C headings/levels, pre-ordinary paragraphs /pre-substantive text, and 1-3 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 (using the 0.16 standard notation 1,2,3 and 4,5,6) on the positive side: the 0.38 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
+
+!_ 0.37
+(2006w09/7)
+introduced new file naming convention, .sst (text), .ssm (master), .ssi (insert), markup syntax unchanged
+
+SiSU 0.37 introduced new file naming convention, using the file extensions .sst .ssm and .ssi to replace .s1 .s2 .s3 .r1 .r2 .r3 and .si
+
+this is captured by the following file 'rename' instruction:
+
+code{
+
+rename 's/\.s[123]$/\.sst/' *.s{1,2,3}
+rename 's/\.r[123]$/\.ssm/' *.r{1,2,3}
+rename 's/\.si$/\.ssi/' *.si
+
+}code
+
+The internal document markup remains unchanged, from SiSU 0.16
+
+!_ 0.35
+(2005w52/3)
+sisupod, zipped content file introduced
+
+!_ 0.23
+(2005w36/2)
+utf-8 for markup file
+
+!_ 0.22
+(2005w35/3)
+image dimensions may be omitted if rmagick is available to be relied upon
+
+!_ 0.20.4
+(2005w33/4)
+header 0~links
+
+!_ 0.16
+(2005w25/2)
+substantial changes introduced to make markup cleaner, header 0\~title type, and headings [1-6]\~ introduced, also percentage sign (%) at start of a text line as comment marker
+
+SiSU 0.16 (0.15 development branch) introduced the use of
+
+the header 0~ and headings/structure 1~ 2~ 3~ 4~ 5~ 6~
+
+in place of the 0.1 header, heading/structure notation
+
+SiSU 0.1 headers and headings structure represented by
+header 0{~ and headings/structure 1{ 2{ 3{ 4{~ 5{ 6{
diff --git a/data/doc/sisu/markup-samples/v4/sisu_manual/_sisu/sisu_document_make b/data/doc/sisu/markup-samples/v4/sisu_manual/_sisu/sisu_document_make
index 17c6bbf8..72706d10 100644
--- a/data/doc/sisu/markup-samples/v4/sisu_manual/_sisu/sisu_document_make
+++ b/data/doc/sisu/markup-samples/v4/sisu_manual/_sisu/sisu_document_make
@@ -2,7 +2,7 @@
  :num_top: 1
  :breaks: new=C; break=1
  :bold: /Debian|Ruby|SiSU/
- :italics: /Linux|GPL|GPLv3|LaTeX|PostgreSQL|SQLite|SQL|Vim|ascii|plaintext|UTF-?8|HTML|XHTML|XML|EPUB|OpenDocument|ODF|ODT|PDF|pgSQL|TeXinfo|YAML|YML|ocn|object citation system|object citation numbering|granular search|Dublin Core/
+ :italics: /Linux|GPL|GPLv3|LaTeX|PostgreSQL|SQLite|SQL|Vim|ascii|plaintext|UTF-?8|HTML|XHTML|XML|EPUB|OpenDocument|ODF|ODT|PDF|pgSQL|TeXinfo|YAML|YML|OCN|object citation system|object citation numbering|granular search|Dublin Core/
  :substitute: /${debian_stable}/,'*{Wheezy}*' /${debian_testing}/,'*{Jessie}*'
  :home_button_text: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
  :footer: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
diff --git a/data/doc/sisu/markup-samples/v4/sisu_manual/sisu_markup.sst b/data/doc/sisu/markup-samples/v4/sisu_manual/sisu_markup.sst
index 9027817a..98377850 100644
--- a/data/doc/sisu/markup-samples/v4/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/markup-samples/v4/sisu_manual/sisu_markup.sst
@@ -97,41 +97,40 @@ This current document is loaded by a master document that has a header similar t
 
 code{
 
-% SiSU master 2.0
+% SiSU master 4.0
 
 @title: SiSU
- :subtitle: Manual
+  :subtitle: Manual
 
 @creator:
- :author: Amissah, Ralph
+  :author: Amissah, Ralph
 
 @publisher: [publisher name]
 
 @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
 
 @classify:
- :type: information
- :topic_register: SiSU:manual;electronic documents:SiSU:manual
- :subject: ebook, epublishing, electronic book, electronic publishing,
+  :topic_register: SiSU:manual;electronic documents:SiSU:manual
+  :subject: ebook, epublishing, electronic book, electronic publishing,
     electronic document, electronic citation, data structure,
      citation systems, search
 
 % used_by: manual
 
 @date:
- :published: 2008-05-22
- :created: 2002-08-28
- :issued: 2002-08-28
- :available: 2002-08-28
- :modified: 2010-03-03
+  :published: 2008-05-22
+  :created: 2002-08-28
+  :issued: 2002-08-28
+  :available: 2002-08-28
+  :modified: 2010-03-03
 
 @make:
- :num_top: 1
- :breaks: new=C; break=1
- :bold: /Gnu|Debian|Ruby|SiSU/
- :home_button_text: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
- :footer: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
- :manpage: name=sisu - documents: markup, structuring, publishing in multiple standard formats, and search;
+  :num_top: 1
+  :breaks: new=C; break=1
+  :bold: /Gnu|Debian|Ruby|SiSU/
+  :home_button_text: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
+  :footer: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
+  :manpage: name=sisu - documents: markup, structuring, publishing in multiple standard formats, and search;
      synopsis=sisu [-abcDdeFhIiMmNnopqRrSsTtUuVvwXxYyZz0-9] [filename/wildcard ]
      . sisu [-Ddcv] [instruction]
      . sisu [-CcFLSVvW]
@@ -139,16 +138,16 @@ code{
      . sisu --v3 [operations]
 
 @links:
- { SiSU Homepage }http://www.sisudoc.org/
- { SiSU Manual }http://www.sisudoc.org/sisu/sisu_manual/
- { Book Samples & Markup Examples }http://www.jus.uio.no/sisu/SiSU/examples.html
- { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
- { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
- { SiSU Git repo }http://git.sisudoc.org/?p=code/sisu.git;a=summary
- { SiSU List Archives }http://lists.sisudoc.org/pipermail/sisu/
- { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
- { SiSU Project @ Debian }http://qa.debian.org/developer.php?login=sisu@lists.sisudoc.org
- { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
+  { SiSU Homepage }http://www.sisudoc.org/
+  { SiSU Manual }http://www.sisudoc.org/sisu/sisu_manual/
+  { Book Samples & Markup Examples }http://www.jus.uio.no/sisu/SiSU/examples.html
+  { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
+  { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
+  { SiSU Git repo }http://git.sisudoc.org/?p=code/sisu.git;a=summary
+  { SiSU List Archives }http://lists.sisudoc.org/pipermail/sisu/
+  { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
+  { SiSU Project @ Debian }http://qa.debian.org/developer.php?login=sisu@lists.sisudoc.org
+  { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
 
 }code
 
@@ -156,10 +155,10 @@ code{
 
 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 the form @headername: or on the next line and indented by once space :subheadername: All Dublin Core meta tags are available
 
-!_ @indentifier:
+!_ @identifier:
 information or instructions
 
-where the "identifier" is a tag recognised by the program, and the "information" or "instructions" belong to the tag/indentifier specified
+where the "identifier" is a tag recognised by the program, and the "information" or "instructions" belong to the tag/identifier specified
 
 Note: a header where used should only be used once; all headers apart from @title: are optional; the @structure: header is used to describe document structure, and can be useful to know.
 
@@ -173,7 +172,6 @@ code{
 
 }code
 
-
 code{
 
 @title: [title text] [this header is the only one that is mandatory]
@@ -185,57 +183,57 @@ code{
 code{
 
 @creator:
- :author: [Lastname, First names]
- :illustrator: [Lastname, First names]
- :translator: [Lastname, First names]
- :prepared_by: [Lastname, First names]
+  :author: [Lastname, First names]
+  :illustrator: [Lastname, First names]
+  :translator: [Lastname, First names]
+  :prepared_by: [Lastname, First names]
 
 }code
 
 code{
 
 @date:
- :published: [year or yyyy-mm-dd]
- :created: [year or yyyy-mm-dd]
- :issued: [year or yyyy-mm-dd]
- :available: [year or yyyy-mm-dd]
- :modified: [year or yyyy-mm-dd]
- :valid: [year or yyyy-mm-dd]
- :added_to_site: [year or yyyy-mm-dd]
- :translated: [year or yyyy-mm-dd]
+  :published: [year or yyyy-mm-dd]
+  :created: [year or yyyy-mm-dd]
+  :issued: [year or yyyy-mm-dd]
+  :available: [year or yyyy-mm-dd]
+  :modified: [year or yyyy-mm-dd]
+  :valid: [year or yyyy-mm-dd]
+  :added_to_site: [year or yyyy-mm-dd]
+  :translated: [year or yyyy-mm-dd]
 
 }code
 
 code{
 
 @rights:
- :copyright: Copyright (C) [Year and Holder]
- :license: [Use License granted]
- :text: [Year and Holder]
- :translation: [Name, Year]
- :illustrations: [Name, Year]
+  :copyright: Copyright (C) [Year and Holder]
+  :license: [Use License granted]
+  :text: [Year and Holder]
+  :translation: [Name, Year]
+  :illustrations: [Name, Year]
 
 }code
 
 code{
 
 @classify:
- :topic_register: SiSU:markup sample:book;book:novel:fantasy
- :type:
- :subject:
- :description:
- :keywords:
- :abstract:
- :loc: [Library of Congress classification]
- :dewey: [Dewey classification
+  :topic_register: SiSU:markup sample:book;book:novel:fantasy
+  :type:
+  :subject:
+  :description:
+  :keywords:
+  :abstract:
+  :loc: [Library of Congress classification]
+  :dewey: [Dewey classification
 
 }code
 
 code{
 
 @identify:
- :isbn: [ISBN]
- :oclc:
+  :isbn: [ISBN]
+  :oclc:
 
 }code
 
@@ -250,30 +248,30 @@ code{
 code{
 
 @make:
- :num_top: 1
- :headings: [text to match for each level
+  :num_top: 1
+  :headings: [text to match for each level
     (e.g. PART; Chapter; Section; Article; or another: none; BOOK|FIRST|SECOND; none; CHAPTER;)
- :breaks: new=:C; break=1
- :promo: sisu, ruby, sisu_search_libre, open_society
- :bold: [regular expression of words/phrases to be made bold]
- :italics: [regular expression of words/phrases to italicise]
- :home_button_text: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
- :footer: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
+  :breaks: new=:C; break=1
+  :promo: sisu, ruby, sisu_search_libre, open_society
+  :bold: [regular expression of words/phrases to be made bold]
+  :italics: [regular expression of words/phrases to italicise]
+  :home_button_text: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
+  :footer: {SiSU}http://sisudoc.org; {git}http://git.sisudoc.org
 
 }code
 
 code{
 
 @original:
- :language: [language]
+  :language: [language]
 
 }code
 
 code{
 
 @notes:
- :comment:
- :prefix: [prefix is placed just after table of contents]
+  :comment:
+  :prefix: [prefix is placed just after table of contents]
 
 }code
 
@@ -449,12 +447,19 @@ in each case level may be 0-9
 
 !_ resulting output:
 
-_0_1 first line no indent, rest of paragraph indented one step
+_0_1 first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step; first line no indent, rest of paragraph indented one step;
+
+A regular paragraph.
 
-_1_0 first line indented, rest of paragraph no indent
+_1_0 first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent first line indented, rest of paragraph no indent
 
 in each case level may be 0-9
 
+_0_1 *{live-build}* A collection of scripts used to build customized Debian Livesystems. /{live-build}/ was formerly known as live-helper, and even earlier known as live-package.
+
+_0_1 *{live-build}* \\
+A collection of scripts used to build customized Debian Livesystems. /{live-build}/ was formerly known as live-helper, and even earlier known as live-package.
+
 2~ Footnotes / Endnotes
 
 Footnotes and endnotes are marked up at the location where they would be indicated within a text. They are automatically numbered. The output type determines whether footnotes or endnotes will be produced
diff --git a/data/doc/sisu/markup-samples/v4/sisu_manual/sisu_markup_syntax_history.sst b/data/doc/sisu/markup-samples/v4/sisu_manual/sisu_markup_syntax_history.sst
index a5b56f1f..c6da0a14 100644
--- a/data/doc/sisu/markup-samples/v4/sisu_manual/sisu_markup_syntax_history.sst
+++ b/data/doc/sisu/markup-samples/v4/sisu_manual/sisu_markup_syntax_history.sst
@@ -25,22 +25,6 @@
 
 :B~? SiSU Markup Syntax History
 
-1~ Composite documents markup
-
-It is possible to build a document by creating a master document that requires other documents. The documents required may be 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 from other documents), it should be named with the suffix *{.ssm}* 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 *{.sst}* regular markup file, or *{.ssi}* (insert/information) A secondary file of the composite document is built prior to processing with the same prefix and the suffix *{._sst}*
-
-basic markup for importing a document into a master document
-
-code{
-
-<< filename1.sst
-
-<< filename2.ssi
-
-}code
-
-The form described above should be relied on. Within the Vim editor it results in the text thus linked becoming hyperlinked to the document it is calling in which is convenient for editing.
-
 1~syntax_history Markup Syntax History
 
 2~ Notes related to Files-types and Markup Syntax
@@ -66,16 +50,16 @@ same as 1.0, apart from the changing of headers and the addition of a monospace
 code{
 
 @title:
- :subtitle:
+  :subtitle:
 
 @creator:
- :author:
- :translator:
- :illustrator:
+  :author:
+  :translator:
+  :illustrator:
 
 @rights:
- :text:
- :illustrations:
+  :text:
+  :illustrations:
 
 }code