[Date Prev][Date Next][Thread Prev][Thread Next][Author Index][Date Index][Thread Index]

macOS instructions

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

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)

__-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, 

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.


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  

- 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 

- 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 $";