aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorRalph Amissah <ralph@amissah.com>2013-02-22 21:40:54 -0500
committerRalph Amissah <ralph@amissah.com>2013-02-22 21:41:20 -0500
commitf6f8918bfdf8d9bd550f473ecfb53744e17f5731 (patch)
treea375925f595a1106066ce02e7ce0eb46669a858a
parentv4: emacs, sisu-mode.el (diff)
v4: documentation, sisu markup (sisu_markup.sst, man page sisu.1, sisu.1.html)sisu_4.0.9
-rw-r--r--data/doc/sisu/CHANGELOG_v41
-rw-r--r--data/doc/sisu/html/sisu.1.html18
-rw-r--r--data/doc/sisu/markup-samples/v4/sisu_manual/sisu_markup.sst16
-rw-r--r--man/man1/sisu.117
4 files changed, 42 insertions, 10 deletions
diff --git a/data/doc/sisu/CHANGELOG_v4 b/data/doc/sisu/CHANGELOG_v4
index 203a0189..b8d88e1b 100644
--- a/data/doc/sisu/CHANGELOG_v4
+++ b/data/doc/sisu/CHANGELOG_v4
@@ -33,6 +33,7 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_4.0.9.orig.tar.xz
* output formats modified to include, (pdf, odf, epub, html, plaintext)
* vim syntax, sisu.vim
* emacs, sisu-mode.el
+ * documentation, sisu_markup.sst, man page sisu.1, sisu.1.html
%% 4.0.8.orig.tar.xz (2013-02-20:07/3)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_4.0.8
diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html
index 3d852a3e..56535d2e 100644
--- a/data/doc/sisu/html/sisu.1.html
+++ b/data/doc/sisu/html/sisu.1.html
@@ -372,8 +372,7 @@ invoked by --dump &amp; redirect). </dd>
<dd>see --dal (document abstraction level/layer) </dd>
<dt><b>--machine [filename/wildcard/url]</b> </dt>
-<dd>see --dal (document abstraction
-level/layer) </dd>
+<dd>see --dal (document abstraction level/layer) </dd>
<dt><b>--maintenance [filename/wildcard/url]</b> </dt>
<dd>maintenance mode, interim
@@ -381,8 +380,7 @@ processing files are preserved and their locations indicated. (also see
-V). Aliases -M and --keep-processing-files. </dd>
<dt><b>--manpage [filename/wildcard]</b> </dt>
-<dd>produces
-man page of file, not suitable for all outputs. Alias -i </dd>
+<dd>produces man page of file, not suitable for all outputs. Alias -i </dd>
<dt><b>-N [filename/wildcard/url]</b> </dt>
<dd>document digest or document content certificate ( DCC ) as md5 digest tree
@@ -1900,18 +1898,24 @@ or breaks the page, starts a new page.
<p> page break -\- or breaks a column,
starts a new column, if using columns, else breaks the page, starts a new
page.
-<p> <br>
+<p> page break line across page -..- draws a dividing line, dividing paragraphs
+
+<p> page break: <br>
<pre>-\\-
or
&lt;:pb&gt;
</pre>
-<p> or
-<p> <br>
+<p>
+<p> page (break) new: <br>
<pre>=\\=
or
&lt;:pn&gt;
</pre>
<p>
+<p> page (break) line across page (dividing paragraphs): <br>
+<pre>-..-
+</pre>
+<p>
<h2><a name='sect43' href='#toc43'>Book Index</a></h2>
<p> To make an index append to paragraph the book index term relates
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 98377850..92b7f430 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
@@ -1162,6 +1162,8 @@ may be used.
The html break br enclosed in angle brackets (though undocumented) is available in versions prior to 3.0.13 and 2.9.7 (it remains available for the time being, but is depreciated).
+To draw a dividing line dividing paragraphs, see the section on page breaks.
+
3~ page breaks
Page breaks are only relevant and honored in some output formats. A page break or a new page may be inserted manually using the following markup on a line on its own:
@@ -1170,6 +1172,10 @@ page new =\\= or <:pn> breaks the page, starts a new page.
page break -\\- or <:pb> breaks a column, starts a new column, if using columns, else breaks the page, starts a new page.
+page break line across page -..- draws a dividing line, dividing paragraphs
+
+page break:
+
code{
-\\-
@@ -1180,7 +1186,7 @@ or
}code
-or
+page (break) new:
code{
@@ -1192,6 +1198,14 @@ or
}code
+page (break) line across page (dividing paragraphs):
+
+code{
+
+-..-
+
+}code
+
2~ Book index
To make an index append to paragraph the book index term relates to it, using an equal sign and curly braces.
diff --git a/man/man1/sisu.1 b/man/man1/sisu.1
index f21808b1..9fcc524c 100644
--- a/man/man1/sisu.1
+++ b/man/man1/sisu.1
@@ -1,4 +1,4 @@
-.TH "sisu" "1" "2013-02-07" "4.0.6" "SiSU"
+.TH "sisu" "1" "2013-02-22" "4.0.9" "SiSU"
.br
.SH NAME
.br
@@ -2272,6 +2272,12 @@ page new =\e= or breaks the page, starts a new page.
.BR
page break -\\- or breaks a column, starts a new column, if using columns,
else breaks the page, starts a new page.
+
+.BR
+page break line across page -..- draws a dividing line, dividing paragraphs
+
+.BR
+page break:
.nf
-\e\e-
@@ -2280,13 +2286,20 @@ or
.fi
.BR
-or
+page (break) new:
.nf
=\e\e=
or
<:pn>
.fi
+
+.BR
+page (break) line across page (dividing paragraphs):
+.nf
+-..-
+.fi
+
.SH BOOK INDEX
.BR