David Barr <barr@math.psu.edu>

Before compiling INN, please read the FAQ found in this directory.
This was a current version as of when the release was made.  Read
it to find out how to get a current one.  If you can't find the
answer to your problem in the current FAQ (not the one that's included
here), it's probably in the INN documentation (man pages, or Install.ms).
Definately do NOT try to start compiling INN before you read the
entire FAQ as well as the any other platform-specific notes found in
this directory.

Installation is almost the same as previous INN releases.  One change
has been made to rc.news such that it must be invoked as the "news"
user, not root.  The "inndstart" program must be made setuid root after
the "make install".  The rc.news script relies on it for it to be able
to start innd.  See the comment at the top of samples/rc.news for how
to invoke rc.news from your system startup scripts.

If you get an error with subst: "unknown parameter or bad line:"
with PATH_AUTHDIR and/or PATH_NNRPSUBS, you need to add a that keyword
to your config.data.  See config.dist.

If you are upgrading from a previous INN release, it should be just a
matter of adding the above keywords to your current config.data
(if you haven't done so previously), copying it into the config
directory of this distribution and typing 'make update'.

Note to people doing a 'make update'.  You'll need to manually copy
the following scripts to their respective locations after a 'make update':

	site/checkgroups
	site/nntpsend
	site/parsecontrol       (from inn1.4unoff1 or earlier)
	site/rc.news            (from inn1.4unoff1 or earlier)
	site/innlog.awk         (from inn1.4unoff1 or earlier)
	site/tally.unwanted     (from inn1.4unoff1 or earlier)

If you're upgrading from INN1.4unoff3 or earlier and you use 'nntpsend',
be sure to kill off all running feeds while upgrading.  nntpsend has
been changed to name its current batchfiles according to the site
name in the nntpsend.ctl as opposed to the host name.  This allows multiple
innxmits to be running per host.  You may need to rename your .nntp
files after the upgrade.

Sample config.data's for various platforms can be found here.  Some
additional ones can also be found in faq-inn-9.  Please submit
more config.data's to hwr@pilhuhn.de, not to me!  (see explanation
of what to send in faq-inn-9.)

I have included a random sampling of the more oft-used contributed
software in this directory.  The complete collection of software
can be found at ftp.math.psu.edu:/pub/INN/contrib/.  See also
my WWW page about this release and INN in general at
http://www.math.psu.edu/barr/INN.html .
