/contrib/groff/src/devices/grolbp/grolbp.man

  1'\" t
  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
  5.ig
  6Copyright (C) 1994-2000, 2002 Free Software Foundation, Inc.
  7
  8Permission is granted to make and distribute verbatim copies of
  9this manual provided the copyright notice and this permission notice
 10are preserved on all copies.
 11
 12Permission is granted to copy and distribute modified versions of this
 13manual under the conditions for verbatim copying, provided that the
 14entire resulting derived work is distributed under the terms of a
 15permission notice identical to this one.
 16
 17Permission is granted to copy and distribute translations of this
 18manual into another language, under the above conditions for modified
 19versions, except that this permission notice may be included in
 20translations approved by the Free Software Foundation instead of in
 21the original English.
 22
 23Modified by Francisco Andrés Verdú <pandres@dragonet.es> for the grolbp
 24program.
 25..
 26.de TQ
 27.br
 28.ns
 29.TP \\$1
 30..
 31.\" Like TP, but if specified indent is more than half
 32.\" the current line-length - indent, use the default indent.
 33.de Tp
 34.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
 35.el .TP "\\$1"
 36..
 37.TH GROLBP @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
 38.
 39.SH NAME
 40grolbp \- groff driver for Canon CAPSL printers (LBP-4 and LBP-8 series laser printers).
 41.
 42.SH SYNOPSIS
 43.nr a \n(.j
 44.ad l
 45.nh
 46.nr i \n(.i
 47.in +\w'\fBgrolbp 'u
 48.ti \niu
 49.B grolpb
 50.de OP
 51.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]"
 52.el .RB "[\ " "\\$1" "\ ]"
 53..
 54.OP \-l
 55.OP \-\-landscape
 56.OP \-v
 57.OP \-\-version
 58.OP \-c n
 59.OP \-\-copies= numcopies
 60.OP \-p paper_size
 61.OP \-\-papersize= paper_size
 62.OP \-o orientation
 63.OP \-\-orientation= orientation
 64.OP \-w width
 65.OP \-\-linewidth= width
 66.OP \-F dir
 67.OP \-\-fontdir= dir
 68.OP \-h
 69.OP \-\-help
 70.RI "[\ " files\|.\|.\|. "\ ]"
 71.br
 72.ad \na
 73.hy
 74.
 75.SH DESCRIPTION
 76.B grolbp
 77is a driver for
 78.B groff
 79that produces output in CAPSL and VDM format suitable for Canon LBP\-4 and
 80LBP\-8 printers.
 81.LP
 82For compatibility with grolj4 there is an additional drawing command
 83available:
 84.TP
 85.BI \eD'R\  dh\ dv '
 86Draw a rule (i.e.\ a solid black rectangle), with one corner at the current
 87position, and the diagonally opposite corner at the current position
 88.RI +( dh , dv ).
 89.SH OPTIONS
 90Note that there can be whitespace between a one-letter option and its
 91argument; on the other hand, there must be whitespace and/or an equal sign
 92(`=') between a long-name option and its argument.
 93.TP
 94.BI \-c numcopies
 95.TQ
 96.BI \-\-copies= numcopies
 97Print
 98.I numcopies
 99copies of each page.
100.TP
101.B \-l
102.TQ
103.B \-\-landscape
104Print the document with a landscape orientation.
105.TP
106.BI \-p paper_size
107.TQ
108.BI \-\-papersize= paper_size
109Set the paper size to
110.IR paper_size ,
111which must be a valid paper size description as indicated in the section
112.BR "PAPER SIZES" .
113.TP
114.BI \-o orientation
115.TQ
116.BI \-\-orientation= orientation
117Print the document with
118.I orientation
119orientation, which must be `portrait' or `landscape'.
120.TP
121.BI \-w width
122.TQ
123.BI \-\-linewidth= width
124Set the default line thickness to
125.I width
126thousandths of an em.
127If this option isn't specified, the line thickness defaults to 0.04\~em.
128.TP
129.B \-v
130.TQ
131.B \-\-version
132Print the version number.
133.TP
134.BI \-F dir
135.TQ
136.BI \-\-fontdir= dir
137Prepend directory
138.IB dir /dev name
139to the search path for font and device description files;
140.I name
141is the name of the device, usually
142.BR lbp .
143.TP
144.B \-h
145.TQ
146.B \-\-help
147Print a short help text.
148.SH TYPEFACES
149The driver supports the Dutch, Swiss and Swiss-Narrow scalable typefaces,
150each one in the Regular, Bold, Italic and Bold-Italic styles.
151Additionally, the Courier and Elite monospaced typefaces at the sizes 8 and
15212 points (for Courier) resp. 8 and 10 points (for Elite) are supported,
153each one in the Regular, Bold and Italic styles.
154.PP
155The following chart summarizes the font names you can use to access these
156fonts:
157.PP
158.TS
159tab(|) allbox center;
160c c c c c
161ab c c c c
162.
163Typeface | Regular | Bold | Italic | Bold-Italic
164Dutch | TR | TB | TI | TBI
165Swiss | HR | HB | HI | HBI
166Swiss Narrow | HNR | HNB | HNI | HNBI
167Courier | CR | CB | CI |
168Elite | ER | EB | EI |
169.TE
170.PP
171.SH PAPER SIZES
172The paper size can be set in the
173.B DESC
174file or with command line options to
175.BR grolbp .
176If the paper size is specified both ways, the command line options take
177precedence over the contents of the
178.B DESC
179file (this applies to the page orientation too).
180.PP
181See
182.BR groff_font (@MAN1EXT@)
183how to set the paper dimensions in the
184.B DESC
185file.
186.PP
187To set the paper size in the command line, add
188.sp 1
189.in +2m
190.BI \-p \ paper-size
191.in -2m
192.sp 1
193or
194.sp 1
195.in +2m
196.BI \-\-papersize= paper-size
197.in -2m
198.sp 1
199to the other
200.B grolbp
201options, where
202.I paper-size
203is in the same format as in the
204.B DESC
205file.
206.PP
207If no paper size is specified in the
208.B DESC
209file or the command line, a default size of A4 is used.
210.SH PAGE ORIENTATION
211As with the page size, the orientation of the printed page
212.RB ( portrait
213or
214.BR landscape )
215can be set in the
216.B DESC
217file or with command line options.
218It is also case insensitive.
219.PP
220To set the orientation in the
221.B DESC
222file, insert a line with the following content:
223.sp 1
224.in +2m
225.B orientation
226.RB [ portrait | landscape ]
227.in -2m
228.sp 1
229Only the first valid orientation command in the
230.B DESC
231file is used.
232.PP
233To set the page orientation with command line options you can use the
234.B \-o
235or
236.B \-\-orientation
237option with the same parameters
238.RB ( portrait
239or
240.BR landscape )
241as in the
242.B DESC
243file.
244Or you can use the
245.B \-l
246option to force the pages to be printed in landscape.
247.SH FONT FILE FORMAT
248In addition to the usual commands described in
249.BR groff_font (@MAN5EXT@),
250.B grolbp
251provides the command
252.I lbpname
253which sets the font name sent to the printer when requesting this font.
254The syntax of this command is:
255.sp 1
256.in +2m
257.B lbpname
258.I printer_font_name
259.in -2m
260.IP \(bu
261For bitmapped fonts,
262.I printer_font_name
263has the form
264.sp 1
265.in +2m
266.RI N\(la base_fontname \(ra\(la font_style \(ra
267.in -2m
268.sp 1
269.I base_fontname 
270is the font name as it appears in the printers font listings without the
271first letter, up to (but not including) the font size.
272.I font_style
273can be one of the letters
274.BR R ,
275.BR I ,
276or
277.BR B ,
278indicating the font styles Roman, Italic and Bold respectively.
279.IP
280For instance, if the printer's 
281.I font listing A
282shows font `Nelite12I.ISO_USA', the corresponding entry in the font
283description file is
284.sp 1
285.in +2m
286.B lbpname NeliteI
287.in -2m
288.IP
289Note that you may need to modify
290.B grolbp
291to add support for new bitmapped fonts, since the available font names and
292font sizes of bitmapped fonts (as documented above) are hard-coded into the
293program.
294.IP \(bu
295For scalable fonts,
296.I printer_font_name
297is identical to the font name as it appears in the printer's 
298.IR "font listing A" .
299.IP
300For instance, to select the `Swiss' font in bold style, which appears in
301the printer's
302.I font listing A
303as `Swiss-Bold', the required
304.B lbpname
305command line is
306.sp 1
307.in +2m
308.B lbpname Swiss-Bold
309.in -2m
310.sp 1
311.PP
312The argument of
313.B lbpname
314is case sensitive.
315.SH FILES
316.TP
317.B @FONTDIR@/devlbp/DESC
318Device description file.
319.TP
320.BI @FONTDIR@/devlbp/ F
321Font description file for font
322.IR F .
323.TP
324.B @MACRODIR@/lbp.tmac
325Macros for use with
326.BR grolbp .
327.SH SEE ALSO
328.BR groff (@MAN1EXT@),
329.BR @g@troff (@MAN1EXT@),
330.BR groff_out (@MAN5EXT@),
331.BR groff_font (@MAN5EXT@),
332.BR groff_char (@MAN7EXT@)
333.\"
334.\" Local Variables:
335.\" mode: nroff
336.\" End: