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       grolpb [ -l ] [ --landscape ] [ -v ] [ --version ] [ -cn ]
11              [ --copies=numcopies ] [ -ppaper_size ]
12              [ --papersize=paper_size ] [ -oorientation ]
13              [ --orientation=orientation ] [ -wwidth ] [ --linewidth=width ]
14              [ -Fdir ] [ --fontdir=dir ] [ -h ] [ --help ] [ files... ]
15

DESCRIPTION

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

OPTIONS

29       Note that there can be whitespace between a one-letter option  and  its
30       argument;  on  the other hand, there must be whitespace and/or an equal
31       sign (`=') between a long-name option and its argument.
32
33       -cnumcopies
34       --copies=numcopies
35              Print numcopies copies of each page.
36
37       -l
38       --landscape
39              Print the document with a landscape orientation.
40
41       -ppaper_size
42       --papersize=paper_size
43              Set the paper size to paper_size, which must be  a  valid  paper
44              size description as indicated in the section PAPER SIZES.
45
46       -oorientation
47       --orientation=orientation
48              Print  the  document with orientation orientation, which must be
49              `portrait' or `landscape'.
50
51       -wwidth
52       --linewidth=width
53              Set the default line thickness to width thousandths  of  an  em.
54              If  this  option isn't specified, the line thickness defaults to
55              0.04 em.
56
57       -v
58       --version
59              Print the version number.
60
61       -Fdir
62       --fontdir=dir
63              Prepend directory dir/devname to the search path  for  font  and
64              device description files; name is the name of the device, usual‐
65              ly lbp.
66
67       -h
68       --help Print a short help text.
69

TYPEFACES

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

PAPER SIZES

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

PAGE ORIENTATION

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

FONT FILE FORMAT

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

ENVIRONMENT

173       GROFF_FONT_PATH
174              A list of directories in which to search for the devname  direc‐
175              tory  in  addition  to  the  default  ones.   See  troff(1)  and
176              groff_font(5) for more details.
177

FILES

179       /usr/share/groff/1.20.1/font/devlbp/DESC
180              Device description file.
181
182       /usr/share/groff/1.20.1/font/devlbp/F
183              Font description file for font F.
184
185       /usr/share/groff/1.20.1/tmac/lbp.tmac
186              Macros for use with grolbp.
187