summaryrefslogtreecommitdiff
path: root/spec/spec/build-script.yml
blob: e34853e338064eccc5033d30f1206f57f7c6176d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
copyrights:
- Copyright (C) 2020 embedded brains GmbH & Co. KG
enabled-by: true
links:
- role: spec-member
  uid: root
- role: spec-refinement
  spec-key: build-type
  spec-value: script
  uid: build
spec-description: null
spec-example: |
  SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
  build-type: script
  copyrights:
  - Copyright (C) 2020 embedded brains GmbH & Co. KG
  default: null
  default-by-variant: []
  do-build: |
    bld.install_as(
        "${BSP_LIBDIR}/linkcmds",
        "bsps/" + bld.env.ARCH + "/" + bld.env.BSP_FAMILY +
        "/start/linkcmds." + bld.env.BSP_BASE
    )
  do-configure: |
    conf.env.append_value(
        "LINKFLAGS",
        ["-qnolinkcmds", "-T", "linkcmds." + conf.env.BSP_BASE]
    )
  enabled-by: true
  links: []
  prepare-build: null
  prepare-configure: null
  type: build
spec-info:
  dict:
    attributes:
      asflags:
        description: null
        spec-type: build-asflags
      cflags:
        description: null
        spec-type: build-cflags
      cppflags:
        description: null
        spec-type: build-cppflags
      cxxflags:
        description: null
        spec-type: build-cxxflags
      do-build:
        description: |
          If this script shall execute, then it shall be Python code which is
          executed via ``exec()`` in the context of the ``do_build()`` method
          of the :file:`wscript`.  A local variable ``bld`` is available with
          the ``waf`` build context.  A local variable ``bic`` is available
          with the build item context.
        spec-type: optional-str
      do-configure:
        description: |
          If this script shall execute, then it shall be Python code which is
          executed via ``exec()`` in the context of the ``do_configure()``
          method of the :file:`wscript`.  A local variable ``conf`` is
          available with the ``waf`` configuration context.  A local variable
          ``cic`` is available with the configuration item context.
        spec-type: optional-str
      includes:
        description: null
        spec-type: build-includes
      ldflags:
        description: null
        spec-type: build-ldflags
      prepare-build:
        description: |
          If this script shall execute, then it shall be Python code which is
          executed via ``exec()`` in the context of the ``prepare_build()``
          method of the :file:`wscript`.  A local variable ``bld`` is available
          with the ``waf`` build context.  A local variable ``bic`` is
          available with the build item context.
        spec-type: optional-str
      prepare-configure:
        description: |
          If this script shall execute, then it shall be Python code which is
          executed via ``exec()`` in the context of the ``prepare_configure()``
          method of the :file:`wscript`.  A local variable ``conf`` is
          available with the ``waf`` configuration context.  A local variable
          ``cic`` is available with the configuration item context.
        spec-type: optional-str
      stlib:
        description: null
        spec-type: build-stlib-list
      target:
        description: null
        spec-type: build-target
      use-after:
        description: null
        spec-type: build-use-after-list
      use-before:
        description: null
        spec-type: build-use-before-list
    description: |
      This set of attributes specifies a build script.  The optional attributes
      may be required by commands executed through the scripts.
    mandatory-attributes:
    - do-build
    - do-configure
    - prepare-build
    - prepare-configure
spec-name: Build Script Item Type
spec-type: build-script
type: spec