Add Doxygen file tags to all headers except Defines.h.

Author: jimmysoda

source/pdal/capi/DimType.h

@@ -7,6 +7,11 @@
 
 #include "Forward.h"
 
+/**
+ * @file DimType.h
+ * Functions to inspect dimension types.
+ */
+
 #ifdef __cplusplus
 
 namespace pdal

source/pdal/capi/Forward.h

@@ -15,6 +15,11 @@
 #define PDAL_C_API PDAL_C_IMPORT_API
 #endif
 
+/**
+ * @file Forward.h
+ * Forward declarations for the PDAL C API.
+ */
+
 #ifdef __cplusplus
 #include <memory>
 #include <set>

source/pdal/capi/Pipeline.h

@@ -6,6 +6,11 @@
 
 #include "Forward.h"
 
+/**
+ * @file Pipeline.h
+ * Functions to launch and inspect the results of a pipeline.
+ */
+
 #ifdef __cplusplus
 
 namespace pdal

source/pdal/capi/PointLayout.h

@@ -7,6 +7,12 @@
 
 #include "Forward.h"
 
+/**
+ * @file PointLayout.h
+ * Functions to inspect the contents of a point layout.
+ */
+
+
 #ifdef __cplusplus
 namespace pdal
 {

source/pdal/capi/PointView.h

@@ -6,6 +6,11 @@
 
 #include "Forward.h"
 
+/**
+ * @file PointView.h
+ * Functions to inspect the contents of a point view.
+ */
+
 #ifdef __cplusplus /* __cplusplus */
 
 namespace pdal

source/pdal/capi/PointViewIterator.h

@@ -6,6 +6,11 @@
 
 #include "Forward.h"
 
+/**
+ * @file PointViewIterator.h
+ * Functions to inspect the contents of a point view iterator.
+ */
+
 #ifdef __cplusplus
 #include <pdal/PointView.hpp>