grotty.man revision 18100
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.B \-Tascii 43or 44.B \-Tlatin1 45option. 46If no files are given, 47.B grotty 48will read the standard input. 49A filename of 50.B \- 51will also cause 52.B grotty 53to read the standard input. 54Output is written to the standard output. 55.LP 56Normally 57.B grotty 58prints a bold character 59.I c 60using the sequence 61.RI ` c 62.SM BACKSPACE 63.IR c ' 64and a italic character 65.I c 66by the sequence 67.RB ` _ 68.SM BACKSPACE 69.IR c '. 70These sequences can be displayed on a terminal 71by piping through 72.BR ul (1). 73Pagers such as 74.BR more (1) 75or 76.BR less (1) 77are also able to display these sequences. 78Use either 79.B \-B 80or 81.B \-U 82when piping into 83.BR less (1); 84use 85.B \-b 86when piping into 87.BR more (1). 88There is no need to filter the output through 89.BR col (1) 90since 91.B grotty 92never outputs reverse line feeds. 93.LP 94The font description file may contain a command 95.IP 96.BI internalname\ n 97.LP 98where 99.I n 100is a decimal integer. 101If the 01 bit in 102.I n 103is set, 104then the font will be treated as an italic font; 105if the 02 bit is set, 106then it will be treated as a bold font. 107The code field in the font description field gives the 108code which will be used to output the character. 109This code can also be used in the 110.B \eN 111escape sequence in 112.BR troff . 113.SH OPTIONS 114.TP 115.BI \-F dir 116Search the directory 117.IB dir /dev name 118for font and device description files; 119.I name 120is the name of the device, usually 121.B ascii 122or 123.BR latin1 . 124.TP 125.B \-h 126Use horizontal tabs in the output. 127Tabs are assumed to be set every 8 columns. 128.TP 129.B \-f 130Use form feeds in the output. 131A form feed will be output at the end of each page that has no output 132on its last line. 133.TP 134.B \-b 135Suppress the use of overstriking for bold characters. 136.TP 137.B \-u 138Suppress the use of underlining for italic characters. 139.TP 140.B \-B 141Use only overstriking for bold-italic characters. 142.TP 143.B \-U 144Use only underlining for bold-italic characters. 145.TP 146.B \-o 147Suppress overstriking (other than for bold or underlined characters). 148.TP 149.B \-d 150Ignore all 151.B \eD 152commands. 153Without this 154.B grotty 155will render 156.B \eD'l\|.\|.\|.' 157commands that have at least at least one zero argument 158(and so are either horizontal or vertical) 159using 160.BR \- , 161.B | 162and 163.B + 164characters. 165.TP 166.B \-v 167Print the version number. 168.SH FILES 169.TP 170.B @FONTDIR@/devascii/DESC 171Device description file for 172.B ascii 173device. 174.TP 175.B @FONTDIR@/devascii/ F 176Font description file for font 177.I F 178of 179.B ascii device. 180.TP 181.B @FONTDIR@/devlatin1/DESC 182Device description file for 183.B latin1 184device. 185.TP 186.B @FONTDIR@/devlatin1/ F 187Font description file for font 188.I F 189of 190.B latin1 device. 191.TP 192.B @MACRODIR@/tmac.tty 193Macros for use with 194.BR grotty . 195.TP 196.B @MACRODIR@/tmac.tty-char 197Additional klugey character definitions for use with 198.BR grotty . 199.SH BUGS 200.LP 201.B grotty 202is intended only for simple documents. 203.LP 204There is no support for fractional horizontal or vertical motions. 205.LP 206There is no support for 207.B \eD 208commands 209other than horizontal and vertical lines. 210.LP 211Characters above the first line (ie with a vertical position of 0) 212cannot be printed. 213.SH "SEE ALSO" 214.BR groff (@MAN1EXT@), 215.BR @g@troff (@MAN1EXT@), 216.BR groff_out (@MAN5EXT@), 217.BR groff_font (@MAN5EXT@), 218.BR groff_char (@MAN7EXT@), 219.BR ul (1), 220.BR more (1), 221.BR less (1) 222