macOS instructions

[inSECT22 <i22@xxxxxxx>]

hi,
this is a brief guide to setting up zz on the mac, please let me know if
there are any problems/omissions/etc. . otherwise, it could be useful in
the documentation folder.

 
__-you are here

this file is a brief instruction to get zigzag compiled and running on
the macintosh using MacOS 8 or 9 (the MacOSX file will be much shorter,
since most of the work will be delegated to that handy utility 'make'),
in the meantime...

__-required software

to get the current version of the source code you will need a cvs
client. MacCVS Pro works well, and is downloadable from
http://www.maccvs.org/ (there are others clients available but i haven't
used them).

most of the current development seems to be focusing on the java
version, so MRJ should be installed
http://developer.apple.com/java/text/download.html

to compile the code i use javac, part of the MRJ SDK avaliable at the
above url. all the following instructions assume javac, but it should
also be possible to compile using MacJikes (send me a config script if
you manage it please)
http://www.stg.com/employees/sbytnar/projects/MacJikes/


__-get the code

set up a new cvs session, and configure the session settings

Server Hostname: cvs.gzigzag.sourforge.net
CVS root: /cvsroot/gzigzag
Username: anonymous

you should then be able to connect, and check out module "gzigzag". 

you will also need the JFC/swing libraries for MacOS from sun, 
http://java.sun.com/products/jfc/download.html

there are several extension modules for zigzag, each of which requires
external libraries, if you want to compile these, see the readme in the
relevant module's folder.


__-compile

note: this is a quick-and-dirty(tm) method, but seems to be the easiest
to get everything to (re)compile.

- make new folders inside "gzigzag:Java:" so you will have the path  
  "gzigzag:Java:fi:iki:luka".

- copy every .java file in the gzigzag:Java directory, and the 
  subdirectories into gzigzag:Java:fi:iki:luka.

- drag ALL the files in this directory onto javac.
  (you might need to crank up the memory allocated to javac)
  
- add "gzigzag:Java:" to the classpath, and set the destination to 
  "gzigzag:Java".

- click the "do javac" button, sit back and relax


__-make it go 

to get zigzag running, you will need to build a runtime wrapper using
jBindery. required settings are as follows

  class name: foo.Main (this may change, im told!)
  optional parameters: <name of cell folder>
  redirect stdout to file (helps tracking problmes)
  classpath: add gzigzag:Java:

this should produce an application that will double click into the
n-dimensional cellular structures of zigzag. 


__-read the docs
  
there is more information in the "gzigzag:Documentation" folder, however
most of it is .tex format which to my knowledge is not particularly well
supported on the mac. if you cant read them on a unix machine somewhere,
you may require a reader, or translator for the mac (eg. OzTtH which
will convert to .html) to make sense of them. 
http://www.xanadu.net/zigzag/ might provide more answers.



__-version info

last compiled "$Id: Main.java,v 1.19 2000/05/25 15:05:15 tjl Exp $";
this file  "$Id: mac_HOWTO.txt,v 0.1 2000/06/02 02:33:01 i22 Exp $";