v4: documentation, sisu_manual/sisu_commands, manpage & html

1 files changed, 49 insertions, 8 deletions

diff --git a/man/man1/sisu.1 b/man/man1/sisu.1
index 11c88a3d..f21808b1 100644
--- a/man/man1/sisu.1
+++ b/man/man1/sisu.1
@@ -1,4 +1,4 @@
-.TH "sisu" "1" "2013-02-03" "4.0.5" "SiSU"
+.TH "sisu" "1" "2013-02-07" "4.0.6" "SiSU"
 .br
 .SH NAME
 .br
@@ -437,9 +437,6 @@ see --color-off
 .B --keep-processing-files [filename/wildcard/url]
 see --maintenance
 .TP
-.B -L
-prints license information.
-.TP
 .B -M [filename/wildcard/url]
 see --maintenance
 .TP
@@ -492,13 +489,57 @@ see --po4a
 .B -p [filename/wildcard]
 see --pdf
 .TP
+.B --papersize-(a4|a5|b5|letter|legal)
+in conjunction with --pdf set pdf papersize, overriding any configuration
+settings, to set more than one papersize repeat the option --pdf --papersize-a4
+--papersize-letter. See also --papersize=*
+
+.BR
+
+.B --papersize=a4,a5,b5,letter,legal
+in conjunction with --pdf set pdf papersize, overriding any configuration
+settings, to set more than one papersize list after the equal sign with a comma
+separator --papersize=a4,letter. See also --papersize-*
+.TP
 .B --pdf [filename/wildcard]
 produces
 .I 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). Alias -p
+pdf (portrait.pdf & landscape.pdf). Orientation and papersize may be set on the
+command-line. 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), and; --landscape or --portrait, so: e.g. "sisu
+--pdf-a4 --pdf-letter --landscape --verbose [filename/wildcard]" or "sisu --pdf
+--landscape --a4 --letter --verbose [filename/wildcard]". --pdf defaults to
+both landscape & portrait output, and a4 if no other papersizes are configured.
+Related options --pdf-landscape --pdf-portrait --pdf-papersize-*
+--pdf-papersize=[list]. Alias -p
+.TP
+.B --pdf-l [filename/wildcard]
+See --pdf-landscape
+.TP
+.B --pdf-landscape [filename/wildcard]
+sets orientation, produces
+.I LaTeX
+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). Related options --pdf --pdf-portrait. See also
+--papersize-* or --papersize=[list]. Alias --pdf-l or in conjunction with --pdf
+--landscape
+.TP
+.B --pdf-p [filename/wildcard]
+See --pdf-portrait
+.TP
+.B --pdf-portrait [filename/wildcard]
+sets orientation, produces
+.I LaTeX
+pdf portrait.pdf.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). Related options --pdf --pdf-landscape. See also
+--papersize-* or --papersize=[list]. Alias --pdf-p or in conjunction with --pdf
+--portrait
 .TP
 .B --pg [instruction] [filename]
 database