Title:
	
		SiSU - SiSU information Structuring Universe - Manual [0.58]
	 
	 
	 Creator:
	
		Ralph Amissah
	 
	 
	 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
	 
	 
	 Date created:
	
	 
	 Date issued:
	
	 
	 Date available:
	
	 
	 Date modified:
	
	 
	 Date:
	
		2007-08-30
	 
	 
	
		SiSU - SiSU information Structuring Universe - Manual [0.58], 
Ralph Amissah
	 
	1 
 
	
		SiSU Help
	 
	2 
 
	
		1. Help 
	 
	3 
 
	
		1.1 SiSU Manual
	 
	4 
 
	
		The most up to date information on sisu should be contained in the
sisu_manual, available at:
	 
	5 
 
	
		 < http://www.jus.uio.no/sisu/sisu_manual/>
	 
	6 
 
	
		and (from SiSU  0.59 onwards) installed locally at:
	 
	7 
 
	
		 /usr/share/doc/sisu/sisu_manual/
	 
	8 
 
	
		or equivalent directory
	 
	9 
 
	
		Within the SiSU  tarball at:
	 
	10 
 
	
		 ./data/doc/sisu/sisu_manual/
	 
	11 
 
	
		1.2 SiSU man pages 
	 
	12 
 
	
		If SiSU  is installed on your system usual man commands should be
available, try:
	 
	13 
 
	
		 man sisu
	 
	14 
 
	
		 man sisu_markup
	 
	15 
 
	
		 man sisu_commands
	 
	16 
 
	
		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:
	 
	17 
 
	
		 ./data/doc/sisu/sisu_manual/
	 
	18 
 
	
		Once installed, directory equivalent to:
	 
	19 
 
	
		 /usr/share/doc/sisu/sisu_manual/
	 
	20 
 
	
		Available man pages are converted back to html using man2html:
	 
	21 
 
	
		 /usr/share/doc/sisu/html/
	 
	22 
 
	
		 ./data/doc/sisu/html/
	 
	23 
 
	
		The SiSU  man pages can be viewed online at:1 
	 
	
		1. 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>
	 
	24 
 
	
		An online version of the sisu man page is available here:
	 
	25 
 
	
		  various sisu man pages
 2 
	 
	
		2. < http://www.jus.uio.no/sisu/man/>
	 
	26 
 
	
		  sisu.1 
3 
	 
	
		3. < http://www.jus.uio.no/sisu/man/sisu.1.html>
	 
	27 
 
	
		  sisu.8 
4 
	 
	
		4. < http://www.jus.uio.no/sisu/man/sisu.8.html>
	 
	28 
 
	
		 
sisu_examples.1  5 
	 
	
		5. < http://www.jus.uio.no/sisu/man/sisu_examples.1.html>
	 
	29 
 
	
		 
sisu_webrick.1  6 
	 
	
		6. < http://www.jus.uio.no/sisu/man/sisu_webrick.1.html>
	 
	30 
 
	
		1.3 SiSU built-in interactive help
	 
	31 
 
	
		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.
	 
	32 
 
	
		 sisu --help
	 
	33 
 
	
		 sisu --help [subject]
	 
	34 
 
	
		 sisu --help env [for feedback on the way your system is setup
with regard to sisu]
	 
	35 
 
	
		 sisu -V [same as above command]
	 
	36 
 
	
		 sisu --help commands
	 
	37 
 
	
		 sisu --help markup
	 
	38 
 
	
		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).
	 
	39 
 
	
		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.
	 
	40 
 
	
		1.4 Help Sources
	 
	41 
 
	
		For lists of alternative help sources, see:
	 
	42 
 
	
		man page 
	 
	43 
 
	
		 man sisu_help_sources
	 
	44 
 
	
		man2html 
	 
	45 
 
	
		 /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html
	 
	46 
 
	
		sisu generated html 
	 
	47 
 
	
		 /usr/share/doc/sisu/html/sisu_help_sources/index.html
	 
	48 
 
	
		 < http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
	 
	49 
 
	
		 < http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
	 
	50 
 
	
		Endnotes
	 
	0