bake-toolkit 2.28.0 → 2.28.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. checksums.yaml +4 -4
  2. data/documentation/_build/html/_sources/changelog.txt +3 -0
  3. data/documentation/_build/html/_sources/index.txt +1 -1
  4. data/documentation/_build/html/_static/logo_tiny_48.png +0 -0
  5. data/documentation/_build/html/changelog.html +1154 -1149
  6. data/documentation/_build/html/commandline/commandline.html +285 -285
  7. data/documentation/_build/html/concepts/build_hierarchy.html +204 -204
  8. data/documentation/_build/html/concepts/concepts.html +196 -196
  9. data/documentation/_build/html/concepts/inject.html +216 -216
  10. data/documentation/_build/html/concepts/link_order.html +245 -245
  11. data/documentation/_build/html/concepts/prebuild.html +205 -205
  12. data/documentation/_build/html/concepts/the_main_project.html +260 -260
  13. data/documentation/_build/html/concepts/the_project_meta_file.html +288 -288
  14. data/documentation/_build/html/genindex.html +152 -152
  15. data/documentation/_build/html/ide/eclipse/eclipse.html +186 -186
  16. data/documentation/_build/html/ide/eclipse/how_to_convert_existing_cdt_workspace.html +208 -208
  17. data/documentation/_build/html/ide/eclipse/how_to_create_a_new_project_in_eclipse.html +191 -191
  18. data/documentation/_build/html/ide/eclipse/how_to_create_a_workspace_in_eclipse.html +198 -198
  19. data/documentation/_build/html/ide/eclipse/how_to_debug_in_eclipse.html +198 -198
  20. data/documentation/_build/html/ide/eclipse/how_to_install_eclipse_plugin.html +196 -196
  21. data/documentation/_build/html/ide/eclipse/how_to_use_bake_in_eclipse.html +256 -256
  22. data/documentation/_build/html/ide/ide_integrations.html +185 -185
  23. data/documentation/_build/html/ide/vs/how_to_create_vs_projects.html +171 -171
  24. data/documentation/_build/html/ide/vs/how_to_debug_in_vs.html +185 -185
  25. data/documentation/_build/html/ide/vs/how_to_used_bake_in_vs.html +190 -190
  26. data/documentation/_build/html/ide/vs/vs.html +170 -170
  27. data/documentation/_build/html/ide/vs/vs_install.html +202 -202
  28. data/documentation/_build/html/index.html +246 -246
  29. data/documentation/_build/html/install/install_bake.html +279 -279
  30. data/documentation/_build/html/internal.html +217 -217
  31. data/documentation/_build/html/known_issues.html +173 -173
  32. data/documentation/_build/html/license.html +236 -236
  33. data/documentation/_build/html/performance/performance.html +373 -373
  34. data/documentation/_build/html/quickstart/quickstart.html +236 -236
  35. data/documentation/_build/html/search.html +174 -174
  36. data/documentation/_build/html/searchindex.js +1 -1
  37. data/documentation/_build/html/syntax/adapt_configs.html +370 -370
  38. data/documentation/_build/html/syntax/auto_adjustment.html +189 -189
  39. data/documentation/_build/html/syntax/derive_configs.html +247 -247
  40. data/documentation/_build/html/syntax/project_meta_syntax.html +923 -923
  41. data/documentation/_build/html/syntax/syntax.html +196 -196
  42. data/documentation/_build/html/syntax/variable_substitutions.html +365 -365
  43. data/documentation/_build/html/tips_and_tricks/bakeclean.html +169 -169
  44. data/documentation/_build/html/tips_and_tricks/dot.html +186 -186
  45. data/documentation/_build/html/tips_and_tricks/how_to_use_bake_with_cygwin.html +214 -214
  46. data/documentation/_build/html/tips_and_tricks/qac.html +297 -297
  47. data/documentation/_build/html/tips_and_tricks/the_bakery.html +405 -405
  48. data/documentation/_build/html/tips_and_tricks/the_clang.html +201 -201
  49. data/documentation/_build/html/tips_and_tricks/tips_and_tricks.html +198 -198
  50. data/documentation/_build/html/why_bake/why_bake.html +241 -241
  51. data/lib/bake/config/checks.rb +76 -68
  52. data/lib/bake/model/metamodel.rb +6 -0
  53. data/lib/common/version.rb +1 -1
  54. metadata +3 -5
  55. data/documentation/_build/html/_sources/tips_and_tricks/static_code_analysis.txt +0 -122
  56. data/documentation/_build/html/_static/logo_conformant_48.png +0 -0
  57. data/documentation/_build/html/tips_and_tricks/static_code_analysis.html +0 -285
@@ -1,190 +1,190 @@
1
- <!DOCTYPE html>
2
-
3
-
4
- <html xmlns="http://www.w3.org/1999/xhtml">
5
- <head>
6
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7
-
8
- <title>Auto-adjustment of paths to existing projects &mdash; bake documentation</title>
9
-
10
- <link rel="stylesheet" href="../_static/basic.css" type="text/css" />
11
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
12
- <link rel="stylesheet" href="../_static/bootswatch-3.3.4/sandstone/bootstrap.min.css" type="text/css" />
13
- <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
14
-
15
- <script type="text/javascript">
16
- var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '../',
18
- VERSION: '',
19
- COLLAPSE_INDEX: false,
20
- FILE_SUFFIX: '.html',
21
- HAS_SOURCE: true
22
- };
23
- </script>
24
- <script type="text/javascript" src="../_static/jquery.js"></script>
25
- <script type="text/javascript" src="../_static/underscore.js"></script>
26
- <script type="text/javascript" src="../_static/doctools.js"></script>
27
- <script type="text/javascript" src="../_static/js/jquery-1.11.0.min.js"></script>
28
- <script type="text/javascript" src="../_static/js/jquery-fix.js"></script>
29
- <script type="text/javascript" src="../_static/bootstrap-3.3.4/js/bootstrap.min.js"></script>
30
- <script type="text/javascript" src="../_static/bootstrap-sphinx.js"></script>
31
- <link rel="shortcut icon" href="../_static/logo_tiny_32.ico"/>
32
- <link rel="top" title="bake documentation" href="../index.html" />
33
- <link rel="up" title="Syntax" href="syntax.html" />
34
- <link rel="next" title="Commandline" href="../commandline/commandline.html" />
35
- <link rel="prev" title="Adapt configs" href="adapt_configs.html" />
36
- <meta charset='utf-8'>
37
- <meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
38
- <meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
39
- <meta name="apple-mobile-web-app-capable" content="yes">
40
-
41
- </head>
42
- <body role="document">
43
-
44
- <div id="navbar" class="navbar navbar-default navbar-fixed-top">
45
- <div class="container">
46
- <div class="navbar-header">
47
- <!-- .btn-navbar is used as the toggle for collapsed navbar content -->
48
- <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
49
- <span class="icon-bar"></span>
50
- <span class="icon-bar"></span>
51
- <span class="icon-bar"></span>
52
- </button>
53
- <a class="navbar-brand" href="../index.html"><img src="../_static/logo_conformant_48.png">
54
- </a>
55
- <span class="navbar-text navbar-version pull-left"><b></b></span>
56
- </div>
57
-
58
- <div class="collapse navbar-collapse nav-collapse">
59
- <ul class="nav navbar-nav">
60
-
61
-
62
- <li class="dropdown globaltoc-container">
63
- <a role="button"
64
- id="dLabelGlobalToc"
65
- data-toggle="dropdown"
66
- data-target="#"
67
- href="../index.html">Section <b class="caret"></b></a>
68
- <ul class="dropdown-menu globaltoc"
69
- role="menu"
70
- aria-labelledby="dLabelGlobalToc"><ul class="current">
71
- <li class="toctree-l1"><a class="reference internal" href="../why_bake/why_bake.html">Why you should use bake</a></li>
72
- <li class="toctree-l1"><a class="reference internal" href="../install/install_bake.html">Install bake</a></li>
73
- <li class="toctree-l1"><a class="reference internal" href="../quickstart/quickstart.html">Quickstart</a></li>
74
- <li class="toctree-l1"><a class="reference internal" href="../concepts/concepts.html">Concepts</a></li>
75
- <li class="toctree-l1 current"><a class="reference internal" href="syntax.html">Syntax</a></li>
76
- <li class="toctree-l1"><a class="reference internal" href="../commandline/commandline.html">Commandline</a></li>
77
- <li class="toctree-l1"><a class="reference internal" href="../ide/ide_integrations.html">IDE Support</a></li>
78
- <li class="toctree-l1"><a class="reference internal" href="../tips_and_tricks/tips_and_tricks.html">Additional features</a></li>
79
- <li class="toctree-l1"><a class="reference internal" href="../performance/performance.html">Performance</a></li>
80
- <li class="toctree-l1"><a class="reference internal" href="../known_issues.html">Known Issues</a></li>
81
- <li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
82
- <li class="toctree-l1"><a class="reference internal" href="../license.html">License</a></li>
83
- </ul>
84
- <ul>
85
- <li class="toctree-l1"><a class="reference internal" href="../internal.html">Internal developing notes</a></li>
86
- </ul>
87
- </ul>
88
- </li>
89
-
90
- <li class="dropdown">
91
- <a role="button"
92
- id="dLabelLocalToc"
93
- data-toggle="dropdown"
94
- data-target="#"
95
- href="#">SubSections <b class="caret"></b></a>
96
- <ul class="dropdown-menu localtoc"
97
- role="menu"
98
- aria-labelledby="dLabelLocalToc"><ul>
99
- <li><a class="reference internal" href="#">Auto-adjustment of paths to existing projects</a></li>
100
- </ul>
101
- </ul>
102
- </li>
103
-
104
-
105
-
106
-
107
-
108
- <li>
109
- <a href="adapt_configs.html" title="Previous Chapter: Adapt configs"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm hidden-tablet">&laquo; Adapt configs</span>
110
- </a>
111
- </li>
112
- <li>
113
- <a href="../commandline/commandline.html" title="Next Chapter: Commandline"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm hidden-tablet">Commandline &raquo;</span>
114
- </a>
115
- </li>
116
-
117
-
118
-
119
-
120
-
121
- </ul>
122
-
123
-
124
-
125
- <form class="navbar-form navbar-right" action="../search.html" method="get">
126
- <div class="form-group">
127
- <input type="text" name="q" class="form-control" placeholder="Search" />
128
- </div>
129
- <input type="hidden" name="check_keywords" value="yes" />
130
- <input type="hidden" name="area" value="default" />
131
- </form>
132
-
133
- </div>
134
- </div>
135
- </div>
136
-
137
- <div class="container">
138
- <div class="row">
139
- <div class="col-md-12">
140
-
141
- <div class="section" id="auto-adjustment-of-paths-to-existing-projects">
142
- <h1>Auto-adjustment of paths to existing projects<a class="headerlink" href="#auto-adjustment-of-paths-to-existing-projects" title="Permalink to this headline">¶</a></h1>
143
- <p>If paths to other projects are needed, e.g. to &#8220;bootloaderUpdater&#8221;, don&#8217;t write a hard coded relative path like this:</p>
144
- <div class="highlight-text"><div class="highlight"><pre>CommandLine &quot;../bootloaderUpdater/tools/PrimaryBootloader2Include.exe
145
- </pre></div>
146
- </div>
147
- <p>If paths to other projects are needed, e.g. to &#8220;bootloaderUpdater&#8221; just reference it starting from the project folder.</p>
148
- <p>Example:</p>
149
- <div class="highlight-text"><div class="highlight"><pre>CommandLine &quot;bootloaderUpdater/tools/PrimaryBootloader2Include.exe
150
- </pre></div>
151
- </div>
152
- <p>or:</p>
153
- <div class="highlight-text"><div class="highlight"><pre>IncludeDir &quot;myProjectName/bootloaderUpdater/whatever&quot;
154
- </pre></div>
155
- </div>
156
- <p>bake recognizes that the first part of the path is a valid project name and calculates the relative path to the project automatically.
157
- If you have the special case that the referenced project is contained in an other workspace root, you can use the
158
- <cite>-w</cite> parameter or you define a <cite>roots.bake</cite>.</p>
159
- <div class="admonition note">
160
- <p class="first admonition-title">Note</p>
161
- <p>The path auto adjustment is applied for the following elements:</p>
162
- <ul class="last simple">
163
- <li>IncludeDir</li>
164
- <li>ExternalLibrary</li>
165
- <li>ExternalLibrarySearchPath</li>
166
- <li>UserLibrary</li>
167
- <li>CommandLine</li>
168
- </ul>
169
- </div>
170
- </div>
171
-
172
-
173
- </div>
174
-
175
- </div>
176
- </div>
177
- <footer class="footer">
178
- <div class="container">
179
- <p class="pull-right">
180
- <a href="#">Back to top</a>
181
-
182
- </p>
183
- <p>
184
- &copy; Copyright 2016, E.S.R.Labs AG.<br/>
185
- Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.1.<br/>
186
- </p>
187
- </div>
188
- </footer>
189
- </body>
1
+ <!DOCTYPE html>
2
+
3
+
4
+ <html xmlns="http://www.w3.org/1999/xhtml">
5
+ <head>
6
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7
+
8
+ <title>Auto-adjustment of paths to existing projects &mdash; bake documentation</title>
9
+
10
+ <link rel="stylesheet" href="../_static/basic.css" type="text/css" />
11
+ <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
12
+ <link rel="stylesheet" href="../_static/bootswatch-3.3.4/sandstone/bootstrap.min.css" type="text/css" />
13
+ <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
14
+
15
+ <script type="text/javascript">
16
+ var DOCUMENTATION_OPTIONS = {
17
+ URL_ROOT: '../',
18
+ VERSION: '',
19
+ COLLAPSE_INDEX: false,
20
+ FILE_SUFFIX: '.html',
21
+ HAS_SOURCE: true
22
+ };
23
+ </script>
24
+ <script type="text/javascript" src="../_static/jquery.js"></script>
25
+ <script type="text/javascript" src="../_static/underscore.js"></script>
26
+ <script type="text/javascript" src="../_static/doctools.js"></script>
27
+ <script type="text/javascript" src="../_static/js/jquery-1.11.0.min.js"></script>
28
+ <script type="text/javascript" src="../_static/js/jquery-fix.js"></script>
29
+ <script type="text/javascript" src="../_static/bootstrap-3.3.4/js/bootstrap.min.js"></script>
30
+ <script type="text/javascript" src="../_static/bootstrap-sphinx.js"></script>
31
+ <link rel="shortcut icon" href="../_static/logo_tiny_32.ico"/>
32
+ <link rel="top" title="bake documentation" href="../index.html" />
33
+ <link rel="up" title="Syntax" href="syntax.html" />
34
+ <link rel="next" title="Commandline" href="../commandline/commandline.html" />
35
+ <link rel="prev" title="Adapt configs" href="adapt_configs.html" />
36
+ <meta charset='utf-8'>
37
+ <meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
38
+ <meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
39
+ <meta name="apple-mobile-web-app-capable" content="yes">
40
+
41
+ </head>
42
+ <body role="document">
43
+
44
+ <div id="navbar" class="navbar navbar-default navbar-fixed-top">
45
+ <div class="container">
46
+ <div class="navbar-header">
47
+ <!-- .btn-navbar is used as the toggle for collapsed navbar content -->
48
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
49
+ <span class="icon-bar"></span>
50
+ <span class="icon-bar"></span>
51
+ <span class="icon-bar"></span>
52
+ </button>
53
+ <a class="navbar-brand" href="../index.html"><img src="../_static/logo_tiny_48.png">
54
+ </a>
55
+ <span class="navbar-text navbar-version pull-left"><b></b></span>
56
+ </div>
57
+
58
+ <div class="collapse navbar-collapse nav-collapse">
59
+ <ul class="nav navbar-nav">
60
+
61
+
62
+ <li class="dropdown globaltoc-container">
63
+ <a role="button"
64
+ id="dLabelGlobalToc"
65
+ data-toggle="dropdown"
66
+ data-target="#"
67
+ href="../index.html">Section <b class="caret"></b></a>
68
+ <ul class="dropdown-menu globaltoc"
69
+ role="menu"
70
+ aria-labelledby="dLabelGlobalToc"><ul class="current">
71
+ <li class="toctree-l1"><a class="reference internal" href="../why_bake/why_bake.html">Why you should use bake</a></li>
72
+ <li class="toctree-l1"><a class="reference internal" href="../install/install_bake.html">Install bake</a></li>
73
+ <li class="toctree-l1"><a class="reference internal" href="../quickstart/quickstart.html">Quickstart</a></li>
74
+ <li class="toctree-l1"><a class="reference internal" href="../concepts/concepts.html">Concepts</a></li>
75
+ <li class="toctree-l1 current"><a class="reference internal" href="syntax.html">Syntax</a></li>
76
+ <li class="toctree-l1"><a class="reference internal" href="../commandline/commandline.html">Commandline</a></li>
77
+ <li class="toctree-l1"><a class="reference internal" href="../ide/ide_integrations.html">IDE Support</a></li>
78
+ <li class="toctree-l1"><a class="reference internal" href="../tips_and_tricks/tips_and_tricks.html">Additional features</a></li>
79
+ <li class="toctree-l1"><a class="reference internal" href="../performance/performance.html">Performance</a></li>
80
+ <li class="toctree-l1"><a class="reference internal" href="../known_issues.html">Known Issues</a></li>
81
+ <li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
82
+ <li class="toctree-l1"><a class="reference internal" href="../license.html">License</a></li>
83
+ </ul>
84
+ <ul>
85
+ <li class="toctree-l1"><a class="reference internal" href="../internal.html">Internal developing notes</a></li>
86
+ </ul>
87
+ </ul>
88
+ </li>
89
+
90
+ <li class="dropdown">
91
+ <a role="button"
92
+ id="dLabelLocalToc"
93
+ data-toggle="dropdown"
94
+ data-target="#"
95
+ href="#">SubSections <b class="caret"></b></a>
96
+ <ul class="dropdown-menu localtoc"
97
+ role="menu"
98
+ aria-labelledby="dLabelLocalToc"><ul>
99
+ <li><a class="reference internal" href="#">Auto-adjustment of paths to existing projects</a></li>
100
+ </ul>
101
+ </ul>
102
+ </li>
103
+
104
+
105
+
106
+
107
+
108
+ <li>
109
+ <a href="adapt_configs.html" title="Previous Chapter: Adapt configs"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm hidden-tablet">&laquo; Adapt configs</span>
110
+ </a>
111
+ </li>
112
+ <li>
113
+ <a href="../commandline/commandline.html" title="Next Chapter: Commandline"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm hidden-tablet">Commandline &raquo;</span>
114
+ </a>
115
+ </li>
116
+
117
+
118
+
119
+
120
+
121
+ </ul>
122
+
123
+
124
+
125
+ <form class="navbar-form navbar-right" action="../search.html" method="get">
126
+ <div class="form-group">
127
+ <input type="text" name="q" class="form-control" placeholder="Search" />
128
+ </div>
129
+ <input type="hidden" name="check_keywords" value="yes" />
130
+ <input type="hidden" name="area" value="default" />
131
+ </form>
132
+
133
+ </div>
134
+ </div>
135
+ </div>
136
+
137
+ <div class="container">
138
+ <div class="row">
139
+ <div class="col-md-12">
140
+
141
+ <div class="section" id="auto-adjustment-of-paths-to-existing-projects">
142
+ <h1>Auto-adjustment of paths to existing projects<a class="headerlink" href="#auto-adjustment-of-paths-to-existing-projects" title="Permalink to this headline">¶</a></h1>
143
+ <p>If paths to other projects are needed, e.g. to &#8220;bootloaderUpdater&#8221;, don&#8217;t write a hard coded relative path like this:</p>
144
+ <div class="highlight-text"><div class="highlight"><pre>CommandLine &quot;../bootloaderUpdater/tools/PrimaryBootloader2Include.exe
145
+ </pre></div>
146
+ </div>
147
+ <p>If paths to other projects are needed, e.g. to &#8220;bootloaderUpdater&#8221; just reference it starting from the project folder.</p>
148
+ <p>Example:</p>
149
+ <div class="highlight-text"><div class="highlight"><pre>CommandLine &quot;bootloaderUpdater/tools/PrimaryBootloader2Include.exe
150
+ </pre></div>
151
+ </div>
152
+ <p>or:</p>
153
+ <div class="highlight-text"><div class="highlight"><pre>IncludeDir &quot;myProjectName/bootloaderUpdater/whatever&quot;
154
+ </pre></div>
155
+ </div>
156
+ <p>bake recognizes that the first part of the path is a valid project name and calculates the relative path to the project automatically.
157
+ If you have the special case that the referenced project is contained in an other workspace root, you can use the
158
+ <cite>-w</cite> parameter or you define a <cite>roots.bake</cite>.</p>
159
+ <div class="admonition note">
160
+ <p class="first admonition-title">Note</p>
161
+ <p>The path auto adjustment is applied for the following elements:</p>
162
+ <ul class="last simple">
163
+ <li>IncludeDir</li>
164
+ <li>ExternalLibrary</li>
165
+ <li>ExternalLibrarySearchPath</li>
166
+ <li>UserLibrary</li>
167
+ <li>CommandLine</li>
168
+ </ul>
169
+ </div>
170
+ </div>
171
+
172
+
173
+ </div>
174
+
175
+ </div>
176
+ </div>
177
+ <footer class="footer">
178
+ <div class="container">
179
+ <p class="pull-right">
180
+ <a href="#">Back to top</a>
181
+
182
+ </p>
183
+ <p>
184
+ &copy; Copyright 2016, E.S.R.Labs AG.<br/>
185
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.1.<br/>
186
+ </p>
187
+ </div>
188
+ </footer>
189
+ </body>
190
190
  </html>
@@ -1,248 +1,248 @@
1
- <!DOCTYPE html>
2
-
3
-
4
- <html xmlns="http://www.w3.org/1999/xhtml">
5
- <head>
6
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7
-
8
- <title>Derive configs &mdash; bake documentation</title>
9
-
10
- <link rel="stylesheet" href="../_static/basic.css" type="text/css" />
11
- <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
12
- <link rel="stylesheet" href="../_static/bootswatch-3.3.4/sandstone/bootstrap.min.css" type="text/css" />
13
- <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
14
-
15
- <script type="text/javascript">
16
- var DOCUMENTATION_OPTIONS = {
17
- URL_ROOT: '../',
18
- VERSION: '',
19
- COLLAPSE_INDEX: false,
20
- FILE_SUFFIX: '.html',
21
- HAS_SOURCE: true
22
- };
23
- </script>
24
- <script type="text/javascript" src="../_static/jquery.js"></script>
25
- <script type="text/javascript" src="../_static/underscore.js"></script>
26
- <script type="text/javascript" src="../_static/doctools.js"></script>
27
- <script type="text/javascript" src="../_static/js/jquery-1.11.0.min.js"></script>
28
- <script type="text/javascript" src="../_static/js/jquery-fix.js"></script>
29
- <script type="text/javascript" src="../_static/bootstrap-3.3.4/js/bootstrap.min.js"></script>
30
- <script type="text/javascript" src="../_static/bootstrap-sphinx.js"></script>
31
- <link rel="shortcut icon" href="../_static/logo_tiny_32.ico"/>
32
- <link rel="top" title="bake documentation" href="../index.html" />
33
- <link rel="up" title="Syntax" href="syntax.html" />
34
- <link rel="next" title="Adapt configs" href="adapt_configs.html" />
35
- <link rel="prev" title="Variables in Project.meta" href="variable_substitutions.html" />
36
- <meta charset='utf-8'>
37
- <meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
38
- <meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
39
- <meta name="apple-mobile-web-app-capable" content="yes">
40
-
41
- </head>
42
- <body role="document">
43
-
44
- <div id="navbar" class="navbar navbar-default navbar-fixed-top">
45
- <div class="container">
46
- <div class="navbar-header">
47
- <!-- .btn-navbar is used as the toggle for collapsed navbar content -->
48
- <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
49
- <span class="icon-bar"></span>
50
- <span class="icon-bar"></span>
51
- <span class="icon-bar"></span>
52
- </button>
53
- <a class="navbar-brand" href="../index.html"><img src="../_static/logo_conformant_48.png">
54
- </a>
55
- <span class="navbar-text navbar-version pull-left"><b></b></span>
56
- </div>
57
-
58
- <div class="collapse navbar-collapse nav-collapse">
59
- <ul class="nav navbar-nav">
60
-
61
-
62
- <li class="dropdown globaltoc-container">
63
- <a role="button"
64
- id="dLabelGlobalToc"
65
- data-toggle="dropdown"
66
- data-target="#"
67
- href="../index.html">Section <b class="caret"></b></a>
68
- <ul class="dropdown-menu globaltoc"
69
- role="menu"
70
- aria-labelledby="dLabelGlobalToc"><ul class="current">
71
- <li class="toctree-l1"><a class="reference internal" href="../why_bake/why_bake.html">Why you should use bake</a></li>
72
- <li class="toctree-l1"><a class="reference internal" href="../install/install_bake.html">Install bake</a></li>
73
- <li class="toctree-l1"><a class="reference internal" href="../quickstart/quickstart.html">Quickstart</a></li>
74
- <li class="toctree-l1"><a class="reference internal" href="../concepts/concepts.html">Concepts</a></li>
75
- <li class="toctree-l1 current"><a class="reference internal" href="syntax.html">Syntax</a></li>
76
- <li class="toctree-l1"><a class="reference internal" href="../commandline/commandline.html">Commandline</a></li>
77
- <li class="toctree-l1"><a class="reference internal" href="../ide/ide_integrations.html">IDE Support</a></li>
78
- <li class="toctree-l1"><a class="reference internal" href="../tips_and_tricks/tips_and_tricks.html">Additional features</a></li>
79
- <li class="toctree-l1"><a class="reference internal" href="../performance/performance.html">Performance</a></li>
80
- <li class="toctree-l1"><a class="reference internal" href="../known_issues.html">Known Issues</a></li>
81
- <li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
82
- <li class="toctree-l1"><a class="reference internal" href="../license.html">License</a></li>
83
- </ul>
84
- <ul>
85
- <li class="toctree-l1"><a class="reference internal" href="../internal.html">Internal developing notes</a></li>
86
- </ul>
87
- </ul>
88
- </li>
89
-
90
- <li class="dropdown">
91
- <a role="button"
92
- id="dLabelLocalToc"
93
- data-toggle="dropdown"
94
- data-target="#"
95
- href="#">SubSections <b class="caret"></b></a>
96
- <ul class="dropdown-menu localtoc"
97
- role="menu"
98
- aria-labelledby="dLabelLocalToc"><ul>
99
- <li><a class="reference internal" href="#">Derive configs</a><ul>
100
- <li><a class="reference internal" href="#deriving-a-config">Deriving a config</a></li>
101
- <li><a class="reference internal" href="#inheritance-implications">Inheritance implications</a></li>
102
- <li><a class="reference internal" href="#multiple-inheritance">Multiple inheritance</a></li>
103
- </ul>
104
- </li>
105
- </ul>
106
- </ul>
107
- </li>
108
-
109
-
110
-
111
-
112
-
113
- <li>
114
- <a href="variable_substitutions.html" title="Previous Chapter: Variables in Project.meta"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm hidden-tablet">&laquo; Variables in ...</span>
115
- </a>
116
- </li>
117
- <li>
118
- <a href="adapt_configs.html" title="Next Chapter: Adapt configs"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm hidden-tablet">Adapt configs &raquo;</span>
119
- </a>
120
- </li>
121
-
122
-
123
-
124
-
125
-
126
- </ul>
127
-
128
-
129
-
130
- <form class="navbar-form navbar-right" action="../search.html" method="get">
131
- <div class="form-group">
132
- <input type="text" name="q" class="form-control" placeholder="Search" />
133
- </div>
134
- <input type="hidden" name="check_keywords" value="yes" />
135
- <input type="hidden" name="area" value="default" />
136
- </form>
137
-
138
- </div>
139
- </div>
140
- </div>
141
-
142
- <div class="container">
143
- <div class="row">
144
- <div class="col-md-12">
145
-
146
- <div class="section" id="derive-configs">
147
- <h1>Derive configs<a class="headerlink" href="#derive-configs" title="Permalink to this headline">¶</a></h1>
148
- <p>bake supports deriving configs, which allows you to put repetetive settings in a base config.</p>
149
- <div class="section" id="deriving-a-config">
150
- <h2>Deriving a config<a class="headerlink" href="#deriving-a-config" title="Permalink to this headline">¶</a></h2>
151
- <p>Derving a config in bake is pretty straight forward, and looks like this:</p>
152
- <div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A
153
- LibraryConfig B, extends: A
154
- CustomConfig C, extends: B
155
- ExecutableConfig D, extends: C
156
- </pre></div>
157
- </div>
158
- <div class="admonition note">
159
- <p class="first admonition-title">Note</p>
160
- <p class="last">The config type of the parent config does not matter, but only settings which are valid in BOTH configs will be inherited.
161
- In the example above D gets the dependencies from A, because &#8220;Dependency&#8221; is valid in all configs, but D does not get
162
- the &#8220;Files&#8221; from A and B, because &#8220;Files&#8221; is not valid in CustomConfig.</p>
163
- </div>
164
- </div>
165
- <div class="section" id="inheritance-implications">
166
- <h2>Inheritance implications<a class="headerlink" href="#inheritance-implications" title="Permalink to this headline">¶</a></h2>
167
- <p>In general it is very easy.</p>
168
- <ul class="simple">
169
- <li>Elements which can exist more than once (e.g. &#8220;Files&#8221;), are simply concatenated. First the parent elements, then the client elements.</li>
170
- <li>Elements which can exist only once:<ul>
171
- <li>if it exists in EITHER child OR parent, use this one</li>
172
- <li>is it exists in BOTH, attributes are merged (child attributes have high priority) and sub elements are inherited recursively</li>
173
- </ul>
174
- </li>
175
- </ul>
176
- <p>The following example</p>
177
- <div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A {
178
- Files &quot;x.cpp&quot;
179
- Files &quot;y.cpp&quot;
180
- ArtifactName &quot;z.exe&quot;
181
- DefaultToolchain GCC {
182
- Linker {
183
- Flags &quot;-O3&quot;
184
- }
185
- }
186
- }
187
- ExecutableConfig B, extends: A {
188
- Files &quot;z.cpp&quot;
189
- IncludeDir &quot;inc&quot;
190
- ArtifactName &quot;a.exe&quot;
191
- DefaultToolchain Diab {
192
- Compiler CPP {
193
- Define &quot;TEST&quot;
194
- }
195
- }
196
- }
197
- </pre></div>
198
- </div>
199
- <p>results implicitly in:</p>
200
- <div class="highlight-text"><div class="highlight"><pre>ExecutableConfig B {
201
- Files &quot;x.cpp&quot;
202
- Files &quot;y.cpp&quot;
203
- Files &quot;z.cpp&quot;
204
- IncludeDir &quot;inc&quot;
205
- ArtifactName &quot;a.exe&quot;
206
- DefaultToolchain Diab {
207
- Compiler CPP {
208
- Define &quot;TEST&quot;
209
- }
210
- Linker {
211
- Flags &quot;-O3&quot;
212
- }
213
- }
214
- }
215
- </pre></div>
216
- </div>
217
- </div>
218
- <div class="section" id="multiple-inheritance">
219
- <h2>Multiple inheritance<a class="headerlink" href="#multiple-inheritance" title="Permalink to this headline">¶</a></h2>
220
- <p>It is possible to derive from several projects:</p>
221
- <div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A
222
- LibraryConfig B
223
- ExecutableConfig C, extends: &quot;A, B&quot;
224
- </pre></div>
225
- </div>
226
- <p>&#8220;extends&#8221; defines a comma separated list. The merge will be performed with all parent configs.</p>
227
- </div>
228
- </div>
229
-
230
-
231
- </div>
232
-
233
- </div>
234
- </div>
235
- <footer class="footer">
236
- <div class="container">
237
- <p class="pull-right">
238
- <a href="#">Back to top</a>
239
-
240
- </p>
241
- <p>
242
- &copy; Copyright 2016, E.S.R.Labs AG.<br/>
243
- Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.1.<br/>
244
- </p>
245
- </div>
246
- </footer>
247
- </body>
1
+ <!DOCTYPE html>
2
+
3
+
4
+ <html xmlns="http://www.w3.org/1999/xhtml">
5
+ <head>
6
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7
+
8
+ <title>Derive configs &mdash; bake documentation</title>
9
+
10
+ <link rel="stylesheet" href="../_static/basic.css" type="text/css" />
11
+ <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
12
+ <link rel="stylesheet" href="../_static/bootswatch-3.3.4/sandstone/bootstrap.min.css" type="text/css" />
13
+ <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
14
+
15
+ <script type="text/javascript">
16
+ var DOCUMENTATION_OPTIONS = {
17
+ URL_ROOT: '../',
18
+ VERSION: '',
19
+ COLLAPSE_INDEX: false,
20
+ FILE_SUFFIX: '.html',
21
+ HAS_SOURCE: true
22
+ };
23
+ </script>
24
+ <script type="text/javascript" src="../_static/jquery.js"></script>
25
+ <script type="text/javascript" src="../_static/underscore.js"></script>
26
+ <script type="text/javascript" src="../_static/doctools.js"></script>
27
+ <script type="text/javascript" src="../_static/js/jquery-1.11.0.min.js"></script>
28
+ <script type="text/javascript" src="../_static/js/jquery-fix.js"></script>
29
+ <script type="text/javascript" src="../_static/bootstrap-3.3.4/js/bootstrap.min.js"></script>
30
+ <script type="text/javascript" src="../_static/bootstrap-sphinx.js"></script>
31
+ <link rel="shortcut icon" href="../_static/logo_tiny_32.ico"/>
32
+ <link rel="top" title="bake documentation" href="../index.html" />
33
+ <link rel="up" title="Syntax" href="syntax.html" />
34
+ <link rel="next" title="Adapt configs" href="adapt_configs.html" />
35
+ <link rel="prev" title="Variables in Project.meta" href="variable_substitutions.html" />
36
+ <meta charset='utf-8'>
37
+ <meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
38
+ <meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
39
+ <meta name="apple-mobile-web-app-capable" content="yes">
40
+
41
+ </head>
42
+ <body role="document">
43
+
44
+ <div id="navbar" class="navbar navbar-default navbar-fixed-top">
45
+ <div class="container">
46
+ <div class="navbar-header">
47
+ <!-- .btn-navbar is used as the toggle for collapsed navbar content -->
48
+ <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
49
+ <span class="icon-bar"></span>
50
+ <span class="icon-bar"></span>
51
+ <span class="icon-bar"></span>
52
+ </button>
53
+ <a class="navbar-brand" href="../index.html"><img src="../_static/logo_tiny_48.png">
54
+ </a>
55
+ <span class="navbar-text navbar-version pull-left"><b></b></span>
56
+ </div>
57
+
58
+ <div class="collapse navbar-collapse nav-collapse">
59
+ <ul class="nav navbar-nav">
60
+
61
+
62
+ <li class="dropdown globaltoc-container">
63
+ <a role="button"
64
+ id="dLabelGlobalToc"
65
+ data-toggle="dropdown"
66
+ data-target="#"
67
+ href="../index.html">Section <b class="caret"></b></a>
68
+ <ul class="dropdown-menu globaltoc"
69
+ role="menu"
70
+ aria-labelledby="dLabelGlobalToc"><ul class="current">
71
+ <li class="toctree-l1"><a class="reference internal" href="../why_bake/why_bake.html">Why you should use bake</a></li>
72
+ <li class="toctree-l1"><a class="reference internal" href="../install/install_bake.html">Install bake</a></li>
73
+ <li class="toctree-l1"><a class="reference internal" href="../quickstart/quickstart.html">Quickstart</a></li>
74
+ <li class="toctree-l1"><a class="reference internal" href="../concepts/concepts.html">Concepts</a></li>
75
+ <li class="toctree-l1 current"><a class="reference internal" href="syntax.html">Syntax</a></li>
76
+ <li class="toctree-l1"><a class="reference internal" href="../commandline/commandline.html">Commandline</a></li>
77
+ <li class="toctree-l1"><a class="reference internal" href="../ide/ide_integrations.html">IDE Support</a></li>
78
+ <li class="toctree-l1"><a class="reference internal" href="../tips_and_tricks/tips_and_tricks.html">Additional features</a></li>
79
+ <li class="toctree-l1"><a class="reference internal" href="../performance/performance.html">Performance</a></li>
80
+ <li class="toctree-l1"><a class="reference internal" href="../known_issues.html">Known Issues</a></li>
81
+ <li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
82
+ <li class="toctree-l1"><a class="reference internal" href="../license.html">License</a></li>
83
+ </ul>
84
+ <ul>
85
+ <li class="toctree-l1"><a class="reference internal" href="../internal.html">Internal developing notes</a></li>
86
+ </ul>
87
+ </ul>
88
+ </li>
89
+
90
+ <li class="dropdown">
91
+ <a role="button"
92
+ id="dLabelLocalToc"
93
+ data-toggle="dropdown"
94
+ data-target="#"
95
+ href="#">SubSections <b class="caret"></b></a>
96
+ <ul class="dropdown-menu localtoc"
97
+ role="menu"
98
+ aria-labelledby="dLabelLocalToc"><ul>
99
+ <li><a class="reference internal" href="#">Derive configs</a><ul>
100
+ <li><a class="reference internal" href="#deriving-a-config">Deriving a config</a></li>
101
+ <li><a class="reference internal" href="#inheritance-implications">Inheritance implications</a></li>
102
+ <li><a class="reference internal" href="#multiple-inheritance">Multiple inheritance</a></li>
103
+ </ul>
104
+ </li>
105
+ </ul>
106
+ </ul>
107
+ </li>
108
+
109
+
110
+
111
+
112
+
113
+ <li>
114
+ <a href="variable_substitutions.html" title="Previous Chapter: Variables in Project.meta"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm hidden-tablet">&laquo; Variables in ...</span>
115
+ </a>
116
+ </li>
117
+ <li>
118
+ <a href="adapt_configs.html" title="Next Chapter: Adapt configs"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm hidden-tablet">Adapt configs &raquo;</span>
119
+ </a>
120
+ </li>
121
+
122
+
123
+
124
+
125
+
126
+ </ul>
127
+
128
+
129
+
130
+ <form class="navbar-form navbar-right" action="../search.html" method="get">
131
+ <div class="form-group">
132
+ <input type="text" name="q" class="form-control" placeholder="Search" />
133
+ </div>
134
+ <input type="hidden" name="check_keywords" value="yes" />
135
+ <input type="hidden" name="area" value="default" />
136
+ </form>
137
+
138
+ </div>
139
+ </div>
140
+ </div>
141
+
142
+ <div class="container">
143
+ <div class="row">
144
+ <div class="col-md-12">
145
+
146
+ <div class="section" id="derive-configs">
147
+ <h1>Derive configs<a class="headerlink" href="#derive-configs" title="Permalink to this headline">¶</a></h1>
148
+ <p>bake supports deriving configs, which allows you to put repetetive settings in a base config.</p>
149
+ <div class="section" id="deriving-a-config">
150
+ <h2>Deriving a config<a class="headerlink" href="#deriving-a-config" title="Permalink to this headline">¶</a></h2>
151
+ <p>Derving a config in bake is pretty straight forward, and looks like this:</p>
152
+ <div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A
153
+ LibraryConfig B, extends: A
154
+ CustomConfig C, extends: B
155
+ ExecutableConfig D, extends: C
156
+ </pre></div>
157
+ </div>
158
+ <div class="admonition note">
159
+ <p class="first admonition-title">Note</p>
160
+ <p class="last">The config type of the parent config does not matter, but only settings which are valid in BOTH configs will be inherited.
161
+ In the example above D gets the dependencies from A, because &#8220;Dependency&#8221; is valid in all configs, but D does not get
162
+ the &#8220;Files&#8221; from A and B, because &#8220;Files&#8221; is not valid in CustomConfig.</p>
163
+ </div>
164
+ </div>
165
+ <div class="section" id="inheritance-implications">
166
+ <h2>Inheritance implications<a class="headerlink" href="#inheritance-implications" title="Permalink to this headline">¶</a></h2>
167
+ <p>In general it is very easy.</p>
168
+ <ul class="simple">
169
+ <li>Elements which can exist more than once (e.g. &#8220;Files&#8221;), are simply concatenated. First the parent elements, then the client elements.</li>
170
+ <li>Elements which can exist only once:<ul>
171
+ <li>if it exists in EITHER child OR parent, use this one</li>
172
+ <li>is it exists in BOTH, attributes are merged (child attributes have high priority) and sub elements are inherited recursively</li>
173
+ </ul>
174
+ </li>
175
+ </ul>
176
+ <p>The following example</p>
177
+ <div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A {
178
+ Files &quot;x.cpp&quot;
179
+ Files &quot;y.cpp&quot;
180
+ ArtifactName &quot;z.exe&quot;
181
+ DefaultToolchain GCC {
182
+ Linker {
183
+ Flags &quot;-O3&quot;
184
+ }
185
+ }
186
+ }
187
+ ExecutableConfig B, extends: A {
188
+ Files &quot;z.cpp&quot;
189
+ IncludeDir &quot;inc&quot;
190
+ ArtifactName &quot;a.exe&quot;
191
+ DefaultToolchain Diab {
192
+ Compiler CPP {
193
+ Define &quot;TEST&quot;
194
+ }
195
+ }
196
+ }
197
+ </pre></div>
198
+ </div>
199
+ <p>results implicitly in:</p>
200
+ <div class="highlight-text"><div class="highlight"><pre>ExecutableConfig B {
201
+ Files &quot;x.cpp&quot;
202
+ Files &quot;y.cpp&quot;
203
+ Files &quot;z.cpp&quot;
204
+ IncludeDir &quot;inc&quot;
205
+ ArtifactName &quot;a.exe&quot;
206
+ DefaultToolchain Diab {
207
+ Compiler CPP {
208
+ Define &quot;TEST&quot;
209
+ }
210
+ Linker {
211
+ Flags &quot;-O3&quot;
212
+ }
213
+ }
214
+ }
215
+ </pre></div>
216
+ </div>
217
+ </div>
218
+ <div class="section" id="multiple-inheritance">
219
+ <h2>Multiple inheritance<a class="headerlink" href="#multiple-inheritance" title="Permalink to this headline">¶</a></h2>
220
+ <p>It is possible to derive from several projects:</p>
221
+ <div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A
222
+ LibraryConfig B
223
+ ExecutableConfig C, extends: &quot;A, B&quot;
224
+ </pre></div>
225
+ </div>
226
+ <p>&#8220;extends&#8221; defines a comma separated list. The merge will be performed with all parent configs.</p>
227
+ </div>
228
+ </div>
229
+
230
+
231
+ </div>
232
+
233
+ </div>
234
+ </div>
235
+ <footer class="footer">
236
+ <div class="container">
237
+ <p class="pull-right">
238
+ <a href="#">Back to top</a>
239
+
240
+ </p>
241
+ <p>
242
+ &copy; Copyright 2016, E.S.R.Labs AG.<br/>
243
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.1.<br/>
244
+ </p>
245
+ </div>
246
+ </footer>
247
+ </body>
248
248
  </html>