/[groff]/groff/src/devices/grotty/grotty.man
ViewVC logotype

Diff of /groff/src/devices/grotty/grotty.man

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.17 by wlemb, Fri Jul 18 08:16:43 2003 UTC revision 1.18 by wl, Mon Oct 17 07:06:42 2005 UTC
# Line 1  Line 1 
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
# Line 40  It is possible to have whitespace betwee Line 40  It is possible to have whitespace betwee
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
# Line 69  will also cause Line 71  will also cause
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
# Line 77  to change text attributes (bold, italic, Line 80  to change text attributes (bold, italic,
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 :
# Line 84  black, white, red, green, blue, yellow, Line 88  black, white, red, green, blue, yellow,
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
# Line 103  At the same time, color output is disabl Line 108  At the same time, color output is disabl
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
# Line 121  in particular, either add Line 127  in particular, either add
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"
# Line 128  environment variable, e.g.\& Line 135  environment variable, e.g.\&
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
# Line 136  to set the pager executable and its opti Line 144  to set the pager executable and its opti
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
# Line 161  There is no need to filter the output th Line 175  There is no need to filter the output th
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.
# Line 183  escape sequence in Line 200  escape sequence in
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.
# Line 241  is the name of the device, usually Line 260  is the name of the device, usually
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.
# Line 288  isn't used. Line 308  isn't used.
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
# Line 301  is non-zero or missing, enable SGR outpu Line 324  is non-zero or missing, enable SGR outpu
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
# Line 309  backspace character) is active. Line 334  backspace character) is active.
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
# Line 375  Macros for use with Line 402  Macros for use with
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@).
# Line 405  doesn't support anyway) but changes the Line 439  doesn't support anyway) but changes the
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@),

Legend:
Removed from v.1.17  
changed lines
  Added in v.1.18

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26