Hotlist, by Paul Roberts <sakar@ukonline.co.uk>

This is a hotlist manager. The basic idea is that you use the
executable `hotlist' to perform various functions on a bookmark file,
which is stored in HTML. The name of this file is set in the source or
taken from a envoirnment variable defined in the source if it exists
(look in `filenames.h').

Hint: Set that bookmark file as your homepage on Netscape or whatever
browser you use, and you'll see it everytime you load the thing.

The reason that this program exists is because I wanted somewhere
to jot down URLs that I want to visit, and then be able to remove them
easily later, once I have visited them. Its a very simple task, and
would undoubtedly have been better done with a script, but I used it
as a learning excersise.

INSTALLATION:

Easy, just untar the sources, change the definitions in `filenames.h'
if you want, then type make and copy the `hotlist' executable to
wherever you want it. Easy.

USAGE:

Once installed, you should probably set the envoirnment variable
$HOTLISTFILE to the path of the file you want to use, if you haven't
hardcoded the name of the file into the source.

Once this is done, you must initiate this file, which involves putting
in the required HTML headers etc:

	hotlist i

This will create the file. To add a URL, type:

	hotlist a <url>

and it will be added. Finally, to delete it:

	hotlist d <number to delete>

Well, really, thats all there is to it!

NOTES:

At the moment, although this software does work, it is still under
development, so its functionalitiy is somewhat limited, and little
error checking is done. It will not check to see if you try to delete
an non existing URL, and most I/O errors cause core dumps. Still, if
you really can't handle it, the source is there! I will try fix these
things as I go along, so check the website
(http://web.ukonline.co.uk/sakar/) or email me to see what is going
on.

And finally, NO WARRANTY is given with this software, implied or
otherwise. You are free to use it and the source as you wish, but
whatever happens, IT'S NOT MY FAULT! Nobody forced you to use it...

HISTORY:

0.0.1 Basic functionality: add and delete of bookmarks made as
separate functions, no user interface as of yet.

0.0.2 Hotlist filename now taken from envoirnment variable

0.0.9 Add user interface, version command, first usable version!

0.1.0 It now complains if you try to delete a URL that doesn't exist.

TODO:

Trap more errors. At the moment you can do pretty much anything you
want, and the program won't complain, just not work!

Make the program complain if the URL file is corrupted.

I want to add a list URLs functions too.