diff options
Diffstat (limited to 'dviware/dviljk/dvilj.man')
-rw-r--r-- | dviware/dviljk/dvilj.man | 66 |
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 |