summaryrefslogtreecommitdiffstats
path: root/doc/user/conf.t
diff options
context:
space:
mode:
authorAun-Ali Zaidi <admin@kodeit.net>2015-12-23 14:44:02 -0600
committerJoel Sherrill <joel.sherrill@oarcorp.com>2015-12-24 16:52:34 -0600
commitd5154d0f6a04f3b7ed59d9a09038576fe2640756 (patch)
tree4b6dcf6e9b116223903afbc1b1141d28fb751848 /doc/user/conf.t
parentscore: Fix watchdog removal (diff)
downloadrtems-d5154d0f6a04f3b7ed59d9a09038576fe2640756.tar.bz2
api: Remove deprecated Notepads
Notepads where a feature of RTEMS' tasks that simply functioned in the same way as POSIX keys or threaded local storage (TLS). They were introduced well before per task variables, which are also deprecated, and were barely used in favor of their POSIX alternatives. In addition to their scarce usage, Notepads took up unnecessary memory. For each task: - 16 32-bit integers were allocated. - A total of 64 bytes per task per thread. This is especially critical in low memory and safety-critical applications. They are also defined as uint32_t, and therefore are not guaranteed to hold a pointer. Lastly, they are not portable solutions for SMP and uniprocessor systems, like POSIX keys and TLS. updates #2493.
Diffstat (limited to 'doc/user/conf.t')
-rw-r--r--doc/user/conf.t69
1 files changed, 0 insertions, 69 deletions
diff --git a/doc/user/conf.t b/doc/user/conf.t
index 0dd0a50924..560b221464 100644
--- a/doc/user/conf.t
+++ b/doc/user/conf.t
@@ -595,75 +595,6 @@ 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
-
-@findex CONFIGURE_DISABLE_CLASSIC_API_NOTEPADS
-
-@table @b
-@item CONSTANT:
-@code{CONFIGURE_DISABLE_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_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. Classic API
-Notepads are deprecated, and this option is expected to be obsolete in
-the near future.
-
-@c
@c === CONFIGURE_MAXIMUM_TIMERS ===
@c
@subsection Specify Maximum Classic API Timers