[PATCH 2/2] c-user: Improve refs and formatting in appl config
Sebastian Huber
sebastian.huber at embedded-brains.de
Thu Aug 6 09:40:55 UTC 2020
The formatting is generated through references within the specification.
Update #3994.
---
c-user/config/bdbuf.rst | 18 ++++----
c-user/config/bsp-related.rst | 12 +++---
c-user/config/classic-api.rst | 2 +-
c-user/config/classic-init-task.rst | 12 +++---
c-user/config/device-driver.rst | 66 +++++++++++++++++++++--------
c-user/config/event-record.rst | 2 +-
c-user/config/filesystem.rst | 10 +++--
c-user/config/general.rst | 41 +++++++++---------
c-user/config/idle-task.rst | 2 +-
c-user/config/mpci.rst | 15 ++++---
c-user/config/posix-api.rst | 19 +++++----
c-user/config/posix-init-thread.rst | 2 +-
c-user/config/scheduler-general.rst | 8 ++--
c-user/config/task-stack-alloc.rst | 11 ++---
14 files changed, 129 insertions(+), 91 deletions(-)
diff --git a/c-user/config/bdbuf.rst b/c-user/config/bdbuf.rst
index 79459bf..6fe64a0 100644
--- a/c-user/config/bdbuf.rst
+++ b/c-user/config/bdbuf.rst
@@ -84,7 +84,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the minimum size of a buffer
@@ -111,7 +111,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``SIZE_MAX``.
+ and less than or equal to :c:macro:`SIZE_MAX`.
DESCRIPTION:
The value of this configuration option defines the size of the cache memory
@@ -138,7 +138,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the maximum blocks per
@@ -167,7 +167,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the maximum blocks per write
@@ -216,7 +216,7 @@ OPTION TYPE:
This configuration option is an integer define.
DEFAULT VALUE:
- The default value is ``RTEMS_MINIMUM_STACK_SIZE``.
+ The default value is :c:macro:`RTEMS_MINIMUM_STACK_SIZE`.
VALUE CONSTRAINTS:
The value of this configuration option shall satisfy all of the following
@@ -230,7 +230,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the task
stack space calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``uintptr_t``.
+ overflow an integer of type :c:type:`uintptr_t`.
DESCRIPTION:
The value of this configuration option defines the task stack size of the
@@ -257,7 +257,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the swapout task maximum block
@@ -284,7 +284,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the swapout task swap period
@@ -337,7 +337,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the swapout worker task count.
diff --git a/c-user/config/bsp-related.rst b/c-user/config/bsp-related.rst
index 5af5cc2..e8cc817 100644
--- a/c-user/config/bsp-related.rst
+++ b/c-user/config/bsp-related.rst
@@ -71,7 +71,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the IDLE
task stack area calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``size_t``.
+ overflow an integer of type :c:type:`size_t`.
DESCRIPTION:
If
@@ -145,10 +145,10 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the
interrupt stack area calculation carried out by ``<rtems/confdefs.h>`` does
- not overflow an integer of type ``size_t``.
+ not overflow an integer of type :c:type:`size_t`.
* It shall be aligned according to
- ``CPU_INTERRUPT_STACK_ALIGNMENT``.
+ :c:macro:`CPU_INTERRUPT_STACK_ALIGNMENT`.
DESCRIPTION:
If
@@ -259,9 +259,9 @@ DESCRIPTION:
* and :ref:`CONFIGURE_DISABLE_BSP_SETTINGS` is undefined,
then not all memory is made available to the C Program Heap immediately at
- system initialization time. When :c:func:`malloc()` or other standard memory
- allocation functions are unable to allocate memory, they will call the BSP
- supplied :c:func:`sbrk()` function to obtain more memory.
+ system initialization time. When :c:func:`malloc` or other standard
+ memory allocation functions are unable to allocate memory, they will call the
+ BSP supplied :c:func:`sbrk` function to obtain more memory.
NOTES:
This option should not be defined by the application. Only the BSP knows how
diff --git a/c-user/config/classic-api.rst b/c-user/config/classic-api.rst
index 41994e0..c640aae 100644
--- a/c-user/config/classic-api.rst
+++ b/c-user/config/classic-api.rst
@@ -331,7 +331,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the task
stack space calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``uintptr_t``.
+ overflow an integer of type :c:type:`uintptr_t`.
* It may be defined through
:c:func:`rtems_resource_unlimited` the enable unlimited objects for this
diff --git a/c-user/config/classic-init-task.rst b/c-user/config/classic-init-task.rst
index ca300e7..81e8e99 100644
--- a/c-user/config/classic-init-task.rst
+++ b/c-user/config/classic-init-task.rst
@@ -27,7 +27,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be a valid integer of type
- ``rtems_task_argument``.
+ :c:type:`rtems_task_argument`.
DESCRIPTION:
The value of this configuration option defines task argument of the Classic
@@ -50,7 +50,7 @@ OPTION TYPE:
This configuration option is an integer define.
DEFAULT VALUE:
- The default value is ``RTEMS_DEFAULT_ATTRIBUTES``.
+ The default value is :c:macro:`RTEMS_DEFAULT_ATTRIBUTES`.
VALUE CONSTRAINTS:
The value of this configuration option shall be a valid task attribute set.
@@ -104,8 +104,8 @@ OPTION TYPE:
This configuration option is an integer define.
DEFAULT VALUE:
- In SMP configurations, the default value is ``RTEMS_DEFAULT_MODES``,
- otherwise the default value is ``RTEMS_NO_PREEMPT``.
+ In SMP configurations, the default value is :c:macro:`RTEMS_DEFAULT_MODES`
+ otherwise the default value is :c:macro:`RTEMS_NO_PREEMPT`.
VALUE CONSTRAINTS:
The value of this configuration option shall be a valid task mode set.
@@ -135,7 +135,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be a valid integer of type
- ``rtems_name``.
+ :c:type:`rtems_name`.
DESCRIPTION:
The value of this configuration option defines the name of the Classic API
@@ -195,7 +195,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the task
stack space calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``uintptr_t``.
+ overflow an integer of type :c:type:`uintptr_t`.
DESCRIPTION:
The value of this configuration option defines the task stack size of the
diff --git a/c-user/config/device-driver.rst b/c-user/config/device-driver.rst
index 627c346..f1e06f4 100644
--- a/c-user/config/device-driver.rst
+++ b/c-user/config/device-driver.rst
@@ -169,7 +169,7 @@ NOTES:
The
- * :ref:`CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER`,
+ * ``CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER``,
* :ref:`CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER`, and
@@ -311,9 +311,9 @@ NOTES:
device file. This device is used to initialize the standard input, output,
and error file descriptors.
- This device driver reads via :c:func:`getchark`.
+ This device driver reads via :c:func:`rtems_putc`.
- This device driver writes via :c:func:`rtems_putc`.
+ This device driver writes via :c:func:`getchark`.
The Termios framework is not used. There is no support to change device
settings, e.g. baud, stop bits, parity, etc.
@@ -322,7 +322,7 @@ NOTES:
* :ref:`CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER`,
- * :ref:`CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER`, and
+ * ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER``, and
* :ref:`CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER`
@@ -354,17 +354,17 @@ NOTES:
device file. This device is used to initialize the standard input, output,
and error file descriptors.
- This device driver reads via :c:func:`getchark`.
+ This device driver reads via :c:func:`rtems_putc`.
This device driver writes into a write buffer. The count of characters
written into the write buffer is returned. It might be less than the
requested count, in case the write buffer is full. The write is
non-blocking and may be called from interrupt context. A dedicated task
reads from the write buffer and outputs the characters via
- :c:func:`rtems_putc`. This task runs with the least important priority.
+ :c:func:`getchark`. This task runs with the least important priority.
The write buffer size is 2047 characters and it is not configurable.
- Use ``fsync(STDOUT_FILENO)`` or ``fdatasync(STDOUT_FILENO)`` to drain the
+ Use ``fsync( STDOUT_FILENO )`` or ``fdatasync( STDOUT_FILENO )`` to drain the
write buffer.
The Termios framework is not used. There is no support to change device
@@ -376,7 +376,7 @@ NOTES:
* :ref:`CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER`, and
- * :ref:`CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER`
+ * ``CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER``
configuration options are mutually exclusive.
@@ -566,15 +566,49 @@ OPTION TYPE:
This configuration option is an integer define.
DEFAULT VALUE:
- This is computed by default, and is set to the number of device drivers
- configured using the ``CONFIGURE_APPLICATIONS_NEEDS_XXX_DRIVER``
- configuration options.
+ This is computed by default, and is set to the number of statically
+ configured device drivers configured using the following configuration
+ options:
+
+ * :ref:`CONFIGURE_APPLICATION_EXTRA_DRIVERS`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_ATA_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_FRAME_BUFFER_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_IDE_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_LIBBLOCK`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_NULL_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_RTC_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_SIMPLE_CONSOLE_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_SIMPLE_TASK_CONSOLE_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_STUB_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_TIMER_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_WATCHDOG_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_NEEDS_ZERO_DRIVER`
+
+ * :ref:`CONFIGURE_APPLICATION_PREREQUISITE_DRIVERS`
+
+ * :ref:`CONFIGURE_BSP_PREREQUISITE_DRIVERS`
VALUE CONSTRAINTS:
The value of this configuration option shall satisfy all of the following
constraints:
- * It shall be less than or equal to ``SIZE_MAX``.
+ * It shall be less than or equal to :c:macro:`SIZE_MAX`.
* It shall be greater than or equal than the number of statically configured
device drivers.
@@ -587,8 +621,6 @@ DESCRIPTION:
The value of this configuration option defines the number of device drivers.
NOTES:
- If the application will dynamically install device drivers, then this
- configuration parameter shall be larger than the number of statically
- configured device drivers. Drivers configured using the
- ``CONFIGURE_APPLICATIONS_NEEDS_XXX_DRIVER`` configuration options are
- statically installed.
+ If the application will dynamically install device drivers, then the
+ configuration option value shall be larger than the number of statically
+ configured device drivers.
diff --git a/c-user/config/event-record.rst b/c-user/config/event-record.rst
index 6c93a3a..755e662 100644
--- a/c-user/config/event-record.rst
+++ b/c-user/config/event-record.rst
@@ -122,7 +122,7 @@ VALUE CONSTRAINTS:
* It shall be greater than or equal to 16.
- * It shall be less than or equal to ``SIZE_MAX``.
+ * It shall be less than or equal to :c:macro:`SIZE_MAX`.
* It shall be a power of two.
diff --git a/c-user/config/filesystem.rst b/c-user/config/filesystem.rst
index 8d1efbd..ffb8e80 100644
--- a/c-user/config/filesystem.rst
+++ b/c-user/config/filesystem.rst
@@ -455,7 +455,8 @@ DEFAULT CONFIGURATION:
DESCRIPTION:
In case this configuration option is defined, then the root IMFS does not
- support mounting other filesystems (no support for :c:func:`mount`).
+ support mounting other filesystems (no support for
+ :c:func:`mount`).
NOTES:
None.
@@ -479,8 +480,8 @@ DEFAULT CONFIGURATION:
DESCRIPTION:
In case this configuration option is defined, then the root IMFS does not
- support reading directories (no support for :c:func:`readdir`). It is still
- possible to open files in a directory.
+ support reading directories (no support for :c:func:`readdir`). It is
+ still possible to open files in a directory.
NOTES:
None.
@@ -600,7 +601,8 @@ DEFAULT CONFIGURATION:
DESCRIPTION:
In case this configuration option is defined, then the root IMFS does not
- support unmounting other filesystems (no support for :c:func:`unmount`).
+ support unmounting other filesystems (no support for
+ :c:func:`unmount`).
NOTES:
None.
diff --git a/c-user/config/general.rst b/c-user/config/general.rst
index 4fa03f9..99036e5 100644
--- a/c-user/config/general.rst
+++ b/c-user/config/general.rst
@@ -63,8 +63,8 @@ DESCRIPTION:
NOTES:
You can enable this option to reduce the size of the :term:`TCB`. Use this
option with care, since it can lead to race conditions and undefined system
- behaviour. For example, :c:data:`errno` is no longer a thread-local variable
- if this option is enabled.
+ behaviour. For example, :c:macro:`errno` is no longer a thread-local
+ variable if this option is enabled.
.. index:: CONFIGURE_EXECUTIVE_RAM_SIZE
@@ -90,7 +90,7 @@ VALUE CONSTRAINTS:
* It shall be greater than or equal to 0.
- * It shall be less than or equal to ``UINTPTR_MAX``.
+ * It shall be less than or equal to :c:macro:`UINTPTR_MAX`.
* It shall be less than or equal to a
BSP-specific and application-specific value which depends on the size of the
@@ -129,7 +129,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the task
stack space calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``uintptr_t``.
+ overflow an integer of type :c:type:`uintptr_t`.
DESCRIPTION:
The value of this configuration option defines the number of bytes the
@@ -186,7 +186,7 @@ OPTION TYPE:
DEFAULT VALUE:
The default value is :ref:`BSP_INTERRUPT_STACK_SIZE` in case it is defined,
- otherwise the default value is ``CPU_STACK_MINIMUM_SIZE``.
+ otherwise the default value is :c:macro:`CPU_STACK_MINIMUM_SIZE`.
VALUE CONSTRAINTS:
The value of this configuration option shall satisfy all of the following
@@ -197,10 +197,10 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the
interrupt stack area calculation carried out by ``<rtems/confdefs.h>`` does
- not overflow an integer of type ``size_t``.
+ not overflow an integer of type :c:type:`size_t`.
* It shall be aligned according to
- ``CPU_INTERRUPT_STACK_ALIGNMENT``.
+ :c:macro:`CPU_INTERRUPT_STACK_ALIGNMENT`.
DESCRIPTION:
The value of this configuration option defines the size of an interrupt stack
@@ -221,7 +221,8 @@ NOTES:
size may still result in undefined behaviour.
In releases before RTEMS 5.1 the default value was
- :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE` instead of ``CPU_STACK_MINIMUM_SIZE``.
+ :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE` instead of
+ :c:macro:`CPU_STACK_MINIMUM_SIZE`.
.. index:: CONFIGURE_MALLOC_DIRTY
@@ -274,7 +275,7 @@ VALUE CONSTRAINTS:
* It shall be greater than or equal to 0.
- * It shall be less than or equal to ``SIZE_MAX``.
+ * It shall be less than or equal to :c:macro:`SIZE_MAX`.
* It shall be less than or equal to a
BSP-specific and application-specific value which depends on the size of the
@@ -286,7 +287,7 @@ DESCRIPTION:
NOTES:
The default value of three file descriptors allows RTEMS to support standard
- input, output, and error I/O streams on ``/dev/console``.
+ input, output, and error I/O streams on :file:`/dev/console`.
.. index:: CONFIGURE_MAXIMUM_PROCESSORS
@@ -306,7 +307,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 1
- and less than or equal to ``CPU_MAXIMUM_PROCESSORS``.
+ and less than or equal to :c:macro:`CPU_MAXIMUM_PROCESSORS`.
DESCRIPTION:
The value of this configuration option defines the maximum number of
@@ -346,7 +347,7 @@ VALUE CONSTRAINTS:
* It shall be greater than or equal to 0.
- * It shall be less than or equal to ``SIZE_MAX``.
+ * It shall be less than or equal to :c:macro:`SIZE_MAX`.
* It shall be less than or equal to a
BSP-specific and application-specific value which depends on the size of the
@@ -393,7 +394,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the
RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` does
- not overflow an integer of type ``uintptr_t``.
+ not overflow an integer of type :c:type:`uintptr_t`.
DESCRIPTION:
The value of this configuration option defines the number of kilobytes the
@@ -438,7 +439,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the
RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` does
- not overflow an integer of type ``uintptr_t``.
+ not overflow an integer of type :c:type:`uintptr_t`.
DESCRIPTION:
The value of this configuration option defines the number of bytes reserved
@@ -449,7 +450,7 @@ NOTES:
:ref:`CONFIGURE_MAXIMUM_POSIX_MESSAGE_QUEUES` define only how many message
queues can be created by the application. The memory for the message
buffers is configured by this option. For each message queue you have to
- reserve some memory for the message buffers. The size dependes on the
+ reserve some memory for the message buffers. The size depends on the
maximum number of pending messages and the maximum size of the messages of
a message queue. Use the ``CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE()`` macro
to specify the message buffer memory for each message queue and sum them up
@@ -470,7 +471,7 @@ NOTES:
RTEMS Workspace size.
The following example illustrates how the
- `CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE()` help macro can be used to assist in
+ ``CONFIGURE_MESSAGE_BUFFERS_FOR_QUEUE()`` help macro can be used to assist in
calculating the message buffer memory required. In this example, there are
two message queues used in this application. The first message queue has a
maximum of 24 pending messages with the message structure defined by the
@@ -560,7 +561,7 @@ OPTION TYPE:
This configuration option is an integer define.
DEFAULT VALUE:
- The default value is ``CPU_STACK_MINIMUM_SIZE``.
+ The default value is :c:macro:`CPU_STACK_MINIMUM_SIZE`.
VALUE CONSTRAINTS:
The value of this configuration option shall satisfy all of the following
@@ -568,7 +569,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the task
stack space calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``uintptr_t``.
+ overflow an integer of type :c:type:`uintptr_t`.
* It shall be greater than or equal to a
BSP-specific and application-specific minimum value.
@@ -646,7 +647,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the length of the timeslice
@@ -716,7 +717,7 @@ DESCRIPTION:
If :ref:`CONFIGURE_UNLIMITED_OBJECTS` is defined, then the value of this
configuration option defines the default objects maximum of all object
classes supporting :ref:`ConfigUnlimitedObjects` to
- ``rtems_resource_unlimited(CONFIGURE_UNLIMITED_ALLOCATION_SIZE)``.
+ ``rtems_resource_unlimited( CONFIGURE_UNLIMITED_ALLOCATION_SIZE )``.
NOTES:
By allowing users to declare all resources as being unlimited the user can
diff --git a/c-user/config/idle-task.rst b/c-user/config/idle-task.rst
index 12e7f46..2faf775 100644
--- a/c-user/config/idle-task.rst
+++ b/c-user/config/idle-task.rst
@@ -111,7 +111,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the IDLE
task stack area calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``size_t``.
+ overflow an integer of type :c:type:`size_t`.
DESCRIPTION:
The value of this configuration option defines the task stack size for an
diff --git a/c-user/config/mpci.rst b/c-user/config/mpci.rst
index 1413474..af24bb0 100644
--- a/c-user/config/mpci.rst
+++ b/c-user/config/mpci.rst
@@ -35,11 +35,12 @@ VALUE CONSTRAINTS:
* It shall be greater than or equal to 0.
- * It shall be less than or equal to ``UINT32_MAX``.
+ * It shall be less than or equal to :c:macro:`UINT32_MAX`.
* It shall be small enough so that the
MPCI receive server stack area calculation carried out by
- ``<rtems/confdefs.h>`` does not overflow an integer of type ``size_t``.
+ ``<rtems/confdefs.h>`` does not overflow an integer of type
+ :c:type:`size_t`.
DESCRIPTION:
The value of this configuration option defines the number of bytes the
@@ -96,7 +97,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the maximum number of
@@ -104,7 +105,7 @@ DESCRIPTION:
NOTES:
This value corresponds to the total number of objects which can be created
- with the ``RTEMS_GLOBAL`` attribute.
+ with the :c:macro:`RTEMS_GLOBAL` attribute.
This configuration option is only evaluated if
:ref:`CONFIGURE_MP_APPLICATION` is defined.
@@ -127,7 +128,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the maximum number of nodes in
@@ -155,7 +156,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the maximum number of
@@ -221,7 +222,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be greater than or equal to 0
- and less than or equal to ``UINT32_MAX``.
+ and less than or equal to :c:macro:`UINT32_MAX`.
DESCRIPTION:
The value of this configuration option defines the node number of this node
diff --git a/c-user/config/posix-api.rst b/c-user/config/posix-api.rst
index 6603b66..07ee7e8 100644
--- a/c-user/config/posix-api.rst
+++ b/c-user/config/posix-api.rst
@@ -129,7 +129,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the
RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` does
- not overflow an integer of type ``uintptr_t``.
+ not overflow an integer of type :c:type:`uintptr_t`.
* It may be defined through
:c:func:`rtems_resource_unlimited` the enable unlimited objects for this
@@ -174,7 +174,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the
RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` does
- not overflow an integer of type ``uintptr_t``.
+ not overflow an integer of type :c:type:`uintptr_t`.
* It shall be zero if the POSIX API is not
enabled (e.g. RTEMS was built without the ``--enable-posix`` build
@@ -221,7 +221,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the
RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` does
- not overflow an integer of type ``uintptr_t``.
+ not overflow an integer of type :c:type:`uintptr_t`.
* It may be defined through
:c:func:`rtems_resource_unlimited` the enable unlimited objects for this
@@ -236,9 +236,10 @@ NOTES:
This object class can be configured in unlimited allocation mode, see
:ref:`ConfigUnlimitedObjects`.
- Named semaphores are created with :c:func:`sem_open()`. Semaphores
- initialized with :c:func:`sem_init()` are not affected by this configuration
- option since the storage space for these semaphores is user-provided.
+ Named semaphores are created with :c:func:`sem_open`. Semaphores
+ initialized with :c:func:`sem_init` are not affected by this
+ configuration option since the storage space for these semaphores is
+ user-provided.
.. index:: CONFIGURE_MAXIMUM_POSIX_SHMS
@@ -270,7 +271,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the
RTEMS Workspace size calculation carried out by ``<rtems/confdefs.h>`` does
- not overflow an integer of type ``uintptr_t``.
+ not overflow an integer of type :c:type:`uintptr_t`.
* It may be defined through
:c:func:`rtems_resource_unlimited` the enable unlimited objects for this
@@ -315,7 +316,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the task
stack space calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``uintptr_t``.
+ overflow an integer of type :c:type:`uintptr_t`.
DESCRIPTION:
The value of this configuration option defines the maximum number of POSIX
@@ -408,7 +409,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the task
stack space calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``uintptr_t``.
+ overflow an integer of type :c:type:`uintptr_t`.
* It shall be greater than or equal to a
BSP-specific and application-specific minimum value.
diff --git a/c-user/config/posix-init-thread.rst b/c-user/config/posix-init-thread.rst
index 65ccfe8..b9d38e1 100644
--- a/c-user/config/posix-init-thread.rst
+++ b/c-user/config/posix-init-thread.rst
@@ -61,7 +61,7 @@ VALUE CONSTRAINTS:
* It shall be small enough so that the task
stack space calculation carried out by ``<rtems/confdefs.h>`` does not
- overflow an integer of type ``uintptr_t``.
+ overflow an integer of type :c:type:`uintptr_t`.
DESCRIPTION:
The value of this configuration option defines the thread stack size of the
diff --git a/c-user/config/scheduler-general.rst b/c-user/config/scheduler-general.rst
index 68e7a45..0226868 100644
--- a/c-user/config/scheduler-general.rst
+++ b/c-user/config/scheduler-general.rst
@@ -52,7 +52,7 @@ VALUE CONSTRAINTS:
* It shall be greater than or equal to 0.
- * It shall be less than or equal to ``SIZE_MAX``.
+ * It shall be less than or equal to :c:macro:`SIZE_MAX`.
* It shall be less than or equal to a
BSP-specific and application-specific value which depends on the size of the
@@ -150,7 +150,7 @@ VALUE CONSTRAINTS:
* ``RTEMS_SCHEDULER_ASSIGN( processor_index, attributes )``
- * :c:macro:`RTEMS_SCHEDULER_ASSIGN_NO_SCHEDULER`
+ * ``RTEMS_SCHEDULER_ASSIGN_NO_SCHEDULER``
* It shall be a list of exactly
:ref:`CONFIGURE_MAXIMUM_PROCESSORS` elements.
@@ -293,7 +293,7 @@ DEFAULT VALUE:
VALUE CONSTRAINTS:
The value of this configuration option shall be a valid integer of type
- ``rtems_name``.
+ :c:type:`rtems_name`.
DESCRIPTION:
The value of this configuration option defines the name of the default
@@ -303,7 +303,7 @@ NOTES:
This scheduler configuration option is an advanced configuration option.
Think twice before you use it.
- Schedulers can be identified via c:func:`rtems_scheduler_ident`.
+ Schedulers can be identified via :c:func:`rtems_scheduler_ident`.
Use :c:func:`rtems_build_name` to define the scheduler name.
diff --git a/c-user/config/task-stack-alloc.rst b/c-user/config/task-stack-alloc.rst
index 203757a..1676151 100644
--- a/c-user/config/task-stack-alloc.rst
+++ b/c-user/config/task-stack-alloc.rst
@@ -43,7 +43,7 @@ NOTES:
* :ref:`CONFIGURE_TASK_STACK_ALLOCATOR_INIT`
- * `CONFIGURE_TASK_STACK_ALLOCATOR`
+ * ``CONFIGURE_TASK_STACK_ALLOCATOR``
* :ref:`CONFIGURE_TASK_STACK_DEALLOCATOR`
@@ -86,11 +86,12 @@ OPTION TYPE:
This configuration option is an initializer define.
DEFAULT VALUE:
- The default value is ``NULL``.
+ The default value is :c:macro:`NULL`.
VALUE CONSTRAINTS:
The value of this configuration option shall be defined to a valid function
- pointer of the type ``void ( *initialize )( size_t )`` or to ``NULL``.
+ pointer of the type ``void ( *initialize )( size_t )`` or to
+ :c:macro:`NULL`.
DESCRIPTION:
The value of this configuration option initializes the stack allocator
@@ -99,7 +100,7 @@ DESCRIPTION:
NOTES:
A correctly configured system shall configure the following to be consistent:
- * `CONFIGURE_TASK_STACK_ALLOCATOR_INIT`
+ * ``CONFIGURE_TASK_STACK_ALLOCATOR_INIT``
* :ref:`CONFIGURE_TASK_STACK_ALLOCATOR`
@@ -138,7 +139,7 @@ NOTES:
* :ref:`CONFIGURE_TASK_STACK_ALLOCATOR`
- * `CONFIGURE_TASK_STACK_DEALLOCATOR`
+ * ``CONFIGURE_TASK_STACK_DEALLOCATOR``
.. index:: CONFIGURE_TASK_STACK_FROM_ALLOCATOR
.. index:: task stack allocator
--
2.26.2
More information about the devel
mailing list