Debian Codegraph @

upstream/debian-unstable/man1/grolj4.1

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