NAME¶

SYNOPSIS¶

DESCRIPTION¶

For compatibility with grolj4(1) there is an additional drawing command available:

\D'R dh dv'

Draw a rule (i.e., a solid black rectangle), with one corner at the current position, and the diagonally opposite corner at the current position +(dh,dv).

OPTIONS¶

-c num-copies

--copies=num-copies

Print 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.

-h

--help

Print a short help text.

-l

--landscape

Print the document with a landscape orientation.

-o orientation

--orientation=orientation

Print the document with orientation orientation, which must be ‘portrait’ or ‘landscape’.

-p paper-size

--papersize=paper-size

Set the paper size to paper-size, which must be a valid paper size description as indicated in section “Paper Sizes”, below.

-v

--version

Print the version number.

-w width

--linewidth=width

Set the default line thickness to width thousandths of an em. If this option isn't specified, the line thickness defaults to 0.04 em.

TYPEFACES¶

The following chart summarizes the font names you can use to access these fonts:

PAPER SIZES¶

See groff_font(5) how to set the paper dimensions in the DESC file.

To set the paper size in the command line, add

-p paper-size

or

--papersize=paper-size

to the other grolbp options, where paper-size is in the same format as in the DESC file.

If no paper size is specified in the DESC file or the command line, a default size of A4 is used.

PAGE ORIENTATION¶

To set the orientation in the DESC file, insert a line with the following content:

orientation [portrait|landscape]

Only the first valid orientation command in the DESC file is used.

To set the page orientation with command-line options you can use the -o or --orientation option with the same parameters (portrait or landscape) as in the DESC file. Or you can use the -l option to force the pages to be printed in landscape.

FONT FILE FORMAT¶

lbpname printer_font_name

•

For bitmapped fonts, printer_font_name has the form

N⟨base_fontname⟩⟨font_style⟩

base_fontname is the font name as it appears in the printers 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 font styles Roman, Italic and Bold respectively.

For instance, if the printer's font listing A shows font ‘Nelite12I.ISO_USA’, the corresponding entry in the font description file is

lbpname NeliteI

Note that 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 style, which appears in the printer's font listing A as ‘Swiss-Bold’, the required lbpname command line is

lbpname Swiss-Bold

The argument of lbpname is case sensitive.

ENVIRONMENT¶

GROFF_FONT_PATH

A list of directories in which to search for the devname directory in addition to the default ones. See troff(1) and groff_font(5) for more details.

FILES¶

/usr/share/groff/1.22.4/font/devlbp/DESC

Device description file.

/usr/share/groff/1.22.4/font/devlbp/F

Font description file for font F.

/usr/share/groff/1.22.4/tmac/lbp.tmac

Macros for use with grolbp.

SEE ALSO¶