src/devices/grolbp/grolbp.man

   1 .ig \"-*- nroff -*-
   2 Copyright (C) 1994-2000 Free Software Foundation, Inc.
   3
   4 Permission is granted to make and distribute verbatim copies of
   5 this manual provided the copyright notice and this permission notice
   6 are preserved on all copies.
   7
   8 Permission is granted to copy and distribute modified versions of this
   9 manual under the conditions for verbatim copying, provided that the
  10 entire resulting derived work is distributed under the terms of a
  11 permission notice identical to this one.
  12
  13 Permission is granted to copy and distribute translations of this
  14 manual into another language, under the above conditions for modified
  15 versions, except that this permission notice may be included in
  16 translations approved by the Free Software Foundation instead of in
  17 the original English.
  18
  19 Modified by Francisco Andrés Verdú <pandres@dragonet.es> for the grolbp
  20 program.
  21 ..
  22 .de TQ
  23 .br
  24 .ns
  25 .TP \\$1
  26 ..
  27 .\" Like TP, but if specified indent is more than half
  28 .\" the current line-length - indent, use the default indent.
  29 .de Tp
  30 .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
  31 .el .TP "\\$1"
  32 ..
  33 .TH GROLBP @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
  34 .SH NAME
  35 grolbp \- groff driver for Canon CAPSL printers (LBP-4 and LBP-8 series laser printers).
  36 .SH SYNOPSIS
  37 .nr a \n(.j
  38 .ad l
  39 .nr i \n(.i
  40 .in +\w'\fBgrolbp 'u
  41 .ti \niu
  42 .B grolpb
  43 .de OP
  44 .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\ \\$2" "\ ]"
  45 .el .RB "[\ " "\\$1" "\ ]"
  46 ..
  47 .OP \-l
  48 .OP \-\-landscape
  49 .OP \-v
  50 .OP \-\-version
  51 .OP \-c n
  52 .OP \-\-copies numcopies
  53 .OP \-p paper_size
  54 .OP \-\-papersize paper_size
  55 .OP \-o orientation
  56 .OP \-\-orientation orientation
  57 .OP \-F dir
  58 .OP \-\-fontdir dir
  59 .OP \-h
  60 .OP \-\-help
  61 .RI "[\ " files\|.\|.\|. "\ ]"
  62 .br
  63 .ad \na
  64 .SH DESCRIPTION
  65 .B grolbp
  66 is a driver for
  67 .B groff
  68 that produces output in CAPSL and VDM format suitable for Canon LBP\-4 and
  69 LBP\-8 printers.
  70 .LP
  71 For compatibility with grolj4 there is an additional drawing command
  72 available:
  73 .TP
  74 .BI \eD'R\  dh\ dv '
  75 Draw a rule (i.e.\ a solid black rectangle), with one corner at the current
  76 position, and the diagonally opposite corner at the current position
  77 .RI +( dh , dv ).
  78 .SH OPTIONS
  79 Note that the whitespace between a one-letter option and its argument can be
  80 omitted; on the other hand, there must be whitespace and/or an equal sign
  81 (`=') between a long-name option and its argument.
  82 .TP
  83 .BI \-c \ numcopies
  84 .TQ
  85 .BI \-\-copies \ numcopies
  86 Print
  87 .I numcopies
  88 copies of each page.
  89 .TP
  90 .B \-l
  91 .TQ
  92 .B \-\-landscape
  93 Print the document with a landscape orientation.
  94 .TP
  95 .BI \-p \ paper_size
  96 .TQ
  97 .BI \-\-papersize \ paper_size
  98 Set the paper size to
  99 .IR paper_size ,
 100 which must be a valid paper size description as indicated in the section
 101 .BR "PAPER SIZES" .
 102 .TP
 103 .BI \-o \ orientation
 104 .TQ
 105 .BI \-\-orientation \ orientation
 106 Print the document with
 107 .I orientation
 108 orientation, which must be `portrait' or `landscape'.
 109 .TP
 110 .B \-v
 111 .TQ
 112 .B \-\-version
 113 Print the version number.
 114 .TP
 115 .BI \-F \ dir
 116 .TQ
 117 .BI \-\-fontdir \ dir
 118 Search directory
 119 .IB dir /devlbp
 120 for font and device description files.
 121 .TP
 122 .B \-h
 123 .TQ
 124 .B \-\-help
 125 Print a short help text.
 126 .SH TYPEFACES
 127 The driver supports the Dutch, Swiss and Swiss-Narrow scalable typefaces,
 128 each one in the Regular, Bold, Italic and Bold-Italic styles.
 129 Additionally, the Courier and Elite monospaced typefaces at the sizes 8 and
 130 12 points (for Courier) resp. 8 and 10 points (for Elite) are supported,
 131 each one in the Regular, Bold and Italic styles.
 132 .PP
 133 The following chart summarizes the font names you can use to access these
 134 fonts:
 135 .PP
 136 .TS
 137 tab(|) allbox center;
 138 c c c c c
 139 ab c c c c
 140 .
 141 Typeface | Regular | Bold | Italic | Bold-Italic
 142 Dutch | TR | TB | TI | TBI
 143 Swiss | HR | HB | HI | HBI
 144 Swiss Narrow | HNR | HNB | HNI | HNBI
 145 Courier | CR | CB | CI |
 146 Elite | ER | EB | EI |
 147 .TE
 148 .PP
 149 .SH PAPER SIZES
 150 The paper size can be set in the
 151 .B DESC
 152 file or with command line options to
 153 .BR grolbp .
 154 If the paper size is specified both ways, the command line options take
 155 precedence over the contents of the
 156 .B DESC
 157 file (this applies to the page orientation too).
 158 .PP
 159 To set the paper size in the
 160 .B DESC
 161 file, insert in that file a line containing
 162 .B papersize
 163 .IR desired_papersize ,
 164 where
 165 .I desired_papersize
 166 is:
 167 .IP \(bu 4
 168 One of the recognized paper sizes: `a4', `letter', `legal' or `executive'.
 169 .IP \(bu 4
 170 A custom defined paper size, as described in the
 171 .B CUSTOM PAPER SIZES
 172 subsection below.
 173 .IP \(bu 4
 174 The name of a file (e.g.
 175 .IR /etc/papersize )
 176 whose first line must be the desired paper size in one of the above formats.
 177 .PP
 178 If there are various papersize lines in the
 179 .B DESC
 180 file, only the first valid one is used.
 181 .PP
 182 To set the paper size in the command line, add
 183 .sp 1
 184 .in +2m
 185 .BI \-p \ desired_papersize
 186 .in -2m
 187 .sp 1
 188 or
 189 .sp 1
 190 .in +2m
 191 .BI \-\-papersize \ desired_papersize
 192 .in -2m
 193 .sp 1
 194 to the other
 195 .B grolbp
 196 options, where
 197 .B desired_papersize
 198 is in the same format as in the
 199 .B DESC
 200 file.
 201 .PP
 202 Paper sizes are case insensitive (i.e., `A4' is the same as `a4').
 203 .PP
 204 If no paper size is specified in the
 205 .B DESC
 206 file or the command line, a default size of A4 is used.
 207 .TP
 208 .SH CUSTOM PAPER SIZES
 209 Custom defined paper sizes are in the form
 210 .BI cust length x width
 211 where
 212 .I length
 213 and
 214 .I width
 215 are the dimensions of the paper you want to to use, specified in printer
 216 units (1/300 of an inch).
 217 For instance, to print in a postcard sized paper which is two inches long
 218 and four inches wide you can insert a line containing
 219 .sp 1
 220 .in +2m
 221 .B papersize cust600x1200
 222 .in -2m
 223 .sp 1
 224 at the beginning of the
 225 .B DESC
 226 file.
 227 .SH PAGE ORIENTATION
 228 As with the page size, the orientation of the printed page
 229 .RB ( portrait
 230 or
 231 .BR landscape )
 232 can be set in the
 233 .B DESC
 234 file or with command line options.
 235 It is also case insensitive.
 236 .PP
 237 To set the orientation in the
 238 .B DESC
 239 file, insert a line with the following content:
 240 .sp 1
 241 .in +2m
 242 .B orientation
 243 .RB [ portrait | landscape ]
 244 .in -2m
 245 .sp 1
 246 As with paper sizes, only the first valid orientation command in the
 247 .B DESC
 248 file is used.
 249 .PP
 250 To set the page orientation with command line options you can use the
 251 .B \-o
 252 or
 253 .B \-\-orientation
 254 option with the same parameters
 255 .RB ( portrait
 256 or
 257 .BR landscape )
 258 as in the
 259 .B DESC
 260 file.
 261 Or you can use the
 262 .B \-l
 263 option to force the pages to be printed in landscape.
 264 .SH FILES
 265 .TP
 266 .B @FONTDIR@/devlbp/DESC
 267 Device description file.
 268 .TP
 269 .BI @FONTDIR@/devlbp/ F
 270 Font description file for font
 271 .IR F .
 272 .SH SEE ALSO
 273 .BR groff (@MAN1EXT@),
 274 .BR @g@troff (@MAN1EXT@),
 275 .BR groff_out (@MAN5EXT@),
 276 .BR groff_font (@MAN5EXT@),
 277 .BR groff_char (@MAN7EXT@)