3 Copyright (C) 1989-2000, 2001, 2002, 2003 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
21 .do nr grotty_C \n[.C]
24 .TH GROTTY @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
26 grotty \- groff driver for typewriter-like devices
39 It is possible to have whitespace between the
41 option and its parameter.
46 translates the output of GNU
48 into a form suitable for typewriter-like devices.
51 should be invoked by using the
60 option on ASCII based systems, and with
64 on EBCDIC based hosts.
65 If no files are given,
67 will read the standard input.
72 to read the standard input.
73 Output is written to the standard output.
77 emits SGR escape sequences (from ISO 6429, also called ANSI color escapes)
78 to change text attributes (bold, italic, colors).
79 This makes it possible to have eight different \M[green]background\M[]
80 and \m[red]foreground\m[] colors; additionally, bold and italic
81 attributes can be used \f[BI]at the same time\f[] (by using the BI font).
83 The following colors are defined in
85 black, white, red, green, blue, yellow, magenta, cyan.
86 Unknown colors are mapped to the default color (which is dependent on the
87 settings of the terminal; in most cases, this is black for the foreground
88 and white for the background).
92 switch to revert to the old behaviour, printing a bold character
98 and an italic character
104 At the same time, color output is disabled.
105 The same effect can be achieved by setting either the
107 environment variable or using the `sgr' X command (see below).
109 For SGR support, it is necessary to use the
113 to disable the interpretation of
116 Consequently, all programs which use
118 as the pager program have to pass this option to it.
121 in particular, either add
125 environment variable, e.g.\&
128 .B PAGER="/usr/bin/less -R"
137 to set the pager executable and its options, or modify the configuration
140 in a similar fashion.
143 old output format can be displayed on a terminal
150 are also able to display these sequences.
161 There is no need to filter the output through
165 never outputs reverse line feeds.
167 The font description file may contain a command
173 is a decimal integer.
177 then the font will be treated as an italic font;
178 if the 02 bit is set,
179 then it will be treated as a bold font.
180 The code field in the font description field gives the
181 code which will be used to output the character.
182 This code can also be used in the
191 Suppress the use of overstriking for bold characters.
198 Use only overstriking for bold-italic characters.
207 old output format (see above).
208 This also disables color output.
218 .B \[rs]D'l\|.\|.\|.\&'
219 commands that have at least one zero argument
220 (and so are either horizontal or vertical)
230 Use form feeds in the output.
231 A form feed will be output at the end of each page that has no output
238 to the search path for font and device description files;
240 is the name of the device, usually
249 Use horizontal tabs in the output.
250 Tabs are assumed to be set every 8 columns.
254 Use escape sequences to set the italic text attribute instead of the
255 underline attribute for italic fonts (`I' and `BI').
256 Note that most terminals (including xterm) don't support this.
263 Suppress overstriking (other than for bold or underlined characters in
264 case the old output format has been activated with
269 Use escape sequences to set the reverse text attribute instead of the
270 underline attribute for italic fonts (`I' and `BI').
277 Suppress the use of underlining for italic characters.
284 Use only underlining for bold-italic characters.
291 Print the version number.
296 understands a single X command produced using the
300 .BI \[rs]X'tty:\ sgr\ n '
303 is non-zero or missing, enable SGR output (this is the default), otherwise
304 use the old drawing scheme for bold and underline.
310 If set, the old drawing scheme for bold and underline (using the
311 backspace character) is active.
317 .B @FONTDIR@/devascii/DESC
318 Device description file for
323 .BI @FONTDIR@/devascii/ F
324 Font description file for font
330 .B @FONTDIR@/devkoi8-r/DESC
331 Device description file for
335 .BI @FONTDIR@/devkoi8-r/ F
336 Font description file for font
343 .B @FONTDIR@/devlatin1/DESC
344 Device description file for
349 .BI @FONTDIR@/devlatin1/ F
350 Font description file for font
357 .B @FONTDIR@/devutf8/DESC
358 Device description file for
363 .BI @FONTDIR@/devutf8/ F
364 Font description file for font
371 .B @FONTDIR@/devcp1047/DESC
372 Device description file for
377 .BI @FONTDIR@/devcp1047/ F
378 Font description file for font
385 .B @MACRODIR@/tty.tmac
390 .B @MACRODIR@/tty-char.tmac
391 Additional klugdey character definitions for use with
394 Note that on EBCDIC hosts, only files for the
396 device will be installed.
402 is intended only for simple documents.
404 There is no support for fractional horizontal or vertical motions.
406 There is no support for
409 other than horizontal and vertical lines.
411 Characters above the first line (ie with a vertical position of\~0)
414 Color handling is different compared to
415 .BR grops (@MAN1EXT@).
417 doesn't set the fill color for closed graphic objects (which
419 doesn't support anyway) but changes the background color of the character
420 cell, affecting all subsequent operations.
424 .BR groff (@MAN1EXT@),
425 .BR @g@troff (@MAN1EXT@),
426 .BR groff_out (@MAN5EXT@),
427 .BR groff_font (@MAN5EXT@),
428 .BR groff_char (@MAN7EXT@),