[rtems-central commit] spec: Clarify stlib build attribute

[Sebastian Huber]

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

Author:    Sebastian Huber <sebastian.huber at embedded-brains.de>
Date:      Thu Oct  1 07:33:26 2020 +0200

spec: Clarify stlib build attribute

---

 spec/spec/build-ada-test-program.yml |  6 ++----
 spec/spec/build-script.yml           |  6 ++----
 spec/spec/build-stlib-list.yml       | 16 ++++++++++++++++
 spec/spec/build-stlib.yml            | 21 +++++++++++++++++++++
 spec/spec/build-test-program.yml     |  6 ++----
 spec/spec/build-use-after.yml        |  6 +++---
 spec/spec/build-use-before.yml       |  6 +++---
 7 files changed, 49 insertions(+), 18 deletions(-)

diff --git a/spec/spec/build-ada-test-program.yml b/spec/spec/build-ada-test-program.yml
index 2151873..ea905ea 100644
--- a/spec/spec/build-ada-test-program.yml
+++ b/spec/spec/build-ada-test-program.yml
@@ -69,10 +69,8 @@ spec-info:
         description: null
         spec-type: build-source-list
       stlib:
-        description: |
-          It shall be a list of external static library identifiers used to
-          link this test program, e.g. ``m`` for ``libm.a``.
-        spec-type: list-str
+        description: null
+        spec-type: build-stlib-list
       target:
         description: null
         spec-type: build-target
diff --git a/spec/spec/build-script.yml b/spec/spec/build-script.yml
index 9cce6f0..9caeb31 100644
--- a/spec/spec/build-script.yml
+++ b/spec/spec/build-script.yml
@@ -87,10 +87,8 @@ spec-info:
           ``cic`` is available with the configuration item context.
         spec-type: optional-str
       stlib:
-        description: |
-          It shall be a list of external static library identifiers used to
-          link this test program, e.g. ``m`` for ``libm.a``.
-        spec-type: list-str
+        description: null
+        spec-type: build-stlib-list
       use-after:
         description: null
         spec-type: build-use-after-list
diff --git a/spec/spec/build-stlib-list.yml b/spec/spec/build-stlib-list.yml
new file mode 100644
index 0000000..0f22f64
--- /dev/null
+++ b/spec/spec/build-stlib-list.yml
@@ -0,0 +1,16 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+links:
+- role: spec-member
+  uid: root
+spec-description: null
+spec-example: null
+spec-info:
+  list:
+    description: null
+    spec-type: build-stlib
+spec-name: Build Link Static Library List
+spec-type: build-stlib-list
+type: spec
diff --git a/spec/spec/build-stlib.yml b/spec/spec/build-stlib.yml
new file mode 100644
index 0000000..24d401b
--- /dev/null
+++ b/spec/spec/build-stlib.yml
@@ -0,0 +1,21 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+links:
+- role: spec-member
+  uid: root
+spec-description: null
+spec-example: null
+spec-info:
+  str:
+    description: |
+      It shall be an external static library identifier.  The library is used
+      to link programs referenced by this item, e.g. ``m`` for ``libm.a``.  The
+      library is added to the build command through the ``stlib`` attribute.
+      It shall not be used for internal static libraries.  Internal static
+      libraries shall be specified through the ``use-after`` and ``use-before``
+      attributes to enable a proper build dependency tracking.
+spec-name: Build Link Static Library Directive
+spec-type: build-stlib
+type: spec
diff --git a/spec/spec/build-test-program.yml b/spec/spec/build-test-program.yml
index 0f96964..2442e65 100644
--- a/spec/spec/build-test-program.yml
+++ b/spec/spec/build-test-program.yml
@@ -57,10 +57,8 @@ spec-info:
         description: null
         spec-type: build-source-list
       stlib:
-        description: |
-          It shall be a list of external static library identifiers used to
-          link this test program, e.g. ``m`` for ``libm.a``.
-        spec-type: list-str
+        description: null
+        spec-type: build-stlib-list
       target:
         description: null
         spec-type: build-target
diff --git a/spec/spec/build-use-after.yml b/spec/spec/build-use-after.yml
index f42c53d..8545721 100644
--- a/spec/spec/build-use-after.yml
+++ b/spec/spec/build-use-after.yml
@@ -10,9 +10,9 @@ spec-example: null
 spec-info:
   str:
     description: |
-      It shall be an internal static library identifier.  They are used to link
-      programs referenced by this item, e.g. ``z`` for ``libz.a``.  They are
-      placed after the use items of the build item context.
+      It shall be an internal static library identifier.  The library is used
+      to link programs referenced by this item, e.g. ``z`` for ``libz.a``.  The
+      library is placed after the use items of the build item context.
 spec-name: Build Use After Directive
 spec-type: build-use-after
 type: spec
diff --git a/spec/spec/build-use-before.yml b/spec/spec/build-use-before.yml
index 27dfa33..4b34cb2 100644
--- a/spec/spec/build-use-before.yml
+++ b/spec/spec/build-use-before.yml
@@ -10,9 +10,9 @@ spec-example: null
 spec-info:
   str:
     description: |
-      It shall be an internal static library identifier.  They are used to link
-      programs referenced by this item, e.g. ``z`` for ``libz.a``.  They are
-      placed before the use items of the build item context.
+      It shall be an internal static library identifier.  The library is used
+      to link programs referenced by this item, e.g. ``z`` for ``libz.a``.  The
+      library is placed before the use items of the build item context.
 spec-name: Build Use Before Directive
 spec-type: build-use-before
 type: spec