diff --git a/Documentation/NuttxPortingGuide.html b/Documentation/NuttxPortingGuide.html index faa9f32cf40..e4bcc5d64ec 100644 --- a/Documentation/NuttxPortingGuide.html +++ b/Documentation/NuttxPortingGuide.html @@ -12,7 +12,7 @@
Last Updated: May 28, 2011
+Last Updated: June 18, 2011
@@ -3208,17 +3208,37 @@ build -+ General Debug setup options are provided to (1) enable and control debug console output, (2) to build NuttX for use with a debugger, and (3) to enable specific debug features: +
CONFIG_DEBUG: enables built-in debug options
+ CONFIG_DEBUG: enables built-in debug options.
+ This includes more extensive parameter checking, debug assertions, and other debug logic.
+ This option is also necessary (but not sufficient) to enable debug console output;
+ Debug console output must also be enabled on a subsystem-by-subsystem basis as described below.
CONFIG_DEBUG_VERBOSE: enables verbose debug output
+ CONFIG_DEBUG_VERBOSE: If debug console output is enabled, the option enables more verbose debug output.
+ Ignored if CONFIG_DEBUG is not defined.
+ If only CONFIG_DEBUG then the only output will be errors, warnings, and critical information.
+ If CONFIG_DEBUG_VERBOSE is defined in addition, then general debug comments will also be included in the console output.
CONFIG_DEBUG_SYMBOLS: build without optimization and with debug symbols (needed for use with a debugger).
+ This option has nothing to do with debug output.
CONFIG_DEBUG_STACK: a few ports include logic to monitor stack usage.
+ If the NuttX port supports this option, it would be enabled with this option.
+ This option also requires CONFIG_DEBUG to enable general debug features.
+
+ If debug features are enabled with CONFIG_DEBUG (and possibly CONFIG_DEBUG_VERBOSE), then debug console output can also be enabled on a subsystem-by-subsystem basis.
+ Below are debug subsystems that are generally available on all platforms:
+
CONFIG_DEBUG_SCHED: enable OS debug output (disabled by default)
CONFIG_DEBUG_GRAPHICS: enable NX graphics debug output (disabled by default)
+ The following debug options may also be used with certain ports that support these features: +
+CONFIG_DEBUG_DMA: enable DMA controller debug output (disabled by default)
+ CONFIG_DEBUG_GPIO: enable detail GPIO usage debug output (disabled by default)
+ CONFIG_DEBUG_PAGING: enable on-demand paging debug output (disabled by default)
+ CONFIG_ARCH_LOWPUTC: architecture supports low-level, boot
time console output