/contrib/groff/src/devices/grolbp/grolbp.man
Unknown | 336 lines | 332 code | 4 blank | 0 comment | 0 complexity | 5f205341cdfc65ba69da2ccd50a8d601 MD5 | raw file
1'\" t 2.\" The above line should force the use of tbl as a preprocessor 3.\" vim: set syntax=nroff : 4.\" The above line should set vim into nroff mode 5.ig 6Copyright (C) 1994-2000, 2002 Free Software Foundation, Inc. 7 8Permission is granted to make and distribute verbatim copies of 9this manual provided the copyright notice and this permission notice 10are preserved on all copies. 11 12Permission is granted to copy and distribute modified versions of this 13manual under the conditions for verbatim copying, provided that the 14entire resulting derived work is distributed under the terms of a 15permission notice identical to this one. 16 17Permission is granted to copy and distribute translations of this 18manual into another language, under the above conditions for modified 19versions, except that this permission notice may be included in 20translations approved by the Free Software Foundation instead of in 21the original English. 22 23Modified by Francisco Andrés Verdú <pandres@dragonet.es> for the grolbp 24program. 25.. 26.de TQ 27.br 28.ns 29.TP \\$1 30.. 31.\" Like TP, but if specified indent is more than half 32.\" the current line-length - indent, use the default indent. 33.de Tp 34.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP 35.el .TP "\\$1" 36.. 37.TH GROLBP @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 38. 39.SH NAME 40grolbp \- groff driver for Canon CAPSL printers (LBP-4 and LBP-8 series laser printers). 41. 42.SH SYNOPSIS 43.nr a \n(.j 44.ad l 45.nh 46.nr i \n(.i 47.in +\w'\fBgrolbp 'u 48.ti \niu 49.B grolpb 50.de OP 51.ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]" 52.el .RB "[\ " "\\$1" "\ ]" 53.. 54.OP \-l 55.OP \-\-landscape 56.OP \-v 57.OP \-\-version 58.OP \-c n 59.OP \-\-copies= numcopies 60.OP \-p paper_size 61.OP \-\-papersize= paper_size 62.OP \-o orientation 63.OP \-\-orientation= orientation 64.OP \-w width 65.OP \-\-linewidth= width 66.OP \-F dir 67.OP \-\-fontdir= dir 68.OP \-h 69.OP \-\-help 70.RI "[\ " files\|.\|.\|. "\ ]" 71.br 72.ad \na 73.hy 74. 75.SH DESCRIPTION 76.B grolbp 77is a driver for 78.B groff 79that produces output in CAPSL and VDM format suitable for Canon LBP\-4 and 80LBP\-8 printers. 81.LP 82For compatibility with grolj4 there is an additional drawing command 83available: 84.TP 85.BI \eD'R\ dh\ dv ' 86Draw a rule (i.e.\ a solid black rectangle), with one corner at the current 87position, and the diagonally opposite corner at the current position 88.RI +( dh , dv ). 89.SH OPTIONS 90Note that there can be whitespace between a one-letter option and its 91argument; on the other hand, there must be whitespace and/or an equal sign 92(`=') between a long-name option and its argument. 93.TP 94.BI \-c numcopies 95.TQ 96.BI \-\-copies= numcopies 97Print 98.I numcopies 99copies of each page. 100.TP 101.B \-l 102.TQ 103.B \-\-landscape 104Print the document with a landscape orientation. 105.TP 106.BI \-p paper_size 107.TQ 108.BI \-\-papersize= paper_size 109Set the paper size to 110.IR paper_size , 111which must be a valid paper size description as indicated in the section 112.BR "PAPER SIZES" . 113.TP 114.BI \-o orientation 115.TQ 116.BI \-\-orientation= orientation 117Print the document with 118.I orientation 119orientation, which must be `portrait' or `landscape'. 120.TP 121.BI \-w width 122.TQ 123.BI \-\-linewidth= width 124Set the default line thickness to 125.I width 126thousandths of an em. 127If this option isn't specified, the line thickness defaults to 0.04\~em. 128.TP 129.B \-v 130.TQ 131.B \-\-version 132Print the version number. 133.TP 134.BI \-F dir 135.TQ 136.BI \-\-fontdir= dir 137Prepend directory 138.IB dir /dev name 139to the search path for font and device description files; 140.I name 141is the name of the device, usually 142.BR lbp . 143.TP 144.B \-h 145.TQ 146.B \-\-help 147Print a short help text. 148.SH TYPEFACES 149The driver supports the Dutch, Swiss and Swiss-Narrow scalable typefaces, 150each one in the Regular, Bold, Italic and Bold-Italic styles. 151Additionally, the Courier and Elite monospaced typefaces at the sizes 8 and 15212 points (for Courier) resp. 8 and 10 points (for Elite) are supported, 153each one in the Regular, Bold and Italic styles. 154.PP 155The following chart summarizes the font names you can use to access these 156fonts: 157.PP 158.TS 159tab(|) allbox center; 160c c c c c 161ab c c c c 162. 163Typeface | Regular | Bold | Italic | Bold-Italic 164Dutch | TR | TB | TI | TBI 165Swiss | HR | HB | HI | HBI 166Swiss Narrow | HNR | HNB | HNI | HNBI 167Courier | CR | CB | CI | 168Elite | ER | EB | EI | 169.TE 170.PP 171.SH PAPER SIZES 172The paper size can be set in the 173.B DESC 174file or with command line options to 175.BR grolbp . 176If the paper size is specified both ways, the command line options take 177precedence over the contents of the 178.B DESC 179file (this applies to the page orientation too). 180.PP 181See 182.BR groff_font (@MAN1EXT@) 183how to set the paper dimensions in the 184.B DESC 185file. 186.PP 187To set the paper size in the command line, add 188.sp 1 189.in +2m 190.BI \-p \ paper-size 191.in -2m 192.sp 1 193or 194.sp 1 195.in +2m 196.BI \-\-papersize= paper-size 197.in -2m 198.sp 1 199to the other 200.B grolbp 201options, where 202.I paper-size 203is in the same format as in the 204.B DESC 205file. 206.PP 207If no paper size is specified in the 208.B DESC 209file or the command line, a default size of A4 is used. 210.SH PAGE ORIENTATION 211As with the page size, the orientation of the printed page 212.RB ( portrait 213or 214.BR landscape ) 215can be set in the 216.B DESC 217file or with command line options. 218It is also case insensitive. 219.PP 220To set the orientation in the 221.B DESC 222file, insert a line with the following content: 223.sp 1 224.in +2m 225.B orientation 226.RB [ portrait | landscape ] 227.in -2m 228.sp 1 229Only the first valid orientation command in the 230.B DESC 231file is used. 232.PP 233To set the page orientation with command line options you can use the 234.B \-o 235or 236.B \-\-orientation 237option with the same parameters 238.RB ( portrait 239or 240.BR landscape ) 241as in the 242.B DESC 243file. 244Or you can use the 245.B \-l 246option to force the pages to be printed in landscape. 247.SH FONT FILE FORMAT 248In addition to the usual commands described in 249.BR groff_font (@MAN5EXT@), 250.B grolbp 251provides the command 252.I lbpname 253which sets the font name sent to the printer when requesting this font. 254The syntax of this command is: 255.sp 1 256.in +2m 257.B lbpname 258.I printer_font_name 259.in -2m 260.IP \(bu 261For bitmapped fonts, 262.I printer_font_name 263has the form 264.sp 1 265.in +2m 266.RI N\(la base_fontname \(ra\(la font_style \(ra 267.in -2m 268.sp 1 269.I base_fontname 270is the font name as it appears in the printers font listings without the 271first letter, up to (but not including) the font size. 272.I font_style 273can be one of the letters 274.BR R , 275.BR I , 276or 277.BR B , 278indicating the font styles Roman, Italic and Bold respectively. 279.IP 280For instance, if the printer's 281.I font listing A 282shows font `Nelite12I.ISO_USA', the corresponding entry in the font 283description file is 284.sp 1 285.in +2m 286.B lbpname NeliteI 287.in -2m 288.IP 289Note that you may need to modify 290.B grolbp 291to add support for new bitmapped fonts, since the available font names and 292font sizes of bitmapped fonts (as documented above) are hard-coded into the 293program. 294.IP \(bu 295For scalable fonts, 296.I printer_font_name 297is identical to the font name as it appears in the printer's 298.IR "font listing A" . 299.IP 300For instance, to select the `Swiss' font in bold style, which appears in 301the printer's 302.I font listing A 303as `Swiss-Bold', the required 304.B lbpname 305command line is 306.sp 1 307.in +2m 308.B lbpname Swiss-Bold 309.in -2m 310.sp 1 311.PP 312The argument of 313.B lbpname 314is case sensitive. 315.SH FILES 316.TP 317.B @FONTDIR@/devlbp/DESC 318Device description file. 319.TP 320.BI @FONTDIR@/devlbp/ F 321Font description file for font 322.IR F . 323.TP 324.B @MACRODIR@/lbp.tmac 325Macros for use with 326.BR grolbp . 327.SH SEE ALSO 328.BR groff (@MAN1EXT@), 329.BR @g@troff (@MAN1EXT@), 330.BR groff_out (@MAN5EXT@), 331.BR groff_font (@MAN5EXT@), 332.BR groff_char (@MAN7EXT@) 333.\" 334.\" Local Variables: 335.\" mode: nroff 336.\" End: