Jigsaw on Macintosh

Anselm,

I have been working with Henrik alpha testing the www-lib for some time now and
just pulled my head out of the sand and downloaded the Jigsaw source yesterday.

I must say, it is absolutely wonderful! No need for GUSI socket libraries, SIOUX
libs and all that C/C++ gobbledy-gook that made running the mini-server a pain.
Wow, what a neat concept!

I have a long way to go yet, since I have *no* Java experience whatsoever, but
because of this, I though my experience getting Jigsaw up and running would be
helpful. Also, because I am doing this on a Mac (and I have seen several
messages
from Mac users having problems getting Jigsaw to run), I though my feedback may
be helpful.

First though, a couple of minor problems that I did encounter. Both of
these were
mentioned in previous messages, but I thought I should mention them once again
since they were the *only* problems I encountered, getting Jigsaw running on
macintosh.


* Since mac file names are limited to 31 characters, some of the URLs in the
documentation do not resolve, because they were originally longer and were
truncated when the archive was unpacked. For example:
w3c.jigsaw.resources.HTTPResource.html is one.

* Second, Apple claims that in future versions of their OS, file names begining
with a '.' will not be allowed. This will cause problems with the .jigidx index
files on future macs.


Running Jigsaw on the Mac platform.

Here is my experience under Metrowerks CW-9 (I'm sorry I've not had time yet to
build it under MacJDK but I would not think this to be a problem.) Also, there
are possibly easier ways to do this using ToolServer and the MakeFile directly,
but I did not take the time and instead added all of the necessary source files
to the project manually.

In Metrowerks CW-9:

#1) Create a new Java Project in the root Jigsaw directory.

#2) In the Metrowerks Java Project Preferences specify the project type as
'Runable ZIP File'. Specify the file name as 'Jigsaw.out'. Specify the main
class as 'w3c.jigsaw.http.httpd'. Leave everything else default.

#3) Using the 'Add Files' to project dialog, add all of the files described in
the MakeFile found in the directory /src/classes/w3c/

That is, there are 22 different directories specified in the MakeFile. Just
click
the 'Add All' button to add all of the files in each directory. I added each
directory as a different named group, for the sake of learning the library but
again this is probably not necessary if your future sanity is not an issue.

#4) Next, select 'Make' and go get a cup of coffee. It took a while here! When
you get back you will have a file named 'Jigsaw.out' in the same directory
as the
project. The last and very important step is to move this file into the
subfolder
named 'Jigsaw' so it can find the 'config' folder etc.

#5) Finally double-click the 'Jigsaw.out' file to execute and you should see
something similar to:

Executing: javai -working /Apple%202110/Dev/Jigsaw/Jigsaw -classpath
./Jigsaw.out w3c.jigsaw.http.httpd
loading properties from: ./config/httpd.props
[httpd]: listening at:http://cc46.ccia.com:9999
Completed(0)

#6) Copy the URL i.e., http://cc46.ccia.com:9999 or whatever it says on your
machine and paste it into your favorite browser and your on your way.
Hope this helps out.

Great job Anselm and other folks at w3c. Keep up the good work!! sinc, -jeff

Received on Wednesday, 26 June 1996 14:09:50 UTC