diff options
Diffstat (limited to 'doc/user/conf.t')
-rw-r--r-- | doc/user/conf.t | 46 |
1 files changed, 41 insertions, 5 deletions
diff --git a/doc/user/conf.t b/doc/user/conf.t index dc10816909..fe714b42d4 100644 --- a/doc/user/conf.t +++ b/doc/user/conf.t @@ -595,6 +595,40 @@ require the addition of a new configuration parameter to specify the number of tasks which enable floating point support. @c +@c === CONFIGURE_ENABLE_CLASSIC_API_NOTEPADS === +@c +@subsection Enable Classic API Notepads + +@findex CONFIGURE_ENABLE_CLASSIC_API_NOTEPADS + +@table @b +@item CONSTANT: +@code{CONFIGURE_ENABLE_CLASSIC_API_NOTEPADS} + +@item DATA TYPE: +Boolean feature macro. + +@item RANGE: +Defined or undefined. + +@item DEFAULT VALUE: +This is not defined by default, and Classic API Notepads are not supported. + +@end table + +@subheading DESCRIPTION: +@code{CONFIGURE_ENABLE_CLASSIC_API_NOTEPADS} should be defined if the +user wants to have support for Classic API Notepads in their application. + +@subheading NOTES: +Disabling Classic API Notepads saves the allocation of sixteen (16) +thirty-two bit integers. This saves sixty-four bytes per task/thread +plus the allocation overhead. Notepads are rarely used in applications +and this can save significant memory in a low RAM system. Classic API +Notepads are deprecated, and this option is expected to be obsolete in +the near future. + +@c @c === CONFIGURE_DISABLE_CLASSIC_API_NOTEPADS === @c @subsection Disable Classic API Notepads @@ -612,20 +646,22 @@ Boolean feature macro. Defined or undefined. @item DEFAULT VALUE: -This is not defined by default, and Classic API Notepads are supported. +This is not defined by default, and Classic API Notepads are not supported. @end table @subheading DESCRIPTION: -@code{CONFIGURE_DISABLE_CLASSIC_API_NOTEPADS} should be defined if the -user does not want to have support for Classic API Notepads in their -application. +@code{CONFIGURE_DISABLE_CLASSIC_API_NOTEPADS} is deprecated. If users +want to have support for Classic API Notepads, they should use +@code{CONFIGURE_ENABLE_CLASSIC_API_NOTEPADS}. @subheading NOTES: Disabling Classic API Notepads saves the allocation of sixteen (16) thirty-two bit integers. This saves sixty-four bytes per task/thread plus the allocation overhead. Notepads are rarely used in applications -and this can save significant memory in a low RAM system. +and this can save significant memory in a low RAM system. Classic API +Notepads are deprecated, and this option is expected to be obsolete in +the near future. @c @c === CONFIGURE_MAXIMUM_TIMERS === |