Mac Developer Library Developer
Search

 

This manual page is for Mac OS X version 10.9

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.



GROLBP(1)                                                                                          GROLBP(1)



NAME
       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 ] [ -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(1) 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_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 correspond-ing corresponding
              ing 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.

FILES
       /usr/share/groff/1.19.2/font/devlbp/DESC
              Device description file.

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

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

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



Groff Version 1.19.2                            1 March 2013                                       GROLBP(1)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Feedback