[rtems-docs commit] eng: Simplify interface return specification

[Sebastian Huber]

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

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Fri Sep 10 16:25:59 2021 +0200

eng: Simplify interface return specification

Update #3715.

---

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

diff --git a/eng/req/items.rst b/eng/req/items.rst
index 51f3c3d..1818bd2 100644
--- a/eng/req/items.rst
+++ b/eng/req/items.rst
@@ -4297,16 +4297,21 @@ This type is used by the following types:
 Interface Return Directive
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-This set of attributes specifies an interface return. All explicit attributes
-shall be specified. The explicit attributes for this type are:
+A value of this type shall be of one of the following variants:
 
-return
-    The attribute value shall be an optional string. It shall describe the
-    interface return for unspecified return values.
+* The value may be a set of attributes. This set of attributes specifies an
+  interface return. All explicit attributes shall be specified. The explicit
+  attributes for this type are:
 
-return-values
-    The attribute value shall be a list. Each list element shall be an
-    :ref:`SpecTypeInterfaceReturnValue`.
+  return
+      The attribute value shall be an optional string. It shall describe the
+      interface return for unspecified return values.
+
+  return-values
+      The attribute value shall be a list. Each list element shall be an
+      :ref:`SpecTypeInterfaceReturnValue`.
+
+* There may by be no value (null).
 
 This type is used by the following types: