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


SYNOPSIS

       grolpb [ -l ] [ --landscape ] [ -v ] [ --version ] [ -cn ]
              [ --copies=numcopies ] [ -ppaper_size ]
              [ --papersize=paper_size ] [ -oorientation ]
              [ --orientation=orientation ] [ -Fdir ]
              [ --fontdir=dir ] [ -h ] [ --help ] [ files... ]


DESCRIPTION

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

       For compatibility with grolj4 there is an additional draw­
       ing command available:

       \D'R dh dv'
              Draw  a  rule  (i.e. a solid black rectangle), with
              one corner at the current position, and the  diago­
              nally  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.

       -cnumcopies
       --copies=numcopies
              Print numcopies copies of each page.

       -l
       --landscape
              Print the document with a landscape orientation.

       -ppaper_size
       --papersize=paper_size
              Set  the  paper size to paper_size, which must be a
              valid paper size description as  indicated  in  the
              section PAPER SIZES.

       -oorientation
       --orientation=orientation
              Print  the  document  with orientation orientation,
              which must be `portrait' or `landscape'.

       -v
       --version
              Print the version number.

       --fontdir=dir
              Prepend directory dir/devlbp to the search path for
              font and device description files.

       -h
       --help Print a short help text.


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 sup­
       ported, 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).

       To  set  the  paper  size in the DESC file, insert in that
       file a line containing papersize desired_papersize,  where
       desired_papersize is:

       ·   One  of  the  recognized  paper sizes: `a4', `letter',
           `legal' or `executive'.

       ·   A custom defined paper size, as described in the  CUS­
           TOM PAPER SIZES subsection below.

       ·   The  name of a file (e.g.  /etc/papersize) whose first
           line must be the desired paper  size  in  one  of  the
           above formats.

       only the first valid one is used.

       To set the paper size in the command line, add

         -p desired_papersize

       or

         --papersize=desired_papersize

       to the other grolbp options, where desired_papersize is in
       the same format as in the DESC file.

       Paper  sizes  are case insensitive (i.e., `A4' is the same
       as `a4').

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

       CUSTOM PAPER SIZES
              Custom   defined   paper  sizes  are  in  the  form
              custlengthxwidth where length  and  width  are  the
              dimensions  of the paper you want to to use, speci­
              fied in printer units  (1/300  of  an  inch).   For
              instance,  to print in a postcard sized paper which
              is two inches long and four  inches  wide  you  can
              insert a line containing

                papersize cust600x1200

              at the beginning of the DESC file.


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]

       As with paper sizes, only the first valid orientation com­
       mand 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.

       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_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 respec­
              tively.

              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 sup­
              port  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.


FILES

       /usr/share/groff/1.17.2/font/devlbp/DESC
              Device description file.

       /usr/share/groff/1.17.2/font/devlbp/F
              Font description file for font F.

       /usr/share/groff/1.17.2/tmac/lbp.tmac
              Macros for use with grolbp.

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


Man(1) output converted with man2html