diff --git a/Documentation/NuttXCCodingStandard.html b/Documentation/NuttXCCodingStandard.html index 7505acfd13..977af36225 100644 --- a/Documentation/NuttXCCodingStandard.html +++ b/Documentation/NuttXCCodingStandard.html @@ -12,7 +12,7 @@
Last Updated: August 24, 2016
+Last Updated: February 9, 2017
@@ -1074,6 +1074,15 @@ int do_foobar(void)static
storage class then the scope of the global symbol is within the file only.
+This is a somewhat different concept and within NuttX you will find these distinguished as private vs. public global symbols.
+However, within this standard, the term global variable will refer to any variable that has more than local scope.
+
+
Coding Standard:
Incorrect
extern int someint; +static int anotherint; uint32_t dwA32BitInt; uint32_t gAGlobalVariable;
Acceptable
extern int g_someint; +static int g_anotherint; uint32_t g_a32bitint; uint32_t g_aglobal;@@ -1136,6 +1147,7 @@ struct my_variables_s }; extern int g_someint; +static int g_anotherint; struct my_variables_s g_myvariables; diff --git a/libc/Kconfig b/libc/Kconfig index 774a4e00c6..089f77571b 100644 --- a/libc/Kconfig +++ b/libc/Kconfig @@ -10,15 +10,18 @@ config STDIO_DISABLE_BUFFERING default n ---help--- Tiny systems may need to disable all support for I/O buffering in - order to minimum footprint. + order to minimize the memory footprint. NOTE that even if STDIO buffering is enabled, you can still disable - buffer by setting CONFIG_STDIO_BUFFER_SIZE=0 or dynamically through - the setvbuf() interface. In this case, however, memory used for - buffering will be eliminated, of course, buth there will be no - reduction in static code size. Only setting + buffering by setting CONFIG_STDIO_BUFFER_SIZE=0 or dynamically + through the setvbuf() interface. In this case, however, memory + used forbuffering will be eliminated, of course, buth there will be + no reduction in static code size. Only setting CONFIG_STDIO_DISABLE_BUFFERING will reduce static code size. + The setvbuf() interface is not available if + CONFIG_STDIO_DISABLE_BUFFERING is selected. + if !STDIO_DISABLE_BUFFERING config STDIO_BUFFER_SIZE @@ -27,8 +30,8 @@ config STDIO_BUFFER_SIZE ---help--- Size of buffers using within the C buffered I/O interfaces (printf, putchar, fwrite, etc.). This function sets the initial I/O buffer - size. Zero disables I/O buffering. That size may be subsequently - modified using setvbuf(). + size. Zero disables I/O buffering initially. Any buffer size may + be subsequently modified using setvbuf(). config STDIO_LINEBUFFER bool "STDIO line buffering"