*** INSTALLING ***

Set BINDIR in the Makefile to where you keep your binaries and MANDIR
to where you keep your man pages (in their source form).  (If you're
using RosettaMan with TkMan, BINDIR needs to be a component of your
bin PATH.)  After properly editing the Makefile, type `make install'.
Thereafter (perhaps after a `rehash') type `rman' to invoke RosettaMan.
RosettaMan requires an ANSI C compiler.  To compile on a Macintosh
under MPW, use Makefile.mac.

If you send me bug reports and/or suggestions for new features,
include the version of RosettaMan (available by typing `rman -v').
RosettaMan doesn't parse every aspect of every man page perfectly, but
if it blows up spectacularly where it doesn't seem like it should, you
can send me the man page (or a representative man page if it blows up
on a class of man pages) in BOTH: (1) [tn]roff source form, from
.../man/manX and (2) formatted form (as formatted by `nroff -man'),
uuencoded to preserve the control characters, from .../man/catX.

The home location for RosettaMan is ftp.cs.berkeley.edu:
/ucb/people/phelps/tcltk/rman.tar.Z (this is a softlink to the latest,
numbered version).  If you discover a bug and you obtained RosettaMan
at some other site, first grab it from this one to see if the problem
has been fixed.

Be sure to look in the contrib directory for WWW server interfaces,
a batch converter, and a wrapper for SCO.

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

*** NOTES ON CURRENT VERSION ***

Help!  I'm looking for people to help with the following projects.
(1) Better RTF output format.  The current one works, but could be
made better.  (2) Roff macros that produce text that is easily
parsable.  RosettaMan handles a great variety, but some things, like
H-P's tables, are intractable.  If you write an output format or
otherwise improve RosettaMan, please send in your code so that I may
share the wealth in future releases.

This version can try to identify tables (turn this on with the -T
switch) by looking for lines with a large amount of interword spacing,
reasoning that this is space between columns of a table.  This
heuristic doesn't always work and sometimes misidentifies ordinary
text as tables.  In general I think it is impossible to perfectly
identify tables from nroff formatted text.  However, I do think the
heuristics can be tuned, so if you have a collection of manual pages
with unrecognized tables, send me the lot, in formatted form (i.e.,
after formatting with nroff -man), and uuencode them to preserve the
control characters.  Better, if you can think of heuristics that
distinguish tables from ordinary text, I'd like to hear them.
