summaryrefslogtreecommitdiff
path: root/dviware/dviljk/dvilj.man
diff options
context:
space:
mode:
Diffstat (limited to 'dviware/dviljk/dvilj.man')
-rw-r--r--dviware/dviljk/dvilj.man66
1 files changed, 34 insertions, 32 deletions
diff --git a/dviware/dviljk/dvilj.man b/dviware/dviljk/dvilj.man
index 33bed66f02..3a44d9d554 100644
--- a/dviware/dviljk/dvilj.man
+++ b/dviware/dviljk/dvilj.man
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
+.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -46,7 +46,7 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
@@ -56,12 +56,12 @@
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
-.if (\n(rF:(\n(.g==0)) \{
-. if \nF \{
+.if (\n(rF:(\n(.g==0)) \{\
+. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
-. if !\nF==2 \{
+. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "DVILJ 1"
-.TH DVILJ 1 "2012-03-12" "Version 2.6p5" "TeX-Live"
+.TH DVILJ 1 "2022-08-30" "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
@@ -150,25 +150,25 @@ dvilj4, dvilj4l, dvilj2p, dvilj \- convert a TeX DVI file to PCL, for HP LaserJe
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
-\&\fBdvilj\fR and siblings convert TeX-output \f(CW\*(C`.dvi\*(C'\fR files into \s-1PCL \s0(the
+\&\fBdvilj\fR and siblings convert TeX-output \f(CW\*(C`.dvi\*(C'\fR files into \s-1PCL\s0 (the
Hewlett-Packard Printer Control Language) commands suitable for
-printing on a \s-1HP\s0 LaserJet+, \s-1HP\s0 LaserJet \s-1IIP \s0(using \fBdvilj2p\fR), \s-1HP\s0
+printing on a \s-1HP\s0 LaserJet+, \s-1HP\s0 LaserJet \s-1IIP\s0 (using \fBdvilj2p\fR), \s-1HP\s0
LaserJet 4 (using \fBdvilj4\fR), and fully compatible printers.
.PP
\&\fBdvilj4\fR also provides support for the builtin Intellifont and
TrueType fonts; \s-1TFM\s0 and \s-1VF\s0 files are provided in the distribution.
Virtual fonts are not supported directly by \fBdvilj\fR, so you must run
-\&\fIdvicopy\fR\|(1) first, or otherwise expand the virtual fonts
+\&\fBdvicopy\fR\|(1) first, or otherwise expand the virtual fonts
.PP
All programs are generated from one source file \fIdvi2xx.c\fR. They are
usually called via a shell script or as a line printer filter. One
-such script, \fIdvihp\fR\|(1), is included in the distribution. It provides
-command-line options similar to those of \fIdvips\fR\|(1).
+such script, \fBdvihp\fR\|(1), is included in the distribution. It provides
+command-line options similar to those of \fBdvips\fR\|(1).
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-D\fR\fInumber\fR" 4
.IX Item "--Dnumber"
-Debug according to the bits of \fInumber\fR; see the \fIkpathsea\fR\|(3) manual
+Debug according to the bits of \fInumber\fR; see the \fBkpathsea\fR\|(3) manual
for values. Also turns on general verbosity.
.IP "\fB\-c\fR\fInumber\fR" 4
.IX Item "-cnumber"
@@ -207,9 +207,9 @@ Print output in landscape mode; supported only by \fBdvilj2p\fR and
\&\fBdvilj4\fR.
.IP "\fB\-M\fR\fIflag\fR" 4
.IX Item "-Mflag"
-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
+Do (not) call \fBmktexpk\fR\|(1) to generate fonts on demand. \fB\-M1\fR and \fB\-M\fR
+are equivalent. \fB\-M0\fR enables invoking \fBmktexpk\fR\|(1). (This is the same
+as in \fBdvips\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.
.IP "\fB\-m\fR\fImagnification\fR" 4
.IX Item "-mmagnification"
@@ -308,7 +308,7 @@ appended.
.Sp
If \fIfilename\fR is \fB\-\fR, the \s-1DVI\s0 file is read from standard input and
the resulting \s-1PCL\s0 document is written to standard output. (Please
-remember that thhe \s-1DVI\s0 file must be seekable, even if it's stdin.)
+remember that the \s-1DVI\s0 file must be seekable, even if it's stdin.)
.SH "SUPPORTED TeX \especial COMMANDS"
.IX Header "SUPPORTED TeX special COMMANDS"
\&\f(CW\*(C`\especial\*(C'\fR commands supported by \fBdvilj\fR have the generic syntax
@@ -329,7 +329,7 @@ The following key/value combinations are valid:
.IP "\fBhpfile\fR=\fIfile\fR" 4
.IX Item "hpfile=file"
Insert \fIfile\fR at the current position. \fIfile\fR is searched with
-\&\fIkpathsea\fR\|(3), see below.
+\&\fBkpathsea\fR\|(3), see below.
.Sp
The file content must be valid for this printer, i.e., it should
contain \s-1PCL\s0 escape sequences or \s-1HP\-GL/2\s0 commands. If the file is a
@@ -342,15 +342,15 @@ used as reference.
.IP "\fBhpfile_verbatim\fR=\fIfile\fR" 4
.IX Item "hpfile_verbatim=file"
Insert \fIfile\fR verbatim at the current position, without any changes
-of the file content. \fIfile\fR is searched with \fIkpathsea\fR\|(3), see below.
+of the file content. \fIfile\fR is searched with \fBkpathsea\fR\|(3), see below.
.Sp
This is mostly used to keep absolute positions in \s-1PCL\s0 files.
.IP "\fBpsfile\fR=\fIfile\fR \fBllx\fR=\fIx0\fR \fBlly\fR=\fIy0\fR \fBurx\fR=\fIx1\fR \fBury\fR=\fIy1\fR \fBrwi\fR=\fIs\fR" 4
.IX Item "psfile=file llx=x0 lly=y0 urx=x1 ury=y1 rwi=s"
-Convert Postscript file \fIfile\fR to \s-1HP PCL,\s0 by Ghostscript with device
+Convert PostScript file \fIfile\fR to \s-1HP PCL,\s0 by Ghostscript with device
\&\f(CW\*(C`ljetplus\*(C'\fR, and insert the resulting graphics file at the current
position, rewriting absolute position escape sequences. \fIfile\fR is
-searched with \fIkpathsea\fR\|(3), see below.
+searched with \fBkpathsea\fR\|(3), see below.
.Sp
The accompanying key/value pairs are mandatory, they can be specified
in an arbitrary order. Values \fIx0\fR, \fIx1\fR, \fIy0\fR, \fIy1\fR, and \fIs\fR are
@@ -361,7 +361,7 @@ upper right corner of the image.
In particular, the \fBrwi\fR parameter is some scale factor; but even
looking at the source code it is not quite clear what the special's
author intended to implement here. In addition, it is unclear what
-dimensions are used to specify the corners, Postscript points or \s-1PCL\s0
+dimensions are used to specify the corners, PostScript points or \s-1PCL\s0
dots.
.Sp
\&\fIIf you happen to know the psfile semantics, or if you spent the work
@@ -500,7 +500,7 @@ The default fill mode is 10% gray color filling.
This is a legacy special, its use is depreciated. If the special is
just one word that names an existing file, that file is verbatim
included. Contrary to other file inclusion means, the file is not
-searched with \fIkpathsea\fR\|(3). \fIYou are not supposed to use this special
+searched with \fBkpathsea\fR\|(3). \fIYou are not supposed to use this special
and we won't fix any problems with it.\fR
.PP
It should be noted that the special parser does sometimes accept
@@ -508,7 +508,7 @@ constructs that are not valid as in the documentation above. Then, the
output is most often damaged in some way.
.SS "Searching for Included Files"
.IX Subsection "Searching for Included Files"
-Proper file include specials search the file with \fIkpathsea\fR\|(3). The
+Proper file include specials search the file with \fBkpathsea\fR\|(3). The
search path is configured by variable \f(CW\*(C`DVILJINPUTS\*(C'\fR and, if the file
is not found in that search path, by variable \f(CW\*(C`TEXINPUTS\*(C'\fR.
.PP
@@ -522,7 +522,7 @@ driver variants, independent of the actual program name.
.ie n .SS "Unknown Specials and ""TEX_HUSH"" configuration"
.el .SS "Unknown Specials and \f(CWTEX_HUSH\fP configuration"
.IX Subsection "Unknown Specials and TEX_HUSH configuration"
-\&\fIKpathsea\fR\|(3) has the concept of warning suppression with the
+\&\fBKpathsea\fR\|(3) has the concept of warning suppression with the
configuration variable \f(CW\*(C`TEX_HUSH\*(C'\fR, please refer to its Info node
\&\fITeX support / Suppressing warnings\fR. That variable holds a
colon-separated identifiers that specifies the to-be-suppressed
@@ -550,7 +550,7 @@ placing first the printed pages into the paper tray).
.PP
If \fB\-D1\fR was specified only odd pages will be printed, \fB\-D2\fR can be
used for even pages. A trailing \f(CW\*(C`\-\*(C'\fR (as in \fB\-D\-\fR, \fB\-D1\-\fR or
-\&\fB\-D2\-\fR) supresses printing of empty pages which are generated for
+\&\fB\-D2\-\fR) suppresses printing of empty pages which are generated for
padding otherwise.
.PP
The driver allows the \fB\-D\fR option for both print-directions
@@ -579,7 +579,7 @@ part of a document is using \fB\-f\fR (from) and \fB\-t\fR (to).
.IX Header "ENVIRONMENT"
\&\fBdvilj\fR uses the same environment variables and algorithms for finding
font files as TeX and its friends do. See the documentation for the
-\&\fIkpathsea\fR\|(3) library for details. (Repeating it here is too cumbersome.)
+\&\fBkpathsea\fR\|(3) library for details. (Repeating it here is too cumbersome.)
.ie n .IP """DVILJFONTS""" 4
.el .IP "\f(CWDVILJFONTS\fR" 4
.IX Item "DVILJFONTS"
@@ -587,7 +587,7 @@ If set, overrides all other font paths.
.ie n .IP """DVILJMAKEPK""" 4
.el .IP "\f(CWDVILJMAKEPK\fR" 4
.IX Item "DVILJMAKEPK"
-If set, overrides \fImktexpk\fR\|(1) as the name of the command to execute to
+If set, overrides \fBmktexpk\fR\|(1) as the name of the command to execute to
create a \s-1PK\s0 file if one isn't found.
.ie n .IP """DVILJSIZES""" 4
.el .IP "\f(CWDVILJSIZES\fR" 4
@@ -624,7 +624,7 @@ warning shall be output. The following identifiers are used:
.ie n .IP """KPATHSEA_DEBUG""" 4
.el .IP "\f(CWKPATHSEA_DEBUG\fR" 4
.IX Item "KPATHSEA_DEBUG"
-Trace \fIkpathsea\fR\|(3) lookups; set to \-1 for complete tracing.
+Trace \fBkpathsea\fR\|(3) lookups; set to \-1 for complete tracing.
.ie n .IP """GS_PATH""" 4
.el .IP "\f(CWGS_PATH\fR" 4
.IX Item "GS_PATH"
@@ -632,11 +632,11 @@ On Windows, this may be the path to Ghostscript; there the default is
\&\fIgswin32c.exe\fR.
.Sp
On Unix, this environment variable is not used. Ghostscript is called
-as \fIgs\fR\|(1) and must be found over \f(CW$PATH\fR.
+as \fBgs\fR\|(1) and must be found over \f(CW$PATH\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
-\&\fIdvihp\fR\|(1), \fIdvicopy\fR\|(1), \fIdvips\fR\|(1), \fIxdvi\fR\|(1), \fImktexpk\fR\|(1), \fIgs\fR\|(1),
-\&\fIkpathsea\fR\|(3)
+\&\fBdvihp\fR\|(1), \fBdvicopy\fR\|(1), \fBdvips\fR\|(1), \fBxdvi\fR\|(1), \fBmktexpk\fR\|(1), \fBgs\fR\|(1),
+\&\fBkpathsea\fR\|(3)
.PP
Email bug reports to tex\-k@tug.org.
.PP
@@ -660,7 +660,7 @@ if you have questions about \s-1PCL\s0 escape sequences.
.IP "\fB13210\fR and \fB13211\fR" 4
.IX Item "13210 and 13211"
\&\s-1PCL 5\s0 Technical Reference Manual (part I and \s-1II\s0). This is the
-full-detailled explanation that you need to look up if you don't
+fully detailed explanation that you need to look up if you don't
understand how the printer works. Part I is the actual manual, part \s-1II\s0
explains \s-1HP\-GL/2\s0 and has overall tips.
.IP "\fB13208\fR and \fB13207\fR" 4
@@ -683,6 +683,8 @@ dviljk fork by Karl Berry.
.PP
Joachim Schrod <jschrod@acm.org> supplied security fixes and updated
this man page.
+.PP
+dviljk is currently maintained as part of TeX Live.
.SH "LICENSE"
.IX Header "LICENSE"
dvi2xx is public domain software. dviljk changes are covered by the