grolbp - 8 series laser printers).
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... ]
GROLBP(1) General Commands Manual GROLBP(1)
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 for-
mat 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, usual-
ly lbp.
-h
--help Print a short help text.
TYPEFACES
The driver supports the Dutch, Swiss and Swiss-Narrow scalable type-
faces, 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 ap-
plies 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 follow-
ing 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 land-
scape) 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
o 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 includ-
ing) 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 de-
scription 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 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 re-
quired 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 direc-
tory 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.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | text/groff |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
SEE ALSO
groff(1), troff(1), groff_out(5), groff_font(5), groff_char(7)
COPYING
Copyright (C) 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 en-
tire resulting derived work is distributed under the terms of a permis-
sion notice identical to this one.
Permission is granted to copy and distribute translations of this manu-
al into another language, under the above conditions for modified ver-
sions, except that this permission notice may be included in transla-
tions approved by the Free Software Foundation instead of in the origi-
nal English.
Modified by Francisco Andrs Verd <pandres@dragonet.es> for the grolbp
program.
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at https://github.com/or-
acle/solaris-userland. The original community source was downloaded
from https://ftp.gnu.org/gnu/groff/groff-1.22.3.tar.gz.
Further information about this software can be found on the open source
community website at https://www.gnu.org/software/groff.
Groff Version 1.22.3 4 November 2014 GROLBP(1)