diff options
Diffstat (limited to 'upstream/debian-bookworm/man1/grolbp.1')
| -rw-r--r-- | upstream/debian-bookworm/man1/grolbp.1 | 456 |
1 files changed, 456 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/grolbp.1 b/upstream/debian-bookworm/man1/grolbp.1 new file mode 100644 index 00000000..b49ab299 --- /dev/null +++ b/upstream/debian-bookworm/man1/grolbp.1 @@ -0,0 +1,456 @@ +'\" t +.TH GROLBP 1 "7 March 2023" "groff 1.22.4" +.SH NAME +grolbp \- groff driver for Canon CAPSL printers (LBP-4 and LBP-8 \ +series laser printers) +. +. +.\" Save and disable compatibility mode (for, e.g., Solaris 10/11). +.do nr grolbp_C \n[.C] +.cp 0 +. +. +.\" Modified by Francisco Andrés Verdú <pandres@dragonet.es> for the +.\" grolbp program. +. +. +.\" ==================================================================== +.\" Legal Terms +.\" ==================================================================== +.\" +.\" Copyright (C) 1994-2018 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. +. +. +.\" ==================================================================== +.SH SYNOPSIS +.\" ==================================================================== +. +.SY grolbp +.OP \-l +.OP \-c num-copies +.OP \-F font-directory +.OP \-o orientation +.OP \-p paper-size +.OP \-w width +.RI [ file +\&.\|.\|.\&] +.SY grolbp +[\c +.BI \-\-copies= num-copies\c +] [\c +.BI \-\-fontdir= font-directory\c +] [\c +.B \-\-landscape\c +] [\c +.BI \-\-linewidth= width\c +] [\c +.BI \-\-orientation= orientation\c +] [\c +.BI \-\-papersize= paper-size\c +] +.RI [ file +\&.\|.\|.\&] +.YS +. +.SY grolbp +.B \-h +.SY grolbp +.B \-\-help +.YS +. +.SY grolbp +.B \-v +.SY grolbp +.B \-\-version +.YS +. +. +.\" ==================================================================== +.SH DESCRIPTION +.\" ==================================================================== +. +.B grolbp +is a driver for +.B groff +that produces output in CAPSL and VDM format suitable for Canon LBP-4 +and LBP-8 printers. +. +. +.LP +For compatibility with +.BR grolj4 (1) +there is an additional drawing command available: +. +.TP +.BI \eD'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 +.RI +( dh , dv ). +. +. +.\" ==================================================================== +.SH 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 +(\(oq=\(cq) between a long-name option and its argument. +. +. +.TP +.BI \-c " num-copies" +.TQ +.BI \-\-copies= num-copies +Print +.I num-copies +copies of each page. +. +. +.TP +.BI \-F " font-directory" +.TQ +.BI \-\-fontdir= font-directory +Prepend directory +.RI font-directory /dev name +to the search path for font and device description files; +.I name +is the name of the device, usually +.BR lbp . +. +. +.TP +.B \-h +.TQ +.B \-\-help +Print a short help text. +. +. +.TP +.B \-l +.TQ +.B \-\-landscape +Print the document with a landscape orientation. +. +. +.TP +.BI \-o " orientation" +.TQ +.BI \-\-orientation= orientation +Print the document with +.I orientation +orientation, which must be \(oqportrait\(cq or \(oqlandscape\(cq. +. +. +.TP +.BI \-p " paper-size" +.TQ +.BI \-\-papersize= paper-size +Set the paper size to +.IR paper-size , +which must be a valid paper size description as indicated in section +\[lq]Paper Sizes\[rq], below. +. +. +.TP +.B \-v +.TQ +.B \-\-version +Print the version number. +. +. +.TP +.BI \-w " width" +.TQ +.BI \-\-linewidth= width +Set the default line thickness to +.I width +thousandths of an em. +. +If this option isn't specified, the line thickness defaults to 0.04\~em. +. +. +.\" ==================================================================== +.SH 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. +. +. +.PP +The following chart summarizes the font names you can use to access +these fonts: +. +. +.PP +.TS +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 | +.TE +. +. +.\" ==================================================================== +.SH PAPER SIZES +.\" ==================================================================== +. +The paper size can be set in the +.I DESC +file or with command-line options to +.BR grolbp . +If the paper size is specified both ways, the command-line options take +precedence over the contents of the +.I DESC +file (this applies to the page orientation too). +. +. +.PP +See +.BR groff_font (5) +how to set the paper dimensions in the +.I DESC +file. +. +. +.PP +To set the paper size in the command line, add +.sp 1 +.in +2m +.BI \-p \ paper-size +.in -2m +.sp 1 +or +.sp 1 +.in +2m +.BI \-\-papersize= paper-size +.in -2m +.sp 1 +to the other +.B grolbp +options, where +.I paper-size +is in the same format as in the +.I DESC +file. +. +. +.PP +If no paper size is specified in the +.I DESC +file or the command line, a default size of A4 is used. +. +. +.\" ==================================================================== +.SH PAGE ORIENTATION +.\" ==================================================================== +. +As with the page size, the orientation of the printed page +.RB ( portrait +or +.BR landscape ) +can be set in the +.I DESC +file or with command-line options. +. +It is also case insensitive. +. +. +.PP +To set the orientation in the +.I DESC +file, insert a line with the following content: +.sp 1 +.in +2m +.B orientation +.RB [ portrait | landscape ] +.in -2m +.sp 1 +. +Only the first valid orientation command in the +.I DESC +file is used. +. +. +.PP +To set the page orientation with command-line options you can use the +.B \-o +or +.B \-\-orientation +option with the same parameters +.RB ( portrait +or +.BR landscape ) +as in the +.I DESC +file. +Or you can use the +.B \-l +option to force the pages to be printed in landscape. +. +. +.\" ==================================================================== +.SH FONT FILE FORMAT +.\" ==================================================================== +. +In addition to the usual commands described in +.BR groff_font (5), +.B grolbp +provides the command +.I lbpname +which sets the font name sent to the printer when requesting this font. +. +The syntax of this command is: +.sp 1 +.in +2m +.B lbpname +.I printer_font_name +.in -2m +. +.IP \(bu +For bitmapped fonts, +.I printer_font_name +has the form +.sp 1 +.in +2m +.RI N\(la base_fontname \(ra\(la font_style \(ra +.in -2m +.sp 1 +.I 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. +.I font_style +can be one of the letters +.BR R , +.BR I , +or +.BR B , +indicating the font styles Roman, Italic and Bold respectively. +. +.IP +For instance, if the printer's +.I font listing A +shows font \(oqNelite12I.ISO_USA\(cq, the corresponding entry in the +font description file is +.sp 1 +.in +2m +.B lbpname NeliteI +.in -2m +. +.IP +Note that you may need to modify +.B 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. +. +.IP \(bu +For scalable fonts, +.I printer_font_name +is identical to the font name as it appears in the printer's +.IR "font listing A" . +. +.IP +For instance, to select the \(oqSwiss\(cq font in bold style, which +appears in the printer's +.I font listing A +as \(oqSwiss-Bold\(cq, the required +.B lbpname +command line is +.sp 1 +.in +2m +.B lbpname Swiss-Bold +.in -2m +.sp 1 +. +.PP +The argument of +.B lbpname +is case sensitive. +. +. +.\" ==================================================================== +.SH ENVIRONMENT +.\" ==================================================================== +. +.TP +.I GROFF_FONT_PATH +A list of directories in which to search for the +.IR dev name +directory in addition to the default ones. +. +See +.BR troff (1) +and +.BR \%groff_font (5) +for more details. +. +. +.\" ==================================================================== +.SH FILES +.\" ==================================================================== +. +.TP +.I /usr/\:share/\:groff/\:1.22.4/\:font/devlbp/DESC +Device description file. +. +.TP +.IR /usr/\:share/\:groff/\:1.22.4/\:font/devlbp/ F +Font description file for font +.IR F . +. +.TP +.I /usr/\:share/\:groff/\:1.22.4/\:tmac/lbp.tmac +Macros for use with +.BR grolbp . +. +. +.\" ==================================================================== +.SH SEE ALSO +.\" ==================================================================== +. +.BR groff (1), +.BR troff (1), +.BR groff_out (5), +.BR groff_font (5), +.BR groff_char (7) +. +. +.\" Restore compatibility mode (for, e.g., Solaris 10/11). +.cp \n[grolbp_C] +. +. +.\" +.\" Local Variables: +.\" mode: nroff +.\" End: +.\" vim: set filetype=groff: |