bionic (1) grolbp.1.gz

Provided by: groff_1.22.3-10_amd64 bug

NAME

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

SYNOPSIS

       grolbp [ -l ] [ --landscape ] [ -v ] [ --version ] [ -cn ] [ --copies=numcopies ] [ -ppaper_size ]
              [ --papersize=paper_size ] [ -oorientation ] [ --orientation=orientation ] [ -wwidth ]
              [ --linewidth=width ] [ -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 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 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’.

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

       -v
       --version
              Print the version number.

       -Fdir
       --fontdir=dir
              Prepend directory dir/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.

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.3/font/devlbp/DESC
              Device description file.

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

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

SEE ALSO

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

COPYING

       Copyright © 1994-2014 Free Software Foundation, Inc.

       Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice
       and this permission notice are preserved on all copies.

       Permission  is  granted  to copy and distribute modified versions of this manual under the conditions for
       verbatim copying, provided that the entire resulting derived work is distributed under  the  terms  of  a
       permission notice identical to this one.

       Permission is granted to copy and distribute translations of this manual into another language, under the
       above conditions  for  modified  versions,  except  that  this  permission  notice  may  be  included  in
       translations approved by the Free Software Foundation instead of in the original English.

       Modified by Francisco Andrés Verdú <pandres@dragonet.es> for the grolbp program.