Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GROTTY(1)		    General Commands Manual		     GROTTY(1)

NAME
       grotty -	groff driver for typewriter-like devices

SYNOPSIS
       grotty [	-hfbuodBUv ] [ -Fdir ] [ files...  ]

       It is possible to have whitespace between the -F	option and its parame-
       ter.

DESCRIPTION
       grotty translates the output of GNU troff  into	a  form	 suitable  for
       typewriter-like	devices.   Normally  grotty should be invoked by using
       the groff command with a	-Tascii, -Tkoi8-r, -Tlatin1 or	-Tutf8	option
       on ASCII	based systems, and with	-Tcp1047 on EBCDIC based hosts.	 If no
       files are given,	grotty will read the standard input.  A	filename of  -
       will  also  cause grotty	to read	the standard input.  Output is written
       to the standard output.

       Normally	grotty prints  a  bold	character  c  using  the  sequence  `c
       BACKSPACE  c' and a italic character c by the sequence `_ BACKSPACE c'.
       These sequences can be displayed	on a terminal by piping	through	ul(1).
       Pagers  such  as	 more(1) or less(1) are	also able to display these se-
       quences.	 Use either -B or -U when piping into  less(1);	 use  -b  when
       piping  into  more(1).	There  is no need to filter the	output through
       col(1) since grotty never outputs reverse line feeds.

       The font	description file may contain a command

	      internalname n

       where n is a decimal integer.  If the 01	bit in n is set, then the font
       will  be	 treated as an italic font; if the 02 bit is set, then it will
       be treated as a bold font.  The code  field  in	the  font  description
       field  gives the	code which will	be used	to output the character.  This
       code can	also be	used in	the \N escape sequence in troff.

OPTIONS
       -Fdir  Prepend directory	dir/devname to the search path	for  font  and
	      device  description  files; name is the name of the device, usu-
	      ally ascii, koi8-r, latin1, utf8,	or cp1047.

       -h     Use horizontal tabs in the output.  Tabs are assumed to  be  set
	      every 8 columns.

       -f     Use form feeds in	the output.  A form feed will be output	at the
	      end of each page that has	no output on its last line.

       -b     Suppress the use of overstriking for bold	characters.

       -u     Suppress the use of underlining for italic characters.

       -B     Use only overstriking for	bold-italic characters.

       -U     Use only underlining for bold-italic characters.

       -o     Suppress overstriking (other than	for bold or underlined charac-
	      ters).

       -d     Ignore  all  \D  commands.   Without  this  grotty  will	render
	      \D'l...'	commands that have at least at least one zero argument
	      (and  so	are  either  horizontal	 or vertical) using -, | and +
	      characters.

       -v     Print the	version	number.

FILES
       /usr/share/groff_font/devascii/DESC
	      Device description file for ascii	device.

       /usr/share/groff_font/devascii/F
	      Font description file for	font F of ascii	device.

       /usr/share/groff_font/devkoi8-r/DESC
	      Device description file for koi8-r device.

       /usr/share/groff_font/devkoi8-r/F
	      Font description file for	font F of koi8-r device.

       /usr/share/groff_font/devlatin1/DESC
	      Device description file for latin1 device.

       /usr/share/groff_font/devlatin1/F
	      Font description file for	font F of latin1 device.

       /usr/share/groff_font/devutf8/DESC
	      Device description file for utf8 device.

       /usr/share/groff_font/devutf8/F
	      Font description file for	font F of utf8 device.

       /usr/share/groff_font/devcp1047/DESC
	      Device description file for cp1047 device.

       /usr/share/groff_font/devcp1047/F
	      Font description file for	font F of cp1047 device.

       /usr/share/tmac/tty.tmac
	      Macros for use with grotty.

       /usr/share/tmac/tty-char.tmac
	      Additional klugdey character definitions for use with grotty.

       Note that on EBCDIC hosts, only files for the cp1047 device will	be in-
       stalled.

BUGS
       grotty is intended only for simple documents.

       There is	no support for fractional horizontal or	vertical motions.

       There  is no support for	\D commands other than horizontal and vertical
       lines.

       Characters above	the first line (ie with	a vertical position of 0) can-
       not be printed.

SEE ALSO
       groff(1),  troff(1), groff_out(5), groff_font(5), groff_char(7),	ul(1),
       more(1),	less(1)

Groff Version 1.17.2		 6 August 2001			     GROTTY(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | BUGS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=grotty&sektion=1&manpath=FreeBSD+4.7-RELEASE>

home | help