eng: Add ObjectsItem details

This adds a section on adding ObjectsItems.
This commit is contained in:
Kinsey Moore 2023-02-07 16:02:47 -06:00 committed by Sebastian Huber
parent 68a44b2524
commit cb375249c5
2 changed files with 35 additions and 2 deletions

View File

@ -489,3 +489,32 @@ Add a link to the new library item using a relative UID:
links: links:
- role: build-dependency - role: build-dependency
uid: libnew uid: libnew
Add an Object
-------------
Build objects logically separate relatively independent segments of
functionality (for example a device driver, an architecture-dependent feature,
etc.). Let *new* be the name of the new object. You can add the new object
with:
.. code-block:: none
$ vi spec/build/cpukit/objnew.yml
Define the attributes of your new object according to
:ref:`SpecTypeBuildObjectsItemType`.
Edit corresponding group item:
.. code-block:: none
$ vi spec/build/cpukit/grp.yml
Add a link to the new objects item using a relative UID:
.. code-block:: yaml
links:
- role: build-dependency
uid: objnew

View File

@ -649,8 +649,12 @@ Build Objects Item Type
This type refines the :ref:`SpecTypeBuildItemType` through the ``build-type`` This type refines the :ref:`SpecTypeBuildItemType` through the ``build-type``
attribute if the value is ``objects``. This set of attributes specifies a set attribute if the value is ``objects``. This set of attributes specifies a set
of object files used to build static libraries or test programs. All explicit of object files used to build static libraries or test programs. Objects Items
attributes shall be specified. The explicit attributes for this type are: must not be included on multiple paths through the build dependency graph with
identical build options. Violating this can cause race conditions in the build
system due to duplicate installs and multiple instances of build tasks. All
explicit attributes shall be specified. The explicit attributes for this type
are:
cflags cflags
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