1 |
.ig |
.ig |
2 |
Copyright (C) 1989-2000, 2001, 2002, 2003 Free Software Foundation, Inc. |
Copyright (C) 1989-2000, 2001, 2002, 2003, 2005 Free Software Foundation, Inc. |
3 |
|
|
4 |
Permission is granted to make and distribute verbatim copies of |
Permission is granted to make and distribute verbatim copies of |
5 |
this manual provided the copyright notice and this permission notice |
this manual provided the copyright notice and this permission notice |
40 |
option and its parameter. |
option and its parameter. |
41 |
. |
. |
42 |
. |
. |
43 |
|
. |
44 |
.SH DESCRIPTION |
.SH DESCRIPTION |
45 |
|
. |
46 |
.B grotty |
.B grotty |
47 |
translates the output of GNU |
translates the output of GNU |
48 |
.B troff |
.B troff |
71 |
.B grotty |
.B grotty |
72 |
to read the standard input. |
to read the standard input. |
73 |
Output is written to the standard output. |
Output is written to the standard output. |
74 |
|
. |
75 |
.LP |
.LP |
76 |
By default, |
By default, |
77 |
.B grotty |
.B grotty |
80 |
This makes it possible to have eight different \M[green]background\M[] |
This makes it possible to have eight different \M[green]background\M[] |
81 |
and \m[red]foreground\m[] colors; additionally, bold and italic |
and \m[red]foreground\m[] colors; additionally, bold and italic |
82 |
attributes can be used \f[BI]at the same time\f[] (by using the BI font). |
attributes can be used \f[BI]at the same time\f[] (by using the BI font). |
83 |
|
. |
84 |
.LP |
.LP |
85 |
The following colors are defined in |
The following colors are defined in |
86 |
.BR tty.tmac : |
.BR tty.tmac : |
88 |
Unknown colors are mapped to the default color (which is dependent on the |
Unknown colors are mapped to the default color (which is dependent on the |
89 |
settings of the terminal; in most cases, this is black for the foreground |
settings of the terminal; in most cases, this is black for the foreground |
90 |
and white for the background). |
and white for the background). |
91 |
|
. |
92 |
.LP |
.LP |
93 |
Use the |
Use the |
94 |
.B \-c |
.B \-c |
108 |
The same effect can be achieved by setting either the |
The same effect can be achieved by setting either the |
109 |
.B GROFF_NO_SGR |
.B GROFF_NO_SGR |
110 |
environment variable or using the `sgr' X command (see below). |
environment variable or using the `sgr' X command (see below). |
111 |
|
. |
112 |
.LP |
.LP |
113 |
For SGR support, it is necessary to use the |
For SGR support, it is necessary to use the |
114 |
.B \-R |
.B \-R |
127 |
to the |
to the |
128 |
.B $PAGER |
.B $PAGER |
129 |
environment variable, e.g.\& |
environment variable, e.g.\& |
130 |
|
. |
131 |
.RS |
.RS |
132 |
.LP |
.LP |
133 |
.B PAGER="/usr/bin/less -R" |
.B PAGER="/usr/bin/less -R" |
135 |
.B export PAGER |
.B export PAGER |
136 |
.RE |
.RE |
137 |
.LP |
.LP |
138 |
|
. |
139 |
or use the |
or use the |
140 |
.B \-P |
.B \-P |
141 |
option of |
option of |
144 |
file of |
file of |
145 |
.B man |
.B man |
146 |
in a similar fashion. |
in a similar fashion. |
147 |
|
Note that with some |
148 |
|
.BR man (1) |
149 |
|
versions, you have to use the |
150 |
|
.B $MANPAGER |
151 |
|
environment variable instead. |
152 |
|
. |
153 |
.LP |
.LP |
154 |
.BR grotty 's |
.BR grotty 's |
155 |
old output format can be displayed on a terminal |
old output format can be displayed on a terminal |
175 |
since |
since |
176 |
.B grotty |
.B grotty |
177 |
never outputs reverse line feeds. |
never outputs reverse line feeds. |
178 |
|
. |
179 |
.LP |
.LP |
180 |
The font description file may contain a command |
The font description file may contain a command |
181 |
|
. |
182 |
.IP |
.IP |
183 |
.BI internalname\ n |
.BI internalname\ n |
184 |
.LP |
.LP |
185 |
|
. |
186 |
where |
where |
187 |
.I n |
.I n |
188 |
is a decimal integer. |
is a decimal integer. |
200 |
.BR troff . |
.BR troff . |
201 |
. |
. |
202 |
. |
. |
203 |
|
. |
204 |
.SH OPTIONS |
.SH OPTIONS |
205 |
|
. |
206 |
.TP |
.TP |
207 |
.B \-b |
.B \-b |
208 |
Suppress the use of overstriking for bold characters. |
Suppress the use of overstriking for bold characters. |
260 |
.BR utf8 , |
.BR utf8 , |
261 |
or |
or |
262 |
.BR cp1047 . |
.BR cp1047 . |
263 |
|
. |
264 |
.TP |
.TP |
265 |
.B \-h |
.B \-h |
266 |
Use horizontal tabs in the output. |
Use horizontal tabs in the output. |
308 |
Print the version number. |
Print the version number. |
309 |
. |
. |
310 |
. |
. |
311 |
|
. |
312 |
.SH USAGE |
.SH USAGE |
313 |
|
. |
314 |
.B grotty |
.B grotty |
315 |
understands a single X command produced using the |
understands a single X command produced using the |
316 |
.B \[rs]X |
.B \[rs]X |
317 |
escape sequence. |
escape sequence. |
318 |
|
. |
319 |
.TP |
.TP |
320 |
.BI \[rs]X'tty:\ sgr\ n ' |
.BI \[rs]X'tty:\ sgr\ n ' |
321 |
If |
If |
324 |
use the old drawing scheme for bold and underline. |
use the old drawing scheme for bold and underline. |
325 |
. |
. |
326 |
. |
. |
327 |
|
. |
328 |
.SH ENVIRONMENT |
.SH ENVIRONMENT |
329 |
|
. |
330 |
.TP |
.TP |
331 |
.B GROFF_NO_SGR |
.B GROFF_NO_SGR |
332 |
If set, the old drawing scheme for bold and underline (using the |
If set, the old drawing scheme for bold and underline (using the |
334 |
Colors are disabled. |
Colors are disabled. |
335 |
. |
. |
336 |
. |
. |
337 |
|
. |
338 |
.SH FILES |
.SH FILES |
339 |
|
. |
340 |
.TP |
.TP |
341 |
.B @FONTDIR@/devascii/DESC |
.B @FONTDIR@/devascii/DESC |
342 |
Device description file for |
Device description file for |
402 |
.B @MACRODIR@/tty-char.tmac |
.B @MACRODIR@/tty-char.tmac |
403 |
Additional klugdey character definitions for use with |
Additional klugdey character definitions for use with |
404 |
.BR grotty . |
.BR grotty . |
405 |
|
. |
406 |
.LP |
.LP |
407 |
Note that on EBCDIC hosts, only files for the |
Note that on EBCDIC hosts, only files for the |
408 |
.B cp1047 |
.B cp1047 |
409 |
device will be installed. |
device will be installed. |
410 |
. |
. |
411 |
. |
. |
412 |
|
. |
413 |
.SH BUGS |
.SH BUGS |
414 |
|
. |
415 |
.LP |
.LP |
416 |
.B grotty |
.B grotty |
417 |
is intended only for simple documents. |
is intended only for simple documents. |
418 |
|
. |
419 |
.LP |
.LP |
420 |
There is no support for fractional horizontal or vertical motions. |
There is no support for fractional horizontal or vertical motions. |
421 |
|
. |
422 |
.LP |
.LP |
423 |
There is no support for |
There is no support for |
424 |
.B \[rs]D |
.B \[rs]D |
425 |
commands |
commands |
426 |
other than horizontal and vertical lines. |
other than horizontal and vertical lines. |
427 |
|
. |
428 |
.LP |
.LP |
429 |
Characters above the first line (ie with a vertical position of\~0) |
Characters above the first line (ie with a vertical position of\~0) |
430 |
cannot be printed. |
cannot be printed. |
431 |
|
. |
432 |
.LP |
.LP |
433 |
Color handling is different compared to |
Color handling is different compared to |
434 |
.BR grops (@MAN1EXT@). |
.BR grops (@MAN1EXT@). |
439 |
cell, affecting all subsequent operations. |
cell, affecting all subsequent operations. |
440 |
. |
. |
441 |
. |
. |
442 |
|
. |
443 |
.SH "SEE ALSO" |
.SH "SEE ALSO" |
444 |
|
. |
445 |
.BR groff (@MAN1EXT@), |
.BR groff (@MAN1EXT@), |
446 |
.BR @g@troff (@MAN1EXT@), |
.BR @g@troff (@MAN1EXT@), |
447 |
.BR groff_out (@MAN5EXT@), |
.BR groff_out (@MAN5EXT@), |