Clean-up/standardize a few header files

include/errno.h

@@ -379,11 +379,11 @@
 #define ECANCELED_STR       "Operation cancelled"
 
 /************************************************************************
- * Type Declarations
+ * Public Type Definitions
  ************************************************************************/
 
 /************************************************************************
- * Global Function Prototypes
+ * Public Function Prototypes
  ************************************************************************/
 
 #undef EXTERN

include/mqueue.h

@@ -51,7 +51,7 @@
 #define MQ_NONBLOCK O_NONBLOCK
 
 /********************************************************************************
- * Global Type Declarations
+ * Public Type Declarations
  ********************************************************************************/
 
 /* Message queue attributes */

include/pthread.h

@@ -148,7 +148,7 @@
   prctl((int)PR_GET_NAME, (char*)name, (int)thread)
 
 /********************************************************************************
- * Global Type Declarations
+ * Public Type Definitions
  ********************************************************************************/
 
 #ifdef __cplusplus
@@ -241,11 +241,11 @@ typedef bool pthread_once_t;
 struct sched_param; /* Defined in sched.h */
 
 /********************************************************************************
- * Global Variables
+ * Public Data
  ********************************************************************************/
 
 /********************************************************************************
- * Global Function Prototypes
+ * Public Function Prototypes
  ********************************************************************************/
 
 /* Initializes a thread attributes object (attr) with default values for all of
@@ -414,4 +414,3 @@ int pthread_sigmask(int how, FAR const sigset_t *set, FAR sigset_t *oset);
 #endif
 
 #endif /* __INCLUDE_PTHREAD_H */
-

include/queue.h

@@ -60,7 +60,7 @@
 #define dq_peek(q)  ((q)->head)
 
 /****************************************************************************
- * Global Type Declarations
+ * Public Type Definitions
  ****************************************************************************/
 
 struct sq_entry_s
@@ -91,7 +91,7 @@ struct dq_queue_s
 typedef struct dq_queue_s dq_queue_t;
 
 /****************************************************************************
- * Global Function Prototypes
+ * Public Function Prototypes
  ****************************************************************************/
 
 #ifdef __cplusplus

include/sched.h

@@ -53,7 +53,7 @@
 
 /* POSIX-like scheduling policies */
 
-#define SCHED_FIFO       1  /* FIFO per priority scheduling policy */
+#define SCHED_FIFO       1  /* FIFO priority scheduling policy */
 #define SCHED_RR         2  /* Round robin scheduling policy */
 #define SCHED_SPORADIC   3  /* Sporadic scheduling policy */
 #define SCHED_OTHER      4  /* Not supported */

include/signal.h

@@ -183,7 +183,7 @@
 #endif
 
 /********************************************************************************
- * Global Type Declarations
+ * Public Type Definitions
  ********************************************************************************/
 
 /* This defines a set of 32 signals (numbered 0 through 31). */
@@ -251,11 +251,11 @@ struct sigaction
 #define sa_sigaction sa_u._sa_sigaction
 
 /********************************************************************************
- * Global Variables
+ * Public Data
  ********************************************************************************/
 
 /********************************************************************************
- * Global Function Prototypes
+ * Public Function Prototypes
  ********************************************************************************/
 
 #ifdef __cplusplus
@@ -297,4 +297,3 @@ int sigqueue(int pid, int signo, FAR void *sival_ptr);
 #endif
 
 #endif /* __INCLUDE_SIGNAL_H */
-

include/stdlib.h

@@ -49,9 +49,9 @@
  * Pre-processor Definitions
  ****************************************************************************/
 
-/* The C standard specifies two constants, EXIT_SUCCESS and
+/* The C standard specifies two constants, EXIT_SUCCESS and EXIT_FAILURE,
- * EXIT_FAILURE, that may be passed to exit() to indicate
+ * that may be passed to exit() to indicate successful or unsuccessful
- * successful or unsucessful termination, respectively.
+ * termination, respectively.
  */
 
 #define EXIT_SUCCESS 0
@@ -71,9 +71,8 @@
 
 #define MB_CUR_MAX 1
 
-/* The environ variable, normally 'extern char **environ;' is
+/* The environ variable, normally 'char **environ;' is not implemented as a
- * not implemented as a function call.  However, get_environ_ptr()
+ * function call.  However, get_environ_ptr() can be used in its place.
- * can be used in its place.
  */
 
 #ifndef CONFIG_DISABLE_ENVIRON
@@ -81,7 +80,7 @@
 #endif
 
 /****************************************************************************
- * Global Type Definitions
+ * Public Type Definitions
  ****************************************************************************/
 
 struct mallinfo
@@ -97,11 +96,7 @@ struct mallinfo
 };
 
 /****************************************************************************
- * Global Function Prototypes
+ * Public Function Prototypes
- ****************************************************************************/
-
-/****************************************************************************
- * Global Function Prototypes
  ****************************************************************************/
 
 #undef EXTERN

include/string.h

@@ -56,7 +56,7 @@
 #define bcopy(b1,b2,len) (void)memmove(b2,b1,len)
 
 /****************************************************************************
- * Global Function Prototypes
+ * Public Function Prototypes
  ****************************************************************************/
 
 #undef EXTERN

include/unistd.h

@@ -113,7 +113,7 @@
 #define HOST_NAME_MAX 32
 
 /****************************************************************************
- * Global Variables
+ * Public Data
  ****************************************************************************/
 
 #undef EXTERN
@@ -133,7 +133,7 @@ extern "C"
 #ifndef __NXFLAT__
 EXTERN FAR char *optarg; /* Optional argument following option */
 EXTERN int       optind; /* Index into argv */
-EXTERN int       optopt; /* unrecognized option character */
+EXTERN int       optopt; /* Unrecognized option character */
 #else
 #  define optarg  (*(getoptargp()))
 #  define optind  (*(getoptindp()))
@@ -141,7 +141,7 @@ EXTERN int       optopt; /* unrecognized option character */
 #endif
 
 /****************************************************************************
- * Global Function Prototypes
+ * Public Function Prototypes
  ****************************************************************************/
 
 /* Task Control Interfaces */
@@ -205,7 +205,7 @@ int     getopt(int argc, FAR char *const argv[], FAR const char *optstring);
 
 FAR char **getoptargp(void); /* Optional argument following option */
 int       *getoptindp(void); /* Index into argv */
-int       *getoptoptp(void); /* unrecognized option character */
+int       *getoptoptp(void); /* Unrecognized option character */
 
 #ifdef CONFIG_NET
 int     gethostname(FAR char *name, size_t size);