[INC] cosmetic changes for docs auto generation

git-svn-id: svn://openib.tc.cornell.edu/gen1@540 ad392aa1-c5ef-ae45-8dd8-e69d62a5ef86

diff --git a/trunk/inc/complib/comp_lib.h b/trunk/inc/complib/comp_lib.h
index ce439e0b88cdce52cef9cd0ec9a21cd2cc06d491..39f5e0cb267eff99c487be81e51775f7b7df89dd 100644 (file)
--- a/trunk/inc/complib/comp_lib.h
+++ b/trunk/inc/complib/comp_lib.h
@@ -44,9 +44,9 @@
 #define _CL_LIB_H_\r
 \r
 \r
-/****h* Component Library/Overview\r
+/****h* Component Library/Component Library \r
 * NAME\r
-*      Overview\r
+*      component library \r
 *\r
 * DESCRIPTION\r
 *      The component library is a collection of components that can be used to\r

diff --git a/trunk/inc/kernel/iba/ib_al_ifc.h b/trunk/inc/kernel/iba/ib_al_ifc.h
index c28bc9ff00939621e5d9b0c5089a69b04483198d..7b15737feac8c333b14dc9206139f783a9143dba 100644 (file)
--- a/trunk/inc/kernel/iba/ib_al_ifc.h
+++ b/trunk/inc/kernel/iba/ib_al_ifc.h
@@ -38,9 +38,9 @@
 #include <iba/ib_al.h>\r
 \r
 \r
-/****h* Access Layer/ib_al_ifc.h\r
+/****h* Access Layer/AL Interface\r
 * NAME\r
-*      ib_al_ifc.h\r
+*      AL Interface\r
 *\r
 * DESCRIPTION\r
 *      Header file for the interface exported to ICT client drivers for access to\r

diff --git a/trunk/inc/kernel/iba/ib_ci_ifc.h b/trunk/inc/kernel/iba/ib_ci_ifc.h
index e5c1bab4fdd45abe6bd7bc90db55ff405dbe452d..00ceaf94fc9a2eb34f551a008acbe3ef50d07302 100644 (file)
--- a/trunk/inc/kernel/iba/ib_ci_ifc.h
+++ b/trunk/inc/kernel/iba/ib_ci_ifc.h
@@ -38,9 +38,9 @@
 #include "iba/ib_ci.h"\r
 \r
 \r
-/****h* Access Layer/ib_ci_ifc.h\r
+/****h* Access Layer/AL Channel Interface\r
 * NAME\r
-*      ib_ci_ifc.h\r
+*      AL Channel Interface\r
 *\r
 * DESCRIPTION\r
 *      Header file for the interface exported to HCA drivers to allow them\r
@@ -78,9 +78,18 @@ typedef const char*
        IN                              ib_api_status_t                         status );\r
 \r
 \r
+\r
+/****s* Access Layer: AL Channel Interface/ib_ci_ifc_t\r
+* NAME\r
+*      ib_ci_ifc_t\r
+*\r
+* DESCRIPTION\r
+*      \r
+* SYNOPSIS\r
+*/\r
 typedef struct _ib_ci_ifc\r
 {\r
-       /* Standard interface header. */\r
+\r
        INTERFACE                               wdm;\r
 \r
        ib_pfn_register_ca_t    register_ca;\r
@@ -89,6 +98,26 @@ typedef struct _ib_ci_ifc
        ib_pfn_get_err_str_t    get_err_str;\r
 \r
 }      ib_ci_ifc_t;\r
+/*\r
+* FIELDS\r
+*      wdmr.\r
+*              Standard interface header.\r
+*\r
+*      register_ca\r
+*              Pointer  to ib_pfn_register_ca_t function\r
+*\r
+*      deregister_ca\r
+*              Pointer  to ib_pfn_deregister_ca_t function\r
+*\r
+*      get_relations\r
+*              Pointer  to ib_pfn_get_relations_t function\r
+*\r
+*      get_err_str\r
+*              Pointer  to ib_pfn_get_err_str_t function\r
+*\r
+* SEE ALSO\r
+*      ib_register_ca,ib_deregister_ca,\r
+*********/\r
 \r
 \r
 #endif /* !defined _IB_CI_IFC_H_ */\r

diff --git a/trunk/inc/kernel/iba/ioc_ifc.h b/trunk/inc/kernel/iba/ioc_ifc.h
index 990f88ddcfe04c881338bc6073858b2134cd3b75..6ea9328bf42cc02127d8023e6e65c92afcb8f432 100644 (file)
--- a/trunk/inc/kernel/iba/ioc_ifc.h
+++ b/trunk/inc/kernel/iba/ioc_ifc.h
@@ -38,9 +38,9 @@
 #define _IOC_IFC_H_\r
 \r
 \r
-/****h* Access Layer/ioc_ifc.h\r
+/****h* Access Layer/IO Controler Interface\r
 * NAME\r
-*      ioc_ifc.h\r
+*      IO Controler Interface\r
 *\r
 * DESCRIPTION\r
 *      Header file for the interface exported to IOC client drivers to retrieve\r
@@ -53,13 +53,35 @@
 #define IOC_INTERFACE_DATA_VERSION             (3)\r
 \r
 \r
-/* Interface definitions */\r
+\r
+/****s* Access Layer: IO Controler Interface/ioc_ifc_data_t\r
+* NAME\r
+*      ioc_ifc_data_t\r
+*\r
+* DESCRIPTION\r
+*      I/O Controler interface data.\r
+*\r
+*      The ioc_ifc_data_t structure \r
+*\r
+* SYNOPSIS\r
+*/\r
 typedef struct _ioc_ifc_data\r
 {\r
        net64_t                                 ca_guid;\r
        net64_t                                 guid;\r
 \r
 }      ioc_ifc_data_t;\r
+/*\r
+* FIELDS\r
+*      ca_guid\r
+*              Local CA GUID through which IOC is accessible.\r
+*\r
+*      guid\r
+*              IOC GUID.\r
+*\r
+* SEE ALSO\r
+*      \r
+*********/\r
 \r
 \r
 #endif /* !defined _IOC_IFC_H_ */\r

diff --git a/trunk/inc/kernel/iba/iou_ifc.h b/trunk/inc/kernel/iba/iou_ifc.h
index 44c5c2c9bec988158d6180bd749977c424d480a3..2741397a5621714557f979097363cb46d2c2e21b 100644 (file)
--- a/trunk/inc/kernel/iba/iou_ifc.h
+++ b/trunk/inc/kernel/iba/iou_ifc.h
@@ -38,9 +38,9 @@
 #define _IOU_IFC_H_\r
 \r
 \r
-/****h* Access Layer/iou_ifc.h\r
+/****h* Access Layer/ IO Unit Interface\r
 * NAME\r
-*      iou_ifc.h\r
+*      IO Unit Interface\r
 *\r
 * DESCRIPTION\r
 *      Header file for the interface exported to IOU client drivers to retrieve\r
@@ -53,21 +53,43 @@
 #define IOU_INTERFACE_DATA_VERSION             (4)\r
 \r
 \r
-/* Interface definitions */\r
+\r
+/****s* Access Layer: IO Unit Interface/iou_ifc_data_t\r
+* NAME\r
+*      iou_ifc_data_t\r
+*\r
+* DESCRIPTION\r
+*      I/O Unit interface data.\r
+*\r
+*      The iou_ifc_data_t structure \r
+*\r
+* SYNOPSIS\r
+*/\r
 typedef struct _iou_ifc_data\r
 {\r
-       /* Local CA GUID through which IOU is accessible. */\r
        net64_t                                 ca_guid;\r
-\r
-       /* Chassis GUID and slot number */\r
        net64_t                                 chassis_guid;\r
        uint8_t                                 slot;\r
-\r
-       /* IOU GUID. */\r
-       net64_t                                 guid;\r
+       net64_t                                 guid;\r
 \r
 }      iou_ifc_data_t;\r
-\r
+/*\r
+* FIELDS\r
+*      ca_guid\r
+*              Local CA GUID through which IOU is accessible.\r
+*\r
+*      chassis_guid\r
+*              IOU chassis GUID.\r
+*\r
+*      slot\r
+*              IOU  slot.\r
+*\r
+*      guid\r
+*              IOU  GUID.\r
+*\r
+* SEE ALSO\r
+*      \r
+*********/\r
 \r
 #endif /* !defined _IOU_IFC_H_ */\r
 \r

diff --git a/trunk/inc/kernel/iba/ipoib_ifc.h b/trunk/inc/kernel/iba/ipoib_ifc.h
index f680f775bd486b0413800f118114406d2b133e78..f19d0c112c350483f0845604b73e6af6d2cbc0f0 100644 (file)
--- a/trunk/inc/kernel/iba/ipoib_ifc.h
+++ b/trunk/inc/kernel/iba/ipoib_ifc.h
@@ -38,9 +38,9 @@
 #define _IPOIB_IFC_H_\r
 \r
 \r
-/****h* Access Layer/ipoib_ifc.h\r
+/****h* Access Layer/IPoIB Interface\r
 * NAME\r
-*      ipoib_ifc.h\r
+*      IPoIB Interface\r
 *\r
 * DESCRIPTION\r
 *      Header file for the interface exported to IPoIB client drivers for access\r
@@ -54,15 +54,39 @@
 #define IPOIB_INTERFACE_DATA_VERSION           (5)\r
 \r
 \r
-/* Interface definitions */\r
+/****s* Access Layer: IPoIB Interface/ipoib_ifc_data_t\r
+* NAME\r
+*      ipoib_ifc_data_t\r
+*\r
+* DESCRIPTION\r
+*      IPoIB interface datat.\r
+*\r
+*      The ipoib_ifc_data_t structure \r
+*\r
+* SYNOPSIS\r
+*/\r
 typedef struct _ipoib_ifc_data\r
 {\r
-       /* HCA and Port GUID */\r
        net64_t                                         ca_guid;\r
        net64_t                                         port_guid;\r
        uint8_t                                         port_num;\r
 \r
 }      ipoib_ifc_data_t;\r
+/*\r
+* FIELDS\r
+*      ca_guid\r
+*              HCA GUID for this IPoIB interface\r
+*\r
+*      port_guid\r
+*              Port GUID for this IPoIB interface\r
+*\r
+*      port_num\r
+*              Port Number GUID for this IPoIB interface\r
+*\r
+* SEE ALSO\r
+*      \r
+*********/\r
+\r
 \r
 \r
 #endif /* !defined _IPOIB_IFC_H_ */\r

diff --git a/trunk/inc/user/iba/ib_uvp.h b/trunk/inc/user/iba/ib_uvp.h
index edc98154cdf78d604d308d08495984078818c268..495c17123ecdd376d4a32ab76596fb71f6f8cc59 100644 (file)
--- a/trunk/inc/user/iba/ib_uvp.h
+++ b/trunk/inc/user/iba/ib_uvp.h
@@ -37,7 +37,7 @@
 #include <iba/ib_types.h>\r
 #include <iba/ib_ci.h>\r
 \r
-/****h* UAL_UVP_Interface/Overview user-mode Verbs\r
+/****h* UAL_UVP_Interface/user-mode Verbs\r
 * NAME\r
 *      User-mode Verbs -- User-mode Verbs implements the HCA specific\r
 *      user-mode functions to plug in to the Usermode Access Layer\r

diff --git a/trunk/ulp/opensm/user/include/iba/ib_types.h b/trunk/ulp/opensm/user/include/iba/ib_types.h
index 136c673f3b6b79cbab89706994c55fe17693bc74..f14ffc68a12753a5aa7cb3922d74302951008678 100644 (file)
--- a/trunk/ulp/opensm/user/include/iba/ib_types.h
+++ b/trunk/ulp/opensm/user/include/iba/ib_types.h
@@ -9793,4 +9793,5 @@ END_C_DECLS
     #include <iba/ib_types_extended.h>
 #endif
 
-#endif // __IB_TYPES_H__
+#endif /* __IB_TYPES_H__ */
+