This GNU roff output driver translates the output of troff(1)
into a CaPSL and VDM format suitable for Canon LBP-4 and LBP-8
printers. Normally, grolbp is invoked by groff(1) when the
latter is given the “-T lbp” option. (In this installation, ps
is the default output device.) Use groff's -P option to pass any
options shown above to grolbp. If no file arguments are given,
or if file is “-”, grolbp reads the standard input stream.
Output is written to the standard output stream.
The driver supports the Dutch, Swiss, and Swiss-Narrow scalable
typefaces, each in the regular, bold, italic, and bold-italic
styles. Additionally, the bitmapped, monospaced Courier and
Elite typefaces are available in regular, bold, and italic
styles; Courier at 8 and 12 points, Elite at 8 and 10 points.
The following chart summarizes the groff font names used to
│ Typeface │ Roman │ Bold │ Italic │ Bold-Italic │
│Dutch │ TR │ TB │ TI │ TBI │
│Swiss │ HR │ HB │ HI │ HBI │
│Swiss Narrow │ HNR │ HNB │ HNI │ HNBI │
│Courier │ CR │ CB │ CI │ │
│Elite │ ER │ EB │ EI │ │
Paper format, orientation, and device description filegrolbp supports paper formats “A4”, “letter”, “legal”, and
“executive”. These are matched case-insensitively. The -p,
--papersize option overrides any setting in the device
description file DESC. If neither specifies a paper format, A4
In its DESC file, grolbp (case-insensitively) recognizes an
orientation directive accepting one mandatory argument, portrait
or landscape. The first valid orientation directive encountered
controls. The -l, -o, and --orientation command-line options
override any setting in DESC. If none of the foregoing specify
the orientation, portrait is assumed.
Font description files
In addition to the font description file directives documented in
groff_font(5), grolbp recognizes lbpname, which maps the groff
font name to the font name used internally by the printer. Its
syntax is as follows.
lbpname printer-font-namelbpname's argument is case-sensitive. The printer's font names
are encoded as follows.
For bitmapped fonts, printer-font_name has the form
base-font-name is the font name as it appears in the printer's
font listings without the first letter, up to (but not including)
the font size. font-style can be one of the letters R, I, or B,
indicating the roman, italic, and bold styles, respectively. For
instance, if the printer's “font listing A” shows
“Nelite12I.ISO_USA”, the corresponding entry in the groff font
description file is
You may need to modify grolbp to add support for new bitmapped
fonts, since the available font names and font sizes of bitmapped
fonts (as documented above) are hard-coded into the program.
For scalable fonts, printer-font-name is identical to the font
name as it appears in the printer's “font listing A”. For
instance, to select the “Swiss” font in bold-italic style, which
appears in the font listing as “Swiss-BoldOblique”,
is the required directive, and this is what we find in the groff
font description file HBI for the lbp device.
For compatibility with grolj4(1), an additional drawing command
\D'R dh dv'
Draw a rule (solid black rectangle) with one corner at the
drawing position, and the diagonally opposite corner at
the drawing position +(dh,dv).
-h and --help display a usage message, while -v and --version
show version information; all exit afterward.
Produce num-copies copies of each page.
Prepend directory font-directory/devname to the search
path for font and device description files; name is the
name of the device, usually lbp.
Format the document in landscape orientation.
Format the document in the given orientation, which must
be “portrait” or “landscape”.
Set the paper format to paper-format, which must be a
valid paper format as described above.
Set the default line thickness to width thousandths of an
em; the default is 40 (0.04 em).
describes the lbp output device.
describes the font known as F on device lbp.
defines macros for use with the lbp output device. It is
automatically loaded by troffrc when the lbp output device
This page is part of the groff (GNU troff) project. Information
about the project can be found at
⟨http://www.gnu.org/software/groff/⟩. If you have a bug report
for this manual page, see ⟨http://www.gnu.org/software/groff/⟩.
This page was obtained from the project's upstream Git repository
⟨https://git.savannah.gnu.org/git/groff.git⟩ on 2023-06-23. (At
that time, the date of the most recent commit that was found in
the repository was 2023-06-23.) If you discover any rendering
problems in this HTML version of the page, or you believe there
is a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
groff 1.23.0.rc4.250-1b2b6-dirt2y2 June 2023 grolbp(1)