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 2.14
Time::ParseDate 100.010301

- Getting Started:

You can envoke newsgrab.pl on the command line, and you'll be asked for server
connection information. But what you probably want to do is to create a
.newsgrabrc file in your home directory. An example of a newsgrabrc file comes
with this distrobution and the format is as follows:

  SERVER <serverkey> <nntp hostname> [port] [username] [password]

so an entry like: 
  
  SERVER easynews news-01.easynews.com 119 myeasynewsusername mypassword

Would connect to news-01.easynews.com on port 119 with the username
'myeasynewsusername' and the password 'mypassword'.

The 'serverkey' is used to identify the server on the commmand line (-s
option). If no server is specified the first server in the newsgrabrc file
will be used.

When you've edited the newsgrabrc file place in you home directory, like:
~/.newsgrabrc

- 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 easynews -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 easynews -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:

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

---------------------------------------------------------- Internal Notes ---

Internal Newsgrab notes (devel-guys/girls only):

$arts{KEY}->{'date'}
          ->{'complete'}
          ->{'total'}
          ->{'type'}
          ->{'arts'}     ->{MULTIPART#}->{'subject'}
                         ->{'message_id'}

Legend:
    KEY: A concatenation of the subject line, unique for each multipart
	     message.
	date: Date of this message (for sorting).
	complete: State of the multipart message (look above).
	total: Number of total multipart messages for this post.
	MULTIPART#: The number of the multipart message.
	subject: The original subject of one article
	message_id: The MID of one article
    type: This can either be ART_UUENC or ART_YENC
-----------------------------------------------------------------------------

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

- Distributed under the GNU public license.

vim:tw=78
