Hi Göran.

Since I am a complete newbie to SqueakMap, perhaps my trials & tribulations
will be of some help to you.

Henceforth, some feedback on SqueakMap.  :-)

Using a nearly virgin 3.2 image (on Windows NT 4.0), I created a fresh
project, opened a workspace and I was able to successfully install SqueakMap
via Göran's do-it.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

ChangeSorter newChangesFromStream:
('http://anakin.bluefish.se:8000/gohu/uploads/11/squeakmap-021023RC1.cs.gz'
asUrl retrieveContents content unzipped readStream)
 named: 'squeakmap-021023RC1'

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*  During the installation, I OK'd the selection of the 2nd server (Daniel
has already explained that little tidbit).
*  During the installation, I OK'd the installation of the 'SM Package
Loader'.

The first thing I noticed (in my stock image) is that the 'SM Package
Loader' system window looks like an albino and it was hard to read (white
window w/ white borders, etc.), so I immediately changed its window color
into something pleasing to my eyes.  :-)

The next thing I noticed is that the stock Squeak image can't display
Göran's name properly.  Apparently we need to add 'ö' to the standard font
set.  With so many European Squeakers, I was rather surprised to see this.

OK.  So now I'm looking at this browser, which I have enlarged to fill my
screen.  It has 11 items in the list on the upper left.  The box on the
upper right seems to be display-only, as none of my 3 mouse buttons do
anything there.  So what do I do now?

I clicked on one of the items in the list: Shared Streams (->1.0).  In the
large pane at the bottom, I see lots of information that is all sorta
jumbled together; it makes my eyes tired (OK, I was already tired, but...).
Perhaps a bit of fun with fonts & colors could clear this pane up a bit.
Looking over the details, I see two URLs (Homepage & Download).  Wouldn't it
be nice if these were a different color and/or underlined, as they are in
all of my web browsers?

Perhaps there should be a line above the word 'Description:' to separate
this important bit of information.  Well, I think you get the idea, so I
won't belabor the point any further.

OK, so I'm back to wondering what the heck I can do with this tool.  I tried
right mouse clicking over the description pane and didn't even get an edit
menu, though I *can* type in that window.  Hmm.  What does that mean?

Right mouse clicking in the upper left pane yields more satisfying fruit.
In the menu that pops up, I see help so I immediately chose it.  This opens
up another menu with a large heading (the help text) and a single selection
(OK).  This reminds me of the many UI items that are missing in Squeak,
namely a general help mechanism (like Windows and other OSs have), dialogs
that support such basic uses as OK, Cancel, ...  There are many such simple
tools that are missing in Squeak.  I simply must put this on my list of
items I'm willing to pay for.

* There is a spelling error in the 'help' text (pacakges).

Moving back to the popup, I now see that if I let my mouse hover for a bit,
I get some balloon help.  This is nice.

I see the option for setting the download directory and I wonder what will
be downloaded.  Because I'm insatiably curious, I opened up a Windows
Explorer and looked at my Squeak directory.  Curious.  A subdirectory called
'sm' was created, presumably by me when I installed this tool.  In that
directory, I see two files squeakmap.1.log and squeakmap.2.log.  These files
are odd.  The first file only contains the following:

'24 October 2002' asDate!

That seems like a bug to me.  The second file also starts out with that
line, but it is followed by a 17 pages (using MS Word) of data that looks
like this:

(self newCategoryWithId: '82f328ab-175d-40b4-a363-bc0287dabd77')
	created: 3206703836
	updated:3206703836
	name: 'Development tools'
	summary: 'Add-on development tools for Squeak.'
	url: ''
	mandatory: false
	parentId: nil!

This seems, to me, to be some sort of temporary data file.  I can only
presume that it was downloaded from http://anakin.bluefish.se or perhaps it
was created when the 'SM Package Loader' was installed?  I don't know.
Maybe it is the result of my request to 'update map from the net'?

Getting back to the download directory, I change mine to the new 'sm'
directory, because I don't know what will happen when I start downloading
and I really don't want to mess up my squeak directory (I use it with other,
less virginal images, after all).

OK.  Before I start downloading, I'm going to look at the other menu
options.  I've figured out what the four last options are -- the balloons
helped me with this part, though I would prefer to see the word 'display' in
the menu before each of these items.

*  How come some of the packages don't have information in the upper right
pane?

Fine.  Now I'm ready to try this puppy out.  I chose 'Win32 Native Fonts
(1.0)' and selected 'install'.  Well, whatever it did, it was fast.  The
item has disappeared from the list.  I think some bio-feedback would be good
here.

OK, I searched my disk and found the Win32NativeFonts.zip file is now in my
'sm' directory.  Opening the archive, I see many files inside.  I can only
presume that the 'SM Package Loader' downloaded the archive, but then didn't
know how to 'install' it.  Is this a bug???  Should the 'SM Package Loader'
have tried to file in the contents of the archive?

OK.  'SM Package Loader' seems to be working pretty well so far, so now I'm
going to download the 'SqueakMap Browser'.  This time, the
squeakmapbrowser-021023.cs.gz file was downloaded and the
squeakmapbrowser-021023.cs changeset was extracted and apparently it was
filed-in too, because I can see it in a ChangeSet browser.  Unfortunately,
the changeset doesn't provide any information on this tool, so I'll have to
look it up in a Browser.

The SMSqueakMapBrowser has a class comment (Hurrah!).  In the comment I
find: "SMSqueakMapBrowser open", which is great, but don't you think it
should be a URL?  Maybe I'm getting too used to point & click technology.
:-)

* As was noted by others, right-mouse-clicking in the 2 empty panes in the
SMSqueakMapBrowser reaps a walkback.

* I clicked on Entertainment>>Games>>Classic and then clicked the 'install'
button -- this resulted in a walkback.

* I clicked on Class Libraries>>Refactoring Browser and then clicked
'install' -- this brought my computer to a virtual standstill.  After a
while, I saw a progress meter.  Finally, I got a satisfactory message (an OK
'menu').  

* One thing that is missing from SqueakMap is a 'ReadMe' after something
gets loaded.  In the case of the Refactory Browser, I expected a window to
pop up and give me some basic instructions on what to do next.  Perhaps this
could be improved upon.

After poking around in a Browser, I found the RefactoringBrowser class.
There was no comment (!!!), but there was a class method that I ran
(RefactoringBrowser openBrowser) which resulted in a RefactoringBrowser --
it looks curiously like a regular Browser; I had expected it to at least
have its own color.

The oil has been spent and I've got to go get some dinner now (its 8:40p and
I've long since passed the hunger stage).

Thanks for the nice tools Göran & Daniel!  I hope this e-mail will help you
with your feature.

Cheers,

---==> Chris