grolbp(1)

1GROLBP(1)                   General Commands Manual                  GROLBP(1)
2
3
4

NAME

6       grolbp  - groff driver for Canon CAPSL printers (LBP-4 and LBP-8 series
7       laser printers)
8

SYNOPSIS

10       grolbp [-l] [-c num-copies] [-F font-directory] [-o orientation]
11              [-p paper-size] [-w width] [file ...]
12       grolbp [--copies=num-copies] [--fontdir=font-directory] [--landscape]
13              [--linewidth=width] [--orientation=orientation]
14              [--papersize=paper-size] [file ...]
15
16       grolbp -h
17       grolbp --help
18
19       grolbp -v
20       grolbp --version
21

DESCRIPTION

23       grolbp is a driver for groff that produces output in CAPSL and VDM for‐
24       mat suitable for Canon LBP-4 and LBP-8 printers.
25
26       For compatibility with grolj4(1) there is an additional drawing command
27       available:
28
29       \D'R dh dv'
30              Draw  a rule (i.e., a solid black rectangle), with one corner at
31              the current position, and the diagonally opposite corner at  the
32              current position +(dh,dv).
33

OPTIONS

35       Note  that  there can be whitespace between a one-letter option and its
36       argument; on the other hand, there must be whitespace and/or  an  equal
37       sign (‘=’) between a long-name option and its argument.
38
39       -c num-copies
40       --copies=num-copies
41              Print num-copies copies of each page.
42
43       -F font-directory
44       --fontdir=font-directory
45              Prepend  directory font-directory/devname to the search path for
46              font and device description files; name is the name of  the  de‐
47              vice, usually lbp.
48
49       -h
50       --help Print a short help text.
51
52       -l
53       --landscape
54              Print the document with a landscape orientation.
55
56       -o orientation
57       --orientation=orientation
58              Print  the  document with orientation orientation, which must be
59              ‘portrait’ or ‘landscape’.
60
61       -p paper-size
62       --papersize=paper-size
63              Set the paper size to paper-size, which must be  a  valid  paper
64              size description as indicated in section “Paper Sizes”, below.
65
66       -v
67       --version
68              Print the version number.
69
70       -w width
71       --linewidth=width
72              Set  the  default  line thickness to width thousandths of an em.
73              If this option isn't specified, the line thickness  defaults  to
74              0.04 em.
75

TYPEFACES

77       The  driver  supports  the Dutch, Swiss and Swiss-Narrow scalable type‐
78       faces, each one in the Regular, Bold, Italic  and  Bold-Italic  styles.
79       Additionally, the Courier and Elite monospaced typefaces at the sizes 8
80       and 12 points (for Courier) resp. 8 and 10 points (for Elite) are  sup‐
81       ported, each one in the Regular, Bold and Italic styles.
82
83       The  following  chart  summarizes  the font names you can use to access
84       these fonts:
85
86          ┌────────────────┬───────────┬────────┬──────────┬──────────────┐
87          │   Typeface     │  Regular  │  Bold  │  Italic  │  Bold-Italic │
88          ├────────────────┼───────────┼────────┼──────────┼──────────────┤
89          │ Dutch          │    TR     │   TB   │    TI    │      TBI     │
90          ├────────────────┼───────────┼────────┼──────────┼──────────────┤
91          │ Swiss          │    HR     │   HB   │    HI    │      HBI     │
92          ├────────────────┼───────────┼────────┼──────────┼──────────────┤
93          │ Swiss Narrow   │    HNR    │  HNB   │   HNI    │     HNBI     │
94          ├────────────────┼───────────┼────────┼──────────┼──────────────┤
95          │ Courier        │    CR     │   CB   │    CI    │              │
96          ├────────────────┼───────────┼────────┼──────────┼──────────────┤
97          │ Elite          │    ER     │   EB   │    EI    │              │
98          └────────────────┴───────────┴────────┴──────────┴──────────────┘

PAPER SIZES

100       The paper size can be set in the DESC file or with command-line options
101       to  grolbp.  If the paper size is specified both ways, the command-line
102       options take precedence over the contents of the DESC  file  (this  ap‐
103       plies to the page orientation too).
104
105       See groff_font(5) how to set the paper dimensions in the DESC file.
106
107       To set the paper size in the command line, add
108
109         -p paper-size
110
111       or
112
113         --papersize=paper-size
114
115       to  the other grolbp options, where paper-size is in the same format as
116       in the DESC file.
117
118       If no paper size is specified in the DESC file or the command  line,  a
119       default size of A4 is used.
120

PAGE ORIENTATION

122       As with the page size, the orientation of the printed page (portrait or
123       landscape) can be set in the DESC file or  with  command-line  options.
124       It is also case insensitive.
125
126       To set the orientation in the DESC file, insert a line with the follow‐
127       ing content:
128
129         orientation [portrait|landscape]
130
131       Only the first valid orientation command in the DESC file is used.
132
133       To set the page orientation with command-line options you can  use  the
134       -o  or --orientation option with the same parameters (portrait or land‐
135       scape) as in the DESC file.  Or you can use the -l option to force  the
136       pages to be printed in landscape.
137

FONT FILE FORMAT

139       In  addition  to  the usual commands described in groff_font(5), grolbp
140       provides the command lbpname which sets  the  font  name  sent  to  the
141       printer when requesting this font.  The syntax of this command is:
142
143         lbpname printer_font_name
144
145       •      For bitmapped fonts, printer_font_name has the form
146
147                N⟨base_fontname⟩⟨font_style⟩
148
149              base_fontname  is  the  font  name as it appears in the printers
150              font listings without the first letter, up to (but  not  includ‐
151              ing)  the font size.  font_style can be one of the letters R, I,
152              or B, indicating the font styles Roman, Italic and Bold  respec‐
153              tively.
154
155              For  instance,  if  the  printer's  font  listing  A  shows font
156              ‘Nelite12I.ISO_USA’, the corresponding entry  in  the  font  de‐
157              scription file is
158
159                lbpname NeliteI
160
161              Note  that  you may need to modify grolbp to add support for new
162              bitmapped fonts, since the available font names and  font  sizes
163              of bitmapped fonts (as documented above) are hard-coded into the
164              program.
165
166       •      For scalable fonts, printer_font_name is identical to  the  font
167              name as it appears in the printer's font listing A.
168
169              For  instance,  to  select the ‘Swiss’ font in bold style, which
170              appears in the printer's font listing A as ‘Swiss-Bold’, the re‐
171              quired lbpname command line is
172
173                lbpname Swiss-Bold
174
175
176       The argument of lbpname is case sensitive.
177

ENVIRONMENT

179       GROFF_FONT_PATH
180              A  list of directories in which to search for the devname direc‐
181              tory  in  addition  to  the  default  ones.   See  troff(1)  and
182              groff_font(5) for more details.
183

FILES

185       /usr/share/groff/1.22.4/font/devlbp/DESC
186              Device description file.
187
188       /usr/share/groff/1.22.4/font/devlbp/F
189              Font description file for font F.
190
191       /usr/share/groff/1.22.4/tmac/lbp.tmac
192              Macros for use with grolbp.
193