new build system: more preparation

git-svn-id: svn://tug.org/texlive/trunk@12432 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 69 insertions, 56 deletions

diff --git a/Build/source/texk/dviljk/dvilj.man b/Build/source/texk/dviljk/dvilj.man
index 7edcf5f8836..acb729ddb55 100644
--- a/Build/source/texk/dviljk/dvilj.man
+++ b/Build/source/texk/dviljk/dvilj.man
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
+.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
@@ -25,11 +25,11 @@
 ..
 .\" Set up some character translations and predefined strings.  \*(-- will
 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  | will give a
-.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
-.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
-.\" expand to `' in nroff, nothing in troff, for use with C<>.
-.tr \(*W-|\(bv\*(Tr
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 .ie n \{\
 .    ds -- \(*W-
@@ -48,22 +48,25 @@
 .    ds R" ''
 'br\}
 .\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
 .\" If the F register is turned on, we'll generate index entries on stderr for
 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
 .\" entries marked with X<> in POD.  Of course, you'll have to process the
 .\" output yourself in some meaningful fashion.
-.if \nF \{\
+.ie \nF \{\
 .    de IX
 .    tm Index:\\$1\t\\n%\t"\\$2"
 ..
 .    nr % 0
 .    rr F
 .\}
-.\"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
-.\" way too many mistakes in technical documents.
-.hy 0
-.if n .na
+.el \{\
+.    de IX
+..
+.\}
 .\"
 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
@@ -129,16 +132,20 @@
 .\" ========================================================================
 .\"
 .IX Title "DVILJ 1"
-.TH DVILJ 1 "2007-07-05" "Version 2.6p4" "TeX-Live"
+.TH DVILJ 1 "2007-07-05" "Version 2.6p5" "TeX-Live"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
 .SH "NAME"
 dvilj4, dvilj4l, dvilj2p, dvilj \- convert a TeX DVI file to PCL, for HP LaserJet printers
 .SH "SYNOPSIS"
 .IX Header "SYNOPSIS"
 .Vb 4
-\& dvilj [--Dnumber] [-ccopies] [-dmode] [-D] [-E] [-eoutputfile]
-\&       [-ffrompage] [-g] [-hheaderfile] [-l] [-Mflag] [-mmag] [-ppages]
-\&       [-q] [-r] [-ttopage] [-spagesize] [-v] [-Vmode] [-w] [-xxoff(mm)]
-\&       [-yyoff(mm)] [-Xxoff(dots)] [-Yyoff(dots)] [-z] [filename]
+\& dvilj [\-\-Dnumber] [\-ccopies] [\-dmode] [\-D] [\-E] [\-eoutputfile]
+\&       [\-ffrompage] [\-g] [\-hheaderfile] [\-l] [\-Mflag] [\-mmag] [\-ppages]
+\&       [\-q] [\-r] [\-ttopage] [\-spagesize] [\-v] [\-Vmode] [\-w] [\-xxoff(mm)]
+\&       [\-yyoff(mm)] [\-Xxoff(dots)] [\-Yyoff(dots)] [\-z] [filename]
 .Ve
 .SH "DESCRIPTION"
 .IX Header "DESCRIPTION"
@@ -202,21 +209,21 @@ Print output in landscape mode; supported only by \fBdvilj2p\fR and
 Do (not) call \fImktexpk\fR\|(1) to generate fonts on demand. \fB\-M1\fR and \fB\-M\fR
 are equivalent. \fB\-M0\fR enables invoking \fImktexpk\fR\|(1). (This is the same
 as in \fIdvips\fR\|(1).) The default behavior (i.e., if no \fB\-M\fR option is
-given) is chosen at compile\-time; as distributed, mktexpk is enabled.
+given) is chosen at compile-time; as distributed, mktexpk is enabled.
 .IP "\fB\-m\fR\fImagnification\fR" 4
 .IX Item "-mmagnification"
 Specify the magnification to use. The following are available:
 .Sp
 .Vb 9
-\&  -m#usermag e.g., #900
-\&  -m0 equivalent to -m#1000
-\&  -mh equivalent to -m#1095
-\&  -m1 equivalent to -m#1200
-\&  -mq equivalent to -m#1250
-\&  -m2 equivalent to -m#1440
-\&  -m3 equivalent to -m#1728
-\&  -m4 equivalent to -m#2074
-\&  -m5 equivalent to -m#2488
+\&  \-m#usermag e.g., #900
+\&  \-m0 equivalent to \-m#1000
+\&  \-mh equivalent to \-m#1095
+\&  \-m1 equivalent to \-m#1200
+\&  \-mq equivalent to \-m#1250
+\&  \-m2 equivalent to \-m#1440
+\&  \-m3 equivalent to \-m#1728
+\&  \-m4 equivalent to \-m#2074
+\&  \-m5 equivalent to \-m#2488
 .Ve
 .IP "\fB\-p\fR\fIpagecount\fR" 4
 .IX Item "-ppagecount"
@@ -231,23 +238,23 @@ Toggle page reversal.
 .IX Item "-spagesize"
 Specify the page size:
 .Sp
-.Vb 16
-\&  -s1: Executive (7.25" x 10.5")
-\&  -s2: Letter (8.5" x 11")
-\&  -s3: Legal (8.5" x 14")
-\&  -s6: Ledger (11" x 17")
-\&  -s25: A5 paper (148mm x 210mm)
-\&  -s26: A4 paper (210mm x 297mm)
-\&  -s27: A3 (297mm x 420mm)
-\&  -s45: JIS B5 paper (182mm x 257mm)
-\&  -s46: JIS B4 paper (250mm x 354mm)
-\&  -s71: Hagaki postcard (100mm x 148mm)
-\&  -s72: Oufuku-Hagaki postcard (200mm x 148mm)
-\&  -s80: Monarch Envelope (3 7/8" x 7 1/2")
-\&  -s81: Commercial Envelope 10 (4 1/8" x 9 1/2")
-\&  -s90: International DL (110mm x 220mm)
-\&  -s91: International C5 (162mm x 229mm)
-\&  -s100: International B5 (176mm x 250mm)
+.Vb 10
+\&  \-s1: Executive (7.25" x 10.5")
+\&  \-s2: Letter (8.5" x 11")
+\&  \-s3: Legal (8.5" x 14")
+\&  \-s6: Ledger (11" x 17")
+\&  \-s25: A5 paper (148mm x 210mm)
+\&  \-s26: A4 paper (210mm x 297mm)
+\&  \-s27: A3 (297mm x 420mm)
+\&  \-s45: JIS B5 paper (182mm x 257mm)
+\&  \-s46: JIS B4 paper (250mm x 354mm)
+\&  \-s71: Hagaki postcard (100mm x 148mm)
+\&  \-s72: Oufuku\-Hagaki postcard (200mm x 148mm)
+\&  \-s80: Monarch Envelope (3 7/8" x 7 1/2")
+\&  \-s81: Commercial Envelope 10 (4 1/8" x 9 1/2")
+\&  \-s90: International DL (110mm x 220mm)
+\&  \-s91: International C5 (162mm x 229mm)
+\&  \-s100: International B5 (176mm x 250mm)
 .Ve
 .Sp
 These values are from the \s-1PCL\s0 5 technical reference manual. If the
@@ -307,7 +314,7 @@ remember that thhe \s-1DVI\s0 file must be seekable, even if it's stdin.)
 .PP
 .Vb 2
 \&  \especial{key1=value key1="value with space"}
-\&  \especial{key3 = value key4 = 'note optional spaces around equal sign'}
+\&  \especial{key3 = value key4 = \*(Aqnote optional spaces around equal sign\*(Aq}
 .Ve
 .PP
 I.e., specials are a sequence of key/value pairs, separated by an
@@ -452,13 +459,13 @@ fine-grained as the value range 0..100 might make you believe. In
 reality, there are only 8 different gray patterns available:
 .Sp
 .Vb 8
-\&   1 -  2%
-\&   3 - 10%
-\&  11 - 20%
-\&  21 - 35%
-\&  36 - 55%
-\&  56 - 80%
-\&  81 - 99%
+\&   1 \-  2%
+\&   3 \- 10%
+\&  11 \- 20%
+\&  21 \- 35%
+\&  36 \- 55%
+\&  56 \- 80%
+\&  81 \- 99%
 \&  100%
 .Ve
 .Sp
@@ -546,7 +553,7 @@ used for even pages. A trailing \f(CW\*(C`\-\*(C'\fR (as in \fB\-D\-\fR, \fB\-D1
 padding otherwise.
 .PP
 The driver allows the \fB\-D\fR option for both print-directions
-(front\-to\-back or back-to-front printing). It tries to be clever in
+(front-to-back or back-to-front printing). It tries to be clever in
 certain cases: when a document has an odd number of pages it inserts
 in the right place an empty page when a document starts with page 0
 the driver inserts an empty page after the 0\-page when a piece of a
@@ -559,7 +566,7 @@ The doubleside option works for all LJs, not only for the new D model
 with does doubleside-printing (actually, I don't know whether it makes
 much sense on the new \s-1LJ\s0 \s-1II\s0 D at all).
 .PP
-Caveat on the doubleside\-option: When it is used frequently or on very
+Caveat on the doubleside-option: When it is used frequently or on very
 large files, it might become necessary to clean the printer much more
 frequently.
 .PP
@@ -671,12 +678,18 @@ sequences are supported on which \s-1HP\s0 printers.
 .IX Header "AUTHOR"
 dvi2xx by Gustaf Neumann <neumann@wu\-wien.ac.at>,
 Wirtschaftsuniversitaet Wien
-.Sp
+.PP
 dviljk fork by kb@mail.tug.org
-.Sp
+.PP
 Joachim Schrod <jschrod@acm.org> supplied security fixes and updated
 this man page.
 .SH "LICENSE"
 .IX Header "LICENSE"
 dvi2xx is public domain software. dviljk changes are covered by the
 \&\s-1GNU\s0 General Public License.
+.SH "POD ERRORS"
+.IX Header "POD ERRORS"
+Hey! \fBThe above document had some coding errors, which are explained below:\fR
+.IP "Around line 595:" 4
+.IX Item "Around line 595:"
+You forgot a '=back' before '=head1'