rtems/rtems-docs
1
0
Fork 0
mirror of https://git.rtems.org/rtems-docs/ synced 2025-05-15 17:46:49 +08:00
Code Issues Packages Projects Releases Wiki Activity

eng: Clarify stlib build attribute

Browse Source 
Update #4107.
This commit is contained in:
Sebastian Huber 2020-10-01 07:37:04 +02:00
parent e70aebd4d9
commit 9628dfde43
1 changed files with 32 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
eng/req/items.rst
View File

@ -279,9 +279,8 @@ source
:ref:`SpecTypeBuildSource`. :ref:`SpecTypeBuildSource`.
stlib stlib
The attribute value shall be a list of strings. It shall be a list of The attribute value shall be a list. Each list element shall be a
external static library identifiers used to link this test program, e.g. :ref:`SpecTypeBuildLinkStaticLibraryDirective`.
``m`` for ``libm.a``.
target target
The attribute value shall be a :ref:`SpecTypeBuildTarget`. The attribute value shall be a :ref:`SpecTypeBuildTarget`.
@ -821,9 +820,8 @@ prepare-configure
context. context.
stlib stlib
The attribute value shall be a list of strings. It shall be a list of The attribute value shall be a list. Each list element shall be a
external static library identifiers used to link this test program, e.g. :ref:`SpecTypeBuildLinkStaticLibraryDirective`.
``m`` for ``libm.a``.
use-after use-after
The attribute value shall be a list. Each list element shall be a The attribute value shall be a list. Each list element shall be a
@ -954,9 +952,8 @@ source
:ref:`SpecTypeBuildSource`. :ref:`SpecTypeBuildSource`.
stlib stlib
The attribute value shall be a list of strings. It shall be a list of The attribute value shall be a list. Each list element shall be a
external static library identifiers used to link this test program, e.g. :ref:`SpecTypeBuildLinkStaticLibraryDirective`.
``m`` for ``libm.a``.
target target
The attribute value shall be a :ref:`SpecTypeBuildTarget`. The attribute value shall be a :ref:`SpecTypeBuildTarget`.
@ -2712,6 +2709,26 @@ This type is used by the following types:
* :ref:`SpecTypeBuildStartFileItemType` * :ref:`SpecTypeBuildStartFileItemType`
.. _SpecTypeBuildLinkStaticLibraryDirective:
Build Link Static Library Directive
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The value shall be a string. 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.
This type is used by the following types:
* :ref:`SpecTypeBuildAdaTestProgramItemType`
* :ref:`SpecTypeBuildScriptItemType`
* :ref:`SpecTypeBuildTestProgramItemType`
.. _SpecTypeBuildLinkerOption: .. _SpecTypeBuildLinkerOption:
Build Linker Option Build Linker Option
@ -3123,8 +3140,9 @@ Build Use After Directive
^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^
The value shall be a string. It shall be an internal static library identifier. The value shall be a string. It shall be an internal static library identifier.
They are used to link programs referenced by this item, e.g. ``z`` for The library is 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. ``libz.a``. The library is placed after the use items of the build item
context.
This type is used by the following types: This type is used by the following types:
@ -3142,8 +3160,9 @@ Build Use Before Directive
^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^^^^^
The value shall be a string. It shall be an internal static library identifier. The value shall be a string. It shall be an internal static library identifier.
They are used to link programs referenced by this item, e.g. ``z`` for The library is 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. ``libz.a``. The library is placed before the use items of the build item
context.
This type is used by the following types: This type is used by the following types: