grotty.man revision 18099
118099Spst.ig \"-*- nroff -*- 218099SpstCopyright (C) 1989-1995 Free Software Foundation, Inc. 318099Spst 418099SpstPermission is granted to make and distribute verbatim copies of 518099Spstthis manual provided the copyright notice and this permission notice 618099Spstare preserved on all copies. 718099Spst 818099SpstPermission is granted to copy and distribute modified versions of this 918099Spstmanual under the conditions for verbatim copying, provided that the 1018099Spstentire resulting derived work is distributed under the terms of a 1118099Spstpermission notice identical to this one. 1218099Spst 1318099SpstPermission is granted to copy and distribute translations of this 1418099Spstmanual into another language, under the above conditions for modified 1518099Spstversions, except that this permission notice may be included in 1618099Spsttranslations approved by the Free Software Foundation instead of in 1718099Spstthe original English. 1818099Spst.. 1918099Spst.TH GROTTY @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 2018099Spst.SH NAME 2118099Spstgrotty \- groff driver for typewriter-like devices 2218099Spst.SH SYNOPSIS 2318099Spst.B grotty 2418099Spst[ 2518099Spst.B \-hfbuodBUv 2618099Spst] [ 2718099Spst.BI \-F dir 2818099Spst] [ 2918099Spst.IR files \|.\|.\|. 3018099Spst] 3118099Spst.SH DESCRIPTION 3218099Spst.B grotty 3318099Spsttranslates the output of GNU 3418099Spst.B troff 3518099Spstinto a form suitable for typewriter-like devices. 3618099SpstNormally 3718099Spst.B grotty 3818099Spstshould invoked by using the 3918099Spst.B groff 4018099Spstcommand 4118099Spstwith a 4218099Spst.B \-Tascii 4318099Spstor 4418099Spst.B \-Tlatin1 4518099Spstoption. 4618099SpstIf no files are given, 4718099Spst.B grotty 4818099Spstwill read the standard input. 4918099SpstA filename of 5018099Spst.B \- 5118099Spstwill also cause 5218099Spst.B grotty 5318099Spstto read the standard input. 5418099SpstOutput is written to the standard output. 5518099Spst.LP 5618099SpstNormally 5718099Spst.B grotty 5818099Spstprints a bold character 5918099Spst.I c 6018099Spstusing the sequence 6118099Spst.RI ` c 6218099Spst.SM BACKSPACE 6318099Spst.IR c ' 6418099Spstand a italic character 6518099Spst.I c 6618099Spstby the sequence 6718099Spst.RB ` _ 6818099Spst.SM BACKSPACE 6918099Spst.IR c '. 7018099SpstThese sequences can be displayed on a terminal 7118099Spstby piping through 7218099Spst.BR ul (1). 7318099SpstPagers such as 7418099Spst.BR more (1) 7518099Spstor 7618099Spst.BR less (1) 7718099Spstare also able to display these sequences. 7818099SpstUse either 7918099Spst.B \-B 8018099Spstor 8118099Spst.B \-U 8218099Spstwhen piping into 8318099Spst.BR less (1); 8418099Spstuse 8518099Spst.B \-b 8618099Spstwhen piping into 8718099Spst.BR more (1). 8818099SpstThere is no need to filter the output through 8918099Spst.BR col (1) 9018099Spstsince 9118099Spst.B grotty 9218099Spstnever outputs reverse line feeds. 9318099Spst.LP 9418099SpstThe font description file may contain a command 9518099Spst.IP 9618099Spst.BI internalname\ n 9718099Spst.LP 9818099Spstwhere 9918099Spst.I n 10018099Spstis a decimal integer. 10118099SpstIf the 01 bit in 10218099Spst.I n 10318099Spstis set, 10418099Spstthen the font will be treated as an italic font; 10518099Spstif the 02 bit is set, 10618099Spstthen it will be treated as a bold font. 10718099SpstThe code field in the font description field gives the 10818099Spstcode which will be used to output the character. 10918099SpstThis code can also be used in the 11018099Spst.B \eN 11118099Spstescape sequence in 11218099Spst.BR troff . 11318099Spst.SH OPTIONS 11418099Spst.TP 11518099Spst.BI \-F dir 11618099SpstSearch the directory 11718099Spst.IB dir /dev name 11818099Spstfor font and device description files; 11918099Spst.I name 12018099Spstis the name of the device, usually 12118099Spst.B ascii 12218099Spstor 12318099Spst.BR latin1 . 12418099Spst.TP 12518099Spst.B \-h 12618099SpstUse horizontal tabs in the output. 12718099SpstTabs are assumed to be set every 8 columns. 12818099Spst.TP 12918099Spst.B \-f 13018099SpstUse form feeds in the output. 13118099SpstA form feed will be output at the end of each page that has no output 13218099Spston its last line. 13318099Spst.TP 13418099Spst.B \-b 13518099SpstSuppress the use of overstriking for bold characters. 13618099Spst.TP 13718099Spst.B \-u 13818099SpstSuppress the use of underlining for italic characters. 13918099Spst.TP 14018099Spst.B \-B 14118099SpstUse only overstriking for bold-italic characters. 14218099Spst.TP 14318099Spst.B \-U 14418099SpstUse only underlining for bold-italic characters. 14518099Spst.TP 14618099Spst.B \-o 14718099SpstSuppress overstriking (other than for bold or underlined characters). 14818099Spst.TP 14918099Spst.B \-d 15018099SpstIgnore all 15118099Spst.B \eD 15218099Spstcommands. 15318099SpstWithout this 15418099Spst.B grotty 15518099Spstwill render 15618099Spst.B \eD'l\|.\|.\|.' 15718099Spstcommands that have at least at least one zero argument 15818099Spst(and so are either horizontal or vertical) 15918099Spstusing 16018099Spst.BR \- , 16118099Spst.B | 16218099Spstand 16318099Spst.B + 16418099Spstcharacters. 16518099Spst.TP 16618099Spst.B \-v 16718099SpstPrint the version number. 16818099Spst.SH FILES 16918099Spst.TP 17018099Spst.B @FONTDIR@/devascii/DESC 17118099SpstDevice description file for 17218099Spst.B ascii 17318099Spstdevice. 17418099Spst.TP 17518099Spst.B @FONTDIR@/devascii/ F 17618099SpstFont description file for font 17718099Spst.I F 17818099Spstof 17918099Spst.B ascii device. 18018099Spst.TP 18118099Spst.B @FONTDIR@/devlatin1/DESC 18218099SpstDevice description file for 18318099Spst.B latin1 18418099Spstdevice. 18518099Spst.TP 18618099Spst.B @FONTDIR@/devlatin1/ F 18718099SpstFont description file for font 18818099Spst.I F 18918099Spstof 19018099Spst.B latin1 device. 19118099Spst.TP 19218099Spst.B @MACRODIR@/tmac.tty 19318099SpstMacros for use with 19418099Spst.BR grotty . 19518099Spst.TP 19618099Spst.B @MACRODIR@/tmac.tty-char 19718099SpstAdditional klugey character definitions for use with 19818099Spst.BR grotty . 19918099Spst.SH BUGS 20018099Spst.LP 20118099Spst.B grotty 20218099Spstis intended only for simple documents. 20318099Spst.LP 20418099SpstThere is no support for fractional horizontal or vertical motions. 20518099Spst.LP 20618099SpstThere is no support for 20718099Spst.B \eD 20818099Spstcommands 20918099Spstother than horizontal and vertical lines. 21018099Spst.LP 21118099SpstCharacters above the first line (ie with a vertical position of 0) 21218099Spstcannot be printed. 21318099Spst.SH "SEE ALSO" 21418099Spst.BR groff (@MAN1EXT@), 21518099Spst.BR @g@troff (@MAN1EXT@), 21618099Spst.BR groff_out (@MAN5EXT@), 21718099Spst.BR groff_font (@MAN5EXT@), 21818099Spst.BR groff_char (@MAN7EXT@), 21918099Spst.BR ul (1), 22018099Spst.BR more (1), 22118099Spst.BR less (1) 222