Index: trunk/psModules/src/detrend/pmFlatField.h
===================================================================
--- trunk/psModules/src/detrend/pmFlatField.h	(revision 7278)
+++ trunk/psModules/src/detrend/pmFlatField.h	(revision 9612)
@@ -1,2 +1,17 @@
+/// @file pmFlatField.h
+///
+/// @brief Apply flat field calibration
+///
+/// @ingroup Detrend
+///
+/// @author Ross Harman, MHPCC
+/// @author Paul Price, IfA
+///
+/// @version $Revision: 1.5 $ $Name: not supported by cvs2svn $
+/// @date $Date: 2006-10-17 20:38:42 $
+///
+/// Copyright 2004-2006 Institute for Astronomy, University of Hawaii
+///
+
 /** @file  pmFlatField.h
  *
@@ -18,11 +33,12 @@
  *  @author Ross Harman, MHPCC
  *
- *  @version $Revision: 1.4 $ $Name: not supported by cvs2svn $
- *  @date $Date: 2006-06-02 00:55:23 $
+ *  @version $Revision: 1.5 $ $Name: not supported by cvs2svn $
+ *  @date $Date: 2006-10-17 20:38:42 $
  *
  *  Copyright 2004 Maui High Performance Computing Center, University of Hawaii
  */
 
-#include "pslib.h"
+
+
 #include "pmFPA.h"
 
@@ -35,7 +51,15 @@
  *  @return  bool: True or false for success or failure
  */
-bool pmFlatField(
-    pmReadout *in,          ///< Readout with input image
-    const pmReadout *flat   ///< Readout with flat image
-);
 
+
+/// Apply flat field calibration to a readout
+///
+/// This function applies the flat field calibration to the input readout.  Support is available for different
+/// image types, though the input and flat images must have the same type.  The relative offsets between the
+/// input and flat images is determined from the readout row0,col0 and the CELL.X0 and CELL.Y0 concepts.
+/// Normalisation of the flat is left as the responsibility of the caller.  Negative pixels in the flat are
+/// masked, if there is a mask present in the input readout.
+bool pmFlatField(pmReadout *in,         ///< Readout with input image
+                 const pmReadout *flat  ///< Readout with flat image
+                );
+