-->

Previous | Table of Contents | Next

Page 235

SEE ALSO

afmtodit(1), groff(1), gtroff(1), psbb(1),groff_out(5), groff_font(5), groff_char(7)

Groff Version 1.09, 14 February 1995

grotty

grotty—groff driver for typewriter-like devices

SINOPSIS


grotty [ _hfbuodBUv ][_Fdir ][files ... ]

DESCRIPTION

grotty translates the output of GNU troff into a form suitable for typewriter-like devices. Normally, grotty should invoked by using the groff command with a _Tascii or _Tlatin1 option. 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 an 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 sequences. 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:


internalnamen

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 that will be used to output the character. This code can also be used in the \N escape sequence in troff.

OPTIONS

_Fdir Search the directory dir/devname for font and device description files; name is the name of the device, usually ascii or latin1.
_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 characters).
_d Ignore all \D commands. Without this, grotty will render \D'l ...' commands that have at least one zero argument (and so are either horizontal or vertical) using _, |, and + characters.
_v Print the version number.

FILES

/usr/lib/groff/font/devascii/DESC Device description file for ascii device.
/usr/lib/groff/font/devascii/F Font description file for font F of ascii device.
/usr/lib/groff/font/devlatin1/DESC Device description file for latin1 device.
/usr/lib/groff/font/devlatin1/F Font description file for font F of latin1 device.
/usr/lib/groff/tmac/tmac.tty Macros for use with grotty.
/usr/lib/groff/tmac/tmac.tty-char Additional kludgy character definitions for use with grotty.

Page 236

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 (that is, with a vertical position of 0) cannot be printed.

SEE ALSO

groff(1), gtroff(1), groff_out(5),groff_font(5), groff_char(7), ul(1), more(1), less(1)

Groff Version1.09, 14 February 1995

gsoelim

gsoelim—Interpret .so requests in groff input

SINOPSIS


gsoelim [ _Cv ][files ... ]

DESCRIPTION

gsoelim reads files and replaces lines of the form


.sofile

by the contents of file. It is useful if files included with so need to be preprocessed. Normally, gsoelim should be invoked with the _s option of groff.

OPTIONS

_C Recognize .so even when followed by a character other than space or newline
_v Print the version number

SEE ALSO

Groff Version1.09, 15 September 1992

gtbl

gtbl—Format tables for troff

SINOPSIS


gtbl [ _Cv ][files ... ]

DESCRIPTION

This manual page describes the GNU version of tbl, which is part of the groff document formatting system. tbl compiles descriptions of tables embedded within troff input files into commands that are understood by troff. Normally, it should be invoked using the _t option of groff. It is highly compatible with UNIX tbl. The output generated by GNU tbl cannot be processed with UNIX troff; it must be processed with GNU troff. If no files are given on the command line, the standard input will be read. A filename of _ will cause the standard input to be read.

Page 237

OPTIONS

_C Recognize .TS and .TE even when followed by a character other than space or newline
_v Print the version number

USAGE

Only the differences between GNU tbl and UNIX tbl are described here.

Normally, tbl attempts to prevent undesirable breaks in the table by using diversions. This can sometimes interact badly with macro packages' own use of diversions, when footnotes, for example, are used. The nokeep option tells tbl not to try to prevent breaks in this way.

The decimalpoint option specifies the character to be recognized as the decimal point character in place of the default period. It takes an argument in parentheses, which must be a single character, as for the tab option.

The f format modifier can be followed by an arbitrary length font name in parentheses.

There is a d format modifier that means that a vertically spanning entry should be aligned at the bottom of its range.

There is no limit on the number of columns in a table, nor any limit on the number of text blocks. All the lines of a table are considered in deciding column widths, not just the first 200. Table continuation (.T&) lines are not restricted to the first 200 lines.

Numeric and alphabetic items may appear in the same column.

Numeric and alphabetic items may span horizontally.

tbl uses register, string, macro and diversion names beginning with 3. When using tbl, you should avoid using any names beginning with a 3.

BUGS

You should use .TSH/.TH in conjunction with a supporting macro package for all multipage boxed tables. If there is no header that you want to appear at the top of each page of the table, place the .TH line immediately after the format section. Do not enclose a multipage table within keep/release macros, or divert it in any other way.

A text block within a table must be able to fit on one page.

The bp request cannot be used to force a page-break in a multipage table. Instead, define BP as follows:


.de BP

.ie `\\n(.z" .bp \\$1

.el \!.BP \\$1

..

and use BP instead of bp.

SEE ALSO

groff(1), gtroff(1)

Groff Version 1.09, 1 April 1993

gtroff

gtroff—Format documents

SINOPSIS


gtroff [_abivzCER] [_w name] [_W name] [_d cs] [_f fam] [_m name] [_n num] [_o list] [_r cn] [_T name] [_F dir] [_M dir] [nfiles...n]

Previous | Table of Contents | Next