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