| 1 |
.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) |
| 2 |
.\" |
| 3 |
.\" Standard preamble: |
| 4 |
.\" ======================================================================== |
| 5 |
.de Sp \" Vertical space (when we can't use .PP) |
| 6 |
.if t .sp .5v |
| 7 |
.if n .sp |
| 8 |
.. |
| 9 |
.de Vb \" Begin verbatim text |
| 10 |
.ft CW |
| 11 |
.nf |
| 12 |
.ne \\$1 |
| 13 |
.. |
| 14 |
.de Ve \" End verbatim text |
| 15 |
.ft R |
| 16 |
.fi |
| 17 |
.. |
| 18 |
.\" Set up some character translations and predefined strings. \*(-- will |
| 19 |
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
| 20 |
.\" double quote, and \*(R" will give a right double quote. \*(C+ will |
| 21 |
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and |
| 22 |
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, |
| 23 |
.\" nothing in troff, for use with C<>. |
| 24 |
.tr \(*W- |
| 25 |
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
| 26 |
.ie n \{\ |
| 27 |
. ds -- \(*W- |
| 28 |
. ds PI pi |
| 29 |
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
| 30 |
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
| 31 |
. ds L" "" |
| 32 |
. ds R" "" |
| 33 |
. ds C` "" |
| 34 |
. ds C' "" |
| 35 |
'br\} |
| 36 |
.el\{\ |
| 37 |
. ds -- \|\(em\| |
| 38 |
. ds PI \(*p |
| 39 |
. ds L" `` |
| 40 |
. ds R" '' |
| 41 |
. ds C` |
| 42 |
. ds C' |
| 43 |
'br\} |
| 44 |
.\" |
| 45 |
.\" Escape single quotes in literal strings from groff's Unicode transform. |
| 46 |
.ie \n(.g .ds Aq \(aq |
| 47 |
.el .ds Aq ' |
| 48 |
.\" |
| 49 |
.\" If the F register is >0, we'll generate index entries on stderr for |
| 50 |
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index |
| 51 |
.\" entries marked with X<> in POD. Of course, you'll have to process the |
| 52 |
.\" output yourself in some meaningful fashion. |
| 53 |
.\" |
| 54 |
.\" Avoid warning from groff about undefined register 'F'. |
| 55 |
.de IX |
| 56 |
.. |
| 57 |
.nr rF 0 |
| 58 |
.if \n(.g .if rF .nr rF 1 |
| 59 |
.if (\n(rF:(\n(.g==0)) \{\ |
| 60 |
. if \nF \{\ |
| 61 |
. de IX |
| 62 |
. tm Index:\\$1\t\\n%\t"\\$2" |
| 63 |
.. |
| 64 |
. if !\nF==2 \{\ |
| 65 |
. nr % 0 |
| 66 |
. nr F 2 |
| 67 |
. \} |
| 68 |
. \} |
| 69 |
.\} |
| 70 |
.rr rF |
| 71 |
.\" |
| 72 |
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
| 73 |
.\" Fear. Run. Save yourself. No user-serviceable parts. |
| 74 |
. \" fudge factors for nroff and troff |
| 75 |
.if n \{\ |
| 76 |
. ds #H 0 |
| 77 |
. ds #V .8m |
| 78 |
. ds #F .3m |
| 79 |
. ds #[ \f1 |
| 80 |
. ds #] \fP |
| 81 |
.\} |
| 82 |
.if t \{\ |
| 83 |
. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
| 84 |
. ds #V .6m |
| 85 |
. ds #F 0 |
| 86 |
. ds #[ \& |
| 87 |
. ds #] \& |
| 88 |
.\} |
| 89 |
. \" simple accents for nroff and troff |
| 90 |
.if n \{\ |
| 91 |
. ds ' \& |
| 92 |
. ds ` \& |
| 93 |
. ds ^ \& |
| 94 |
. ds , \& |
| 95 |
. ds ~ ~ |
| 96 |
. ds / |
| 97 |
.\} |
| 98 |
.if t \{\ |
| 99 |
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
| 100 |
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
| 101 |
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
| 102 |
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
| 103 |
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
| 104 |
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
| 105 |
.\} |
| 106 |
. \" troff and (daisy-wheel) nroff accents |
| 107 |
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
| 108 |
.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
| 109 |
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
| 110 |
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
| 111 |
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
| 112 |
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
| 113 |
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
| 114 |
.ds ae a\h'-(\w'a'u*4/10)'e |
| 115 |
.ds Ae A\h'-(\w'A'u*4/10)'E |
| 116 |
. \" corrections for vroff |
| 117 |
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
| 118 |
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
| 119 |
. \" for low resolution devices (crt and lpr) |
| 120 |
.if \n(.H>23 .if \n(.V>19 \ |
| 121 |
\{\ |
| 122 |
. ds : e |
| 123 |
. ds 8 ss |
| 124 |
. ds o a |
| 125 |
. ds d- d\h'-1'\(ga |
| 126 |
. ds D- D\h'-1'\(hy |
| 127 |
. ds th \o'bp' |
| 128 |
. ds Th \o'LP' |
| 129 |
. ds ae ae |
| 130 |
. ds Ae AE |
| 131 |
.\} |
| 132 |
.rm #[ #] #H #V #F C |
| 133 |
.\" ======================================================================== |
| 134 |
.\" |
| 135 |
.IX Title "DVILJ 1" |
| 136 |
.TH DVILJ 1 "2022-08-30" "Version 2.6p5" "TeX Live" |
| 137 |
.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
| 138 |
.\" way too many mistakes in technical documents. |
| 139 |
.if n .ad l |
| 140 |
.nh |
| 141 |
.SH "NAME" |
| 142 |
dvilj4, dvilj4l, dvilj2p, dvilj \- convert a TeX DVI file to PCL, for HP LaserJet printers |
| 143 |
.SH "SYNOPSIS" |
| 144 |
.IX Header "SYNOPSIS" |
| 145 |
.Vb 4 |
| 146 |
\& dvilj [\-\-Dnumber] [\-ccopies] [\-dmode] [\-D] [\-E] [\-eoutputfile] |
| 147 |
\& [\-ffrompage] [\-g] [\-hheaderfile] [\-l] [\-Mflag] [\-mmag] [\-ppages] |
| 148 |
\& [\-q] [\-r] [\-ttopage] [\-spagesize] [\-v] [\-Vmode] [\-w] [\-xxoff(mm)] |
| 149 |
\& [\-yyoff(mm)] [\-Xxoff(dots)] [\-Yyoff(dots)] [\-z] [filename] |
| 150 |
.Ve |
| 151 |
.SH "DESCRIPTION" |
| 152 |
.IX Header "DESCRIPTION" |
| 153 |
\&\fBdvilj\fR and siblings convert TeX-output \f(CW\*(C`.dvi\*(C'\fR files into \s-1PCL\s0 (the |
| 154 |
Hewlett-Packard Printer Control Language) commands suitable for |
| 155 |
printing on a \s-1HP\s0 LaserJet+, \s-1HP\s0 LaserJet \s-1IIP\s0 (using \fBdvilj2p\fR), \s-1HP\s0 |
| 156 |
LaserJet 4 (using \fBdvilj4\fR), and fully compatible printers. |
| 157 |
.PP |
| 158 |
\&\fBdvilj4\fR also provides support for the builtin Intellifont and |
| 159 |
TrueType fonts; \s-1TFM\s0 and \s-1VF\s0 files are provided in the distribution. |
| 160 |
Virtual fonts are not supported directly by \fBdvilj\fR, so you must run |
| 161 |
\&\fBdvicopy\fR\|(1) first, or otherwise expand the virtual fonts |
| 162 |
.PP |
| 163 |
All programs are generated from one source file \fIdvi2xx.c\fR. They are |
| 164 |
usually called via a shell script or as a line printer filter. One |
| 165 |
such script, \fBdvihp\fR\|(1), is included in the distribution. It provides |
| 166 |
command-line options similar to those of \fBdvips\fR\|(1). |
| 167 |
.SH "OPTIONS" |
| 168 |
.IX Header "OPTIONS" |
| 169 |
.IP "\fB\-\-D\fR\fInumber\fR" 4 |
| 170 |
.IX Item "--Dnumber" |
| 171 |
Debug according to the bits of \fInumber\fR; see the \fBkpathsea\fR\|(3) manual |
| 172 |
for values. Also turns on general verbosity. |
| 173 |
.IP "\fB\-c\fR\fInumber\fR" 4 |
| 174 |
.IX Item "-cnumber" |
| 175 |
Print each page \fInumber\fR times (including original) |
| 176 |
.IP "\fB\-d\fR\fInumber\fR" 4 |
| 177 |
.IX Item "-dnumber" |
| 178 |
print in duplex mode. The option \fB\-d1\fR means long edge binding, |
| 179 |
\&\fB\-d2\fR stands for short edge binding. This option is only selectable |
| 180 |
in \fBdvilj4\fR and \fBdvilj2p\fR. |
| 181 |
.IP "\fB\-D\fR\fI[\-12]\fR" 4 |
| 182 |
.IX Item "-D[-12]" |
| 183 |
Double-sided printing \- see below; \fB\-D1\fR prints odd sides only, |
| 184 |
\&\fB\-D2\fR is for even pages, a trailing \fB\-\fR suppresses printing of empty |
| 185 |
padding pages. |
| 186 |
.IP "\fB\-E\fR" 4 |
| 187 |
.IX Item "-E" |
| 188 |
Switch printer into econo mode (\fBdvilj4\fR only). |
| 189 |
.IP "\fB\-e\fR\fIoutfile\fR" 4 |
| 190 |
.IX Item "-eoutfile" |
| 191 |
Send output to \fIoutfile\fR instead of the basename of dvi file extended |
| 192 |
with \f(CW\*(C`.lj\*(C'\fR. If outfile is \fB\-\fR (as in \f(CW\*(C`\-e\-\*(C'\fR) the output is directed |
| 193 |
to standard output and can be directly piped into a spooler. |
| 194 |
.IP "\fB\-f\fR\fIpagenum\fR" 4 |
| 195 |
.IX Item "-fpagenum" |
| 196 |
Print pages with TeX page numbers greater than or equal to \fIpagenum\fR. |
| 197 |
.IP "\fB\-g\fR" 4 |
| 198 |
.IX Item "-g" |
| 199 |
\&\fIGo\fR mode: do not reset printer at start of job. |
| 200 |
.IP "\fB\-h\fR\fIheaderfile\fR" 4 |
| 201 |
.IX Item "-hheaderfile" |
| 202 |
Copy \fIheaderfile\fR to output before translation of the \s-1DVI\s0 file. Used |
| 203 |
to send arbitrary commands to the laserprinter. |
| 204 |
.IP "\fB\-l\fR" 4 |
| 205 |
.IX Item "-l" |
| 206 |
Print output in landscape mode; supported only by \fBdvilj2p\fR and |
| 207 |
\&\fBdvilj4\fR. |
| 208 |
.IP "\fB\-M\fR\fIflag\fR" 4 |
| 209 |
.IX Item "-Mflag" |
| 210 |
Do (not) call \fBmktexpk\fR\|(1) to generate fonts on demand. \fB\-M1\fR and \fB\-M\fR |
| 211 |
are equivalent. \fB\-M0\fR enables invoking \fBmktexpk\fR\|(1). (This is the same |
| 212 |
as in \fBdvips\fR\|(1).) The default behavior (i.e., if no \fB\-M\fR option is |
| 213 |
given) is chosen at compile-time; as distributed, mktexpk is enabled. |
| 214 |
.IP "\fB\-m\fR\fImagnification\fR" 4 |
| 215 |
.IX Item "-mmagnification" |
| 216 |
Specify the magnification to use. The following are available: |
| 217 |
.Sp |
| 218 |
.Vb 9 |
| 219 |
\& \-m#usermag e.g., #900 |
| 220 |
\& \-m0 equivalent to \-m#1000 |
| 221 |
\& \-mh equivalent to \-m#1095 |
| 222 |
\& \-m1 equivalent to \-m#1200 |
| 223 |
\& \-mq equivalent to \-m#1250 |
| 224 |
\& \-m2 equivalent to \-m#1440 |
| 225 |
\& \-m3 equivalent to \-m#1728 |
| 226 |
\& \-m4 equivalent to \-m#2074 |
| 227 |
\& \-m5 equivalent to \-m#2488 |
| 228 |
.Ve |
| 229 |
.IP "\fB\-p\fR\fIpagecount\fR" 4 |
| 230 |
.IX Item "-ppagecount" |
| 231 |
Print \fIpagecount\fR pages after the starting page. |
| 232 |
.IP "\fB\-q\fR" 4 |
| 233 |
.IX Item "-q" |
| 234 |
Quiet operation: omit final statistics, etc. |
| 235 |
.IP "\fB\-r\fR" 4 |
| 236 |
.IX Item "-r" |
| 237 |
Toggle page reversal. |
| 238 |
.IP "\fB\-s\fR\fIpagesize\fR" 4 |
| 239 |
.IX Item "-spagesize" |
| 240 |
Specify the page size: |
| 241 |
.Sp |
| 242 |
.Vb 10 |
| 243 |
\& \-s1: Executive (7.25" x 10.5") |
| 244 |
\& \-s2: Letter (8.5" x 11") |
| 245 |
\& \-s3: Legal (8.5" x 14") |
| 246 |
\& \-s6: Ledger (11" x 17") |
| 247 |
\& \-s25: A5 paper (148mm x 210mm) |
| 248 |
\& \-s26: A4 paper (210mm x 297mm) |
| 249 |
\& \-s27: A3 (297mm x 420mm) |
| 250 |
\& \-s45: JIS B5 paper (182mm x 257mm) |
| 251 |
\& \-s46: JIS B4 paper (250mm x 354mm) |
| 252 |
\& \-s71: Hagaki postcard (100mm x 148mm) |
| 253 |
\& \-s72: Oufuku\-Hagaki postcard (200mm x 148mm) |
| 254 |
\& \-s80: Monarch Envelope (3 7/8" x 7 1/2") |
| 255 |
\& \-s81: Commercial Envelope 10 (4 1/8" x 9 1/2") |
| 256 |
\& \-s90: International DL (110mm x 220mm) |
| 257 |
\& \-s91: International C5 (162mm x 229mm) |
| 258 |
\& \-s100: International B5 (176mm x 250mm) |
| 259 |
.Ve |
| 260 |
.Sp |
| 261 |
These values are from the \s-1PCL 5\s0 technical reference manual. If the |
| 262 |
\&\fB\-s\fR commandline option is omitted, no clipping is performed at the |
| 263 |
bottom of the page. (But printing below the paper bottom should not |
| 264 |
disturb any correctly behaving \s-1PCL\s0 printer.) Please remember that the |
| 265 |
correct paper tray must be installed for selected paper size, so use |
| 266 |
this option only if you have full control over your print destination. |
| 267 |
.IP "\fB\-t\fR\fIpagenum\fR" 4 |
| 268 |
.IX Item "-tpagenum" |
| 269 |
Print pages with TeX page numbers less than or equal to \fIpagenum\fR. |
| 270 |
.IP "\fB\-v\fR" 4 |
| 271 |
.IX Item "-v" |
| 272 |
Verbose mode: list fonts used, etc. |
| 273 |
.IP "\fB\-V\fR\fImode\fR" 4 |
| 274 |
.IX Item "-Vmode" |
| 275 |
Compatibility mode. As \fImode\fR, use \f(CW\*(C`K\*(C'\fR for Kyocera, \f(CW\*(C`B\*(C'\fR for |
| 276 |
Brother, \f(CW6\fR for \s-1LJ6\s0 printers. |
| 277 |
.IP "\fB\-w\fR" 4 |
| 278 |
.IX Item "-w" |
| 279 |
Omit warnings. |
| 280 |
.IP "\fB\-x\fR\fIoffset\fR" 4 |
| 281 |
.IX Item "-xoffset" |
| 282 |
Global x\-offset in mm on output page relative to 1 inch/1 inch origin. |
| 283 |
.IP "\fB\-y\fR\fIoffset\fR" 4 |
| 284 |
.IX Item "-yoffset" |
| 285 |
Global y\-offset in mm on output page relative to 1 inch/1 inch origin. |
| 286 |
.IP "\fB\-X\fR\fIoffset\fR" 4 |
| 287 |
.IX Item "-Xoffset" |
| 288 |
Global x\-offset in dots on output page (overrides 1 inch/1 inch |
| 289 |
origin). |
| 290 |
.IP "\fB\-Y\fR\fIoffset\fR" 4 |
| 291 |
.IX Item "-Yoffset" |
| 292 |
Global y\-offset in dots on output page (overrides 1 inch/1 |
| 293 |
inch origin). |
| 294 |
.IP "\fB\-z\fR" 4 |
| 295 |
.IX Item "-z" |
| 296 |
Print a test page with the page counter at end of job. |
| 297 |
.SH "OPERANDS" |
| 298 |
.IX Header "OPERANDS" |
| 299 |
If no operands are specified a brief usage message is displayed. |
| 300 |
.IP "\fIfilename\fR" 4 |
| 301 |
.IX Item "filename" |
| 302 |
The \s-1DVI\s0 file name that shall be converted by \fBdvilj\fR. It must always |
| 303 |
be seekable. |
| 304 |
.Sp |
| 305 |
The output file name is constructed from \fIfilename\fR. Either an |
| 306 |
extension \f(CW\*(C`.dvi\*(C'\fR is replaced by \f(CW\*(C`.lj\*(C'\fR, or the extension \f(CW\*(C`.lj\*(C'\fR is |
| 307 |
appended. |
| 308 |
.Sp |
| 309 |
If \fIfilename\fR is \fB\-\fR, the \s-1DVI\s0 file is read from standard input and |
| 310 |
the resulting \s-1PCL\s0 document is written to standard output. (Please |
| 311 |
remember that the \s-1DVI\s0 file must be seekable, even if it's stdin.) |
| 312 |
.SH "SUPPORTED TeX \especial COMMANDS" |
| 313 |
.IX Header "SUPPORTED TeX special COMMANDS" |
| 314 |
\&\f(CW\*(C`\especial\*(C'\fR commands supported by \fBdvilj\fR have the generic syntax |
| 315 |
.PP |
| 316 |
.Vb 2 |
| 317 |
\& \especial{key1=value key1="value with space"} |
| 318 |
\& \especial{key3 = value key4 = \*(Aqnote optional spaces around equal sign\*(Aq} |
| 319 |
.Ve |
| 320 |
.PP |
| 321 |
I.e., specials are a sequence of key/value pairs, separated by an |
| 322 |
equal sign. Spaces around the equal sign are ignored. The value is |
| 323 |
either a space separated word, or a quoted string. Both double and |
| 324 |
single quotes can be used, alternatively. There is no support for |
| 325 |
quoting quote characters in values; if you want both double and single |
| 326 |
quotes in one value, you're out of luck. |
| 327 |
.PP |
| 328 |
The following key/value combinations are valid: |
| 329 |
.IP "\fBhpfile\fR=\fIfile\fR" 4 |
| 330 |
.IX Item "hpfile=file" |
| 331 |
Insert \fIfile\fR at the current position. \fIfile\fR is searched with |
| 332 |
\&\fBkpathsea\fR\|(3), see below. |
| 333 |
.Sp |
| 334 |
The file content must be valid for this printer, i.e., it should |
| 335 |
contain \s-1PCL\s0 escape sequences or \s-1HP\-GL/2\s0 commands. If the file is a |
| 336 |
graphics file, this typically means that the upper left corner of the |
| 337 |
graphics is placed at the current position. |
| 338 |
.Sp |
| 339 |
\&\s-1PCL\s0 absolute positioning escape sequences in \fIfile\fR are rewritten to |
| 340 |
be relative positioning commands; the lowest appearing coordinate is |
| 341 |
used as reference. |
| 342 |
.IP "\fBhpfile_verbatim\fR=\fIfile\fR" 4 |
| 343 |
.IX Item "hpfile_verbatim=file" |
| 344 |
Insert \fIfile\fR verbatim at the current position, without any changes |
| 345 |
of the file content. \fIfile\fR is searched with \fBkpathsea\fR\|(3), see below. |
| 346 |
.Sp |
| 347 |
This is mostly used to keep absolute positions in \s-1PCL\s0 files. |
| 348 |
.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 |
| 349 |
.IX Item "psfile=file llx=x0 lly=y0 urx=x1 ury=y1 rwi=s" |
| 350 |
Convert PostScript file \fIfile\fR to \s-1HP PCL,\s0 by Ghostscript with device |
| 351 |
\&\f(CW\*(C`ljetplus\*(C'\fR, and insert the resulting graphics file at the current |
| 352 |
position, rewriting absolute position escape sequences. \fIfile\fR is |
| 353 |
searched with \fBkpathsea\fR\|(3), see below. |
| 354 |
.Sp |
| 355 |
The accompanying key/value pairs are mandatory, they can be specified |
| 356 |
in an arbitrary order. Values \fIx0\fR, \fIx1\fR, \fIy0\fR, \fIy1\fR, and \fIs\fR are |
| 357 |
integers. (\fIx0\fR,\fIy0\fR) is the lower left corner, (\fIx1\fR,\fIy1\fR) the |
| 358 |
upper right corner of the image. |
| 359 |
.Sp |
| 360 |
\&\fBPlease note: The specific semantics of this special is not known.\fR |
| 361 |
In particular, the \fBrwi\fR parameter is some scale factor; but even |
| 362 |
looking at the source code it is not quite clear what the special's |
| 363 |
author intended to implement here. In addition, it is unclear what |
| 364 |
dimensions are used to specify the corners, PostScript points or \s-1PCL\s0 |
| 365 |
dots. |
| 366 |
.Sp |
| 367 |
\&\fIIf you happen to know the psfile semantics, or if you spent the work |
| 368 |
analyzing them, please inform us at tex\[email protected], so that we can |
| 369 |
update this man page with the relevant information.\fR |
| 370 |
.IP "\fBdvilj-psfile-syntax\fR=\fIsyntax\fR" 4 |
| 371 |
.IX Item "dvilj-psfile-syntax=syntax" |
| 372 |
where \fIsyntax\fR is either \f(CW\*(C`dvilj\*(C'\fR or \f(CW\*(C`ignore\*(C'\fR. This is a very crude |
| 373 |
way to tell the driver what to do with \fBpsfile\fR specials. |
| 374 |
.Sp |
| 375 |
If the value is \f(CW\*(C`ignore\*(C'\fR, all \fBpsfile\fR specials that are processed |
| 376 |
afterwards are ignored, until the next \fBdvilj-psfile-syntax\fR special is |
| 377 |
processed. |
| 378 |
.Sp |
| 379 |
If the value is \f(CW\*(C`dvilj\*(C'\fR, \fBpsfiles\fR specials are processed as |
| 380 |
explained above, until the next \fBdvilj-psfile-syntax\fR special is |
| 381 |
processed. |
| 382 |
.Sp |
| 383 |
An obvious, planned, extension is the value \f(CW\*(C`dvips\*(C'\fR, but this has not |
| 384 |
been implemented yet. |
| 385 |
.Sp |
| 386 |
That special is not as simple as it sounds at first. Since its |
| 387 |
semantics is defined by processing order, it is only of use if it is |
| 388 |
placed on the same page as the \fBpsfile\fR special. Having it once in a |
| 389 |
file (e.g., on the first page) does not help if you print just one |
| 390 |
page of the document \*(-- \fBdvilj\fR does not do prescanning of first-page |
| 391 |
specials like some other drivers do. (Patches would be welcome, of |
| 392 |
course.) |
| 393 |
.IP "\fBcomment\fR=\fIarbitrary text\fR" 4 |
| 394 |
.IX Item "comment=arbitrary text" |
| 395 |
.PD 0 |
| 396 |
.IP "\fBcomment\fR \fIarbitrary text\fR" 4 |
| 397 |
.IX Item "comment arbitrary text" |
| 398 |
.PD |
| 399 |
This causes the rest of the special to be ignored; it may be used to |
| 400 |
add meta-information to a \s-1DVI\s0 file. |
| 401 |
.Sp |
| 402 |
With the first form, the comment may appear anywhere in the special. |
| 403 |
When it appears first, the processing of this special is terminated |
| 404 |
and all other text behind is ignored. |
| 405 |
.Sp |
| 406 |
The second form is a speciality that has been introduced for |
| 407 |
compatibility with other drivers. If the first keyword of the special |
| 408 |
is \fBcomment\fR and has no value, it is taken as a valid comment syntax, |
| 409 |
too; the rest of the special is ignored. |
| 410 |
.IP "\fBorientation\fR=\fIpo\fR" 4 |
| 411 |
.IX Item "orientation=po" |
| 412 |
Position the page on the physical paper. The value \fIpo\fR may be one of |
| 413 |
the following values: |
| 414 |
.Sp |
| 415 |
.Vb 4 |
| 416 |
\& 0 for portrait |
| 417 |
\& 1 for landscape |
| 418 |
\& 2 for reverse portrait |
| 419 |
\& 3 for reverse landscape |
| 420 |
.Ve |
| 421 |
.IP "\fBdefpoint\fR=\fIn(x,y)\fR" 4 |
| 422 |
.IX Item "defpoint=n(x,y)" |
| 423 |
Define the point number \fIn\fR. This point can be referred to later in |
| 424 |
other special commands to specify areas that shall be filled with some |
| 425 |
pattern. \fIn\fR must be between 0 and 79. |
| 426 |
.Sp |
| 427 |
\&\fIx\fR and \fIy\fR are the position of that point and have the form \f(CW\*(C`?pt\*(C'\fR |
| 428 |
where \f(CW\*(C`?\*(C'\fR is a floating point number. The positions are relative to |
| 429 |
the \s-1DVI\s0 page origin; i.e., coordinates increase moving right and down, |
| 430 |
the point of origin is (1in,1in) in the upper left corner, altered by |
| 431 |
options \fB\-x\fR, \fB\-y\fR, \fB\-X\fR, and \fB\-Y\fR, but not by \ehoffset and |
| 432 |
\&\evoffset. |
| 433 |
.Sp |
| 434 |
\&\fIx\fR and \fIy\fR can be omitted, i.e., the values \f(CW3\fR or \f(CW\*(C`4(,)\*(C'\fR are |
| 435 |
valid. Then the current page position is used as position for point |
| 436 |
\&\fIn\fR. |
| 437 |
.ie n .IP "\fBresetpoints\fR=""all""" 4 |
| 438 |
.el .IP "\fBresetpoints\fR=\f(CWall\fR" 4 |
| 439 |
.IX Item "resetpoints=all" |
| 440 |
This undefines all points again. |
| 441 |
.IP "\fBgray\fR=\fIgray_scale\fR" 4 |
| 442 |
.IX Item "gray=gray_scale" |
| 443 |
.PD 0 |
| 444 |
.IP "\fBgrey\fR=\fIgray_scale\fR" 4 |
| 445 |
.IX Item "grey=gray_scale" |
| 446 |
.PD |
| 447 |
This sets the fill mode for the next \fBfill\fR special, the area will be |
| 448 |
filled with gray color. (\fBgrey\fR is an alias for \fBgray\fR.) Any pattern |
| 449 |
specification is reset. |
| 450 |
.Sp |
| 451 |
\&\fIgray_scale\fR is the percentage of gray that shall be used here; with |
| 452 |
\&\f(CW0\fR meaning white and \f(CW100\fR meaning black. |
| 453 |
.Sp |
| 454 |
Caveat: That special is actually a misnomer. \s-1PCL\s0 names these gray |
| 455 |
scales \fIshading patterns\fR and they are created by placing dots in the |
| 456 |
area. The gray scale selects how far spread the dots are. In the lower |
| 457 |
ranges, this doesn't look very gray on close sight, but more like a |
| 458 |
dotted background. Furthermore, the gray scales are not as |
| 459 |
fine-grained as the value range 0..100 might make you believe. In |
| 460 |
reality, there are only 8 different gray patterns available: |
| 461 |
.Sp |
| 462 |
.Vb 8 |
| 463 |
\& 1 \- 2% |
| 464 |
\& 3 \- 10% |
| 465 |
\& 11 \- 20% |
| 466 |
\& 21 \- 35% |
| 467 |
\& 36 \- 55% |
| 468 |
\& 56 \- 80% |
| 469 |
\& 81 \- 99% |
| 470 |
\& 100% |
| 471 |
.Ve |
| 472 |
.Sp |
| 473 |
One of these patterns is selected according to the \fIgray_scale\fR value. |
| 474 |
.IP "\fBpattern\fR=\fIpat\fR" 4 |
| 475 |
.IX Item "pattern=pat" |
| 476 |
This sets the fill mode for the next \fBfill\fR special, the area will be |
| 477 |
filled with a pattern. Any gray color specification is reset. |
| 478 |
.Sp |
| 479 |
\&\fIpat\fR is one of the following values: |
| 480 |
.Sp |
| 481 |
.Vb 6 |
| 482 |
\& 1 horizontal lines |
| 483 |
\& 2 vertical lines |
| 484 |
\& 3 diagonal lines, from lower left corner to upper right corner |
| 485 |
\& 4 diagonal lines, from upper right corner to lower left corner |
| 486 |
\& 5 crossed lines, vertically |
| 487 |
\& 6 crossed lines, diagonally |
| 488 |
.Ve |
| 489 |
.IP "\fBfill\fR=\fIa/b\fR" 4 |
| 490 |
.IX Item "fill=a/b" |
| 491 |
Fill the area between the points \fIa\fR and \fIb\fR, according to the |
| 492 |
current fill mode. |
| 493 |
.Sp |
| 494 |
Point \fIa\fR \fBmust\fR be the upper left corner and point \fIb\fR \fBmust\fR be the |
| 495 |
lower left corner of the rectangle. Otherwise the result is garbage. |
| 496 |
.Sp |
| 497 |
The default fill mode is 10% gray color filling. |
| 498 |
.IP "\fIfilename\fR" 4 |
| 499 |
.IX Item "filename" |
| 500 |
This is a legacy special, its use is depreciated. If the special is |
| 501 |
just one word that names an existing file, that file is verbatim |
| 502 |
included. Contrary to other file inclusion means, the file is not |
| 503 |
searched with \fBkpathsea\fR\|(3). \fIYou are not supposed to use this special |
| 504 |
and we won't fix any problems with it.\fR |
| 505 |
.PP |
| 506 |
It should be noted that the special parser does sometimes accept |
| 507 |
constructs that are not valid as in the documentation above. Then, the |
| 508 |
output is most often damaged in some way. |
| 509 |
.SS "Searching for Included Files" |
| 510 |
.IX Subsection "Searching for Included Files" |
| 511 |
Proper file include specials search the file with \fBkpathsea\fR\|(3). The |
| 512 |
search path is configured by variable \f(CW\*(C`DVILJINPUTS\*(C'\fR and, if the file |
| 513 |
is not found in that search path, by variable \f(CW\*(C`TEXINPUTS\*(C'\fR. |
| 514 |
.PP |
| 515 |
Search via \f(CW\*(C`DVILJINPUTS\*(C'\fR covers the use case that one has common |
| 516 |
site-wide graphics that shall be included in documents, e.g., scanned |
| 517 |
signatures. Search via \f(CW\*(C`TEXINPUTS\*(C'\fR covers the use case that one has |
| 518 |
graphics as part of ones current document. |
| 519 |
.PP |
| 520 |
\&\f(CW\*(C`dvilj\*(C'\fR is used as the \f(CW\*(C`.PROGRAM\*(C'\fR name in \fItexmf.cnf\fR, for all |
| 521 |
driver variants, independent of the actual program name. |
| 522 |
.ie n .SS "Unknown Specials and ""TEX_HUSH"" configuration" |
| 523 |
.el .SS "Unknown Specials and \f(CWTEX_HUSH\fP configuration" |
| 524 |
.IX Subsection "Unknown Specials and TEX_HUSH configuration" |
| 525 |
\&\fBKpathsea\fR\|(3) has the concept of warning suppression with the |
| 526 |
configuration variable \f(CW\*(C`TEX_HUSH\*(C'\fR, please refer to its Info node |
| 527 |
\&\fITeX support / Suppressing warnings\fR. That variable holds a |
| 528 |
colon-separated identifiers that specifies the to-be-suppressed |
| 529 |
warnings. |
| 530 |
.PP |
| 531 |
If \f(CW\*(C`special\*(C'\fR is among the listed values, \fBdvilj\fR does not output |
| 532 |
warnings any more about specials that it doesn't know about. But if |
| 533 |
there is a recognized special and if that special has an invalid |
| 534 |
parameter, then a warning is output nevertheless, independent of the |
| 535 |
content of \f(CW\*(C`TEX_HUSH\*(C'\fR. |
| 536 |
.SH "DOUBLE PAGE PRINTING" |
| 537 |
.IX Header "DOUBLE PAGE PRINTING" |
| 538 |
If the printer has a duplex unit installed, duplex printing can be |
| 539 |
demanded with the \fB\-d\fR option. |
| 540 |
.PP |
| 541 |
Otherwise, the command line option \fB\-D\fR causes the printer to print |
| 542 |
in doublepage mode, that is, roughly speaking, printing first the even |
| 543 |
pages and then the odd pages of a document. If \fB\-D\fR is used to print |
| 544 |
both even and odd pages (\fB\-D\fR is used without the optional 1 or 2) |
| 545 |
the following will happen after half of the pages is printed: \s-1LJ:\s0 the |
| 546 |
printer stops, shows message \*(L"\s-1FEED\*(R"\s0 and switches on manual feed led. |
| 547 |
The printer continues when either the printed pages are fed into the |
| 548 |
manual page feeder, or the operator pushes the continue button (after |
| 549 |
placing first the printed pages into the paper tray). |
| 550 |
.PP |
| 551 |
If \fB\-D1\fR was specified only odd pages will be printed, \fB\-D2\fR can be |
| 552 |
used for even pages. A trailing \f(CW\*(C`\-\*(C'\fR (as in \fB\-D\-\fR, \fB\-D1\-\fR or |
| 553 |
\&\fB\-D2\-\fR) suppresses printing of empty pages which are generated for |
| 554 |
padding otherwise. |
| 555 |
.PP |
| 556 |
The driver allows the \fB\-D\fR option for both print-directions |
| 557 |
(front-to-back or back-to-front printing). It tries to be clever in |
| 558 |
certain cases: when a document has an odd number of pages it inserts |
| 559 |
in the right place an empty page when a document starts with page 0 |
| 560 |
the driver inserts an empty page after the 0\-page when a piece of a |
| 561 |
document is printed that starts with an even page-number it prints |
| 562 |
this page at the backside of the first page to ensure that the odd |
| 563 |
sides are always on the frontside. The 0\-page is treated like an odd |
| 564 |
page. |
| 565 |
.PP |
| 566 |
The doubleside option works for all LJs, not only for the new D model |
| 567 |
with does doubleside-printing (actually, I don't know whether it makes |
| 568 |
much sense on the new \s-1LJ II D\s0 at all). |
| 569 |
.PP |
| 570 |
Caveat on the doubleside-option: When it is used frequently or on very |
| 571 |
large files, it might become necessary to clean the printer much more |
| 572 |
frequently. |
| 573 |
.PP |
| 574 |
The command line option \fB\-p\fR\fIX\fR can be used to abort printing after |
| 575 |
the output of \fIX\fR pages (can lead to strange results together with |
| 576 |
\&\fB\-D\fR). I personally dislike this option. The secure way of printing a |
| 577 |
part of a document is using \fB\-f\fR (from) and \fB\-t\fR (to). |
| 578 |
.SH "ENVIRONMENT" |
| 579 |
.IX Header "ENVIRONMENT" |
| 580 |
\&\fBdvilj\fR uses the same environment variables and algorithms for finding |
| 581 |
font files as TeX and its friends do. See the documentation for the |
| 582 |
\&\fBkpathsea\fR\|(3) library for details. (Repeating it here is too cumbersome.) |
| 583 |
.ie n .IP """DVILJFONTS""" 4 |
| 584 |
.el .IP "\f(CWDVILJFONTS\fR" 4 |
| 585 |
.IX Item "DVILJFONTS" |
| 586 |
If set, overrides all other font paths. |
| 587 |
.ie n .IP """DVILJMAKEPK""" 4 |
| 588 |
.el .IP "\f(CWDVILJMAKEPK\fR" 4 |
| 589 |
.IX Item "DVILJMAKEPK" |
| 590 |
If set, overrides \fBmktexpk\fR\|(1) as the name of the command to execute to |
| 591 |
create a \s-1PK\s0 file if one isn't found. |
| 592 |
.ie n .IP """DVILJSIZES""" 4 |
| 593 |
.el .IP "\f(CWDVILJSIZES\fR" 4 |
| 594 |
.IX Item "DVILJSIZES" |
| 595 |
May be set to indicate which sizes of fonts are available. It should |
| 596 |
consist of a list of numbers separated by colons. If the list begins |
| 597 |
with a colon, the system default sizes are used, as well. Sizes are |
| 598 |
expressed in dots per inch; decimals may be used for \f(CW\*(C`pxl\*(C'\fR files: for |
| 599 |
example, a 300 dots per inch file magnified by half a step comes out |
| 600 |
to 1643 dots per five inches, which should be encoded as 328.6. |
| 601 |
\&\fBdvilj\fR tries the actual size of the font before trying any of the |
| 602 |
given sizes. |
| 603 |
.ie n .IP """DVILJINPUTS""" 4 |
| 604 |
.el .IP "\f(CWDVILJINPUTS\fR" 4 |
| 605 |
.IX Item "DVILJINPUTS" |
| 606 |
Primary search path for include files. |
| 607 |
.ie n .IP """TEXINPUTS""" 4 |
| 608 |
.el .IP "\f(CWTEXINPUTS\fR" 4 |
| 609 |
.IX Item "TEXINPUTS" |
| 610 |
Secondary search path for include files. |
| 611 |
.ie n .IP """TEX_HUSH""" 4 |
| 612 |
.el .IP "\f(CWTEX_HUSH\fR" 4 |
| 613 |
.IX Item "TEX_HUSH" |
| 614 |
Colon separated list of identifiers that name situations where no |
| 615 |
warning shall be output. The following identifiers are used: |
| 616 |
.Sp |
| 617 |
.Vb 5 |
| 618 |
\& checksum suppress mismatched font checksum warnings |
| 619 |
\& readable suppress warnings about unreadable files |
| 620 |
\& special suppress warnings about unknown specials |
| 621 |
\& all suppress all warning classes above |
| 622 |
\& none suppress no warnings |
| 623 |
.Ve |
| 624 |
.ie n .IP """KPATHSEA_DEBUG""" 4 |
| 625 |
.el .IP "\f(CWKPATHSEA_DEBUG\fR" 4 |
| 626 |
.IX Item "KPATHSEA_DEBUG" |
| 627 |
Trace \fBkpathsea\fR\|(3) lookups; set to \-1 for complete tracing. |
| 628 |
.ie n .IP """GS_PATH""" 4 |
| 629 |
.el .IP "\f(CWGS_PATH\fR" 4 |
| 630 |
.IX Item "GS_PATH" |
| 631 |
On Windows, this may be the path to Ghostscript; there the default is |
| 632 |
\&\fIgswin32c.exe\fR. |
| 633 |
.Sp |
| 634 |
On Unix, this environment variable is not used. Ghostscript is called |
| 635 |
as \fBgs\fR\|(1) and must be found over \f(CW$PATH\fR. |
| 636 |
.SH "SEE ALSO" |
| 637 |
.IX Header "SEE ALSO" |
| 638 |
\&\fBdvihp\fR\|(1), \fBdvicopy\fR\|(1), \fBdvips\fR\|(1), \fBxdvi\fR\|(1), \fBmktexpk\fR\|(1), \fBgs\fR\|(1), |
| 639 |
\&\fBkpathsea\fR\|(3) |
| 640 |
.PP |
| 641 |
Email bug reports to tex\[email protected]. |
| 642 |
.PP |
| 643 |
Source is at <http://mirror.ctan.org/dviware/dviljk/>; but for |
| 644 |
compilation the texk build environment is needed, from |
| 645 |
<svn://tug.org/texlive/*/Build/source>. |
| 646 |
.PP |
| 647 |
As of July 2007, \s-1PCL\s0 reference documentation is found at \s-1HP\s0's Web site |
| 648 |
at |
| 649 |
<http://h20000.www2.hp.com/bizsupport/TechSupport/Document.jsp?objectID=bpl04568>. |
| 650 |
At the end of that page are links to reference manuals for \s-1PCL\s0 and \s-1PJL.\s0 |
| 651 |
.PP |
| 652 |
In case that page is changed, here are the URLs of these documents. |
| 653 |
All have the form |
| 654 |
<http://h20000.www2.hp.com/bc/docs/support/SupportManual/bpl<\s-1ID\s0>/bpl<\s-1ID\s0>.pdf>, |
| 655 |
where \f(CW\*(C`<ID>\*(C'\fR is the following document \s-1ID:\s0 |
| 656 |
.IP "\fB13205\fR" 4 |
| 657 |
.IX Item "13205" |
| 658 |
\&\s-1PCL 5\s0 Technical Quick Reference Guide. This is the 1st thing to look up |
| 659 |
if you have questions about \s-1PCL\s0 escape sequences. |
| 660 |
.IP "\fB13210\fR and \fB13211\fR" 4 |
| 661 |
.IX Item "13210 and 13211" |
| 662 |
\&\s-1PCL 5\s0 Technical Reference Manual (part I and \s-1II\s0). This is the |
| 663 |
fully detailed explanation that you need to look up if you don't |
| 664 |
understand how the printer works. Part I is the actual manual, part \s-1II\s0 |
| 665 |
explains \s-1HP\-GL/2\s0 and has overall tips. |
| 666 |
.IP "\fB13208\fR and \fB13207\fR" 4 |
| 667 |
.IX Item "13208 and 13207" |
| 668 |
\&\s-1PJL\s0 Technical Reference Manual (and addendum) |
| 669 |
.IP "\fB13212\fR" 4 |
| 670 |
.IX Item "13212" |
| 671 |
\&\s-1PCL 5\s0 Color Manual. This explains color specials for the newer \s-1HP\s0 |
| 672 |
printers. (Not of much use today; for practical purposes we would need |
| 673 |
to add color specials to \fBdvilj\fR first.) |
| 674 |
.IP "\fB13206\fR and \fB13209\fR" 4 |
| 675 |
.IX Item "13206 and 13209" |
| 676 |
Comparison Guide (and addendum) that documents which \s-1PCL\s0 escape |
| 677 |
sequences are supported on which \s-1HP\s0 printers. |
| 678 |
.SH "AUTHOR" |
| 679 |
.IX Header "AUTHOR" |
| 680 |
dvi2xx by Gustaf Neumann, Wirtschaftsuniversitaet Wien. |
| 681 |
.PP |
| 682 |
dviljk fork by Karl Berry. |
| 683 |
.PP |
| 684 |
Joachim Schrod <[email protected]> supplied security fixes and updated |
| 685 |
this man page. |
| 686 |
.PP |
| 687 |
dviljk is currently maintained as part of TeX Live. |
| 688 |
.SH "LICENSE" |
| 689 |
.IX Header "LICENSE" |
| 690 |
dvi2xx is public domain software. dviljk changes are covered by the |
| 691 |
\&\s-1GNU\s0 General Public License. |