<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<?xml-stylesheet type="text/css" href="../_sisu/css/dom.css"?>
<!-- Document processing information:
     * Generated by: SiSU 0.70.0 of 2008w48/3 (2008-12-03)
     * Ruby version: ruby 1.8.7 (2008-08-11 patchlevel 72) [i486-linux]
     * 
     * Last Generated on: Mon Dec 08 15:49:02 -0500 2008
     * SiSU http://www.jus.uio.no/sisu
-->

<document>

<head>

	<header>
		<meta>Title:</meta>
		<title>
			SiSU - Help
		</title>
	</header>

	<header>
		<meta>Creator:</meta>
		<creator>
			Amissah, Ralph
		</creator>
	</header>

	<header>
		<meta>Rights:</meta>
		<rights>
			Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
		</rights>
	</header>

	<header>
		<meta>Type:</meta>
		<type>
			information
		</type>
	</header>

	<header>
		<meta>Subject:</meta>
		<subject>
			ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search
		</subject>
	</header>

	<header>
		<meta>Date created:</meta>
		<date_created>
			2002-08-28
		</date_created>
	</header>

	<header>
		<meta>Date issued:</meta>
		<date_issued>
			2002-08-28
		</date_issued>
	</header>

	<header>
		<meta>Date available:</meta>
		<date_available>
			2002-08-28
		</date_available>
	</header>

	<header>
		<meta>Date modified:</meta>
		<date_modified>
			2007-08-30
		</date_modified>
	</header>

	<header>
		<meta>Date:</meta>
		<date>
			2007-08-30
		</date>
	</header>






</head>

<body>

<heading1>
	<heading>
		<object id="1">
			<ocn>1</ocn>
			<nametag>?</nametag>

			<text>SiSU - Help,<br />Ralph Amissah</text>
		</object>
	</heading>

	<heading2>
		<heading>
			<object id="2">
				<ocn>2</ocn>
				<nametag>?</nametag>

				<text>SiSU Help</text>
			</object>
		</heading>

			<contents1>
				<heading>
					<object id="3">
						<ocn>3</ocn>
						<nametag>help</nametag>

						<text>1. Help</text>
					</object>
				</heading>
					<content>

					</content>

				<contents2>
					<heading>
						<object id="4">
							<ocn>4</ocn>
							<nametag>1.1</nametag>

							<text>1.1 SiSU Manual</text>
						</object>
					</heading>
					<content>

						<object id="5">


							<ocn>5</ocn>


							<text class="norm">The most up to date information on sisu should be contained in the sisu_manual, available at:</text>

						</object>


						<object id="6">


							<ocn>6</ocn>


							<text class="indent1">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://sisudoc.org/sisu/sisu_manual/">http://sisudoc.org/sisu/sisu_manual/</link>&gt;</text>

						</object>


						<object id="7">


							<ocn>7</ocn>


							<text class="norm">The manual can be generated from source, found respectively, either within the <b>SiSU</b> tarball or installed locally at:</text>

						</object>


						<object id="8">


							<ocn>8</ocn>


							<text class="indent1">./data/doc/sisu/sisu_markup_samples/sisu_manual/</text>

						</object>


						<object id="9">


							<ocn>9</ocn>


							<text class="indent1">/usr/share/doc/sisu/sisu_markup_samples/sisu_manual/</text>

						</object>


						<object id="10">


							<ocn>10</ocn>


							<text class="norm">move to the respective directory and type e.g.:</text>

						</object>


						<object id="11">


							<ocn>11</ocn>


							<text class="indent1">sisu sisu_manual.ssm</text>

						</object>


					</content>

				</contents2>

				<contents2>
					<heading>
						<object id="12">
							<ocn>12</ocn>
							<nametag>1.2</nametag>

							<text>1.2 SiSU man pages</text>
						</object>
					</heading>
					<content>

						<object id="13">


							<ocn>13</ocn>


							<text class="norm">If <b>SiSU</b> is installed on your system usual man commands should be available, try:</text>

						</object>


						<object id="14">


							<ocn>14</ocn>


							<text class="indent1">man sisu</text>

						</object>


						<object id="15">


							<ocn>15</ocn>


							<text class="indent1">man sisu_markup</text>

						</object>


						<object id="16">


							<ocn>16</ocn>


							<text class="indent1">man sisu_commands</text>

						</object>


						<object id="17">


							<ocn>17</ocn>


							<text class="norm">Most <b>SiSU</b> 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 <b>SiSU</b> tarball at:</text>

						</object>


						<object id="18">


							<ocn>18</ocn>


							<text class="indent1">./data/doc/sisu/sisu_manual/</text>

						</object>


						<object id="19">


							<ocn>19</ocn>


							<text class="norm">Once installed, directory equivalent to:</text>

						</object>


						<object id="20">


							<ocn>20</ocn>


							<text class="indent1">/usr/share/doc/sisu/sisu_manual/</text>

						</object>


						<object id="21">


							<ocn>21</ocn>


							<text class="norm">Available man pages are converted back to html using man2html:</text>

						</object>


						<object id="22">


							<ocn>22</ocn>


							<text class="indent1">/usr/share/doc/sisu/html/</text>

						</object>


						<object id="23">


							<ocn>23</ocn>


							<text class="indent1">./data/doc/sisu/html/</text>

						</object>


						<object id="24">


							<ocn>24</ocn>


							<text class="norm">An online version of the sisu man page is available here:</text>

						</object>


						<object id="25">


							<ocn>25</ocn>


							<text class="indent_bullet"><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://www.jus.uio.no/sisu/man/">various sisu man pages</link> <endnote><number>1</number><note>&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://www.jus.uio.no/sisu/man/">http://www.jus.uio.no/sisu/man/</link>&gt;</note></endnote></text>

						</object>


						<object id="26">


							<ocn>26</ocn>


							<text class="indent_bullet"><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://www.jus.uio.no/sisu/man/sisu.1.html">sisu.1</link> <endnote><number>2</number><note>&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://www.jus.uio.no/sisu/man/sisu.1.html">http://www.jus.uio.no/sisu/man/sisu.1.html</link>&gt;</note></endnote></text>

						</object>


					</content>

				</contents2>

				<contents2>
					<heading>
						<object id="27">
							<ocn>27</ocn>
							<nametag>1.3</nametag>

							<text>1.3 SiSU built-in interactive help</text>
						</object>
					</heading>
					<content>

						<object id="28">


							<ocn>28</ocn>


							<text class="norm">This is particularly useful for getting the current sisu setup/environment information:</text>

						</object>


						<object id="29">


							<ocn>29</ocn>


							<text class="indent1">sisu --help</text>

						</object>


						<object id="30">


							<ocn>30</ocn>


							<text class="indent1">sisu --help [subject]</text>

						</object>


						<object id="31">


							<ocn>31</ocn>


							<text class="indent2">sisu --help commands</text>

						</object>


						<object id="32">


							<ocn>32</ocn>


							<text class="indent2">sisu --help markup</text>

						</object>


						<object id="33">


							<ocn>33</ocn>


							<text class="indent2">sisu --help env [for feedback on the way your system is setup with regard to sisu]</text>

						</object>


						<object id="34">


							<ocn>34</ocn>


							<text class="indent1">sisu -V [environment information, same as above command]</text>

						</object>


						<object id="35">


							<ocn>35</ocn>


							<text class="indent1">sisu (on its own provides version and some help information)</text>

						</object>


						<object id="36">


							<ocn>36</ocn>


							<text class="norm">Apart from real-time information on your current configuration the <b>SiSU</b> manual and man pages are likely to contain more up-to-date information than the sisu interactive help (for example on commands and markup).</text>

						</object>


						<object id="37">


							<ocn>37</ocn>


							<text class="norm">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.</text>

						</object>


					</content>

				</contents2>

				<contents2>
					<heading>
						<object id="38">
							<ocn>38</ocn>
							<nametag>1.4</nametag>

							<text>1.4 Help Sources</text>
						</object>
					</heading>
					<content>

						<object id="39">


							<ocn>39</ocn>


							<text class="norm">For lists of alternative help sources, see:</text>

						</object>


						<object id="40">


							<ocn>40</ocn>


							<text class="norm"><b>man page</b></text>

						</object>


						<object id="41">


							<ocn>41</ocn>


							<text class="indent1">man sisu_help_sources</text>

						</object>


						<object id="42">


							<ocn>42</ocn>


							<text class="norm"><b>man2html</b></text>

						</object>


						<object id="43">


							<ocn>43</ocn>


							<text class="indent1">/usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html</text>

						</object>


						<object id="44">


							<ocn>44</ocn>


							<text class="norm"><b>sisu generated html</b></text>

						</object>


						<object id="45">


							<ocn>45</ocn>


							<text class="indent1">/usr/share/doc/sisu/html/sisu_help_sources/index.html</text>

						</object>


						<object id="46">


							<ocn>46</ocn>


							<text class="indent1">&lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://sisudoc.org/sisu/sisu_help_sources/index.html">http://sisudoc.org/sisu/sisu_help_sources/index.html</link>&gt;</text>

						</object>


					</content>

			</contents2>

			</contents1>

			<contents1>
				<heading>
					<object id="0">
						<ocn>0</ocn>
						<nametag>endnotes</nametag>

						<text>Endnotes</text>
					</object>
				</heading>
					<content>

					</content>

</contents1>

	</heading2>

</heading1>

<heading1>
	<heading>
		<object id="0">
			<ocn>0</ocn>
			<nametag>meta</nametag>

			<text>Document Information (metadata)</text>
		</object>
	</heading>

			<contents1>
				<heading>
					<object id="0">
						<ocn>0</ocn>
						<nametag>metadata</nametag>

						<text>Metadata</text>
					</object>
				</heading>
					<content>

						<object id="0">


							<ocn>0</ocn>


							<text class="norm"> &lt;<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" xlink:href="http://www.sisudoc.org/sisu/sisu_help/sisu_manifest.html">http://www.sisudoc.org/sisu/sisu_help/sisu_manifest.html</link>&gt;</text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm"><b>Dublin Core</b> (DC)</text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm"><i>DC tags included with this document are provided here.</i></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">DC Title: <u>SiSU - Help</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">DC Creator: <u>Ralph Amissah</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">DC Rights: <u>Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">DC Type: <u>information</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">DC Date created: <u>2002-08-28</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">DC Date issued: <u>2002-08-28</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">DC Date available: <u>2002-08-28</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">DC Date modified: <u>2007-08-30</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">DC Date: <u>2007-08-30</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm"><b>Version Information</b></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">Sourcefile: <u>sisu_help.sst</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">Filetype: <u>SiSU text 0.58</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">Sourcefile Digest, MD5(sisu_help.sst)= <u>d787510a545fae2e2e655d51616ecbe8</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">Skin_Digest: MD5(skin_sisu_manual.rb)= <u>072b2584bedea82ea8a416587b9fa244</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm"><b>Generated</b></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">Document (metaverse) last generated: <u>Mon Dec 08 15:49:01 -0500 2008</u></text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">Generated by: <u>SiSU</u> <u>0.70.0</u> of 2008w48/3 (2008-12-03)</text>

						</object>


						<object id="0">


							<ocn>0</ocn>


							<text class="norm">Ruby version: <u> ruby 1.8.7 (2008-08-11 patchlevel 72) [i486-linux]</u></text>

						</object>


					</content>
			</contents1>

</heading1>

</body>

</document>


