[PATCH] c-user: Use a common phrase for pointer parameters
Sebastian Huber
sebastian.huber at embedded-brains.de
Mon Jun 14 07:20:25 UTC 2021
Mention the type of the pointer in the parameter description. Use the
more general term "object" instead of "variable".
Update #3993.
---
c-user/barrier/directives.rst | 15 +++----
c-user/clock/directives.rst | 44 +++++++++++---------
c-user/dual-ported-memory/directives.rst | 20 ++++-----
c-user/interrupt/directives.rst | 7 ++--
c-user/io/directives.rst | 6 +--
c-user/message/directives.rst | 28 ++++++-------
c-user/object-services/directives.rst | 11 ++---
c-user/partition/directives.rst | 12 +++---
c-user/rate-monotonic/directives.rst | 20 ++++-----
c-user/region/directives.rst | 32 +++++++--------
c-user/scheduling-concepts/directives.rst | 41 +++++++++----------
c-user/semaphore/directives.rst | 14 +++----
c-user/task/directives.rst | 50 +++++++++++------------
c-user/timer/directives.rst | 14 +++----
c-user/user-extensions/directives.rst | 8 ++--
15 files changed, 163 insertions(+), 159 deletions(-)
diff --git a/c-user/barrier/directives.rst b/c-user/barrier/directives.rst
index ec40844..59abc51 100644
--- a/c-user/barrier/directives.rst
+++ b/c-user/barrier/directives.rst
@@ -67,9 +67,9 @@ Creates a barrier.
barrier.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created barrier will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -175,9 +175,9 @@ Identifies a barrier by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -380,9 +380,10 @@ Releases the barrier.
This parameter is the barrier identifier.
``released``
- This parameter is the pointer to an integer variable. When the directive
- call is successful, the number of released tasks will be stored in this
- variable.
+ This parameter is the pointer to an `uint32_t
+ <https://en.cppreference.com/w/c/types/integer>`_ object. When the
+ directive call is successful, the number of released tasks will be stored
+ in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/clock/directives.rst b/c-user/clock/directives.rst
index 4ed1c58..e0f858a 100644
--- a/c-user/clock/directives.rst
+++ b/c-user/clock/directives.rst
@@ -126,10 +126,10 @@ Gets the time of day associated with the current :term:`CLOCK_REALTIME`.
.. rubric:: PARAMETERS:
``time_of_day``
- This parameter is the pointer to a RTEMS time of day variable. When the
- directive call is successful, the time of day associated with the
+ This parameter is the pointer to an :c:type:`rtems_time_of_day` object.
+ When the directive call is successful, the time of day associated with the
:term:`CLOCK_REALTIME` at some point during the directive call will be
- stored in this variable.
+ stored in this object.
.. rubric:: RETURN VALUES:
@@ -179,10 +179,12 @@ current :term:`CLOCK_REALTIME`.
.. rubric:: PARAMETERS:
``time_of_day``
- This parameter is the pointer to a timeval structure variable. When the
- directive call is successful, the seconds and microseconds elapsed since
- the :term:`Unix epoch` and the :term:`CLOCK_REALTIME` at some point during
- the directive call will be stored in this variable.
+ This parameter is the pointer to a `struct timeval
+ <https://pubs.opengroup.org/onlinepubs/009695399/basedefs/sys/time.h.html>`_
+ object. When the directive call is successful, the seconds and
+ microseconds elapsed since the :term:`Unix epoch` and the
+ :term:`CLOCK_REALTIME` at some point during the directive call will be
+ stored in this object.
.. rubric:: RETURN VALUES:
@@ -234,10 +236,10 @@ Gets the seconds elapsed since the :term:`RTEMS epoch` and the current
.. rubric:: PARAMETERS:
``seconds_since_rtems_epoch``
- This parameter is the pointer to an interval variable. When the directive
- call is successful, the seconds elapsed since the :term:`RTEMS epoch` and
- the :term:`CLOCK_REALTIME` at some point during the directive call will be
- stored in this variable.
+ This parameter is the pointer to an :c:type:`rtems_interval` object. When
+ the directive call is successful, the seconds elapsed since the
+ :term:`RTEMS epoch` and the :term:`CLOCK_REALTIME` at some point during the
+ directive call will be stored in this object.
.. rubric:: RETURN VALUES:
@@ -370,11 +372,12 @@ system initialization using :term:`CLOCK_MONOTONIC`.
.. rubric:: PARAMETERS:
``uptime``
- This parameter is the pointer to a timeval structure variable. When the
- directive call is successful, the seconds and nanoseconds elapsed since
- some time point during the system initialization and some point during the
- directive call using :term:`CLOCK_MONOTONIC` will be stored in this
- variable.
+ This parameter is the pointer to a `struct timeval
+ <https://pubs.opengroup.org/onlinepubs/009695399/basedefs/sys/time.h.html>`_
+ object. When the directive call is successful, the seconds and nanoseconds
+ elapsed since some time point during the system initialization and some
+ point during the directive call using :term:`CLOCK_MONOTONIC` will be
+ stored in this object.
.. rubric:: RETURN VALUES:
@@ -420,10 +423,11 @@ system initialization using :term:`CLOCK_MONOTONIC`.
.. rubric:: PARAMETERS:
``uptime``
- This parameter is the pointer to a timeval structure variable. The seconds
- and microseconds elapsed since some time point during the system
- initialization and some point during the directive call using
- :term:`CLOCK_MONOTONIC` will be stored in this variable. The pointer shall
+ This parameter is the pointer to a `struct timeval
+ <https://pubs.opengroup.org/onlinepubs/009695399/basedefs/sys/time.h.html>`_
+ object. The seconds and microseconds elapsed since some time point during
+ the system initialization and some point during the directive call using
+ :term:`CLOCK_MONOTONIC` will be stored in this object. The pointer shall
be valid, otherwise the behaviour is undefined.
.. rubric:: CONSTRAINTS:
diff --git a/c-user/dual-ported-memory/directives.rst b/c-user/dual-ported-memory/directives.rst
index 42cb875..869fd4b 100644
--- a/c-user/dual-ported-memory/directives.rst
+++ b/c-user/dual-ported-memory/directives.rst
@@ -71,9 +71,9 @@ Creates a port.
This parameter is the length in bytes of the memory area.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created port will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -158,9 +158,9 @@ Identifies a port by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -297,9 +297,9 @@ Converts the external address to the internal address.
This parameter is the external address to convert.
``internal``
- This parameter is the pointer to a pointer variable. When the directive
- call is successful, the external address associated with the internal
- address will be stored in this variable.
+ This parameter is the pointer to a ``void`` pointer object. When the
+ directive call is successful, the external address associated with the
+ internal address will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -367,9 +367,9 @@ Converts the internal address to the external address.
This parameter is the internal address to convert.
``external``
- This parameter is the pointer to a pointer variable. When the directive
- call is successful, the external address associated with the internal
- address will be stored in this variable.
+ This parameter is the pointer to a ``void`` pointer object. When the
+ directive call is successful, the external address associated with the
+ internal address will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/interrupt/directives.rst b/c-user/interrupt/directives.rst
index 2b15fd6..f3a944d 100644
--- a/c-user/interrupt/directives.rst
+++ b/c-user/interrupt/directives.rst
@@ -63,10 +63,9 @@ Establishes an interrupt service routine.
This parameter is the interrupt vector number.
``old_isr_handler``
- This parameter is the pointer to an :c:type:`rtems_isr_entry` variable.
- When the directive call is successful, the previous interrupt service
- routine established for this interrupt vector will be stored in this
- variable.
+ This parameter is the pointer to an :c:type:`rtems_isr_entry` object. When
+ the directive call is successful, the previous interrupt service routine
+ established for this interrupt vector will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/io/directives.rst b/c-user/io/directives.rst
index 0683c4c..d308944 100644
--- a/c-user/io/directives.rst
+++ b/c-user/io/directives.rst
@@ -64,9 +64,9 @@ table and device major number in the Device Driver Table.
This parameter is the device driver address table.
``registered_major``
- This parameter is the pointer to a device major number variable. When the
- directive call is successful, the device major number of the registered
- device will be stored in this variable.
+ This parameter is the pointer to an :c:type:`rtems_device_major_number`
+ object. When the directive call is successful, the device major number of
+ the registered device will be stored in this object.
.. rubric:: RETURN VALUES:
diff --git a/c-user/message/directives.rst b/c-user/message/directives.rst
index 11ff105..f320350 100644
--- a/c-user/message/directives.rst
+++ b/c-user/message/directives.rst
@@ -72,9 +72,9 @@ Creates a message queue.
This parameter is the attribute set of the message queue.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created message queue
- will be stored in this variable.
+ will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -233,9 +233,9 @@ Constructs a message queue from the specified the message queue configuration.
This parameter is the message queue configuration.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the constructed message
- queue will be stored in this variable.
+ queue will be stored in this object.
.. rubric:: RETURN VALUES:
@@ -361,9 +361,9 @@ Identifies a message queue by the object name.
This parameter is the node or node set to search for a matching object.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -719,9 +719,9 @@ Broadcasts the messages to the tasks waiting at the queue.
``count``
This parameter is the pointer to an `uint32_t
- <https://en.cppreference.com/w/c/types/integer>`_ variable. When the
+ <https://en.cppreference.com/w/c/types/integer>`_ object. When the
directive call is successful, the number of unblocked tasks will be stored
- in this variable.
+ in this object.
.. rubric:: DESCRIPTION:
@@ -815,9 +815,9 @@ Receives a message from the queue.
``size``
This parameter is the pointer to a `size_t
- <https://en.cppreference.com/w/c/types/size_t>`_ variable. When the
+ <https://en.cppreference.com/w/c/types/size_t>`_ object. When the
directive call is successful, the size in bytes of the received messages
- will be stored in this variable. This parameter cannot be used to specify
+ will be stored in this object. This parameter cannot be used to specify
the size of the buffer.
``option_set``
@@ -954,9 +954,9 @@ Gets the number of messages pending on the queue.
``count``
This parameter is the pointer to an `uint32_t
- <https://en.cppreference.com/w/c/types/integer>`_ variable. When the
+ <https://en.cppreference.com/w/c/types/integer>`_ object. When the
directive call is successful, the number of pending messages will be stored
- in this variable.
+ in this object.
.. rubric:: DESCRIPTION:
@@ -1017,9 +1017,9 @@ Flushes all messages on the queue.
``count``
This parameter is the pointer to an `uint32_t
- <https://en.cppreference.com/w/c/types/integer>`_ variable. When the
+ <https://en.cppreference.com/w/c/types/integer>`_ object. When the
directive call is successful, the number of unblocked tasks will be stored
- in this variable.
+ in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/object-services/directives.rst b/c-user/object-services/directives.rst
index 54f234f..c975c75 100644
--- a/c-user/object-services/directives.rst
+++ b/c-user/object-services/directives.rst
@@ -168,9 +168,9 @@ Gets the object name associated with the object identifier.
This parameter is the object identifier to get the name.
``name``
- This parameter is the pointer to an object name variable. When the
+ This parameter is the pointer to an :c:type:`rtems_name` object. When the
directive call is successful, the object name associated with the object
- identifier will be stored in this variable.
+ identifier will be stored in this object.
.. rubric:: RETURN VALUES:
@@ -801,9 +801,10 @@ Gets the object class information of the object class of the object API.
information.
``info``
- This parameter is the pointer to an object class information variable.
- When the directive call is successful, the object class information of the
- class of the API will be stored in this variable.
+ This parameter is the pointer to an
+ :c:type:`rtems_object_api_class_information` object. When the directive
+ call is successful, the object class information of the class of the API
+ will be stored in this object.
.. rubric:: RETURN VALUES:
diff --git a/c-user/partition/directives.rst b/c-user/partition/directives.rst
index 98c0eb1..534cfb4 100644
--- a/c-user/partition/directives.rst
+++ b/c-user/partition/directives.rst
@@ -76,9 +76,9 @@ Creates a partition.
This parameter is the attribute set of the partition.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created partition will
- be stored in this variable.
+ be stored in this object.
.. rubric:: DESCRIPTION:
@@ -241,9 +241,9 @@ Identifies a partition by the object name.
This parameter is the node or node set to search for a matching object.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -415,9 +415,9 @@ Tries to get a buffer from the partition.
This parameter is the partition identifier.
``buffer``
- This parameter is the pointer to a buffer pointer variable. When the
+ This parameter is the pointer to a ``void`` pointer object. When the
directive call is successful, the pointer to the allocated buffer will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/rate-monotonic/directives.rst b/c-user/rate-monotonic/directives.rst
index 1935e8a..02b8898 100644
--- a/c-user/rate-monotonic/directives.rst
+++ b/c-user/rate-monotonic/directives.rst
@@ -56,9 +56,9 @@ Creates a period.
This parameter is the object name of the period.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created period will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -133,9 +133,9 @@ Identifies a period by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -407,10 +407,10 @@ Gets the detailed status of the period.
This parameter is the rate monotonic period identifier.
``status``
- This parameter is the pointer to a
- :c:type:`rtems_rate_monotonic_period_status` variable. When the directive
+ This parameter is the pointer to an
+ :c:type:`rtems_rate_monotonic_period_status` object. When the directive
call is successful, the detailed period status will be stored in this
- variable.
+ object.
.. rubric:: DESCRIPTION:
@@ -494,10 +494,10 @@ Gets the statistics of the period.
This parameter is the rate monotonic period identifier.
``status``
- This parameter is the pointer to a
- :c:type:`rtems_rate_monotonic_period_statistics` variable. When the
+ This parameter is the pointer to an
+ :c:type:`rtems_rate_monotonic_period_statistics` object. When the
directive call is successful, the period statistics will be stored in this
- variable.
+ object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/region/directives.rst b/c-user/region/directives.rst
index 86bb537..5a03e6a 100644
--- a/c-user/region/directives.rst
+++ b/c-user/region/directives.rst
@@ -77,9 +77,9 @@ Creates a region.
This parameter is the attribute set of the region.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created region will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -193,9 +193,9 @@ Identifies a region by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -427,9 +427,9 @@ Gets a segment from the region.
wait potentially forever.
``segment``
- This parameter is the pointer to a void pointer variable. When the
+ This parameter is the pointer to a ``void`` pointer object. When the
directive call is successful, the begin address of the allocated segment
- will be stored in this variable.
+ will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -635,9 +635,9 @@ Changes the size of the segment.
``old_size``
This parameter is the pointer to an `uintptr_t
- <https://en.cppreference.com/w/c/types/integer>`_ variable. When the
+ <https://en.cppreference.com/w/c/types/integer>`_ object. When the
directive call is successful, the old size of the segment will be stored in
- this variable.
+ this object.
.. rubric:: DESCRIPTION:
@@ -713,9 +713,9 @@ Gets the region information.
This parameter is the region identifier.
``the_info``
- This parameter is the pointer to a Heap_Information_block variable. When
- the directive call is successful, the information of the region will be
- stored in this variable.
+ This parameter is the pointer to a Heap_Information_block object. When the
+ directive call is successful, the information of the region will be stored
+ in this object.
.. rubric:: DESCRIPTION:
@@ -788,9 +788,9 @@ Gets the region free information.
This parameter is the region identifier.
``the_info``
- This parameter is the pointer to a Heap_Information_block variable. When
- the directive call is successful, the free information of the region will
- be stored in this variable.
+ This parameter is the pointer to a Heap_Information_block object. When the
+ directive call is successful, the free information of the region will be
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -871,9 +871,9 @@ Gets the size of the region segment.
``size``
This parameter is the pointer to a `uintptr_t
- <https://en.cppreference.com/w/c/types/integer>`_ variable. When the
+ <https://en.cppreference.com/w/c/types/integer>`_ object. When the
directive call is successful, the size of the segment in bytes will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/scheduling-concepts/directives.rst b/c-user/scheduling-concepts/directives.rst
index 4785457..aa0300e 100644
--- a/c-user/scheduling-concepts/directives.rst
+++ b/c-user/scheduling-concepts/directives.rst
@@ -54,9 +54,9 @@ Identifies a scheduler by the object name.
This parameter is the scheduler name to look up.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the scheduler will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -120,9 +120,9 @@ Identifies a scheduler by the processor index.
This parameter is the processor index to identify the scheduler.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the scheduler will be
- stored in this variable.
+ stored in this object.
.. rubric:: RETURN VALUES:
@@ -176,17 +176,17 @@ Identifies a scheduler by the processor set.
.. rubric:: PARAMETERS:
``cpusetsize``
- This parameter is the size of the referenced processor set variable in
- bytes. This value shall be positive.
+ This parameter is the size of the processor set referenced by ``cpuset`` in
+ bytes. The size shall be positive.
``cpuset``
- This parameter is the pointer to a processor set variable. The referenced
+ This parameter is the pointer to a :c:type:`cpu_set_t`. The referenced
processor set will be used to identify the scheduler.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the scheduler will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -254,9 +254,9 @@ Gets the maximum task priority of the scheduler.
This parameter is the scheduler identifier.
``priority``
- This parameter is the pointer to a task priority variable. The maximum
- priority of the scheduler will be stored in this variable, if the operation
- is successful.
+ This parameter is the pointer to an :c:type:`rtems_task_priority` object.
+ When the directive the maximum priority of the scheduler will be stored in
+ this object.
.. rubric:: RETURN VALUES:
@@ -313,10 +313,9 @@ Maps a Classic API task priority to the corresponding POSIX thread priority.
This parameter is the Classic API task priority to map.
``posix_priority``
- This parameter is the pointer to a POSIX thread priority variable. When
- the directive call is successful, the POSIX thread priority value
- corresponding to the specified Classic API task priority value will be
- stored in this variable.
+ This parameter is the pointer to an ``int`` object. When the directive
+ call is successful, the POSIX thread priority value corresponding to the
+ specified Classic API task priority value will be stored in this object.
.. rubric:: RETURN VALUES:
@@ -376,10 +375,10 @@ Maps a POSIX thread priority to the corresponding Classic API task priority.
This parameter is the POSIX thread priority to map.
``priority``
- This parameter is the pointer to a Classic API task priority variable.
+ This parameter is the pointer to an :c:type:`rtems_task_priority` object.
When the directive call is successful, the Classic API task priority value
corresponding to the specified POSIX thread priority value will be stored
- in this variable.
+ in this object.
.. rubric:: RETURN VALUES:
@@ -532,13 +531,13 @@ Gets the set of processors owned by the scheduler.
This parameter is the scheduler identifier.
``cpusetsize``
- This parameter is the size of the referenced processor set variable in
+ This parameter is the size of the processor set referenced by ``cpuset`` in
bytes.
``cpuset``
- This parameter is the pointer to a processor set variable. When the
+ This parameter is the pointer to a :c:type:`cpu_set_t` object. When the
directive call is successful, the processor set of the scheduler will be
- stored in this variable. A set bit in the processor set means that the
+ stored in this object. A set bit in the processor set means that the
corresponding processor is owned by the scheduler, otherwise the bit is
cleared.
diff --git a/c-user/semaphore/directives.rst b/c-user/semaphore/directives.rst
index 45ed8c1..5a66ac1 100644
--- a/c-user/semaphore/directives.rst
+++ b/c-user/semaphore/directives.rst
@@ -75,9 +75,9 @@ Creates a semaphore.
the attribute set.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created semaphore will
- be stored in this variable.
+ be stored in this object.
.. rubric:: DESCRIPTION:
@@ -278,9 +278,9 @@ Identifies a semaphore by the object name.
This parameter is the node or node set to search for a matching object.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -862,9 +862,9 @@ Sets the priority by scheduler for the semaphore.
scheduler.
``old_priority``
- This parameter is the pointer to a task priority variable. When the
- directive call is successful, the old priority of the semaphore
- corresponding to the specified scheduler will be stored in this variable.
+ This parameter is the pointer to an :c:type:`rtems_task_priority` object.
+ When the directive call is successful, the old priority of the semaphore
+ corresponding to the specified scheduler will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/task/directives.rst b/c-user/task/directives.rst
index 47e51d1..e544525 100644
--- a/c-user/task/directives.rst
+++ b/c-user/task/directives.rst
@@ -74,9 +74,9 @@ Creates a task.
This parameter is the attribute set of the task.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created task will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -335,9 +335,9 @@ Constructs a task from the specified task configuration.
This parameter is the task configuration.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the constructed task will
- be stored in this variable.
+ be stored in this object.
.. rubric:: RETURN VALUES:
@@ -475,9 +475,9 @@ Identifies a task by the object name.
This parameter is the node or node set to search for a matching object.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -1147,10 +1147,10 @@ Sets the real priority or gets the current priority of the task.
:c:macro:`RTEMS_CURRENT_PRIORITY` to get the current priority.
``old_priority``
- This parameter is the pointer to an :c:type:`rtems_task_priority` variable.
+ This parameter is the pointer to an :c:type:`rtems_task_priority` object.
When the directive call is successful, the current or previous priority of
the task with respect to its :term:`home scheduler` will be stored in this
- variable.
+ object.
.. rubric:: DESCRIPTION:
@@ -1246,9 +1246,9 @@ Gets the current priority of the task with respect to the scheduler.
This parameter is the scheduler identifier.
``priority``
- This parameter is the pointer to an :c:type:`rtems_task_priority` variable.
+ This parameter is the pointer to an :c:type:`rtems_task_priority` object.
When the directive call is successful, the current priority of the task
- with respect to the specified scheduler will be stored in this variable.
+ with respect to the specified scheduler will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -1340,9 +1340,9 @@ Gets and optionally sets the mode of the calling task.
:c:macro:`RTEMS_CURRENT_MODE`, the mode of the calling task is not changed.
``previous_mode_set``
- This parameter is the pointer to a mode variable. When the directive call
- is successful, the mode of the task before any mode changes done by the
- directive call will be stored in this variable.
+ This parameter is the pointer to an :c:type:`rtems_mode` object. When the
+ directive call is successful, the mode of the task before any mode changes
+ done by the directive call will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -1615,9 +1615,9 @@ Gets the home scheduler of the task.
may be used to specify the calling task.
``scheduler_id``
- This parameter is the pointer to an :c:type:`rtems_id` variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the :term:`home scheduler`
- of the task will be stored in this variable.
+ of the task will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -1779,13 +1779,13 @@ Gets the processor affinity of the task.
may be used to specify the calling task.
``cpusetsize``
- This parameter is the size of the referenced processor set variable in
+ This parameter is the size of the processor set referenced by ``cpuset`` in
bytes.
``cpuset``
- This parameter is the pointer to a processor set variable. When the
+ This parameter is the pointer to a :c:type:`cpu_set_t` object. When the
directive call is successful, the processor affinity set of the task will
- be stored in this variable. A set bit in the processor set means that the
+ be stored in this object. A set bit in the processor set means that the
corresponding processor is in the processor affinity set of the task,
otherwise the bit is cleared.
@@ -1807,8 +1807,8 @@ task specified by ``id``.
There was no task associated with the identifier specified by ``id``.
:c:macro:`RTEMS_INVALID_SIZE`
- The provided processor set was too small for the processor affinity set of
- the task.
+ The size specified by ``cpusetsize`` of the processor set was too small for
+ the processor affinity set of the task.
:c:macro:`RTEMS_ILLEGAL_ON_REMOTE_OBJECT`
The task resided on a remote node.
@@ -1857,14 +1857,14 @@ Sets the processor affinity of the task.
may be used to specify the calling task.
``cpusetsize``
- This parameter is the size of the referenced processor set variable in
+ This parameter is the size of the processor set referenced by ``cpuset`` in
bytes.
``cpuset``
- This parameter is the pointer to a processor set variable. The processor
- set defines the new processor affinity set of the task. A set bit in the
- processor set means that the corresponding processor shall be in the
- processor affinity set of the task, otherwise the bit shall be cleared.
+ This parameter is the pointer to a :c:type:`cpu_set_t` object. The
+ processor set defines the new processor affinity set of the task. A set
+ bit in the processor set means that the corresponding processor shall be in
+ the processor affinity set of the task, otherwise the bit shall be cleared.
.. rubric:: DESCRIPTION:
diff --git a/c-user/timer/directives.rst b/c-user/timer/directives.rst
index 2affe42..f020de4 100644
--- a/c-user/timer/directives.rst
+++ b/c-user/timer/directives.rst
@@ -55,9 +55,9 @@ Creates a timer.
This parameter is the object name of the timer.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created timer will be
- stored in this variable.
+ stored in this object.
.. rubric:: DESCRIPTION:
@@ -137,9 +137,9 @@ Identifies a timer by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -811,9 +811,9 @@ Gets information about the timer.
This parameter is the timer identifier.
``the_info``
- This parameter is the pointer to a timer information variable. When the
- directive call is successful, the information about the timer will be
- stored in this variable.
+ This parameter is the pointer to an :c:type:`rtems_timer_information`
+ object. When the directive call is successful, the information about the
+ timer will be stored in this object.
.. rubric:: DESCRIPTION:
diff --git a/c-user/user-extensions/directives.rst b/c-user/user-extensions/directives.rst
index 9aa1e9d..2dbac54 100644
--- a/c-user/user-extensions/directives.rst
+++ b/c-user/user-extensions/directives.rst
@@ -64,9 +64,9 @@ Creates an extension set.
set.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the identifier of the created extension set
- will be stored in this variable.
+ will be stored in this object.
.. rubric:: DESCRIPTION:
@@ -215,9 +215,9 @@ Identifies an extension set by the object name.
This parameter is the object name to look up.
``id``
- This parameter is the pointer to an object identifier variable. When the
+ This parameter is the pointer to an :c:type:`rtems_id` object. When the
directive call is successful, the object identifier of an object with the
- specified name will be stored in this variable.
+ specified name will be stored in this object.
.. rubric:: DESCRIPTION:
--
2.26.2
More information about the devel
mailing list