2 $FreeBSD: src/contrib/groff/src/devices/grotty/grotty.man,v 1.4.2.3 2003/02/14 15:22:03 ru Exp $
3 Copyright (C) 1989-2000, 2001, 2002 Free Software Foundation, Inc.
5 Permission is granted to make and distribute verbatim copies of
6 this manual provided the copyright notice and this permission notice
7 are preserved on all copies.
9 Permission is granted to copy and distribute modified versions of this
10 manual under the conditions for verbatim copying, provided that the
11 entire resulting derived work is distributed under the terms of a
12 permission notice identical to this one.
14 Permission is granted to copy and distribute translations of this
15 manual into another language, under the above conditions for modified
16 versions, except that this permission notice may be included in
17 translations approved by the Free Software Foundation instead of in
22 .TH GROTTY @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
24 grotty \- groff driver for typewriter-like devices
37 It is possible to have whitespace between the
39 option and its parameter.
44 translates the output of GNU
46 into a form suitable for typewriter-like devices.
49 should be invoked by using the
58 option on ASCII based systems, and with
62 on EBCDIC based hosts.
63 If no files are given,
65 will read the standard input.
70 to read the standard input.
71 Output is written to the standard output.
75 emits SGR escape sequences (from ISO 6429, also called ANSI color escapes)
76 to change text attributes (bold, italic, colors).
77 This makes it possible to have eight different \M[green]background\M[]
78 and \m[red]foreground\m[] colors; additionally, bold and italic
79 attributes can be used \f[BI]at the same time\f[] (by using the BI font).
81 The following colors are defined in
83 black, white, red, green, blue, yellow, magenta, cyan.
84 Unknown colors are mapped to the default color (which is dependent on the
85 settings of the terminal; in most cases, this is black for the foreground
86 and white for the background).
90 switch to revert to the old behaviour, printing a bold character
96 and an italic character
102 At the same time, color output is disabled.
103 The same effect can be achieved by setting either the
105 environment variable or using the `sgr' X command (see below).
107 For SGR support, it is necessary to use the
111 to disable the interpretation of
114 Consequently, all programs which use
116 as the pager program have to pass this option to it.
119 in particular, either add
123 environment variable, e.g.\&
126 .B PAGER="/usr/bin/less -R"
135 to set the pager executable and its options, or modify the configuration
138 in a similar fashion.
141 old output format can be displayed on a terminal
148 are also able to display these sequences.
159 There is no need to filter the output through
163 never outputs reverse line feeds.
165 The font description file may contain a command
171 is a decimal integer.
175 then the font will be treated as an italic font;
176 if the 02 bit is set,
177 then it will be treated as a bold font.
178 The code field in the font description field gives the
179 code which will be used to output the character.
180 This code can also be used in the
189 Suppress the use of overstriking for bold characters.
196 Use only overstriking for bold-italic characters.
205 old output format (see above).
206 This also disables color output.
216 .B \[rs]D'l\|.\|.\|.\&'
217 commands that have at least one zero argument
218 (and so are either horizontal or vertical)
228 Use form feeds in the output.
229 A form feed will be output at the end of each page that has no output
236 to the search path for font and device description files;
238 is the name of the device, usually
247 Use horizontal tabs in the output.
248 Tabs are assumed to be set every 8 columns.
252 Use escape sequences to set the italic text attribute instead of the
253 underline attribute for italic fonts (`I' and `BI').
254 Note that most terminals (including xterm) don't support this.
261 Suppress overstriking (other than for bold or underlined characters in
262 case the old output format has been activated with
267 Use escape sequences to set the reverse text attribute instead of the
268 underline attribute for italic fonts (`I' and `BI').
275 Suppress the use of underlining for italic characters.
282 Use only underlining for bold-italic characters.
289 Print the version number.
294 understands a single X command produced using the
298 .BI \[rs]X'tty:\ sgr\ n '
301 is non-zero or missing, enable SGR output (this is the default), otherwise
302 use the old drawing scheme for bold and underline.
308 If set, the old drawing scheme for bold and underline (using the
309 backspace character) is active.
315 .B @FONTDIR@/devascii/DESC
316 Device description file for
321 .BI @FONTDIR@/devascii/ F
322 Font description file for font
328 .B @FONTDIR@/devkoi8-r/DESC
329 Device description file for
333 .BI @FONTDIR@/devkoi8-r/ F
334 Font description file for font
341 .B @FONTDIR@/devlatin1/DESC
342 Device description file for
347 .BI @FONTDIR@/devlatin1/ F
348 Font description file for font
355 .B @FONTDIR@/devutf8/DESC
356 Device description file for
361 .BI @FONTDIR@/devutf8/ F
362 Font description file for font
369 .B @FONTDIR@/devcp1047/DESC
370 Device description file for
375 .BI @FONTDIR@/devcp1047/ F
376 Font description file for font
383 .B @MACRODIR@/tty.tmac
388 .B @MACRODIR@/tty-char.tmac
389 Additional klugdey character definitions for use with
392 Note that on EBCDIC hosts, only files for the
394 device will be installed.
400 is intended only for simple documents.
402 There is no support for fractional horizontal or vertical motions.
404 There is no support for
407 other than horizontal and vertical lines.
409 Characters above the first line (ie with a vertical position of\~0)
412 Color handling is different compared to
413 .BR grops (@MAN1EXT@).
415 doesn't set the fill color for closed graphic objects (which
417 doesn't support anyway) but changes the background color of the character
418 cell, affecting all subsequent operations.
422 .BR groff (@MAN1EXT@),
423 .BR @g@troff (@MAN1EXT@),
424 .BR groff_out (@MAN5EXT@),
425 .BR groff_font (@MAN5EXT@),
426 .BR groff_char (@MAN7EXT@),