2 .\" The above line should force the use of tbl as a preprocessor
3 .\" vim: set syntax=nroff :
4 .\" The above line should set vim into nroff mode
6 Copyright (C) 1994-2000 Free Software Foundation, Inc.
8 Permission is granted to make and distribute verbatim copies of
9 this manual provided the copyright notice and this permission notice
10 are preserved on all copies.
12 Permission is granted to copy and distribute modified versions of this
13 manual under the conditions for verbatim copying, provided that the
14 entire resulting derived work is distributed under the terms of a
15 permission notice identical to this one.
17 Permission is granted to copy and distribute translations of this
18 manual into another language, under the above conditions for modified
19 versions, except that this permission notice may be included in
20 translations approved by the Free Software Foundation instead of in
23 Modified by Francisco Andrés Verdú <pandres@dragonet.es> for the grolbp
31 .\" Like TP, but if specified indent is more than half
32 .\" the current line-length - indent, use the default indent.
34 .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
37 .TH GROLBP @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
39 grolbp \- groff driver for Canon CAPSL printers (LBP-4 and LBP-8 series laser printers).
48 .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
49 .el .RB "[\ " "\\$1" "\ ]"
56 .OP \-\-copies= numcopies
58 .OP \-\-papersize= paper_size
60 .OP \-\-orientation= orientation
65 .RI "[\ " files\|.\|.\|. "\ ]"
72 that produces output in CAPSL and VDM format suitable for Canon LBP\-4 and
75 For compatibility with grolj4 there is an additional drawing command
79 Draw a rule (i.e.\ a solid black rectangle), with one corner at the current
80 position, and the diagonally opposite corner at the current position
83 Note that there can be whitespace between a one-letter option and its
84 argument; on the other hand, there must be whitespace and/or an equal sign
85 (`=') between a long-name option and its argument.
89 .BI \-\-copies= numcopies
97 Print the document with a landscape orientation.
101 .BI \-\-papersize= paper_size
102 Set the paper size to
104 which must be a valid paper size description as indicated in the section
109 .BI \-\-orientation= orientation
110 Print the document with
112 orientation, which must be `portrait' or `landscape'.
117 Print the version number.
124 for font and device description files.
129 Print a short help text.
131 The driver supports the Dutch, Swiss and Swiss-Narrow scalable typefaces,
132 each one in the Regular, Bold, Italic and Bold-Italic styles.
133 Additionally, the Courier and Elite monospaced typefaces at the sizes 8 and
134 12 points (for Courier) resp. 8 and 10 points (for Elite) are supported,
135 each one in the Regular, Bold and Italic styles.
137 The following chart summarizes the font names you can use to access these
141 tab(|) allbox center;
145 Typeface | Regular | Bold | Italic | Bold-Italic
146 Dutch | TR | TB | TI | TBI
147 Swiss | HR | HB | HI | HBI
148 Swiss Narrow | HNR | HNB | HNI | HNBI
149 Courier | CR | CB | CI |
150 Elite | ER | EB | EI |
154 The paper size can be set in the
156 file or with command line options to
158 If the paper size is specified both ways, the command line options take
159 precedence over the contents of the
161 file (this applies to the page orientation too).
163 To set the paper size in the
165 file, insert in that file a line containing
167 .IR desired_papersize ,
172 One of the recognized paper sizes: `a4', `letter', `legal' or `executive'.
174 A custom defined paper size, as described in the
175 .B CUSTOM PAPER SIZES
178 The name of a file (e.g.
180 whose first line must be the desired paper size in one of the above formats.
182 If there are various papersize lines in the
184 file, only the first valid one is used.
186 To set the paper size in the command line, add
189 .BI \-p \ desired_papersize
195 .BI \-\-papersize= desired_papersize
202 is in the same format as in the
206 Paper sizes are case insensitive (i.e., `A4' is the same as `a4').
208 If no paper size is specified in the
210 file or the command line, a default size of A4 is used.
212 .SH CUSTOM PAPER SIZES
213 Custom defined paper sizes are in the form
214 .BI cust length x width
219 are the dimensions of the paper you want to to use, specified in printer
220 units (1/300 of an inch).
221 For instance, to print in a postcard sized paper which is two inches long
222 and four inches wide you can insert a line containing
225 .B papersize cust600x1200
228 at the beginning of the
232 As with the page size, the orientation of the printed page
238 file or with command line options.
239 It is also case insensitive.
241 To set the orientation in the
243 file, insert a line with the following content:
247 .RB [ portrait | landscape ]
250 As with paper sizes, only the first valid orientation command in the
254 To set the page orientation with command line options you can use the
258 option with the same parameters
267 option to force the pages to be printed in landscape.
269 In addition to the usual commands described in
270 .BR groff_font (@MAN5EXT@),
274 which sets the font name sent to the printer when requesting this font.
275 The syntax of this command is:
287 .RI N\(la base_fontname \(ra\(la font_style \(ra
291 is the font name as it appears in the printers font listings without the
292 first letter, up to (but not including) the font size.
294 can be one of the letters
299 indicating the font styles Roman, Italic and Bold respectively.
301 For instance, if the printer's
303 shows font `Nelite12I.ISO_USA', the corresponding entry in the font
310 Note that you may need to modify
312 to add support for new bitmapped fonts, since the available font names and
313 font sizes of bitmapped fonts (as documented above) are hard-coded into the
318 is identical to the font name as it appears in the printer's
319 .IR "font listing A" .
321 For instance, to select the `Swiss' font in bold style, which appears in
324 as `Swiss-Bold', the required
329 .B lbpname Swiss-Bold
338 .B @FONTDIR@/devlbp/DESC
339 Device description file.
341 .BI @FONTDIR@/devlbp/ F
342 Font description file for font
345 .BR groff (@MAN1EXT@),
346 .BR @g@troff (@MAN1EXT@),
347 .BR groff_out (@MAN5EXT@),
348 .BR groff_font (@MAN5EXT@),
349 .BR groff_char (@MAN7EXT@)