Copyright (C) 1994-2000, 2002 Free Software Foundation, Inc.

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

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

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

<p>Modified by Francisco Andrés Verdú &lt;pandres@dragonet.es&gt; for the grolbp
program.
<!--#exec cmd="header grolbp" -->
<ul>
</ul><H2>NAME </H2><ul>

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

</ul><H2>SYNOPSIS </H2><ul>

<br>
<b>grolpb</b> 
[ <i>files...</i> ]
<br>

</ul><H2>DESCRIPTION </H2><ul>

<b>grolbp</b> 
is a driver for
<b>groff</b> 
that produces output in CAPSL and VDM format suitable for Canon LBP-4 and
LBP-8 printers.

<p>
For compatibility with grolj4 there is an additional drawing command
available:
<p><dl compact><dt><b>\D'R </b><i>dh dv</i><b>'</b>
<dd>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
+(<i>dh</i>,<i>dv</i>).
</dl>
</ul><H2>OPTIONS </H2><ul>

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.
<p><dl compact><dt><b>-c</b><i>numcopies</i>
<dt><b>--copies=</b><i>numcopies</i>
<dd>Print
<i>numcopies</i> 
copies of each page.
<dt><b>-l</b> 
<dt><b>--landscape</b> 
<dd>Print the document with a landscape orientation.
<dt><b>-p</b><i>paper_size</i>
<dt><b>--papersize=</b><i>paper_size</i>
<dd>Set the paper size to
<i>paper_size</i>,
which must be a valid paper size description as indicated in the section
<b>PAPER SIZES</b>.
<dt><b>-o</b><i>orientation</i>
<dt><b>--orientation=</b><i>orientation</i>
<dd>Print the document with
<i>orientation</i> 
orientation, which must be `portrait' or `landscape'.
<dt><b>-w</b><i>width</i>
<dt><b>--linewidth=</b><i>width</i>
<dd>Set the default line thickness to
<i>width</i> 
thousandths of an em.
If this option isn't specified, the line thickness defaults to 0.04~em.
<dt><b>-v</b> 
<dt><b>--version</b> 
<dd>Print the version number.
<dt><b>-F</b><i>dir</i>
<dt><b>--fontdir=</b><i>dir</i>
<dd>Prepend directory
<i>dir</i><b>/dev</b><i>name</i>
to the search path for font and device description files;
<i>name</i> 
is the name of the device, usually
<b>lbp</b>.
<dt><b>-h</b> 
<dt><b>--help</b> 
<dd>Print a short help text.
</dl>
</ul><H2>TYPEFACES </H2><ul>

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.

<p>
The following chart summarizes the font names you can use to access these
fonts:

<p>
tab(|) allbox center;
c c c c c
ab c c c c
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 |

<p>

</ul><H2>PAPER SIZES </H2><ul>

The paper size can be set in the
<b>DESC</b> 
file or with command line options to
<b>grolbp</b>.
If the paper size is specified both ways, the command line options take
precedence over the contents of the
<b>DESC</b> 
file (this applies to the page orientation too).

<p>
See
<b>groff_font</b>(1)
how to set the paper dimensions in the
<b>DESC</b> 
file.

<p>
To set the paper size in the command line, add

<p>
<b>-p</b><i> paper-size</i>

<p>
or

<p>
<b>--papersize=</b><i>paper-size</i>

<p>
to the other
<b>grolbp</b> 
options, where
<i>paper-size</i> 
is in the same format as in the
<b>DESC</b> 
file.

<p>
If no paper size is specified in the
<b>DESC</b> 
file or the command line, a default size of A4 is used.

</ul><H2>PAGE ORIENTATION </H2><ul>

As with the page size, the orientation of the printed page
(<b>portrait</b>
or
<b>landscape</b>)
can be set in the
<b>DESC</b> 
file or with command line options.
It is also case insensitive.

<p>
To set the orientation in the
<b>DESC</b> 
file, insert a line with the following content:

<p>
<b>orientation</b> 
[<b>portrait</b>|<b>landscape</b>]

<p>
Only the first valid orientation command in the
<b>DESC</b> 
file is used.

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

</ul><H2>FONT FILE FORMAT </H2><ul>

In addition to the usual commands described in
<b>groff_font</b>(5),
<b>grolbp</b> 
provides the command
<i>lbpname</i> 
which sets the font name sent to the printer when requesting this font.
The syntax of this command is:

<p>
<b>lbpname</b> 
<i>printer_font_name</i> 
<p><dl compact><dt><li><dd>For bitmapped fonts,
<i>printer_font_name</i> 
has the form
</dl>
<p>
N<i>base_fontname</i><i>font_style</i>

<p>
<i>base_fontname</i> 
is the font name as it appears in the printers font listings without the
first letter, up to (but not including) the font size.
<i>font_style</i> 
can be one of the letters
<b>R</b>,
<b>I</b>,
or
<b>B</b>,
indicating the font styles Roman, Italic and Bold respectively.
<p><dl compact><dt><dd>For instance, if the printer's 
<i>font</i> <i>listing</i> <i>A</i> 
shows font `Nelite12I.ISO_USA', the corresponding entry in the font
description file is
</dl>
<p>
<b>lbpname</b> <b>NeliteI</b> 
<p><dl compact><dt><dd>Note that you may need to modify
<b>grolbp</b> 
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.
<dt><li><dd>For scalable fonts,
<i>printer_font_name</i> 
is identical to the font name as it appears in the printer's 
<i>font listing A</i>.
<dt><dd>For instance, to select the `Swiss' font in bold style, which appears in
the printer's
<i>font</i> <i>listing</i> <i>A</i> 
as `Swiss-Bold', the required
<b>lbpname</b> 
command line is
</dl>
<p>
<b>lbpname</b> <b>Swiss-Bold</b> 

<p>

<p>
The argument of
<b>lbpname</b> 
is case sensitive.

</ul><H2>FILES </H2><ul>

<p><dl compact><dt><b>/usr/site/groff-1.19.1/share/font/devlbp/DESC</b> 
<dd>Device description file.
<dt><b>/usr/site/groff-1.19.1/share/font/devlbp/</b><i>F</i>
<dd>Font description file for font
<i>F</i>.
<dt><b>/usr/site/groff-1.19.1/share/tmac/lbp.tmac</b> 
<dd>Macros for use with
<b>grolbp</b>.
</dl>
</ul><H2>SEE ALSO </H2><ul>

<b>groff</b>(1),
<b>troff</b>(1),
<b>groff_out</b>(5),
<b>groff_font</b>(5),
<b>groff_char</b>(7)
</ul>
<!--#exec cmd="trailer" -->