Installation instructions are in the INSTALL file. Also see the EXPIRE
file for an explanation of the expiration mechanism.

(c) Jerome Laheurte 2002
This is free software, GPLed. If you don't know what it means, see
COPYING.

The homepage is
http://fraca7.free.fr/

***********************************************************************

@ What is NewsSrv

NewsSrv is a set of C++ programs dedicated to downloading binaries on
Usenet. All information regarding headers is stored in a MySQL
database, which allows someone to control the download process via a
PHP interface (a GTK+ client is also under development).

It's composed of four executables:

* NewsHeaders
   This one retrieves headers and updates the database accordingly.

* NewsSrv
   Downloads relevant articles.

* NewsDec
   Decodes downloaded articles.

* NewsRm
   Intended to be run from cron, deletes expired entries in the
   database.

For an explanation of the concepts used by NewsSrv, see the interface
documentation (which is integrated in the PHP interface).

*******************************************************************
* Common problems

@ The first time you launch NewsHeaders, it will be *very* CPU intensive!
Don't worry about that.

@ It seems that UUlib sometimes issues error messages like "xxx: File
I/O Error" when decoding, although the resulting file is fine. I don't
know why yet.

@ Sometimes, messages will be indicated as more than 100% done. This
can happen, but everything should be OK thereafter. Somme dummies just
keep posting the same files with exactly the same subject line.

@ If the queue becomes filled with 100% done messages, some decoding
error occured. Your only hope is the "nrescue" utility (not yet
tested!). You can build it by typing "make nrescue" in the NewsSrv
source directory. Then, give it the stringID of the post:

nrescue "Senjin Studios AMV - Repost - X - Brainscan [HQ] (05/18) [SS] - X - Brainscan OTT (HQ).r01"

This will create a file in your store directory, with extension .UU
(always the same file name, be careful!). You can try to decode this
yourself, using either uudeview in desperate mode or uudecode, or
anything.

I have encountered this situation on some UUencoded posts made with
"Power-Post 2000". I have found that most of the time, I could
correctly decode files with uudecode in spite of the "no end line"
error.

Hopefully, in a coming version, this will be fixed in uulib...

@ There seems to be a memory leak in NewsHeaders.

*
*******************************************************************