manpage, v2 update (including --long-options)

11 files changed, 259 insertions, 93 deletions

diff --git a/man/man1/sisu-concordance.1 b/man/man1/sisu-concordance.1
index 67f427a5..da2cdb7a 100644
--- a/man/man1/sisu-concordance.1
+++ b/man/man1/sisu-concordance.1
@@ -9,7 +9,7 @@
 .SH DESCRIPTION
 \fBSiSU\fR is a lightweight markup based document structuring, publishing and search framework for document collections.
 .PP
-The \fBsisu\-concordance\fR command is an alias for \fBsisu \-w\fR which produces an HTML concordance file (wordlist) of a SiSU markup file.
+The \fBsisu\-concordance\fR command is an alias for \fBsisu \-\-concordance\fR (or \fBsisu \-w\fR) which produces an HTML concordance file (wordlist) of a SiSU markup file.
 
 .SH SEE ALSO
 \fIsisu\fR(1),
diff --git a/man/man1/sisu-epub.1 b/man/man1/sisu-epub.1
index 7ea12428..8036b214 100644
--- a/man/man1/sisu-epub.1
+++ b/man/man1/sisu-epub.1
@@ -9,7 +9,7 @@
 .SH DESCRIPTION
 \fBSiSU\fR is a lightweight markup based document structuring, publishing and search framework for document collections.
 .PP
-The \fBsisu\-epub\fR command is an alias for \fBsisu \-e\fR which produces EPUB output of a SiSU markup file.
+The \fBsisu\-epub\fR command is an alias for \fBsisu \-\-epub\fR (or \fBsisu \-e\fR) which produces EPUB output of a SiSU markup file.
 
 .SH SEE ALSO
 \fIsisu\fR(1),
diff --git a/man/man1/sisu-html.1 b/man/man1/sisu-html.1
index e389a229..8af826cc 100644
--- a/man/man1/sisu-html.1
+++ b/man/man1/sisu-html.1
@@ -9,7 +9,7 @@
 .SH DESCRIPTION
 \fBSiSU\fR is a lightweight markup based document structuring, publishing and search framework for document collections.
 .PP
-The \fBsisu\-html\fR command is an alias for \fBsisu \-h\fR which produces HTML output of a SiSU markup file.
+The \fBsisu\-html\fR command is an alias for \fBsisu \-\-html\fR (or \fBsisu \-h\fR) which produces HTML output of a SiSU markup file.
 
 .SH SEE ALSO
 \fIsisu\fR(1),
diff --git a/man/man1/sisu-odf.1 b/man/man1/sisu-odf.1
index 82071b81..7e12508c 100644
--- a/man/man1/sisu-odf.1
+++ b/man/man1/sisu-odf.1
@@ -9,7 +9,7 @@
 .SH DESCRIPTION
 \fBSiSU\fR is a lightweight markup based document structuring, publishing and search framework for document collections.
 .PP
-The \fBsisu\-odf\fR command is an alias for \fBsisu \-o\fR which produces OpenDocument output of a SiSU markup file.
+The \fBsisu\-odf\fR command is an alias for \fBsisu \-\-odt\fR (or \fBsisu \-o\fR) which produces OpenDocument output of a SiSU markup file.
 
 .SH SEE ALSO
 \fIsisu\fR(1),
diff --git a/man/man1/sisu-pdf.1 b/man/man1/sisu-pdf.1
index 52f16c9c..20782f75 100644
--- a/man/man1/sisu-pdf.1
+++ b/man/man1/sisu-pdf.1
@@ -9,7 +9,7 @@
 .SH DESCRIPTION
 \fBSiSU\fR is a lightweight markup based document structuring, publishing and search framework for document collections.
 .PP
-The \fBsisu\-pdf\fR command is an alias for \fBsisu \-p\fR which produces PDF output of a SiSU markup file.
+The \fBsisu\-pdf\fR command is an alias for \fBsisu \-\-pdf\fR (or \fBsisu \-p\fR) which produces PDF output of a SiSU markup file.
 
 .SH SEE ALSO
 \fIsisu\fR(1),
diff --git a/man/man1/sisu-pg.1 b/man/man1/sisu-pg.1
index a6dda153..d94d4b0c 100644
--- a/man/man1/sisu-pg.1
+++ b/man/man1/sisu-pg.1
@@ -9,7 +9,7 @@
 .SH DESCRIPTION
 \fBSiSU\fR is a lightweight markup based document structuring, publishing and search framework for document collections.
 .PP
-The \fBsisu\-pq\fR command is an alias for \fBsisu \-D\fR which populates a PostgreSQL database with SiSU content (for search) from a SiSU markup file.
+The \fBsisu\-pq\fR command is an alias for \fBsisu \-\-pg\fR (or \fBsisu \-D\fR) which populates a PostgreSQL database with SiSU content (for search) from a SiSU markup file.
 
 .SH SEE ALSO
 \fIsisu\fR(1),
diff --git a/man/man1/sisu-sqlite.1 b/man/man1/sisu-sqlite.1
index ecea4470..f808aaa9 100644
--- a/man/man1/sisu-sqlite.1
+++ b/man/man1/sisu-sqlite.1
@@ -9,7 +9,7 @@
 .SH DESCRIPTION
 \fBSiSU\fR is a lightweight markup based document structuring, publishing and search framework for document collections.
 .PP
-The \fBsisu\-sqlite\fR command is an alias for \fBsisu \-d\fR which populates a SQLite database with SiSU content (for search) from a SiSU markup file.
+The \fBsisu\-sqlite\fR command is an alias for \fBsisu \-\-sqlite\fR (or \fBsisu \-d\fR) which populates a SQLite database with SiSU content (for search) from a SiSU markup file.
 
 .SH SEE ALSO
 \fIsisu\fR(1),
diff --git a/man/man1/sisu-txt.1 b/man/man1/sisu-txt.1
index e834caf1..51cedf4c 100644
--- a/man/man1/sisu-txt.1
+++ b/man/man1/sisu-txt.1
@@ -9,7 +9,7 @@
 .SH DESCRIPTION
 \fBSiSU\fR is a lightweight markup based document structuring, publishing and search framework for document collections.
 .PP
-The \fBsisu\-txt\fR command is an alias for \fBsisu \-t\fR which produces plain text output of a SiSU markup file.
+The \fBsisu\-txt\fR command is an alias for \fBsisu \-\-txt\fR (or \fBsisu \-t\fR) which produces plain text output of a SiSU markup file.
 
 .SH SEE ALSO
 \fIsisu\fR(1),
diff --git a/man/man1/sisu.1 b/man/man1/sisu.1
index 9dce74e4..7a9d9659 100644
--- a/man/man1/sisu.1
+++ b/man/man1/sisu.1
@@ -1,4 +1,4 @@
-.TH "sisu" "1" "2010-07-07" "2.6.0" "SiSU"
+.TH "sisu" "1" "2010-09-17" "2.6.3" "SiSU"
 .SH NAME
 sisu \- documents: markup, structuring, publishing in multiple standard formats, and search
 .SH SYNOPSIS
@@ -207,7 +207,20 @@ footnotes at the end of each paragraph \-\-unix for unix linefeed (default)
 
 .TP
 .B \-b [filename/wildcard]
-produces xhtml/XML output for browser viewing (sax parsing).
+see \-\-xhtml
+
+.TP
+.B \-\-color\-toggle [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). Alias \-c
+
+.TP
+.B \-\-concordance [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). Alias \-w
 
 .TP
 .B \-C [\-\-init\-site]
@@ -229,70 +242,112 @@ 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).
+see \-\-color\-toggle
+
+.TP
+.B \-\-dal [filename/wildcard/url]
+assumed for most other flags, creates new intermediate files for processing
+(document abstraction) that is used in all subsequent processing of other
+output. This step is assumed for most processing flags. To skip it see \-n.
+Alias \-m
+
+.TP
+.B \-\-delete [filename/wildcard]
+see \-\-zap
 
 .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.
+see \-\-pg
 
 .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.
+see \-\-sqlite
+
+.TP
+.B \-\-epub [filename/wildcard]
+produces an epub document, [sisu \ version \ 2 \ only] (filename.epub). Alias
+\-e
 
 .TP
 .B \-e [filename/wildcard]
-produces an epub document, [sisu \ version \ 2 \ only] (filename.epub)
+see \-\-epub
 
 .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
+see \-\-sample\-search\-form
 
 .TP
-.B \-h [filename/wildcard]
+.B \-\-git [filename/wildcard]
+produces or updates markup source file structure in a git repo (experimental
+and subject to change). Alias \-g
+
+.TP
+.B \-g [filename/wildcard]
+see \-\-git
+
+.TP
+.B \-\-harvest *.ss[tm]
+makes two lists of sisu output based on the sisu markup documents in a
+directory: list of author and authors works (year and titles), and; list by
+topic with titles and author. Makes use of header metadata fields (author,
+title, date, topic_register). Can be used with maintenance (\-M) and remote
+placement (\-R) flags.
+
+.TP
+.B \-\-help [topic]
+provides help on the selected topic, where topics (keywords) include: list,
+(com)mands, short(cuts), (mod)ifiers, (env)ironment, markup, syntax, headers,
+headings, endnotes, tables, example, customise, skin, (dir)ectories, path,
+(lang)uage, db, install, setup, (conf)igure, convert, termsheet, search, sql,
+features, license
+
+.TP
+.B \-\-html [filename/wildcard]
 produces html output, segmented text with table of contents (toc.html and
-index.html) and the document in a single file (scroll.html)
+index.html) and the document in a single file (scroll.html). Alias \-h
+
+.TP
+.B \-h [filename/wildcard]
+see \-\-html
 
 .TP
 .B \-I [filename/wildcard]
-produces texinfo and info file, (view with pinfo).
+see \-\-texinfo
 
 .TP
 .B \-i [filename/wildcard]
-produces man page of file, not suitable for all outputs.
+see \-\-manpage
 
 .TP
 .B \-L
 prints license information.
 
 .TP
-.B \-M [filename/wildcard/url]
+.B \-\-machine [filename/wildcard/url]
+see \-\-dal (document abstraction level/layer)
+
+.TP
+.B \-\-maintenance [filename/wildcard/url]
 maintenance mode files created for processing preserved and their locations
-indicated. (also see \-V)
+indicated. (also see \-V). Alias \-M
+
+.TP
+.B \-\-manpage [filename/wildcard]
+produces man page of file, not suitable for all outputs. Alias \-i
+
+.TP
+.B \-M [filename/wildcard/url]
+see \-\-maintenance
 
 .TP
 .B \-m [filename/wildcard/url]
-assumed for most other flags, creates new intermediate files for processing
-(document abstraction) that is used in all subsequent processing of other
-output. This step is assumed for most processing flags. To skip it see \-n
+see \-\-dal (document abstraction level/layer)
+
+.TP
+.B \-\-no\-ocn
+[with \ \-\-html \ \-\-pdf \ or \ \-\-epub] switches off object citation
+numbering. Produce output without identifying numbers in margins of html or
+LaTeX/pdf output.
 
 .TP
 .B \-N [filename/wildcard/url]
@@ -308,45 +363,99 @@ they already exist, this skips the equivalent of \-m which is otherwise assumed
 by most processing flags.
 
 .TP
+.B \-\-odf [filename/wildcard/url]
+see \-\-odt
+
+.TP
+.B \-\-odt [filename/wildcard/url]
+output basic document in opendocument file format (opendocument.odt). Alias
+\-o
+
+.TP
 .B \-o [filename/wildcard/url]
-output basic document in opendocument file format (opendocument.odt).
+see \-\-odt
 
 .TP
-.B \-p [filename/wildcard]
+.B \-\-pdf [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).
+'legal' and book sizes 'A5' and 'B5' (system defaults to A4). Alias \-p
 
 .TP
-.B \-q [filename/wildcard]
+.B \-\-pg [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. Alias
+\-D
+
+.TP
+.B \-p [filename/wildcard]
+see \-\-pdf
+
+.TP
+.B \-\-quiet [filename/wildcard]
 quiet less output to screen.
 
 .TP
-.B \-R [filename/wildcard]
+.B \-q [filename/wildcard]
+see \-\-quiet
+
+.TP
+.B \-\-rsync [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
+\-R is used together with other flags, it is not). Also see \-\-scp. Alias \-R
+
+.TP
+.B \-R [filename/wildcard]
+see \-\-rsync
 
 .TP
 .B \-r [filename/wildcard]
+see \-\-scp
+
+.TP
+.B \-\-sample\-search\-form [\-\-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. Alias \-F
+
+.TP
+.B \-\-scp [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
+that you have your "keys" and ssh agent in place. Also see \-\-rsync. Alias \-r
 
 .TP
-.B \-S
+.B \-\-sqlite \-\-[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. Alias \-d
+
+.TP
+.B \-\-sisupod
 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).
+option is tested only with zsh). Alias \-S
 
 .TP
-.B \-S [filename/wildcard]
+.B \-\-sisupod [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
@@ -364,33 +473,58 @@ 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].
+Alias \-S
+
+.TP
+.B \-\-source [filename/wildcard]
+copies sisu markup file to output directory. Alias \-s
+
+.TP
+.B \-S
+see \-\-sisupod
+
+.TP
+.B \-S [filename/wildcard]
+see \-\-sisupod
 
 .TP
 .B \-s [filename/wildcard]
-copies sisu markup file to output directory.
+see \-\-source
 
 .TP
-.B \-T [filename/wildcard \ (*.termsheet.rb)]
-standard form document builder, preprocessing feature
+.B \-\-texinfo [filename/wildcard]
+produces texinfo and info file, (view with pinfo). Alias \-I
 
 .TP
-.B \-t [filename/wildcard]
+.B \-\-txt [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)
+\-\-msdos for msdos linefeed). Alias \-t
 
 .TP
-.B \-U [filename/wildcard]
+.B \-T [filename/wildcard \ (*.termsheet.rb)]
+standard form document builder, preprocessing feature
+
+.TP
+.B \-t [filename/wildcard]
+see \-\-txt
+
+.TP
+.B \-\-urls [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
+file system paths in sisurc.yml. Alias \-U
+
+.TP
+.B \-U [filename/wildcard]
+see \-\-urls
 
 .TP
 .B \-u [filename/wildcard]
@@ -398,6 +532,23 @@ provides url mapping of output files for the flags requested for processing,
 also see \-U
 
 .TP
+.B \-\-v1 [filename/wildcard]
+invokes the sisu v1 document parser/generator. For use with sisu v1 markup
+documents. (Markup conversion to v2 involves the modification of document
+headers)
+
+.TP
+.B \-\-v2 [filename/wildcard]
+invokes the sisu v2 document parser/generator. This is the default and is
+normally omitted.
+
+.TP
+.B \-\-verbose [filename/wildcard]
+provides verbose output of what is being generated, where output is placed
+(and error messages if any), as with \-u flag provides a url mapping of files
+created for each of the processing flag requests. Alias \-v
+
+.TP
 .B \-V
 on its own, provides
 .B SiSU
@@ -405,7 +556,7 @@ version and environment information (sisu \-\-help env)
 
 .TP
 .B \-V [filename/wildcard]
-even more verbose than the \-v flag. (also see \-M)
+even more verbose than the \-v flag.
 
 .TP
 .B \-v
@@ -415,31 +566,48 @@ version information
 
 .TP
 .B \-v [filename/wildcard]
-provides verbose output of what is being generated, where output is placed
-(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
+see \-\-verbose
 
 .TP
-.B \-W
+.B \-\-webrick
 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 \ ].
+\-H \ ; \ also, \ note \ \-F \ webrick \ ]. Alias \-W
+
+.TP
+.B \-W
+see \-\-webrick
+
+.TP
+.B \-\-wordmap [filename/wildcard]
+see \-\-concordance
 
 .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)
+see \-\-concordance
+
+.TP
+.B \-\-xhtml [filename/wildcard]
+produces xhtml/XML output for browser viewing (sax parsing). Alias \-b
+
+.TP
+.B \-\-xml\-dom [filename/wildcard]
+produces XML output with deep document structure, in the nature of dom. Alias
+\-X
+
+.TP
+.B \-\-xml\-sax [filename/wildcard]
+produces XML output shallow structure (sax parsing). Alias \-x
 
 .TP
 .B \-X [filename/wildcard]
-produces XML output with deep document structure, in the nature of dom.
+see \-\-xml\-dom
 
 .TP
 .B \-x [filename/wildcard]
-produces XML output shallow structure (sax parsing).
+see \-\-xml\-sax
 
 .TP
 .B \-Y [filename/wildcard]
@@ -454,24 +622,15 @@ document specific metadata (sisu_manifest.html). This step is assumed for most
 processing flags.
 
 .TP
-.B \-Z [filename/wildcard]
+.B \-\-zap [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]
+will remove the related document output directory. Alias \-Z
 
 .TP
-.B \-\-harvest *.ss[tm]
-makes two lists of sisu output based on the sisu markup documents in a
-directory: list of author and authors works (year and titles), and; list by
-topic with titles and author. Makes use of header metadata fields (author,
-title, date, topic_register). Can be used with maintenance (\-M) and remote
-placement (\-R) flags.
+.B \-Z [filename/wildcard]
+see \-\-zap
 
 .SH
 3. COMMAND LINE MODIFIERS
@@ -479,8 +638,9 @@ placement (\-R) flags.
 
 .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.
+[with \ \-\-html \ \-\-pdf \ or \ \-\-epub] switches off object citation
+numbering. Produce output without identifying numbers in margins of html or
+LaTeX/pdf output.
 
 .TP
 .B \-\-no\-annotate
@@ -507,7 +667,7 @@ dbi \- database interface
 \-d is modifiable with \-\-db=[database \ type \ (pgsql \ or \ sqlite)]
 
 .TP
-.B \-Dv \-\-createall
+.B \-\-pg \-v \-\-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 \
@@ -518,27 +678,27 @@ where database name would be SiSU_[present \ working \ directory \ name \
 (without \ path)]. Please use only alphanumerics and underscores.
 
 .TP
-.B \-Dv \-\-import
+.B \-\-pg \-v \-\-import
 [filename/wildcard] imports data specified to postgresql db (rb.dbi) [ \ \-dv
 \ \-\-import \ sqlite \ equivalent]
 
 .TP
-.B \-Dv \-\-update
+.B \-\-pg \-v \-\-update
 [filename/wildcard] updates/imports specified data to postgresql db (rb.dbi)
 [ \ \-dv \ \-\-update \ sqlite \ equivalent]
 
 .TP
-.B \-D \-\-remove
+.B \-\-pg \-\-remove
 [filename/wildcard] removes specified data to postgresql db (rb.dbi) [ \ \-d
 \ \-\-remove \ sqlite \ equivalent]
 
 .TP
-.B \-D \-\-dropall
+.B \-\-pg \-\-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.
+The \-v is for verbose output.
 
 .SH
 5. SHORTCUTS, SHORTHAND FOR MULTIPLE FLAGS
diff --git a/man/man1/sisu_termsheet.1 b/man/man1/sisu_termsheet.1
index cc0e37ec..4ec59279 100644
--- a/man/man1/sisu_termsheet.1
+++ b/man/man1/sisu_termsheet.1
@@ -27,7 +27,7 @@
 .SH Summary of man page
 .PP
 sisu_termsheet, is started with the command:
-.B sisu \-t
+.B sisu \-\-termsheet
 .I [termsheet\-name(s)]
 .\"%% Flags
 .SH DOCUMENT PROCESSING COMMAND FLAGS
diff --git a/man/man1/sisu_webrick.1 b/man/man1/sisu_webrick.1
index 858cb623..e139fb4c 100644
--- a/man/man1/sisu_webrick.1
+++ b/man/man1/sisu_webrick.1
@@ -33,6 +33,12 @@ sisu_webrick \ [port]
 or
 
 .BR
+sisu \-\-Webrick \ [port]
+
+.BR
+or
+
+.BR
 sisu \-W \ [port]
 
 .SH