[PATCH] c-user: Reformat configuration option constraints
Gedare Bloom
gedare at rtems.org
Thu Apr 29 15:56:59 UTC 2021
ok
On Wed, Apr 28, 2021 at 11:30 PM Sebastian Huber
<sebastian.huber at embedded-brains.de> wrote:
>
> If only one constraint is present, then use a single sentence, otherwise
> use a list for the constraints. Format the constraints so that the line
> length limit is maintained.
> ---
> c-user/config/bdbuf.rst | 94 ++++++++++-----
> c-user/config/bsp-related.rst | 22 ++--
> c-user/config/classic-api.rst | 176 ++++++++++++++--------------
> c-user/config/classic-init-task.rst | 28 +++--
> c-user/config/device-driver.rst | 18 +--
> c-user/config/event-record.rst | 11 +-
> c-user/config/filesystem.rst | 6 +-
> c-user/config/general.rst | 114 ++++++++++--------
> c-user/config/idle-task.rst | 12 +-
> c-user/config/mpci.rst | 50 +++++---
> c-user/config/posix-api.rst | 168 +++++++++++++-------------
> c-user/config/posix-init-thread.rst | 11 +-
> c-user/config/scheduler-general.rst | 28 ++---
> c-user/config/task-stack-alloc.rst | 6 +-
> 14 files changed, 414 insertions(+), 330 deletions(-)
>
> diff --git a/c-user/config/bdbuf.rst b/c-user/config/bdbuf.rst
> index 7377bee..c5381e1 100644
> --- a/c-user/config/bdbuf.rst
> +++ b/c-user/config/bdbuf.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -76,9 +76,10 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be an integral multiple of :ref:`CONFIGURE_BDBUF_BUFFER_MIN_SIZE`.
> + * It shall be an integral multiple of
> + :ref:`CONFIGURE_BDBUF_BUFFER_MIN_SIZE`.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum size of a buffer
> @@ -106,8 +107,13 @@ DEFAULT VALUE:
> The default value is 512.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the minimum size of a buffer
> @@ -135,8 +141,13 @@ DEFAULT VALUE:
> The default value is 32768.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `SIZE_MAX <https://en.cppreference.com/w/c/types/limits>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `SIZE_MAX
> + <https://en.cppreference.com/w/c/types/limits>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the size of the cache memory
> @@ -164,8 +175,13 @@ DEFAULT VALUE:
> The default value is 0.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum blocks per
> @@ -195,8 +211,13 @@ DEFAULT VALUE:
> The default value is 16.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum blocks per write
> @@ -225,7 +246,8 @@ DEFAULT VALUE:
>
> VALUE CONSTRAINTS:
> The value of this configuration option shall be a valid Classic API task
> - priority. The set of valid task priorities is scheduler-specific.
> + priority. The set of valid task priorities depends on the scheduler
> + configuration.
>
> DESCRIPTION:
> The value of this configuration option defines the read-ahead task priority.
> @@ -255,15 +277,16 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.
> + * It shall be greater than or equal to
> + :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the task stack size of the
> @@ -291,8 +314,13 @@ DEFAULT VALUE:
> The default value is 1000.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the swapout task maximum block
> @@ -320,8 +348,13 @@ DEFAULT VALUE:
> The default value is 250.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the swapout task swap period
> @@ -350,7 +383,8 @@ DEFAULT VALUE:
>
> VALUE CONSTRAINTS:
> The value of this configuration option shall be a valid Classic API task
> - priority. The set of valid task priorities is scheduler-specific.
> + priority. The set of valid task priorities depends on the scheduler
> + configuration.
>
> DESCRIPTION:
> The value of this configuration option defines the swapout task priority.
> @@ -377,8 +411,13 @@ DEFAULT VALUE:
> The default value is 0.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the swapout worker task count.
> @@ -406,7 +445,8 @@ DEFAULT VALUE:
>
> VALUE CONSTRAINTS:
> The value of this configuration option shall be a valid Classic API task
> - priority. The set of valid task priorities is scheduler-specific.
> + priority. The set of valid task priorities depends on the scheduler
> + configuration.
>
> DESCRIPTION:
> The value of this configuration option defines the swapout worker task
> diff --git a/c-user/config/bsp-related.rst b/c-user/config/bsp-related.rst
> index e56cee4..4b6848d 100644
> --- a/c-user/config/bsp-related.rst
> +++ b/c-user/config/bsp-related.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -87,12 +87,12 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to a
> - BSP-specific and application-specific minimum value.
> + * It shall be greater than or equal to a BSP-specific and
> + application-specific minimum value.
>
> - * 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 <https://en.cppreference.com/w/c/types/size_t>`_.
> + * 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 <https://en.cppreference.com/w/c/types/size_t>`_.
>
> DESCRIPTION:
> If
> @@ -165,12 +165,12 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to a
> - BSP-specific and application-specific minimum value.
> + * It shall be greater than or equal to a BSP-specific and
> + application-specific minimum value.
>
> - * 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 <https://en.cppreference.com/w/c/types/size_t>`_.
> + * 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 <https://en.cppreference.com/w/c/types/size_t>`_.
>
> * It shall be aligned according to
> :c:macro:`CPU_INTERRUPT_STACK_ALIGNMENT`.
> diff --git a/c-user/config/classic-api.rst b/c-user/config/classic-api.rst
> index 74a8257..4643572 100644
> --- a/c-user/config/classic-api.rst
> +++ b/c-user/config/classic-api.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -47,18 +47,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -90,18 +90,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -135,18 +135,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -178,18 +178,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -221,18 +221,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -264,18 +264,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -307,18 +307,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -354,22 +354,22 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -414,11 +414,13 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be less than or equal to `SIZE_MAX <https://en.cppreference.com/w/c/types/limits>`_.
> + * It shall be less than or equal to `SIZE_MAX
> + <https://en.cppreference.com/w/c/types/limits>`_.
>
> - * It shall be an integral multiple of :c:macro:`RTEMS_TASK_STORAGE_ALIGNMENT`.
> + * It shall be an integral multiple of
> + :c:macro:`RTEMS_TASK_STORAGE_ALIGNMENT`.
>
> DESCRIPTION:
> If the value of this configuration option is greater than zero, then it
> @@ -466,18 +468,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -509,13 +511,13 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of Classic
> @@ -543,8 +545,12 @@ DEFAULT VALUE:
> The default value is 0.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to :ref:`CONFIGURE_MAXIMUM_TASKS`.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to :ref:`CONFIGURE_MAXIMUM_TASKS`.
>
> DESCRIPTION:
> The value of this configuration option defines the minimum count of Classic
> diff --git a/c-user/config/classic-init-task.rst b/c-user/config/classic-init-task.rst
> index 0743929..9c0435b 100644
> --- a/c-user/config/classic-init-task.rst
> +++ b/c-user/config/classic-init-task.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -45,8 +45,8 @@ DEFAULT VALUE:
> The default value is 0.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be a valid integer of type
> - :c:type:`rtems_task_argument`.
> + The value of this configuration option shall be convertible to an integer
> + of type :c:type:`rtems_task_argument`.
>
> DESCRIPTION:
> The value of this configuration option defines task argument of the Classic
> @@ -107,10 +107,10 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.
> + * It shall be greater than or equal to
> + :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.
>
> - * It shall be defined using
> - :c:func:`RTEMS_TASK_STORAGE_SIZE`.
> + * It shall be defined using :c:func:`RTEMS_TASK_STORAGE_SIZE`.
>
> DESCRIPTION:
> The value of this configuration option defines the task storage size of the
> @@ -222,8 +222,8 @@ DEFAULT VALUE:
> The default value is ``rtems_build_name( 'U', 'I', '1', ' ' )``.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be a valid integer of type
> - :c:type:`rtems_name`.
> + The value of this configuration option shall be convertible to an integer
> + of type :c:type:`rtems_name`.
>
> DESCRIPTION:
> The value of this configuration option defines the name of the Classic API
> @@ -252,7 +252,8 @@ DEFAULT VALUE:
>
> VALUE CONSTRAINTS:
> The value of this configuration option shall be a valid Classic API task
> - priority. The set of valid task priorities is scheduler-specific.
> + priority. The set of valid task priorities depends on the scheduler
> + configuration.
>
> DESCRIPTION:
> The value of this configuration option defines the initial priority of the
> @@ -283,11 +284,12 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.
> + * It shall be greater than or equal to
> + :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> 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 05ae08a..22002f9 100644
> --- a/c-user/config/device-driver.rst
> +++ b/c-user/config/device-driver.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -594,7 +594,8 @@ DEFAULT VALUE:
>
> VALUE CONSTRAINTS:
> The value of this configuration option shall be a valid Classic API task
> - priority. The set of valid task priorities is scheduler-specific.
> + priority. The set of valid task priorities depends on the scheduler
> + configuration.
>
> DESCRIPTION:
> The value of this configuration option defines the ATA task priority.
> @@ -661,14 +662,15 @@ 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 <https://en.cppreference.com/w/c/types/limits>`_.
> + * It shall be less than or equal to `SIZE_MAX
> + <https://en.cppreference.com/w/c/types/limits>`_.
>
> - * It shall be greater than or equal than the number of statically configured
> - device drivers.
> + * It shall be greater than or equal than the number of statically
> + configured device drivers.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> DESCRIPTION:
> The value of this configuration option defines the number of device drivers.
> diff --git a/c-user/config/event-record.rst b/c-user/config/event-record.rst
> index cbe02e3..fa1d011 100644
> --- a/c-user/config/event-record.rst
> +++ b/c-user/config/event-record.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2019, 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2019, 2021 embedded brains GmbH (http://www.embedded-brains.de)
>
> .. This file is part of the RTEMS quality process and was automatically
> .. generated. If you find something that needs to be fixed or
> @@ -147,13 +147,14 @@ VALUE CONSTRAINTS:
>
> * It shall be greater than or equal to 16.
>
> - * It shall be less than or equal to `SIZE_MAX <https://en.cppreference.com/w/c/types/limits>`_.
> + * It shall be less than or equal to `SIZE_MAX
> + <https://en.cppreference.com/w/c/types/limits>`_.
>
> * It shall be a power of two.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> DESCRIPTION:
> The value of this configuration option defines the event record item count
> diff --git a/c-user/config/filesystem.rst b/c-user/config/filesystem.rst
> index 5b1b414..05ca826 100644
> --- a/c-user/config/filesystem.rst
> +++ b/c-user/config/filesystem.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -739,8 +739,8 @@ DEFAULT VALUE:
> The default value is 128.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be
> - an element of {16, 32, 64, 128, 256, 512}.
> + The value of this configuration option shall be equal to 16, 32, 64, 128,
> + 256, or 512.
>
> DESCRIPTION:
> The value of this configuration option defines the block size for in-memory
> diff --git a/c-user/config/general.rst b/c-user/config/general.rst
> index 024b5c4..203c3e8 100644
> --- a/c-user/config/general.rst
> +++ b/c-user/config/general.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -111,13 +111,14 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be less than or equal to `UINTPTR_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + * It shall be less than or equal to `UINTPTR_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> DESCRIPTION:
> The value of this configuration option defines the RTEMS Workspace size in
> @@ -150,11 +151,11 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the number of bytes the
> @@ -221,12 +222,12 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to a
> - BSP-specific and application-specific minimum value.
> + * It shall be greater than or equal to a BSP-specific and
> + application-specific minimum value.
>
> - * 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 <https://en.cppreference.com/w/c/types/size_t>`_.
> + * 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 <https://en.cppreference.com/w/c/types/size_t>`_.
>
> * It shall be aligned according to
> :c:macro:`CPU_INTERRUPT_STACK_ALIGNMENT`.
> @@ -306,13 +307,14 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be less than or equal to `SIZE_MAX <https://en.cppreference.com/w/c/types/limits>`_.
> + * It shall be less than or equal to `SIZE_MAX
> + <https://en.cppreference.com/w/c/types/limits>`_.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of file
> @@ -341,8 +343,12 @@ DEFAULT VALUE:
> The default value is 1.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 1
> - and less than or equal to :c:macro:`CPU_MAXIMUM_PROCESSORS`.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to one.
> +
> + * It shall be less than or equal to :c:macro:`CPU_MAXIMUM_PROCESSORS`.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of
> @@ -382,13 +388,14 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be less than or equal to `SIZE_MAX <https://en.cppreference.com/w/c/types/limits>`_.
> + * It shall be less than or equal to `SIZE_MAX
> + <https://en.cppreference.com/w/c/types/limits>`_.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum thread name size
> @@ -425,15 +432,15 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the number of kilobytes the
> @@ -472,15 +479,15 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the number of bytes reserved
> @@ -557,9 +564,11 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to a Clock Driver specific value.
> + * It shall be greater than or equal to a value defined by the :term:`Clock
> + Driver`.
>
> - * It shall be less than or equal to a Clock Driver specific value.
> + * It shall be less than or equal to a value defined by the :term:`Clock
> + Driver`.
>
> * The resulting clock ticks per second should be an integer.
>
> @@ -612,12 +621,12 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> - * It shall be greater than or equal to a
> - BSP-specific and application-specific minimum value.
> + * It shall be greater than or equal to a BSP-specific and
> + application-specific minimum value.
>
> DESCRIPTION:
> The value of this configuration option defines the minimum stack size in
> @@ -695,8 +704,13 @@ DEFAULT VALUE:
> The default value is 50.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the length of the timeslice
> diff --git a/c-user/config/idle-task.rst b/c-user/config/idle-task.rst
> index 9330672..1234f42 100644
> --- a/c-user/config/idle-task.rst
> +++ b/c-user/config/idle-task.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -129,12 +129,12 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to a
> - BSP-specific and application-specific minimum value.
> + * It shall be greater than or equal to a BSP-specific and
> + application-specific minimum value.
>
> - * 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 <https://en.cppreference.com/w/c/types/size_t>`_.
> + * 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 <https://en.cppreference.com/w/c/types/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 0c967c6..800aa30 100644
> --- a/c-user/config/mpci.rst
> +++ b/c-user/config/mpci.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -52,14 +52,14 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> - * 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 <https://en.cppreference.com/w/c/types/size_t>`_.
> + * 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 <https://en.cppreference.com/w/c/types/size_t>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the number of bytes the
> @@ -119,8 +119,13 @@ DEFAULT VALUE:
> The default value is 32.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of
> @@ -152,8 +157,13 @@ DEFAULT VALUE:
> The default value is 2.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of nodes in
> @@ -182,8 +192,13 @@ DEFAULT VALUE:
> The default value is 32.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of
> @@ -252,8 +267,13 @@ DEFAULT VALUE:
> The default value is ``NODE_NUMBER``.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be greater than or equal to 0
> - and less than or equal to `UINT32_MAX <https://en.cppreference.com/w/c/types/integer>`_.
> + The value of this configuration option shall satisfy all of the following
> + constraints:
> +
> + * It shall be greater than or equal to zero.
> +
> + * It shall be less than or equal to `UINT32_MAX
> + <https://en.cppreference.com/w/c/types/integer>`_.
>
> 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 592a1ce..3c2c8a2 100644
> --- a/c-user/config/posix-api.rst
> +++ b/c-user/config/posix-api.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -50,18 +50,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of POSIX
> @@ -96,18 +96,18 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of key
> @@ -142,22 +142,22 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of POSIX
> @@ -191,20 +191,19 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> - * It shall be zero if the POSIX API is not
> - enabled (e.g. RTEMS was built without the ``--enable-posix`` build
> - configuration option). Otherwise a compile time error in the configuration
> - file will occur.
> + * It shall be zero if the POSIX API is not enabled (e.g. RTEMS was built
> + without the ``RTEMS_POSIX_API = True`` build configuration option).
> + Otherwise a compile time error in the configuration file will occur.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of POSIX
> @@ -238,22 +237,22 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of POSIX
> @@ -290,22 +289,22 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of POSIX
> @@ -337,17 +336,17 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of POSIX
> @@ -389,23 +388,22 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> * It shall be less than or equal to 65535.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> - * It may be defined through
> - :c:func:`rtems_resource_unlimited` the enable unlimited objects for this
> - object class, if the value passed to :c:func:`rtems_resource_unlimited`
> - satisfies all other constraints of this configuration option.
> + * It may be defined through :c:func:`rtems_resource_unlimited` the enable
> + unlimited objects for the object class, if the value passed to
> + :c:func:`rtems_resource_unlimited` satisfies all other constraints of the
> + configuration option.
>
> - * It shall be zero if the POSIX API is not
> - enabled (e.g. RTEMS was built without the ``--enable-posix`` build
> - configuration option). Otherwise a compile time error in the configuration
> - file will occur.
> + * It shall be zero if the POSIX API is not enabled (e.g. RTEMS was built
> + without the ``RTEMS_POSIX_API = True`` build configuration option).
> + Otherwise a compile time error in the configuration file will occur.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number of POSIX
> @@ -442,12 +440,12 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> - * It shall be greater than or equal to a
> - BSP-specific and application-specific minimum value.
> + * It shall be greater than or equal to a BSP-specific and
> + application-specific minimum value.
>
> DESCRIPTION:
> The value of this configuration option defines the minimum stack size in
> diff --git a/c-user/config/posix-init-thread.rst b/c-user/config/posix-init-thread.rst
> index 42542e5..8623f2c 100644
> --- a/c-user/config/posix-init-thread.rst
> +++ b/c-user/config/posix-init-thread.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -78,11 +78,12 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.
> + * It shall be greater than or equal to
> + :ref:`CONFIGURE_MINIMUM_TASK_STACK_SIZE`.
>
> - * 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 <https://en.cppreference.com/w/c/types/integer>`_.
> + * 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 <https://en.cppreference.com/w/c/types/integer>`_.
>
> 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 cbdb145..4fe840f 100644
> --- a/c-user/config/scheduler-general.rst
> +++ b/c-user/config/scheduler-general.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 2010 Gedare Bloom
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> @@ -69,13 +69,14 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be greater than or equal to 0.
> + * It shall be greater than or equal to zero.
>
> - * It shall be less than or equal to `SIZE_MAX <https://en.cppreference.com/w/c/types/limits>`_.
> + * It shall be less than or equal to `SIZE_MAX
> + <https://en.cppreference.com/w/c/types/limits>`_.
>
> - * It shall be less than or equal to a
> - BSP-specific and application-specific value which depends on the size of the
> - memory available to the application.
> + * It shall be less than or equal to a BSP-specific and application-specific
> + value which depends on the size of the memory available to the
> + application.
>
> DESCRIPTION:
> The value of this configuration option defines the maximum number Constant
> @@ -106,8 +107,8 @@ DEFAULT VALUE:
> The default value is 255.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be
> - an element of {3, 7, 31, 63, 127, 255}.
> + The value of this configuration option shall be equal to 3, 7, 31, 63, 127,
> + or 255.
>
> DESCRIPTION:
> For the following schedulers
> @@ -168,15 +169,14 @@ VALUE CONSTRAINTS:
> The value of this configuration option shall satisfy all of the following
> constraints:
>
> - * It shall be a list of the following
> - macros:
> + * It shall be a list of the following macros:
>
> * ``RTEMS_SCHEDULER_ASSIGN( processor_index, attributes )``
>
> * ``RTEMS_SCHEDULER_ASSIGN_NO_SCHEDULER``
>
> - * It shall be a list of exactly
> - :ref:`CONFIGURE_MAXIMUM_PROCESSORS` elements.
> + * It shall be a list of exactly :ref:`CONFIGURE_MAXIMUM_PROCESSORS`
> + elements.
>
> DESCRIPTION:
> The value of this configuration option is used to initialize the initial
> @@ -323,8 +323,8 @@ DEFAULT VALUE:
> * ``"UPS "`` for the :ref:`SchedulerPrioritySimple`.
>
> VALUE CONSTRAINTS:
> - The value of this configuration option shall be a valid integer of type
> - :c:type:`rtems_name`.
> + The value of this configuration option shall be convertible to an integer
> + of type :c:type:`rtems_name`.
>
> DESCRIPTION:
> The value of this configuration option defines the name of the default
> diff --git a/c-user/config/task-stack-alloc.rst b/c-user/config/task-stack-alloc.rst
> index cd174ed..3f779ff 100644
> --- a/c-user/config/task-stack-alloc.rst
> +++ b/c-user/config/task-stack-alloc.rst
> @@ -1,6 +1,6 @@
> .. SPDX-License-Identifier: CC-BY-SA-4.0
>
> -.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
> +.. Copyright (C) 2020, 2021 embedded brains GmbH (http://www.embedded-brains.de)
> .. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
>
> .. This file is part of the RTEMS quality process and was automatically
> @@ -113,8 +113,8 @@ DEFAULT VALUE:
>
> 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 <https://en.cppreference.com/w/c/types/NULL>`_.
> + pointer of the type ``void ( *initialize )( size_t )`` or to `NULL
> + <https://en.cppreference.com/w/c/types/NULL>`_.
>
> DESCRIPTION:
> The value of this configuration option initializes the stack allocator
> --
> 2.26.2
>
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel
More information about the devel
mailing list