c-user: Generate Object Services documentation

The documentation is a consolidation of the comments in Doxygen markup
and the documentation sources in Sphinx markup.  The documentation was
transfered to interface specification items.  The documentation source
files were generated from the items by a script.

Update #3993.

1 files changed, 73 insertions, 20 deletions

diff --git a/c-user/object-services/introduction.rst b/c-user/object-services/introduction.rst
index 3c7ff18..6e7f4af 100644
--- a/c-user/object-services/introduction.rst
+++ b/c-user/object-services/introduction.rst
@@ -1,47 +1,100 @@
 .. SPDX-License-Identifier: CC-BY-SA-4.0
 
-.. Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+.. Copyright (C) 1988, 2009 On-Line Applications Research Corporation (OAR)
+
+.. This file is part of the RTEMS quality process and was automatically
+.. generated.  If you find something that needs to be fixed or
+.. worded better please post a report or patch to an RTEMS mailing list
+.. or raise a bug report:
+..
+.. https://docs.rtems.org/branches/master/user/support/bugs.html
+..
+.. For information on updating and regenerating please refer to:
+..
+.. https://docs.rtems.org/branches/master/eng/req/howto.html
+
+.. Generated from spec:/rtems/object/if/group
+
+.. _ObjectServicesIntroduction:
 
 Introduction
 ============
 
+.. The following list was generated from:
+.. spec:/rtems/object/if/build-id
+.. spec:/rtems/object/if/build-name
+.. spec:/rtems/object/if/get-classic-name
+.. spec:/rtems/object/if/get-name
+.. spec:/rtems/object/if/set-name
+.. spec:/rtems/object/if/id-get-api
+.. spec:/rtems/object/if/id-get-class
+.. spec:/rtems/object/if/id-get-node
+.. spec:/rtems/object/if/id-get-index
+.. spec:/rtems/object/if/id-api-minimum
+.. spec:/rtems/object/if/id-api-maximum
+.. spec:/rtems/object/if/api-minimum-class
+.. spec:/rtems/object/if/api-maximum-class
+.. spec:/rtems/object/if/get-api-name
+.. spec:/rtems/object/if/get-api-class-name
+.. spec:/rtems/object/if/get-class-information
+.. spec:/rtems/object/if/get-local-node
+.. spec:/rtems/object/if/id-initial
+
 RTEMS provides a collection of services to assist in the management and usage
 of the objects created and utilized via other managers.  These services assist
 in the manipulation of RTEMS objects independent of the API used to create
-them.  The object related services provided by RTEMS are:
+them. The directives provided by the Object Services are:
 
-- :ref:`rtems_build_id`
+* :ref:`InterfaceRtemsBuildId` - Builds the object identifier from the API,
+  class, MPCI node, and index components.
 
-- :ref:`rtems_build_name`
+* :ref:`InterfaceRtemsBuildName` - Builds the object name composed of the four
+  characters.
 
-- :ref:`rtems_object_get_classic_name`
+* :ref:`InterfaceRtemsObjectGetClassicName` - Gets the object name associated
+  with the object identifier.
 
-- :ref:`rtems_object_get_name`
+* :ref:`InterfaceRtemsObjectGetName` - Gets the object name associated with the
+  object identifier as a string.
 
-- :ref:`rtems_object_set_name`
+* :ref:`InterfaceRtemsObjectSetName` - Sets the object name of the object
+  associated with the object identifier.
 
-- :ref:`rtems_object_id_get_api`
+* :ref:`InterfaceRtemsObjectIdGetApi` - Gets the API component of the object
+  identifier.
 
-- :ref:`rtems_object_id_get_class`
+* :ref:`InterfaceRtemsObjectIdGetClass` - Gets the class component of the
+  object identifier.
 
-- :ref:`rtems_object_id_get_node`
+* :ref:`InterfaceRtemsObjectIdGetNode` - Gets the MPCI node component of the
+  object identifier.
 
-- :ref:`rtems_object_id_get_index`
+* :ref:`InterfaceRtemsObjectIdGetIndex` - Gets the index component of the
+  object identifier.
 
-- :ref:`rtems_build_id`
+* :ref:`InterfaceRtemsObjectIdApiMinimum` - Gets the lowest valid value for the
+  API component of an object identifier.
 
-- :ref:`rtems_object_id_api_minimum`
+* :ref:`InterfaceRtemsObjectIdApiMaximum` - Gets the highest valid value for
+  the API component of an object identifier.
 
-- :ref:`rtems_object_id_api_maximum`
+* :ref:`InterfaceRtemsObjectApiMinimumClass` - Gets the lowest valid class
+  value of the object API.
 
-- :ref:`rtems_object_id_api_minimum_class`
+* :ref:`InterfaceRtemsObjectApiMaximumClass` - Gets the highest valid class
+  value of the object API.
 
-- :ref:`rtems_object_id_api_maximum_class`
+* :ref:`InterfaceRtemsObjectGetApiName` - Gets a descriptive name of the object
+  API.
 
-- :ref:`rtems_object_get_api_name`
+* :ref:`InterfaceRtemsObjectGetApiClassName` - Gets a descriptive name of the
+  object class of the object API.
 
-- :ref:`rtems_object_get_api_class_name`
+* :ref:`InterfaceRtemsObjectGetClassInformation` - Gets the object class
+  information of the object class of the object API.
 
-- :ref:`rtems_object_get_class_information`
+* :ref:`InterfaceRtemsObjectGetLocalNode` - Gets the local MPCI node number.
 
-- :ref:`rtems_object_get_local_node`
+* :ref:`InterfaceRTEMSOBJECTIDINITIAL` - Builds the object identifier with the
+  lowest index from the API, class, and MPCI node components.