WebGet V0.12
=============

******************************************************************
* WebGet 0.12                                                   *
*                                                                *
* Due to people bulk distributing buggy versions of my software, *
* clearly flagged as betas without so much as a word to me, this *
* version MAY NOT BE DISTRIBUTED, other than from my website.    *
*                                                                *
* If you got this version from anywhere other than the           *
* webpage at <http://www.ping.demon.co.uk/acorn/download.html>   *
* delete it now and fetch the latest version from there.         *
*                                                                *
* If for whatever reason you need a version of WebGet to         *
* distribute to other people, contact me via email at            *
* webget@ping.demon.co.uk, and I'll try to sort out a non-beta   *
* release.                                                       *
*                                                                *
******************************************************************

+++++++++++++++++++++++++++++++++++++++++++++++++
+ WebGet is 'giftware'. Please read the licence +
+ at the bottom of this file.                   +
+++++++++++++++++++++++++++++++++++++++++++++++++



Installation
============

Basically, copy !WebGet out of the archive, load !WebGet.Choices into a
text editor and alter at least the proxy details, if required.


Adding URLs to the fetch queue
==============================

This can be done by either selecting 'Add URL' from WebGet's iconbar
menu, or ticking 'Capture URLs' and then clicking on URLs in other
applications (eg. mail/news readers, hotlist programs, etc).

The Capture URLs facility will only reliably work when there isn't
a web browser loaded!


Fetching pages
==============

Go online, run !WebGet and then select the appropriate fetch from the
'Start Fetch' submenu of the iconbar menu.

Click select on the iconbar to open the status window.

The pages will be fetched, and then rewritten so that all the links
work in the local copies of the pages. Once this is complete, the
log file will be automatically run.

The 'Stop Fetch' menu item may be used to gracefully stop a download -
webget will not start to download any more pages, and will enter the
rewrite phase once all the in progress pages have finished.

'Abort fetch' will immediately stop a download, and will also stop
the pages being rewritten.

'Configure...' is greyed out, because it hasn't been implemented yet!


Reporting Bugs
==============

If you find a bug in webget, please send an email to
webget@ping.demon.co.uk, including the following information:

* Version of webget in use
* URL(s) being fetched (if appropriate)
* Copies of fetch, log and choices files, as appropriate.
* Risc OS and Internet stack version


Future Enhancements
===================

Requests for enhancements are welcome via email to webget@ping.demon.co.uk.

The following is a brief list of the enhancements (in no particular order)
I plan to make when I find the time:

* Configuration window
* Better format for sites directory
* Restarting and freshening of fetches
* End of fetch summary (number of errors, speed, etc)
* Multiple log files
* Better animation icon whilst downloading
* More information in progress window (eg. %age fetched, when available)
* A stronghelp manual
* Release of source
* Ability to remove URLs from the fetch files once they've been fetched
* Ability to limit fetches to certain filetypes, or exclude certain
  file types.
* Rewrite unfetched URL's to webget:http://www.wherever/, then set things
  so when the link is traversed, webget will offer to fetch the url.
  NB. need to think about inline images and things?
* Rewrite to relative rather than absolute urls.
* When deciding what to fetch next, favour urls with lower link depths?
* Allow URLs (and URI's?) to be dragged to add url dialogue / iconbar
* Hide some of the more esoteric options in the add url dialogue
  inside an 'Advanced' box or something?
* Improve the searching speed of the internal URL database
* Add an 'abort fetch but do rewrite option'
* Support for 'norobots.txt'?
* Add way to abort fetch of a url to status win.
* Add size & %age to url's in status win.

Credits
=======

Thanks to the following for beta testing:

* Andrew Ingram
* Alisdair McDiarmid
* Tony Houghton

Thanks to everyone who has emailed me suggestions and bug reports,
or just emails saying 'Wow!' - I'm afraid there's too many of
you to list everyone here!

Stewart Brodie, for the multitasking dns libary that WebGet uses to
resolve hostnames into ip addresses.

Thanks also go to Richard Atterer, the author of the excellent raFS
program that WebGet uses to store all its downloaded web pages.
raFS is available from <http://home.augsburg.baynet.de/richard.atterer/>.

A special "thankyou!" goes to Samuel Penn, who was the first person
I received the 'gift' from!

Licence
=======

WebGet is distributed as 'giftware'. This is similar to freeware, but
you are encouraged (rather that obliged, as with shareware) to send the
author approximately 5ukp if you think it's worth it. See the section
at the end of this file for contact details.

Your money will encourage the future development and support of this
and other freeware/giftware RiscOS applications.
(and, of course, if you send a feature request accompanied by some
money, you may find I'm more likely to implement it ;-) )

[If sending UK currency isn't easy for you, feel free to send me
something 'interesting' from the country you're in. And, no, I don't
exactly know what I mean by that either!]

Contact details
===============

New versions of WebGet will appear on:

http://www.ping.demon.co.uk/acorn/download.html


All email about WebGet should be addressed to:

webget@ping.demon.co.uk


To contact me via snail-mail:

Joseph Heenan
25 Attoxhall Road
Wyken
Coventry
CV2 5AH


-- 
Joseph Heenan
webget@ping.demon.co.uk
