diff options
Diffstat (limited to 'eng/build-system.rst')
-rw-r--r-- | eng/build-system.rst | 41 |
1 files changed, 35 insertions, 6 deletions
diff --git a/eng/build-system.rst b/eng/build-system.rst index e76b606..11e8ba7 100644 --- a/eng/build-system.rst +++ b/eng/build-system.rst @@ -1,6 +1,6 @@ .. SPDX-License-Identifier: CC-BY-SA-4.0 -.. Copyright (C) 2019, 2020 embedded brains GmbH (http://www.embedded-brains.de) +.. Copyright (C) 2019, 2020 embedded brains GmbH & Co. KG .. _BSPBuildSystem: @@ -73,13 +73,13 @@ the following ``waf`` commands do. BSP List -------- -In the ``./waf bsp_list`` command, the BSP list is generated from the +In the ``./waf bsplist`` command, the BSP list is generated from the :ref:`SpecTypeBuildBSPItemType` items. BSP Defaults ------------ -In the ``./waf bsp_defaults`` command, the BSP defaults are generated from the +In the ``./waf bspdefaults`` command, the BSP defaults are generated from the :ref:`SpecTypeBuildBSPItemType` and :ref:`SpecTypeBuildOptionItemType` items. Build specification items contribute to the command through the ``do_defaults()`` method in the ``wscript``. @@ -294,7 +294,7 @@ shows the GCC-specific ABI flags item of the ``sparc/leon3`` BSP family: - env-append: null build-type: option copyrights: - - Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de) + - Copyright (C) 2020 embedded brains GmbH & Co. KG default: - -mcpu=leon3 default-by-variant: @@ -355,8 +355,8 @@ Add a Base BSP to a BSP Family items ``spec:/build/bsps/arch/family/bsprst``, ``spec:/build/bsps/arch/family/bspuvw``, and ``spec:/build/bsps/arch/family/bspxyz`` just define the name of the base - BSP and set a link to the group item. The base BSP names can be used for - example in the ``default-by-variant`` attribute of + BSP and set a link to the group item. The base BSP and BSP family names + can be used for example in the ``default-by-variant`` attribute of :ref:`SpecTypeBuildOptionItemType` items. The items linked by the BSP items are shown using relative UIDs. @@ -489,3 +489,32 @@ Add a link to the new library item using a relative UID: links: - role: build-dependency 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 |