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

A license is hereby granted to reproduce this software source code and
to create executable versions from this source code for personal,
non-commercial use.  The copyright notice included with the software
must be maintained in all copies produced.

THIS PROGRAM IS PROVIDED "AS IS". THE AUTHOR PROVIDES NO WARRANTIES
WHATSOEVER, EXPRESSED OR IMPLIED, INCLUDING WARRANTIES OF
MERCHANTABILITY, TITLE, OR FITNESS FOR ANY PARTICULAR PURPOSE.  THE
AUTHOR DOES NOT WARRANT THAT USE OF THIS PROGRAM DOES NOT INFRINGE THE
INTELLECTUAL PROPERTY RIGHTS OF ANY THIRD PARTY IN ANY COUNTRY.

Copyright (c) 1995, 1996, 1997, 1998 John Conover, All Rights Reserved.

Comments and/or bug reports should be addressed to:

    john@johncon.com (John Conover)

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

Htmlrel is a modification to the rel(1) program-the output file list
format has been altered to be compatible with Netscape's level 1
bookmark file syntax. It was designed to be used with the program
wget(1), (the wget(1) program is freely available from GNU/FSF by
anonymous ftp to ftp://prep.ai.mit.edu/pub/gnu/wget.tar.gz.) A typical
usage of the wget(1) program would be:

    wget -nc -r -l2 -H -x -t3 -T15 -P www -Ahtml,htm http://my.favorite.url

This would create a directory structure, www, on the local machine
containing all of the available html documents, (and the documents
linked to them, nested two deep,) starting with the specified URL.

The wget(1) program may be used to fetch http pages from a bookmark
file, (and the documents linked to them, nested two deep,) www.html,
also:

    wget -nc -r -l2 -H -x -t3 -T15 -P www -Ahtml,htm -i www.html

The program htmlrel can then be used to make a bookmark file of the
html documents, arranged in order of relevance to a specified
criteria:

    htmlrel criteria * > ../www.html

or, if only the 10 most relevant documents are desired:

    htmlrel -n 10 criteria * > ../www.html

The documents can be reviewed with Netscape, Mosaic, or Lynx, for
example:

    lynx www.html

john@johncon.com (John Conover)
Campbell, California, USA
January, 1998
