c-user: Use a common phrase for pointer parameters

Mention the type of the pointer in the parameter description.  Use the
more general term "object" instead of "variable".

Update #3993.
This commit is contained in:
Sebastian Huber
2021-06-14 09:18:23 +02:00
parent 1a281869a9
commit c70715baea
15 changed files with 163 additions and 159 deletions

View File

@@ -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: