Modifications for Programmer's Referens Manual

src/lib/co/src/co_time.c

@@ -47,11 +47,6 @@
   pwr_Assert((p->tv_sec < 0) ? (p->tv_nsec <= 0 && p->tv_nsec > -1000000000) : TRUE);\
 } while (0)
 
-typedef struct {
-  int	  tv_sec;
-  int	  tv_nsec;
-} tTime;
-
 /* String representations of months.  */
 
 static const char *monStr[] =

src/lib/rt/src/rt_errh.c

@@ -121,7 +121,9 @@ static void log_message (errh_sLog*, char, char*, va_list);
 static int msg_vsprintf (char *, const char *, aa_list, va_list);
 
 #if defined(OS_LYNX) || defined(OS_LINUX) || defined(OS_ELN)
- static size_t strnlen (const char*, size_t);
+ static size_t errh_strnlen (const char*, size_t);
+#else
+#define errh_strnlen strnlen
 #endif
 
 static unsigned int do_div (int*, unsigned int);
@@ -818,7 +820,7 @@ repeat:
       if (!s)
         s = "<NULL>";
 
-      len = strnlen(s, precision);
+      len = errh_strnlen(s, precision);
 
       if (!(flags & LEFT))
         while (len < field_width--)
@@ -907,7 +909,7 @@ repeat:
    whatever comes true first.  */
 
 static size_t
-strnlen (
+errh_strnlen (
   const char  *s,
   size_t      count
 )

src/lib/rt/src/rt_mh_appl.c

@@ -27,6 +27,7 @@
 #include "rt_mh_util.h"
 #include "rt_errh.h"
 
+//! Application context.
 typedef struct {
   mh_sHead	head;
   qcom_sQid	handler;

src/lib/rt/src/rt_qcom.h

@@ -129,9 +129,7 @@ static const qcom_sQid qcom_cQhdClient		= {qcom_cIhdClient, 0};
 static const qcom_sQid qcom_cQnacp		= {qcom_cInacp, 0};
 static const qcom_sQid qcom_cQini		= {qcom_cIini, 0};
 
-/**
- * ZZZ
- */
+//! Application identity
 typedef struct {
   qcom_tAix	aix;		/**< Application index */
   pwr_tNodeId	nid;		/**< Node identity */
@@ -139,27 +137,32 @@ typedef struct {
 
 static const qcom_sAid qcom_cNAid = {0, 0};
 
+//! Qcom application
 typedef struct {
   qcom_sAid	aid;
   pid_t		pid;
 } qcom_sAppl;
 
+//! Qcom event
 typedef struct {
   qcom_sAid	aid;
   pid_t		pid;
   int		mask;
 } qcom_sEvent;
 
+//! Queue attributes
 typedef struct {
   qcom_eQtype	type;
   unsigned int	quota;
 } qcom_sQattr;
 
+//! Qcom type
 typedef struct {
   qcom_eBtype	b;
   qcom_eStype	s;
 } qcom_sType;
 
+//! Put data structure.
 typedef struct {
   qcom_sQid	reply;
   qcom_sType	type;
@@ -167,6 +170,7 @@ typedef struct {
   void		*data;
 } qcom_sPut;
 
+//! Get data structure
 typedef struct {
   qcom_sAid	sender;
   pid_t		pid;
@@ -179,8 +183,10 @@ typedef struct {
   void		*data;
 } qcom_sGet;
 
+//! Node status
 typedef union {
   pwr_tBitMask m;
+  //! Bitmask representation
   pwr_32Bits (
     pwr_Bits( initiated	, 1),
     pwr_Bits( connected	, 1),
@@ -203,17 +209,16 @@ typedef union {
 
 } qcom_mNode;
 
-/**
- * Strucure describing a node ???
- */
+
+//! Data for a Qcom node.
 typedef struct {
-  pwr_tNodeId	nid;		/**< node index */
-  qcom_mNode	flags;		/**< node flags */
-  char		name[80];       /**< node name */
-  co_eOS	os;		/**< operating system */
-  co_eHW	hw;		/**< hardware */ 
-  co_eBO	bo;		/**< big/little endian */
-  co_eFT	ft;		/**< float type */
+  pwr_tNodeId	nid;		//!< node index
+  qcom_mNode	flags;		//!< node flags
+  char		name[80];       //!< node name
+  co_eOS	os;		//!< operating system
+  co_eHW	hw;		//!< hardware
+  co_eBO	bo;		//!< big/little endian
+  co_eFT	ft;		//!< float type
 } qcom_sNode;