grolbp(1)

🎀 grolbp(1) — General Commands Manual 🎀

okay bestie, this is the manual page for grolbp, and it's lowkey a whole vibe: it's the groff output driver for Canon CaPSL printers. 💅

🍓 NAME 🍓

grolbp — groff output driver for Canon CaPSL printers. ✨

🌸 SYNOPSIS 🌸

grolbp [-l] [-c num-copies] [-F font-directory] [-o orientation]
       [-p paper-format] [-w width] [file ...]

grolbp [--copies=num-copies] [--fontdir=font-directory] [--landscape]
       [--linewidth=width] [--orientation=orientation]
       [--papersize=paper-format] [file ...]

grolbp -h

grolbp --help

grolbp -v

grolbp --version

💖 DESCRIPTION 💖

okay so grolbp is a GNU roff output driver that 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. It writes to the standard output stream. 💌

🦋 Typefaces 🦋

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 access them. Here's the cheat sheet, listified but with all the tea intact: 💅

• Dutch — Roman TR; Bold TB; Italic TI; Bold-Italic TBI
• Swiss — Roman HR; Bold HB; Italic HI; Bold-Italic HBI
• Swiss Narrow — Roman HNR; Bold HNB; Italic HNI; Bold-Italic HNBI
• Courier — Roman CR; Bold CB; Italic CI
• Elite — Roman ER; Bold EB; Italic EI

🎀 Paper format, orientation, and device description file 🎀

grolbp 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 is assumed. 🗂️

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-name

lbpname's argument is case-sensitive. The printer's font names are encoded as follows. 🔍

For bitmapped fonts, printer-font_name has the form N⟨base-font-name⟩⟨font-style⟩. 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 lbpname NeliteI. 😭

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, lbpname Swiss-BoldOblique is the required directive, and this is what we find in the groff font description file HBI for the lbp device. 🌟

✏️ Drawing commands ✏️

For compatibility with grolj4(1), an additional drawing command is available. 🖍️

\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). 🖤

💅 OPTIONS 💅

• -h, --help — display a usage message; exits afterward. 🫶
• -v, --version — show version information; exits afterward. ⭐
• -c num-copies, --copies=num-copies — produce num-copies copies of each page. 📄
• -F font-directory, --fontdir=font-directory — prepend directory font-directory/devname to the search path for font and device description files; name is the name of the device, usually lbp. 🔎
• -l, --landscape — format the document in landscape orientation. 🌅
• -o orientation, --orientation=orientation — format the document in the given orientation, which must be portrait or landscape. 🧭
• -p paper-format, --papersize=paper-format — set the paper format to paper-format, which must be a valid paper format as described above. 📐
• -w width, --linewidth=width — set the default line thickness to width thousandths of an em; the default is 40 (0.04 em). ✨

🚦 EXIT STATUS 🚦

grolbp exits with status 0 on successful operation, status 2 if the program cannot interpret its command-line arguments, and status 1 if it encounters an error during operation. 🙈

🌿 ENVIRONMENT 🌿

• GROFF_FONT_PATH — lists directories in which to seek the selected output device's directory of device and font description files. See troff(1) and groff_font(5). 🍃

🗂️ FILES 🗂️

• /usr/share/groff/1.24.2/font/devlbp/DESC — describes the lbp output device. 🎀
• /usr/share/groff/1.24.2/font/devlbp/F — describes the font known as F on device lbp. 🔤
• /usr/share/groff/1.24.2/tmac/lbp.tmac — defines macros for use with the lbp output device. It is automatically loaded by troffrc when the lbp output device is selected. 🪄

👀 SEE ALSO 👀

groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7) — go read these too, bestie. 💖

---

k that's the whole page, periodt. 💅 This one is from groff 1.24.2, dated 2026-10-01, and it's the grolbp(1) manual. 🎀✨