aboutsummaryrefslogtreecommitdiffhomepage
path: root/data/doc/sisu/html/sisu.1.html
diff options
context:
space:
mode:
Diffstat (limited to 'data/doc/sisu/html/sisu.1.html')
-rw-r--r--data/doc/sisu/html/sisu.1.html432
1 files changed, 211 insertions, 221 deletions
diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html
index f7268daa..2063c021 100644
--- a/data/doc/sisu/html/sisu.1.html
+++ b/data/doc/sisu/html/sisu.1.html
@@ -255,47 +255,46 @@ To skip it see -n. Alias -m </dd>
<dt><b>--dump[=directory_path]
[filename/wildcard]</b> </dt>
<dd>places output in directory specified, if none is specified
-in the current directory (pwd). Compare --redirect </dd>
+in the current directory (pwd). Unlike using default settings <i>HTML</i> files
+have embedded css. Compare --redirect </dd>
<dt><b>-e [filename/wildcard]</b> </dt>
-<dd>see
---epub </dd>
+<dd>see --epub </dd>
-<dt><b>--epub [filename/wildcard]</b> </dt>
-<dd>produces an epub document, [sisu version
-&gt;=2 ] (filename.epub). Alias -e </dd>
+<dt><b>--epub
+[filename/wildcard]</b> </dt>
+<dd>produces an epub document, [sisu version &gt;=2 ] (filename.epub).
+Alias -e </dd>
<dt><b>--exc-*</b> </dt>
-<dd>exclude output feature, overrides configuration
-settings --exc-ocn, (exclude <i>object</i> citation numbering, (switches off <i>object</i>
-citation numbering ) , affects html (seg, scroll), epub, xhtml, xml, pdf)
-; --exc-toc, (exclude table of contents, affects html (scroll), epub, pdf)
-; --exc-links-to-manifest, --exc-manifest-links, (exclude links to manifest, affects
-html (seg, scroll)); --exc-search-form, (exclude search form, affects html
-(seg, scroll), manifest); --exc-minitoc, (exclude mini table of contents,
-affects html (seg), concordance, manifest); --exc-manifest-minitoc, (exclude
-mini table of contents, affects manifest); --exc-html-minitoc, (exclude mini
-table of contents, affects html (seg), concordance); --exc-html-navigation,
-(exclude navigation, affects html (seg)); --exc-html-navigation-bar, (exclude
-navigation bar, affects html (seg)); --exc-html-search-form, (exclude search
-form, affects html (seg, scroll)); --exc-html-right-pane, (exclude right pane/column,
-affects html (seg, scroll)); --exc-html-top-band, (exclude top band, affects
-html (seg, scroll), concordance (minitoc forced on to provide seg navigation));
---exc-segsubtoc (exclude sub table of contents, affects html (seg), epub)
-; see also --inc-* </dd>
+<dd>exclude output feature, overrides configuration settings --exc-ocn,
+(exclude <i>object</i> citation numbering, (switches off <i>object</i> citation numbering
+) , affects html (seg, scroll), epub, xhtml, xml, pdf) ; --exc-toc, (exclude
+table of contents, affects html (scroll), epub, pdf) ; --exc-links-to-manifest,
+--exc-manifest-links, (exclude links to manifest, affects html (seg, scroll));
+--exc-search-form, (exclude search form, affects html (seg, scroll), manifest);
+--exc-minitoc, (exclude mini table of contents, affects html (seg), concordance,
+manifest); --exc-manifest-minitoc, (exclude mini table of contents, affects
+manifest); --exc-html-minitoc, (exclude mini table of contents, affects html
+(seg), concordance); --exc-html-navigation, (exclude navigation, affects html
+(seg)); --exc-html-navigation-bar, (exclude navigation bar, affects html (seg));
+--exc-html-search-form, (exclude search form, affects html (seg, scroll)); --exc-html-right-pane,
+(exclude right pane/column, affects html (seg, scroll)); --exc-html-top-band,
+(exclude top band, affects html (seg, scroll), concordance (minitoc forced
+on to provide seg navigation)); --exc-segsubtoc (exclude sub table of contents,
+affects html (seg), epub) ; see also --inc-* </dd>
<dt><b>-F [--webserv=webrick]</b> </dt>
<dd>see --sample-search-form </dd>
-<dt><b>-f [optional string
-part of filename]</b> </dt>
+<dt><b>-f [optional string part of filename]</b> </dt>
<dd>see --find </dd>
<dt><b>--find [optional string part of filename]</b> </dt>
-<dd>without
-match string, glob all .sst .ssm files in directory (including language subdirectories).
-With match string, find files that match given string in directory (including
-language subdirectories). Alias -f, --glob, -G </dd>
+<dd>without match string, glob all .sst .ssm files in directory
+(including language subdirectories). With match string, find files that
+match given string in directory (including language subdirectories). Alias
+-f, --glob, -G </dd>
<dt><b>-G [optional string part of filename]</b>
</dt>
@@ -305,193 +304,192 @@ language subdirectories). Alias -f, --glob, -G </dd>
<dd>see --git </dd>
<dt><b>--git [filename/wildcard]</b> </dt>
-<dd>produces
-or updates markup source file structure in a git repo (experimental and
-subject to change). Alias -g </dd>
+<dd>produces or updates markup source file
+structure in a git repo (experimental and subject to change). Alias -g </dd>
-<dt><b>--glob [optional string part of filename]</b> </dt>
-<dd>see
---find </dd>
+<dt><b>--glob
+[optional string part of filename]</b> </dt>
+<dd>see --find</dd>
<dt><b>-h [filename/wildcard]</b> </dt>
<dd>see --html </dd>
<dt><b>--harvest *.ss[tm]</b> </dt>
-<dd>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. </dd>
+<dd>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. </dd>
+
+<dt><b>--help [topic]</b> </dt>
+<dd>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. </dd>
+
+<dt><b>--html [filename/wildcard]</b> </dt>
+<dd>produces html output, in two forms (i)
+segmented text with table of contents (toc.html and index.html) and (ii)
+the document in a single file (scroll.html). Alias -h </dd>
-<dt><b>--help [topic]</b>
+<dt><b>--html-scroll [filename/wildcard]</b>
</dt>
-<dd>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. </dd>
+<dd>produces html output, the document in a single file (scroll.html) only. Compare
+--html-seg and --html </dd>
-<dt><b>--html [filename/wildcard]</b> </dt>
+<dt><b>--html-seg [filename/wildcard]</b> </dt>
<dd>produces html output, segmented
-text with table of contents (toc.html and index.html) and the document in
-a single file (scroll.html). Alias -h </dd>
+text with table of contents (toc.html and index.html). Compare --html-scroll
+and --html </dd>
<dt><b>-I [filename/wildcard]</b> </dt>
<dd>see --texinfo </dd>
-<dt><b>-i
-[filename/wildcard]</b> </dt>
-<dd>see --manpage </dd>
+<dt><b>-i [filename/wildcard]</b> </dt>
+<dd>see --manpage</dd>
<dt><b>--inc-*</b> </dt>
-<dd>include output feature, overrides
-configuration settings, (usually the default if none set), has precedence
-over --exc-* (exclude output feature). Some detail provided under --exc-*, see
---exc-* </dd>
+<dd>include output feature, overrides configuration settings, (usually
+the default if none set), has precedence over --exc-* (exclude output feature).
+Some detail provided under --exc-*, see --exc-* </dd>
<dt><b>-j [filename/wildcard]</b> </dt>
-<dd>copies images associated with a file for use
-by html, xhtml &amp; xml outputs (automatically invoked by --dump &amp; redirect). </dd>
+<dd>copies images associated with a file for use by html, xhtml &amp; xml outputs (automatically
+invoked by --dump &amp; redirect). </dd>
-<dt><b>-k</b>
-</dt>
+<dt><b>-k</b> </dt>
<dd>see --color-off </dd>
<dt><b>--keep-processing-files [filename/wildcard/url]</b> </dt>
-<dd>see --maintenance
-</dd>
+<dd>see --maintenance </dd>
<dt><b>-L</b> </dt>
<dd>prints license information. </dd>
<dt><b>-M [filename/wildcard/url]</b> </dt>
-<dd>see --maintenance
-</dd>
+<dd>see --maintenance </dd>
<dt><b>-m [filename/wildcard/url]</b> </dt>
<dd>see --dal (document abstraction level/layer) </dd>
-<dt><b>--machine
-[filename/wildcard/url]</b> </dt>
-<dd>see --dal (document abstraction level/layer) </dd>
+<dt><b>--machine [filename/wildcard/url]</b> </dt>
+<dd>see --dal (document abstraction
+level/layer) </dd>
-<dt><b>--maintenance
-[filename/wildcard/url]</b> </dt>
-<dd>maintenance mode, interim processing files are
-preserved and their locations indicated. (also see -V). Aliases -M and --keep-processing-files.
-</dd>
+<dt><b>--maintenance [filename/wildcard/url]</b> </dt>
+<dd>maintenance mode, interim
+processing files are preserved and their locations indicated. (also see
+-V). Aliases -M and --keep-processing-files. </dd>
<dt><b>--manpage [filename/wildcard]</b> </dt>
-<dd>produces man page of file, not suitable for
-all outputs. Alias -i </dd>
+<dd>produces
+man page of file, not suitable for all outputs. Alias -i </dd>
<dt><b>-N [filename/wildcard/url]</b> </dt>
-<dd>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. </dd>
-
-<dt><b>-n [filename/wildcard/url]</b> </dt>
-<dd>skip the
-creation of intermediate processing files (document abstraction) if they
-already exist, this skips the equivalent of -m which is otherwise assumed
-by most processing flags. </dd>
+<dd>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. </dd>
+
+<dt><b>-n
+[filename/wildcard/url]</b> </dt>
+<dd>skip the creation of intermediate processing files
+(document abstraction) if they already exist, this skips the equivalent
+of -m which is otherwise assumed by most processing flags. </dd>
<dt><b>--no-*</b> </dt>
<dd>see --exc-* </dd>
-<dt><b>-o [filename/wildcard/url]</b> </dt>
-<dd>see --odt
-</dd>
+<dt><b>-o
+[filename/wildcard/url]</b> </dt>
+<dd>see --odt </dd>
<dt><b>--odf [filename/wildcard/url]</b> </dt>
<dd>see --odt </dd>
-<dt><b>--odt [filename/wildcard/url]</b> </dt>
-<dd>output
-basic document in opendocument file format (opendocument.odt). Alias -o </dd>
+<dt><b>--odt
+[filename/wildcard/url]</b> </dt>
+<dd>output basic document in opendocument file format
+(opendocument.odt). Alias -o </dd>
-<dt><b>--output-by-*</b>
-</dt>
-<dd>select output directory structure from 3 alternatives: --output-by-language,
-(language directory (based on language code) with filetype (html, epub,
-pdf etc.) subdirectories); --output-by-filetype, (filetype directories with
-language code as part of filename); --output-by-filename, (filename directories
-with language code as part of filename). This is configurable. Alias --by-*
-</dd>
+<dt><b>--output-by-*</b> </dt>
+<dd>select output directory structure from
+3 alternatives: --output-by-language, (language directory (based on language
+code) with filetype (html, epub, pdf etc.) subdirectories); --output-by-filetype,
+(filetype directories with language code as part of filename); --output-by-filename,
+(filename directories with language code as part of filename). This is configurable.
+Alias --by-* </dd>
<dt><b>-P [language_directory/filename language_directory]</b> </dt>
<dd>see --po4a </dd>
-<dt><b>-p [filename/wildcard]</b>
-</dt>
+<dt><b>-p
+[filename/wildcard]</b> </dt>
<dd>see --pdf </dd>
<dt><b>--pdf [filename/wildcard]</b> </dt>
-<dd>produces <i>LaTeX</i> pdf (portrait.pdf &amp; 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:
-&rsquo;A4&rsquo;, U.S. &rsquo;letter&rsquo; and &rsquo;legal&rsquo; and book sizes &rsquo;A5&rsquo; and &rsquo;B5&rsquo; (system defaults to A4).
-Alias -p </dd>
+<dd>produces <i>LaTeX</i> pdf
+(portrait.pdf &amp; 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: &rsquo;A4&rsquo;, U.S. &rsquo;letter&rsquo; and &rsquo;legal&rsquo; and book sizes
+&rsquo;A5&rsquo; and &rsquo;B5&rsquo; (system defaults to A4). Alias -p </dd>
<dt><b>--pg [instruction] [filename]</b> </dt>
-<dd>database <i>PostgreSQL</i> ( --pgsql may be
-used instead) possible instructions, include: --createdb; --create; --dropall;
---import [filename]; --update [filename]; --remove [filename]; see database section
-below. Alias -D </dd>
+<dd>database
+<i>PostgreSQL</i> ( --pgsql may be used instead) possible instructions, include:
+--createdb; --create; --dropall; --import [filename]; --update [filename]; --remove
+[filename]; see database section below. Alias -D </dd>
-<dt><b>--po [language_directory/filename language_directory]</b> </dt>
-<dd>see --po4a
-</dd>
+<dt><b>--po [language_directory/filename
+language_directory]</b> </dt>
+<dd>see --po4a </dd>
<dt><b>--po4a [language_directory/filename language_directory]</b> </dt>
-<dd>produces .pot and
-po files for the file in the languages specified by the language directory.
-<b>SiSU</b> markup is placed in subdirectories named with the language code, e.g.
-en/ fr/ es/. The sisu config file must set the output directory structure
-to multilingual. v3, experimental </dd>
+<dd>produces .pot and po files for the file in the languages specified by the
+language directory. <b>SiSU</b> markup is placed in subdirectories named with the
+language code, e.g. en/ fr/ es/. The sisu config file must set the output
+directory structure to multilingual. v3, experimental </dd>
-<dt><b>-Q [filename/wildcard]</b> </dt>
+<dt><b>-Q [filename/wildcard]</b>
+</dt>
<dd>see --qrcode </dd>
-<dt><b>-q [filename/wildcard]</b>
-</dt>
+<dt><b>-q [filename/wildcard]</b> </dt>
<dd>see --quiet </dd>
<dt><b>--qrcode [filename/wildcard]</b> </dt>
-<dd>generate QR code image of metadata
-(used in manifest). v3 only. </dd>
+<dd>generate
+QR code image of metadata (used in manifest). v3 only. </dd>
<dt><b>--quiet [filename/wildcard]</b> </dt>
-<dd>quiet less output
-to screen. </dd>
+<dd>quiet less output to screen. </dd>
<dt><b>-R [filename/wildcard]</b> </dt>
<dd>see --rsync </dd>
<dt><b>-r [filename/wildcard]</b> </dt>
-<dd>see --scp
-</dd>
+<dd>see --scp </dd>
<dt><b>--redirect[=directory_path] [filename/wildcard]</b> </dt>
-<dd>places output in subdirectory
-under specified directory, subdirectory uses the filename (without the
-suffix). If no output directory is specified places the subdirectory under
-the current directory (pwd). Compare --dump </dd>
+<dd>places output in
+subdirectory under specified directory, subdirectory uses the filename
+(without the suffix). If no output directory is specified places the subdirectory
+under the current directory (pwd). Unlike using default settings <i>HTML</i> files
+have embedded css. Compare --dump </dd>
<dt><b>--rsync [filename/wildcard]</b> </dt>
-<dd>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 --scp. Alias -R </dd>
+<dd>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 --scp. Alias -R </dd>
<dt><b>-S</b> </dt>
-<dd>see --sisupod
-</dd>
+<dd>see --sisupod </dd>
<dt><b>-S [filename/wildcard]</b> </dt>
<dd>see --sisupod </dd>
@@ -499,110 +497,102 @@ used together with other flags, it is not). Also see --scp. Alias -R </dd>
<dt><b>-s [filename/wildcard]</b> </dt>
<dd>see --source </dd>
-<dt><b>--sample-search-form
-[--webserv=webrick]</b> </dt>
-<dd>generate examples of (naive) cgi search form for <i>SQLite</i>
-and PgSQL depends on your already having used sisu to populate an <i>SQLite</i>
-and/or PgSQL database, (the <i>SQLite</i> 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). Alias -F </dd>
+<dt><b>--sample-search-form [--webserv=webrick]</b> </dt>
+<dd>generate examples of (naive) cgi search form for <i>SQLite</i> and PgSQL depends
+on your already having used sisu to populate an <i>SQLite</i> and/or PgSQL database,
+(the <i>SQLite</i> 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). Alias -F </dd>
<dt><b>--scp [filename/wildcard]</b> </dt>
-<dd>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 --rsync. Alias -r </dd>
-
-<dt><b>--sqlite --[instruction] [filename]</b>
-</dt>
-<dd>database type set to <i>SQLite,</i> this produces one of two possible databases,
-without additional database related instructions it produces a discreet
-<i>SQLite</i> file for the document processed; with additional instructions it
-produces a common <i>SQLite</i> database of all processed documents that (come
-from the same document preparation directory and as a result) share the
-same output directory base path (possible instructions include: --createdb;
---create; --dropall; --import [filename]; --update [filename]; --remove [filename]);
-see database section below. Alias -d </dd>
+<dd>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 --rsync. Alias -r </dd>
+
+<dt><b>--sqlite --[instruction] [filename]</b> </dt>
+<dd>database type set to
+<i>SQLite,</i> this produces one of two possible databases, without additional
+database related instructions it produces a discreet <i>SQLite</i> file for the
+document processed; with additional instructions it produces a common <i>SQLite</i>
+database of all processed documents that (come from the same document preparation
+directory and as a result) share the same output directory base path (possible
+instructions include: --createdb; --create; --dropall; --import [filename]; --update
+[filename]; --remove [filename]); see database section below. Alias -d </dd>
<dt><b>--sisupod</b> </dt>
-<dd>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 is tested only
-with zsh). Alias -S </dd>
+<dd>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 is tested only with zsh). Alias -S </dd>
<dt><b>--sisupod [filename/wildcard]</b> </dt>
-<dd>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</b> 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].
-Alias -S </dd>
+<dd>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</b> 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]. Alias -S </dd>
<dt><b>--source [filename/wildcard]</b> </dt>
-<dd>copies sisu markup file to output directory.
-Alias -s </dd>
+<dd>copies sisu markup file to output directory. Alias -s </dd>
<dt><b>-T [filename/wildcard (*.termsheet.rb)]</b> </dt>
-<dd>standard form document builder,
-preprocessing feature </dd>
+<dd>standard form document builder, preprocessing feature </dd>
<dt><b>-t [filename/wildcard]</b> </dt>
<dd>see --txt </dd>
-<dt><b>--texinfo [filename/wildcard]</b>
-</dt>
-<dd>produces texinfo and info file, (view with pinfo). Alias -I </dd>
+<dt><b>--texinfo [filename/wildcard]</b> </dt>
+<dd>produces texinfo and info file, (view with
+pinfo). Alias -I </dd>
-<dt><b>--txt [filename/wildcard]</b>
-</dt>
-<dd>produces <i>plaintext</i> 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). Alias
--t </dd>
+<dt><b>--txt [filename/wildcard]</b> </dt>
+<dd>produces <i>plaintext</i> 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). Alias -t </dd>
<dt><b>-U [filename/wildcard]</b> </dt>
<dd>see --urls </dd>
<dt><b>-u [filename/wildcard]</b> </dt>
-<dd>provides url mapping
-of output files for the flags requested for processing, also see -U </dd>
-
-<dt><b>--urls
-[filename/wildcard]</b> </dt>
-<dd>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. Alias -U </dd>
+<dd>provides url mapping of output files for the flags
+requested for processing, also see -U </dd>
+
+<dt><b>--urls [filename/wildcard]</b> </dt>
+<dd>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. Alias -U </dd>
<dt><b>-V</b> </dt>
-<dd>on its own,
-provides <b>SiSU</b> version and environment information (sisu --help env) </dd>
+<dd>on its own, provides <b>SiSU</b> version
+and environment information (sisu --help env) </dd>
-<dt><b>-V [filename/wildcard]</b>
-</dt>
+<dt><b>-V [filename/wildcard]</b> </dt>
<dd>even more verbose than the -v flag. </dd>
<dt><b>-v</b> </dt>