PAVE 2.3 BETA RELEASE README

KNOWN ISSUE IN PAVE 2.3
-----------------------

When running without the bus, the Motif browser does not 
properly add new files to be analyzed.  We are unsure of
how to fix this.


CHANGES IN PAVE 2.3 
-------------------

In PAVE 2.2 a feature was added that causes PAVE to kill all
processes in the process group prior to exiting.  The idea
was to kill all _child_ processes such as time series plots.
However, on Linux, this command also seems to kill the parent
script that started PAVE, which is undesirable (and is different
from the behavior on Irix).  Therefore, version 2.3 only kills 
the processes in the process group when exiting if the environment 
variable KILL_PROCESS_GROUP is set to ON (which is the
default behavior set in the new pave23 script).  If you don't 
want this behavior, do

setenv KILL_PROCESS_GROUP OFF

before you run pave23.  


The pave23 script also responds to these new environment 
variables:

PAVE_DEBUG (should be ON or OFF, default is OFF) - when ON,
  this prints some debugging information about the various
  paths used when PAVE is executed.  Turn this ON if you
  are having problems executing PAVE.

LOCAL_FILES_ONLY (should be ON or OFF, default is OFF) -
  when ON, this causes PAVE to execute without using the
  software bus.  Therefore, you can run multiple instances
  of PAVE from the same user account.  A limitation is that
  when LOCAL_FILES_ONLY is on and you are running PAVE in 
  interactive mode, you cannot yet add new files to be analyzed 
  (although you can analyze files loaded in a previous session 
  that exist in your PAVE.AA.cases file).  This will be 
  fixed before PAVE 2.3 is released to the general public.


Another set of commands was added to PAVE 2.3 to control 
the features of the plot that are drawn:

-drawLegend OFF \
-drawMinMax OFF \
-drawTimeStamp OFF \
-drawTiles OFF \
-drawGridLabels OFF \

Acceptable values to follow the above are ON and OFF -
case shouldn't matter.  Another argument is provided as a 
short cut in case you only want to draw the legend:

-onlyDrawLegend ON[OFF] \

In case you were unaware of this feature from early
versions, if you don't want titles to appear, use the 
following arguments:
 -titleString "  " -subTitle1 "  " -subTitle2 "  " \
(be sure to include the spaces - if you use just "" it
doesn't work).

Another new argument is
-imageMagickArgs 'args' \

PAVE will pass the contents of 'args' on to the convert
program when it creates tile plots of various formats.
You may need to experiment with escaping quotes inside
of the args string when calling this from a script.

Note that the PNG export format was added in version 2.2.
You should be able to use this to add some metadata
to formats that support it.