[brlcad-commits] SF.net SVN: brlcad:[64896] brlcad/trunk/include/bu

[<sta...@us...>]

Revision: 64896
          http://sourceforge.net/p/brlcad/code/64896
Author:   starseeker
Date:     2015-05-07 15:08:41 +0000 (Thu, 07 May 2015)
Log Message:
-----------
Don't define top level groups in headers - that's the responsibility of the top level dox structure files.

Modified Paths:
--------------
    brlcad/trunk/include/bu/cv.h
    brlcad/trunk/include/bu/debug.h
    brlcad/trunk/include/bu/endian.h
    brlcad/trunk/include/bu/file.h
    brlcad/trunk/include/bu/hist.h
    brlcad/trunk/include/bu/log.h
    brlcad/trunk/include/bu/path.h
    brlcad/trunk/include/bu/ptbl.h
    brlcad/trunk/include/bu/vls.h

Modified: brlcad/trunk/include/bu/cv.h
===================================================================
--- brlcad/trunk/include/bu/cv.h	2015-05-07 14:41:18 UTC (rev 64895)
+++ brlcad/trunk/include/bu/cv.h	2015-05-07 15:08:41 UTC (rev 64896)
@@ -85,8 +85,8 @@
 /** @{*/
 /** @file bu/cv.h */
 
-/** @defgroup conv_network_sizes Network Data Sizes */
-/** @addtogroup conv_network_sizes
+/** @defgroup bu_conv_network_sizes Network Data Sizes */
+/** @addtogroup bu_conv_network_sizes
  * Sizes of "network" format data.  We use the same convention as the
  * TCP/IP specification, namely, big-Endian, IEEE format, twos
  * complement.  This is the BRL-CAD external data representation
@@ -111,8 +111,8 @@
 #  define htonll(_val) ntohll(_val)
 #endif
 
-/** @defgroup cv_masks Conversion Bit Masks */
-/** @addtogroup cv_masks
+/** @defgroup bu_cv_masks Conversion Bit Masks */
+/** @addtogroup bu_cv_masks
  * Mask definitions for CV
  */
 /** @{*/
@@ -123,8 +123,8 @@
 #define CV_CONVERT_MASK 0x6000  /* 0110 0000 0000 0000 */
 /** @}*/
 
-/** @defgroup cv_defs Conversion Defines */
-/** @addtogroup cv_defs
+/** @defgroup bu_cv_defs Conversion Defines */
+/** @addtogroup bu_cv_defs
  * Various convenience definitions for CV
  */
 /** @{*/
@@ -294,8 +294,8 @@
 BU_EXPORT extern size_t bu_cv_w_cookie(void *out, int outcookie, size_t size, void *in, int incookie, size_t count);
 
 
-/** @defgroup hton Network Byte-order Conversion */
-/** @addtogroup hton
+/** @defgroup bu_hton Network Byte-order Conversion */
+/** @addtogroup bu_hton
  * Network to host and host to network conversion routines.
  *
  * It is assumed that these routines will only be called if there is
@@ -308,9 +308,9 @@
 /** @brief Convert doubles to host/network format. */
 /** @file libbu/htond.c */
 
-/** @ingroup hton */
-/** @defgroup htond Network Conversion - Doubles */
-/** @addtogroup htond
+/** @ingroup bu_hton */
+/** @defgroup bu_htond Network Conversion - Doubles */
+/** @addtogroup bu_htond
  * Network conversion routines for type double.
  */
 /** @{*/
@@ -325,9 +325,9 @@
 /** @brief convert floats to host/network format */
 /** @file libbu/htonf.c */
 
-/** @ingroup hton */
-/** @defgroup htonf Network Conversion - Floats */
-/** @addtogroup htonf
+/** @ingroup bu_hton */
+/** @defgroup bu_htonf Network Conversion - Floats */
+/** @addtogroup bu_htonf
  * Network conversion routines for type float.
  */
 /** @{*/
@@ -339,9 +339,9 @@
 				  size_t count);
 /** @}*/
 
-/** @ingroup hton */
-/** @defgroup htons Network Conversion - Signed Short */
-/** @addtogroup htons
+/** @ingroup bu_hton */
+/** @defgroup bu_htons Network Conversion - Signed Short */
+/** @addtogroup bu_htons
  * Network to Host Signed Short
  *
  * @param in	generic pointer for input.
@@ -393,8 +393,8 @@
 /** @brief A base64 encoding algorithm */
 /** @file libbu/b64.c */
 
-/** @defgroup cv_b64 Base64 Encoding and Decoding */
-/** @addtogroup cv_b64
+/** @defgroup bu_cv_b64 Base64 Encoding and Decoding */
+/** @addtogroup bu_cv_b64
  * Functions for b64 encoding and decoding.
  */
 /** @{*/

Modified: brlcad/trunk/include/bu/debug.h
===================================================================
--- brlcad/trunk/include/bu/debug.h	2015-05-07 14:41:18 UTC (rev 64895)
+++ brlcad/trunk/include/bu/debug.h	2015-05-07 15:08:41 UTC (rev 64896)
@@ -18,9 +18,6 @@
  * information.
  */
 
-/**  @defgroup io Input/Output */
-/**   @defgroup debug Debugging */
-
 #ifndef BU_DEBUG_H
 #define BU_DEBUG_H
 

Modified: brlcad/trunk/include/bu/endian.h
===================================================================
--- brlcad/trunk/include/bu/endian.h	2015-05-07 14:41:18 UTC (rev 64895)
+++ brlcad/trunk/include/bu/endian.h	2015-05-07 15:08:41 UTC (rev 64896)
@@ -18,12 +18,6 @@
  * information.
  */
 
-/** @defgroup data Data Management */
-/**   @defgroup endian Endian Support */
-
-/** @file endian.h
- *
- */
 #ifndef BU_ENDIAN_H
 #define BU_ENDIAN_H
 
@@ -39,7 +33,9 @@
  */
 /** @{ */
 /** @file libbu/endian.c */
+/** @file bu/endian.h */
 
+
 typedef enum {
     BU_LITTLE_ENDIAN = 1234, /* LSB first: i386, VAX order */
     BU_BIG_ENDIAN    = 4321, /* MSB first: 68000, IBM, network order */

Modified: brlcad/trunk/include/bu/file.h
===================================================================
--- brlcad/trunk/include/bu/file.h	2015-05-07 14:41:18 UTC (rev 64895)
+++ brlcad/trunk/include/bu/file.h	2015-05-07 15:08:41 UTC (rev 64896)
@@ -18,9 +18,6 @@
  * information.
  */
 
-/**  @defgroup io Input/Output */
-/**   @defgroup file File Processing */
-
 #ifndef BU_FILE_H
 #define BU_FILE_H
 

Modified: brlcad/trunk/include/bu/hist.h
===================================================================
--- brlcad/trunk/include/bu/hist.h	2015-05-07 14:41:18 UTC (rev 64895)
+++ brlcad/trunk/include/bu/hist.h	2015-05-07 15:08:41 UTC (rev 64896)
@@ -18,12 +18,6 @@
  * information.
  */
 
-/**  @defgroup data Data Management */
-/**   @defgroup hist Histogram Handling */
-
-/** @file hist.h
- *
- */
 #ifndef BU_HIST_H
 #define BU_HIST_H
 
@@ -47,6 +41,7 @@
  */
 /** @{ */
 /** @file libbu/hist.c */
+/** @file bu/hist.h */
 
 /**
  * histogram support

Modified: brlcad/trunk/include/bu/log.h
===================================================================
--- brlcad/trunk/include/bu/log.h	2015-05-07 14:41:18 UTC (rev 64895)
+++ brlcad/trunk/include/bu/log.h	2015-05-07 15:08:41 UTC (rev 64896)
@@ -18,9 +18,6 @@
  * information.
  */
 
-/**  @defgroup io Input/Output */
-/**   @defgroup log Logging */
-
 #ifndef BU_LOG_H
 #define BU_LOG_H
 

Modified: brlcad/trunk/include/bu/path.h
===================================================================
--- brlcad/trunk/include/bu/path.h	2015-05-07 14:41:18 UTC (rev 64895)
+++ brlcad/trunk/include/bu/path.h	2015-05-07 15:08:41 UTC (rev 64896)
@@ -18,9 +18,6 @@
  * information.
  */
 
-/** @defgroup io Input/Output */
-/** @defgroup path Path Processing */
-
 #ifndef BU_PATH_H
 #define BU_PATH_H
 

Modified: brlcad/trunk/include/bu/ptbl.h
===================================================================
--- brlcad/trunk/include/bu/ptbl.h	2015-05-07 14:41:18 UTC (rev 64895)
+++ brlcad/trunk/include/bu/ptbl.h	2015-05-07 15:08:41 UTC (rev 64896)
@@ -18,9 +18,6 @@
  * information.
  */
 
-/** @defgroup container Data Containers */
-/**   @defgroup ptbl Pointer Tables */
-
 #ifndef BU_PTBL_H
 #define BU_PTBL_H
 

Modified: brlcad/trunk/include/bu/vls.h
===================================================================
--- brlcad/trunk/include/bu/vls.h	2015-05-07 14:41:18 UTC (rev 64895)
+++ brlcad/trunk/include/bu/vls.h	2015-05-07 15:08:41 UTC (rev 64896)
@@ -18,11 +18,6 @@
  * information.
  */
 
-/** @defgroup container Data Containers */
-/**   @defgroup vls Variable-length Strings */
-
-/** @file vls.h
- */
 #ifndef BU_VLS_H
 #define BU_VLS_H
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.