Imported Upstream version 1.22.4
[platform/upstream/groff.git] / src / devices / grolj4 / grolj4.1.man
1 .TH GROLJ4 @MAN1EXT@ "@MDATE@" "groff @VERSION@"
2 .SH NAME
3 grolj4 \- groff driver for HP LaserJet 4 family
4 .
5 .
6 .\" ====================================================================
7 .\" Legal Terms
8 .\" ====================================================================
9 .\"
10 .\" Copyright (C) 1994-2018 Free Software Foundation, Inc.
11 .\"
12 .\" Permission is granted to make and distribute verbatim copies of this
13 .\" manual provided the copyright notice and this permission notice are
14 .\" preserved on all copies.
15 .\"
16 .\" Permission is granted to copy and distribute modified versions of
17 .\" this manual under the conditions for verbatim copying, provided that
18 .\" the entire resulting derived work is distributed under the terms of
19 .\" a permission notice identical to this one.
20 .\"
21 .\" Permission is granted to copy and distribute translations of this
22 .\" manual into another language, under the above conditions for
23 .\" modified versions, except that this permission notice may be
24 .\" included in translations approved by the Free Software Foundation
25 .\" instead of in the original English.
26 .
27 .
28 .\" ====================================================================
29 .SH SYNOPSIS
30 .\" ====================================================================
31 .
32 .SY grolj4
33 .OP \-l
34 .OP \-c num-copies
35 .RB [ \-d
36 .RI [ n ]]
37 .OP \-F font-directory
38 .OP \-p paper-size
39 .OP \-w line-width
40 .RI [ file
41 \&.\|.\|.\&]
42 .YS
43 .
44 .SY grolj4
45 .B \-\-help
46 .YS
47 .
48 .SY grolj4
49 .B \-v
50 .SY grolj4
51 .B \-\-version
52 .YS
53 .
54 .
55 .\" ====================================================================
56 .SH DESCRIPTION
57 .\" ====================================================================
58 .
59 .B grolj4
60 is a driver for
61 .B groff
62 that produces output in PCL5 format suitable for an HP LaserJet 4
63 printer.
64 .
65 .
66 .LP
67 There is an additional drawing command available:
68 .
69 .TP
70 .BI \eD'R\  dh\ dv '
71 Draw a rule (solid black rectangle), with one corner at the current
72 position, and the diagonally opposite corner at the current position
73 .RI +( dh , dv ).
74 .
75 Afterwards the current position will be at the opposite corner.
76 .
77 This generates a PCL fill rectangle command, and so will work on
78 printers that do not support HPGL/2 unlike the other
79 .B \eD
80 commands.
81 .
82 .
83 .\" ====================================================================
84 .SH OPTIONS
85 .\" ====================================================================
86 .
87 Whitespace is permitted between a command-line option and its argument.
88 .
89 .
90 .TP
91 .BI \-c " num-copies"
92 Print
93 .I num-copies
94 copies of each page.
95 .
96 .
97 .TP
98 .B \-l
99 Print the document with a landscape orientation.
100 .
101 .
102 .TP
103 .B \-d\c
104 .RI " [" n ]
105 Use duplex mode
106 .IR n :
107 1\ is long-side binding; 2\ is short-side binding;
108 default is\ 1.
109 .
110 .
111 .TP
112 .BI \-p " paper-size"
113 Set the paper size to
114 .IR paper-size ,
115 which must be one of
116 letter, legal, executive, a4, com10, monarch, c5, b5, dl.
117 .
118 .
119 .TP
120 .B \-v
121 .TQ
122 .B \-\-version
123 Print the version number.
124 .
125 .
126 .TP
127 .BI \-w " line-width"
128 Set the default line thickness to
129 .I line-width
130 thousandths of an em.
131 .
132 If this option isn't specified, the line thickness defaults to
133 0.04\~em.
134 .
135 .
136 .TP
137 .BI \-F " font-directory"
138 Prepend directory
139 .IR font-directory /dev name
140 to the search path for font and device description files;
141 .I name
142 is the name of the device, usually
143 .BR lj4 .
144 .
145 .
146 .LP
147 The following four commands are available additionally in the
148 font description files:
149 .
150 .
151 .TP
152 .BI pclweight \ N
153 The integer value
154 .I N
155 must be in the range \-7 to +7; default is\~0.
156 .
157 .
158 .TP
159 .BI pclstyle \ N
160 The integer value
161 .I N
162 must be in the range 0 to 32767; default is\~0.
163 .
164 .
165 .TP
166 .BI pclproportional \ N
167 A boolean flag which can be either 0 or\~1; default is\~0.
168 .
169 .
170 .TP
171 .BI pcltypeface \ N
172 The integer value
173 .I N
174 must be in the range 0 to 65535; default is\~0.
175 .
176 .
177 .\" ====================================================================
178 .SH ENVIRONMENT
179 .\" ====================================================================
180 .
181 .TP
182 .I GROFF_FONT_PATH
183 A list of directories in which to search for the
184 .IR dev name
185 directory in addition to the default ones.
186 .
187 See
188 .BR @g@troff (@MAN1EXT@)
189 and
190 .BR \%groff_font (@MAN5EXT@)
191 for more details.
192 .
193 .
194 .\" ====================================================================
195 .SH FILES
196 .\" ====================================================================
197 .
198 .TP
199 .I @FONTDIR@/devlj4/DESC
200 Device description file.
201 .
202 .TP
203 .IR @FONTDIR@/devlj4/ F
204 Font description file for font
205 .IR F .
206 .
207 .TP
208 .I @MACRODIR@/lj4.tmac
209 Macros for use with
210 .BR grolj4 .
211 .
212 .
213 .SH BUGS
214 Small dots.
215 .
216 .
217 .\" ====================================================================
218 .SH "SEE ALSO"
219 .\" ====================================================================
220 .
221 .BR lj4_font (@MAN5EXT@),
222 .BR groff (@MAN1EXT@),
223 .BR @g@troff (@MAN1EXT@),
224 .BR groff_out (@MAN5EXT@),
225 .BR groff_font (@MAN5EXT@),
226 .BR groff_char (@MAN7EXT@)
227 .
228 .
229 .\" Local Variables:
230 .\" mode: nroff
231 .\" End:
232 .\" vim: set filetype=groff: