This file describes various problems that have been encountered in
compiling, installing and running groff.  Suggestions for additions or
other improvements to this file are welcome.

----------------------------------------------------------------------



Generic Problems
================



* Displaying a man page on a terminal with/without my favourite pager
 only gives garbage.

groff by default now uses SGR escape sequences (`ANSI color') to
control the display attributes (bold, underlined, colour) on TTYs.
Some terminals (e.g. `kterm') don't understand SGR, and some pagers
(e.g. older versions of `less' or `less' without the -R option) don't
understand SGR either.  There are three solutions to fix this, in order
of preference; please read the grotty man page for more details.

The fourth and probably best option is to update your terminal program
and pager to versions which can handle SGR.

 1. Set the GROFF_NO_SGR environment variable.

 2. Pass option -c to grotty.

 3. Append the following fragment to the `troffrc' file:


--- start ---
if n \{\
 nr _C \n(.C
 cp 0