[rtems-docs commit] eng: Allow multiple interface references

[Sebastian Huber]

Module:    rtems-docs
Branch:    master
Commit:    3fa9ed4323fd69b01d7ea760190f065cc159b7ec
Changeset: http://git.rtems.org/rtems-docs/commit/?id=3fa9ed4323fd69b01d7ea760190f065cc159b7ec

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Mon Apr 26 09:56:41 2021 +0200

eng: Allow multiple interface references

Update #3715.

---

 eng/req/items.rst | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/eng/req/items.rst b/eng/req/items.rst
index 64a32cb..b6fef2f 100644
--- a/eng/req/items.rst
+++ b/eng/req/items.rst
@@ -1584,9 +1584,8 @@ name
     The attribute value shall be a string. It shall be the name of the
     unspecified interface.
 
-reference
-    The attribute value shall be an optional string. If the value is present,
-    then it shall be an URL to the standard or specification of the interface.
+references
+    The attribute value shall be an :ref:`SpecTypeInterfaceReferencesSet`.
 
 .. _SpecTypeInterfaceVariableItemType:
 
@@ -4317,6 +4316,20 @@ value is ``interface-placement``. It defines the interface placement role of
 links.  It is used to indicate that an interface definition is placed into an
 interface container, for example a header file.
 
+.. _SpecTypeInterfaceReferencesSet:
+
+Interface References Set
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+This set of attributes defines references for the interface. Generic attributes
+may be specified. Each generic attribute key shall be a :ref:`SpecTypeName`.
+Each generic attribute value shall be a string. The key defines the reference
+kind.  The value shall be a kind-specific reference target.
+
+This type is used by the following types:
+
+* :ref:`SpecTypeInterfaceUnspecifiedItemType`
+
 .. _SpecTypeInterfaceReturnDirective:
 
 Interface Return Directive
@@ -4449,6 +4462,8 @@ This type is used by the following types:
 
 * :ref:`SpecTypeInterfaceItemType`
 
+* :ref:`SpecTypeInterfaceReferencesSet`
+
 * :ref:`SpecTypeLink`
 
 * :ref:`SpecTypeNonFunctionalRequirementItemType`