oO Newsgrab

This is a simple Perl script, provided to download binary multipart UUencoded
files from a NNTP server.

- Requires:

News::NNTPClient 0.36-1
News::Newsrc 1.07-3
Term::ReadKey

- Example:

I want to list all binary files in the group
'alt.binaries.sounds.mp3.bootlegs' from my newsserver 'nntp.news.com'. Do it
like so:

./newsgrab.pl -s nntp.news.com -g alt.binaries.sounds.mp3.bootlegs

Will return a list of available files, at the end of each line the will be a pair of brackets, indicating which state the file is in. 
The states are:

    C: The file is Complete, and all messages a available.
    I: The file is incomplete, one or more messages a missing for the
       UUdecoding to be performed correctly.
    R: The file has already been retrieved and marked in the newsrc as read,
       and therefor will not be downloaded again. (You, however have the
       possibility of ignoring this with an option (see --help)).

Lets say I want to download all files containing 'REM' in the subject, I'll do
somethig like:

./newsgrab.pl -r -s nntp.news.com -g alt.binaries.sound.mp3.bootlegs "*REM*"

(Note the '-r' option, meaning 'retrive').

And it starts downloading.

The files will be downloaded in you working directory, and unpacked there
as well.

- Notes:

-s can also be specied as the environment variable NEWSSERVER.

If no group is specified, a list of all available newsgroups will be the
result.

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

Contact: Jesper L. Nielsen <lyager@phunkbros.dk>

- Distributed under the GNU public license.
