From 9dffba29dd1000452563204e4e6887df1d5bb2c9 Mon Sep 17 00:00:00 2001
From: Ralph Amissah <ralph@amissah.com>
Date: Tue, 30 Jul 2013 21:36:53 -0400
Subject: v5: output structure by, monolingual alternative, documentation

---
 man/man1/sisu.1 | 41 +++++++++++++++++++++++++++++------------
 1 file changed, 29 insertions(+), 12 deletions(-)

(limited to 'man')

diff --git a/man/man1/sisu.1 b/man/man1/sisu.1
index 2bafb76b..8292187d 100644
--- a/man/man1/sisu.1
+++ b/man/man1/sisu.1
@@ -1,4 +1,4 @@
-.TH "sisu" "1" "2013-02-22" "4.0.9" "SiSU"
+.TH "sisu" "1" "2013-07-25" "4.1.8" "SiSU"
 .br
 .SH NAME
 .br
@@ -422,6 +422,13 @@ see --texinfo
 .B -i [filename/wildcard]
 see --manpage
 .TP
+.B --i18n-*
+these flags affect output by filetype and filename): --i18n-mono
+(--monolingual) output filenames without language code for default language
+('en' or as set); --i18n-multi (--multilingual) language code provided as part
+of the output filename, this is the default. Where output is in one language
+only the language code may not be desired. see also --output-by-* (v5)
+.TP
 .B --inc-*
 include output feature, overrides configuration settings, (usually the default
 if none set), has precedence over --exc-* (exclude output feature). Some detail
@@ -453,6 +460,12 @@ indicated. (also see -V). Aliases -M and --keep-processing-files.
 .B --manpage [filename/wildcard]
 produces man page of file, not suitable for all outputs. Alias -i
 .TP
+.B --monolingual
+see --i18n-*
+.TP
+.B --multilingual
+see --i18n-*
+.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
@@ -927,7 +940,7 @@ The most up to date information on sisu should be contained in the sisu_manual,
 available at:
 
 .BR
-  <http://sisudoc.org/sisu/sisu_manual/>
+<http://sisudoc.org/sisu/sisu_manual/>
 
 .BR
 The manual can be generated from source, found respectively, either within the
@@ -935,16 +948,16 @@ The manual can be generated from source, found respectively, either within the
 tarball or installed locally at:
 
 .BR
-  ./data/doc/sisu/markup-samples/sisu_manual
+\./data/doc/sisu/markup-samples/sisu_manual
 
 .BR
-  /usr/share/doc/sisu/markup-samples/sisu_manual
+/usr/share/doc/sisu/markup-samples/sisu_manual
 
 .BR
 move to the respective directory and type e.g.:
 
 .BR
-  sisu sisu_manual.ssm
+sisu sisu_manual.ssm
 
 .SH SISU MAN PAGES
 
@@ -954,7 +967,7 @@ If
 is installed on your system usual man commands should be available, try:
 
 .BR
-  man sisu
+man sisu
 
 .BR
 Most
@@ -1512,7 +1525,9 @@ in each case level may be 0-9
 
 .BR
 .B live-build
-  A collection of scripts used to build customized Debian
+  A collection of scripts used to build customized
+.B Debian
+
   Livesystems.
   .I live-build
   was formerly known as live-helper, and even earlier known as live-package.
@@ -1520,9 +1535,12 @@ in each case level may be 0-9
 .BR
 .B live-build
 
-  A collection of scripts used to build customized Debian
-  Livesystems. live-build was formerly known as live-helper, and even earlier
-  known as live-package.
+  A collection of scripts used to build customized
+.B Debian
+  Livesystems.
+.I live-build
+  was formerly known as live-helper, and even earlier known as live-package.
+
 .SH FOOTNOTES / ENDNOTES
 
 .BR
@@ -1837,8 +1855,7 @@ information in each column
 
 .BR
 .B markup example:
-[^18]
-
+[^17]
 .nf
 !_ Table 3.1: Contributors to Wikipedia, January 2001 - June 2005
 
-- 
cgit v1.2.3