Index: /trunk/Ohana/src/opihi/cmd.astro/help/biassub
===================================================================
--- /trunk/Ohana/src/opihi/cmd.astro/help/biassub	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.astro/help/biassub	(revision 4688)
@@ -0,0 +1,9 @@
+
+  biassub buffer sx sy nx ny dir [-v N V]
+
+  Apply a bias correction.  The region defines a vector 
+  (median is taken perpendicular to the dir direction) which 
+  is subtracted from the image.
+
+
+
Index: /trunk/Ohana/src/opihi/cmd.astro/help/cgrid
===================================================================
--- /trunk/Ohana/src/opihi/cmd.astro/help/cgrid	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.astro/help/cgrid	(revision 4688)
@@ -0,0 +1,6 @@
+
+  cgrid
+
+  draws a grid in RA and DEC on window 0 approriate for the current
+  region.
+
Index: /trunk/Ohana/src/opihi/cmd.astro/help/coords
===================================================================
--- /trunk/Ohana/src/opihi/cmd.astro/help/coords	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.astro/help/coords	(revision 4688)
@@ -0,0 +1,19 @@
+
+  coords <buffer> (filename)
+
+  "coords" loads astrometric parameters for the given buffer from the
+header of the named file.  The parameters are applied to the buffer,
+and will register in the Ki'i window if the buffer it tv'ed again.
+This is particularly convenient for intercomparing coordinate system
+or in the event the astrometry is stored in a different file (eg, a
+stripped off header).  Currently, the only format of coordinate
+information that is looked for are gene's linear transformation: RA_O,
+RA_X, RA_Y, DEC_O, DEC_X, DEC_Y such that the RA,DEC of an object is
+given by:
+
+RA  = RA_O  + x*RA_X  + y*RA_Y
+DEC = DEC_O + x*DEC_X + y*DEC_Y.
+
+
+  See also: rd, tv
+
Index: /trunk/Ohana/src/opihi/cmd.astro/help/flux
===================================================================
--- /trunk/Ohana/src/opihi/cmd.astro/help/flux	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.astro/help/flux	(revision 4688)
@@ -0,0 +1,7 @@
+
+   flux buffer (file)
+
+   calculate the flux enclosed by the contour given in the file.  The
+   file contains the coordinates of the polygon corners.
+
+
Index: /trunk/Ohana/src/opihi/cmd.astro/help/gauss
===================================================================
--- /trunk/Ohana/src/opihi/cmd.astro/help/gauss	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.astro/help/gauss	(revision 4688)
@@ -0,0 +1,15 @@
+
+   gauss Npix [Nspots] [-border N] [-sat cnts]
+
+   calculate statistics on stars, assuming a Gaussian profile.  The
+   user types a key on a star in the Kii window, and the resulting
+   information is printed on the screen.  This is really aperture
+   photometry.  Npix defines the aperture width (square aperture), the
+   optional -border defines the number of pixels in an annulus used to
+   find the background, -sat defines the value of a saturated pixel.
+   If the Nspots option is given, exactly Nspots stars are chosen.
+   Otherwise, the user may type on stars until the 'q' is typed.  The
+   results of the last star are stored the a set of Mana variables.
+
+   See also: star, cursor
+
Index: /trunk/Ohana/src/opihi/cmd.astro/help/profile
===================================================================
--- /trunk/Ohana/src/opihi/cmd.astro/help/profile	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.astro/help/profile	(revision 4688)
@@ -0,0 +1,6 @@
+
+   profile <buffer> <X vector> <Y vector> x y N
+
+   Find the radial profile of an image at the location x, y.  the
+   radius is placed in the X vector and the pixel value is placed in
+   the Y vector.   
Index: /trunk/Ohana/src/opihi/cmd.astro/help/region
===================================================================
--- /trunk/Ohana/src/opihi/cmd.astro/help/region	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.astro/help/region	(revision 4688)
@@ -0,0 +1,11 @@
+
+  region RA DEC Radius [projection]
+
+  define the current sky region and optionally the projection.  
+  RA, DEC and Radius are all values in decimal degrees.  The possible 
+  values for "projection" are:
+
+  TAN - a tangent plane projection (default, and typical for optical images)
+  SIN - a sine plane projection (more appropriate for polar regions)
+  AIT - aitoff projection (good for the full sky)
+  GLS - ?? (also good for the full sky)
Index: /trunk/Ohana/src/opihi/cmd.data/help/Graphics
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/Graphics	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/Graphics	(revision 4688)
@@ -0,0 +1,20 @@
+
+  Kapa, the graphics window.
+
+  Kapa is the program which Status uses to display plots on an X
+terminal.  There are actually 5 graphics windows available to Status,
+though several functions write to specific windows by default.  All
+plots of sky coordinates are displayed on window 0, while 
+functions which plot other types of data use window 1.  Most functions
+have an option -n which allows the user to specify which Kapa window.
+If it is not specified, the last window used will receive the action.
+
+  Below are the available Resources.  
+
+  kii*Foreground:			white
+  kii*Background:			maroon
+  kii*geometry:				540x540+10+10
+
+  See Also: box, clear, limits, plot
+
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/Kii
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/Kii	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/Kii	(revision 4688)
@@ -0,0 +1,57 @@
+
+
+  Kii (= "picture" in Hawaiian) is the program which Mana uses to
+display images on an X terminal.  The window consists of a main region
+where the image is displayed, a small "zoom box" where a magnified
+view of the region around the cursor is shown, a colorbar showing the
+current color map across the top of the window, a status box where the
+coordinates and pixel values are displayed, and several buttons.
+Clicking with the mounse in the different regions produces different
+effects.
+
+  Image Window:  Clicking with the left mouse button (mouse-1)
+recenters the image at the specified location.  Clicking with the
+right button (mouse-3) also recenters, but increases the zoom factor
+by one.  Clicking with the middle button centers and decreases the
+zoom factor.  
+
+  Colorbar: Clicking and draging with the left button (mouse-1) alters
+the color mapping.  Moving left-to-right slides the center of the
+color scale with the mouse.  Moving up-and-down squeezes or expands
+the color scale.  The middle button resets the color mapping.
+Clicking and dragging side-to-side with the right button expands or
+squeezes the color mapping.  **Note: the dynamic colormap cannot be
+used with a 24 or 32 bit visual.  The standard Linux XFree86 server
+does not support 8 bit visuals in 24 or 32 bit/pixel mode.  In this
+case, the Kii window must resort to a static colormap with the
+colorbar disabled.  In Linux, it is possible to run startx with the
+following command-line options to force the 8 bit/pixel mode:
+# startx -- -bpp 8 
+This assumes that you have an 8bpp Display mode set in the XF86Config
+file.  If not, you can just duplicate the 24 or 32 bpp Display modes
+which will enable this option.
+
+  Buttons:
+    PS: this button creates a PostScript version of the image.
+    Grey: this button makes the colormap a greyscale.
+    Rainbow: this button makes the colormap a rainbow.
+    Puns: this button make the colormap a blue and yellow mapping.
+    Recenter: this button recenters the image and resets the zoom.
+
+  Kii also recognizes several X Resource values:
+
+  Below are the available Resources (with Gene's default values).  Unlike
+most standard X programs, the geometry resource specifies the size of
+the Image Window, not the borders of the entire window.  Valid values
+for the colormap are: greyscale, grayscale (photonegative), -greyscale,
+-grayscale (photopositive), Puns, GoBears (buff 'n blue colormap),
+Rainbow (a rainbow map).  
+
+  kii*Foreground:			white
+  kii*Background:			maroon
+  kii*Colormap:				greyscale
+  kii*geometry:				540x540+10+10
+  
+
+  See Also: tv, cursor
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/Math
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/Math	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/Math	(revision 4688)
@@ -0,0 +1,58 @@
+
+  Opihi shell math operations:
+
+  Mana will evaluate scalar (1D) arithmetic expresions in two
+situations.  To set a variable equal to a math operation, use the
+syntax is:
+
+  $foo = expression
+
+where "expression" is an arithmetic expression on numbers and
+variables, including a variety of functions (see below).  After
+performing the arithmetic and setting the variable to the resulting
+value, mana returns the prompts without performing any further
+command.  Mana will also evaluate any arithmetic expression enclosed
+in curly brackets before attempting to perform the given command.  For
+example, if the variables $MEAN and $SIGMA contain the mean and
+standard deviation of an image, it would be possible to display the
+image with a zero and range based on $MEAN and $SIGMA like this:
+
+  tv image {$MEAN - 1.5*$SIGMA} {5*$SIGMA}
+
+
+The two expressions in curly brackets are evaluated and the resulting
+numbers passed as arguments to the "tv" command.
+
+  See Also:  Variables, tv
+
+
+list of valid math operations:
+
+  binary operators:
+  * (times)
+  / (divided by)
+  + (plus)
+  - (minus)
+  ^ (to the power of: 2^3 = 8)
+
+  unary operators:
+  exp (e to the power of)
+  ten (10 to the power of)
+  ln  (natural logarithm)
+  log (log base 10)
+
+  angles in radians:
+  sin (sine)
+  cos (cosine)
+  tan (tangent)
+  asin (arcsin)
+  acos (arccos)
+  atan (arctan)
+
+  angles in degrees:
+  dsin (sine)
+  dcos (cosine)
+  dtan (tangent)
+  dasin (arcsin)
+  dacos (arccos)
+  datan (arctan)
Index: /trunk/Ohana/src/opihi/cmd.data/help/applyfit
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/applyfit	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/applyfit	(revision 4688)
@@ -0,0 +1,10 @@
+
+  applyfit x y
+
+  apply the results of a polynomial fit (stored in variables 
+  $C0, $C1, etc, with $Cn representing the order of the fit).
+  The second vector will contain the function value at the 
+  corresponding x coordinates of the first vector.
+
+  See also: fit
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/box
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/box	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/box	(revision 4688)
@@ -0,0 +1,11 @@
+
+  box [-n Nwindow]
+
+  draw a coordinate box on the current kapa window, or on the window
+specified by -n (0 - 4).
+
+  See also: Kapa
+
+
+
+  
Index: /trunk/Ohana/src/opihi/cmd.data/help/buffers
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/buffers	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/buffers	(revision 4688)
@@ -0,0 +1,9 @@
+
+  buffers
+
+  buffers gives information about the currently allocated buffers.  
+A * next to the filename means the data has been altered from the
+originally read in image.
+
+  See also: memory
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/center
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/center	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/center	(revision 4688)
@@ -0,0 +1,10 @@
+
+  center (xpix) (ypix) [magnification]
+
+  "center" centers the Kii window at the specified pixel coordinates.
+Specifying a magnification will change the image scale to the
+specified magnification.  If you do not specify a magnification
+(default), the image scale will remain the same.
+
+  See also: Kii, tv
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/clear
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/clear	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/clear	(revision 4688)
@@ -0,0 +1,5 @@
+
+   clear
+
+   clear the Kapa window
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/clip
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/clip	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/clip	(revision 4688)
@@ -0,0 +1,8 @@
+
+  clip (buffer) [min Vmin max Vmax] [-inf val] [-nan val]
+
+  clip values in an image.  A min/max clip can be applied, 
+  in which case all values above max are set to Vmax and all
+  below min are set to Vmin.  -nan and -inf flags will set all 
+  instances of NaN or any non-finite values to the given value.
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/concat
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/concat	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/concat	(revision 4688)
@@ -0,0 +1,8 @@
+
+   concat v1 v2
+
+   concatenates the values of vector v2 to the end of vector
+   v1, increasing the length of v1.
+
+   See also: subset, set
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/contour
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/contour	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/contour	(revision 4688)
@@ -0,0 +1,13 @@
+
+  contour <buffer> (overlay) level [Npix]
+
+  "contour" makes a contour plot from the given <buffer> at the
+specified level.  If Npix is specified, the image is rebinned by a
+factor of Npix in each direction.  The contour is drawn as a series of
+lines on the specified overlay.  The new lines are added to any
+existing shapes.  (Use "erase" first to erase all objects if desired).
+
+Valid overlays may be: 0, red, 1, green, 2, blue, 3, yellow.
+
+  See also: load, save, erase
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/create
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/create	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/create	(revision 4688)
@@ -0,0 +1,7 @@
+
+   create vector start end [delta]
+
+   create a vector of uniformly spaced values, starting at
+   start and going to end.  By default the spacing is 1, but
+   may be chosen with the delta option.
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/cursor
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/cursor	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/cursor	(revision 4688)
@@ -0,0 +1,13 @@
+
+  cursor
+
+  place cursor coordinates (and values ??) into Mana variables.  to do
+this, type cursor, then place the cursor on the desired spot in the
+Ki'i window and type a digit (0 - 9).  The coordinates of the cursor
+are then placed in the variables $Xn and $Yn (where n is the digit you
+typed).  To exit the cursor mode, type "q" (or "Q") in the Ki'i
+window.  
+
+  See Also: Kii, tv, center
+
+ 
Index: /trunk/Ohana/src/opihi/cmd.data/help/cut
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/cut	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/cut	(revision 4688)
@@ -0,0 +1,9 @@
+
+   cut buffer <X vector> <Y vector> <X|Y> sx sy nx ny
+
+   take a cut from an image and place it in a pair of vectors.
+   the <X vector> gets the pixel coordinate in the given direction,
+   the <Y vector> gets the pixel values.  <X|Y> specifies the 
+   direction of the cut.  the region sx, sy, nx, ny specifies the
+   region for the cut, with summation in the cross-direction.
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/datafile
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/datafile	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/datafile	(revision 4688)
@@ -0,0 +1,6 @@
+
+   datafile (filename)
+
+   define a data file for subsequent vector reads.
+
+   See also: read
Index: /trunk/Ohana/src/opihi/cmd.data/help/delete
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/delete	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/delete	(revision 4688)
@@ -0,0 +1,5 @@
+
+  delete <buffer>
+
+  delete the named buffer.  Warning: no second chances are given!
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/erase
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/erase	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/erase	(revision 4688)
@@ -0,0 +1,8 @@
+
+  erase (overlay)
+
+  "erase" erases all objects on the specified overlay.  
+  Valid overlays may be: all, red, green, blue, yellow.
+
+  See also: load, save, contour
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/extract
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/extract	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/extract	(revision 4688)
@@ -0,0 +1,12 @@
+
+  extract <from> <to> sx sy nx ny sx sy nx ny
+
+  extract takes a portion of an image (buffer <from>) and creates a
+new image (buffer <to>).  The source region is defined by the first
+set of (sx sy nx ny), the resulting image and the location of the
+extracted image are defined by the second (sx sy nx ny).  This allows
+a portion of an image to be overlayed at a particular location in a
+larger image.
+
+  See also: Kii, tv
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/fit
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/fit	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/fit	(revision 4688)
@@ -0,0 +1,9 @@
+
+   fit x y order [-dy wt]
+
+   perform a lease-square polynomial fit to the data defined 
+   by vectors x and y.  the coefficients are placed in the variables
+   $C0, $C1, ..., and the order is placed in $Cn.
+
+   See also: applyfit
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/grid
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/grid	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/grid	(revision 4688)
@@ -0,0 +1,6 @@
+
+   grid (overlay) (buffer)
+
+   draw a coordinate grid for the given buffer in the 
+   given overlay in Kii.
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/header
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/header	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/header	(revision 4688)
@@ -0,0 +1,8 @@
+
+   header (buffer)
+
+   print the header information for the given buffer.  The header
+   information is Meta-information associated with an image.  It is
+   well-defined for the FITS images, but may not exist for some of the
+   other possible data types.  
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/histogram
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/histogram	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/histogram	(revision 4688)
@@ -0,0 +1,8 @@
+
+   histogram <buffer> <x> <y> [-region sx sy nx ny] [-range min max]
+
+   calculate a histogram of the image pixel values in the given
+   buffer, optionally constrained to the given region, with optional
+   max and min values.  the results are placed in the vectors x and y,
+   which contain the pixel values and the number of occurences.
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/kern
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/kern	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/kern	(revision 4688)
@@ -0,0 +1,4 @@
+
+   kern buffer (kernel file or -)
+
+   apply a 3x3 kernel to the image.  
Index: /trunk/Ohana/src/opihi/cmd.data/help/keyword
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/keyword	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/keyword	(revision 4688)
@@ -0,0 +1,11 @@
+
+  keyword <buffer> (KEYWORD) [variable] [-w value]
+
+  "keyword" extracts the specified keyword from the header of the
+   specified buffer.  If a third word is listed, the value of the
+   keyword is stored in a variable with the given name.  If the -w
+   option is given, the value is written to the header keyword.
+
+   The header Meta-data is well-defined for FITS, but not necessarily
+   for other data types.
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/labels
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/labels	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/labels	(revision 4688)
@@ -0,0 +1,23 @@
+
+   labels 
+
+   write a label on the Kapa window.  there are many options:
+
+   -fn font size -- define the font (may be times, helvetica, courier)
+
+   -x "a long line" -- label on the bottom x-axis
+
+   +x "a long line" -- label on the top x-axis
+
+   -y "a long line" -- label on the left y-axis
+
+   +y "a long line" -- label on the right y-axis
+
+   -ul "a long line" -- label on the upper left of plot
+
+   -ll "a long line" -- label on the lower left of plot
+
+   -ur "a long line" -- label on the upper right of plot
+
+   -lr "a long line" -- label on the lower right of plot
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/limits
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/limits	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/limits	(revision 4688)
@@ -0,0 +1,12 @@
+
+   limits min max min max
+   limits x y
+   limits x min max
+   limits min max y
+   
+   set Kapa plot limits.  The x and y axis limits may be explicitly
+   set (first example), or they may be assigned based on the range of
+   values in a pair of vectors (second examples), or one range may be
+   explicit and the other range assigned from a vector.
+
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/load
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/load	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/load	(revision 4688)
@@ -0,0 +1,20 @@
+
+   load (overlay) (filename)
+
+  "load" reads a file with objects in SAOimage style into the
+  specified overlay.  If the specified overlay is already used, the
+  new objects are added to the old.  If you do not want this, use
+  "erase" to erase all objects in the overlay first.  Valid overlays
+  may be: 0, red, 1, green, 2, blue, 3, yellow.
+
+Examples of SAOimage style objects:
+BOX   300  200  100 50  : draws a box centered at pixel 300,200 that
+			  is 100 pixels wide, and 50 pixels high
+
+CIRCLE 500 400 200 : draws a circle centered at pixel 500,400 with a
+                     radius of 200 pixels
+
+LINE 100 100 200 200 : draws a line from (100,100) with length (200,200)
+
+  See also: save, erase, contour
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/plot
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/plot	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/plot	(revision 4688)
@@ -0,0 +1,13 @@
+
+   plot <x> <y> [-dx dx] [-dy dy] [+dx dx] [+dy dy]
+
+   plot a pair of vectors.  the options allow for errorbars.  If only
+   one of -dy or +dy is given, the given vector is used for the
+   errorbar.  If both are given, -dy defines the lower errorbar, while
+   +dy defines the upper errorbar.  This allows for assymetric errors
+   in a trivial fashion.  The same applies to the -dx, +dx values.  
+
+   The vectors are plotted with the current plot style.  See style for
+   all of the options.
+
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/ps
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/ps	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/ps	(revision 4688)
@@ -0,0 +1,8 @@
+
+   ps [-g]
+
+   create a PostScript file from the Kii window (or Kapa window if -g
+   is given).  Kii produces a file called Ximage.ps, while Kapa
+   produces a file called Xgraph.ps
+
+   Color postscript is an obvious, but unimplemented extension...
Index: /trunk/Ohana/src/opihi/cmd.data/help/rd
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/rd	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/rd	(revision 4688)
@@ -0,0 +1,10 @@
+
+  rd (buffer) (filename)
+
+  "rd" reads a file into the specified buffer, creating the buffer if
+  none exists.  A buffer name may consist of any letters, numbers, and
+  some limited other characters.  However, the name may not start with
+  a digit.
+
+  See also: wd, tv
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/read
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/read	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/read	(revision 4688)
@@ -0,0 +1,10 @@
+
+   read vect col [vect col, ...]
+
+   read vector values from a file.  An arbitrary number of vectors can
+   be specified, and the (whitespace-separated) field number given for
+   each vector.  Data is read from the file defined by "datafile".
+
+   See also: datafile
+
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/rebin
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/rebin	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/rebin	(revision 4688)
@@ -0,0 +1,9 @@
+
+  rebin <from> <to> scale
+
+  "rebin" rebins the specified buffer by the given scale factor and
+  places the result in the <to> buffer.  Negative integer values imply
+  expansion, positive numbers imply compression.
+
+  See also: extract
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/resize
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/resize	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/resize	(revision 4688)
@@ -0,0 +1,6 @@
+
+   resize Nx Ny
+
+   change the size of the Kii window to have image dimensions Nx x
+   Ny.  
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/rotate
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/rotate	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/rotate	(revision 4688)
@@ -0,0 +1,10 @@
+
+   rotate (buffer) (angle) [-center x y]
+
+   rotate the buffer by the given angle.  The angle may also be one of
+   the following special words:
+
+   -flipx - flip in the x direction
+   -flipy - flip in the y direction
+
+   if the optional center is given the rotation is about this position.
Index: /trunk/Ohana/src/opihi/cmd.data/help/save
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/save	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/save	(revision 4688)
@@ -0,0 +1,16 @@
+  save (overlay) (filename)
+
+  "save" stores the objects from the specified overlay into the named
+file.  Valid overlays may be: 0, red, 1, green, 2, blue, 3, yellow.
+
+Examples of SAOimage style objects:
+BOX   300  200  100 50  : draws a box centered at pixel 300,200 that
+			  is 100 pixels wide, and 50 pixels high
+
+CIRCLE 500 400 200 : draws a circle centered at pixel 500,400 with a
+                     radius of 200 pixels
+
+LINE 100 100 200 200 : draws a line from (100,100) with length (200,200)
+
+  See also: load, erase, contour
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/set
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/set	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/set	(revision 4688)
@@ -0,0 +1,41 @@
+
+  set (buffer) = expression..
+
+  perform math operations on images.  there are several allowed
+  operators.  the standard math functions are + - * /.  Exponentiation
+  is performed with ^ (set c = a ^ b).  There are several "logic"
+  operators which need some explanation.
+
+  set c = a < b  -- c is 1 if a < b, 0 otherwise
+  set c = a > b  -- c is 1 if a > b, 0 otherwise
+  set c = m1 & m1 - c is 1 if m1 AND m2 true (non-zero is true)
+  set c = m1 | m1 - c is 1 if m1 OR m2 true (non-zero is true)
+  set c = a << b -- c is the minimum of a and b
+  set c = a >> b -- c is maximum of a and b
+
+  complex operations may be performed:
+
+  set c = a*(a < b) + c*((a < c) | (c < d))
+
+  unary operators also exist:
+
+  exp(a) - e to the power of a
+  ten(a) - 10 to the power of a
+  ln(a) - log base e of a
+  log(a) - log base 10 of a
+  sqrt(a) - square root of a
+  sin(a) - sin of a
+  cos(a) - sin of a
+  tan(a) - sin of a
+  not(a) - logical inverse of a
+  abs(a) - absolute value of a
+  int(a) - integer value of a
+
+  Examples:
+  
+  set a = b + 10  (add 10 to every pixel in b and put the answer in a)
+  set a = a / b   (divide every pixel in a by the corresponding pixel
+                     b and put the answer in a)
+  set b = 10 / a  (divide 10 by every pixel in a and put the answer
+                     in b)
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/shift
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/shift	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/shift	(revision 4688)
@@ -0,0 +1,6 @@
+
+   shift buffer dx dy
+
+   shift image by dx,dy pixels (may be fractional values).
+
+   
Index: /trunk/Ohana/src/opihi/cmd.data/help/stats
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/stats	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/stats	(revision 4688)
@@ -0,0 +1,10 @@
+
+  stats (buffer) (x) (y) (nx) (ny)
+
+  report the statistics on a portion of an image.  (x) and (y) specify
+the starting corner of the region, (nx) and (ny) specify the width and
+height of the region.  stats reports the mean, sigma, and number of
+pixels in the region.
+
+  See Also: ??
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/style
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/style	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/style	(revision 4688)
@@ -0,0 +1,36 @@
+
+   style -- many options
+
+   define or check the Kapa plotting style.  without any command-line arguments,
+   style prints the current style.  
+
+   option definitions:
+
+   -n	window number (0-4), can also be used to change active window.
+   -pt	point style: 
+		0 = filled box
+		1 = open box
+		2 = +
+		3 = X
+		4 = filled triangle
+		5 = blank
+		6 = open triangle 
+		7 = open circle
+		100 = connect pair of points
+   -x	plotting method:
+		0 = connect
+		1 = histogram
+		2 = points
+   -lt	line type:
+		0 = solid
+		1 = dashed
+		2 = dotted??
+   -lw	line weight (0-10)
+   -sz	point size
+   -c   color:
+	black, white, red, orange, 
+	yellow, green, blue, indigo, violet
+   -eb  errorbar with no top
+   +eb  errorbar with top
+
+   See also: plot, box
Index: /trunk/Ohana/src/opihi/cmd.data/help/subset
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/subset	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/subset	(revision 4688)
@@ -0,0 +1,12 @@
+
+   subset vec = vec if (logic expression)
+
+   reduce the length of a vector based on logical expression.  The
+   logic expression is some function of vectors of equal length to the
+   main vector.
+
+   for example, we have vectors x and y of the same length:
+   
+   subset X = x if ((y > 100) | (x < 10))
+
+    
Index: /trunk/Ohana/src/opihi/cmd.data/help/textline
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/textline	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/textline	(revision 4688)
@@ -0,0 +1,7 @@
+
+   textline x y (line) [-fn (font) size] [-rot angle]
+
+   write the string at the given coordinates and rotation,
+   in the given font.
+
+   (enclose long strings with spaces in quotes)
Index: /trunk/Ohana/src/opihi/cmd.data/help/tv
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/tv	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/tv	(revision 4688)
@@ -0,0 +1,13 @@
+
+  tv [-log] (buffer) [zero range]
+
+  display an image in the Ki'i window (X display program).  zero and
+  range specify the data values corresponding to the color mapping.
+  If they are not specified, the old values are used (default is 0,
+  1024).
+
+  If -log is specified the color mapping scale will be logarithmic.  
+
+
+  See Also: Kii, rd, cursor
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/unsign
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/unsign	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/unsign	(revision 4688)
@@ -0,0 +1,20 @@
+  unsign
+
+  "unsign" toggles the status of the UNSIGN mode.  Warning: This is a
+non-FITS standard implementation.  The FITS standard does not allow
+for unsigned integer data values, but many sites write CCD images with
+16 bit UNSIGNED data.  Mana looks for a FITS keyword "UNSIGN" to
+determine if an image which is read in has signed or unsigned
+integers.  However, since this is a non-standard concept, many sites
+do not use the UNSIGN flag, yet still write unsigned data.  If the
+user knows the data in the file is unsigned (ie, the user must have
+apriori knowledge -- a FITS no-no!), then the user should set the
+UNSIGN mode to true.  In the event that the UNSIGN mode is set, if a
+FITS file is encountered which contains integers, but which does not
+contain the UNSIGN keyword, Mana will make the default assumption that
+the data is unsigned.  If the SIGNED mode is set, Mana will assume all
+integer FITS files contain signed integers.  
+
+((( should be able to say "unsign <buffer>" to convert the status of a
+buffer to UNSIGN or to toggle the buffer's status, but not yet
+implemented)))
Index: /trunk/Ohana/src/opihi/cmd.data/help/vectors
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/vectors	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/vectors	(revision 4688)
@@ -0,0 +1,5 @@
+
+   vectors
+
+   list the currently defined vectors and lengths
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/wd
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/wd	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/wd	(revision 4688)
@@ -0,0 +1,29 @@
+
+  wd (buffer) (filename) [BITPIX]
+
+  wd writes a buffer to the specified file in FITS format.  (You may
+need quotes around the filename if there are any /'s in the path).
+The FITS keyword BITPIX may be specified.  Valid values are 8, 16, 32
+(integer formats) and -32, -64 (floating point formats).  If BITPIX is
+unspecified, the original value of the image is used.  The image is
+converted blindly to the format and written out.  This may mean that
+values are rounded (integers), or wrapped by the range of the number
+of bits.  Also beware of the issue of signed vs unsigned images.
+
+  See Also: rd
+
+bitpix  bzero  bscale  file range     data range
+16      0      1       -32k : 32k     -32k : 32k
+16	32k    1       -32k : 32k        0 : 64k
+16	0      2       -32k : 32k     -64k : 64k
+16	0      0.001   -32k : 32k     -32. : 32.
+32	0      1       -2e9 : 2e9     -2e9 : 2e9
+8	0      1       -128 : 128     -128 : 128
+
+so for example, a file with a data range of -128k to +128k written
+with bitpix 16, bzero 0, bscale 1 will have all data outside -32k :
++32k wrapped back in that range.
+
+note: on write, bzero is subtracted from the data before the data is
+      divided by bscale.
+
Index: /trunk/Ohana/src/opihi/cmd.data/help/zplot
===================================================================
--- /trunk/Ohana/src/opihi/cmd.data/help/zplot	(revision 4688)
+++ /trunk/Ohana/src/opihi/cmd.data/help/zplot	(revision 4688)
@@ -0,0 +1,7 @@
+
+   zplot x y z min max
+
+   plot the vector pair x and y as a series of points with size scaled
+   by the values in the vector z, with the smallest point having
+   values <= min and the largest having values >= max.
+
Index: /trunk/Ohana/src/opihi/dvo/help/Photometry
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/Photometry	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/Photometry	(revision 4688)
@@ -0,0 +1,26 @@
+
+cals: Plot residuals for reference stars. 
+
+ This function takes the currently displayed region and looks for all
+ stars which have 'reference' photometry and plots the difference
+ between the reference magnitude (in the given filter) and the
+ observed magnitude (same filter) versus one of several options:  the
+ star color (based on the 'reference' photometry), the star magnitude,
+ the airmass, time, secqunce, etc.
+
+ These plots can use one of two options for the 'observed' magnitude.
+ Either, the magnitude for individual measurement, using the currently
+ set values for the CCD zeropoints (from the photometry database), or
+ using the relative photometry determined for the particular star.  
+
+
+dmags: plot difference between two measured magnitudes
+
+resid: 
+
+abszero
+
+zeropts
+
+cmd
+
Index: /trunk/Ohana/src/opihi/dvo/help/catalog
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/catalog	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/catalog	(revision 4688)
@@ -0,0 +1,74 @@
+
+  catalog (filename/-all) [many options!]
+
+  plot the star positions from any of several possible catalogs.  By
+default, the photometry database (see Database) is used, but the HST
+Guide Star Catalog and a simple ASCII file may also be used.  The
+plotting is done on window 0, with the current point type.  The point
+size can be scaled by the magnitude of the star or by the number
+of observations (-n).  
+
+There are many options to this function.  Here they are all:
+
+-e epoch: given ASCII catalog has this epoch, plot in J2000
+
+-ID ID: plot only measurements with this ID number
+ ID may be one of:
+	0 - star
+	4 - variable
+	5 - transient
+      100 - ghost image
+      101 - trail (satellite)
+      102 - bright star garbage	
+      note that numbers < 50 are static objects, 
+	and numbers > 100 are bad data.
+
+-all:  plot all data for the current display region
+
+-g: use the HST GSC instead of the photometry database
+
+-a RA DEC MAG:  the given file is an ASCII file with 
+	RA, DEC, and MAG in columns given by the three numbers
+
+-v ra dec scale: save the values in vectors with the three names given
+	the ra and dec are always used, but the third is the size of 
+	the points plotted, based on whatever the scaling is.
+
+-m m1 m2: scale points by magnitude, with smallest points having
+	magnitude m2.
+
++n n1 n2: scale points by number of measurements, with smallest points
+	having number n1.
+
+-n n1 n2: scale points by number of missing values, with smallest points
+	having number n1.
+
+Note that if two of -m, -n, +n are given, the first determines the
+ scaling of the points.  the second provides an allowed range, so
+ points are only plotted if the second parameter has a value in the
+ given range.
+
+Examples: 
+
+  catalog -all -m 12 18  
+    plot all stars in current region with magnitude 12 having the
+    biggest points and magnitude 18 having the smallest.
+   
+  catalog -all -m 12 18 +n 2 4
+    plot all stars in current region with magnitude 12 having the
+    biggest points and magnitude 18 having the smallest, but only
+    if the stars have 2-4 measurements each
+   
+  catalog -all -m 12 18 +n 0 1 -ID 101
+    plot all stars in current region with magnitude 12 having the
+    biggest points and magnitude 18 having the smallest, but only
+    if the stars have 1 measurements each, and if the object is 
+    found to be a trail.
+   
+  catalog n2230/1819.cpt -n 2 8  
+    plot all stars in catalog n2230/1819.cpt with the biggest points
+    having 8 measurements and the smallest having only 2.
+
+  See Also: lcat, pcat, style, region
+
+   
Index: /trunk/Ohana/src/opihi/dvo/help/images
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/images	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/images	(revision 4688)
@@ -0,0 +1,9 @@
+
+  images 
+
+  plot the outlines of images in the photometry database and list
+  along with relevant information.  An example of relevant data is the
+  image time, which can be used in other functions to define a specific
+  image or a range of images relevant for the function.
+
+  See also: Database, lcat, pcat
Index: /trunk/Ohana/src/opihi/dvo/help/imstats
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/imstats	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/imstats	(revision 4688)
@@ -0,0 +1,5 @@
+
+  imstats 
+
+  list interesting statistics for a set of images.
+
Index: /trunk/Ohana/src/opihi/dvo/help/lcat
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/lcat	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/lcat	(revision 4688)
@@ -0,0 +1,10 @@
+
+  lcat [-all]
+
+  list photometry database files in the current region.  if the option
+  -all is given, all database in the region are listed, along with a
+  comment to show if there is data in the file or not.  if the option
+  is not given, only those files with data are listed.
+
+  See also: region, pcat
+
Index: /trunk/Ohana/src/opihi/dvo/help/lcurve
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/lcurve	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/lcurve	(revision 4688)
@@ -0,0 +1,8 @@
+
+  lcurve RA DEC Radius [-l]
+
+  plot light curves for all stars within Radius of the given
+  coordinates.  The units for all three are decimal degrees.  
+  The option -l autoscales the limits of the plot.  
+
+  See also: limits
Index: /trunk/Ohana/src/opihi/dvo/help/mextract
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/mextract	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/mextract	(revision 4688)
@@ -0,0 +1,12 @@
+
+ mextract (filename) (value) [-g / -a Ncol]
+
+ extracts a vector from the photometry database.  The name also
+ specifies the type of data extracted (and is case insensitive).  Only
+ certain names may be used.
+
+ The possible values are:
+ ra, dec, mag, dmag, Mcal, Mrel, source, time, dR, dD
+
+
+ Note: this routine extracts the individual measurements.
Index: /trunk/Ohana/src/opihi/dvo/help/pcat
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/pcat	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/pcat	(revision 4688)
@@ -0,0 +1,9 @@
+
+  pcat [-all]
+
+  plot outlines of photometry database files in the current region.
+  if the option -all is given, all database in the region are listed.
+  if the option is not given, only those files with data are listed.
+
+  See also: region, lcat
+
Index: /trunk/Ohana/src/opihi/dvo/help/resid
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/resid	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/resid	(revision 4688)
@@ -0,0 +1,12 @@
+
+  resid [-im time] [-X] [-l] (photometry file)
+
+  plot the photometry residuals for a photometry database file. 
+  For every star in the database, the average magnitude is plotted 
+  vs the difference between the average magnitude and each existing 
+  measurement for that star.  
+
+  -l		automatically set the plot limits.
+  -X		plot residual divided by photometric error
+  -im time	only plot the residuals for one of the images 
+		in the database, specified by the obseravation time.
Index: /trunk/Ohana/src/opihi/dvo/help/simage
===================================================================
--- /trunk/Ohana/src/opihi/dvo/help/simage	(revision 4688)
+++ /trunk/Ohana/src/opihi/dvo/help/simage	(revision 4688)
@@ -0,0 +1,7 @@
+
+  simage (filename)
+
+  plot the positions of stars in a CMP file.  This function is a
+  useful test for image comparisons, and astrometry must be determined
+  before the function is run.
+
Index: /trunk/Ohana/src/opihi/pantasks/help/controller
===================================================================
--- /trunk/Ohana/src/opihi/pantasks/help/controller	(revision 4688)
+++ /trunk/Ohana/src/opihi/pantasks/help/controller	(revision 4688)
@@ -0,0 +1,29 @@
+
+   controller (command) ...
+
+   Interact with the parallel controller 'pcontrol'.  This command
+   groups together several controller sub-commands, listed below.
+
+
+   controller host (hostname)
+
+   Define a new machine available to the parallel controller.  
+
+
+   controller check (host) (HostID)
+   controller check (job) (JobID)
+
+   Check on the status of a specific host or job known to the parallel
+   controller.
+
+
+   controller status
+
+   Query the parallel controller for its current status
+
+
+   controller output
+
+   Dump the contents of the parallel controller message buffers.
+   These are the messages from the controller itself, rather than the
+   messages generated by jobs run by the controller.
Index: /trunk/Ohana/src/opihi/pantasks/help/task
===================================================================
--- /trunk/Ohana/src/opihi/pantasks/help/task	(revision 4688)
+++ /trunk/Ohana/src/opihi/pantasks/help/task	(revision 4688)
@@ -0,0 +1,27 @@
+
+   task (name)
+
+   Define or modify a task.  A task is defined by issuing a series of
+   task commands, listed below (see their individual help pages).  A
+   task describes the rules for constructing jobs.  At a minimum, a
+   task must include a command, defining the UNIX command to run for
+   each job.  Other task commands define optional concepts for the
+   task.  These include: 
+
+   - a macro to be run before the job is constructed (task.exec).
+   - a set of macros to be run when the job is completed (task.exit)
+   - time ranges in which the task should be run (or not) (trange) 
+   - required / desired parallel controller hosts (host)
+   - job contruction time interval (periods -exec)
+   - job polling time interval (periods -poll)
+   - job timeouts (periods -timeout)
+   - maximum number of jobs to construct
+
+   See also:
+   task.command
+   task.exit
+   task.exec
+   task.trange
+   task.nmax
+   task.host
+   task.periods
Index: /trunk/Ohana/src/opihi/pantasks/help/task.command
===================================================================
--- /trunk/Ohana/src/opihi/pantasks/help/task.command	(revision 4688)
+++ /trunk/Ohana/src/opihi/pantasks/help/task.command	(revision 4688)
@@ -0,0 +1,15 @@
+
+   command (arg0) (arg1) ...
+
+   Define the rule for constructing a job command for a task.  The
+   arguments are UNIX command and the collection of command arguments.
+   The arguments may include references to Opihi variables.  The task
+   command may be included at the top level of the task, or it may be
+   defined within the task exec macro.  In the latter case, the
+   command is constructed only when the exec macro is run, every job
+   construction interval.  Thus, the command arguments may depend on
+   the result of the exec macro operation.   
+
+   See also:
+   task
+   task.exec
Index: /trunk/Ohana/src/opihi/pantasks/help/task.exec
===================================================================
--- /trunk/Ohana/src/opihi/pantasks/help/task.exec	(revision 4688)
+++ /trunk/Ohana/src/opihi/pantasks/help/task.exec	(revision 4688)
@@ -0,0 +1,17 @@
+
+   task.exec
+
+   A special macro to be executed before constructing the job command.
+   The macro is defined by commands following the 'task.exec' command,
+   ending with the word 'end'.  If the exit status of the task.exec
+   macro is FALSE, then the job is NOT constructed.  This allows the
+   construction of a job to be conditional on other, external
+   quantites.  (Note: the exit status of the macro is false if 'break'
+   is called).  The task command may be defined within the task.exec
+   macro, in which case the command is constructed only when the exec
+   macro is run, every job construction interval.  Thus, the command
+   arguments may depend on the result of the exec macro operation.
+
+   See also:
+   task
+   task.command