		newscan - a Perl Network News scanner
			  by John F. McGowan, Ph.D.
		    jfm@jupiter.slac.stanford.edu

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

COPYRIGHT NOTICE:

	This note is Copyright (C) 1993, 1994, 1995 by John F. McGowan.
Permission to reproduce and distribute is granted however.  
Additional information may be appended after the END OF ORIGINAL README
line.


Description:

	newscan is an attempt to solve the information overload
problem in the Network News groups by scanning news groups for
articles that contain matches to regular expressions.  newscan can
also exclude articles in news groups that contain matches to regular
expressions.

	newscan is written in Larry Wall's Perl (Practical Extraction and
Report Language).  Perl is described in Programming Perl by Larry Wall and
Randal L. Schwartz.  It is available for virtually all Unix systems.  Perl
is free but copyrighted by Larry Wall.

	newscan contains Perl comments, a short help message generated by
entering % newscan -h, and an embedded manpage following the convention
described in Programming Perl.

	The newscan distribution also contains xnewscan.  xnewscan is
a Tcl/Tk script that provides a graphical user interface for running 
newscan.  xnewscan should run on any machine supporting the wish 
windowing shell.

AUTHOR:
-------

	newscan's author is John McGowan who can be reached at either
jfm@jupiter.slac.stanford.edu or jfm@rahul.net.  Please send comments and
bug reports to the author.


SYSTEMS:
---------
Should work on Unix systems.


DEPENDENCIES:
--------------
Needs Perl to run.
xnewscan needs Tcl/Tk and wish (Windowing Shell) to run.

PACKING LIST:
---------------
README                   - this README file
INSTALL                  - Installation instructions for newscan
newscan                  - Perl shell script
Makefile                 - Makefile for building Perl script
xnewscan                 - Tcl/Tk script for graphical interface
newscan.man              - standalone nroff newscan manpage (for Linux)
newscan.man.ascii        - ascii output from running nroff on newscan.man 
                           (for Linux )
newscan.ftp              - retrieving newscan by anonymous ftp HOW TO
test_net                 - short Perl script to test connection to 
                           NNTP (News) Server
cdrom.cfg                - a sample configuration file
pex.cfg                  - a sample configuration file
extest.cfg	         - a sample configuration file 
                           with wildcard * expansion
windows.cfg              - a sample configuration file
ppc.cfg                  - a sample configuration file
require.cfg              - a sample configuration file 
                           illustrates use of REQUIRE and WORD keywords
home.cfg                 - sample configuration file
                           illustrates use of leading ~ in filespec
vanity.cfg               - sample configuration file
                           illustrates use of leading ~ in filespec
distrib.txt              - how and where to post newscan to Net
alert.uu                 - uuencoded sound file used by xnewscan

STANDARD DISCLAIMER:

	newscan is distributed AS IS.  There is NO WARRANTY express or
implied that it will work correctly, do what you want, or anything else.
Use at your own risk.


------------------------>END OF ORIGINAL README<-----------------------
