SiSU - Manual,
Ralph Amissah

  1

What is SiSU?

  2

4. Help

4. Help

  45

4.1 SiSU Manual

  46

The most up to date information on sisu should be contained in the sisu_manual, available at:

  47

<http://www.jus.uio.no/sisu/sisu_manual/>

  48

and (from SiSU 0.59 onwards) installed locally at:

  49

/usr/share/doc/sisu/sisu_manual/

  50

or equivalent directory

  51

Within the SiSU tarball at:

  52

./data/doc/sisu/sisu_manual/

  53

4.2 SiSU man pages

  54

If SiSU is installed on your system usual man commands should be available, try:

  55

man sisu

  56

man sisu_markup

  57

man sisu_commands

  58

Most SiSU man pages are generated directly from sisu documents that are used to prepare the sisu manual, the sources files for which are located within the SiSU tarball at:

  59

./data/doc/sisu/sisu_manual/

  60

Once installed, directory equivalent to:

  61

/usr/share/doc/sisu/sisu_manual/

  62

Available man pages are converted back to html using man2html:

  63

/usr/share/doc/sisu/html/

  64

./data/doc/sisu/html/

  65

The SiSU man pages can be viewed online at:  ⁹ 

  66

An online version of the sisu man page is available here:

  67

  68

  69

  70

  71

  72

4.3 SiSU built-in interactive help

  73

This is particularly useful when current installation information is obtained as the interactive help is able to provide information on your sisu configuration and setup.

  74

sisu --help

  75

sisu --help [subject]

  76

sisu --help env [for feedback on the way your system is setup with regard to sisu]

  77

sisu -V [same as above command]

  78

sisu --help commands

  79

sisu --help markup

  80

Apart from real-time information on your current configuration the SiSU manual and man pages are likely to contain more up-to-date information than the sisu interactive help (for example on commands and markup).

  81

NOTE: Running the command sisu (alone without any flags, filenames or wildcards) brings up the interactive help, as does any sisu command that is not recognised. Enter to escape.

  82

4.4 Help Sources

  83

For lists of alternative help sources, see:

  84

man page

  85

man sisu_help_sources

  86

man2html

  87

/usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html

  88

sisu generated html

  89

/usr/share/doc/sisu/html/sisu_help_sources/index.html

  90

<http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>

  91

<http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>

  92

 ^9. generated from source using rman

<http://polyglotman.sourceforge.net/rman.html>

With regard to SiSU man pages the formatting generated for markup syntax is not quite right, for that you might prefer the links under:

<http://www.jus.uio.no/sample>

 ^10. <http://www.jus.uio.no/sisu/man/>

 ^11. <http://www.jus.uio.no/sisu/man/sisu.1.html>

 ^12. <http://www.jus.uio.no/sisu/man/sisu.8.html>

 ^13. <http://www.jus.uio.no/sisu/man/sisu_examples.1.html>

 ^14. <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html>

Output generated by SiSU 0.59.0 2007-09-23 (2007w38/0)
SiSU Copyright ^© Ralph Amissah 1997, current 2007. All Rights Reserved.
SiSU is software for document structuring, publishing and search,
www.jus.uio.no/sisu and www.sisudoc.org
w3 since October 3 1993 ralph@amissah.com

SiSU using:
Standard SiSU markup syntax,
Standard SiSU meta-markup syntax, and the
Standard SiSU object citation numbering and system, (object/text positioning system)
Copyright ^© Ralph Amissah 1997, current 2007. All Rights Reserved.

SiSU is released under GPLv3 or later, <http://www.gnu.org/licenses/gpl.html>

SiSU, developed using Ruby on Debian/Gnu/Linux software infrastructure, with the usual GPL (or OSS) suspects.
Better - "performance, reliability, scalability, security & total cost of ownership" [not to mention flexibility & choice] use of and adherence to open standards (where practical and fair) and it is software libre.
Get With the Future Way Better!