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

                 A M I G A     M O S A I C    H O T L I S T

                     AMHotlist, (c) 1994, Berend Ozceri

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

I. Legalities

  This program is provided as is, as a public domain program and no guarantees
are made by the author. As Dave Haynie quoted Jimmy Buffet in the A3000/A4000
hardware notes, "What works for me, might work for you." Use this program at
your own risk as I do not assume any responsibility for any physical/electrical
/mental/etc damage caused by this program.

  Feel free to distribute this program as much as you want but do not make any
profit from it! If you like it some much that you want to send me a donation,
feel free to do so! ;)

  Please report any bugs/problems to me. You can contact me at:
  
  E-Mail: bo24@andrew.cmu.edu

  Snail-Mail: Berend Ozceri
              Carnegie Mellon University
              Box 4930
              5115 Margaret Morrison
              Pittsburgh, PA 15213

  This program uses MUI. MUI is (c) 1993,1994 by Stefan Stuntz.


II. Introduction

  As you well know, the AMosaic development team has done a great job of
porting Mosaic to the Amiga, bringing an invaluable net resource to the Amiga
world. However, one of the shortcomings of the latest version of AMosaic
(version 1.2) is the support for hotlists (or lack thereof ;) ). Apparently the
developers tried to address this problem by putting in an ARexx script into the
distribution to create pseudo-hotlist support. However, I find the idea of
using a seperate HTML page as a hotlist a major kludge. So what did I do? I
performed a smaller kludge! I wrote an MUI program that can be invoked from
AMosaic (via ARexx) and will give you complete hotlist control.


III. Installation

  The installation is straightforward. Copy the executable AMHotlist to any
directory you want. Add the following lines to your ENVARC:Mosaic/Prefs:

RexxMacro1 Add to Hotlist | "ADDRESS COMMAND 'C:RUN <>NIL: MOSAIC:AMHotlist QUICKADD'"
RexxMacro2 Hotlist... | "ADDRESS COMMAND 'C:RUN <>NIL: MOSAIC:AMHotlist'"

(Make sure you replace MOSAIC:AMHotlist with wherever you decide to install the
 executable in your system. For example, if you install the AMHotlist program
 in your C: directory, replace the MOSAIC:AMHotlist in those lines with
 C:AMHotlist)

  Copy the .mosaic-hotlist-default file to your ENVARC: directory as follows:

    COPY .mosaic-hotlist-default ENVARC:Mosaic

  Copy the ENVARC:Mosaic directory to ENV:Mosaic as follows:

	  COPY ENVARC:Mosaic ENV:Mosaic

  You are set!

  (Note: The hotlist program requires you have a MUI, but since you are already
using AMosaic that step should already have been taken care of.)


IV. Usage

  Start AMosaic. Under the Rexx menu you should see two entries "Add to
Hotlist" and "Hotlist..." Select "Hotlist..." The hotlist window will open on
your default MUI screen (this is normal for any MUI program that does not have
any configuration saved). If you are running AMosaic on a screen other than the
default screen, close the hotlist window, start up MUIPrefs and set
AmigaMosaic-Hotlist's screen prefs so that it opens on that screen too. Then
reopen the window. If you copied a .mosaic-hotlist-default file to your
ENV:Mosaic directory, it should automatically have been loaded by now.

   i) Adding New Entries

     There are two ways to add new entries to the hotlist. The first way is by
   using the "Add" button in the hotlist window. If you click on "Add" a dialog
   window will come up preloaded with the information regarding the current
   page loaded into AMosaic. If you want to add that page as is, just click on
   "Done", and it will be added. If you want, you can do editing on the "Title"
   and "URL" fields before you click on "Done". If you decide not to add, just
   click on "Cancel"

     The other way to add an entry to the hotlist is by using the "Add to
   Hotlist" menu option. If you perform this menu selection, AMosaic's current
   page will be added to your hotlist without bringing up any sort of dialog
   window. NOTE: IF YOU HAVE THE HOTLIST WINDOW OPEN WHEN YOU SELECT "Add to
   Hotlist" THE LISTVIEW WILL NOT BE UPDATED. THIS IS NORMAL (A SHORTCOMING OF
   THE PROGRAM, I WROTE THIS IN ONE NIGHT, AND RUSHED IT OUT THE DOOR!). IN
   THIS CASE JUST CLOSE THE HOTLIST WINDOW AND REOPEN IT AND EVERYTHING WILL BE
   FINE.

     Note that everytime you add an item, AMHotlist will update the
   .mosaic-hotlist-default file in your ENVARC: and ENV: directories. 
     

   ii) Deleting Entries

     Deleting a hotlist entry is easy. Just select the hotlist entry from the
   listview and click on "Delete"


   iii) Editing Entries

     If you decide at any point to change anything about a hotlist entry that
   you already have, use the "Edit" button. Selecting a hotlist entry and
   clicking on "Edit" will bring up an editing dialog. Edit the entry as you
   wish and click on "Done" if you want the changes to take effect. If you want
   to scratch the changes, click on "Cancel"

     The editing window is asynchronous from the rest of the program so you can
   be double-clicking on entries to jump to while the edit window is open.


   iv) Jumping to Entries
 
     If you want to jump to an entry, just double click on it! Presto! You are
   there. You will realize that when you perform a jump, the hotlist window
   will be put to sleep until AMosaic confirms via ARexx that the jump has
   worked.