grotty.man revision 18128
1.ig \"-*- nroff -*- 2Copyright (C) 1989-1995 Free Software Foundation, Inc. 3 4Permission is granted to make and distribute verbatim copies of 5this manual provided the copyright notice and this permission notice 6are preserved on all copies. 7 8Permission is granted to copy and distribute modified versions of this 9manual under the conditions for verbatim copying, provided that the 10entire resulting derived work is distributed under the terms of a 11permission notice identical to this one. 12 13Permission is granted to copy and distribute translations of this 14manual into another language, under the above conditions for modified 15versions, except that this permission notice may be included in 16translations approved by the Free Software Foundation instead of in 17the original English. 18.. 19.TH GROTTY @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 20.SH NAME 21grotty \- groff driver for typewriter-like devices 22.SH SYNOPSIS 23.B grotty 24[ 25.B \-hfbuodBUv 26] [ 27.BI \-F dir 28] [ 29.IR files \|.\|.\|. 30] 31.SH DESCRIPTION 32.B grotty 33translates the output of GNU 34.B troff 35into a form suitable for typewriter-like devices. 36Normally 37.B grotty 38should invoked by using the 39.B groff 40command 41with a 42.BR \-Tascii , 43.B \-Tkoi8-r 44or 45.B \-Tlatin1 46option. 47If no files are given, 48.B grotty 49will read the standard input. 50A filename of 51.B \- 52will also cause 53.B grotty 54to read the standard input. 55Output is written to the standard output. 56.LP 57Normally 58.B grotty 59prints a bold character 60.I c 61using the sequence 62.RI ` c 63.SM BACKSPACE 64.IR c ' 65and a italic character 66.I c 67by the sequence 68.RB ` _ 69.SM BACKSPACE 70.IR c '. 71These sequences can be displayed on a terminal 72by piping through 73.BR ul (1). 74Pagers such as 75.BR more (1) 76or 77.BR less (1) 78are also able to display these sequences. 79Use either 80.B \-B 81or 82.B \-U 83when piping into 84.BR less (1); 85use 86.B \-b 87when piping into 88.BR more (1). 89There is no need to filter the output through 90.BR col (1) 91since 92.B grotty 93never outputs reverse line feeds. 94.LP 95The font description file may contain a command 96.IP 97.BI internalname\ n 98.LP 99where 100.I n 101is a decimal integer. 102If the 01 bit in 103.I n 104is set, 105then the font will be treated as an italic font; 106if the 02 bit is set, 107then it will be treated as a bold font. 108The code field in the font description field gives the 109code which will be used to output the character. 110This code can also be used in the 111.B \eN 112escape sequence in 113.BR troff . 114.SH OPTIONS 115.TP 116.BI \-F dir 117Search the directory 118.IB dir /dev name 119for font and device description files; 120.I name 121is the name of the device, usually 122.BR ascii , 123.B koi8-r 124or 125.BR latin1 . 126.TP 127.B \-h 128Use horizontal tabs in the output. 129Tabs are assumed to be set every 8 columns. 130.TP 131.B \-f 132Use form feeds in the output. 133A form feed will be output at the end of each page that has no output 134on its last line. 135.TP 136.B \-b 137Suppress the use of overstriking for bold characters. 138.TP 139.B \-u 140Suppress the use of underlining for italic characters. 141.TP 142.B \-B 143Use only overstriking for bold-italic characters. 144.TP 145.B \-U 146Use only underlining for bold-italic characters. 147.TP 148.B \-o 149Suppress overstriking (other than for bold or underlined characters). 150.TP 151.B \-d 152Ignore all 153.B \eD 154commands. 155Without this 156.B grotty 157will render 158.B \eD'l\|.\|.\|.' 159commands that have at least at least one zero argument 160(and so are either horizontal or vertical) 161using 162.BR \- , 163.B | 164and 165.B + 166characters. 167.TP 168.B \-v 169Print the version number. 170.SH FILES 171.TP 172.B @FONTDIR@/dev\fIname\fB/DESC 173Device description file for 174.I name 175device. 176.TP 177.BI @FONTDIR@/dev\fIname\fB/ F 178Font description file for font 179.I F 180of 181.I name 182device. 183.TP 184.B @MACRODIR@/tmac.tty 185Macros for use with 186.BR grotty . 187.TP 188.B @MACRODIR@/tmac.tty-char 189Additional klugey character definitions for use with 190.BR grotty . 191.SH BUGS 192.LP 193.B grotty 194is intended only for simple documents. 195.LP 196There is no support for fractional horizontal or vertical motions. 197.LP 198There is no support for 199.B \eD 200commands 201other than horizontal and vertical lines. 202.LP 203Characters above the first line (ie with a vertical position of 0) 204cannot be printed. 205.SH "SEE ALSO" 206.BR groff (@MAN1EXT@), 207.BR @g@troff (@MAN1EXT@), 208.BR groff_out (@MAN5EXT@), 209.BR groff_font (@MAN5EXT@), 210.BR groff_char (@MAN7EXT@), 211.BR ul (1), 212.BR more (1) 213