man pages section 1: User Commands

Exit Print View

Updated: July 2014

grolbp (1)


grolbp - 4 and LBP-8 series laser printers).


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


User Commands                                           GROLBP(1)

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

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

     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 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 op-
          posite corner at the current position +(dh,dv).

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

          Print numcopies copies of each page.

          Print the document with a landscape orientation.

          Set the paper size to paper_size, which must be a valid
          paper size description as indicated in the section  PA-
          PER SIZES.

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

          Set the default line thickness to width thousandths  of

Groff Version 1.19Last change: 23 September 2002                1

User Commands                                           GROLBP(1)

          an em.  If this option isn't specified, the line thick-
          ness defaults to 0.04 em.

          Print the version number.

          Prepend directory dir/devname to the  search  path  for
          font  and device description files; name is the name of
          the device, usually lbp.

          Print a short help text.

     The driver supports the Dutch, Swiss and Swiss-Narrow  scal-
     able  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    |              |
     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 con-
     tents of the DESC file (this applies to the page orientation

     See groff_font(1) how to set the paper dimensions in the DE-
     SC file.

Groff Version 1.19Last change: 23 September 2002                2

User Commands                                           GROLBP(1)

     To set the paper size in the command line, add

       -p 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  com-
     mand line, a default size of A4 is used.

     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

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

     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

     o    For bitmapped fonts, printer_font_name has the form


          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

Groff Version 1.19Last change: 23 September 2002                3

User Commands                                           GROLBP(1)

          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.

     o    For  scalable  fonts, printer_font_name is identical to
          the font name as it appears in the printer's font list-
          ing 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.

          Device description file.

          Font description file for font F.

          Macros for use with grolbp.

     See  attributes(5)  for  descriptions  of  the following at-

     |Availability   | text/groff       |
     |Stability      | Uncommitted      |
     groff(1),    gtroff(1),     groff_out(5),     groff_font(5),

Groff Version 1.19Last change: 23 September 2002                4

User Commands                                           GROLBP(1)

     This software was built from source available at https://ja-   The  original  community
     source             was            downloaded            from

     Further information about this software can be found on  the
     open  source  community  website at

Groff Version 1.19Last change: 23 September 2002                5