PACKAGE NAME
------------
neko_groff


SOURCE/VERSION
--------------
groff-1.22.3 / 2


IRIX/MIPSPRO VERSION
--------------------
6.5.22m / 7.4.4m


CONFIGURE FLAGS
---------------
setenv CC cc
setenv CFLAGS "-O2 -n32 -mips4"
setenv PERL /usr/nekoware/bin/perl
./configure --prefix=/usr/nekoware --disable-rpath --with-libiconv-prefix=/usr/nekoware
gmake
gmake install

For mips3 change CFLAGS into:
setenv CFLAGS "-O2 -n32 -mips3"


KNOWN DEPENDENCIES
------------------
neko_libiconv.sw.lib and headers for locale support
neko_perl.sw.eoe for building groff. The vanilla perl on IRIX systems is too old


ERRORS/MISCELLANEOUS
--------------------
To assure compatibility with more terminals i've changed /usr/nekoware/share/groff/1.22.3/tmac/troffrc to disable SGR escape sequences (see the PROBLEMS file in the source tree). If you don't like this, feel free to remove the end of the file starting with line 57.

The relevant quote from PROBLEMS file, line 20 onwards:

 * 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

End quote


I noticed that some man pages installed with this package issue warnings when viewed with its own groff. Try 'man troff' and you will receive these two warnings:

> man troff
Reformatting page.  Wait...
/usr/nekoware/share/man/man1/troff.1:200: warning [p 2, 0.8i]: cannot adjust line
/usr/nekoware/share/man/man1/troff.1:560: warning [p 4, 3.2i]: cannot adjust line

This is due to the fact that the man page troff.1 contains /usr/nekoware path locations generated from 'make' and they are a bit long, which causes groff to complain. Other than being cosmetic, it doesn't do any harm.


This package has dual support for both mips3 and mips4 architecture, controlled 
by the mach(CPUARCH=R4000) switch for libraries and executables.


PACKAGED BY
-----------

S/N   VER      PORTER
-------------------------------------
1     1.19.1:  Timo Kanera
2     1.22.3:  Frank Everdij (dexter1)