Commit f9bbdd7862e2f15bcd34923852dbef1719329d60

henry 2002-11-28T08:23:56

Changes to Documentation

diff --git a/include/FTSize.h b/include/FTSize.h
index 5964779..d391759 100755
--- a/include/FTSize.h
+++ b/include/FTSize.h
@@ -12,7 +12,7 @@
 /**
  * FTSize class provides an abstraction layer for the Freetype Size.
  *
- * @see "Freetype 2 Documentation - 2.0.4"
+ * @see "Freetype 2 Documentation"
  *
  */
 class FTGL_EXPORT FTSize
diff --git a/include/FTVector.h b/include/FTVector.h
index 9a60a48..97def2a 100644
--- a/include/FTVector.h
+++ b/include/FTVector.h
@@ -1,5 +1,11 @@
+#ifndef    __FTVector__
+#define    __FTVector__
+
 #include "FTGL.h"
 
+/**
+ * Provides a non-STL alternative to the STL vector
+ */
 template <typename FT_VECTOR_ITEM_TYPE>
 class FTGL_EXPORT FTVector
 {
@@ -188,3 +194,5 @@ class FTGL_EXPORT FTVector
         size_type Size;
         value_type* Items;
 };
+
+#endif  //  __FTVector__
diff --git a/include/FTVectoriser.h b/include/FTVectoriser.h
index 5e7da55..be7f61d 100644
--- a/include/FTVectoriser.h
+++ b/include/FTVectoriser.h
@@ -21,7 +21,7 @@
  *
  * @see FTOutlineGlyph
  * @see FTPolyGlyph
- * @see ftPoint
+ * @see FTPoint
  *
  */
 class FTGL_EXPORT FTContour
@@ -87,14 +87,23 @@ class FTGL_EXPORT FTContour
 };
 
 
+/**
+ * FTTesselation captures points that are output by OpenGL's gluTesselator.
+ */
 class FTGL_EXPORT FTTesselation
 {
     public:
+        /**
+         * Default constructor
+         */
         FTTesselation()
         {
             pointList.reserve( 128);
         }
 
+        /**
+         *  Destructor
+         */
         ~FTTesselation()
         {
             pointList.clear();
@@ -118,20 +127,33 @@ class FTGL_EXPORT FTTesselation
 };
 
 
+/**
+ * FTMesh is a container of FTTesselation s that make up a polygon glyph
+ */
 class FTGL_EXPORT FTMesh
 {
     public:
+        /**
+         * Default constructor
+         */
         FTMesh();
+
+        /**
+         *  Destructor
+         */
         ~FTMesh();
         
         void AddPoint( const FTGL_DOUBLE x, const FTGL_DOUBLE y, const FTGL_DOUBLE z);
         void Begin( GLenum m);
         void End();
+        void Error( GLenum e) { err = e;}
         
         FTGL_DOUBLE* Point();
         int size() const;
         
-        void Error( GLenum e) { err = e;}
+        /**
+         * Get the GL ERROR returned by the glu tesselator
+         */
         GLenum Error() const { return err;}
 
         typedef FTVector<FTPoint> PointVector;
@@ -147,6 +169,10 @@ class FTGL_EXPORT FTMesh
          *  The list of points in this mesh
          */
         FTTesselation* tempTess;
+        
+        /**
+         * GL ERROR returned by the glu tesselator
+         */
         GLenum err;
 
 };
@@ -244,7 +270,7 @@ class FTGL_EXPORT FTVectoriser
         
     private:
         /**
-         * Process a conic ( second order bezier curve)
+         * Process a conic ( second order) bezier curve.
          *
          * @param index The index of the current point in the point list.
          * @param first The index into the pointlist of the first point in