Exploring JeeRev

As described on the daily weblog, JeeRev is a collection of "rigs" in the form of Tcl source files in the "kit/" folder. For development, it's very important to be able to find your way around in there.

Here is the structure of the "kit/" area:

kit/
  cmds/       rigs which can be launched from the command line
  lib/        Tcl packages loaded via "package require" are placed here
  main.tcl    startup code to init JeeRev and set up the rig mechanism
  rigs1/      rigs needed during startup: app, Jm, Ju, and Jx
  rigs2/      a number of reasonably stable rigs are placed here
  rigs3/      the majority of JeeRev's built-in rigs are in this area
  tm/         Tcl modules loaded via the Tcl "tm" mechanism
  wrapup.tcl  utility code to wrap up JeeRev into a "jeemon-rev" release

There are three command-line rigs (as of Nov 2011):

doc - generate some documentation summaries, directly from the rigs
env - display information about JeeMon, rigs, packages, and much more
tcl - a simple way to run some Tcl commands directly from the command-line

The doc rig can be used to find basic information about rigs and the public commands they define. Type "jeemon doc" to get a description of all the rigs, or "jeemon doc Webserver" to get info about the Webserver rig, for example.

The env rig displays information about the system and its environment. Type "jeemon env" for details on how to obtain various types of details. To get a full set of reports, type "jeemon env all".

The tcl rig can be convenient to quickly try out a bit of Tcl. For example, you could type "jeemon tcl 'expr 2 ** 100'" to calculate 2 to the power 100, or "jeemon tcl 'info ?'" to see what sort of arguments the "info" command expects.