From 2aa25d8c89808eb50a1da5c41f63b7920b4f0f5e Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Thu, 14 Feb 2008 02:51:52 +0000 Subject: minor information/help (man page) related --- data/doc/sisu/html/sisu.1.html | 55 +++++++++++++--------- data/doc/sisu/html/sisu_vim.7.html | 44 ++++++++--------- .../sisu/sisu_markup_samples/sisu_manual/sisu.ssm | 6 +-- .../sisu_manual/sisu_markup.sst | 18 +++++-- .../sisu_markup_samples/sisu_manual/sisu_vim.sst | 10 ++-- man/man1/sisu.1 | 38 +++++++++++---- man/man7/sisu_vim.7 | 32 ++++++------- 7 files changed, 123 insertions(+), 80 deletions(-) diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html index aee67590..88717ed6 100644 --- a/data/doc/sisu/html/sisu.1.html +++ b/data/doc/sisu/html/sisu.1.html @@ -685,26 +685,35 @@ as code

Some interactive help on markup is available, by typing sisu and selecting

markup or sisu --help markup +

To check the markup in a file: +

sisu --identify + [filename].sst
+ +

For brief descriptive summary of markup history +

sisu --query-history
+ +

or if for a particular version: +

sisu --query-0.38
+

7.2 MARKUP EXAMPLES

7.2.1 ONLINE -

Online markup -examples are available together with the respective outputs produced from -<http://www.jus.uio.no/sisu/SiSU/examples.html -> or from <http://www.jus.uio.no/sisu/sisu_examples/ -> - -

There is of course this document, which provides a cursory overview of -sisu markup and the respective output produced: <http://www.jus.uio.no/sisu/sisu_markup/ +

Online markup examples are available +together with the respective outputs produced from <http://www.jus.uio.no/sisu/SiSU/examples.html > - -

Some example marked up files are available as html with syntax highlighting -for viewing: <http://www.jus.uio.no/sisu/sample/syntax +or from <http://www.jus.uio.no/sisu/sisu_examples/ > -

an alternative presentation -of markup syntax: <http://www.jus.uio.no/sisu/sample/on_markup.txt +

There is of course this +document, which provides a cursory overview of sisu markup and the respective +output produced: <http://www.jus.uio.no/sisu/sisu_markup/ > -

7.2.2 INSTALLED +

Some example marked +up files are available as html with syntax highlighting for viewing: <http://www.jus.uio.no/sisu/sample/syntax +> + +

an alternative presentation of markup syntax: <http://www.jus.uio.no/sisu/sample/on_markup.txt +> +

7.2.2 INSTALLED

With SiSU installed sample skins may be found in: /usr/share/doc/sisu/sisu_markup_samples/dfsg (or equivalent directory) and if sisu-markup-samples is installed also under: @@ -3262,30 +3271,30 @@ html pages[^28]

DC Title: SiSU - Manual

DC Creator: Ralph Amissah

DC Rights: Copyright -(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 +(C) Ralph Amissah 2008, part of SiSU documentation, License GPL 3

DC Type: information

DC Date created: 2002-08-28

DC Date issued: 2002-08-28

DC Date available: 2002-08-28 -

DC Date modified: 2008-02-05 -

DC Date: 2008-02-05 +

DC Date modified: 2008-02-12 +

DC Date: 2008-02-12

Version Information

Sourcefile: sisu.ssm.sst

Filetype: SiSU text insert

0.58 -

Sourcefile Digest, MD5(sisu.ssm.sst)= 587397c3165a622e01a5c800d69d39a0 +

Sourcefile Digest, MD5(sisu.ssm.sst)= 1a602f31f72da6a8d1e6fc6b42d1b703

Skin_Digest: MD5(skin_sisu_manual.rb)= 072b2584bedea82ea8a416587b9fa244

Generated -

Document (metaverse) last generated: Tue Feb 05 23:45:59 +

Document (metaverse) last generated: Thu Feb 14 02:44:23

+0000 2008 -

Generated by: SiSU 0.64.3 of 2008w05/2 (2008-02-05) +

Generated by: SiSU 0.64.4 of 2008w06/4 (2008-02-14)

Ruby version: ruby 1.8.6 (2007-09-24 patchlevel 111)  [i486-linux]

@@ -3403,15 +3412,15 @@ distributable are not freely changeable. .

  • named index.html or mo
    -
    * Generated by: SiSU 0.64.3 of 2008w05/2 (2008-02-05)
    +
    * Generated by: SiSU 0.64.4 of 2008w06/4 (2008-02-14)
    * Ruby version: ruby 1.8.6 (2007-09-24 patchlevel 111) [i486-linux]
    -
    * Last Generated on: Tue Feb -05 23:45:59 +0000 2008
    +
    * Last Generated on: Thu Feb +14 02:44:23 +0000 2008
    * SiSU http://www.jus.uio.no/sisu diff --git a/data/doc/sisu/html/sisu_vim.7.html b/data/doc/sisu/html/sisu_vim.7.html index 5099bb3a..385eef0e 100644 --- a/data/doc/sisu/html/sisu_vim.7.html +++ b/data/doc/sisu/html/sisu_vim.7.html @@ -9,14 +9,15 @@ Table of Contents

    Name

    -sisu_vim - vim syntax and folds file for sisu: documents: markup, structuring, -publishing in multiple standard formats, and search SISU - VIM, RALPH AMISSAH - + sisu_vim - vim syntax and folds file for sisu: markup, structuring, +publishing in multiple standard formats, and search
    + SISU - VIM, RALPH AMISSAH

    SISU VIM

    1. SISU VIM

    Synopsis -

    SiSU has syntax highlighting for -a number of editors including vim which are documented under: +

    SiSU has +syntax highlighting for a number of editors including vim which are documented +under:

    man sisu_syntax_highlighting

    /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html
    @@ -32,10 +33,11 @@ and to set some defaults for SiSU markup in installed by sisu.

    Vim 7 includes sisu markup syntax highlighting.

    Vim related files are included in: /usr/share/sisu/conf/editor-syntax-etc/vim -(including the syntax highlighter which may be used for earlier versions -of Vim). -

    sisu-vim actions are activated on files with the suffix .sst .ssm -.ssi .-sst ._sst (and the same with a further .meta extension)
    +(including the syntax highlighter, together with an ftplugin which may +be sourced if so desired from your vimrc). +

    sisu-vim actions are activated +on files with the suffix .sst .ssm .ssi .-sst ._sst (and the same with a further +.meta extension)


    @@ -65,7 +67,7 @@ of Vim). SiSU - Vim

    DC Creator: Ralph Amissah

    DC Rights: Copyright (C) Ralph -Amissah 2007, part of SiSU documentation, License GPL 3 +Amissah 2008, part of SiSU documentation, License GPL 3

    DC Type: information

    DC Date created: 2002-11-12 @@ -73,23 +75,23 @@ Amissah 2007, part of SiSU documentation, License GPL 3

    DC Date available:

    2002-11-12 -

    DC Date modified: 2007-09-16 -

    DC Date: 2007-09-16 +

    DC Date modified: 2008-02-12 +

    DC Date: 2008-02-12

    Version Information

    Sourcefile: sisu_vim.sst

    Filetype: SiSU text insert 0.58

    Sourcefile -Digest, MD5(sisu_vim.sst)= a3db74eebef04815aa234d3c3b17f375 +Digest, MD5(sisu_vim.sst)= b5028f957b128162f7653bbd940042ca

    Skin_Digest: -MD5(skin_sisu_manual.rb)= 20fc43cf3eb6590bc3399a1aef65c5a9 +MD5(skin_sisu_manual.rb)= 072b2584bedea82ea8a416587b9fa244

    Generated

    - Document (metaverse) last generated: Sat Sep 29 17:14:44 +0100 2007 + Document (metaverse) last generated: Thu Feb 14 02:44:14 +0000 2008

    -Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) +Generated by: SiSU 0.64.4 of 2008w06/4 (2008-02-14)

    Ruby version: ruby 1.8.6 -(2007-06-07 patchlevel 36)  [i486-linux] +(2007-09-24 patchlevel 111)  [i486-linux]

    @@ -130,15 +132,15 @@ Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
    -
    * Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
    +
    * Generated by: SiSU 0.64.4 of 2008w06/4 (2008-02-14)
    * Ruby version: ruby -1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
    +1.8.6 (2007-09-24 patchlevel 111) [i486-linux]
    -
    * Last Generated on: Sat Sep 29 -17:14:44 +0100 2007
    +
    * Last Generated on: Thu Feb +14 02:44:14 +0000 2008
    * SiSU http://www.jus.uio.no/sisu diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm index 50265706..54bbe2a3 100644 --- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm +++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm @@ -6,7 +6,7 @@ @creator: Ralph Amissah -@rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 +@rights: Copyright (C) Ralph Amissah 2008, part of SiSU documentation, License GPL 3 @type: information @@ -18,9 +18,9 @@ @date.available: 2002-08-28 -@date.modified: 2008-02-05 +@date.modified: 2008-02-12 -@date: 2008-02-05 +@date: 2008-02-12 @level: new=C; break=1; num_top=1 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 9c797dcc..741c26a8 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 @@ -6,7 +6,7 @@ @creator: Ralph Amissah -@rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 +@rights: Copyright (C) Ralph Amissah 2008, part of SiSU documentation, License GPL 3 @type: information @@ -18,9 +18,9 @@ @date.available: 2002-08-28 -@date.modified: 2007-09-16 +@date.modified: 2008-02-12 -@date: 2007-09-16 +@date: 2008-02-12 @level: new=C; break=1; num_top=1 @@ -73,6 +73,18 @@ _1* paragraph actions, such as indent, bulleted, numbered-lists, etc. Some interactive help on markup is available, by typing sisu and selecting markup or sisu --help markup +To check the markup in a file: + +_1 sisu --identify [filename].sst + +For brief descriptive summary of markup history + +_1 sisu --query-history + +or if for a particular version: + +_1 sisu --query-0.38 + 2~ Markup Examples 3~ Online diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_vim.sst b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_vim.sst index a1c324aa..b8018fa8 100644 --- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_vim.sst +++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_vim.sst @@ -6,7 +6,7 @@ @creator: Ralph Amissah -@rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 +@rights: Copyright (C) Ralph Amissah 2008, part of SiSU documentation, License GPL 3 @type: information @@ -18,14 +18,16 @@ @date.available: 2002-11-12 -@date.modified: 2007-09-16 +@date.modified: 2008-02-12 -@date: 2007-09-16 +@date: 2008-02-12 @level: new=C; break=1; num_top=1 @skin: skin_sisu_manual +@man: name= sisu_vim \- vim syntax and folds file for sisu: markup, structuring, publishing in multiple standard formats, and search; + @bold: /Gnu|Debian|Ruby|SiSU/ @links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/ @@ -65,7 +67,7 @@ Vim 7 includes sisu markup syntax highlighting. Vim related files are included in: /usr/share/sisu/conf/editor-syntax-etc/vim -(including the syntax highlighter which may be used for earlier versions of Vim). +(including the syntax highlighter, together with an ftplugin which may be sourced if so desired from your vimrc). sisu-vim actions are activated on files with the suffix .sst .ssm .ssi .-sst ._sst (and the same with a further .meta extension) diff --git a/man/man1/sisu.1 b/man/man1/sisu.1 index 678b65b6..0cfae494 100644 --- a/man/man1/sisu.1 +++ b/man/man1/sisu.1 @@ -1,4 +1,4 @@ -.TH "sisu" "1" "2008-02-05" "0.64.3" "SiSU" +.TH "sisu" "1" "2008-02-12" "0.64.4" "SiSU" .SH NAME sisu \- documents: markup, structuring, publishing in multiple standard formats, and search .SH SYNOPSIS @@ -810,6 +810,24 @@ primary outline of the document structure. Markup of substantive text includes: Some interactive help on markup is available, by typing sisu and selecting markup or sisu \-\-help markup +.BR +To check the markup in a file: + +.BR + sisu \-\-identify \ [filename].sst + +.BR +For brief descriptive summary of markup history + +.BR + sisu \-\-query\-history + +.BR +or if for a particular version: + +.BR + sisu \-\-query\-0.38 + .SH 7.2 MARKUP EXAMPLES @@ -4533,7 +4551,7 @@ DC Creator: .BR DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL +.I Copyright (C) Ralph Amissah 2008, part of SiSU documentation, License GPL 3 .BR @@ -4554,11 +4572,11 @@ DC Date available: .BR DC Date modified: -.I 2008\-02\-05 +.I 2008\-02\-12 .BR DC Date: -.I 2008\-02\-05 +.I 2008\-02\-12 .BR .B Version Information @@ -4573,7 +4591,7 @@ Filetype: .BR Sourcefile Digest, MD5(sisu.ssm.sst)= -.I 587397c3165a622e01a5c800d69d39a0 +.I 1a602f31f72da6a8d1e6fc6b42d1b703 .BR Skin_Digest: MD5(skin_sisu_manual.rb)= @@ -4584,13 +4602,13 @@ Skin_Digest: MD5(skin_sisu_manual.rb)= .BR Document (metaverse) last generated: -.I Tue Feb 05 23:45:59 +0000 2008 +.I Thu Feb 14 02:44:23 +0000 2008 .BR Generated by: .I SiSU -.I 0.64.3 -of 2008w05/2 (2008\-02\-05) +.I 0.64.4 +of 2008w06/4 (2008\-02\-14) .BR Ruby version: @@ -4747,10 +4765,10 @@ pdf: at: .TP .TP -* Generated by: SiSU 0.64.3 of 2008w05/2 (2008-02-05) +* Generated by: SiSU 0.64.4 of 2008w06/4 (2008-02-14) .TP * Ruby version: ruby 1.8.6 (2007-09-24 patchlevel 111) [i486-linux] .TP -* Last Generated on: Tue Feb 05 23:45:59 +0000 2008 +* Last Generated on: Thu Feb 14 02:44:23 +0000 2008 .TP * SiSU http://www.jus.uio.no/sisu diff --git a/man/man7/sisu_vim.7 b/man/man7/sisu_vim.7 index a6e4ecce..1c22b831 100644 --- a/man/man7/sisu_vim.7 +++ b/man/man7/sisu_vim.7 @@ -1,6 +1,6 @@ -.TH "sisu_vim" "1" "2007-09-16" "0.59.1" "SiSU" +.TH "sisu_vim" "1" "2008-02-12" "0.64.4" "SiSU" .SH NAME -sisu_vim \- vim syntax and folds file for sisu: documents: markup, structuring, publishing in multiple standard formats, and search + sisu_vim \- vim syntax and folds file for sisu: markup, structuring, publishing in multiple standard formats, and search .SH SISU \- VIM, RALPH AMISSAH @@ -47,8 +47,8 @@ Vim 7 includes sisu markup syntax highlighting. .BR Vim related files are included in: /usr/share/sisu/conf/editor\-syntax\-etc/vim -(including the syntax highlighter which may be used for earlier versions of -Vim). +(including the syntax highlighter, together with an ftplugin which may be +sourced if so desired from your vimrc). .BR sisu\-vim actions are activated on files with the suffix \.sst \.ssm \.ssi @@ -108,7 +108,7 @@ DC Creator: .BR DC Rights: -.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL +.I Copyright (C) Ralph Amissah 2008, part of SiSU documentation, License GPL 3 .BR @@ -129,11 +129,11 @@ DC Date available: .BR DC Date modified: -.I 2007\-09\-16 +.I 2008\-02\-12 .BR DC Date: -.I 2007\-09\-16 +.I 2008\-02\-12 .BR .B Version Information @@ -148,28 +148,28 @@ Filetype: .BR Sourcefile Digest, MD5(sisu_vim.sst)= -.I a3db74eebef04815aa234d3c3b17f375 +.I b5028f957b128162f7653bbd940042ca .BR Skin_Digest: MD5(skin_sisu_manual.rb)= -.I 20fc43cf3eb6590bc3399a1aef65c5a9 +.I 072b2584bedea82ea8a416587b9fa244 .BR .B Generated .BR Document (metaverse) last generated: -.I Sat Sep 29 17:14:44 +0100 2007 +.I Thu Feb 14 02:44:14 +0000 2008 .BR Generated by: .I SiSU -.I 0.59.1 -of 2007w39/2 (2007\-09\-25) +.I 0.64.4 +of 2008w06/4 (2008\-02\-14) .BR Ruby version: -.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux] +.I ruby 1.8.6 (2007\-09\-24 patchlevel 111) \ [i486\-linux] .TP @@ -188,10 +188,10 @@ manpage: http://www.jus.uio.no/sisu/sisu_vim/sisu_vim.1 at: .TP .TP -* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25) +* Generated by: SiSU 0.64.4 of 2008w06/4 (2008-02-14) .TP -* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] +* Ruby version: ruby 1.8.6 (2007-09-24 patchlevel 111) [i486-linux] .TP -* Last Generated on: Sat Sep 29 17:14:44 +0100 2007 +* Last Generated on: Thu Feb 14 02:44:14 +0000 2008 .TP * SiSU http://www.jus.uio.no/sisu -- cgit v1.2.3