Comment tweaks

diff --git a/source/geometry/extrudedshape.h b/source/geometry/extrudedshape.h
index bacea7c3e54e208f6ef246bfa4dd719aa2aeb8ac..84addc46e7dde3fee65dea0283f56f2c0b29fc91 100644 (file)
--- a/source/geometry/extrudedshape.h
+++ b/source/geometry/extrudedshape.h
@@ -134,8 +134,8 @@ inline unsigned ExtrudedShape<T, D>::get_intersections(const Ray<T, D> &ray, Sur
 
                        SurfacePoint<T, D-1> *base_points = 0;
                        if(points)
-                               /* Shamelessly reuse the provided storage.  Align to the end of the array
-                               so processing can start from the first (nearest) point. */
+                               /* Shamelessly reuse the provided storage.  Align to the end of the
+                               array so processing can start from the first (nearest) point. */
                                base_points = reinterpret_cast<SurfacePoint<T, D-1> *>(points+size)-size;
 
                        unsigned count = base->get_intersections(base_ray, base_points, size);

diff --git a/source/geometry/halfspace.h b/source/geometry/halfspace.h
index 4adc0dff45694726f399b7a07a3afff0cedcdb2c..518f91ab7ad46979766f25d2ea96deb984cde345 100644 (file)
--- a/source/geometry/halfspace.h
+++ b/source/geometry/halfspace.h
@@ -7,8 +7,8 @@ namespace Msp {
 namespace Geometry {
 
 /**
-An infinite shape consisting of the space on one side of a plane.  Mostly
-useful when composited with other shapes.
+An unbounded shape consisting of the space on one side of a plane.  Mostly
+useful when intersected with other shapes.
 */
 template<typename T, unsigned D>
 class HalfSpace: public Shape<T, D>

diff --git a/source/geometry/intersection.h b/source/geometry/intersection.h
index 01707cdfc64274a79317179fc3faa96348c3c591..7d21f75f81c081e87aeb783710a56aab7fe6207e 100644 (file)
--- a/source/geometry/intersection.h
+++ b/source/geometry/intersection.h
@@ -6,9 +6,6 @@
 namespace Msp {
 namespace Geometry {
 
-/**
-Forms a shape from the common parts of component shapes.
-*/
 template<typename T, unsigned D>
 struct IntersectionOps
 {
@@ -20,6 +17,9 @@ struct IntersectionOps
        static bool combine_surface(bool a, bool b) { return a && b; }
 };
 
+/**
+Forms a shape from the common parts of component shapes.
+*/
 template<typename T, unsigned D>
 class Intersection: public CompositeShape<T, D, IntersectionOps<T, D> >
 {

diff --git a/source/geometry/ray.h b/source/geometry/ray.h
index 6c9a65bf4785c38ae07ab6fc78e4a4337575200b..d8eb7d8405ec75f799226572c5135d08260b978b 100644 (file)
--- a/source/geometry/ray.h
+++ b/source/geometry/ray.h
@@ -7,6 +7,9 @@
 namespace Msp {
 namespace Geometry {
 
+/**
+A directed line segment.  Can be used to point at things.
+*/
 template<typename T, unsigned D>
 class Ray
 {

diff --git a/source/geometry/union.h b/source/geometry/union.h
index 8461f8484ee5d085560b6fb70f522447d9a95c6e..a1562cb4e6b458b55003d981b5898c0c7ded2f25 100644 (file)
--- a/source/geometry/union.h
+++ b/source/geometry/union.h
@@ -6,9 +6,6 @@
 namespace Msp {
 namespace Geometry {
 
-/**
-Joins component shapes together into one.
-*/
 template<typename T, unsigned D>
 struct UnionOps
 {
@@ -20,6 +17,9 @@ struct UnionOps
        static bool combine_surface(bool a, bool b) { return a && !b; }
 };
 
+/**
+Joins component shapes together into one.
+*/
 template<typename T, unsigned D>
 class Union: public CompositeShape<T, D, UnionOps<T, D> >
 {