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