Debian Codegraph @

upstream/debian-trixie/man1/grolj4.1

raw
1 .TH grolj4 1 "3 June 2025" "groff 1.23.0"
2 .SH Name
3 grolj4 \-
4 .I groff
5 output driver for HP LaserJet 4 and compatible printers
6 .
7 .
8 .\" ====================================================================
9 .\" Legal Terms
10 .\" ====================================================================
11 .\"
12 .\" Copyright (C) 1994-2020, 2022 Free Software Foundation, Inc.
13 .\"
14 .\" Permission is granted to make and distribute verbatim copies of this
15 .\" manual provided the copyright notice and this permission notice are
16 .\" preserved on all copies.
17 .\"
18 .\" Permission is granted to copy and distribute modified versions of
19 .\" this manual under the conditions for verbatim copying, provided that
20 .\" the entire resulting derived work is distributed under the terms of
21 .\" a permission notice identical to this one.
22 .\"
23 .\" Permission is granted to copy and distribute translations of this
24 .\" manual into another language, under the above conditions for
25 .\" modified versions, except that this permission notice may be
26 .\" included in translations approved by the Free Software Foundation
27 .\" instead of in the original English.
28 .
29 .
30 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
31 .do nr *groff_grolj4_1_man_C \n[.cp]
32 .cp 0
33 .
34 .\" Define fallback for groff 1.23's MR macro if the system lacks it.
35 .nr do-fallback 0
36 .if !\n(.f .nr do-fallback 1 \" mandoc
37 .if \n(.g .if !d MR .nr do-fallback 1 \" older groff
38 .if !\n(.g .nr do-fallback 1 \" non-groff *roff
39 .if \n[do-fallback] \{\
40 . de MR
41 . ie \\n(.$=1 \
42 . I \%\\$1
43 . el \
44 . IR \%\\$1 (\\$2)\\$3
45 . .
46 .\}
47 .rr do-fallback
48 .
49 .\" This macro definition is poor style from a portability standpoint,
50 .\" but it's a good test and demonstration of the standard font
51 .\" repertoire for the devices where it has any effect at all, and so
52 .\" should be retained.
53 .de FT
54 . if '\\*(.T'lj4' .ft \\$1
55 ..
56 .
57 .
58 .\" ====================================================================
59 .SH Synopsis
60 .\" ====================================================================
61 .
62 .SY grolj4
63 .RB [ \-l ]
64 .RB [ \-c\~\c
65 .IR num-copies ]
66 .RB [ \-d
67 .RI [ n ]]
68 .RB [ \-F\~\c
69 .IR font-directory ]
70 .RB [ \-p\~\c
71 .IR paper-format ]
72 .RB [ \-w\~\c
73 .IR line-width ]
74 .RI [ file\~ .\|.\|.]
75 .YS
76 .
77 .
78 .SY grolj4
79 .B \-\-help
80 .YS
81 .
82 .
83 .SY grolj4
84 .B \-v
85 .
86 .SY grolj4
87 .B \-\-version
88 .YS
89 .
90 .
91 .\" ====================================================================
92 .SH Description
93 .\" ====================================================================
94 .
95 This GNU
96 .I roff
97 output driver translates the output of
98 .MR \%troff 1
99 into a PCL5 format suitable for an HP LaserJet 4 printer.
100 .
101 Normally,
102 .I grolj4
103 is invoked by
104 .MR groff 1
105 when the latter is given the
106 .RB \[lq] \-T\~lj4 \[rq]
107 option.
108 .
109 (In this installation,
110 .B \%ps
111 is the default output device.)
112 .
113 Use
114 .IR groff 's
115 .B \-P
116 option to pass any options shown above to
117 .IR grolj4 .
118 .
119 If no
120 .I file
121 arguments are given,
122 or if
123 .I file
124 is \[lq]\-\[rq],
125 .I grolj4
126 reads the standard input stream.
127 .
128 Output is written to the standard output stream.
129 .
130 .
131 .\" ====================================================================
132 .SS Typefaces
133 .\" ====================================================================
134 .
135 .I grolj4
136 supports the standard four styles:
137 .B R
138 (roman),
139 .B I
140 .RI ( italic ),
141 .B B
142 .RB ( bold ),
143 and
144 .B BI
145 (\f[BI]bold-italic\f[]).
146 .
147 Fonts are grouped into families
148 .BR A ,
149 .BR C ,
150 .BR G ,
151 .BR O ,
152 .BR T ,
153 .BR TN ,
154 .BR U ,
155 and
156 .B UC
157 having members in each style.
158 .
159 .
160 .RS
161 .TP 14n
162 .B AB
163 .FT AB
164 Arial Bold
165 .FT
166 .
167 .TQ
168 .B ABI
169 .FT ABI
170 Arial Bold Italic
171 .FT
172 .
173 .TQ
174 .B AI
175 .FT AI
176 Arial Italic
177 .FT
178 .
179 .TQ
180 .B AR
181 .FT AR
182 Arial Roman
183 .FT
184 .
185 .TQ
186 .B CB
187 .FT CB
188 Courier Bold
189 .FT
190 .
191 .TQ
192 .B CBI
193 .FT CBI
194 Courier Bold Italic
195 .FT
196 .
197 .TQ
198 .B CI
199 .FT CI
200 Courier Italic
201 .FT
202 .
203 .TQ
204 .B CR
205 .FT CR
206 Courier Roman
207 .FT
208 .
209 .TQ
210 .B GB
211 .FT GB
212 Garamond Halbfett
213 .FT
214 .
215 .TQ
216 .B GBI
217 .FT GBI
218 Garamond Kursiv Halbfett
219 .FT
220 .
221 .TQ
222 .B GI
223 .FT GI
224 Garamond Kursiv
225 .FT
226 .
227 .TQ
228 .B GR
229 .FT GR
230 Garamond Antiqua
231 .FT
232 .
233 .TQ
234 .B OB
235 .FT OB
236 CG Omega Bold
237 .FT
238 .
239 .TQ
240 .B OBI
241 .FT OBI
242 CG Omega Bold Italic
243 .FT
244 .
245 .TQ
246 .B OI
247 .FT OI
248 CG Omega Italic
249 .FT
250 .
251 .TQ
252 .B OR
253 .FT OR
254 CG Omega Roman
255 .
256 .TQ
257 .B OB
258 .FT OB
259 CG Omega Bold
260 .FT
261 .
262 .TQ
263 .B OBI
264 .FT OBI
265 CG Omega Bold Italic
266 .FT
267 .
268 .TQ
269 .B OI
270 .FT OI
271 CG Omega Italic
272 .FT
273 .
274 .TQ
275 .B OR
276 .FT OR
277 CG Omega Roman
278 .FT
279 .
280 .TQ
281 .B TB
282 .FT TB
283 CG Times Bold
284 .FT
285 .
286 .TQ
287 .B TBI
288 .FT TBI
289 CG Times Bold Italic
290 .FT
291 .
292 .TQ
293 .B TI
294 .FT TI
295 CG Times Italic
296 .FT
297 .
298 .TQ
299 .B TR
300 .FT TR
301 CG Times Roman
302 .FT
303 .
304 .TQ
305 .B TNRB
306 .FT TNRB
307 M Times Bold
308 .FT
309 .
310 .TQ
311 .B TNRBI
312 .FT TNRBI
313 M Times Bold Italic
314 .FT
315 .
316 .TQ
317 .B TNRI
318 .FT TNRI
319 M Times Italic
320 .FT
321 .
322 .TQ
323 .B TNRR
324 .FT TNRR
325 M Times Roman
326 .FT
327 .
328 .TQ
329 .B UB
330 .FT UB
331 Univers Bold
332 .FT
333 .
334 .TQ
335 .B UBI
336 .FT UBI
337 Univers Bold Italic
338 .FT
339 .
340 .TQ
341 .B UI
342 .FT UI
343 Univers Medium Italic
344 .FT
345 .
346 .TQ
347 .B UR
348 .FT UR
349 Univers Medium
350 .FT
351 .
352 .TQ
353 .B UCB
354 .FT UCB
355 Univers Condensed Bold
356 .FT
357 .
358 .TQ
359 .B UCBI
360 .FT UCBI
361 Univers Condensed Bold Italic
362 .FT
363 .
364 .TQ
365 .B UCI
366 .FT UCI
367 Univers Condensed Medium Italic
368 .FT
369 .
370 .TQ
371 .B UCR
372 .FT UCR
373 Univers Condensed Medium
374 .FT
375 .RE
376 .
377 .
378 .P
379 The following fonts are not members of a family.
380 .
381 .
382 .RS
383 .TP 14n
384 .B ALBB
385 .FT ALBB
386 Albertus Extra Bold
387 .FT
388 .
389 .TQ
390 .B ALBR
391 .FT ALBR
392 Albertus Medium
393 .FT
394 .
395 .TQ
396 .B AOB
397 .FT AOB
398 Antique Olive Bold
399 .
400 .TQ
401 .B AOI
402 .FT AOI
403 Antique Olive Italic
404 .
405 .TQ
406 .B AOR
407 .FT AOR
408 Antique Olive Roman
409 .
410 .TQ
411 .B CLARENDON
412 .FT CLARENDON
413 Clarendon
414 .
415 .TQ
416 .B CORONET
417 .FT CORONET
418 Coronet
419 .
420 .TQ
421 .B LGB
422 .FT LGB
423 Letter Gothic Bold
424 .
425 .TQ
426 .B LGI
427 .FT LGI
428 Letter Gothic Italic
429 .
430 .TQ
431 .B LGR
432 .FT LGR
433 Letter Gothic Roman
434 .
435 .TQ
436 .B MARIGOLD
437 .FT MARIGOLD
438 Marigold
439 .RE
440 .
441 .
442 .P
443 The special font is
444 .B S
445 (PostScript Symbol);
446 .B SYMBOL
447 (M Symbol),
448 and
449 .B WINGDINGS
450 (Wingdings)
451 are also available but not mounted by default.
452 .
453 .
454 .\" ====================================================================
455 .SS "Paper format and device description file"
456 .\" ====================================================================
457 .
458 .I grolj4
459 supports paper formats
460 .RB \[lq] A4 \[rq],
461 .RB \[lq] B5 \[rq],
462 .RB \[lq] C5 \[rq],
463 .RB \[lq] com10 \[rq],
464 .RB \[lq] DL \[rq],
465 .RB \%\[lq] executive \[rq],
466 .RB \%\[lq] legal \[rq],
467 .RB \%\[lq] letter \[rq],
468 and
469 .RB \[lq] monarch \[rq].
470 .
471 These are matched case-insensitively.
472 .
473 The
474 .B \-p
475 option overrides any setting in the device description file
476 .IR DESC .
477 .
478 If neither specifies a paper format,
479 \[lq]letter\[rq] is assumed.
480 .
481 .
482 .\" ====================================================================
483 .SS "Font description files"
484 .\" ====================================================================
485 .
486 .I grolj4
487 recognizes four font description file directives in addition to those
488 documented in
489 .MR groff_font 5 .
490 .
491 .
492 .TP
493 .BI pclweight\~ n
494 Set the stroke weight to
495 .IR n ,
496 an integer in the range \-7 to +7;
497 the default is\~0.
498 .
499 .
500 .TP
501 .BI pclstyle\~ n
502 Set the style to
503 .IR n ,
504 an integer in the range 0 to 32767;
505 the default is\~0.
506 .
507 .
508 .TP
509 .BI pclproportional\~ n
510 Set the proportional spacing Boolean flag to
511 .IR n ,
512 which can be either 0 or\~1;
513 the default is\~0.
514 .
515 .
516 .TP
517 .BI pcltypeface\~ n
518 Set the typeface family to
519 .IR n ,
520 an integer in the range 0 to 65535;
521 the default is\~0.
522 .
523 .
524 .\" ====================================================================
525 .SS "Drawing commands"
526 .\" ====================================================================
527 .
528 An additional drawing command is recognized as an extension to those
529 documented in
530 .MR groff 7 .
531 .
532 .
533 .TP
534 .BI \[rs]D\[aq]R\~ "dh dv" \[aq]
535 Draw a rule
536 (solid black rectangle)
537 with one corner at the drawing position,
538 and the diagonally opposite corner at the drawing position
539 .RI +( dh , dv ),
540 at which the drawing position will be afterward.
541 .
542 This generates a PCL fill rectangle command,
543 and so will work on printers that do not support HP-GL/2,
544 unlike the other
545 .B \[rs]D
546 commands.
547 .
548 .
549 .\" ====================================================================
550 .SS Fonts
551 .\" ====================================================================
552 .
553 Nominally,
554 all Hewlett-Packard LaserJet\~\%4-series and newer printers have the
555 same internal fonts:
556 45 scalable fonts and one bitmapped Lineprinter font.
557 .
558 The scalable fonts are available in sizes between 0.25 points and 999.75
559 points,
560 in 0.25-point increments;
561 the Lineprinter font is available only in 8.5-point size.
562 .
563 .
564 .P
565 The LaserJet font files included with
566 .I groff
567 assume that all printers since the LaserJet\~4 are identical.
568 .
569 There are some differences between fonts in the earlier and more recent
570 printers,
571 however.
572 .
573 The LaserJet\~4 printer used Agfa Intellifont technology for 35 of the
574 internal scalable fonts;
575 the remaining 10 scalable fonts were TrueType.
576 .
577 Beginning with the LaserJet\~\%4000-series printers introduced in 1997,
578 all scalable internal fonts have been TrueType.
579 .
580 The number of printable glyphs differs slightly between Intellifont and
581 TrueType fonts
582 (generally,
583 the TrueType fonts include more glyphs),
584 and
585 there are some minor differences in glyph metrics.
586 .
587 Differences among printer models are described in the
588 .I "PCL\~5 Comparison Guide"
589 and the
590 .I "PCL\~5 Comparison Guide Addendum"
591 (for printers introduced since approximately 2001).
592 .
593 .
594 .P
595 LaserJet printers reference a glyph by a combination of a 256-glyph
596 symbol set and an index within that symbol set.
597 .
598 Many glyphs appear in more than one symbol set;
599 all combinations of symbol set and index that reference the same glyph
600 are equivalent.
601 .
602 For each glyph,
603 .MR hpftodit 1
604 searches a list of symbol sets,
605 and selects the first set that contains the glyph.
606 .
607 The printing code generated by
608 .I hpftodit
609 is an integer that encodes a numerical value for the symbol set in the
610 high byte(s),
611 and the index in the low byte.
612 .
613 See
614 .MR groff_font 5
615 for a complete description of the font file format;
616 symbol sets are described in greater detail in the
617 .IR "PCL\~5 Printer Language Technical Reference Manual" .
618 .
619 .
620 .P
621 Two of the scalable fonts,
622 Symbol and Wingdings,
623 are bound to 256-glyph symbol sets;
624 the remaining scalable fonts,
625 as well as the Lineprinter font,
626 support numerous symbol sets,
627 sufficient to enable printing of more than 600 glyphs.
628 .
629 .
630 .P
631 The metrics generated by
632 .I hpftodit
633 assume that the
634 .I DESC
635 file contains values of 1200 for
636 .I res
637 and 6350 for
638 .IR unitwidth ,
639 or any combination
640 (e.g.,
641 2400 and 3175)
642 for which
643 .IR res \~\[tmu]\~ unitwidth \~=\~7\|620\|000.
644 .
645 Although HP PCL\~5 LaserJet printers support an internal resolution of
646 7200 units per inch,
647 they use a 16-bit signed integer for positioning;
648 if
649 .B devlj4
650 is to support U.S.\& ledger paper (11\~in\~\[mu]\~17\~in;
651 in = inch),
652 the maximum usable resolution is 32\|767\~\[di]\~17,
653 or 1927 units per inch,
654 which rounds down to 1200 units per inch.
655 .
656 If the largest required paper dimension is less
657 (e.g.,
658 8.5\~in\~\[mu]\~11\~in,
659 or A5),
660 a greater
661 .I res
662 (and lesser
663 .IR unitwidth )
664 can be specified.
665 .
666 .
667 .P
668 Font metrics for Intellifont fonts were provided by Tagged Font Metric
669 (TFM) files originally developed by Agfa/Compugraphic.
670 .
671 The TFM files provided for these fonts supported 600+ glyphs and
672 contained extensive lists of kerning pairs.
673 .
674 .
675 .P
676 To accommodate developers who had become accustomed to TFM files,
677 HP also provided TFM files for the 10 TrueType fonts included in the
678 LaserJet\~4.
679 .
680 The TFM files for TrueType fonts generally included less information
681 than the Intellifont TFMs,
682 supporting fewer glyphs,
683 and in most cases,
684 providing no kerning information.
685 .
686 By the time the LaserJet\~4000 printer was introduced,
687 most developers had migrated to other means of obtaining font metrics,
688 and support for new TFM files was very limited.
689 .
690 The TFM files provided for the TrueType fonts in the LaserJet\~4000
691 support only the Latin 2 (ISO 8859-2) symbol set,
692 and include no kerning information;
693 consequently,
694 they are of little value for any but the most rudimentary documents.
695 .
696 .
697 .P
698 Because the Intellifont TFM files contain considerably more information,
699 they generally are preferable to the TrueType TFM files even for use
700 with the TrueType fonts in the newer printers.
701 .
702 The metrics for the TrueType fonts are very close,
703 though not identical,
704 to those for the earlier Intellifont fonts of the same names.
705 .
706 Although most output using the Intellifont metrics with the newer
707 printers is quite acceptable,
708 a few glyphs may fail to print as expected.
709 .
710 The differences in glyph metrics may be particularly noticeable with
711 composite parentheses,
712 brackets,
713 and braces used by
714 .MR eqn 1 .
715 .
716 A script,
717 located in
718 .IR /usr/\:\%share/\:\%groff/\:\%1.23.0/\:\%font/\:\%devlj4/\:generate ,
719 can be used to adjust the metrics for these glyphs in the special font
720 \[lq]S\[rq] for use with printers that have all TrueType fonts.
721 .
722 .
723 .P
724 At the time HP last supported TFM files,
725 only version 1.0 of the Unicode standard was available.
726 .
727 Consequently,
728 many glyphs lacking assigned code points were assigned by HP to the
729 Private Use Area (PUA).
730 .
731 Later versions of the Unicode standard included code points outside the
732 PUA for many of these glyphs.
733 .
734 The HP-supplied TrueType TFM files use the PUA assignments;
735 TFM files generated from more recent TrueType font files require the
736 later Unicode values to access the same glyphs.
737 .
738 Consequently,
739 two different mapping files may be required:
740 one for the HP-supplied TFM files,
741 and one for more recent TFM files.
742 .
743 .
744 .\" ====================================================================
745 .SH Options
746 .\" ====================================================================
747 .
748 .B \-\-help
749 displays a usage message,
750 while
751 .B \-v
752 and
753 .B \-\-version
754 show version information;
755 all exit afterward.
756 .
757 .
758 .TP
759 .BI \-c\~ num-copies
760 Format
761 .I num-copies
762 copies of each page.
763 .
764 .
765 .TP
766 .BR \-d \~[\c
767 .IR n ]
768 Use duplex mode
769 .IR n :
770 1\~is long-side binding (default),
771 and 2\~is short-side binding.
772 .
773 .
774 .TP
775 .BI \-F " font-directory"
776 Prepend directory
777 .IR font-directory /dev name
778 to the search path for font and device description files;
779 .I name
780 is the name of the device,
781 usually
782 .BR lj4 .
783 .
784 .
785 .TP
786 .B \-l
787 Format the document in landscape orientation.
788 .
789 .
790 .TP
791 .BI \-p " paper-format"
792 Set the paper format to
793 .IR paper-format ,
794 which must be a valid paper format as described above.
795 .
796 .
797 .TP
798 .BI \-w " line-width"
799 Set the default line thickness to
800 .I line-width
801 thousandths of an em;
802 the default is
803 .B 40
804 (0.04\~em).
805 .
806 .
807 .br
808 .ne 4v \" Keep section heading and paragraph together.
809 .\" ====================================================================
810 .SH Environment
811 .\" ====================================================================
812 .
813 .TP
814 .I GROFF_FONT_PATH
815 lists directories in which to seek the selected output device's
816 directory of device and font description files.
817 .
818 See
819 .MR \%troff 1
820 and
821 .MR groff_font 5 .
822 .
823 .
824 .\" ====================================================================
825 .SH Files
826 .\" ====================================================================
827 .
828 .TP
829 .I /usr/\:\%share/\:\%groff/\:\%1.23.0/\:\%font/\:\%devlj4/\:DESC
830 describes the
831 .B lj4
832 output device.
833 .
834 .
835 .TP
836 .IR /usr/\:\%share/\:\%groff/\:\%1.23.0/\:\%font/\:\%devlj4/ F
837 describes the font known
838 .RI as\~ F
839 on device
840 .BR lj4 .
841 .
842 .
843 .TP
844 .I /usr/\:\%share/\:\%groff/\:\%1.23.0/\:\%tmac/\:lj4\:.tmac
845 defines macros for use with the
846 .B lj4
847 output device.
848 .
849 It is automatically loaded by
850 .I troffrc
851 when the
852 .B lj4
853 output device is selected.
854 .
855 .
856 .\" ====================================================================
857 .SH Bugs
858 .\" ====================================================================
859 .
860 .\" XXX: What does this mean? The period/full stop glyph? Flyspecks?
861 Small dots.
862 .
863 .
864 .\" ====================================================================
865 .SH "See also"
866 .\" ====================================================================
867 .
868 .UR http://\:www\:.hp\:.com/\:ctg/\:Manual/\:bpl13210\:.pdf
869 .I HP PCL/PJL Reference:
870 .I PCL\~5 Printer Language Technical Reference Manual,
871 .I Part I
872 .UE
873 .
874 .
875 .P
876 .MR hpftodit 1 ,
877 .MR groff 1 ,
878 .MR \%troff 1 ,
879 .MR groff_out 5 ,
880 .MR groff_font 5 ,
881 .MR groff_char 7
882 .
883 .
884 .\" Clean up.
885 .rm FT
886 .
887 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
888 .cp \n[*groff_grolj4_1_man_C]
889 .do rr *groff_grolj4_1_man_C
890 .
891 .
892 .\" Local Variables:
893 .\" fill-column: 72
894 .\" mode: nroff
895 .\" End:
896 .\" vim: set filetype=groff textwidth=72: