corr class comments

Device/Beam/Beam.h

@@ -21,7 +21,7 @@
 
 class IFootprintFactor;
 
-//! Beam defined by wavelength, direction and intensity.
+//! An incident neutron or x-ray beam.
 //! @ingroup beam
 
 class Beam : public INode {

Device/Beam/FootprintGauss.h

@@ -17,9 +17,9 @@
 
 #include "Device/Beam/IFootprintFactor.h"
 
-//! Calculates footprint coefficient for a gaussian beam
-//! Beam width is interpreted as the full width on the level
-//! of \f[ \exp{-1/2} \f] from the peak intensity.
+//! Gaussian beam footprint.
+//!
+//! Beam width is the full width at half maximum.
 //! @ingroup beam
 
 class FootprintGauss : public IFootprintFactor {

Device/Beam/FootprintSquare.h

@@ -17,7 +17,7 @@
 
 #include "Device/Beam/IFootprintFactor.h"
 
-//! Calculates footprint coefficient for a square beam
+//! Rectangular beam footprint.
 //! @ingroup beam
 
 class FootprintSquare : public IFootprintFactor {

Device/Mask/Ellipse.h

@@ -17,7 +17,7 @@
 
 #include "Device/Mask/IShape2D.h"
 
-//! Ellipse shape.
+//! An ellipse, for use in detector masks.
 //! @ingroup tools
 
 class Ellipse : public IShape2D {

Device/Mask/InfinitePlane.h

@@ -22,7 +22,7 @@
 
 #include "Device/Mask/IShape2D.h"
 
-//! The infinite plane is used for masking everything once and forever.
+//! The infinite plane is used for masking the entire detector.
 //! @ingroup tools
 
 class InfinitePlane : public IShape2D {

Device/Mask/Line.h

@@ -17,7 +17,7 @@
 
 #include "Device/Mask/IShape2D.h"
 
-//! A line segment.
+//! A line segment, for use in detector masks.
 //! @ingroup mask
 
 class Line : public IShape2D {

Device/Mask/Polygon.h

@@ -20,7 +20,7 @@
 
 class PolygonPrivate;
 
-//! A polygon in 2D space.
+//! A polygon, for use in detector masks.
 //! @ingroup mask
 
 //! Polygon defined by two arrays with x and y coordinates of points.

Device/Mask/Rectangle.h

@@ -17,7 +17,9 @@
 
 #include "Device/Mask/IShape2D.h"
 
-//! The rectangle shape having its axis aligned to the (non-rotated) coordinate system.
+//! A rectangle, for use in detector masks.
+//!
+//! Edges are along the coordinate axes.
 //! @ingroup mask
 
 class Rectangle : public IShape2D {

Fit/Param/Attributes.h

@@ -19,7 +19,7 @@
 
 #include <ostream>
 
-//! Attributes for a fit parameter. Currently, the only attribute is fixed/free.
+//! %Attributes for a fit parameter. Currently, the only attribute is fixed/free.
 //! @ingroup fitting
 
 class Attributes {