Index: /trunk/ippTools/doc/p0tools.txt
===================================================================
--- /trunk/ippTools/doc/p0tools.txt	(revision 6015)
+++ /trunk/ippTools/doc/p0tools.txt	(revision 6015)
@@ -0,0 +1,34 @@
+
+Phase 0 pipeline tools:
+
+p0search -ready :
+  * examine the new.imfiles,new.exposures tables and select exposures ready for analysi
+
+p0search -update :
+  * select a specified image in the new.imfiles/new.exposures table
+  * extract the specified header information
+  * search the summit metadata db tables
+  * write an entry to the raw.imfiles and raw.exposure tables
+  * set the state on the new.imfiles,new.exposure tables
+  * based on the camera config information;
+    * add an entry to the p1.pending table (mosaic) 
+    - or
+    * add an entry to the p2.pending table (single)
+
+p0search -stats :
+  * select a specified image in the new.imfiles/new.exposures table
+  * extract the specified header information
+  * search the summit metadata db tables
+  * report the image stats
+  [-update without output to MDDB]
+
+p0search -mkraw :
+  * select a specified image in the new.imfiles/new.exposures table
+  * extract the specified header information
+  * search the summit metadata db tables
+  * write an entry to the raw.imfiles and raw.exposure tables
+  * set the state on the new.imfiles,new.exposure tables
+
+p0search -cleanup:
+  * remove completed entries from the new.imfiles,new.exposure tables
+
Index: /trunk/ippTools/doc/p1tools.txt
===================================================================
--- /trunk/ippTools/doc/p1tools.txt	(revision 6015)
+++ /trunk/ippTools/doc/p1tools.txt	(revision 6015)
@@ -0,0 +1,15 @@
+
+Phase 1 pipeline tools:
+
+p1search -insert ? :
+  * examine the raw.exposures tables and select exposures matching the given criteria
+  * add entries which are allowed (mosaic) to the p1.pending table
+
+p1search -pending :
+  * examine the p1.pending table and select exposures waiting for p1
+  * output the list for p1.tasks
+
+p1search -update :
+  * select completed entries in the p1.pending table
+  * move to the p1.done table
+  * add new entry to the p2.pending tables
Index: /trunk/ippTools/doc/p2tools.txt
===================================================================
--- /trunk/ippTools/doc/p2tools.txt	(revision 6014)
+++ /trunk/ippTools/doc/p2tools.txt	(revision 6015)
@@ -2,10 +2,14 @@
 Phase 2 pipeline tools:
 
-p2define -time (start) (stop) -camera (camera) -region (ra,dec) (ra,dec)
+p2search -quick 
+  * search for images which match in raw.exp,raw.imfiles
+  * output in format which can be used by ppImage pantasks script
+
+p2search -define [options]
   * input: searches mddb:raw_exposures,raw_images
   * output: updates mddb:P2_exposures_pending,P2_images_pending
   * alternative output: identical to p2pending
  
-p2pending 
+p2search -pending 
   * input: searches mddb:P2_exposures_pending,P2_images_pending
   * output: Nlines consisting of:
@@ -13,12 +17,17 @@
   * options: ?
 
-(place both of these in a single user tool, p2search)
+p2search -update
+  * examine the imfiles and identify any comleted exposures
 
-p2search -quick [options]
-p2search -define [options]
-p2search -pending [options]
-p2search -update [options]
+p2search -done
+  * add completed exposures to the p2.done tables
+  * remove corresponding entries from the p2.pending table
+  * send new entry to the pending p3 table
 
 ppImage file://path/filename file://path/outroot -recipe (recipe) 
 ppImage neb://nebname neb://outroot -recipe (recipe)
 
+restriction options:
+  -time (start) (stop)
+  -camera (camera) 
+  -region (ra,dec) (ra,dec)
Index: /trunk/ippTools/doc/p3tools.txt
===================================================================
--- /trunk/ippTools/doc/p3tools.txt	(revision 6015)
+++ /trunk/ippTools/doc/p3tools.txt	(revision 6015)
@@ -0,0 +1,11 @@
+
+Phase 3 pipeline tools:
+
+p3search -pending :
+  * examine the raw.exposures tables and select exposures matching the given criteria
+  * add entries which are allowed (mosaic) to the p3.pending table
+
+p3search -update :
+  * select completed entries in the p1.pending table
+  * move to the p1.done table
+  * add new entry to the p2.pending tables