grotty.man revision 75590
118099Spst.ig \"-*- nroff -*- 269631Sru$FreeBSD: head/contrib/groff/src/devices/grotty/grotty.man 75590 2001-04-17 12:28:31Z ru $ 369631SruCopyright (C) 1989-2000 Free Software Foundation, Inc. 418099Spst 518099SpstPermission is granted to make and distribute verbatim copies of 618099Spstthis manual provided the copyright notice and this permission notice 718099Spstare preserved on all copies. 818099Spst 918099SpstPermission is granted to copy and distribute modified versions of this 1018099Spstmanual under the conditions for verbatim copying, provided that the 1118099Spstentire resulting derived work is distributed under the terms of a 1218099Spstpermission notice identical to this one. 1318099Spst 1418099SpstPermission is granted to copy and distribute translations of this 1518099Spstmanual into another language, under the above conditions for modified 1618099Spstversions, except that this permission notice may be included in 1718099Spsttranslations approved by the Free Software Foundation instead of in 1818099Spstthe original English. 1918099Spst.. 2018099Spst.TH GROTTY @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@" 2118099Spst.SH NAME 2218099Spstgrotty \- groff driver for typewriter-like devices 2318099Spst.SH SYNOPSIS 2418099Spst.B grotty 2518099Spst[ 2618099Spst.B \-hfbuodBUv 2718099Spst] [ 2818099Spst.BI \-F dir 2918099Spst] [ 3018099Spst.IR files \|.\|.\|. 3118099Spst] 3269631Sru.PP 3369631SruIt is possible to have whitespace between the 3469631Sru.B \-F 3569631Sruoption and its parameter. 3618099Spst.SH DESCRIPTION 3718099Spst.B grotty 3818099Spsttranslates the output of GNU 3918099Spst.B troff 4018099Spstinto a form suitable for typewriter-like devices. 4118099SpstNormally 4218099Spst.B grotty 4375590Srushould be invoked by using the 4418099Spst.B groff 4518099Spstcommand 4618099Spstwith a 4718128Spst.BR \-Tascii , 4869631Sru.BR \-Tkoi8-r , 4969631Sru.B \-Tlatin1 5018099Spstor 5169631Sru.B \-Tutf8 5269631Sruoption on ASCII based systems, and with 5369631Sru.B \-Tcp1047 5469631Sruon EBCDIC based hosts. 5518099SpstIf no files are given, 5618099Spst.B grotty 5718099Spstwill read the standard input. 5818099SpstA filename of 5918099Spst.B \- 6018099Spstwill also cause 6118099Spst.B grotty 6218099Spstto read the standard input. 6318099SpstOutput is written to the standard output. 6418099Spst.LP 6518099SpstNormally 6618099Spst.B grotty 6718099Spstprints a bold character 6818099Spst.I c 6918099Spstusing the sequence 7018099Spst.RI ` c 7118099Spst.SM BACKSPACE 7218099Spst.IR c ' 7318099Spstand a italic character 7418099Spst.I c 7518099Spstby the sequence 7618099Spst.RB ` _ 7718099Spst.SM BACKSPACE 7818099Spst.IR c '. 7918099SpstThese sequences can be displayed on a terminal 8018099Spstby piping through 8118099Spst.BR ul (1). 8218099SpstPagers such as 8318099Spst.BR more (1) 8418099Spstor 8518099Spst.BR less (1) 8618099Spstare also able to display these sequences. 8718099SpstUse either 8818099Spst.B \-B 8918099Spstor 9018099Spst.B \-U 9118099Spstwhen piping into 9218099Spst.BR less (1); 9318099Spstuse 9418099Spst.B \-b 9518099Spstwhen piping into 9618099Spst.BR more (1). 9718099SpstThere is no need to filter the output through 9818099Spst.BR col (1) 9918099Spstsince 10018099Spst.B grotty 10118099Spstnever outputs reverse line feeds. 10218099Spst.LP 10318099SpstThe font description file may contain a command 10418099Spst.IP 10518099Spst.BI internalname\ n 10618099Spst.LP 10718099Spstwhere 10818099Spst.I n 10918099Spstis a decimal integer. 11018099SpstIf the 01 bit in 11118099Spst.I n 11218099Spstis set, 11318099Spstthen the font will be treated as an italic font; 11418099Spstif the 02 bit is set, 11518099Spstthen it will be treated as a bold font. 11618099SpstThe code field in the font description field gives the 11718099Spstcode which will be used to output the character. 11818099SpstThis code can also be used in the 11918099Spst.B \eN 12018099Spstescape sequence in 12118099Spst.BR troff . 12218099Spst.SH OPTIONS 12318099Spst.TP 12418099Spst.BI \-F dir 12575590SruPrepend directory 12618099Spst.IB dir /dev name 12775590Sruto the search path for font and device description files; 12818099Spst.I name 12918099Spstis the name of the device, usually 13018128Spst.BR ascii , 13169631Sru.BR koi8-r , 13269631Sru.BR latin1 , 13369631Sru.BR utf8 , 13418099Spstor 13569631Sru.BR cp1047 . 13618099Spst.TP 13718099Spst.B \-h 13818099SpstUse horizontal tabs in the output. 13918099SpstTabs are assumed to be set every 8 columns. 14018099Spst.TP 14118099Spst.B \-f 14218099SpstUse form feeds in the output. 14318099SpstA form feed will be output at the end of each page that has no output 14418099Spston its last line. 14518099Spst.TP 14618099Spst.B \-b 14718099SpstSuppress the use of overstriking for bold characters. 14818099Spst.TP 14918099Spst.B \-u 15018099SpstSuppress the use of underlining for italic characters. 15118099Spst.TP 15218099Spst.B \-B 15318099SpstUse only overstriking for bold-italic characters. 15418099Spst.TP 15518099Spst.B \-U 15618099SpstUse only underlining for bold-italic characters. 15718099Spst.TP 15818099Spst.B \-o 15918099SpstSuppress overstriking (other than for bold or underlined characters). 16018099Spst.TP 16118099Spst.B \-d 16218099SpstIgnore all 16318099Spst.B \eD 16418099Spstcommands. 16518099SpstWithout this 16618099Spst.B grotty 16718099Spstwill render 16818099Spst.B \eD'l\|.\|.\|.' 16918099Spstcommands that have at least at least one zero argument 17018099Spst(and so are either horizontal or vertical) 17118099Spstusing 17218099Spst.BR \- , 17318099Spst.B | 17418099Spstand 17518099Spst.B + 17618099Spstcharacters. 17718099Spst.TP 17818099Spst.B \-v 17918099SpstPrint the version number. 18018099Spst.SH FILES 18118099Spst.TP 18269631Sru.B @FONTDIR@/devascii/DESC 18318099SpstDevice description file for 18469631Sru.B ascii 18518099Spstdevice. 18618099Spst.TP 18769631Sru.BI @FONTDIR@/devascii/ F 18818099SpstFont description file for font 18918099Spst.I F 19018099Spstof 19169631Sru.B ascii 19218099Spstdevice. 19318099Spst.TP 19469631Sru.B @FONTDIR@/devkoi8-r/DESC 19569631SruDevice description file for 19669631Sru.B koi8-r 19769631Srudevice. 19869631Sru.TP 19969631Sru.BI @FONTDIR@/devkoi8-r/ F 20069631SruFont description file for font 20169631Sru.I F 20269631Sruof 20369631Sru.B koi8-r 20469631Srudevice. 20569631Sru.TP 20669631Sru.B @FONTDIR@/devlatin1/DESC 20769631SruDevice description file for 20869631Sru.B latin1 20969631Srudevice. 21069631Sru.TP 21169631Sru.BI @FONTDIR@/devlatin1/ F 21269631SruFont description file for font 21369631Sru.I F 21469631Sruof 21569631Sru.B latin1 21669631Srudevice. 21769631Sru.TP 21869631Sru.B @FONTDIR@/devutf8/DESC 21969631SruDevice description file for 22069631Sru.B utf8 22169631Srudevice. 22269631Sru.TP 22369631Sru.BI @FONTDIR@/devutf8/ F 22469631SruFont description file for font 22569631Sru.I F 22669631Sruof 22769631Sru.B utf8 22869631Srudevice. 22969631Sru.TP 23069631Sru.B @FONTDIR@/devcp1047/DESC 23169631SruDevice description file for 23269631Sru.B cp1047 23369631Srudevice. 23469631Sru.TP 23569631Sru.BI @FONTDIR@/devcp1047/ F 23669631SruFont description file for font 23769631Sru.I F 23869631Sruof 23969631Sru.B cp1047 24069631Srudevice. 24169631Sru.TP 24275590Sru.B @MACRODIR@/tty.tmac 24318099SpstMacros for use with 24418099Spst.BR grotty . 24518099Spst.TP 24675590Sru.B @MACRODIR@/tty-char.tmac 24775590SruAdditional klugdey character definitions for use with 24818099Spst.BR grotty . 24969631Sru.LP 25069631SruNote that on EBCDIC hosts, only files for the 25169631Sru.B cp1047 25269631Srudevice will be installed. 25318099Spst.SH BUGS 25418099Spst.LP 25518099Spst.B grotty 25618099Spstis intended only for simple documents. 25718099Spst.LP 25818099SpstThere is no support for fractional horizontal or vertical motions. 25918099Spst.LP 26018099SpstThere is no support for 26118099Spst.B \eD 26218099Spstcommands 26318099Spstother than horizontal and vertical lines. 26418099Spst.LP 26518099SpstCharacters above the first line (ie with a vertical position of 0) 26618099Spstcannot be printed. 26718099Spst.SH "SEE ALSO" 26818099Spst.BR groff (@MAN1EXT@), 26918099Spst.BR @g@troff (@MAN1EXT@), 27018099Spst.BR groff_out (@MAN5EXT@), 27118099Spst.BR groff_font (@MAN5EXT@), 27218099Spst.BR groff_char (@MAN7EXT@), 27318099Spst.BR ul (1), 27469631Sru.BR more (1), 27569631Sru.BR less (1) 276