removal of auto-generated manpages

6 files changed, 0 insertions, 3744 deletions

diff --git a/man/man1/sisu_commands.1 b/man/man1/sisu_commands.1
deleted file mode 100644
index ca60efc6..00000000
--- a/man/man1/sisu_commands.1
+++ /dev/null
@@ -1,575 +0,0 @@
-.TH "sisu_commands" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- COMMANDS,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU COMMANDS
-.BR
-
-.SH
-1. COMMANDS SUMMARY
-.BR
-
-.SH
-1.1 SYNOPSIS
-
-.BR
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system
-
-.BR
-sisu \ [ \ \-abcDdFHhIiMmNnopqRrSsTtUuVvwXxYyZz0\-9 \ ] \ [ \ filename/ \
-wildcard \ ]
-
-.BR
-sisu \ [ \ \-Ddcv \ ] \ [ \ instruction \ ]
-
-.BR
-sisu \ [ \ \-CcFLSVvW \ ]
-
-.BR
-Note: commands should be issued from within the directory that contains the
-marked up files, cd to markup directory.
-
-.SH
-1.2 DESCRIPTION
-
-.BR
-.B SiSU
-.B SiSU
-is a document publishing system, that from a simple single marked\-up
-document, produces multiple of output formats including: plaintext, html,
-LaTeX, pdf, xhtml, XML, info, and SQL (PostgreSQL and SQLite), which share
-numbered text objects (\"object citation numbering\") and the same document
-structure information. For more see: <http://www.jus.uio.no/sisu>
-
-.SH
-1.3 DOCUMENT PROCESSING COMMAND FLAGS
-
-.TP
-.B \ \-a \ \ [filename/wildcard]
-produces plaintext with Unix linefeeds and without markup, (object numbers
-are omitted), has footnotes at end of each paragraph that contains them \ [ \
-\-A \ for \ equivalent \ dos \ (linefeed) \ output \ file] \ [see \ \-e \ for \
-endnotes]. (Options include: \-\-endnotes for endnotes \-\-footnotes for
-footnotes at the end of each paragraph \-\-unix for unix linefeed (default)
-\-\-msdos for msdos linefeed)
-
-.TP
-.B \ \-b \ \ [filename/wildcard]
-produces xhtml/XML output for browser viewing (sax parsing).
-
-.TP
-.B \ \-C \ \ [\-\-init\-site]
-configure/initialise shared output directory files initialize shared output
-directory (config files such as css and dtd files are not updated if they
-already exist unless modifier is used). \-C \-\-init\-site configure/initialise
-site more extensive than \-C on its own, shared output directory files/force
-update, existing shared output config files such as css and dtd files are
-updated if this modifier is used.
-
-.TP
-.B \ \-CC
-\ configure/initialise \ shared \ output \ directory \ files \ initialize \
-shared \ output \ directory \ (config \ files \ such \ as \ css \ and \ dtd \
-files \ are \ not \ updated \ if \ they \ already \ exist \ unless \ modifier \
-is \ used). \ The \ equivalent \ of: \ \-C \ \-\-init\-site \
-configure/initialise \ site, \ more \ extensive \ than \ \-C \ on \ its \ own,
-\ shared \ output \ directory \ files/force \ update, \ existing \ shared \
-output \ config \ files \ such \ as \ css \ and \ dtd \ files \ are \ updated \
-if \ \-CC \ is \ used. \
-
-.TP
-.B \ \-c \ \ [filename/wildcard]
-screen toggle ansi screen colour on or off depending on default set (unless
-\-c flag is used: if sisurc colour default is set to \'true\', output to screen
-will be with colour, if sisurc colour default is set to \'false\' or is
-undefined screen output will be without colour).
-
-.TP
-.B \ \-D \ \ [instruction] \ [filename]
-database postgresql ( \-\-pgsql may be used instead) possible instructions,
-include: \-\-createdb; \-\-create; \-\-dropall; \-\-import \ [filename];
-\-\-update \ [filename]; \-\-remove \ [filename]; see database section below.
-
-.TP
-.B \ \-d \ \ [\-\-db\-[database \ type \ (sqlite|pg)]] \-\-[instruction] \
-[filename]
-database type default set to sqlite, (for which \-\-sqlite may be used
-instead) or to specify another database \-\-db\-[pgsql, \ sqlite] (however see
-\-D) possible instructions include: \-\-createdb; \-\-create; \-\-dropall;
-\-\-import \ [filename]; \-\-update \ [filename]; \-\-remove \ [filename]; see
-database section below.
-
-.TP
-.B \ \-F \ \ [\-\-webserv=webrick]
-generate examples of (naive) cgi search form for sqlite and pgsql depends on
-your already having used sisu to populate an sqlite and/or pgsql database, (the
-sqlite version scans the output directories for existing sisu_sqlite databases,
-so it is first necessary to create them, before generating the search form) see
-\-d \-D and the database section below. If the optional parameter
-\-\-webserv=webrick is passed, the cgi examples created will be set up to use
-the default port set for use by the webrick server, (otherwise the port is left
-blank and the system setting used, usually 80). The samples are dumped in the
-present work directory which must be writable, (with screen instructions given
-that they be copied to the cgi\-bin directory). \-Fv (in addition to the above)
-provides some information on setting up hyperestraier for sisu
-
-.TP
-.B \ \-H \ \ [filename/wildcard]
-produces html without link suffixes (.html \.pdf etc.) (\"Hide\"). Requires
-an appropriately configured web server. \ [behaviour \ switched \ after \ 0.35
-\ see \ \-h].
-
-.TP
-.B \ \-h \ \ [filename/wildcard]
-produces html (with hardlinks i.e. with name suffixes in links/local urls).
-html, with internal document links that include the document suffix, i.e.
-whether it is \.html or \.pdf (required for browsing directly off a file
-system, and works with most web servers). \ [behaviour \ switched \ after \
-0.35 \ see \ \-H].
-
-.TP
-.B \ \-I \ \ [filename/wildcard]
-produces texinfo and info file, (view with pinfo).
-
-.TP
-.B \ \-L
-\ prints \ license \ information. \
-
-.TP
-.B \ \-M \ \ [filename/wildcard/url]
-maintenance mode files created for processing preserved and their locations
-indicated. (also see \-V)
-
-.TP
-.B \ \-m \ \ [filename/wildcard/url]
-assumed for most other flags, creates new meta\-markup file, (the metaverse )
-that is used in all subsequent processing of other output. This step is assumed
-for most processing flags. To skip it see \-n
-
-.TP
-.B \ \-N \ \ [filename/wildcard/url]
-document digest or document content certificate ( DCC ) as md5 digest tree of
-the document: the digest for the document, and digests for each object
-contained within the document (together with information on software versions
-that produced it) (digest.txt). \-NV for verbose digest output to screen.
-
-.TP
-.B \ \-n \ \ [filename/wildcard/url]
-skip meta\-markup (building of \"metaverse\"), this skips the equivalent of
-\-m which is otherwise assumed by most processing flags.
-
-.TP
-.B \ \-o \ \ [filename/wildcard/url]
-output basic document in opendocument file format (opendocument.odt).
-
-.TP
-.B \ \-p \ \ [filename/wildcard]
-produces LaTeX pdf (portrait.pdf & landscape.pdf). Default paper size is set
-in config file, or document header, or provided with additional command line
-parameter, e.g. \-\-papersize\-a4 preset sizes include: \'A4\', U.S. \'letter\'
-and \'legal\' and book sizes \'A5\' and \'B5\' (system defaults to A4).
-
-.TP
-.B \ \-q \ \ [filename/wildcard]
-quiet less output to screen.
-
-.TP
-.B \ \-R \ \ [filename/wildcard]
-copies sisu output files to remote host using rsync. This requires that
-sisurc.yml has been provided with information on hostname and username, and
-that you have your \"keys\" and ssh agent in place. Note the behavior of rsync
-different if \-R is used with other flags from if used alone. Alone the rsync
-\-\-delete parameter is sent, useful for cleaning the remote directory (when
-\-R is used together with other flags, it is not). Also see \-r
-
-.TP
-.B \ \-r \ \ [filename/wildcard]
-copies sisu output files to remote host using scp. This requires that
-sisurc.yml has been provided with information on hostname and username, and
-that you have your \"keys\" and ssh agent in place. Also see \-R
-
-.TP
-.B \ \-S
-\ produces \ a \ sisupod \ a \ zipped \ sisu \ directory \ of \ markup \
-files \ including \ sisu \ markup \ source \ files \ and \ the \ directories \
-local \ configuration \ file, \ images \ and \ skins. \ Note: \ this \ only \
-includes \ the \ configuration \ files \ or \ skins \ contained \ in \ \./_sisu
-\ not \ those \ in \ ~/.sisu \ \-S \ \ [filename/wildcard] option. Note: (this
-option is tested only with zsh).
-
-.TP
-.B \ \-S \ \ [filename/wildcard]
-produces a zipped file of the prepared document specified along with
-associated images, by default named sisupod.zip they may alternatively be named
-with the filename extension \.ssp This provides a quick way of gathering the
-relevant parts of a sisu document which can then for example be emailed. A
-sisupod includes sisu markup source file, (along with associated documents if a
-master file, or available in multilingual versions), together with related
-images and skin.
-.B SiSU
-commands can be run directly against a sisupod contained in a local
-directory, or provided as a url on a remote site. As there is a security issue
-with skins provided by other users, they are not applied unless the flag
-\-\-trust or \-\-trusted is added to the command instruction, it is recommended
-that file that are not your own are treated as untrusted. The directory
-structure of the unzipped file is understood by sisu, and sisu commands can be
-run within it. Note: if you wish to send multiple files, it quickly becomes
-more space efficient to zip the sisu markup directory, rather than the
-individual files for sending). See the \-S option without \
-[filename/wildcard].
-
-.TP
-.B \ \-s \ \ [filename/wildcard]
-copies sisu markup file to output directory.
-
-.TP
-.B \ \-t \ \ [filename/wildcard \ (*.termsheet.rb)]
-standard form document builder, preprocessing feature
-
-.TP
-.B \ \-U \ \ [filename/wildcard]
-prints url output list/map for the available processing flags options and
-resulting files that could be requested, (can be used to get a list of
-processing options in relation to a file, together with information on the
-output that would be produced), \-u provides url output mapping for those flags
-requested for processing. The default assumes sisu_webrick is running and
-provides webrick url mappings where appropriate, but these can be switched to
-file system paths in sisurc.yml
-
-.TP
-.B \ \-u \ \ [filename/wildcard]
-provides url mapping of output files for the flags requested for processing,
-also see \-U
-
-.TP
-.B \ \-V
-\ on \ its \ own, \ provides
-.B \ SiSU
-\ version \ and \ environment \ information \ (sisu \ \-\-help \ env) \
-
-.TP
-.B \ \-V \ \ [filename/wildcard]
-even more verbose than the \-v flag. (also see \-M)
-
-.TP
-.B \ \-v
-\ on \ its \ own, \ provides
-.B \ SiSU
-\ version \ information \
-
-.TP
-.B \ \-v \ \ [filename/wildcard]
-provides verbose output of what is being built, where it is being built (and
-error messages if any), as with \-u flag provides a url mapping of files
-created for each of the processing flag requests. See also \-V
-
-.TP
-.B \ \-W
-\ starts \ ruby\'s \ webrick \ webserver \ points \ at \ sisu \ output \
-directories, \ the \ default \ port \ is \ set \ to \ 8081 \ and \ can \ be \
-changed \ in \ the \ resource \ configuration \ files. \ \ [tip: \ the \
-webrick \ server \ requires \ link \ suffixes, \ so \ html \ output \ should \
-be \ created \ using \ the \ \-h \ option \ rather \ than \ \-H; \ also, \ note
-\ \-F \ webrick \ ].
-
-.TP
-.B \ \-w \ \ [filename/wildcard]
-produces concordance (wordmap) a rudimentary index of all the words in a
-document. (Concordance files are not generated for documents of over 260,000
-words unless this limit is increased in the file sisurc.yml)
-
-.TP
-.B \ \-X \ \ [filename/wildcard]
-produces XML output with deep document structure, in the nature of dom.
-
-.TP
-.B \ \-x \ \ [filename/wildcard]
-produces XML output shallow structure (sax parsing).
-
-.TP
-.B \ \-Y \ \ [filename/wildcard]
-produces a short sitemap entry for the document, based on html output and the
-sisu_manifest. \-\-sitemaps generates/updates the sitemap index of existing
-sitemaps. (Experimental, \ [g,y,m \ announcement \ this \ week])
-
-.TP
-.B \ \-y \ \ [filename/wildcard]
-produces an html summary of output generated (hyperlinked to content) and
-document specific metadata (sisu_manifest.html). This step is assumed for most
-processing flags.
-
-.TP
-.B \ \-Z \ \ [filename/wildcard]
-Zap, if used with other processing flags deletes output files of the type
-about to be processed, prior to processing. If \-Z is used as the lone
-processing related flag (or in conjunction with a combination of \-[mMvVq]),
-will remove the related document output directory.
-
-.TP
-.B \ \-z \ \ [filename/wildcard]
-produces php (zend) \ [this \ feature \ is \ disabled \ for \ the \ time \
-being]
-
-.SH
-2. COMMAND LINE MODIFIERS
-.BR
-
-.TP
-.B \ \-\-no\-ocn
-\ \ [with \ \-h \ \-H \ or \ \-p] switches off object citation numbering.
-Produce output without identifying numbers in margins of html or LaTeX/pdf
-output.
-
-.TP
-.B \ \-\-no\-annotate
-\ strips \ output \ text \ of \ editor \ endnotes[^*1] denoted by asterisk or
-dagger/plus sign
-
-.TP
-.B \ \-\-no\-asterisk
-\ strips \ output \ text \ of \ editor \ endnotes[^*2] denoted by asterisk
-sign
-
-.TP
-.B \ \-\-no\-dagger
-\ strips \ output \ text \ of \ editor \ endnotes[^+1] denoted by dagger/plus
-sign
-
-.SH
-3. DATABASE COMMANDS
-.BR
-
-.BR
-dbi \- database interface
-
-.BR
-\-D or \-\-pgsql set for postgresql \-d or \-\-sqlite default set for sqlite
-\-d is modifiable with \-\-db=[database \ type \ (pgsql \ or \ sqlite)]
-
-.TP
-.B \ \-Dv \ \-\-createall
-\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in
-\ existing \ postgresql \ database \ (a \ database \ should \ be \ created \
-manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \
-requested) \ (rb.dbi) \ \ [ \ \-dv \ \-\-createall \ sqlite \ equivalent] it
-may be necessary to run sisu \-Dv \-\-createdb initially NOTE: at the present
-time for postgresql it may be necessary to manually create the database. The
-command would be \'createdb \ [database \ name]\' where database name would be
-SiSU_[present \ working \ directory \ name \ (without \ path)]. Please use only
-alphanumerics and underscores.
-
-.TP
-.B \ \-Dv \ \-\-import
-\ \ [filename/wildcard] imports data specified to postgresql db (rb.dbi) \ [
-\ \-dv \ \-\-import \ sqlite \ equivalent]
-
-.TP
-.B \ \-Dv \ \-\-update
-\ \ [filename/wildcard] updates/imports specified data to postgresql db
-(rb.dbi) \ [ \ \-dv \ \-\-update \ sqlite \ equivalent]
-
-.TP
-.B \ \-D \ \-\-remove
-\ \ [filename/wildcard] removes specified data to postgresql db (rb.dbi) \ [
-\ \-d \ \-\-remove \ sqlite \ equivalent]
-
-.TP
-.B \ \-D \ \-\-dropall
-\ kills \ data\" \ and \ drops \ (postgresql \ or \ sqlite) \ db, \ tables \
-& \ indexes \ \ [ \ \-d \ \-\-dropall \ sqlite \ equivalent]
-
-.BR
-The v in e.g. \-Dv is for verbose output.
-
-.SH
-4. SHORTCUTS, SHORTHAND FOR MULTIPLE FLAGS
-.BR
-
-.TP
-.B \ \-\-update \ \ [filename/wildcard]
-Checks existing file output and runs the flags required to update this
-output. This means that if only html and pdf output was requested on previous
-runs, only the \-hp files will be applied, and only these will be generated
-this time, together with the summary. This can be very convenient, if you offer
-different outputs of different files, and just want to do the same again.
-
-.TP
-.B \ \-0 \ to \ \-5 \ \ [filename \ or \ wildcard]
-Default shorthand mappings (note that the defaults can be changed/configured
-in the sisurc.yml file):
-
-.TP
-.B \ \-0
-\ \-mNhwpAobxXyYv \ \ [this \ is \ the \ default \ action \ run \ when \ no \
-options \ are \ give, \ i.e. \ on \ \'sisu \ \ [filename]\']
-
-.TP
-.B \ \-1
-\ \-mNHwpy \
-
-.TP
-.B \ \-2
-\ \-mNHwpaoy \
-
-.TP
-.B \ \-3
-\ \-mNhwpAobxXyY \
-
-.TP
-.B \ \-4
-\ \-mNhwpAobxXDyY \ \-\-import \
-
-.TP
-.B \ \-5
-\ \-mNhwpAobxXDyY \ \-\-update \
-
-.BR
-add \-v for verbose mode and \-c for color, e.g. sisu \-2vc \ [filename \ or \
-wildcard]
-
-.BR
-consider \-u for appended url info or \-v for verbose output
-
-.SH
-4.0.1 COMMAND LINE WITH FLAGS \- BATCH PROCESSING
-
-.BR
-In the data directory run sisu \-mh filename or wildcard eg. \"sisu \-h
-cisg.sst\" or \"sisu \-h *.{sst,ssm}\" to produce html version of all
-documents.
-
-.BR
-Running 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.
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Commands
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_commands.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_commands.sst)=
-.I 68a4087f984baffbea779da25e1b6141
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:43 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI *1.
-square brackets
-.TP
-.BI *2.
-square brackets
-.TP
-.BI +1.
-square brackets
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_commands/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_commands/sisu_commands.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_configuration.1 b/man/man1/sisu_configuration.1
deleted file mode 100644
index 98c8c8c0..00000000
--- a/man/man1/sisu_configuration.1
+++ /dev/null
@@ -1,368 +0,0 @@
-.TH "sisu_configuration" "1" "2007-08-30" "0.59.1" "SiSU"
-.SH
-SISU \- CONFIGURATION,
-RALPH AMISSAH
-.BR
-
-.SH
-CONFIGURATION OF ENVIRONMENT
-.BR
-
-.SH
-1. CONFIGURATION
-.BR
-
-.SH
-1.1 DETERMINING THE CURRENT CONFIGURATION
-
-.BR
-Information on the current configuration of
-.B SiSU
-should be available with the help command:
-
-.BR
-  sisu \-v
-
-.BR
-which is an alias for:
-
-.BR
-  sisu \-\-help env
-
-.BR
-Either of these should be executed from within a directory that contains sisu
-markup source documents.
-
-.SH
-1.2 CONFIGURATION FILES (CONFIG.YML)
-
-.BR
-.B SiSU
-configration parameters are adjusted in the configuration file, which can be
-used to override the defaults set. This includes such things as which directory
-interim processing should be done in and where the generated output should be
-placed.
-
-.BR
-The
-.B SiSU
-configuration file is a yaml file, which means indentation is significant.
-
-.BR
-.B SiSU
-resource configuration is determined by looking at the following files if
-they exist:
-
-.BR
-  \./_sisu/sisurc.yml
-
-.BR
-  ~/.sisu/sisurc.yml
-
-.BR
-  /etc/sisu/sisurc.yml
-
-.BR
-The search is in the order listed, and the first one found is used.
-
-.BR
-In the absence of instructions in any of these it falls back to the internal
-program defaults.
-
-.BR
-Configuration determines the output and processing directories and the database
-access details.
-
-.BR
-If
-.B SiSU
-is installed a sample sisurc.yml may be found in /etc/sisu/sisurc.yml
-
-.SH
-CONFIGURATION OF DOCUMENTS
-.BR
-
-.SH
-2. SKINS
-.BR
-
-.BR
-Skins modify the default appearance of document output on a document,
-directory, or site wide basis. Skins are looked for in the following locations:
-
-.BR
-  \./_sisu/skin
-
-.BR
-  ~/.sisu/skin
-
-.BR
-  /etc/sisu/skin
-
-.BR
-.B Within the skin directory
-are the following the default sub\-directories for document skins:
-
-.BR
-  \./skin/doc
-
-.BR
-  \./skin/dir
-
-.BR
-  \./skin/site
-
-.BR
-A skin is placed in the appropriate directory and the file named skin_[name].rb
-
-.BR
-The skin itself is a ruby file which modifies the default appearances set in
-the program.
-
-.SH
-2.1 DOCUMENT SKIN
-
-.BR
-Documents take on a document skin, if the header of the document specifies a
-skin to be used.
-
-
-.nf
-  @skin: skin_united_nations
-.fi
-
-.SH
-2.2 DIRECTORY SKIN
-
-.BR
-A directory may be mapped on to a particular skin, so all documents within that
-directory take on a particular appearance. If a skin exists in the skin/dir
-with the same name as the document directory, it will automatically be used for
-each of the documents in that directory, (except where a document specifies the
-use of another skin, in the skin/doc directory).
-
-.BR
-A personal habit is to place all skins within the doc directory, and symbolic
-links as needed from the site, or dir directories as required.
-
-.SH
-2.3 SITE SKIN
-
-.BR
-A site skin, modifies the program default skin.
-
-.SH
-2.4 SAMPLE SKINS
-
-.BR
-With
-.B SiSU
-installed sample skins may be found in:
-
-.BR
-  /etc/sisu/skin/doc and
-  /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc
-
-.BR
-(or equivalent directory) and if sisu\-markup\-samples is installed also under:
-
-.BR
-  /usr/share/doc/sisu/sisu_markup_samples/non\-free/_sisu/skin/doc
-
-.BR
-Samples of list.yml and promo.yml (which are used to create the right column
-list) may be found in:
-
-.BR
-  /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent
-  directory)
-
-.SH
-3. HOMEPAGES
-.BR
-
-.BR
-.B SiSU
-is about the ability to auto\-generate documents. Home pages are regarded as
-custom built items, and are not created by
-.B SiSU
-. More accurately,
-.B SiSU
-has a default home page, which will not be appropriate for use with other
-sites, and the means to provide your own home page instead in one of two ways
-as part of a site\'s configuration, these being:
-
-.BR
-1. through placing your home page and other custom built documents in the
-subdirectory _sisu/home/ (this probably being the easier and more convenient
-option)
-
-.BR
-2. through providing what you want as the home page in a skin,
-
-.BR
-Document sets are contained in directories, usually organised by site or
-subject. Each directory can/should have its own homepage. See the section on
-directory structure and organisation of content.
-
-.SH
-3.1 HOME PAGE AND OTHER CUSTOM BUILT PAGES IN A SUB\-DIRECTORY
-
-.BR
-Custom built pages, including the home page index.html may be placed within the
-configuration directory _sisu/home/ in any of the locations that is searched
-for the configuration directory, namely \./_sisu; ~/_sisu; /etc/sisu From there
-they are copied to the root of the output directory with the command:
-
-.BR
-  sisu \-CC
-
-.SH
-3.2 HOME PAGE WITHIN A SKIN
-
-.BR
-Skins are described in a separate section, but basically are a file written in
-the programming language
-.B Ruby
-that may be provided to change the defaults that are provided with sisu with
-respect to individual documents, a directories contents or for a site.
-
-.BR
-If you wish to provide a homepage within a skin the skin should be in the
-directory _sisu/skin/dir and have the name of the directory for which it is to
-become the home page. Documents in the directory commercial_law would have the
-homepage modified in skin_commercial law.rb; or the directory poems in
-skin_poems.rb
-
-
-.nf
-    class Home
-      def homepage
-        # place the html content of your homepage here, this will become index.html
-        <<HOME <html>
-  <head></head>
-  <doc>
-  <p>this is my new homepage.</p>
-  </doc>
-  </html>
-  HOME
-      end
-    end
-.fi
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Configuration
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Ralph Amissah
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2007\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-08\-30
-
-.BR
-DC Date:
-.I 2007\-08\-30
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_configuration._sst
-
-.BR
-Filetype:
-.I SiSU text insert 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_configuration._sst)=
-.I 491d3da039162d60ae0e2951aa260915
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:46 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_configuration/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_configuration/sisu_configuration.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:51 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_help.1 b/man/man1/sisu_help.1
deleted file mode 100644
index 95331031..00000000
--- a/man/man1/sisu_help.1
+++ /dev/null
@@ -1,318 +0,0 @@
-.TH "sisu_help" "1" "2007-08-30" "0.59.1" "SiSU"
-.SH
-SISU \- HELP,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU HELP
-.BR
-
-.SH
-1. HELP
-.BR
-
-.SH
-1.1 SISU MANUAL
-
-.BR
-The most up to date information on sisu should be contained in the sisu_manual,
-available at:
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/>
-
-.BR
-and (from
-.B SiSU
-0.59 onwards) installed locally at:
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/
-
-.BR
-or equivalent directory
-
-.BR
-Within the
-.B SiSU
-tarball at:
-
-.BR
-  \./data/doc/sisu/sisu_manual/
-
-.SH
-1.2 SISU MAN PAGES
-
-.BR
-If
-.B SiSU
-is installed on your system usual man commands should be available, try:
-
-.BR
-  man sisu
-
-.BR
-  man sisu_markup
-
-.BR
-  man sisu_commands
-
-.BR
-Most
-.B 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
-.B SiSU
-tarball at:
-
-.BR
-  \./data/doc/sisu/sisu_manual/
-
-.BR
-Once installed, directory equivalent to:
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/
-
-.BR
-Available man pages are converted back to html using man2html:
-
-.BR
-  /usr/share/doc/sisu/html/
-
-.BR
-  \./data/doc/sisu/html/
-
-.BR
-The
-.B SiSU
-man pages can be viewed online at:[^1]
-
-.BR
-An online version of the sisu man page is available here:
-
-.BR
-* various sisu man pages <http://www.jus.uio.no/sisu/man/> \ [^2]
-
-.BR
-* sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1.html> \ [^3]
-
-.BR
-* sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8.html> \ [^4]
-
-.BR
-* sisu_examples.1 <http://www.jus.uio.no/sisu/man/sisu_examples.1.html> \ [^5]
-
-.BR
-* sisu_webrick.1 <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> \ [^6]
-
-.SH
-1.3 SISU BUILT\-IN INTERACTIVE HELP
-
-.BR
-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.
-
-.BR
-  sisu \-\-help
-
-.BR
-  sisu \-\-help \ [subject]
-
-.BR
-    sisu \-\-help env \ [for \ feedback \ on \ the \ way \ your \ system \ is \
-    setup \ with \ regard \ to \ sisu]
-
-.BR
-    sisu \-V \ [same \ as \ above \ command]
-
-.BR
-    sisu \-\-help commands
-
-.BR
-    sisu \-\-help markup
-
-.BR
-Apart from real\-time information on your current configuration the
-.B 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).
-
-.BR
-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.
-
-.SH
-1.4 HELP SOURCES
-
-.BR
-For lists of alternative help sources, see:
-
-.BR
-.B man page
-
-.BR
-  man sisu_help_sources
-
-.BR
-.B man2html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html
-
-.BR
-.B sisu generated html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_help_sources/index.html
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_help/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Help
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-08\-30
-
-.BR
-DC Date:
-.I 2007\-08\-30
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_help.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_help.sst)=
-.I 66d04ba5f3dd4ede774ffa5549b3faba
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:42 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-generated from source using rman
- <http://polyglotman.sourceforge.net/rman.html>
- With regard to
-.B 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>
-.TP
-.BI 2.
-<http://www.jus.uio.no/sisu/man/>
-.TP
-.BI 3.
-<http://www.jus.uio.no/sisu/man/sisu.1.html>
-.TP
-.BI 4.
-<http://www.jus.uio.no/sisu/man/sisu.8.html>
-.TP
-.BI 5.
-<http://www.jus.uio.no/sisu/man/sisu_examples.1.html>
-.TP
-.BI 6.
-<http://www.jus.uio.no/sisu/man/sisu_webrick.1.html>
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_help/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_help/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_help/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_help/sisu_help.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_help_sources.1 b/man/man1/sisu_help_sources.1
deleted file mode 100644
index 2b907a23..00000000
--- a/man/man1/sisu_help_sources.1
+++ /dev/null
@@ -1,729 +0,0 @@
-.TH "sisu_help_sources" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- REFERENCES,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU HELP SOURCES
-.BR
-
-.SH
-1. HELP SOURCES
-.BR
-
-.BR
-For a summary of alternative ways to get help on
-.B SiSU
-try one of the following:
-
-.BR
-.B man page
-
-.BR
-  man sisu_help
-
-.BR
-.B man2html
-
-.BR
-  <file:///usr/share/doc/sisu/html/sisu_help.1.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_help.1.html>
-
-.BR
-.B sisu generated output \- links to html
-
-.BR
-  <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_help/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
-.B help sources lists
-
-.BR
-Alternative sources for this help sources page listed here:
-
-.BR
-  man sisu_help_sources
-
-.BR
-  <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  <file:///usr/share/doc/sisu/html/sisu_help_sources/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.SH
-1.1 MAN PAGES
-
-.SH
-1.1.1 MAN
-
-.BR
-  man sisu
-
-.BR
-  man sisu_commands
-
-.BR
-  man 7 sisu_complete
-
-.BR
-  man sisu_configuration
-
-.BR
-  man 8 sisu_faq
-
-.BR
-  man sisu_filetypes
-
-.BR
-  man sisu_help
-
-.BR
-  man sisu_help_sources
-
-.BR
-  man 8 sisu_howto
-
-.BR
-  man sisu_introduction
-
-.BR
-  man sisu_markup
-
-.BR
-  man sisu_output_overview
-
-.BR
-  man 7 sisu_pdf
-
-.BR
-  man 7 sisu_postgresql
-
-.BR
-  man 8 sisu_quickstart
-
-.BR
-  man 8 sisu_remote
-
-.BR
-  man 8 sisu_search
-
-.BR
-  man sisu_skin
-
-.BR
-  man 7 sisu_sqlite
-
-.BR
-  man 8 sisu_syntax_highlighting
-
-.BR
-  man 7 sisu_vim
-
-.BR
-  man sisu_webrick
-
-.SH
-1.2 SISU GENERATED OUTPUT \- LINKS TO HTML
-
-.BR
-Note
-.B SiSU
-documentation is prepared in
-.B SiSU
-and output is available in multiple formats including amongst others html,
-pdf, and odf which may be also be accessed via the html pages[^1]
-
-.SH
-1.2.1 LOCALLY INSTALLED
-
-.BR
-<file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html>
-
-.BR
-<file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
-<file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_commands/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_description/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_help/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_output_overview/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_quickstart/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_search/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html
-
-.BR
-  /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html
-
-.SH
-1.2.2 WWW.SISUDOC.ORG
-
-.BR
-<http://sisudoc.org/sisu_manual/sisu_manual/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_commands/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_complete/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_configuration/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_description/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_examples/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_faq/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_filetypes/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_help/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_howto/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_introduction/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_manual/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_markup/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_output_overview/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_pdf/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_postgresql/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_quickstart/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_remote/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_search/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_skin/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_sqlite/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_vim/index.html>
-
-.BR
-  <http://sisudoc.org/sisu_manual/sisu_webrick/index.html>
-
-.SH
-1.2.3 WWW.JUS.UIO.NO/SISU
-
-.BR
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html>
-
-.SH
-1.2.4 MAN2HTML
-
-.SH
-1.2.5 LOCALLY INSTALLED
-
-.BR
-<file:///usr/share/doc/sisu/html/sisu_manual.1.html>
-
-.BR
-<file:///usr/share/doc/sisu/html/sisu_help.1.html>
-
-.BR
-<file:///usr/share/doc/sisu/html/sisu_help_sources.1.html>
-
-.BR
-  /usr/share/doc/sisu/html/sisu.1.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_commands.1.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_complete.7.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_configuration.1.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_faq.8.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_help.1.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_help_sources.1.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_howto.8.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_markup.1.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_pdf.7.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_postgresql.7.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_quickstart.8.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_remote.8.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_search.8.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_skin.1.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_sqlite.7.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_vim.7.html
-
-.BR
-  /usr/share/doc/sisu/html/sisu_webrick.1.html
-
-.SH
-1.2.6 WWW.SISUDOC.ORG
-
-.BR
-<http:///sisudoc.org/man/sisu_manual.1.html>
-
-.BR
-<http:///sisudoc.org/man/sisu_help.1.html>
-
-.BR
-<http:///sisudoc.org/man/sisu_help_sources.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_commands.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_complete.7.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_configuration.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_faq.8.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_help.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_help_sources.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_howto.8.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_markup.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_pdf.7.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_postgresql.7.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_quickstart.8.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_remote.8.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_search.8.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_skin.1.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_sqlite.7.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_syntax_highlighting.8.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_vim.7.html>
-
-.BR
-  <http://sisudoc.org/man/sisu_webrick.1.html>
-
-.SH
-1.2.7 WWW.JUS.UIO.NO/SISU
-
-.BR
-<http://www.jus.uio.no/sisu/man/sisu_manual.1.html>
-
-.BR
-<http://www.jus.uio.no/sisu/man/sisu_help.1.html>
-
-.BR
-<http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu.1.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_commands.1.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_complete.7.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_configuration.1.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_faq.8.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_help.1.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_howto.8.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_markup.1.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_pdf.7.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_remote.8.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_search.8.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_skin.1.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_vim.7.html>
-
-.BR
-  <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html>
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- References
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-11\-12
-
-.BR
-DC Date issued:
-.I 2002\-11\-12
-
-.BR
-DC Date available:
-.I 2002\-11\-12
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_help_sources.sst
-
-.BR
-Filetype:
-.I SiSU text insert 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_help_sources.sst)=
-.I ff6812b3008391d7a20d777bbbeb3ec1
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:42 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-named index.html or more extensively through sisu_manifest.html
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_help_sources/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_help_sources/sisu_help_sources.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_markup.1 b/man/man1/sisu_markup.1
deleted file mode 100644
index d8e58032..00000000
--- a/man/man1/sisu_markup.1
+++ /dev/null
@@ -1,1532 +0,0 @@
-.TH "sisu_markup" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- MARKUP,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU MARKUP
-.BR
-
-.SH
-1. INTRODUCTION TO SISU MARKUP[^1]
-.BR
-
-.SH
-1.1 SUMMARY
-
-.BR
-.B SiSU
-source documents are plaintext (UTF\-8)[^2] files
-
-.BR
-All paragraphs are separated by an empty line.
-
-.BR
-Markup is comprised of:
-
-.BR
-* at the top of a document, the document header made up of semantic meta\-data
-about the document and if desired additional processing instructions (such an
-instruction to automatically number headings from a particular level down)
-
-.BR
-* followed by the prepared substantive text of which the most important single
-characteristic is the markup of different heading levels, which define the
-primary outline of the document structure. Markup of substantive text includes:
-
-.BR
-  * heading levels defines document structure
-
-.BR
-  * text basic attributes, italics, bold etc.
-
-.BR
-  * grouped text (objects), which are to be treated differently, such as code
-  blocks or poems.
-
-.BR
-  * footnotes/endnotes
-
-.BR
-  * linked text and images
-
-.BR
-  * paragraph actions, such as indent, bulleted, numbered\-lists, etc.
-
-.BR
-Some interactive help on markup is available, by typing sisu and selecting
-markup or sisu \-\-help markup
-
-.SH
-1.2 MARKUP EXAMPLES
-
-.SH
-1.2.1 ONLINE
-
-.BR
-Online markup examples are available together with the respective outputs
-produced from <http://www.jus.uio.no/sisu/SiSU/2.html> or from
-<http://www.jus.uio.no/sisu/sisu_examples/>
-
-.BR
-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/>
-
-.BR
-Some example marked up files are available as html with syntax highlighting for
-viewing: <http://www.jus.uio.no/sisu/sample/syntax>
-
-.BR
-an alternative presentation of markup syntax:
-<http://www.jus.uio.no/sisu/sample/on_markup.txt>
-
-.SH
-1.2.2 INSTALLED
-
-.BR
-With
-.B 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:
-/usr/share/doc/sisu/sisu_markup_samples/non\-free
-
-.SH
-2. MARKUP OF HEADERS
-.BR
-
-.BR
-Headers consist of semantic meta\-data about a document, which can be used by
-any output module of the program; and may in addition include extra processing
-instructions.
-
-.BR
-Note: the first line of a document may include information on the markup
-version used in the form of a comment. Comments are a percentage mark at the
-start of a paragraph (and as the first character in a line of text) followed by
-a space and the comment:
-
-
-.nf
-  % this would be a comment
-.fi
-
-.SH
-2.1 SAMPLE HEADER
-
-.BR
-This current document has a header similar to this one (without the comments):
-
-
-.nf
-  % SiSU 0.57
-  @title: SiSU
-  @subtitle: Markup
-  @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: 2002\-08\-28
-  @date.issued: 2002\-08\-28
-  @date.available: 2002\-08\-28
-  @date.modified: 2007\-09\-16
-  @date: 2007\-09\-16
-  @level: new=C; break=1; num_top=1
-  % comment: in this @level header num_top=1 starts automatic heading numbering at heading level 1 (numbering continues 3 levels down); the new and break instructions are used by the LaTeX/pdf and odf output to determine where to put page breaks (that are not used by html output or say sql database population).
-  @skin: skin_sisu_manual
-  % skins modify the appearance of a document and are placed in a sub\-directory under \./_sisu/skin ~/.sisu/skin or /etc/sisu/skin. A skin may affect single documents that request them, all documents in a directory, or be site\-wide. (A document is affected by a single skin)
-  @bold: /Gnu|Debian|Ruby|SiSU/
-  @links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/
-  { Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/2.html
-  { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
-  { SiSU @ Freshmeat }http://freshmeat.net/projects/sisu/
-  { SiSU @ Ruby Application Archive }http://raa.ruby\-lang.org/project/sisu/
-  { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
-  { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
-  { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
-.fi
-
-.SH
-2.2 AVAILABLE HEADERS
-
-.BR
-Header tags appear at the beginning of a document and provide meta information
-on the document (such as the Dublin Core), or information as to how the
-document as a whole is to be processed. All header instructions take either the
-form @headername: or 0~headername. All Dublin Core meta tags are available
-
-.BR
-.B @indentifier:
-information or instructions
-
-.BR
-where the \"identifier\" is a tag recognised by the program, and the
-\"information\" or \"instructions\" belong to the tag/indentifier specified
-
-.BR
-Note: a header where used should only be used once; all headers apart from
-@title: are optional; the @structure: header is used to describe document
-structure, and can be useful to know.
-
-.BR
-This is a sample header
-
-.BR
-.B % SiSU 0.38
-\ [declared \ file\-type \ identifier \ with \ markup \ version]
-
-.BR
-.B @title:
-\ [title \ text] This is the title of the document and used as such, this
-header is the only one that is
-.I mandatory
-
-.BR
-.B @subtitle:
-The Subtitle if any
-
-.BR
-.B @creator:
-\ [or \ @author:] Name of Author
-
-.BR
-.B @subject:
-(whatever your subject)
-
-.BR
-.B @description:
-
-.BR
-.B @publisher:
-
-.BR
-.B @contributor:
-
-.BR
-.B @translator:
-\ [or \ @translated_by:]
-
-.BR
-.B @illustrator:
-\ [or \ @illustrated_by:]
-
-.BR
-.B @prepared_by:
-\ [or \ @digitized_by:]
-
-.BR
-.B @date: 2000\-08\-27
-\ [ \ also \ @date.created: \ @date.issued: \ @date.available: \ @date.valid:
-\ @date.modified: \ ]
-
-.BR
-.B @type: article
-
-.BR
-.B @format:
-
-.BR
-.B @identifier:
-
-.BR
-.B @source:
-
-.BR
-.B @language:
-\ [or \ @language.document:] \ [country \ code \ for \ language \ if \
-available, \ or \ language, \ English, \ en \ is \ the \ default \ setting] (en
-\- English, fr \- French, de \- German, it \- Italian, es \- Spanish, pt \-
-Portuguese, sv \- Swedish, da \- Danish, fi \- Finnish, no \- Norwegian, is \-
-Icelandic, nl \- Dutch, et \- Estonian, hu \- Hungarian, pl \- Polish, ro \-
-Romanian, ru \- Russian, el \- Greek, uk \- Ukranian, tr \- Turkish, sk \-
-Slovak, sl \- Slovenian, hr \- Croatian, cs \- Czech, bg \- Bul garian ) \
-[however, \ encodings \ are \ not \ available \ for \ all \ of \ the \
-languages \ listed.]
-
-.BR
-[@language.original: \ original \ language \ in \ which \ the \ work \ was \
-published]
-
-.BR
-.B @papersize:
-(A4|US_letter|book_B5|book_A5|US_legal)
-
-.BR
-.B @relation:
-
-.BR
-.B @coverage:
-
-.BR
-.B @rights:
-Copyright (c) Name of Right Holder, all rights reserved, or as granted:
-public domain, copyleft, creative commons variant, etc.
-
-.BR
-.B @owner:
-
-.BR
-.B @keywords:
-text document generation processing management latex pdf structured xml
-citation \ [your \ keywords \ here, \ used \ for \ example \ by \ rss \ feeds,
-\ and \ in \ sql \ searches]
-
-.BR
-.B @abstract:
-\ [paper \ abstract, \ placed \ after \ table \ of \ contents]
-
-.BR
-.B @comment:
-\ [...]
-
-.BR
-.B @catalogue:
-loc=[Library \ of \ Congress \ classification]; dewey=[Dewey \
-classification]; isbn=[ISBN]; pg=[Project \ Gutenberg \ text \ number]
-
-.BR
-.B @classify_loc:
-\ [Library \ of \ Congress \ classification]
-
-.BR
-.B @classify_dewey:
-\ [Dewey \ classification]
-
-.BR
-.B @classify_isbn:
-\ [ISBN]
-
-.BR
-.B @classify_pg:
-\ [Project \ Gutenberg \ text \ number]
-
-.BR
-.B @prefix:
-\ [prefix \ is \ placed \ just \ after \ table \ of \ contents]
-
-.BR
-.B @prefix_a:
-\ [prefix \ is \ placed \ just \ before \ table \ of \ contents \ \- \ not \
-implemented]
-
-.BR
-.B @prefix_b:
-
-.BR
-.B @rcs:
-$Id: sisu_markup.sst,v 1.2 2007/09/08 17:12:47 ralph Exp $ \ [used \ by \ rcs
-\ or \ cvs \ to \ embed \ version \ (revision \ control) \ information \ into \
-document, \ rcs \ or \ cvs \ can \ usefully \ provide \ a \ history \ of \
-updates \ to \ a \ document \ ]
-
-.BR
-.B @structure:
-PART; CHAPTER; SECTION; ARTICLE; none; none;
-optional, document structure can be defined by words to match or regular
-expression (the regular expression is assumed to start at the beginning of a
-line of text i.e. ^) default markers :A~ to :C~ and 1~ to 6~ can be used within
-text instead, without this header tag, and may be used to supplement the
-instructions provided in this header tag if provided (@structure: is a synonym
-for @toc:)
-
-.BR
-.B @level:
-newpage=3; breakpage=4
-\ [paragraph \ level, \ used \ by \ latex \ to \ breakpages, \ the \ page \
-is \ optional \ eg. \ in \ newpage]
-
-.BR
-.B @markup:
-information on the markup used, e.g. new=1,2,3; break=4; num_top=4 \ [or \
-newpage=1,2,3; \ breakpage=4; \ num_top=4] newpage and breakpage, heading
-level, used by LaTeX to breakpages. breakpage: starts on a new page in single
-column text and on a new column in double column text; newpage: starts on a new
-page for both single and double column texts.
-num_top=4 \ [auto\-number \ document, \ starting \ at \ level \ 4. \ the \
-default \ is \ to \ provide \ 3 \ levels, \ as \ in \ 1 \ level \ 4, \ 1.1 \
-level \ 5, \ 1.1.1 \ level \ 6, \ markup \ to \ be \ merged \ within \ level]
-num_extract \ [take \ numbering \ of \ headings \ provided \ (manually \ in \
-marked \ up \ source \ document), \ and \ use \ for \ numbering \ of \
-segments. \ Available \ where \ a \ clear \ numbering \ structure \ is \
-provided \ within \ document, \ without \ the \ repetition \ of \ a \ number \
-in \ a \ header.] \ [In \ 0.38 \ notation, \ you \ would \ map \ to \ the \
-equivalent \ levels, \ the \ examples \ provided \ would \ map \ to \ the \
-following \ new=A,B,C; \ break=1; \ num_top=1 \ \ [or \ newpage=A,B,C; \
-breakpage=1; \ num_top=1] see headings]
-
-.BR
-.B @bold:
-\ [regular \ expression \ of \ words/phrases \ to \ be \ made \ bold]
-
-.BR
-.B @italics:
-\ [regular \ expression \ of \ words/phrases \ to \ italicise]
-
-.BR
-.B @vocabulary:
-name of taxonomy/vocabulary/wordlist to use against document
-
-.BR
-.B @skin:
-skin_doc_[name_of_desired_document_skin]
-skins change default settings related to the appearance of documents
-generated, such as the urls of the home site, and the icon/logo for the
-document or site.
-
-.BR
-.B @links:
-{
-.B SiSU
-}http://www.jus.uio.no/sisu/;
-{ FSF }http://www.fsf.org
-
-.BR
-.B @promo:
-sisu, ruby, search_libre_docs, open_society
-\ [places \ content \ in \ right \ pane \ in \ html, \ makes \ use \ of \
-list.yml \ and \ promo.yml, \ commented \ out \ sample \ in \ document \
-sample: \
-free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst]
-
-.SH
-3. MARKUP OF SUBSTANTIVE TEXT
-.BR
-
-.SH
-3.1 HEADING LEVELS
-
-.BR
-Heading levels are :A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ \... :A \- :C being part / section
-headings, followed by other heading levels, and 1 \-6 being headings followed
-by substantive text or sub\-headings. :A~ usually the title :A~? conditional
-level 1 heading (used where a stand\-alone document may be imported into
-another)
-
-.BR
-.B :A~ \ [heading \ text]
-Top level heading \ [this \ usually \ has \ similar \ content \ to \ the \
-title \ @title: \ ] NOTE: the heading levels described here are in 0.38
-notation, see heading
-
-.BR
-.B :B~ \ [heading \ text]
-Second level heading \ [this \ is \ a \ heading \ level \ divider]
-
-.BR
-.B :C~ \ [heading \ text]
-Third level heading \ [this \ is \ a \ heading \ level \ divider]
-
-.BR
-.B 1~ \ [heading \ text]
-Top level heading preceding substantive text of document or sub\-heading 2,
-the heading level that would normally be marked 1. or 2. or 3. etc. in a
-document, and the level on which sisu by default would break html output into
-named segments, names are provided automatically if none are given (a number),
-otherwise takes the form 1~my_filename_for_this_segment
-
-.BR
-.B 2~ \ [heading \ text]
-Second level heading preceding substantive text of document or sub\-heading
-3, the heading level that would normally be marked 1.1 or 1.2 or 1.3 or 2.1
-etc. in a document.
-
-.BR
-.B 3~ \ [heading \ text]
-Third level heading preceding substantive text of document, that would
-normally be marked 1.1.1 or 1.1.2 or 1.2.1 or 2.1.1 etc. in a document
-
-
-.nf
-  1~filename level 1 heading,
-  % the primary division such as Chapter that is followed by substantive text, and may be further subdivided (this is the level on which by default html segments are made)
-.fi
-
-.SH
-3.2 FONT ATTRIBUTES
-
-.BR
-.B markup example:
-
-
-.nf
-  normal text !{emphasis}! *{bold text}* _{underscore}_ /{italics}/ \"{citation}\" ^{superscript}^ ,{subscript}, +{inserted text}+
-  normal text
-  !{emphasis}!
-  *{bold text}*
-  _{underscore}
-  /{italics}/
-  \"{citation}\"
-  ^{superscript}^
-  ,{subscript},
-  +{inserted text}+
-  \-{strikethrough}\-
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text <em>emphasis</em>
-.B bold text
-.I underscore
-.I italics
-<cite>citation</cite> ^superscript^ \ [subscript] <ins>inserted text</ins>
-<del>strikethrough</del>
-
-.BR
-normal text
-
-.BR
-<em>emphasis</em>
-
-.BR
-.B bold text
-
-.BR
-.I underscore
-
-.BR
-.I italics
-
-.BR
-<cite>citation</cite>
-
-.BR
-^superscript^
-
-.BR
-[subscript]
-
-.BR
-<ins>inserted text</ins>
-
-.BR
-<del>strikethrough</del>
-
-.SH
-3.3 INDENTATION AND BULLETS
-
-.BR
-.B markup example:
-
-
-.nf
-  ordinary paragraph
-  _1 indent paragraph one step
-  _2 indent paragraph two steps
-  _9 indent paragraph nine steps
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-ordinary paragraph
-
-.BR
-  indent paragraph one step
-
-.BR
-    indent paragraph two steps
-
-.BR
-                  indent paragraph nine steps
-
-.BR
-.B markup example:
-
-
-.nf
-  * bullet text
-  _1* bullet text, first indent
-  _2* bullet text, two step indent
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-* bullet text
-
-.BR
-  * bullet text, first indent
-
-.BR
-    * bullet text, two step indent
-
-.BR
-Numbered List (not to be confused with headings/titles, (document structure))
-
-.BR
-.B markup example:
-
-
-.nf
-  # numbered list                numbered list 1., 2., 3, etc.
-  _# numbered list numbered list indented a., b., c., d., etc.
-.fi
-
-.SH
-3.4 FOOTNOTES / ENDNOTES
-
-.BR
-Footnotes and endnotes not distinguished in markup. They are automatically
-numbered. Depending on the output file format (html, odf, pdf etc.), the
-document output selected will have either footnotes or endnotes.
-
-.BR
-.B markup example:
-
-
-.nf
-  ~{ a footnote or endnote }~
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-[^3]
-
-.BR
-.B markup example:
-
-
-.nf
-  normal text~{ self contained endnote marker & endnote in one }~ continues
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text[^4] continues
-
-.BR
-.B markup example:
-
-
-.nf
-  normal text ~{* unnumbered asterisk footnote/endnote, insert multiple asterisks if required }~ continues
-  normal text ~{** another unnumbered asterisk footnote/endnote }~ continues
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text \ [^*] continues
-
-.BR
-normal text \ [^**] continues
-
-.BR
-.B markup example:
-
-
-.nf
-  normal text ~[* \ editors \ notes, \ numbered \ asterisk \ footnote/endnote \ series \ ]~ continues
-  normal text ~[+ \ editors \ notes, \ numbered \ asterisk \ footnote/endnote \ series \ ]~ continues
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text \ [^*1] continues
-
-.BR
-normal text \ [^+1] continues
-
-.BR
-.B Alternative endnote pair notation for footnotes/endnotes:
-
-
-.nf
-.nf
-  % note the endnote marker \"~^\"
-  normal text~^ continues
-  ^~ endnote text following the paragraph in which the marker occurs
-.fi
-
-.BR
-the standard and pair notation cannot be mixed in the same document
-
-.SH
-3.5 LINKS
-
-.SH
-3.5.1 NAKED URLS WITHIN TEXT, DEALING WITH URLS
-
-.BR
-urls are found within text and marked up automatically. A url within text is
-automatically hyperlinked to itself and by default decorated with angled
-braces, unless they are contained within a code block (in which case they are
-passed as normal text), or escaped by a preceding underscore (in which case the
-decoration is omitted).
-
-.BR
-.B markup example:
-
-
-.nf
-  normal text http://www.jus.uio.no/sisu continues
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text <http://www.jus.uio.no/sisu> continues
-
-.BR
-An escaped url without decoration
-
-.BR
-.B markup example:
-
-
-.nf
-  normal text http://www.jus.uio.no/sisu continues
-  deb http://www.jus.uio.no/sisu/archive unstable main non\-free
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text http://www.jus.uio.no/sisu continues
-
-.BR
-deb http://www.jus.uio.no/sisu/archive unstable main non\-free
-
-.BR
-where a code block is used there is neither decoration nor hyperlinking, code
-blocks are discussed later in this document
-
-.BR
-.B resulting output:
-
-
-.nf
-  deb http://www.jus.uio.no/sisu/archive unstable main non\-free
-  deb\-src http://www.jus.uio.no/sisu/archive unstable main non\-free
-.fi
-
-.BR
-To link text or an image to a url the markup is as follows
-
-.BR
-.B markup example:
-
-
-.nf
-  about { SiSU }http://url.org markup
-.fi
-
-.SH
-3.5.2 LINKING TEXT
-
-.BR
-.B resulting output:
-
-.BR
-about SiSU <http://www.jus.uio.no/sisu/> markup
-
-.BR
-A shortcut notation is available so the url link may also be provided
-automatically as a footnote
-
-.BR
-.B markup example:
-
-
-.nf
-  about {~^ SiSU }http://url.org markup
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-about SiSU <http://www.jus.uio.no/sisu/> \ [^5] markup
-
-.SH
-3.5.3 LINKING IMAGES
-
-.BR
-.B markup example:
-
-
-.nf
-      [ tux.png ]
-  % various url linked images
-      [ tux.png ]
-      [ GnuDebianLinuxRubyBetterWay.png ]
-  {~^ ruby_logo.png \"Ruby\" }http://www.ruby\-lang.org/en/
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-[ tux.png ]
-
-.BR
-tux.png 64x80 \"Gnu/Linux \- a better way\" <http://www.jus.uio.no/sisu/>
-
-.BR
-[ \ ruby_logo \ (png \ missing) \ ] \ [^6]
-
-.BR
-GnuDebianLinuxRubyBetterWay.png 100x101 \"Way Better \- with Gnu/Linux, Debian
-and Ruby\" <http://www.jus.uio.no/sisu/>
-
-.BR
-.B linked url footnote shortcut
-
-
-.nf
-  {~^ \ [text \ to \ link] }http://url.org
-  % maps to: { \ [text \ to \ link] }http://url.org ~{ http://url.org }~
-  % which produces hyper\-linked text within a document/paragraph, with an endnote providing the url for the text location used in the hyperlink
-.fi
-
-
-.nf
-  text marker *~name
-.fi
-
-.BR
-note at a heading level the same is automatically achieved by providing names
-to headings 1, 2 and 3 i.e. 2~[name] and 3~[name] or in the case of
-auto\-heading numbering, without further intervention.
-
-.SH
-3.6 GROUPED TEXT
-
-.SH
-3.6.1 TABLES
-
-.BR
-Tables may be prepared in two either of two forms
-
-.BR
-.B markup example:
-
-
-.nf
-  table{ c3; 40; 30; 30;
-  This is a table
-  this would become column two of row one
-  column three of row one is here
-  And here begins another row
-  column two of row two
-  column three of row two, and so on
-  }table
-.fi
-
-.BR
-.B resulting output:
-
- \ [table \ omitted, \ see \ other \ document \ formats]
-
-.BR
-a second form may be easier to work with in cases where there is not much
-information in each column
-
-.BR
-.B markup example:
-[^7]
-
-
-.nf
-  !_ Table 3.1: Contributors to Wikipedia, January 2001 \- June 2005
-  {table~h 24; 12; 12; 12; 12; 12; 12;}
-                                  |Jan. 2001|Jan. 2002|Jan. 2003|Jan. 2004|July 2004|June 2006
-  Contributors*                   |       10|      472|    2,188|    9,653|   25,011|   48,721
-  Active contributors**           |        9|      212|      846|    3,228|    8,442|   16,945
-  Very active contributors***     |        0|       31|      190|      692|    1,639|    3,016
-  No. of English language articles|       25|   16,000|  101,000|  190,000|  320,000|  630,000
-  No. of articles, all languages  |       25|   19,000|  138,000|  490,000|  862,000|1,600,000
-  \\* Contributed at least ten times; \\** at least 5 times in last month; \\*\** more than 100 times in last month.
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-.B Table 3.1: Contributors to Wikipedia, January 2001 \- June 2005
-
- \ [table \ omitted, \ see \ other \ document \ formats]
-
-.BR
-* Contributed at least ten times; ** at least 5 times in last month; *** more
-than 100 times in last month.
-
-.SH
-3.6.2 POEM
-
-.BR
-.B basic markup:
-
-
-.nf
-  poem{
-    Your poem here
-  }poem
-  Each verse in a poem is given a separate object number.
-.fi
-
-.BR
-.B markup example:
-
-
-.nf
-  poem{
-                      \'Fury said to a
-                     mouse, That he
-                   met in the
-                 house,
-              \"Let us
-                both go to
-                  law:  I will
-                    prosecute
-                      YOU.  \-\-Come,
-                         I\'ll take no
-                          denial; We
-                       must have a
-                   trial:  For
-                really this
-             morning I\'ve
-            nothing
-           to do.\"
-             Said the
-               mouse to the
-                 cur, \"Such
-                   a trial,
-                     dear Sir,
-                           With
-                       no jury
-                    or judge,
-                  would be
-                wasting
-               our
-                breath.\"
-                 \"I\'ll be
-                   judge, I\'ll
-                     be jury,\"
-                           Said
-                      cunning
-                        old Fury:
-                       \"I\'ll
-                        try the
-                           whole
-                            cause,
-                               and
-                          condemn
-                         you
-                        to
-                         death.\"\'
-  }poem
-.fi
-
-.BR
-.B resulting output:
-
-
-                    \'Fury said to a
-.P
-                   mouse, That he
-.P
-                 met in the
-.P
-               house,
-.P
-            \"Let us
-.P
-              both go to
-.P
-                law:  I will
-.P
-                  prosecute
-.P
-                    YOU.  \-\-Come,
-.P
-                       I\'ll take no
-.P
-                        denial; We
-.P
-                     must have a
-.P
-                 trial:  For
-.P
-              really this
-.P
-           morning I\'ve
-.P
-          nothing
-.P
-         to do.\"
-.P
-           Said the
-.P
-             mouse to the
-.P
-               cur, \"Such
-.P
-                 a trial,
-.P
-                   dear Sir,
-.P
-                         With
-.P
-                     no jury
-.P
-                  or judge,
-.P
-                would be
-.P
-              wasting
-.P
-             our
-.P
-              breath.\"
-.P
-               \"I\'ll be
-.P
-                 judge, I\'ll
-.P
-                   be jury,\"
-.P
-                         Said
-.P
-                    cunning
-.P
-                      old Fury:
-.P
-                     \"I\'ll
-.P
-                      try the
-.P
-                         whole
-.P
-                          cause,
-.P
-                             and
-.P
-                        condemn
-.P
-                       you
-.P
-                      to
-.P
-                       death.\"\'
-.P
-
-.SH
-3.6.3 GROUP
-
-.BR
-.B basic markup:
-
-
-.nf
-  group{
-    Your grouped text here
-  }group
-  A group is treated as an object and given a single object number.
-.fi
-
-.BR
-.B markup example:
-
-
-.nf
-  group{
-                      \'Fury said to a
-                     mouse, That he
-                   met in the
-                 house,
-              \"Let us
-                both go to
-                  law:  I will
-                    prosecute
-                      YOU.  \-\-Come,
-                         I\'ll take no
-                          denial; We
-                       must have a
-                   trial:  For
-                really this
-             morning I\'ve
-            nothing
-           to do.\"
-             Said the
-               mouse to the
-                 cur, \"Such
-                   a trial,
-                     dear Sir,
-                           With
-                       no jury
-                    or judge,
-                  would be
-                wasting
-               our
-                breath.\"
-                 \"I\'ll be
-                   judge, I\'ll
-                     be jury,\"
-                           Said
-                      cunning
-                        old Fury:
-                       \"I\'ll
-                        try the
-                           whole
-                            cause,
-                               and
-                          condemn
-                         you
-                        to
-                         death.\"\'
-  }group
-.fi
-
-.BR
-.B resulting output:
-
-
-                    \'Fury said to a
-.P
-                   mouse, That he
-.P
-                 met in the
-.P
-               house,
-.P
-            \"Let us
-.P
-              both go to
-.P
-                law:  I will
-.P
-                  prosecute
-.P
-                    YOU.  \-\-Come,
-.P
-                       I\'ll take no
-.P
-                        denial; We
-.P
-                     must have a
-.P
-                 trial:  For
-.P
-              really this
-.P
-           morning I\'ve
-.P
-          nothing
-.P
-         to do.\"
-.P
-           Said the
-.P
-             mouse to the
-.P
-               cur, \"Such
-.P
-                 a trial,
-.P
-                   dear Sir,
-.P
-                         With
-.P
-                     no jury
-.P
-                  or judge,
-.P
-                would be
-.P
-              wasting
-.P
-             our
-.P
-              breath.\"
-.P
-               \"I\'ll be
-.P
-                 judge, I\'ll
-.P
-                   be jury,\"
-.P
-                         Said
-.P
-                    cunning
-.P
-                      old Fury:
-.P
-                     \"I\'ll
-.P
-                      try the
-.P
-                         whole
-.P
-                          cause,
-.P
-                             and
-.P
-                        condemn
-.P
-                       you
-.P
-                      to
-.P
-                       death.\"\'
-.P
-
-.SH
-3.6.4 CODE
-
-.BR
-Code tags are used to escape regular sisu markup, and have been used
-extensively within this document to provide examples of
-.B SiSU
-markup. You cannot however use code tags to escape code tags. They are
-however used in the same way as group or poem tags.
-
-.BR
-A code\-block is treated as an object and given a single object number. \ [an \
-option \ to \ number \ each \ line \ of \ code \ may \ be \ considered \ at \
-some \ later \ time]
-
-.BR
-.B use of code tags instead of poem compared, resulting output:
-
-
-.nf
-                      \'Fury said to a
-                     mouse, That he
-                   met in the
-                 house,
-              \"Let us
-                both go to
-                  law:  I will
-                    prosecute
-                      YOU.  \-\-Come,
-                         I\'ll take no
-                          denial; We
-                       must have a
-                   trial:  For
-                really this
-             morning I\'ve
-            nothing
-           to do.\"
-             Said the
-               mouse to the
-                 cur, \"Such
-                   a trial,
-                     dear Sir,
-                           With
-                       no jury
-                    or judge,
-                  would be
-                wasting
-               our
-                breath.\"
-                 \"I\'ll be
-                   judge, I\'ll
-                     be jury,\"
-                           Said
-                      cunning
-                        old Fury:
-                       \"I\'ll
-                        try the
-                           whole
-                            cause,
-                               and
-                          condemn
-                         you
-                        to
-                         death.\"\'
-.fi
-
-.SH
-4. COMPOSITE DOCUMENTS MARKUP
-.BR
-
-.BR
-It is possible to build a document by creating a master document that requires
-other documents. The documents required may be complete documents that could be
-generated independently, or they could be markup snippets, prepared so as to be
-easily available to be placed within another text. If the calling document is a
-master document (built from other documents), it should be named with the
-suffix
-.B \.ssm
-Within this document you would provide information on the other documents
-that should be included within the text. These may be other documents that
-would be processed in a regular way, or markup bits prepared only for inclusion
-within a master document
-.B \.sst
-regular markup file, or
-.B \.ssi
-(insert/information) A secondary file of the composite document is built
-prior to processing with the same prefix and the suffix
-.B \._sst
-
-.BR
-basic markup for importing a document into a master document
-
-
-.nf
-  << |filename1.sst|@|^|
-  << |filename2.ssi|@|^|
-.fi
-
-.BR
-The form described above should be relied on. Within the Vim editor it results
-in the text thus linked becoming hyperlinked to the document it is calling in
-which is convenient for editing. Alternative markup for importation of
-documents under consideration, and occasionally supported have been.
-
-
-.nf
-  r{filename}
-  {filename.ssi}require
-  << {filename.ssi}
-  % using textlink alternatives
-  |filename.ssi|@|^|require
-  << |filename.ssi|@|^|
-  % using thlnk alternatives
-  <url:filename.ssi>require
-  << <url:filename.ssi>
-.fi
-
-.SH
-MARKUP SYNTAX HISTORY
-.BR
-
-.SH
-5. NOTES RELATED TO FILES\-TYPES AND MARKUP SYNTAX
-.BR
-
-.BR
-0.38 is substantially current, depreciated 0.16 supported, though file names
-were changed at 0.37
-
-.BR
-.B 0.52
-(2007w14/6) declared document type identifier at start of text/document:
-
-.BR
-  .B SiSU
-0.52
-
-.BR
-or, backward compatible using the comment marker:
-
-.BR
-  %
-.B SiSU
-0.38
-
-.BR
-variations include \'
-.B SiSU
-(text|master|insert) \ [version]\' and \'sisu\-[version]\'
-
-.BR
-.B 0.51
-(2007w13/6) skins changed (simplified), markup unchanged
-
-.BR
-.B 0.42
-(2006w27/4) * (asterisk) type endnotes, used e.g. in relation to author
-
-.BR
-.B 0.38
-(2006w15/7) introduced new/alternative notation for headers, e.g. @title:
-(instead of 0~title), and accompanying document structure markup,
-:A,:B,:C,1,2,3 (maps to previous 1,2,3,4,5,6)
-
-.BR
-.B 0.37
-(2006w09/7) introduced new file naming convention, \.sst (text), \.ssm
-(master), \.ssi (insert), markup syntax unchanged
-
-.BR
-.B 0.35
-(2005w52/3) sisupod, zipped content file introduced
-
-.BR
-.B 0.23
-(2005w36/2) utf\-8 for markup file
-
-.BR
-.B 0.22
-(2005w35/3) image dimensions may be omitted if rmagick is available to be
-relied upon
-
-.BR
-.B 0.20.4
-(2005w33/4) header 0~links
-
-.BR
-.B 0.16
-(2005w25/2) substantial changes introduced to make markup cleaner, header
-0~title type, and headings \ [1\-6]~ introduced, also percentage sign (%) at
-start of a text line as comment marker
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Markup
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_markup.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_markup.sst)=
-.I 6848f40f5844e0a7d59dbb86b3ddae92
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:43 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-From sometime after SiSU 0.58 it should be possible to describe SiSU markup
-using SiSU, which though not an original design goal is useful.
-.TP
-.BI 2.
-files should be prepared using UTF-8 character encoding
-.TP
-.BI 3.
-a footnote or endnote
-.TP
-.BI 4.
-self contained endnote marker & endnote in one
-.TP
-.BI *.
-unnumbered asterisk footnote/endnote, insert multiple asterisks if required
-.TP
-.BI **.
-another unnumbered asterisk footnote/endnote
-.TP
-.BI *1.
-editors notes, numbered asterisk footnote/endnote series
-.TP
-.BI +1.
-editors notes, numbered asterisk footnote/endnote series
-.TP
-.BI 5.
-<http://www.jus.uio.no/sisu/>
-.TP
-.BI 6.
-<http://www.ruby-lang.org/en/>
-.TP
-.BI 7.
-Table from the Wealth of Networks by Yochai Benkler
- <http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler>
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_markup/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_markup/sisu_markup.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_skin.1 b/man/man1/sisu_skin.1
deleted file mode 100644
index 20f337d8..00000000
--- a/man/man1/sisu_skin.1
+++ /dev/null
@@ -1,222 +0,0 @@
-.TH "sisu_skin" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- SKINS,
-RALPH AMISSAH
-.BR
-
-.SH
-DOCUMENT SKINS \- CONFIGURATION
-.BR
-
-.SH
-1. SKINS
-.BR
-
-.BR
-Skins modify the default appearance of document output on a document,
-directory, or site wide basis. Skins are looked for in the following locations:
-
-.BR
-  \./_sisu/skin
-
-.BR
-  ~/.sisu/skin
-
-.BR
-  /etc/sisu/skin
-
-.BR
-.B Within the skin directory
-are the following the default sub\-directories for document skins:
-
-.BR
-  \./skin/doc
-
-.BR
-  \./skin/dir
-
-.BR
-  \./skin/site
-
-.BR
-A skin is placed in the appropriate directory and the file named skin_[name].rb
-
-.BR
-The skin itself is a ruby file which modifies the default appearances set in
-the program.
-
-.SH
-1.1 DOCUMENT SKIN
-
-.BR
-Documents take on a document skin, if the header of the document specifies a
-skin to be used.
-
-
-.nf
-  @skin: skin_united_nations
-.fi
-
-.SH
-1.2 DIRECTORY SKIN
-
-.BR
-A directory may be mapped on to a particular skin, so all documents within that
-directory take on a particular appearance. If a skin exists in the skin/dir
-with the same name as the document directory, it will automatically be used for
-each of the documents in that directory, (except where a document specifies the
-use of another skin, in the skin/doc directory).
-
-.BR
-A personal habit is to place all skins within the doc directory, and symbolic
-links as needed from the site, or dir directories as required.
-
-.SH
-1.3 SITE SKIN
-
-.BR
-A site skin, modifies the program default skin.
-
-.SH
-1.4 SAMPLE SKINS
-
-.BR
-With
-.B SiSU
-installed sample skins may be found in:
-
-.BR
-  /etc/sisu/skin/doc and
-  /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc
-
-.BR
-(or equivalent directory) and if sisu\-markup\-samples is installed also under:
-
-.BR
-  /usr/share/doc/sisu/sisu_markup_samples/non\-free/_sisu/skin/doc
-
-.BR
-Samples of list.yml and promo.yml (which are used to create the right column
-list) may be found in:
-
-.BR
-  /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent
-  directory)
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Skins
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-11\-12
-
-.BR
-DC Date issued:
-.I 2002\-11\-12
-
-.BR
-DC Date available:
-.I 2002\-11\-12
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_skin.sst
-
-.BR
-Filetype:
-.I SiSU text insert 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_skin.sst)=
-.I 8aebfb5312045c3a705ad6c314246f67
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:44 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_skin/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_skin/sisu_skin.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu