These are the ADE man utilities.  Most of these programs have significant
advantages over their Unix counterparts, such as greater speed, additional
options, and viewer arbitrary limits.

The programs that can be built with this package are: apropos, man,
whatis, whereis. Two perl scripts, catman.pl and makewhatis.pl, are also
included. The program col is also built and installed, as it is needed
by catman.pl

See the file NEWS for a list of major changes in the current release.

See the file INSTALL for compilation and installation instructions.

This package is based on the man-1.0 archive from ADE snapshots up to and
including 960902. See the file AUTHORS for details.

With the upgrade to NetBSD-current, a new format for /ade/etc/man.conf
is available. The man utility now calls external viewers for various
man page and documentation formats. For normal manual pages it uses
the PAGER environment variable or more by default. It expects that the
more utility accepts more than one filename. For an example how to set
up man for external viewers, see etc/man.conf.

INSTALLATION NOTE:
The current autoconf (2.10) test for ANSI C header files fails for ADE
headers. The reason is that ixemul.library's locale defaults to Amiga native
(ISO-8859-1) instead of US-ASCII based "C" locale. A hacked test
AC_HEADER_STD_IXEMUL is provided in aclocal.m4 and used in cofigure.in.

After installation, run the makewhatis.pl script to create the whatis.db
database:
# makewhatis.pl -o /ade/man/whatis.db /ade/man
Please note that this version of makewhatis will scan man?/ subdirectories
only. The old version, which scans cat?/ subdirectories only, is still
available as etc/makewhatis.old. makewhtis.pl -h gives a ist of supported
options

After installing new man pages in ${mandir}/man?, one should also run
catman.pl:
# catman.pl /ade/man
to create compressed, formatted man pages in cat?/. This may take a while
(several hours on a 040/25 w/ fast HD and disk cache) if there are many
files in man?/. Subsequent runs will only update cat?/ if the files in
man?/ are newer. Catman should always be run after new man pages have been
installed. Under **ix, it is recommended to run catman as a cron job.
catman.pl -h gives a list of supported options.

NOTE:
To date, formatted man pages in ADE are available as cat?/file.0.
The file names used by catman have the format cat?/file.?.gz.

With the exception of whereis, these programs all recognize the `--version'
option.  When reporting bugs, please include in the subject line both the
package name/version and the name of the program for which you found a problem.

For general documentation on the coding and usage standards this
distribution follows, see the GNU standards document at
prep.ai.mit.edu:pub/gnu/standards.*, especially the `Makefile
Conventions', `Configuration' and `User Interfaces' sections.

For general information on the ADE project, see the README files in
ftp.ninemoons.com/pub/ade/.

Mail suggestions and bug reports for these programs to
lhecking@nmrc.ucc.ie.