.TH WHATSNEW 1 "28 Mar 94" "" "UTILITIES"
.SH NAME
whatsnew - generate lists of new stuff on our favorite archives
.SH SYNOPSIS
whatsnew [-c|m|l] [-s 
.IR sitealias
] [-u username]
.SH DESCRIPTION
.B whatsnew
generates lists of the new files on a given list of our favorite acrhives.
The new lists are compared with the lists from the last run giveing the
result of whatsnew as a list of differences between the files ie. the new
stuff.
.SH OPTIONS
.TP
.B \-c
catchup, get listings but do not show us new stuff
usefull if you have been away for along time, or if you manually looked
at the site
.TP
.B \-l
list results to stdout
.TP
.B \-m
mail results (default)
.TP
.B \-s
do for 
.IR sitealias 
only, 
.TP
.B \-u
mail to a user other than the user running whatsnew, usefull for posting to
local news groups etc.
.SS "Format of $HOME/.favsites"
$HOME/.favsites has 4 feilds wich are colon : separated.

1 is the full internet sitename

2 is the full path of the file/directory to get, comma separated for
  multiple files from the same site.
eg. micros.hensa.ac.uk:micros/atari/mint,micros/atari/tos/index:d,f:hensa
would get both a directory listing and a file but with only one connection.

3 is a "d" if field 2 is a directory, "r" if a recursive directory
listing is required and "f" for a file, comma separated for
  multiple files from the same site. See example above.

4 is the site alias name. 

All fields must be given
.SH NOTES
.B whatsnew
is written as a bourne shell script, it should run with mininal changes
under bash, ksh or zsh if you don't have the standard sh.

The r option in field 3 of .favsites should only be used when the remote
machine has a unix like ls ie it understands the -R parameter. Note that this
could produce very large files!
.SH FILES
.LP
~/.favsites list of sites to check
.LP
~/.archives copies of old results files DO NOT TOUCH
.SH "SEE ALSO"
.BR ftp (1)
.SH BUGS
The current version of
.B whatsnew
should be stable and self configuring but if you find anything which you
think may be a bug, undocumented feature, then please let me know.
For email bug reports please give subject line:
.I WhatsNew BUG REPORT
.SH DIAGNOSTICS
Exit status 1 if we have bad usage or a site alias could not be matched,
otherwise exit status is 0 and any error messages from ftp etc will 
appear in the listing (stdout or mail message)
.SH AUTHOR
.PD 0
Darren J Moffat 
.LP
<moffatd@dcs.glasgow.ac.uk>
.LP
20 Southpark Avenue
.LP
Glasgow
.LP
G12 8HZ

