spec: Use EARS syntax

35 files changed, 114 insertions, 112 deletions

diff --git a/spec/rtems/barrier/if/create.yml b/spec/rtems/barrier/if/create.yml
index 74deb817..10b606e8 100644
--- a/spec/rtems/barrier/if/create.yml
+++ b/spec/rtems/barrier/if/create.yml
@@ -84,9 +84,9 @@ params:
   dir: null
   name: maximum_waiters
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created barrier will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created barrier will be stored in this
+    variable.
   dir: null
   name: id
 return:
diff --git a/spec/rtems/barrier/if/ident.yml b/spec/rtems/barrier/if/ident.yml
index f7cc00bb..109d82de 100644
--- a/spec/rtems/barrier/if/ident.yml
+++ b/spec/rtems/barrier/if/ident.yml
@@ -45,9 +45,9 @@ params:
   dir: null
   name: name
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/barrier/if/release.yml b/spec/rtems/barrier/if/release.yml
index 309687ac..518659bd 100644
--- a/spec/rtems/barrier/if/release.yml
+++ b/spec/rtems/barrier/if/release.yml
@@ -40,8 +40,8 @@ params:
   dir: null
   name: id
 - description: |
-    is the pointer to an integer variable.  The number of released tasks will
-    be stored in this variable, in case of a successful operation.
+    is the pointer to an integer variable.  When the directive call is
+    successful, the number of released tasks will be stored in this variable.
   dir: out
   name: released
 return:
diff --git a/spec/rtems/dpmem/if/create.yml b/spec/rtems/dpmem/if/create.yml
index b4c78bf8..eac83783 100644
--- a/spec/rtems/dpmem/if/create.yml
+++ b/spec/rtems/dpmem/if/create.yml
@@ -66,9 +66,9 @@ params:
   dir: null
   name: length
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created port will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created port will be stored in this
+    variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/dpmem/if/ident.yml b/spec/rtems/dpmem/if/ident.yml
index 404e4f90..b85fc84a 100644
--- a/spec/rtems/dpmem/if/ident.yml
+++ b/spec/rtems/dpmem/if/ident.yml
@@ -45,9 +45,9 @@ params:
   dir: null
   name: name
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/io/if/register-driver.yml b/spec/rtems/io/if/register-driver.yml
index 611e6d8b..3d54eaaf 100644
--- a/spec/rtems/io/if/register-driver.yml
+++ b/spec/rtems/io/if/register-driver.yml
@@ -43,9 +43,9 @@ params:
   dir: null
   name: driver_table
 - description: |
-    is the pointer to a device major number variable.  The device major number
-    of the registered device will be stored in this variable, in case of a
-    successful operation.
+    is the pointer to a device major number variable.  When the directive call
+    is successful, the device major number of the registered device will be
+    stored in this variable.
   dir: out
   name: registered_major
 return:
diff --git a/spec/rtems/message/if/construct.yml b/spec/rtems/message/if/construct.yml
index a32dfc48..0c44794f 100644
--- a/spec/rtems/message/if/construct.yml
+++ b/spec/rtems/message/if/construct.yml
@@ -55,9 +55,9 @@ params:
   dir: null
   name: config
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    constructed message queue will be stored in this variable, in case of a
-    successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the constructed message queue will be
+    stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/message/if/create.yml b/spec/rtems/message/if/create.yml
index 6497c711..fb388c1d 100644
--- a/spec/rtems/message/if/create.yml
+++ b/spec/rtems/message/if/create.yml
@@ -118,9 +118,9 @@ params:
   dir: null
   name: attribute_set
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created message queue will be stored in this variable, in case of a
-    successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created message queue will be stored
+    in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/message/if/ident.yml b/spec/rtems/message/if/ident.yml
index 1c57744b..0506c8e9 100644
--- a/spec/rtems/message/if/ident.yml
+++ b/spec/rtems/message/if/ident.yml
@@ -71,9 +71,9 @@ params:
   dir: null
   name: node
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/object/if/get-class-information.yml b/spec/rtems/object/if/get-class-information.yml
index 2530d123..37a0ca01 100644
--- a/spec/rtems/object/if/get-class-information.yml
+++ b/spec/rtems/object/if/get-class-information.yml
@@ -39,9 +39,9 @@ params:
   dir: null
   name: the_class
 - description: |
-    is the pointer to an object class information variable.  The object class
-    information of the class of the API will be stored in this variable, in
-    case of a successful operation.
+    is the pointer to an object class information variable.  When the directive
+    call is successful, the object class information of the class of the API
+    will be stored in this variable.
   dir: null
   name: info
 return:
diff --git a/spec/rtems/object/if/get-classic-name.yml b/spec/rtems/object/if/get-classic-name.yml
index 7dfcdf79..f4a67bf0 100644
--- a/spec/rtems/object/if/get-classic-name.yml
+++ b/spec/rtems/object/if/get-classic-name.yml
@@ -34,9 +34,9 @@ params:
   dir: null
   name: id
 - description: |
-    is the pointer to an object name variable.  The object name associated with
-    the object identifier will be stored in this variable, in case of a
-    successful operation.
+    is the pointer to an object name variable.  When the directive call is
+    successful, the object name associated with the object identifier will be
+    stored in this variable.
   dir: out
   name: name
 return:
diff --git a/spec/rtems/part/if/create.yml b/spec/rtems/part/if/create.yml
index e914bd37..cf92973c 100644
--- a/spec/rtems/part/if/create.yml
+++ b/spec/rtems/part/if/create.yml
@@ -114,9 +114,9 @@ params:
   dir: null
   name: attribute_set
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created partition will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created partition will be stored in
+    this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/part/if/get-buffer.yml b/spec/rtems/part/if/get-buffer.yml
index 379e61c3..736c01b3 100644
--- a/spec/rtems/part/if/get-buffer.yml
+++ b/spec/rtems/part/if/get-buffer.yml
@@ -50,8 +50,9 @@ params:
   dir: null
   name: id
 - description: |
-    is the pointer to a buffer pointer variable.  The pointer to the allocated
-    buffer will be stored in this variable, in case of a successful operation.
+    is the pointer to a buffer pointer variable.  When the directive call is
+    successful, the pointer to the allocated buffer will be stored in this
+    variable.
   dir: out
   name: buffer
 return:
diff --git a/spec/rtems/part/if/ident.yml b/spec/rtems/part/if/ident.yml
index ca89d14d..96ae159d 100644
--- a/spec/rtems/part/if/ident.yml
+++ b/spec/rtems/part/if/ident.yml
@@ -73,9 +73,9 @@ params:
   dir: null
   name: node
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/ratemon/if/create.yml b/spec/rtems/ratemon/if/create.yml
index abaf911a..506c8edc 100644
--- a/spec/rtems/ratemon/if/create.yml
+++ b/spec/rtems/ratemon/if/create.yml
@@ -51,9 +51,9 @@ params:
   dir: null
   name: name
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created period will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created period will be stored in this
+    variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/ratemon/if/ident.yml b/spec/rtems/ratemon/if/ident.yml
index ae066fec..1cd3185b 100644
--- a/spec/rtems/ratemon/if/ident.yml
+++ b/spec/rtems/ratemon/if/ident.yml
@@ -45,9 +45,9 @@ params:
   dir: null
   name: name
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/region/if/create.yml b/spec/rtems/region/if/create.yml
index 572f3eb0..4790e027 100644
--- a/spec/rtems/region/if/create.yml
+++ b/spec/rtems/region/if/create.yml
@@ -96,9 +96,9 @@ params:
   dir: null
   name: attribute_set
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created region will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created region will be stored in this
+    variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/region/if/ident.yml b/spec/rtems/region/if/ident.yml
index 4710f880..7a78a43c 100644
--- a/spec/rtems/region/if/ident.yml
+++ b/spec/rtems/region/if/ident.yml
@@ -45,9 +45,9 @@ params:
   dir: null
   name: name
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/scheduler/if/get-processor-set.yml b/spec/rtems/scheduler/if/get-processor-set.yml
index c4dfbdeb..8d8acb28 100644
--- a/spec/rtems/scheduler/if/get-processor-set.yml
+++ b/spec/rtems/scheduler/if/get-processor-set.yml
@@ -1,6 +1,6 @@
 SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
 brief: |
-  Gets the set of processors owned by the scheduler instance.
+  Gets the set of processors owned by the scheduler.
 copyrights:
 - Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
 - Copyright (C) 1988, 2017 On-Line Applications Research Corporation (OAR)
@@ -26,7 +26,7 @@ links:
 name: rtems_scheduler_get_processor_set
 notes: null
 params:
-- description: is the scheduler instance identifier.
+- description: is the scheduler identifier.
   dir: null
   name: scheduler_id
 - description: |
@@ -35,10 +35,10 @@ params:
   dir: null
   name: cpusetsize
 - description: |
-    is the pointer to a processor set variable.  The processor set of the
-    scheduler instance will be stored in this variable, in case of a successful
-    operation.  A set bit in the processor set means that the corresponding
-    processor is owned by the scheduler instance, otherwise the bit is cleared.
+    is the pointer to a processor set variable.  When the directive call is
+    successful, the processor set of the scheduler will be stored in this
+    variable.  A set bit in the processor set means that the corresponding
+    processor is owned by the scheduler, otherwise the bit is cleared.
   dir: out
   name: cpuset
 return:
@@ -56,6 +56,6 @@ return:
     value: ${../../status/if/invalid-id:/name}
   - description: |
       The provided processor set was too small for the set of processors owned
-      by the scheduler instance.
+      by the scheduler.
     value: ${../../status/if/invalid-number:/name}
 type: interface
diff --git a/spec/rtems/scheduler/if/ident-by-processor-set.yml b/spec/rtems/scheduler/if/ident-by-processor-set.yml
index 52275ca0..2405320b 100644
--- a/spec/rtems/scheduler/if/ident-by-processor-set.yml
+++ b/spec/rtems/scheduler/if/ident-by-processor-set.yml
@@ -1,6 +1,6 @@
 SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
 brief: |
-  Identifies a scheduler instance by a processor set.
+  Identifies a scheduler by a processor set.
 copyrights:
 - Copyright (C) 2017, 2020 embedded brains GmbH (http://www.embedded-brains.de)
 definition:
@@ -14,8 +14,8 @@ definition:
     return: ${../../status/if/code:/name}
   variants: []
 description: |
-  The scheduler instance is selected according to the highest numbered online
-  processor in the specified processor set.
+  The scheduler is selected according to the highest numbered online processor
+  in the specified processor set.
 enabled-by: true
 index-entries: []
 interface-type: function
@@ -34,13 +34,13 @@ params:
   name: cpusetsize
 - description: |
     is the pointer to a processor set variable.  The referenced processor set
-    will be used to identify the scheduler instance.
+    will be used to identify the scheduler.
   dir: null
   name: cpuset
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    scheduler instance will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the scheduler will be stored in this
+    variable.
   dir: out
   name: id
 return:
@@ -51,7 +51,7 @@ return:
     value: ${../../status/if/successful:/name}
   - description: |
       The processor set was valid, however, the highest numbered online
-      processor in the processor set was not owned by a scheduler instance.
+      processor in the processor set was not owned by a scheduler.
     value: ${../../status/if/incorrect-state:/name}
   - description: |
       The ${.:/params[2]/name} parameter was ${/c/if/null:/name}.
diff --git a/spec/rtems/scheduler/if/ident-by-processor.yml b/spec/rtems/scheduler/if/ident-by-processor.yml
index 5aaa848d..881155e4 100644
--- a/spec/rtems/scheduler/if/ident-by-processor.yml
+++ b/spec/rtems/scheduler/if/ident-by-processor.yml
@@ -29,9 +29,9 @@ params:
   dir: null
   name: cpu_index
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    scheduler instance will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the scheduler instance will be stored in
+    this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/scheduler/if/ident.yml b/spec/rtems/scheduler/if/ident.yml
index 520a7f86..328040b9 100644
--- a/spec/rtems/scheduler/if/ident.yml
+++ b/spec/rtems/scheduler/if/ident.yml
@@ -39,9 +39,9 @@ params:
   dir: null
   name: name
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    scheduler instance will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the scheduler instance will be stored in
+    this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/scheduler/if/map-priority-from-posix.yml b/spec/rtems/scheduler/if/map-priority-from-posix.yml
index 53274b67..1c05f44b 100644
--- a/spec/rtems/scheduler/if/map-priority-from-posix.yml
+++ b/spec/rtems/scheduler/if/map-priority-from-posix.yml
@@ -25,16 +25,16 @@ links:
 name: rtems_scheduler_map_priority_from_posix
 notes: null
 params:
-- description: is the scheduler instance identifier.
+- description: is the scheduler identifier.
   dir: null
   name: scheduler_id
 - description: is the POSIX thread priority to map.
   dir: null
   name: posix_priority
 - description: |
-    is the pointer to a Classic API task priority variable.  The Classic API
-    task priority value corresponding to the specified POSIX thread priority
-    value will be stored in this variable, in case of a successful operation.
+    is the pointer to a Classic API task priority variable.  When the directive
+    call is successful, the Classic API task priority value corresponding to
+    the specified POSIX thread priority value will be stored in this variable.
   dir: out
   name: priority
 return:
diff --git a/spec/rtems/scheduler/if/map-priority-to-posix.yml b/spec/rtems/scheduler/if/map-priority-to-posix.yml
index 4ca3e515..c887d45f 100644
--- a/spec/rtems/scheduler/if/map-priority-to-posix.yml
+++ b/spec/rtems/scheduler/if/map-priority-to-posix.yml
@@ -32,9 +32,9 @@ params:
   dir: null
   name: priority
 - description: |
-    is the pointer to a POSIX thread priority variable.  The POSIX thread
-    priority value corresponding to the specified Classic API task priority
-    value will be stored in this variable, in case of a successful operation.
+    is the pointer to a POSIX thread priority variable.  When the directive
+    call is successful, the POSIX thread priority value corresponding to the
+    specified Classic API task priority value will be stored in this variable.
   dir: out
   name: posix_priority
 return:
diff --git a/spec/rtems/sem/if/create.yml b/spec/rtems/sem/if/create.yml
index 10b58d4c..ddffa612 100644
--- a/spec/rtems/sem/if/create.yml
+++ b/spec/rtems/sem/if/create.yml
@@ -171,9 +171,9 @@ params:
   dir: null
   name: priority_ceiling
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created semaphore will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created semaphore will be stored in
+    this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/sem/if/ident.yml b/spec/rtems/sem/if/ident.yml
index 5b223830..5caf1bea 100644
--- a/spec/rtems/sem/if/ident.yml
+++ b/spec/rtems/sem/if/ident.yml
@@ -71,9 +71,9 @@ params:
   dir: null
   name: node
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/sem/if/set-priority.yml b/spec/rtems/sem/if/set-priority.yml
index 874353d9..99b56947 100644
--- a/spec/rtems/sem/if/set-priority.yml
+++ b/spec/rtems/sem/if/set-priority.yml
@@ -158,9 +158,9 @@ params:
   dir: null
   name: new_priority
 - description: |
-    is the pointer to a task priority variable.  The old priority of the
-    semaphore corresponding to the specified scheduler will be stored in this
-    variable, in case of a successful operation.
+    is the pointer to a task priority variable.  When the directive call is
+    successful, the old priority of the semaphore corresponding to the
+    specified scheduler will be stored in this variable.
   dir: out
   name: old_priority
 return:
diff --git a/spec/rtems/task/if/construct.yml b/spec/rtems/task/if/construct.yml
index cb0dda37..b0c76599 100644
--- a/spec/rtems/task/if/construct.yml
+++ b/spec/rtems/task/if/construct.yml
@@ -67,9 +67,9 @@ params:
   dir: null
   name: config
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    constructed task will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the constructed task will be stored in
+    this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/task/if/create.yml b/spec/rtems/task/if/create.yml
index 46da64e8..3b90a861 100644
--- a/spec/rtems/task/if/create.yml
+++ b/spec/rtems/task/if/create.yml
@@ -224,9 +224,9 @@ params:
   dir: null
   name: attribute_set
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created task will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created task will be stored in this
+    variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/task/if/ident.yml b/spec/rtems/task/if/ident.yml
index bfdfb115..b8fbf4bc 100644
--- a/spec/rtems/task/if/ident.yml
+++ b/spec/rtems/task/if/ident.yml
@@ -73,9 +73,9 @@ params:
   dir: null
   name: node
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/timer/if/create.yml b/spec/rtems/timer/if/create.yml
index ba8be42a..e7aab890 100644
--- a/spec/rtems/timer/if/create.yml
+++ b/spec/rtems/timer/if/create.yml
@@ -50,9 +50,9 @@ params:
   dir: null
   name: name
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created timer will be stored in this variable, in case of a successful
-    operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created timer will be stored in this
+    variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/timer/if/get-information.yml b/spec/rtems/timer/if/get-information.yml
index a69032eb..5c1c3597 100644
--- a/spec/rtems/timer/if/get-information.yml
+++ b/spec/rtems/timer/if/get-information.yml
@@ -38,8 +38,9 @@ params:
   dir: null
   name: id
 - description: |
-    is the pointer to a timer information variable.  The information about the
-    timer will be stored in this variable, in case of a successful operation.
+    is the pointer to a timer information variable.  When the directive call is
+    successful, the information about the timer will be stored in this
+    variable.
   dir: out
   name: the_info
 return:
diff --git a/spec/rtems/timer/if/ident.yml b/spec/rtems/timer/if/ident.yml
index c99b4981..3c351e2d 100644
--- a/spec/rtems/timer/if/ident.yml
+++ b/spec/rtems/timer/if/ident.yml
@@ -46,9 +46,9 @@ params:
   dir: null
   name: name
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/userext/if/create.yml b/spec/rtems/userext/if/create.yml
index e5bbd3a6..21a46165 100644
--- a/spec/rtems/userext/if/create.yml
+++ b/spec/rtems/userext/if/create.yml
@@ -64,9 +64,9 @@ params:
   dir: null
   name: extension_table
 - description: |
-    is the pointer to an object identifier variable.  The identifier of the
-    created extension set will be stored in this variable, in case of a
-    successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the identifier of the created extension set will be stored
+    in this variable.
   dir: out
   name: id
 return:
diff --git a/spec/rtems/userext/if/ident.yml b/spec/rtems/userext/if/ident.yml
index 162e565d..93bfdb0c 100644
--- a/spec/rtems/userext/if/ident.yml
+++ b/spec/rtems/userext/if/ident.yml
@@ -46,9 +46,9 @@ params:
   dir: null
   name: name
 - description: |
-    is the pointer to an object identifier variable.  The object identifier of
-    an object with the specified name will be stored in this variable, in case
-    of a successful operation.
+    is the pointer to an object identifier variable.  When the directive call
+    is successful, the object identifier of an object with the specified name
+    will be stored in this variable.
   dir: out
   name: id
 return: