0 5ˆ 0ÈÁÆ 9ˆÀ¿ ƒh¹¾Æ90 ;ˆÀ¿ ƒh¹¾Æ;auto =ˆÀ¿ ƒh¹¾Æ=auto ?ˆ 0ȾÆ#Cˆl–Ým_Jå4Ÿº‚^PB¸'.å1hßÀ „dAt_¿Ç?÷C Copyright 1989-2018 Free Software Foundation, Inc. Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. 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 (this is, add `-P-c' to groff's command line options). 3. Append the following fragment to the `troffrc' file: --- start --- .if n \{\ . nr _C \n(.C . cp 0 . . \" The following code sets a top-of-page trap to disable grotty's TTY . \" mode. Since neither \X nor .output can be used before the first . \" page has started, we must use a trap. To make it work with troff's . \" -o option, we wait until the first printed page. . . de sgr@dummy . . . . rn wh wh@old . . \" The stand-alone version. If no other trap is set, we can safely . \" insert the truncated vertical space caused by the trap (if any). . \" Otherwise we assume that the document's main macro package takes . \" care of that. As soon as the trap has been executed, it is removed. . de1 no@sgr . if \\n[.P] \{\ . if (\\n[.t] == \\n[.p]) \{\ . rn wh@old wh . rm no@sgr . wh 0 . sp \\n[.trunc] . nop \X'tty: sgr 0' . sp -1 . \}\} . . . . wh@old 0 no@sgr . . \" The piggyback version to be appended to macros planted with the . \" modified `wh' request. . de1 no@sgr1 . if \\n[.P] \{\ . rn wh@old wh . ds no@sgr1 . nop \X'tty: sgr 0' . sp -1 . \} . . . . \" We redefine the `wh' request so that `no@sgr1' is appended to . \" the trap macro. . de1 wh . am1 \\$2 sgr@dummy . no@sgr1 . sgr@dummy . wh@old \\$1 \\$2 . . . . cp \n[_C] .\} --- end --- ---------------------------------------------------------------------- * The UTF-8 output of grotty has strange characters for the minus, the hyphen, and the right quote. Why? The used Unicode characters (U+2212 for the minus sign and U+2010 for the hyphen) are the correct ones, but many programs can't search them properly. The same is true for the right quote (U+201D). To map those characters back to the ASCII characters, insert the following code snippet into the `troffrc' configuration file: .if '\*[.T]'utf8' \{\ . char \- \N'45' . char - \N'45' . char ' \N'39' .\} ---------------------------------------------------------------------- * Processing mdoc man pages like `groff_mdoc.n' fails if I use `test-groff'. Why? The mdoc package works only after installation, not with test-groff. Reason is that the macro files of mdoc get stripped off the `doc-' prefix before they are copied to the final destination. ---------------------------------------------------------------------- * My document says that the current year is 19100, not 2000. In groff, as in traditional troff, the yr number register yields the year minus 1900. Unfortunately, there is a longstanding bug in the Troff User's Manual