Header file clean-up

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@4948 42af7a65-404d-4744-a932-0658087f49c3

ChangeLog

@@ -3015,4 +3015,5 @@
 	  to make a little room in the file name space.
 	* arch/arm/src/stm32/stm32_exti_alarm.c:  Add initial logic to attached the
 	  RTC alarm EXTI interrupt.  This is work be performed mostly by Diego Sanchez.
+	* include/: More stylistic file clean-up.
 

configs/lpc4330-xplorer/README.txt

@@ -381,8 +381,35 @@ Code Red IDE
     CONFIG_DEBUG=y
     CONFIG_DEBUG_SYMBOLS=y
 
-  Troubleshooting.  This page provides some troubleshooting information that
+  NOTE 4: Every time that you control-C out of the command line GDB, you
-  you can use to verify that the LPCLink is working correctly:
+  leave a copy of the Code Red debugger (crt_emu_lpc18_43_nxp) running.  I
+  have found that if you have these old copies of the debugger running, 
+  hen strange things can happen when start yet another copy of the
+  debugger (I suspect that GDB may be talking with the wrong debugger).
+
+  If you exit GDB with quit (not control-C), it seems to clean-up okay.
+  But I have taken to keeping a Process Explorer window open all of the
+  time to keep track of how many of these bad processes have been created.
+
+  NOTE 5: There is also a certain function that is causing some problems.
+  The very first thing that the start-up logic does is call a function
+  called lpc43_softreset() which resets most of the peripherals.  But it
+  also causes some crashes... I think because the resets are causing some
+  interrupts.
+
+  I put a big delay in the soft reset logic between resetting and clearing
+  pending interrupts  and that seems to help some but I am not confident
+  that that is a fix.  I think that the real fix might be to just eliminated
+  this lpc43_softreset() function if we determine that it is not needed.
+
+  If you step over lpc43_softreset() after loading the coding (using the 'n'
+  command), then everything seems work okay.
+
+  Troubleshooting
+  ---------------
+
+  This page provides some troubleshooting information that you can use to
+  verify that the LPCLink is working correctly:
 
     http://support.code-red-tech.com/CodeRedWiki/LPCLinkDiagnostics
 
@@ -394,6 +421,11 @@ Code Red IDE
   found in the configs/lpc4330-xplorer/scripts directory can do that with
   a single command line command.
 
+  USB DFU Booting
+  ---------------
+
+  To be provided.
+
 NuttX buildroot Toolchain
 =========================
 

include/arpa/inet.h

@@ -2,7 +2,7 @@
  * include/arpa/inet.h
  *
  *   Copyright (C) 2007, 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __ARPA_INET_H
+#ifndef __INCLUDE_ARPA_INET_H
-#define __ARPA_INET_H
+#define __INCLUDE_ARPA_INET_H
 
 /****************************************************************************
  * Included Files
@@ -133,4 +133,4 @@ EXTERN const char *inet_ntop(int af, FAR const void *src, FAR char *dst, socklen
 }
 #endif
 
-#endif /* __ARPA_INET_H */
+#endif /* __INCLUDE_ARPA_INET_H */

include/crc32.h

@@ -2,7 +2,7 @@
  * include/crc.h
  *
  *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -54,23 +54,24 @@ extern "C" {
 #define EXTERN extern
 #endif
 
-/************************************************************************************
+/****************************************************************************
  * Name: crc32part
  *
  * Description:
  *   Continue CRC calculation on a part of the buffer.
  *
- ************************************************************************************/
+ ****************************************************************************/
 
-EXTERN uint32_t crc32part(FAR const uint8_t *src, size_t len, uint32_t crc32val);
+EXTERN uint32_t crc32part(FAR const uint8_t *src, size_t len,
+                          uint32_t crc32val);
 
-/************************************************************************************
+/****************************************************************************
  * Name: crc32
  *
  * Description:
  *   Return a 32-bit CRC of the contents of the 'src' buffer, length 'len'
  *
- ************************************************************************************/
+ ****************************************************************************/
 
 EXTERN uint32_t crc32(FAR const uint8_t *src, size_t len);
 

include/ctype.h

@@ -2,7 +2,7 @@
  * include/ctype.h
  *
  *   Copyright (C) 2007-2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -36,10 +36,9 @@
 #ifndef __INCLUDE_CTYPE_H
 #define __INCLUDE_CTYPE_H
 
-/* There is no consistent ctype implementation, just a
+/* There is no consistent ctype implementation, just a smattering of
- * smattering of functions.  Individually, they are okay, but
+ * functions.  Individually, they are okay, but a more standard, data lookup
- * a more standard, data lookup approach would make more sense
+ * approach would make more sense if used extensively.
- * if used extensively.
  */
 
 /****************************************************************************
@@ -51,13 +50,12 @@
  ****************************************************************************/
 
 /****************************************************************************
- * Function:  isspace
+ * Name: isspace
  *
  * Description:
- * Checks  for  white-space characters.  In the "C" and "POSIX"
+ *   Checks  for  white-space characters.  In the "C" and "POSIX" locales,
- * locales, these are: space, form-feed ('\f'), newline ('\n'),
+ *   these are: space, form-feed ('\f'), newline ('\n'), carriage return
- * carriage return ('\r'), horizontal tab ('\t'), and vertical
+ *   ('\r'), horizontal tab ('\t'), and vertical tab ('\v').
- * tab ('\v').
  *
  ****************************************************************************/
 
@@ -66,113 +64,112 @@
    (c) == '\r' || (c) == '\f' || c== '\v')
 
 /****************************************************************************
- * Function:  isascii
+ * Name: isascii
  *
  * Description:
- *  Checks whether c is a 7-bit unsigned char value that
+ *   Checks whether c is a 7-bit unsigned char value that fits into the
- *  fits into the ASCII character set.
+ *   ASCII character set.
  *
  ****************************************************************************/
 
 #define isascii(c)   ((c) >= 0 && (c) <= 0x7f);
 
 /****************************************************************************
- * Function:  isprint
+ * Name: isprint
  *
  * Description:
- *  Checks for a printable character (including space)
+ *   Checks for a printable character (including space)
  *
  ****************************************************************************/
 
 #define isprint(c)   ((c) >= 0x20 && (c) < 0x7f)
 
 /****************************************************************************
- * Function:  isgraph
+ * Name: isgraph
  *
  * Description:
- *  Checks for a printable character (excluding space)
+ *   Checks for a printable character (excluding space)
  *
  ****************************************************************************/
 
 #define isgraph(c)   ((c) > 0x20 && (c) < 0x7f)
 
 /****************************************************************************
- * Function:  iscntrl
+ * Name: iscntrl
  *
  * Description:
- *  Checks for control character.
+ *   Checks for control character.
  *
  ****************************************************************************/
 
 #define iscontrol(c) (!isprint(c))
 
 /****************************************************************************
- * Function:  islower
+ * Name: islower
  *
  * Description:
- *    Checks for an lowercase letter.
+ *   Checks for an lowercase letter.
  *
  ****************************************************************************/
 
 #define islower(c)   ((c) >= 'a' && (c) <= 'z')
 
 /****************************************************************************
- * Function:  isupper
+ * Name: isupper
  *
  * Description:
- *    Checks for an uppercase letter.
+ *   Checks for an uppercase letter.
  *
  ****************************************************************************/
 
 #define isupper(c)   ((c) >= 'A' && (c) <= 'Z')
 
 /****************************************************************************
- * Function:  isalpha
+ * Name: isalpha
  *
  * Description:
- *    Checks for an alphabetic character
+ *   Checks for an alphabetic character
  *
  ****************************************************************************/
 
 #define isalpha(c)   (islower(c) || isupper(c))
 
 /****************************************************************************
- * Function:  isdigit
+ * Name: isdigit
  *
  * Description:
- *    ANSI standard isdigit implementation.
+ *   ANSI standard isdigit implementation.
  *
  ****************************************************************************/
 
 #define isdigit(c)   ((c) >= '0' && (c) <= '9')
 
 /****************************************************************************
- * Function:  isalnum
+ * Name: isalnum
  *
  * Description:
- *    Checks for an alphanumeric character
+ *   Checks for an alphanumeric character
  *
  ****************************************************************************/
 
 #define isalnum(c)   (isalpha(c) || isdigit(c))
 
 /****************************************************************************
- * Function:  ispunct
+ * Name: ispunct
  *
  * Description:
- *  Checks for a printable character which is not a space
+ *   Checks for a printable character which is not a space or an
- *  or an alphanumeric character
+ *   alphanumeric character
  *
  ****************************************************************************/
 
 #define ispunct(c)   (isgraph(c) && !isalnum(c))
 
 /****************************************************************************
- * Function:  isxdigit
+ * Name: isxdigit
  *
  * Description:
- *   isxdigit() checks for a hexadecimal digits, i.e. one of
+ *   isxdigit() checks for a hexadecimal digits, i.e. one of {0-9,a-f,A-F}
- *   {0-9,a-f,A-F}
  *
  ****************************************************************************/
 
@@ -182,7 +179,7 @@
    ((c) >= 'A' && (c) <= 'F'))
 
 /****************************************************************************
- * Function:  toupper
+ * Name: toupper
  *
  * Description:
  *   toupper() converts the letter c to upper case, if possible.
@@ -193,7 +190,7 @@
   (((c) >= 'a' && (c) <= 'z') ? ((c) - 'a' + 'A') : (c))
 
 /****************************************************************************
- * Function:  tolower
+ * Name: tolower
  *
  * Description:
  *   tolower() converts the letter c to lower case, if possible.

include/cxx/cassert

@@ -2,7 +2,7 @@
 // include/cxx/cassert
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/cxx/cctype

@@ -2,7 +2,7 @@
 // include/cxx/cctype
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/cxx/cerrno

@@ -2,7 +2,7 @@
 // include/cxx/cerrno
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/cxx/climits

@@ -2,7 +2,7 @@
 // include/cxx/climits
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/cxx/cmath

@@ -2,7 +2,7 @@
 // include/cxx/cmath
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/cxx/csignal

@@ -2,7 +2,7 @@
 // include/cxx/csignal
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/cxx/cstdbool

@@ -2,7 +2,7 @@
 // include/cxx/cstdbool
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/cxx/cstdio

@@ -2,7 +2,7 @@
 // include/cxx/cstdio
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/cxx/cstring

@@ -2,7 +2,7 @@
 // include/cxx/cstring
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/cxx/ctime

@@ -2,7 +2,7 @@
 // include/cxx/ctime
 //
 //   Copyright (C) 2009 Gregory Nutt. All rights reserved.
-//   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+//   Author: Gregory Nutt <gnutt@nuttx.org>
 //
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions

include/debug.h

@@ -2,7 +2,7 @@
  * include/debug.h
  *
  *   Copyright (C) 2007-2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -579,10 +579,10 @@ extern "C" {
 #define EXTERN extern
 #endif
 
-/* These low-level debug APIs are provided by the NuttX library.  If
+/* These low-level debug APIs are provided by the NuttX library.  If the
- * the cross-compiler's pre-processor supports a variable number of
+ * cross-compiler's pre-processor supports a variable number of macro
- * macro arguments, then the macros above will map all debug statements
+ * arguments, then the macros below will map all debug statements to one
- * on or the other of the following.
+ * or the other of the following.
  */
 
 EXTERN int lib_rawprintf(FAR const char *format, ...);
@@ -602,8 +602,8 @@ EXTERN void lib_dumpbuffer(FAR const char *msg, FAR const uint8_t *buffer,
 EXTERN void dbg_enable(bool enable);
 #endif
 
-/* If the cross-compiler's pre-processor does not support variable
+/* If the cross-compiler's pre-processor does not support variable length
- * length arguments, then these additional APIs will be built.
+ * arguments, then these additional APIs will be built.
  */
 
 #ifndef CONFIG_CPP_HAVE_VARARGS

include/dirent.h

@@ -2,7 +2,7 @@
  * include/dirent.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -69,10 +69,9 @@
  * Public Type Definitions
  ****************************************************************************/
 
-/* The POSIX specification requires that the caller of readdir_r
+/* The POSIX specification requires that the caller of readdir_r provide
- * provide storage "large enough for a dirent with the d_name
+ * storage "large enough for a dirent with the d_name member and an array
- * member and an array of char containing at least {NAME_MAX}
+ * of char containing at least {NAME_MAX} plus one elements.
- * plus one elements.
  */
 
 struct dirent

include/errno.h

@@ -2,7 +2,7 @@
  * include/errno.h
  *
  *   Copyright (C) 2007-2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/fixedmath.h

@@ -2,7 +2,7 @@
  * include/fixedmath.h
  *
  *   Copyright (C) 2008 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/inttypes.h

@@ -2,7 +2,7 @@
  * include/inttypes.h
  *
  *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/libgen.h

@@ -2,7 +2,7 @@
  * include/libgen.h
  *
  *   Copyright (C) 2007, 2008 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/limits.h

@@ -2,7 +2,7 @@
  * include/limits.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/mqueue.h

@@ -1,8 +1,8 @@
 /********************************************************************************
- * ionclude/mqueue.h
+ * include/mqueue.h
  *
  *   Copyright (C) 2007, 2008 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -107,4 +107,3 @@ EXTERN int     mq_getattr(mqd_t mqdes, struct mq_attr *mq_stat);
 #endif
 
 #endif /* __INCLUDE_MQUEUE_H */
-

include/net/ethernet.h

@@ -2,7 +2,7 @@
  * include/net/ethernet.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef  __NET_ETHERNET_H
+#ifndef  __INCLUDE_NET_ETHERNET_H
-#define  __NET_ETHERNET_H
+#define  __INCLUDE_NET_ETHERNET_H
 
 /****************************************************************************
  * Included Files
@@ -68,4 +68,4 @@ struct ether_header
  * Public Function Prototypes
  ****************************************************************************/
 
-#endif /*  __NET_ETHERNET_H */
+#endif /*  __INCLUDE_NET_ETHERNET_H */

include/net/if.h

@@ -33,8 +33,8 @@
  *
  *******************************************************************************************/
 
-#ifndef __NET_IF_H
+#ifndef __INCLUDE_NET_IF_H
-#define __NET_IF_H
+#define __INCLUDE_NET_IF_H
 
 /*******************************************************************************************
  * Included Files
@@ -130,4 +130,4 @@ struct ifreq
  * Public Function Prototypes
  *******************************************************************************************/
 
-#endif /* __NET_IF_H */
+#endif /* __INCLUDE_NET_IF_H */

include/netinet/ether.h

@@ -1,8 +1,8 @@
 /****************************************************************************
- * netinet/ether.h
+ * include/netinet/ether.h
  *
  *   Copyright (C) 2007, 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NETINET_ETHER_H
+#ifndef __INCLUDE_NETINET_ETHER_H
-#define __NETINET_ETHER_H
+#define __INCLUDE_NETINET_ETHER_H
 
 /****************************************************************************
  * Included Files
@@ -74,4 +74,4 @@ EXTERN int ether_line(const char *line, struct ether_addr *addr, char *hostname)
 }
 #endif
 
-#endif /*   __NETINET_ETHER_H */
+#endif /*   __INCLUDE_NETINET_ETHER_H */

include/netinet/in.h

@@ -1,8 +1,8 @@
 /****************************************************************************
- * netinet/in.h
+ * include/netinet/in.h
  *
  *   Copyright (C) 2007, 2009-2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NETINET_IP_H
+#ifndef __INCLUDE_NETINET_IP_H
-#define __NETINET_IP_H
+#define __INCLUDE_NETINET_IP_H
 
 /****************************************************************************
  * Included Files
@@ -152,4 +152,4 @@ struct sockaddr_in6
  * Public Function Prototypes
  ****************************************************************************/
 
-#endif /* __NETINET_IP_H */
+#endif /* __INCLUDE_NETINET_IP_H */

include/netinet/ip.h

@@ -1,8 +1,8 @@
 /****************************************************************************
- * netinet/ip.h
+ * include/netinet/ip.h
  *
  *   Copyright (C) 2007, 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NETINET_IP_H
+#ifndef __INCLUDE_NETINET_IP_H
-#define __NETINET_IP_H
+#define __INCLUDE_NETINET_IP_H
 
 /****************************************************************************
  * Included Files
@@ -51,4 +51,4 @@
  * Public Function Prototypes
  ****************************************************************************/
 
-#endif /* __NETINET_IP_H */
+#endif /* __INCLUDE_NETINET_IP_H */

include/netinet/ip6.h

@@ -1,8 +1,8 @@
 /****************************************************************************
- * netinet/ip6.h
+ * include/netinet/ip6.h
  *
  *   Copyright (C) 2007, 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NETINET_IP6_H
+#ifndef __INCLUDE_NETINET_I6P_H
-#define __NETINET_IP6_H
+#define __INCLUDE_NETINET_I6P_H
 
 /****************************************************************************
  * Included Files
@@ -51,4 +51,4 @@
  * Public Function Prototypes
  ****************************************************************************/
 
-#endif /* __NETINET_IP6_H */
+#endif /* __INCLUDE_NETINET_I6P_H */

include/nuttx/analog/adc.h

@@ -8,7 +8,7 @@
  *
  * Derived from include/nuttx/can.h
  *   Copyright (C) 2008, 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/analog/dac.h

@@ -8,7 +8,7 @@
  * Derived from include/nuttx/can.h
  *
  *   Copyright (C) 2008, 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -39,8 +39,8 @@
  *
  ************************************************************************************/
 
-#ifndef __NUTTX_DAC_H
+#ifndef __INCLUDE_NUTTX_ANALOG_DAC_H
-#define __NUTTX_DAC_H
+#define __INCLUDE_NUTTX_ANALOG_DAC_H
 
 /************************************************************************************
  * Included Files
@@ -209,4 +209,4 @@ FAR struct dac_dev_s *up_ad5410initialize(FAR struct spi_dev_s *spi, unsigned in
 }
 #endif
 
-#endif /* __NUTTX_DAC_H */
+#endif /* __INCLUDE_NUTTX_ANALOG_DAC_H */

include/nuttx/binfmt.h

@@ -2,7 +2,7 @@
  * include/nuttx/binfmt.h
  *
  *   Copyright (C) 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/compiler.h

@@ -2,7 +2,7 @@
  * include/nuttx/compiler.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __COMPILER_H
+#ifndef __INCLUDE_NUTTX_COMPILER_H
-#define __COMPILER_H
+#define __INCLUDE_NUTTX_COMPILER_H
 
 /****************************************************************************
  * Included Files
@@ -445,4 +445,4 @@ extern "C" {
 }
 #endif
 
-#endif /* __COMPILER_H */
+#endif /* __INCLUDE_NUTTX_COMPILER_H */

include/nuttx/fb.h

@@ -2,7 +2,7 @@
  * include/nuttx/fb.h
  *
  *   Copyright (C) 2008-2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/i2c.h

@@ -2,7 +2,7 @@
  * include/nuttx/i2c.h
  *
  *   Copyright(C) 2009-2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/init.h

@@ -2,7 +2,7 @@
  * include/nuttx/init.h
  *
  *   Copyright (C) 2007, 2008, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NUTTX_INIT_H
+#ifndef __INCLUDE_NUTTX_INIT_H
-#define __NUTTX_INIT_H
+#define __INCLUDE_NUTTX_INIT_H
 
 /****************************************************************************
  * Included Files
@@ -79,4 +79,4 @@ EXTERN void   os_start(void); /* OS entry point called by boot logic */
 }
 #endif
 
-#endif /* __NUTTX_INIT_H */
+#endif /* __INCLUDE_NUTTX_INIT_H */

include/nuttx/irq.h

@@ -2,7 +2,7 @@
  * include/nuttx/irq.h
  *
  *   Copyright (C) 2007-2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/kmalloc.h

@@ -2,7 +2,7 @@
  * include/nuttx/kmalloc.h
  *
  *   Copyright (C) 2007, 2008, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/lcd/lcd.h

@@ -2,7 +2,7 @@
  * include/nuttx/lcd/lcd.h
  *
  *   Copyright (C) 2010-2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/lcd/nokia6100.h

@@ -3,7 +3,7 @@
  * Application interface to the Nokia 6100 LCD display
  *
  *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/lcd/p14201.h

@@ -3,7 +3,7 @@
  * Application interface to the RiT P14201 OLED driver
  *
  *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/lcd/ug-9664hswag01.h

@@ -4,7 +4,7 @@
  * SSD1305 LCD controller.
  *
  *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/mm.h

@@ -2,7 +2,7 @@
  * include/nuttx/mm.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NUTTX_MM_H
+#ifndef __INCLUDE_NUTTX_MM_H
-#define __NUTTX_MM_H
+#define __INCLUDE_NUTTX_MM_H
 
 /****************************************************************************
  * Included Files
@@ -81,4 +81,4 @@ EXTERN void mm_givesemaphore(void);
 }
 #endif
 
-#endif /* __NUTTX_MM_H */
+#endif /* __INCLUDE_NUTTX_MM_H */

include/nuttx/mmcsd.h

@@ -2,7 +2,7 @@
  * include/nuttx/mmcsd.h
  *
  *   Copyright (C) 2008-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NUTTX_MMCSD_H
+#ifndef __INCLUDE_NUTTX_MMCSD_H
-#define __NUTTX_MMCSD_H
+#define __INCLUDE_NUTTX_MMCSD_H
 
 /****************************************************************************
  * Included Files
@@ -103,4 +103,5 @@ EXTERN int mmcsd_spislotinitialize(int minor, int slotno, FAR struct spi_dev_s *
 #if defined(__cplusplus)
 }
 #endif
-#endif /* __NUTTX_MMCSD_H */
+
+#endif /* __INCLUDE_NUTTX_MMCSD_H */

include/nuttx/mqueue.h

@@ -2,7 +2,7 @@
  * include/nuttx/mqueue.h
  *
  *   Copyright (C) 2007, 2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/net/enc28j60.h

@@ -2,7 +2,7 @@
  * include/nuttx/net/enc28j60.h
  *
  *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/net/net.h

@@ -1,5 +1,5 @@
 /****************************************************************************
- * nuttx/net/net.h
+ * include/nuttx/net/net.h
  *
  *   Copyright (C) 2007, 2009-2012 Gregory Nutt. All rights reserved.
  *   Author: Gregory Nutt <gnutt@nuttx.org>

include/nuttx/net/uip/uip-arp.h

@@ -38,8 +38,8 @@
  *
  ****************************************************************************/
 
-#ifndef __UIP_ARP_H__
+#ifndef __INCLUDE_NUTTX_NET_UIP_UIP_ARP_H
-#define __UIP_ARP_H__
+#define __INCLUDE_NUTTX_NET_UIP_UIP_ARP_H
 
 /****************************************************************************
  * Included Files
@@ -259,4 +259,4 @@ EXTERN struct arp_entry *uip_arp_find(in_addr_t ipaddr);
 }
 #endif
 
-#endif /* __UIP_ARP_H__ */
+#endif /* __INCLUDE_NUTTX_NET_UIP_UIP_ARP_H */

include/nuttx/net/uip/uip-ipopt.h

@@ -4,7 +4,7 @@
  * Defines values for the IP header options
  *
  *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/net/uip/uipopt.h

@@ -17,7 +17,7 @@
  * be changed, but rather the per-project defconfig file.
  *
  *   Copyright (C) 2007, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * This logic was leveraged from uIP which also has a BSD-style license:
  *

include/nuttx/nx/nxfonts.h

@@ -2,7 +2,7 @@
  * include/nuttx/nx/nxfonts.h
  *
  *   Copyright (C) 2008, 2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/nxflat.h

@@ -2,7 +2,7 @@
  * include/nuttx/nxflat.h
  *
  *   Copyright (C) 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -139,7 +139,7 @@ EXTERN int nxflat_verifyheader(const struct nxflat_hdr_s *header);
  ***********************************************************************/
 
 EXTERN int nxflat_init(const char *filename,
-	                   struct nxflat_loadinfo_s *loadinfo);
+                       struct nxflat_loadinfo_s *loadinfo);
 
 /***********************************************************************
  * Name: nxflat_uninit

include/nuttx/page.h

@@ -3,7 +3,7 @@
  * This file defines interfaces used to support NuttX On-Demand Paging.
  *
  *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -34,8 +34,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NUTTX_PAGE_H
+#ifndef __INCLUDE_NUTTX_PAGE_H
-#define __NUTTX_PAGE_H
+#define __INCLUDE_NUTTX_PAGE_H
 
 /****************************************************************************
  * Included Files
@@ -464,4 +464,4 @@ EXTERN int up_fillpage(FAR _TCB *tcb, FAR void *vpage, up_pgcallback_t pg_callba
 
 #endif /* __ASSEMBLY__ */
 #endif /* CONFIG_PAGING */
-#endif /* __NUTTX_PAGE_H */
+#endif /* __INCLUDE_NUTTX_PAGE_H */

include/nuttx/progmem.h

@@ -62,76 +62,131 @@ extern "C" {
  * Public Functions
  ****************************************************************************/
 
-/* Return number of pages */
+/****************************************************************************
+ * Name: up_progmem_npages
+ *
+ * Description:
+ *   Return number of pages
+ *
+ ****************************************************************************/
 
 uint16_t up_progmem_npages(void);
 
-/* Is program memory uniform or page size differs */
+/****************************************************************************
+ * Name: up_progmem_isuniform
+ *
+ * Description:
+ *   Is program memory uniform or page size differs?
+ *
+ ****************************************************************************/
 
 bool up_progmem_isuniform(void);
 
-/* Return page size */
+/****************************************************************************
+ * Name: up_progmem_pagesize
+ *
+ * Description:
+ *   Return page size
+ *
+ ****************************************************************************/
 
 uint16_t up_progmem_pagesize(uint16_t page);
 
-/* Address to page conversion 
+/****************************************************************************
- *  \param addr Address without flash offet (aligned to page0)
+ * Name: up_progmem_getpage
- *  \return Page or negative value on error
+ *
- * 
+ * Description:
- * The following errors are reported (errno is not set!)
+ *   Address to page conversion 
- *  - EFAULT: On invalid address
+ *
- */
+ * Input Parameters:
+ *   addr - Address without flash offet (aligned to page0)
+ *
+ * Returned Value:
+ *   Page or negative value on error.  The following errors are reported
+ *   (errno is not set!):
+ *
+ *     EFAULT: On invalid address
+ *
+ ****************************************************************************/
 
 int up_progmem_getpage(uint32_t addr);
 
-/* Erase selected page. 
+/****************************************************************************
- *  \return page size or negative value on error
+ * Name: up_progmem_erasepage
- * 
+ *
- * The following errors are reported (errno is not set!)
+ * Description:
- *  - EFAULT: On invalid page
+ *   Erase selected page.
- *  - EIO: On unsuccessful erase
+ *
- *  - EROFS: On access to write protected area
+ * Input Parameters:
- *  - EACCES: Insufficient permissions (read/write protected)
+ *   page - 
- *  - EPERM: If operation is not permitted due to some other constraints
+ *
- *    (i.e. some internal block is not running etc.)
+ * Returned Value:
- */
+ *   Page size or negative value on error.  The following errors are reported
+ *   (errno is not set!):
+ *
+ *     EFAULT: On invalid page
+ *     EIO: On unsuccessful erase
+ *     EROFS: On access to write protected area
+ *     EACCES: Insufficient permissions (read/write protected)
+ *     EPERM: If operation is not permitted due to some other constraints
+ *        (i.e. some internal block is not running etc.)
+ *
+ ****************************************************************************/
 
 int up_progmem_erasepage(uint16_t page);
 
-/* Checks whether page is erased 
+/****************************************************************************
- * 
+ * Name: up_progmem_ispageerased
- * Returns number of bytes written or negative value on error.
- * If it returns zero then complete page is empty (erased).
  *
- * The following errors are reported (errno is not set!)
+ * Description:
- *  - EFAULT: On invalid page
+ *   Checks whether page is erased
- */
+ *
+ * Input Parameters:
+ *    page - 
+ *
+ * Returned Value:
+ *   Returns number of bytes written or negative value on error. If it
+ *   returns zero then complete page is empty (erased).
+ *
+ *   The following errors are reported (errno is not set!)
+ *     EFAULT: On invalid page
+ *
+ ****************************************************************************/
 
 int up_progmem_ispageerased(uint16_t page);
 
-/* Program data at given address 
+/****************************************************************************
- *  \return bytes written or negative value on error 
+ * Name: up_progmem_write
- *  \param addr Address without flash offet (aligned to page0)
+ *
- *  \param buf Pointer to buffer
+ * Description:
- *  \param count Number of bytes to write
+ *   Program data at given address
- * 
+ *
- * Note: this function is not limited to single page and nor it requires
+ *   Note: this function is not limited to single page and nor it requires
  *   the address be aligned inside the page boundaries.
- * 
+ *
- * The following errors are reported (errno is not set!)
+ * Input Parameters:
- *  - EINVAL: if count is not aligned with the flash boundaries (i.e.
+ *   addr  - Address without flash offet (aligned to page0)
- *    some MCU's require per half-word or even word access)
+ *   buf   - Pointer to buffer
- *  - EFAULT: On invalid address
+ *   count - Number of bytes to write *
- *  - EIO: On unsuccessful write
+ *
- *  - EROFS: On access to write protected area
+ * Returned Value:
- *  - EACCES: Insufficient permissions (read/write protected)
+ *   Bytes written or negative value on error.  The following errors are
- *  - EPERM: If operation is not permitted due to some other constraints
+ *   reported (errno is not set!)
- *    (i.e. some internal block is not running etc.)
+ *
- */
+ *     EINVAL: if count is not aligned with the flash boundaries (i.e.
+ *        some MCU's require per half-word or even word access)
+ *     EFAULT: On invalid address
+ *     EIO: On unsuccessful write
+ *     EROFS: On access to write protected area
+ *     EACCES: Insufficient permissions (read/write protected)
+ *     EPERM: If operation is not permitted due to some other constraints
+ *        (i.e. some internal block is not running etc.)
+ *
+ ****************************************************************************/
 
 int up_progmem_write(uint32_t addr, const void *buf, size_t count);
 
-/* \todo: Define the following functions and their options:
+/* TODO: Define the following functions and their options:
  *  - up_progmem_protect() 
  *  - up_progmem_unprotect()
  */

include/nuttx/pthread.h

@@ -3,7 +3,7 @@
  * Non-standard, NuttX-specific pthread-related declarations.
  *
  *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -63,16 +63,6 @@
  * Public Data
  ****************************************************************************/
 
-/* Default pthread attributes (see sched/pthread_create.c).  This global
- * can only be shared within the kernel- or within the user- address space.
- */
-
-extern pthread_attr_t g_default_pthread_attr;
-
-/****************************************************************************
- * Public Function Prototypes
- ****************************************************************************/
-
 #ifdef __cplusplus
 #define EXTERN extern "C"
 extern "C" {
@@ -80,6 +70,16 @@ extern "C" {
 #define EXTERN extern
 #endif
 
+/* Default pthread attributes (see sched/pthread_create.c).  This global
+ * can only be shared within the kernel- or within the user- address space.
+ */
+
+EXTERN pthread_attr_t g_default_pthread_attr;
+
+/****************************************************************************
+ * Public Function Prototypes
+ ****************************************************************************/
+
 #undef EXTERN
 #ifdef __cplusplus
 }

include/nuttx/pwm.h

@@ -250,7 +250,7 @@ extern "C" {
  *
  ****************************************************************************/
 
-int pwm_register(FAR const char *path, FAR struct pwm_lowerhalf_s *dev);
+EXTERN int pwm_register(FAR const char *path, FAR struct pwm_lowerhalf_s *dev);
 
 /****************************************************************************
  * Name: pwm_expired

include/nuttx/ramdisk.h

@@ -1,5 +1,5 @@
 /****************************************************************************
- * nuttx/ramdisk.h
+ * include/nuttx/ramdisk.h
  *
  *   Copyright (C) 2008-2009, 2012 Gregory Nutt. All rights reserved.
  *   Author: Gregory Nutt <gnutt@nuttx.org>

include/nuttx/regex.h

@@ -3,7 +3,7 @@
  * Non-standard, pattern-matching APIs available in lib/.
  *
  *   Copyright (C) 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/rtc.h

@@ -105,6 +105,7 @@
 /****************************************************************************
  * Public Types
  ****************************************************************************/
+
 /* The form of an alarm callback */
 
 typedef CODE void (*alarmcb_t)(void);

include/nuttx/rwbuffer.h

@@ -1,8 +1,8 @@
 /****************************************************************************
- * inlcude/nuttx/rwbuffer.h
+ * include/nuttx/rwbuffer.h
  *
  *   Copyright (C) 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/sched.h

@@ -1,5 +1,5 @@
 /********************************************************************************
- * nuttx/sched.h
+ * include/nuttx/sched.h
  *
  *   Copyright (C) 2007-2012 Gregory Nutt. All rights reserved.
  *   Author: Gregory Nutt <gnutt@nuttx.org>

include/nuttx/scsi.h

@@ -2,7 +2,7 @@
  * include/nuttx/scsi.h
  *
  *   Copyright (C) 2008, 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * References:
  *   "SCSI Primary Commands - 3 (SPC-3),"  American National Standard

include/nuttx/sdio.h

@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NUTTX_SDIO_H
+#ifndef __INCLUDE_NUTTX_SDIO_H
-#define __NUTTX_SDIO_H
+#define __INCLUDE_NUTTX_SDIO_H
 
 /****************************************************************************
  * Included Files
@@ -852,4 +852,4 @@ extern "C" {
 #if defined(__cplusplus)
 }
 #endif
-#endif /* __NUTTX_SDIO_H */
+#endif /* __INCLUDE_NUTTX_SDIO_H */

include/nuttx/symtab.h

@@ -2,7 +2,7 @@
  * include/nuttx/symtab.h
  *
  *   Copyright (C) 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nuttx/usb/cdc.h

@@ -2,7 +2,7 @@
  * include/nuttx/usb/cdc.h
  *
  *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * References: "Universal Serial Bus Class Definitions for Communication
  *   Devices," Version 1.1, January 19, 1999

include/nuttx/usb/composite.h

@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __NUTTX_USB_COMPOSITE_H
+#ifndef __INCLUDE_NUTTX_USB_COMPOSITE_H
-#define __NUTTX_USB_COMPOSITE_H
+#define __INCLUDE_NUTTX_USB_COMPOSITE_H
 
 /****************************************************************************
  * Included Files
@@ -183,4 +183,4 @@ EXTERN int composite_ep0submit(FAR struct usbdevclass_driver_s *driver,
 #endif
 
 #endif /* CONFIG_USBDEV_COMPOSITE */
-#endif /* __NUTTX_USB_COMPOSITE_H */
+#endif /* __INCLUDE_NUTTX_USB_COMPOSITE_H */

include/nuttx/usb/hid.h

@@ -2,7 +2,7 @@
  * include/nuttx/usb/hid.h
  *
  *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * References:
  *   HID Universal Serial Bus (USB), Device Class Definition for Human

include/nuttx/usb/ohci.h

@@ -2,7 +2,7 @@
  * include/nuttx/usb/ohci.h
  *
  *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  *   References: "OpenHCI Open Host Controller Interface Specification
  *   for USB," Release 1.0a, Compaq, Microsoft, National Semiconductor,

include/nuttx/usb/storage.h

@@ -2,7 +2,7 @@
  * include/nuttx/usb/storage.h
  *
  *   Copyright (C) 2008-2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * References:
  *   "Universal Serial Bus Mass Storage Class, Specification Overview,"
@@ -40,8 +40,8 @@
  *
  ************************************************************************************/
 
-#ifndef __NUTTX_USB_STORAGE_H
+#ifndef __INCLUDE_NUTTX_USB_STORAGE_H
-#define __NUTTX_USB_STORAGE_H
+#define __INCLUDE_NUTTX_USB_STORAGE_H
 
 /************************************************************************************
  * Included Files
@@ -128,4 +128,4 @@ struct usbmsc_csw_s
  * Public Functions
  ************************************************************************************/
 
-#endif /* __NUTTX_USB_STORAGE_H */
+#endif /* __INCLUDE_NUTTX_USB_STORAGE_H */

include/nuttx/usb/usb.h

@@ -33,8 +33,8 @@
  *
  ************************************************************************************/
 
-#ifndef __NUTTX_USB_USB_H
+#ifndef __INCLUDE_NUTTX_USB_USB_H
-#define __NUTTX_USB_USB_H
+#define __INCLUDE_NUTTX_USB_USB_H
 
 /************************************************************************************
  * Included Files
@@ -413,4 +413,4 @@ struct usb_iaddesc_s
  * Public Functions
  ************************************************************************************/
 
-#endif // __NUTTX_USB_USB_H
+#endif // __INCLUDE_NUTTX_USB_USB_H

include/nuttx/usb/usbhost.h

@@ -2,7 +2,7 @@
  * include/nuttx/usb/usbhost.h
  *
  *   Copyright (C) 2010-2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * References:
  *   "Universal Serial Bus Mass Storage Class, Specification Overview,"
@@ -40,8 +40,8 @@
  *
  ************************************************************************************/
 
-#ifndef __NUTTX_USB_USBHOST_H
+#ifndef __INCLUDE_NUTTX_USB_USBHOST_H
-#define __NUTTX_USB_USBHOST_H
+#define __INCLUDE_NUTTX_USB_USBHOST_H
 
 /************************************************************************************
  * Included Files
@@ -866,4 +866,4 @@ EXTERN int usbhost_enumerate(FAR struct usbhost_driver_s *drvr,
 }
 #endif
 
-#endif /* __NUTTX_USB_USBHOST_H */
+#endif /* __INCLUDE_NUTTX_USB_USBHOST_H */

include/nuttx/usb/usbhost_trace.h

@@ -2,7 +2,7 @@
  * include/nuttx/usb/usbhost_trace.h
  *
  *   Copyright (C) 2010 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/nxflat.h

@@ -2,7 +2,7 @@
  * include/nxflat.h
  *
  *   Copyright (C) 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/poll.h

@@ -2,7 +2,7 @@
  * include/poll.h
  *
  *   Copyright (C) 2008-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/queue.h

@@ -1,8 +1,8 @@
 /************************************************************************
- * queue.h
+ * include/queue.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ************************************************************************/
 
-#ifndef __QUEUE_H
+#ifndef __INCLUDE_QUEUE_H
-#define __QUEUE_H
+#define __INCLUDE_QUEUE_H
 
 /************************************************************************
  * Included Files
@@ -125,5 +125,5 @@ EXTERN FAR dq_entry_t *dq_remfirst(dq_queue_t *queue);
 }
 #endif
 
-#endif /* __QUEUE_H_ */
+#endif /* __INCLUDE_QUEUE_H_ */
 

include/sched.h

@@ -2,7 +2,7 @@
  * include/sched.h
  *
  *   Copyright (C) 2007-2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/signal.h

@@ -2,7 +2,7 @@
  * include/signal.h
  *
  *   Copyright (C) 2007-2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ********************************************************************************/
 
-#ifndef __SIGNAL_H
+#ifndef __INCLUDE_SIGNAL_H
-#define __SIGNAL_H
+#define __INCLUDE_SIGNAL_H
 
 /********************************************************************************
  * Included Files
@@ -234,5 +234,5 @@ EXTERN int sigqueue(int pid, int signo, FAR void *sival_ptr);
 }
 #endif
 
-#endif /* __SIGNAL_H */
+#endif /* __INCLUDE_SIGNAL_H */
 

include/stdbool.h

@@ -2,7 +2,7 @@
  * include/stdbool.h
  *
  *   Copyright (C) 2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/stddef.h

@@ -2,7 +2,7 @@
  * include/stddef.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __STDDEF_H
+#ifndef __INCLUDE_STDDEF_H
-#define __STDDEF_H
+#define __INCLUDE_STDDEF_H
 
 /****************************************************************************
  * Included Files
@@ -46,4 +46,4 @@
  * Type Definitions
  ****************************************************************************/
 
-#endif /* __STDDEF_H */
+#endif /* __INCLUDE_STDDEF_H */

include/stdint.h

@@ -2,7 +2,7 @@
  * include/stdint.h
  *
  *   Copyright (C) 2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/stdio.h

@@ -2,7 +2,7 @@
  * include/stdio.h
  *
  *   Copyright (C) 2007-2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/sys/mman.h

@@ -2,7 +2,7 @@
  * include/sys/mman.h
  *
  *   Copyright (C) 2008, 2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __SYS_MMAN_H
+#ifndef __INCLUDE_SYS_MMAN_H
-#define __SYS_MMAN_H
+#define __INCLUDE_SYS_MMAN_H
 
 /****************************************************************************
  * Included Files
@@ -110,4 +110,4 @@ EXTERN int munmap(FAR void *start, size_t length);
 }
 #endif
 
-#endif /* __SYS_MMAN_H */
+#endif /* __INCLUDE_SYS_MMAN_H */

include/sys/mount.h

@@ -2,7 +2,7 @@
  * include/sys/mount.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __SYS_MOUNT_H
+#ifndef __INCLUDE_SYS_MOUNT_H
-#define __SYS_MOUNT_H
+#define __INCLUDE_SYS_MOUNT_H
 
 /****************************************************************************
  * Included Files
@@ -74,4 +74,4 @@ EXTERN int umount(const char *target);
 }
 #endif
 
-#endif /* __SYS_MOUNT_H */
+#endif /* __INCLUDE_SYS_MOUNT_H */

include/sys/prctl.h

@@ -45,7 +45,6 @@
  ****************************************************************************/
 
 /* Supported prctl() commands.
- *
  *
  *  PR_SET_NAME
  *    Set the task (or thread) name for the thread whose ID is in required

include/sys/select.h

@@ -2,7 +2,7 @@
  * include/sys/select.h
  *
  *   Copyright (C) 2008-2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/sys/socket.h

@@ -1,8 +1,8 @@
 /****************************************************************************
- * sys/socket.h
+ * include/sys/socket.h
  *
  *   Copyright (C) 2007, 2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __SYS_SOCKET_H
+#ifndef __INCLUDE_SYS_SOCKET_H
-#define __SYS_SOCKET_H
+#define __INCLUDE_SYS_SOCKET_H
 
 /****************************************************************************
  * Included Files
@@ -231,4 +231,4 @@ EXTERN int getsockname(int sockfd, FAR struct sockaddr *addr,
 }
 #endif
 
-#endif /* __SYS_SOCKET_H */
+#endif /* __INCLUDE_SYS_SOCKET_H */

include/sys/stat.h

@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __SYS_STAT_H
+#ifndef __INCLUDE_SYS_STAT_H
-#define __SYS_STAT_H
+#define __INCLUDE_SYS_STAT_H
 
 /****************************************************************************
  * Included Files
@@ -94,9 +94,8 @@
  * Type Definitions
  ****************************************************************************/
 
-/* This is the simplified struct stat as returned by fstat().
+/* This is the simplified struct stat as returned by fstat(). This structure
- * This structure provides information about a specific file
+ * provides information about a specific file or directory in the file system.
- * or directory in the file system.
  */
 
 struct stat
@@ -132,4 +131,4 @@ EXTERN int fstat(int fd, FAR struct stat *buf);
 }
 #endif
 
-#endif /* __SYS_STAT_H */
+#endif /* __INCLUDE_SYS_STAT_H */

include/sys/statfs.h

@@ -2,7 +2,7 @@
  * include/sys/statfs.h
  *
  *   Copyright (C) 2007-2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __SYS_STATFS_H
+#ifndef __INCLUDE_SYS_STATFS_H
-#define __SYS_STATFS_H
+#define __INCLUDE_SYS_STATFS_H
 
 /****************************************************************************
  * Included Files
@@ -142,4 +142,4 @@ EXTERN int fstatfs(int fd, struct statfs *buf);
 }
 #endif
 
-#endif /* __SYS_STATFS_H */
+#endif /* __INCLUDE_SYS_STATFS_H */

include/sys/time.h

@@ -2,7 +2,7 @@
  * include/sys/time.h
  *
  *   Copyright (C) 2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/sys/types.h

@@ -2,7 +2,7 @@
  * include/sys/types.h
  *
  *   Copyright (C) 2007-2009, 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/sys/vfs.h

@@ -2,7 +2,7 @@
  * include/sys/vfs.h
  *
  *   Copyright (C) 2007, 2008 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,15 +33,15 @@
  *
  ****************************************************************************/
 
-#ifndef __SYS_VFS_H
+#ifndef __INCLUDE_SYS_VFS_H
-#define __SYS_VFS_H
+#define __INCLUDE_SYS_VFS_H
 
 /****************************************************************************
  * Included Files
  ****************************************************************************/
 
-/* sys/vfs.h is just an alternative location for the
+/* sys/vfs.h is just an alternative location for the information in
- * information in sys/statfs.h.
+ * sys/statfs.h.
  */
 
 #include <sys/statfs.h>
@@ -58,4 +58,4 @@
  * Public Function Prototypes
  ****************************************************************************/
 
-#endif /* __SYS_VFS_H */
+#endif /* __INCLUDE_SYS_VFS_H */

include/sys/wait.h

@@ -2,7 +2,7 @@
  * include/sys/wait.h
  *
  *   Copyright (C) 2011 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions

include/unistd.h

@@ -2,7 +2,7 @@
  * include/unistd.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -33,8 +33,8 @@
  *
  ****************************************************************************/
 
-#ifndef __UNISTD_H
+#ifndef __INCLUDE_UNISTD_H
-#define __UNISTD_H
+#define __INCLUDE_UNISTD_H
 
 /****************************************************************************
  * Included Files
@@ -176,4 +176,4 @@ EXTERN int       *getoptoptp(void); /* unrecognized option character */
 }
 #endif
 
-#endif /* __UNISTD_H */
+#endif /* __INCLUDE_UNISTD_H */

include/wdog.h

@@ -2,7 +2,7 @@
  * include/wdog.h
  *
  *   Copyright (C) 2007-2009 Gregory Nutt. All rights reserved.
- *   Author: Gregory Nutt <spudmonkey@racsa.co.cr>
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
@@ -53,14 +53,13 @@
  * Global Type Declarations
  ****************************************************************************/
 
-/* The arguments are passed as uint32_t values.  For systems
+/* The arguments are passed as uint32_t values.  For systems where the
- * where the sizeof(pointer) < sizeof(uint32_t), the following
+ * sizeof(pointer) < sizeof(uint32_t), the following union defines the
- * union defines the alignment of the pointer within the
+ * alignment of the pointer within the uint32_t.  For example, the SDCC
- * uint32_t.  For example, the SDCC MCS51 general pointer is
+ * MCS51 general pointer is 24-bits, but uint32_t is 32-bits (of course).
- * 24-bits, but uint32_t is 32-bits (of course).
  *
- * For systems where sizeof(pointer) > sizeof(uint32_t), we will
+ * For systems where sizeof(pointer) > sizeof(uint32_t), we will have to do
- * have to do some redesign.
+ * some redesign.
  */
 
 union wdparm_u
@@ -68,6 +67,7 @@ union wdparm_u
   FAR void     *pvarg;
   FAR uint32_t *dwarg;
 };
+
 typedef union wdparm_u wdparm_t;
 
 /* This is the form of the function that is called when the