spec: Clarify stlib build attribute

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 21518735..ea905eae 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 9cce6f03..9caeb313 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 00000000..0f22f641
--- /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 00000000..24d401b8
--- /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 0f96964b..2442e651 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 f42c53db..85457219 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 27dfa33e..4b34cb21 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