Grace JavaLog

Installation

Grace Software

JavaLog

$Revision: 1.6 $

$Date: 1999/11/18 13:35:21 $

Requirements

JDK 1.1 or 1.2 (1.0.2 - no way, 1.3 - not tested)
GNU Regular Expression library (JavaLog was tested against version 1.0.8)
Optional ANSI color terminal for color output; aterm is a good one; color has not been tested under DOS.
Optional gmake to build JavaLog using the make system.

Note: The GNU Regular Expression Library was bundled into the previous version (0.6) but now must be installed separately.

Installation

Installation is like most other Java packages. Unjar the downloaded file and set your classpath to include $install-dirlib/grace.jar. Don't unjar the grace.jar file. This will just create redundant .class files because the lib/grace.jar is simply a jar of all the files in the classes directory.

$ jar xvf grace-0.7.3.jar
12091 Sun Mar 07 20:56:02 GMT+04:30 1999 META-INF/MANIFEST.MF
67121 Sun Mar 07 20:38:54 GMT+04:30 1999 grace-0.7.3/classes.jar
0 Sun Mar 07 20:29:36 GMT+04:30 1999 grace-0.7.3/docs/
0 Sun Mar 07 19:49:18 GMT+04:30 1999 grace-0.7.3/docs/api/
...
$ export CLASSPATH=$CLASSPATH:$(pwd)/grace-0.7.3/classes.jar
$ java grace.log.Log
03/07/99 16:29:57(0.014):1: notice: system.main.Test-Thread.0: Log$Test.logSomeMessages:1187: Examples of trace()
03/07/99 16:29:57(0.066):2: trace: system.main.Test-Thread.0: Log$Test.logSomeMessages:1188
03/07/99 16:29:57(0.066):3: trace: system.main.Test-Thread.0: Log$Test.testFunction:1145
...

Thats it! If you're running Windoze then you're on your own. No offense, but if you're not running UNIX , you really ought to think about upgrading. It's easy. Just say "NO" to DOS.

Compiling (optional)

You don't need to compile any of the source code. Just set your class path as indicated above. However, if you want to change any of the code, you should compile the source code and then compile the javadoc API documentation.

To build the source, JavaLog uses a top level included makefile {install-dir}/makefile.master. This file is dependent on GNU make. It may or may not work under other make systems. Given you have GNU make, to build all the source, you should need only to set the JAVA_HOME environment variable and type make. Of course, you really don't need to use the make system, you can compile everything by hand but it's a little more tedious.

To build the Javadoc documentation, cd to {install-dir}/docs/api directory and type make. One thing to note here: this makefile is pretty fragile so don't be surprised if it doesn't work. If it doesn't work, you'll have to do the javadoc by hand.