Provided by: groff_1.22.4-10_amd64 bug

NAME

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

SYNOPSIS

       grolbp [-l] [-c num-copies] [-F font-directory] [-o orientation] [-p paper-size]
              [-w width] [file ...]
       grolbp [--copies=num-copies] [--fontdir=font-directory] [--landscape] [--linewidth=width]
              [--orientation=orientation] [--papersize=paper-size] [file ...]

       grolbp -h
       grolbp --help

       grolbp -v
       grolbp --version

DESCRIPTION

       grolbp  is  a  driver  for groff that produces output in CAPSL and VDM format suitable for
       Canon LBP-4 and LBP-8 printers.

       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

       Note  that  there  can  be whitespace between a one-letter option and its argument; on the
       other hand, there must be whitespace and/or an equal sign (‘=’) between a long-name option
       and its argument.

       -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  driver supports the Dutch, Swiss and Swiss-Narrow scalable typefaces, each one in the
       Regular, Bold, Italic  and  Bold-Italic  styles.   Additionally,  the  Courier  and  Elite
       monospaced typefaces at the sizes 8 and 12 points (for Courier) resp. 8 and 10 points (for
       Elite) are supported, each one in the Regular, Bold and Italic styles.

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

                    ┌────────────────┬───────────┬────────┬──────────┬──────────────┐
                    │   Typeface     │  Regular  │  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 SIZES

       The paper size can be set in the DESC file or with command-line options to grolbp.  If the
       paper  size  is  specified  both  ways,  the command-line options take precedence over the
       contents of the DESC file (this applies to the page orientation too).

       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

       As  with the page size, the orientation of the printed page (portrait or landscape) can be
       set in the DESC file or with command-line options.  It is also case insensitive.

       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

       In addition to the usual commands described in groff_font(5), grolbp provides the  command
       lbpname  which  sets  the  font  name  sent to the printer when requesting this font.  The
       syntax of this command is:

         lbpname printer_font_name

       •      For bitmapped fonts, printer_font_name has the form

                N⟨base_fontname⟩⟨font_stylebase_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

       groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7)