645 lines
11 KiB
HTML
645 lines
11 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of GROTTY</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>GROTTY</H1>
|
|
Section: User Commands (1)<BR>Updated: 21 March 2020<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
grotty - groff driver for typewriter-like devices
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
|
|
|
|
[ <B>-bBcdfhioruUv</B> ]
|
|
|
|
[ <B>-F </B><I>dir</I> ]
|
|
|
|
[<I>file</I>
|
|
|
|
...]
|
|
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
|
|
<B>grotty</B>
|
|
|
|
translates the output of GNU
|
|
<B>troff</B>
|
|
|
|
into a form suitable for typewriter-like devices.
|
|
Normally
|
|
<B>grotty</B>
|
|
|
|
should be invoked by using the
|
|
<B>groff</B>
|
|
|
|
command with a
|
|
<B>-Tascii</B>,
|
|
|
|
<B>-Tlatin1</B>
|
|
|
|
or
|
|
<B>-Tutf8</B>
|
|
|
|
option on ASCII based systems, and with
|
|
<B>-Tcp1047</B>
|
|
|
|
and
|
|
<B>-Tutf8</B>
|
|
|
|
on EBCDIC based hosts.
|
|
If no files are given,
|
|
<B>grotty</B>
|
|
|
|
reads the standard input.
|
|
A filename of
|
|
<B>-</B>
|
|
|
|
also causes
|
|
<B>grotty</B>
|
|
|
|
to read the standard input.
|
|
Output is written to the standard output.
|
|
<P>
|
|
|
|
By default,
|
|
<B>grotty</B>
|
|
|
|
emits SGR escape sequences (from ISO 6429, also called ANSI color
|
|
escapes) to change text attributes (bold, italic, colors).
|
|
This makes it possible to have eight different background and
|
|
foreground colors; additionally, bold and italic attributes can be
|
|
used at the same time (by using the BI font).
|
|
<P>
|
|
|
|
The following colors are defined in
|
|
<B>tty.tmac</B>:
|
|
|
|
black, white, red, green, blue, yellow, magenta, cyan.
|
|
Unknown colors are mapped to the default color (which is dependent on
|
|
the settings of the terminal; in most cases, this is black for the
|
|
foreground and white for the background).
|
|
<P>
|
|
|
|
Use the
|
|
<B>-c</B>
|
|
|
|
switch to revert to the old behaviour, printing a bold character
|
|
<I>c</I>
|
|
|
|
with the sequence
|
|
"<I>c</I>
|
|
|
|
BACKSPACE
|
|
<I>c</I>"
|
|
|
|
and an italic character
|
|
<I>c</I>
|
|
|
|
by the sequence
|
|
"<B>_</B>
|
|
|
|
BACKSPACE
|
|
<I>c</I>".
|
|
|
|
At the same time, color output is disabled.
|
|
The same effect can be achieved by setting either the
|
|
<I>GROFF_NO_SGR</I>
|
|
|
|
environment variable or using the 'sgr' X command (see below).
|
|
<P>
|
|
|
|
For SGR support, it is necessary to use the
|
|
<B>-R</B>
|
|
|
|
option of
|
|
<B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1)
|
|
|
|
to disable the interpretation of
|
|
<B>grotty</B>'s
|
|
|
|
old output format.
|
|
Consequently, all programs which use
|
|
<B>less</B>
|
|
|
|
as the pager program have to pass this option to it.
|
|
For
|
|
<B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1)
|
|
|
|
in particular, either add
|
|
<B>-R</B>
|
|
|
|
to the
|
|
<I>PAGER</I>
|
|
|
|
environment variable, e.g.
|
|
<DL COMPACT><DT id="1"><DD>
|
|
<P>
|
|
|
|
<B>PAGER=/usr/bin/less -R</B>
|
|
|
|
<BR>
|
|
|
|
<B>export PAGER</B>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
or use the
|
|
<B>-P</B>
|
|
|
|
option of
|
|
<B>man</B>
|
|
|
|
to set the pager executable and its options, or modify the
|
|
configuration file of
|
|
<B>man</B>
|
|
|
|
in a similar fashion.
|
|
Note that with some
|
|
<B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1)
|
|
|
|
versions, you have to use the
|
|
<I>MANPAGER</I>
|
|
|
|
environment variable instead.
|
|
<P>
|
|
|
|
<B>grotty</B>'s
|
|
|
|
old output format can be displayed on a terminal
|
|
by piping through
|
|
<B><A HREF="/cgi-bin/man/man2html?1+ul">ul</A></B>(1).
|
|
|
|
Pagers such as
|
|
<B><A HREF="/cgi-bin/man/man2html?1+more">more</A></B>(1)
|
|
|
|
or
|
|
<B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1)
|
|
|
|
are also able to display these sequences.
|
|
Use either
|
|
<B>-B</B>
|
|
|
|
or
|
|
<B>-U</B>
|
|
|
|
when piping into
|
|
<B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1);
|
|
|
|
use
|
|
<B>-b</B>
|
|
|
|
when piping into
|
|
<B><A HREF="/cgi-bin/man/man2html?1+more">more</A></B>(1).
|
|
|
|
There is no need to filter the output through
|
|
<B><A HREF="/cgi-bin/man/man2html?1+col">col</A></B>(1)
|
|
|
|
since
|
|
<B>grotty</B>
|
|
|
|
never outputs reverse line feeds.
|
|
<P>
|
|
|
|
The font description file may contain a command
|
|
<DL COMPACT>
|
|
<DT id="2"><DD>
|
|
<B>internalname </B><I>n</I>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
where
|
|
<I>n</I>
|
|
|
|
is a decimal integer.
|
|
If the 01 bit in
|
|
<I>n</I>
|
|
|
|
is set,
|
|
then the font is treated as an italic font;
|
|
if the 02 bit is set,
|
|
then it is treated as a bold font.
|
|
The code field in the font description field gives the code which is
|
|
used to output the character.
|
|
This code can also be used in the
|
|
<B>\N</B>
|
|
|
|
escape sequence in
|
|
<B>troff</B>.
|
|
|
|
<P>
|
|
|
|
If the
|
|
<I>DESC</I>
|
|
|
|
file contains the keyword
|
|
<B>unicode</B>,
|
|
|
|
<B>grotty</B>
|
|
|
|
emits Unicode characters in UTF-8 encoding.
|
|
Otherwise, it emits characters in a single-byte encoding depending on
|
|
the data in the font description files.
|
|
See the
|
|
<B><A HREF="/cgi-bin/man/man2html?5+groff_font">groff_font</A></B>(5)
|
|
|
|
man page for more details.
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
|
|
Whitespace is permitted between a command-line option and its argument.
|
|
<DL COMPACT>
|
|
<DT id="3"><B>-b</B>
|
|
|
|
<DD>
|
|
Suppress the use of overstriking for bold characters.
|
|
Ignored if
|
|
<B>-c</B>
|
|
|
|
isn't used.
|
|
<DT id="4"><B>-B</B>
|
|
|
|
<DD>
|
|
Use only overstriking for bold-italic characters.
|
|
Ignored if
|
|
<B>-c</B>
|
|
|
|
isn't used.
|
|
<DT id="5"><B>-c</B>
|
|
|
|
<DD>
|
|
Use
|
|
<B>grotty</B>'s
|
|
|
|
old output format (see above).
|
|
This also disables color output.
|
|
<DT id="6"><B>-d</B>
|
|
|
|
<DD>
|
|
Ignore all
|
|
<B>\D</B>
|
|
|
|
commands.
|
|
Without this
|
|
<B>grotty</B>
|
|
|
|
renders
|
|
<B>\D'l...'</B>
|
|
|
|
commands that have at least one zero argument
|
|
(and so are either horizontal or vertical)
|
|
using
|
|
<B>-</B>,
|
|
|
|
<B>|</B>,
|
|
|
|
and
|
|
<B>+</B>
|
|
|
|
characters.
|
|
In a similar way,
|
|
<B>grotty</B>
|
|
|
|
handles
|
|
<B>\D'p...'</B>
|
|
|
|
commands which consist entirely of horizontal and vertical lines.
|
|
<DT id="7"><B>-f</B>
|
|
|
|
<DD>
|
|
Use form feeds in the output.
|
|
A form feed is output at the end of each page that has no output on
|
|
its last line.
|
|
<DT id="8"><B>-F</B><I>dir</I>
|
|
|
|
<DD>
|
|
Prepend directory
|
|
dir<I>/dev</I>name
|
|
|
|
to the search path for font and device description files;
|
|
<I>name</I>
|
|
|
|
is the name of the device, usually
|
|
<B>ascii</B>,
|
|
|
|
<B>latin1</B>,
|
|
|
|
<B>utf8</B>,
|
|
|
|
or
|
|
<B>cp1047</B>.
|
|
|
|
<DT id="9"><B>-h</B>
|
|
|
|
<DD>
|
|
Use horizontal tabs in the output.
|
|
Tabs are assumed to be set every 8 columns.
|
|
<DT id="10"><B>-i</B>
|
|
|
|
<DD>
|
|
Use escape sequences to set the italic text attribute instead of the
|
|
underline attribute for italic fonts ('I' and 'BI').
|
|
Note that most terminals (including xterm) don't support this.
|
|
Ignored if
|
|
<B>-c</B>
|
|
|
|
is active.
|
|
<DT id="11"><B>-o</B>
|
|
|
|
<DD>
|
|
Suppress overstriking (other than for bold or underlined characters in
|
|
case the old output format has been activated with
|
|
<B>-c</B>).
|
|
|
|
<DT id="12"><B>-r</B>
|
|
|
|
<DD>
|
|
Use escape sequences to set the reverse text attribute instead of the
|
|
underline attribute for italic fonts ('I' and 'BI').
|
|
Ignored if
|
|
<B>-c</B>
|
|
|
|
is active.
|
|
<DT id="13"><B>-u</B>
|
|
|
|
<DD>
|
|
Suppress the use of underlining for italic characters.
|
|
Ignored if
|
|
<B>-c</B>
|
|
|
|
isn't used.
|
|
<DT id="14"><B>-U</B>
|
|
|
|
<DD>
|
|
Use only underlining for bold-italic characters.
|
|
Ignored if
|
|
<B>-c</B>
|
|
|
|
isn't used.
|
|
<DT id="15"><B>-v</B>
|
|
|
|
<DD>
|
|
Print the version number.
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>USAGE</H2>
|
|
|
|
|
|
<B>grotty</B>
|
|
|
|
understands a single X command produced using the
|
|
<B>\X</B>
|
|
|
|
escape sequence.
|
|
<DL COMPACT>
|
|
<DT id="16"><B>\X'tty: sgr </B><I>n</I><B>'</B>
|
|
|
|
<DD>
|
|
If
|
|
<I>n</I>
|
|
|
|
is non-zero or missing, enable SGR output (this is the default),
|
|
otherwise use the old drawing scheme for bold and underline.
|
|
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="17"><I>GROFF_NO_SGR</I>
|
|
|
|
<DD>
|
|
If set, the old drawing scheme for bold and underline (using the
|
|
backspace character) is active.
|
|
Colors are disabled.
|
|
<DT id="18"><I>GROFF_FONT_PATH</I>
|
|
|
|
<DD>
|
|
A list of directories in which to search for the
|
|
<I>dev</I>name
|
|
|
|
directory in addition to the default ones.
|
|
See
|
|
<B><A HREF="/cgi-bin/man/man2html?1+troff">troff</A></B>(1)
|
|
|
|
and
|
|
<B><A HREF="/cgi-bin/man/man2html?5+groff_font">groff_font</A></B>(5)
|
|
|
|
for more details.
|
|
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="19"><I>/usr/:share/:groff/:1.22.4/:font/devascii/DESC</I>
|
|
|
|
<DD>
|
|
Device description file for the
|
|
<B>ascii</B>
|
|
|
|
device.
|
|
<DT id="20"><I>/usr/:share/:groff/:1.22.4/:font/devascii/</I>F
|
|
|
|
<DD>
|
|
Font description file for font
|
|
<I>F</I>
|
|
|
|
of the
|
|
<B>ascii</B>
|
|
|
|
device.
|
|
<DT id="21"><I>/usr/:share/:groff/:1.22.4/:font/devlatin1/DESC</I>
|
|
|
|
<DD>
|
|
Device description file for the
|
|
<B>latin1</B>
|
|
|
|
device.
|
|
<DT id="22"><I>/usr/:share/:groff/:1.22.4/:font/devlatin1/</I>F
|
|
|
|
<DD>
|
|
Font description file for font
|
|
<I>F</I>
|
|
|
|
of the
|
|
<B>latin1</B>
|
|
|
|
device.
|
|
<DT id="23"><I>/usr/:share/:groff/:1.22.4/:font/devutf8/DESC</I>
|
|
|
|
<DD>
|
|
Device description file for the
|
|
<B>utf8</B>
|
|
|
|
device.
|
|
<DT id="24"><I>/usr/:share/:groff/:1.22.4/:font/devutf8/</I>F
|
|
|
|
<DD>
|
|
Font description file for font
|
|
<I>F</I>
|
|
|
|
of the
|
|
<B>utf8</B>
|
|
|
|
device.
|
|
<DT id="25"><I>/usr/:share/:groff/:1.22.4/:font/devcp1047/DESC</I>
|
|
|
|
<DD>
|
|
Device description file for the
|
|
<B>cp1047</B>
|
|
|
|
device.
|
|
<DT id="26"><I>/usr/:share/:groff/:1.22.4/:font/devcp1047/</I>F
|
|
|
|
<DD>
|
|
Font description file for font
|
|
<I>F</I>
|
|
|
|
of the
|
|
<B>cp1047</B>
|
|
|
|
device.
|
|
<DT id="27"><I>/usr/:share/:groff/:1.22.4/:tmac/tty.tmac</I>
|
|
|
|
<DD>
|
|
Macros for use with
|
|
<B>grotty</B>.
|
|
|
|
<DT id="28"><I>/usr/:share/:groff/:1.22.4/:tmac/tty-char.tmac</I>
|
|
|
|
<DD>
|
|
Additional character definitions for use with
|
|
<B>grotty</B>.
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
Note that on EBCDIC hosts, only files for the
|
|
<B>cp1047</B>
|
|
|
|
device is installed.
|
|
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
|
|
<B>grotty</B>
|
|
|
|
is intended only for simple documents.
|
|
<P>
|
|
|
|
There is no support for fractional horizontal or vertical motions.
|
|
<P>
|
|
|
|
There is no support for
|
|
<B>\D</B>
|
|
|
|
commands other than horizontal and vertical lines.
|
|
<P>
|
|
|
|
Characters above the first line (i.e. with a vertical position
|
|
of~0) cannot be printed.
|
|
<P>
|
|
|
|
Color handling differs from
|
|
<B><A HREF="/cgi-bin/man/man2html?1+grops">grops</A></B>(1).
|
|
|
|
<B>\M</B>
|
|
|
|
doesn't set the fill color for closed graphic objects (which
|
|
<B>grotty</B>
|
|
|
|
doesn't support anyway) but changes the background color of the
|
|
character cell, affecting all subsequent operations.
|
|
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+groff">groff</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+troff">troff</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+groff_out">groff_out</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+groff_font">groff_font</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+groff_char">groff_char</A></B>(7),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+ul">ul</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+more">more</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+less">less</A></B>(1)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="29"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="30"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="31"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="32"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="33"><A HREF="#lbAF">USAGE</A><DD>
|
|
<DT id="34"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="35"><A HREF="#lbAH">FILES</A><DD>
|
|
<DT id="36"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="37"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:15 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|