c-user: Generate API type documentation

Close #4901.

c-user/barrier/directives.rst

@@ -67,9 +67,9 @@ Creates a barrier.
     barrier.
 
 ``id``
-    This parameter is the pointer to an :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created barrier will be
+    the directive call is successful, the identifier of the created barrier
-    stored in this object.
+    will be 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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 

c-user/clock/directives.rst

@@ -137,7 +137,7 @@ Gets the time of day associated with the current :term:`CLOCK_REALTIME`.
 .. rubric:: PARAMETERS:
 
 ``time_of_day``
-    This parameter is the pointer to an :c:type:`rtems_time_of_day` object.
+    This parameter is the pointer to an :ref:`InterfaceRtemsTimeOfDay` 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 object.
@@ -1086,8 +1086,8 @@ 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 :c:type:`rtems_interval` object.  When
+    This parameter is the pointer to an :ref:`InterfaceRtemsInterval` object.
-    the directive call is successful, the seconds elapsed since the
+    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.
 

c-user/config/classic-init-task.rst

@@ -59,7 +59,7 @@ API initialization task.
 .. rubric:: CONSTRAINTS:
 
 The value of the configuration option shall be convertible to an integer of
-type :c:type:`rtems_task_argument`.
+type :ref:`InterfaceRtemsTaskArgument`.
 
 .. Generated from spec:/acfg/if/init-task-attributes
 

c-user/config/device-driver.rst

@@ -114,7 +114,7 @@ placement of application device driver initializers.
 .. rubric:: CONSTRAINTS:
 
 The value of the configuration option shall be a list of initializers for
-structures of type :c:type:`rtems_driver_address_table`.
+structures of type :ref:`InterfaceRtemsDriverAddressTable`.
 
 .. Generated from spec:/acfg/if/appl-needs-ata-driver
 
@@ -718,7 +718,7 @@ of application device driver initializers.
 .. rubric:: CONSTRAINTS:
 
 The value of the configuration option shall be a list of initializers for
-structures of type :c:type:`rtems_driver_address_table`.
+structures of type :ref:`InterfaceRtemsDriverAddressTable`.
 
 .. Generated from spec:/acfg/if/ata-driver-task-priority
 

c-user/config/general.rst

@@ -328,7 +328,7 @@ initial user extensions.
 .. rubric:: CONSTRAINTS:
 
 The value of the configuration option shall be a list of initializers for
-structures of type :c:type:`rtems_extensions_table`.
+structures of type :ref:`InterfaceRtemsExtensionsTable`.
 
 .. Generated from spec:/acfg/if/interrupt-stack-size
 

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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created port will be
+    the directive call is successful, the identifier of the created port will
-    stored in this object.
+    be 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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 

c-user/interrupt/directives.rst

@@ -63,9 +63,10 @@ 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` object.  When
+    This parameter is the pointer to an :ref:`InterfaceRtemsIsrEntry` object.
-    the directive call is successful, the previous interrupt service routine
+    When the directive call is successful, the previous interrupt service
-    established for this interrupt vector will be stored in this object.
+    routine established for this interrupt vector will be stored in this
+    object.
 
 .. rubric:: DESCRIPTION:
 
@@ -133,8 +134,8 @@ Disables the maskable interrupts on the current processor.
 .. rubric:: PARAMETERS:
 
 ``isr_cookie``
-    This parameter is a variable of type :c:type:`rtems_interrupt_level` which
+    This parameter is a variable of type :ref:`InterfaceRtemsInterruptLevel`
-    will be used to save the previous interrupt level.
+    which will be used to save the previous interrupt level.
 
 .. rubric:: DESCRIPTION:
 
@@ -343,8 +344,8 @@ Disables the maskable interrupts on the current processor.
 .. rubric:: PARAMETERS:
 
 ``isr_cookie``
-    This parameter is a variable of type :c:type:`rtems_interrupt_level` which
+    This parameter is a variable of type :ref:`InterfaceRtemsInterruptLevel`
-    will be used to save the previous interrupt level.
+    which will be used to save the previous interrupt level.
 
 .. rubric:: DESCRIPTION:
 
@@ -2188,9 +2189,10 @@ Gets the attributes of the interrupt vector.
     This parameter is the interrupt vector number.
 
 ``attributes``
-    This parameter is the pointer to an :c:type:`rtems_interrupt_attributes`
+    This parameter is the pointer to an
-    object.  When the directive call is successful, the attributes of the
+    :ref:`InterfaceRtemsInterruptAttributes` object.  When the directive call
-    interrupt vector will be stored in this object.
+    is successful, the attributes of the interrupt vector will be stored in
+    this object.
 
 .. rubric:: RETURN VALUES:
 
@@ -2418,9 +2420,9 @@ Creates an interrupt server.
 
 ``control``
     This parameter is the pointer to an
-    :c:type:`rtems_interrupt_server_control` object.  When the directive call
+    :ref:`InterfaceRtemsInterruptServerControl` object.  When the directive
-    was successful, the ownership of the object was transferred from the caller
+    call was successful, the ownership of the object was transferred from the
-    of the directive to the interrupt server management.
+    caller of the directive to the interrupt server management.
 
 ``config``
     This parameter is the interrupt server configuration.

c-user/io/directives.rst

@@ -64,7 +64,7 @@ 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 an :c:type:`rtems_device_major_number`
+    This parameter is the pointer to an :ref:`InterfaceRtemsDeviceMajorNumber`
     object.  When the directive call is successful, the device major number of
     the registered device will be stored in this object.
 

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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created message queue
+    the directive call is successful, the identifier of the created message
-    will be stored in this object.
+    queue will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 
@@ -230,11 +230,12 @@ Constructs a message queue from the specified the message queue configuration.
 .. rubric:: PARAMETERS:
 
 ``config``
-    This parameter is the message queue configuration.
+    This parameter is the pointer to an :ref:`InterfaceRtemsMessageQueueConfig`
+    object.  It configures the message queue.
 
 ``id``
-    This parameter is the pointer to an :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the constructed message
+    the directive call is successful, the identifier of the constructed message
     queue will be stored in this object.
 
 .. rubric:: RETURN VALUES:
@@ -361,9 +362,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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 

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 :c:type:`rtems_name` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsName` object.  When
-    directive call is successful, the object name associated with the object
+    the directive call is successful, the object name associated with the
-    identifier will be stored in this object.
+    object identifier will be stored in this object.
 
 .. rubric:: RETURN VALUES:
 
@@ -802,7 +802,7 @@ Gets the object class information of the object class of the object API.
 
 ``info``
     This parameter is the pointer to an
-    :c:type:`rtems_object_api_class_information` object.  When the directive
+    :ref:`InterfaceRtemsObjectApiClassInformation` object.  When the directive
     call is successful, the object class information of the class of the API
     will be stored in this object.
 

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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created partition will
+    the directive call is successful, the identifier of the created partition
-    be stored in this object.
+    will 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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 

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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created period will be
+    the directive call is successful, the identifier of the created period will
-    stored in this object.
+    be 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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 
@@ -413,7 +413,7 @@ Gets the detailed status of the period.
 
 ``status``
     This parameter is the pointer to an
-    :c:type:`rtems_rate_monotonic_period_status` object.  When the directive
+    :ref:`InterfaceRtemsRateMonotonicPeriodStatus` object.  When the directive
     call is successful, the detailed period status will be stored in this
     object.
 
@@ -496,7 +496,7 @@ Gets the statistics of the period.
 
 ``status``
     This parameter is the pointer to an
-    :c:type:`rtems_rate_monotonic_period_statistics` object.  When the
+    :ref:`InterfaceRtemsRateMonotonicPeriodStatistics` object.  When the
     directive call is successful, the period statistics will be stored in this
     object.
 

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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created region will be
+    the directive call is successful, the identifier of the created region will
-    stored in this object.
+    be 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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 

c-user/scheduling-concepts/directives.rst

@@ -54,8 +54,8 @@ Identifies a scheduler by the object name.
     This parameter is the scheduler name to look up.
 
 ``id``
-    This parameter is the pointer to an :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the scheduler will be
+    the directive call is successful, the identifier of the scheduler will be
     stored in this object.
 
 .. rubric:: DESCRIPTION:
@@ -120,8 +120,8 @@ 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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the scheduler will be
+    the directive call is successful, the identifier of the scheduler will be
     stored in this object.
 
 .. rubric:: RETURN VALUES:
@@ -184,8 +184,8 @@ Identifies a scheduler by the processor set.
     processor set will be used to identify the scheduler.
 
 ``id``
-    This parameter is the pointer to an :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the scheduler will be
+    the directive call is successful, the identifier of the scheduler will be
     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 an :c:type:`rtems_task_priority` object.
+    This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
-    When the directive the maximum priority of the scheduler will be stored in
+    object.  When the directive the maximum priority of the scheduler will be
-    this object.
+    stored in this object.
 
 .. rubric:: RETURN VALUES:
 
@@ -375,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 an :c:type:`rtems_task_priority` object.
+    This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
-    When the directive call is successful, the Classic API task priority value
+    object.  When the directive call is successful, the Classic API task
-    corresponding to the specified POSIX thread priority value will be stored
+    priority value corresponding to the specified POSIX thread priority value
-    in this object.
+    will be stored in this object.
 
 .. rubric:: RETURN VALUES:
 

c-user/semaphore/directives.rst

@@ -75,9 +75,9 @@ Creates a semaphore.
     the attribute set.
 
 ``id``
-    This parameter is the pointer to an :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created semaphore will
+    the directive call is successful, the identifier of the created semaphore
-    be stored in this object.
+    will 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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 
@@ -862,9 +862,10 @@ Sets the priority by scheduler for the semaphore.
     scheduler.
 
 ``old_priority``
-    This parameter is the pointer to an :c:type:`rtems_task_priority` object.
+    This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
-    When the directive call is successful, the old priority of the semaphore
+    object.  When the directive call is successful, the old priority of the
-    corresponding to the specified scheduler will be stored in this object.
+    semaphore corresponding to the specified scheduler will be stored in this
+    object.
 
 .. rubric:: DESCRIPTION:
 

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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created task will be
+    the directive call is successful, the identifier of the created task will
-    stored in this object.
+    be stored in this object.
 
 .. rubric:: DESCRIPTION:
 
@@ -332,12 +332,13 @@ Constructs a task from the specified task configuration.
 .. rubric:: PARAMETERS:
 
 ``config``
-    This parameter is the task configuration.
+    This parameter is the pointer to an :ref:`InterfaceRtemsTaskConfig` object.
+    It configures the task.
 
 ``id``
-    This parameter is the pointer to an :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the constructed task will
+    the directive call is successful, the identifier of the constructed task
-    be stored in this object.
+    will be stored in this object.
 
 .. rubric:: RETURN VALUES:
 
@@ -475,9 +476,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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 
@@ -1162,10 +1163,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` object.
+    This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
-    When the directive call is successful, the current or previous priority of
+    object.  When the directive call is successful, the current or previous
-    the task with respect to its :term:`home scheduler` will be stored in this
+    priority of the task with respect to its :term:`home scheduler` will be
-    object.
+    stored in this object.
 
 .. rubric:: DESCRIPTION:
 
@@ -1261,9 +1262,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` object.
+    This parameter is the pointer to an :ref:`InterfaceRtemsTaskPriority`
-    When the directive call is successful, the current priority of the task
+    object.  When the directive call is successful, the current priority of the
-    with respect to the specified scheduler will be stored in this object.
+    task with respect to the specified scheduler will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 
@@ -1630,9 +1631,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` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the :term:`home scheduler`
+    the directive call is successful, the identifier of the :term:`home
-    of the task will be stored in this object.
+    scheduler` of the task will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 

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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created timer will be
+    the directive call is successful, the identifier of the created timer will
-    stored in this object.
+    be 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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 
@@ -811,7 +811,7 @@ Gets information about the timer.
     This parameter is the timer identifier.
 
 ``the_info``
-    This parameter is the pointer to an :c:type:`rtems_timer_information`
+    This parameter is the pointer to an :ref:`InterfaceRtemsTimerInformation`
     object.  When the directive call is successful, the information about the
     timer will be stored in this object.
 

c-user/user-extensions/directives.rst

@@ -64,9 +64,9 @@ Creates an extension set.
     set.
 
 ``id``
-    This parameter is the pointer to an :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the identifier of the created extension set
+    the directive call is successful, the identifier of the created extension
-    will be stored in this object.
+    set will be stored in this object.
 
 .. rubric:: DESCRIPTION:
 
@@ -219,9 +219,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 :c:type:`rtems_id` object.  When the
+    This parameter is the pointer to an :ref:`InterfaceRtemsId` object.  When
-    directive call is successful, the object identifier of an object with the
+    the directive call is successful, the object identifier of an object with
-    specified name will be stored in this object.
+    the specified name will be stored in this object.
 
 .. rubric:: DESCRIPTION: