- Improvements to Hipadaba

- New chopper driver for MARS Juelich chopper system
- New docbook based SANS manual


SKIPPED:
	psi/amorcomp.c
	psi/amordrive.h
	psi/amorset.c
	psi/amorset.h
	psi/amorset.tex
	psi/amorset.w
	psi/julcho.c
	psi/libpsi.a
	psi/make_gen
	psi/psi.c

sicshipadaba.h

@@ -12,6 +12,11 @@
 #include <hipadaba.h>
 #include <sics.h>
 #include <dynstring.h>
+/*======================== callback error codes ===============================*/
+#define SICSCBRO        -607
+#define SICSCBPERM      -608
+#define SICSCBRANGE     -609  
+#define SICSCBBADFIXED  -610
 /*======================== data structure for automatic parameter update =======*/
 typedef struct {
         SConnection *pCon;
@@ -40,6 +45,13 @@ pHdbCallback MakeSetUpdateCallback();
  * starting a parameter driving.
  */
 pHdbCallback MakeSICSDriveCallback(void *sicsObject);
+/**
+ * make a callback which reads a SICS drivable object
+ * @param sicsObject The SICS drivable object to read.
+ * @return a suitably initialized callback structure for
+ * reading a drivable parameter
+ */
+pHdbCallback MakeSICSReadDriveCallback(void *sicsObject);
 /**
  * make a callback which enables automatically 
  * notification of pCon on parameter updates.
@@ -51,6 +63,33 @@ pHdbCallback MakeSICSDriveCallback(void *sicsObject);
  * automatic notification.
  */
 pHdbCallback MakeNotifyCallback(SConnection *pCon, int id);
+/**
+ * make a callback for checking if a parameter is within a given
+ * range of integers
+ * @param min The minimum value of the range
+ * @param max The maximum value of the range
+ * @return a suitably configured callback or NULL 
+ * when out of memory
+ */
+pHdbCallback MakeIntRangeCallback(int min, int max);
+/**
+ * make a callback for checking if a parameter is one out 
+ * of a series of permitted integers
+ * @param data An array of permitted integers
+ * @param length The length of the data array.
+ * @return a suitably configured callback or NULL 
+ * when out of memory
+ */
+pHdbCallback MakeIntFixedCallback(long *data, int length);
+/**
+ * make a callback for checking if a parameter is within a given
+ * range of floats
+ * @param min The minimum value of the range
+ * @param max The maximum value of the range
+ * @return a suitably configured callback or NULL 
+ * when out of memory
+ */
+pHdbCallback MakeFloatRangeCallback(double min, double max);
 /*======================== parameter creation ===================================*/
 /**
  * make a simple SICS hdb parameter. Setting it will call update immediately. Use 
@@ -171,5 +210,9 @@ int InstallSICSHipadaba(SConnection *pCon, SicsInterp *pSics, void *pData,
  * @return The root node of the hipdaba
  */    
 pHdb GetHipadabaRoot();    
-
+/**
+ * kill the SICS hierarchical database
+ * Only to be called when shutting down the SICServer
+ */
+void killSICSHipadaba(void); 
 #endif /*SICSHIPADABA_H_*/