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