Update class descriptions

Framework/DataObjects/inc/MantidDataObjects/BasePeak.h

@@ -25,10 +25,10 @@ class InstrumentRayTracer;
 
 namespace DataObjects {
 
-/** Structure describing a single-crystal peak
+/** Structure describing a single-crystal peak. This is a partial
+ * implementation of IPeak and should contain everything that is common
+ * to Peak and LeanPeak.
  *
- * @author Janik Zikovsky
- * @date 2011-04-15 13:24:07.963491
  */
 class DLLExport BasePeak : public Geometry::IPeak {
 public:

Framework/DataObjects/inc/MantidDataObjects/LeanPeak.h

@@ -20,10 +20,11 @@ namespace Mantid {
 
 namespace DataObjects {
 
-/** Structure describing a single-crystal peak
+/** Structure describing a single-crystal peak. This is a version of
+ * Peak that doesn't require the instrument. The peak is described
+ * only by the Q-sample position. Optionally if the wavelength and
+ * goniometer is provided other properties can be calculated.
  *
- * @author Janik Zikovsky
- * @date 2011-04-15 13:24:07.963491
  */
 class DLLExport LeanPeak : public BasePeak {
 public:

Framework/DataObjects/inc/MantidDataObjects/Peak.h

@@ -26,10 +26,11 @@ class InstrumentRayTracer;
 
 namespace DataObjects {
 
-/** Structure describing a single-crystal peak
+/** Structure describing a single-crystal peak. The peak is described
+ * by the physical detector position (determined either from detector
+ * infomation or calculated from Q-lab) and inital/final energy
+ * (calculated from Q-lab or provided wavelength)
  *
- * @author Janik Zikovsky
- * @date 2011-04-15 13:24:07.963491
  */
 class DLLExport Peak : public BasePeak {
 public: