[rtems-central commit] spec: Clarify invalid identifier descriptions

[Sebastian Huber]

Module:    rtems-central
Branch:    master
Commit:    c3193cc178cbed469704ad85add339ea01713bd1
Changeset: http://git.rtems.org/rtems-central/commit/?id=c3193cc178cbed469704ad85add339ea01713bd1

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Wed Dec  2 08:31:46 2020 +0100

spec: Clarify invalid identifier descriptions

---

 spec/rtems/event/if/send.yml                        | 3 ++-
 spec/rtems/part/if/delete.yml                       | 3 ++-
 spec/rtems/part/if/get-buffer.yml                   | 3 ++-
 spec/rtems/part/if/return-buffer.yml                | 3 ++-
 spec/rtems/scheduler/if/add-processor.yml           | 3 ++-
 spec/rtems/scheduler/if/get-maximum-priority.yml    | 3 ++-
 spec/rtems/scheduler/if/get-processor-set.yml       | 3 ++-
 spec/rtems/scheduler/if/map-priority-from-posix.yml | 3 ++-
 spec/rtems/scheduler/if/map-priority-to-posix.yml   | 3 ++-
 spec/rtems/scheduler/if/remove-processor.yml        | 3 ++-
 10 files changed, 20 insertions(+), 10 deletions(-)

diff --git a/spec/rtems/event/if/send.yml b/spec/rtems/event/if/send.yml
index a2ff4d4..f061503 100644
--- a/spec/rtems/event/if/send.yml
+++ b/spec/rtems/event/if/send.yml
@@ -71,6 +71,7 @@ return:
       The requested operation was successful.
     value: ${../../status/if/successful:/name}
   - description: |
-      There was no task with the specified identifier.
+      There was no task associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
 type: interface
diff --git a/spec/rtems/part/if/delete.yml b/spec/rtems/part/if/delete.yml
index 2b4d8f1..5dad046 100644
--- a/spec/rtems/part/if/delete.yml
+++ b/spec/rtems/part/if/delete.yml
@@ -52,7 +52,8 @@ return:
       The requested operation was successful.
     value: ${../../status/if/successful:/name}
   - description: |
-      There was no partition with the specified identifier.
+      There was no partition associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
   - description: |
       The partition resided on a remote node.
diff --git a/spec/rtems/part/if/get-buffer.yml b/spec/rtems/part/if/get-buffer.yml
index adced27..b2b13bd 100644
--- a/spec/rtems/part/if/get-buffer.yml
+++ b/spec/rtems/part/if/get-buffer.yml
@@ -55,7 +55,8 @@ return:
       The requested operation was successful.
     value: ${../../status/if/successful:/name}
   - description: |
-      There was no partition with the specified identifier.
+      There was no partition associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
   - description: |
       The ${.:/params[1]/name} parameter was ${/c/if/null:/name}.
diff --git a/spec/rtems/part/if/return-buffer.yml b/spec/rtems/part/if/return-buffer.yml
index 7f31203..db67b5c 100644
--- a/spec/rtems/part/if/return-buffer.yml
+++ b/spec/rtems/part/if/return-buffer.yml
@@ -49,7 +49,8 @@ return:
       The requested operation was successful.
     value: ${../../status/if/successful:/name}
   - description: |
-      There was no partition with the specified identifier.
+      There was no partition associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
   - description: |
       The buffer referenced by ${.:/params[1]/name} was not in the
diff --git a/spec/rtems/scheduler/if/add-processor.yml b/spec/rtems/scheduler/if/add-processor.yml
index 31522a5..c7aa80b 100644
--- a/spec/rtems/scheduler/if/add-processor.yml
+++ b/spec/rtems/scheduler/if/add-processor.yml
@@ -43,7 +43,8 @@ return:
       was not online.
     value: ${../../status/if/incorrect-state:/name}
   - description: |
-      The scheduler instance identifier was invalid.
+      There was no scheduler associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
   - description: |
       The processor was not configured to be used by the application.
diff --git a/spec/rtems/scheduler/if/get-maximum-priority.yml b/spec/rtems/scheduler/if/get-maximum-priority.yml
index fa0c06d..002d3a9 100644
--- a/spec/rtems/scheduler/if/get-maximum-priority.yml
+++ b/spec/rtems/scheduler/if/get-maximum-priority.yml
@@ -43,6 +43,7 @@ return:
       The ${.:/params[1]/name} parameter was ${/c/if/null:/name}.
     value: ${../../status/if/invalid-address:/name}
   - description: |
-      The scheduler instance identifier was invalid.
+      There was no scheduler associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
 type: interface
diff --git a/spec/rtems/scheduler/if/get-processor-set.yml b/spec/rtems/scheduler/if/get-processor-set.yml
index 7e9dc1f..9a942fc 100644
--- a/spec/rtems/scheduler/if/get-processor-set.yml
+++ b/spec/rtems/scheduler/if/get-processor-set.yml
@@ -51,7 +51,8 @@ return:
       The ${.:/params[2]/name} parameter was ${/c/if/null:/name}.
     value: ${../../status/if/invalid-address:/name}
   - description: |
-      The scheduler instance identifier was invalid.
+      There was no scheduler associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
   - description: |
       The provided processor set was too small for the set of processors owned
diff --git a/spec/rtems/scheduler/if/map-priority-from-posix.yml b/spec/rtems/scheduler/if/map-priority-from-posix.yml
index adb7eaa..4b8bbe0 100644
--- a/spec/rtems/scheduler/if/map-priority-from-posix.yml
+++ b/spec/rtems/scheduler/if/map-priority-from-posix.yml
@@ -47,7 +47,8 @@ return:
       The ${.:/params[2]/name} parameter was ${/c/if/null:/name}.
     value: ${../../status/if/invalid-address:/name}
   - description: |
-      The scheduler instance identifier was invalid.
+      There was no scheduler associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
   - description: |
       The POSIX thread priority was invalid.
diff --git a/spec/rtems/scheduler/if/map-priority-to-posix.yml b/spec/rtems/scheduler/if/map-priority-to-posix.yml
index 3780f00..50d6b8d 100644
--- a/spec/rtems/scheduler/if/map-priority-to-posix.yml
+++ b/spec/rtems/scheduler/if/map-priority-to-posix.yml
@@ -47,7 +47,8 @@ return:
       The ${.:/params[2]/name} parameter was ${/c/if/null:/name}.
     value: ${../../status/if/invalid-address:/name}
   - description: |
-      The scheduler instance identifier was invalid.
+      There was no scheduler associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
   - description: |
       The Classic API task priority was invalid.
diff --git a/spec/rtems/scheduler/if/remove-processor.yml b/spec/rtems/scheduler/if/remove-processor.yml
index 82d7907..9db5152 100644
--- a/spec/rtems/scheduler/if/remove-processor.yml
+++ b/spec/rtems/scheduler/if/remove-processor.yml
@@ -40,7 +40,8 @@ return:
       The requested operation was successful.
     value: ${../../status/if/successful:/name}
   - description: |
-      The scheduler instance identifier was invalid.
+      There was no scheduler associated with the identifier specified by
+      ${.:/params[0]/name}.
     value: ${../../status/if/invalid-id:/name}
   - description: |
       The processor was not owned by the specified scheduler instance.