Penguin
Recent Changes
Annotated edit history of grotty(1) version 4, including all changes. View license author blame.
Rev Author # Line
1 perry 1 GROTTY
2 !!!GROTTY
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 FILES
8 BUGS
9 SEE ALSO
10 ----
11 !!NAME
12
13
14 grotty - groff driver for typewriter-like devices
15 !!SYNOPSIS
16
17
18 __grotty__ [[ __-hfbuodBUv__ ] [[ __-F__''dir'' ]
19 [[ ''files''... ]
20
21
22 It is possible to have whitespace between the __-F__
23 option and its parameter.
24 !!DESCRIPTION
25
26
27 __grotty__ translates the output of GNU __troff__ into
28 a form suitable for typewriter-like devices. Normally
29 __grotty__ should be invoked by using the __groff__
30 command with a __-Tascii__, __-Tascii8__,
31 __-Tlatin1__, __-Tnippon__ or __-Tutf8__ option on
32 ASCII based systems, and with __-Tcp1047__ on EBCDIC
33 based hosts. If no files are given, __grotty__ will read
34 the standard input. A filename of __-__ will also cause
35 __grotty__ to read the standard input. Output is written
36 to the standard output.
37
38
39 Normally __grotty__ prints a bold character ''c''
40 using the sequence `''c'' BACKSPACE
41 ''c''' and a italic character ''c'' by the sequence
42 `_____ BACKSPACE ''c'''. These
43 sequences can be displayed on a terminal by piping through
44 ul(1). Pagers such as more(1) or
45 less(1) are also able to display these sequences. Use
46 either __-B__ or __-U__ when piping into
47 less(1); use __-b__ when piping into
48 more(1). There is no need to filter the output
49 through col(1) since __grotty__ never outputs
50 reverse line feeds.
51
52
53 The font description file may contain a command
54
55
56 __internalname__ ''n''
57
58
59 where ''n'' is a decimal integer. If the 01 bit in
60 ''n'' is set, then the font will be treated as an italic
61 font; if the 02 bit is set, then it will be treated as a
62 bold font. The code field in the font description field
63 gives the code which will be used to output the character.
64 This code can also be used in the __N__ escape sequence
65 in __troff__.
66 !!OPTIONS
67
68
69 __-F__''dir''
70
71
72 Prepend directory ''dir''__/dev__''name'' to the
73 search path for font and device description files;
74 ''name'' is the name of the device, usually __ascii__,
75 __ascii8__, __latin1__, __utf8__, __nippon__ or
76 __cp1047__.
77
78
79 __-h__
80
81
82 Use horizontal tabs in the output. Tabs are assumed to be
83 set every 8 columns.
84
85
86 __-f__
87
88
89 Use form feeds in the output. A form feed will be output at
90 the end of each page that has no output on its last
91 line.
92
93
94 __-b__
95
96
97 Suppress the use of overstriking for bold
98 characters.
99
100
101 __-u__
102
103
104 Suppress the use of underlining for italic
105 characters.
106
107
108 __-B__
109
110
111 Use only overstriking for bold-italic
112 characters.
113
114
115 __-U__
116
117
118 Use only underlining for bold-italic
119 characters.
120
121
122 __-o__
123
124
125 Suppress overstriking (other than for bold or underlined
126 characters).
127
128
129 __-d__
130
131
132 Ignore all __D__ commands. Without this __grotty__
133 will render __D'l...'__ commands that have at least at
134 least one zero argument (and so are either horizontal or
135 vertical) using __-__, __|__ and __+__
136 characters.
137
138
139 __-v__
140
141
142 Print the version number.
143 !!FILES
144
145
146 __/usr/share/groff/1.17.2/font/devascii/DESC__
147
148
149 Device description file for __ascii__
150 device.
151
152
153 __/usr/share/groff/1.17.2/font/devascii/__''F''
154
155
156 Font description file for font ''F'' of __ascii__
157 device.
158
159
160 __/usr/share/groff/1.17.2/font/devascii8/DESC__
161
162
163 Device description file for __ascii8__
164 device.
165
166
167 __/usr/share/groff/1.17.2/font/devlatin1/DESC__
168
169
170 Device description file for __latin1__
171 device.
172
173
174 __/usr/share/groff/1.17.2/font/devnippon/DESC__
175
176
177 Device description file for __nippon__
178 device.
179
180
181 __/usr/share/groff/1.17.2/font/devlatin1/__''F''
182
183
184 Font description file for font ''F'' of __latin1__
185 device.
186
187
188 __/usr/share/groff/1.17.2/font/devutf8/DESC__
189
190
191 Device description file for __utf8__ device.
192
193
194 __/usr/share/groff/1.17.2/font/devutf8/__''F''
195
196
197 Font description file for font ''F'' of __utf8__
198 device.
199
200
201 __/usr/share/groff/1.17.2/font/devcp1047/DESC__
202
203
204 Device description file for __cp1047__
205 device.
206
207
208 __/usr/share/groff/1.17.2/font/devcp1047/__''F''
209
210
211 Font description file for font ''F'' of __cp1047__
212 device.
213
214
215 __/usr/share/groff/1.17.2/tmac/tty.tmac__
216
217
218 Macros for use with __grotty__.
219
220
221 __/usr/share/groff/1.17.2/tmac/tty-char.tmac__
222
223
224 Additional klugdey character definitions for use with
225 __grotty__.
226
227
228 Note that on EBCDIC hosts, only files for the __cp1047__
229 device will be installed.
230 !!BUGS
231
232
233 __grotty__ is intended only for simple
234 documents.
235
236
237 There is no support for fractional horizontal or vertical
238 motions.
239
240
241 There is no support for __D__ commands other than
242 horizontal and vertical lines.
243
244
245 Characters above the first line (ie with a vertical position
246 of 0) cannot be printed.
247 !!SEE ALSO
248
249
4 perry 250 groff(1), troff(1), groff_out(5),
251 groff_font(5), __groff_char__(7), ul(1),
1 perry 252 more(1), less(1)
253 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.