RubyGems - bake-toolkit - Versions diffs - 2.18.0 → 2.19.0 - Mend

bake-toolkit 2.18.0 → 2.19.0

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 (147) hide show

data/documentation/_build/html/syntax/derive_configs.html CHANGED

@@ -1,248 +1,248 @@
-<!DOCTYPE html>
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>Derive configs &mdash; bake 2.18.0 documentation</title>
-    <link rel="stylesheet" href="../_static/basic.css" type="text/css" />
-    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
-    <link rel="stylesheet" href="../_static/bootswatch-3.3.4/sandstone/bootstrap.min.css" type="text/css" />
-    <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
-    <script type="text/javascript">
-      var DOCUMENTATION_OPTIONS = {
-        URL_ROOT:    '../',
-        VERSION:     '2.18.0',
-        COLLAPSE_INDEX: false,
-        FILE_SUFFIX: '.html',
-        HAS_SOURCE:  true
-      };
-    </script>
-    <script type="text/javascript" src="../_static/jquery.js"></script>
-    <script type="text/javascript" src="../_static/underscore.js"></script>
-    <script type="text/javascript" src="../_static/doctools.js"></script>
-    <script type="text/javascript" src="../_static/js/jquery-1.11.0.min.js"></script>
-    <script type="text/javascript" src="../_static/js/jquery-fix.js"></script>
-    <script type="text/javascript" src="../_static/bootstrap-3.3.4/js/bootstrap.min.js"></script>
-    <script type="text/javascript" src="../_static/bootstrap-sphinx.js"></script>
-    <link rel="shortcut icon" href="../_static/logo_tiny_32.ico"/>
-    <link rel="top" title="bake 2.18.0 documentation" href="../index.html" />
-    <link rel="up" title="Syntax" href="syntax.html" />
-    <link rel="next" title="Adapt configs" href="adapt_configs.html" />
-    <link rel="prev" title="Variables in Project.meta" href="variable_substitutions.html" />
-<meta charset='utf-8'>
-<meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
-<meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
-<meta name="apple-mobile-web-app-capable" content="yes">
-  </head>
-  <body role="document">
-  <div id="navbar" class="navbar navbar-default navbar-fixed-top">
-    <div class="container">
-      <div class="navbar-header">
-        <!-- .btn-navbar is used as the toggle for collapsed navbar content -->
-        <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
-          <span class="icon-bar"></span>
-          <span class="icon-bar"></span>
-          <span class="icon-bar"></span>
-        </button>
-        <a class="navbar-brand" href="../index.html"><img src="../_static/logo_conformant_48.png">
-           </a>
-        <span class="navbar-text navbar-version pull-left"><b></b></span>
-      </div>
-        <div class="collapse navbar-collapse nav-collapse">
-          <ul class="nav navbar-nav">
-              <li class="dropdown globaltoc-container">
-  <a role="button"
-     id="dLabelGlobalToc"
-     data-toggle="dropdown"
-     data-target="#"
-     href="../index.html">Section <b class="caret"></b></a>
-  <ul class="dropdown-menu globaltoc"
-      role="menu"
-      aria-labelledby="dLabelGlobalToc"><ul class="current">
-<li class="toctree-l1"><a class="reference internal" href="../why_bake/why_bake.html">Why you should use bake</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../install/install_bake.html">Install bake</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../quickstart/quickstart.html">Quickstart</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../concepts/concepts.html">Concepts</a></li>
-<li class="toctree-l1 current"><a class="reference internal" href="syntax.html">Syntax</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../commandline/commandline.html">Commandline</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../ide/ide_integrations.html">IDE Support</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../tips_and_tricks/tips_and_tricks.html">Tips and Tricks</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../performance/performance.html">Performance</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../known_issues.html">Known Issues</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
-<li class="toctree-l1"><a class="reference internal" href="../license.html">License</a></li>
-</ul>
-<ul>
-<li class="toctree-l1"><a class="reference internal" href="../internal.html">Internal developing notes</a></li>
-</ul>
-</ul>
-</li>
-                <li class="dropdown">
-  <a role="button"
-     id="dLabelLocalToc"
-     data-toggle="dropdown"
-     data-target="#"
-     href="#">SubSections <b class="caret"></b></a>
-  <ul class="dropdown-menu localtoc"
-      role="menu"
-      aria-labelledby="dLabelLocalToc"><ul>
-<li><a class="reference internal" href="#">Derive configs</a><ul>
-<li><a class="reference internal" href="#deriving-a-config">Deriving a config</a></li>
-<li><a class="reference internal" href="#inheritance-implications">Inheritance implications</a></li>
-<li><a class="reference internal" href="#multiple-inheritance">Multiple inheritance</a></li>
-</ul>
-</li>
-</ul>
-</ul>
-</li>
-  <li>
-    <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>
-    </a>
-  </li>
-  <li>
-    <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>
-    </a>
-  </li>
-          </ul>
-<form class="navbar-form navbar-right" action="../search.html" method="get">
- <div class="form-group">
-  <input type="text" name="q" class="form-control" placeholder="Search" />
- </div>
-  <input type="hidden" name="check_keywords" value="yes" />
-  <input type="hidden" name="area" value="default" />
-</form>
-        </div>
-    </div>
-  </div>
-<div class="container">
-  <div class="row">
-    <div class="col-md-12">
-  <div class="section" id="derive-configs">
-<h1>Derive configs<a class="headerlink" href="#derive-configs" title="Permalink to this headline">¶</a></h1>
-<p>bake supports deriving configs, which allows you to put repetetive settings in a base config.</p>
-<div class="section" id="deriving-a-config">
-<h2>Deriving a config<a class="headerlink" href="#deriving-a-config" title="Permalink to this headline">¶</a></h2>
-<p>Derving a config in bake is pretty straight forward, and looks like this:</p>
-<div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A
-LibraryConfig    B, extends: A
-CustomConfig     C, extends: B
-ExecutableConfig D, extends: C
-</pre></div>
-</div>
-<div class="admonition note">
-<p class="first admonition-title">Note</p>
-<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.
-In the example above D gets the dependencies from A, because &#8220;Dependency&#8221; is valid in all configs, but D does not get
-the &#8220;Files&#8221; from A and B, because &#8220;Files&#8221; is not valid in CustomConfig.</p>
-</div>
-</div>
-<div class="section" id="inheritance-implications">
-<h2>Inheritance implications<a class="headerlink" href="#inheritance-implications" title="Permalink to this headline">¶</a></h2>
-<p>In general it is very easy.</p>
-<ul class="simple">
-<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>
-<li>Elements which can exist only once:<ul>
-<li>if it exists in EITHER child OR parent, use this one</li>
-<li>is it exists in BOTH, attributes are merged (child attributes have high priority) and sub elements are inherited recursively</li>
-</ul>
-</li>
-</ul>
-<p>The following example</p>
-<div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A {
-  Files &quot;x.cpp&quot;
-  Files &quot;y.cpp&quot;
-  ArtifactName &quot;z.exe&quot;
-  DefaultToolchain GCC {
-    Linker {
-      Flags &quot;-O3&quot;
-    }
-  }
-}
-ExecutableConfig B, extends: A {
-  Files &quot;z.cpp&quot;
-  IncludeDir &quot;inc&quot;
-  ArtifactName &quot;a.exe&quot;
-  DefaultToolchain Diab {
-    Compiler CPP {
-      Define &quot;TEST&quot;
-    }
-  }
-}
-</pre></div>
-</div>
-<p>results implicitly in:</p>
-<div class="highlight-text"><div class="highlight"><pre>ExecutableConfig B {
-  Files &quot;x.cpp&quot;
-  Files &quot;y.cpp&quot;
-  Files &quot;z.cpp&quot;
-  IncludeDir &quot;inc&quot;
-  ArtifactName &quot;a.exe&quot;
-  DefaultToolchain Diab {
-    Compiler CPP {
-      Define &quot;TEST&quot;
-    }
-    Linker {
-      Flags &quot;-O3&quot;
-    }
-  }
-}
-</pre></div>
-</div>
-</div>
-<div class="section" id="multiple-inheritance">
-<h2>Multiple inheritance<a class="headerlink" href="#multiple-inheritance" title="Permalink to this headline">¶</a></h2>
-<p>It is possible to derive from several projects:</p>
-<div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A
-LibraryConfig    B
-ExecutableConfig C, extends: &quot;A, B&quot;
-</pre></div>
-</div>
-<p>&#8220;extends&#8221; defines a comma separated list. The merge will be performed with all parent configs.</p>
-</div>
-</div>
-    </div>
-  </div>
-</div>
-<footer class="footer">
-  <div class="container">
-    <p class="pull-right">
-      <a href="#">Back to top</a>
-    </p>
-    <p>
-        &copy; Copyright 2016, E.S.R.Labs AG.<br/>
-      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.1.<br/>
-    </p>
-  </div>
-</footer>
-  </body>
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>Derive configs &mdash; bake 2.19.0 documentation</title>
+    <link rel="stylesheet" href="../_static/basic.css" type="text/css" />
+    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
+    <link rel="stylesheet" href="../_static/bootswatch-3.3.4/sandstone/bootstrap.min.css" type="text/css" />
+    <link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
+    <script type="text/javascript">
+      var DOCUMENTATION_OPTIONS = {
+        URL_ROOT:    '../',
+        VERSION:     '2.19.0',
+        COLLAPSE_INDEX: false,
+        FILE_SUFFIX: '.html',
+        HAS_SOURCE:  true
+      };
+    </script>
+    <script type="text/javascript" src="../_static/jquery.js"></script>
+    <script type="text/javascript" src="../_static/underscore.js"></script>
+    <script type="text/javascript" src="../_static/doctools.js"></script>
+    <script type="text/javascript" src="../_static/js/jquery-1.11.0.min.js"></script>
+    <script type="text/javascript" src="../_static/js/jquery-fix.js"></script>
+    <script type="text/javascript" src="../_static/bootstrap-3.3.4/js/bootstrap.min.js"></script>
+    <script type="text/javascript" src="../_static/bootstrap-sphinx.js"></script>
+    <link rel="shortcut icon" href="../_static/logo_tiny_32.ico"/>
+    <link rel="top" title="bake 2.19.0 documentation" href="../index.html" />
+    <link rel="up" title="Syntax" href="syntax.html" />
+    <link rel="next" title="Adapt configs" href="adapt_configs.html" />
+    <link rel="prev" title="Variables in Project.meta" href="variable_substitutions.html" />
+<meta charset='utf-8'>
+<meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
+<meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
+<meta name="apple-mobile-web-app-capable" content="yes">
+  </head>
+  <body role="document">
+  <div id="navbar" class="navbar navbar-default navbar-fixed-top">
+    <div class="container">
+      <div class="navbar-header">
+        <!-- .btn-navbar is used as the toggle for collapsed navbar content -->
+        <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+          <span class="icon-bar"></span>
+        </button>
+        <a class="navbar-brand" href="../index.html"><img src="../_static/logo_conformant_48.png">
+           </a>
+        <span class="navbar-text navbar-version pull-left"><b></b></span>
+      </div>
+        <div class="collapse navbar-collapse nav-collapse">
+          <ul class="nav navbar-nav">
+              <li class="dropdown globaltoc-container">
+  <a role="button"
+     id="dLabelGlobalToc"
+     data-toggle="dropdown"
+     data-target="#"
+     href="../index.html">Section <b class="caret"></b></a>
+  <ul class="dropdown-menu globaltoc"
+      role="menu"
+      aria-labelledby="dLabelGlobalToc"><ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../why_bake/why_bake.html">Why you should use bake</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../install/install_bake.html">Install bake</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../quickstart/quickstart.html">Quickstart</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../concepts/concepts.html">Concepts</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="syntax.html">Syntax</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../commandline/commandline.html">Commandline</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../ide/ide_integrations.html">IDE Support</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../tips_and_tricks/tips_and_tricks.html">Tips and Tricks</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../performance/performance.html">Performance</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../known_issues.html">Known Issues</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../changelog.html">Changelog</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../license.html">License</a></li>
+</ul>
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="../internal.html">Internal developing notes</a></li>
+</ul>
+</ul>
+</li>
+                <li class="dropdown">
+  <a role="button"
+     id="dLabelLocalToc"
+     data-toggle="dropdown"
+     data-target="#"
+     href="#">SubSections <b class="caret"></b></a>
+  <ul class="dropdown-menu localtoc"
+      role="menu"
+      aria-labelledby="dLabelLocalToc"><ul>
+<li><a class="reference internal" href="#">Derive configs</a><ul>
+<li><a class="reference internal" href="#deriving-a-config">Deriving a config</a></li>
+<li><a class="reference internal" href="#inheritance-implications">Inheritance implications</a></li>
+<li><a class="reference internal" href="#multiple-inheritance">Multiple inheritance</a></li>
+</ul>
+</li>
+</ul>
+</ul>
+</li>
+  <li>
+    <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>
+    </a>
+  </li>
+  <li>
+    <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>
+    </a>
+  </li>
+          </ul>
+<form class="navbar-form navbar-right" action="../search.html" method="get">
+ <div class="form-group">
+  <input type="text" name="q" class="form-control" placeholder="Search" />
+ </div>
+  <input type="hidden" name="check_keywords" value="yes" />
+  <input type="hidden" name="area" value="default" />
+</form>
+        </div>
+    </div>
+  </div>
+<div class="container">
+  <div class="row">
+    <div class="col-md-12">
+  <div class="section" id="derive-configs">
+<h1>Derive configs<a class="headerlink" href="#derive-configs" title="Permalink to this headline">¶</a></h1>
+<p>bake supports deriving configs, which allows you to put repetetive settings in a base config.</p>
+<div class="section" id="deriving-a-config">
+<h2>Deriving a config<a class="headerlink" href="#deriving-a-config" title="Permalink to this headline">¶</a></h2>
+<p>Derving a config in bake is pretty straight forward, and looks like this:</p>
+<div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A
+LibraryConfig    B, extends: A
+CustomConfig     C, extends: B
+ExecutableConfig D, extends: C
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<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.
+In the example above D gets the dependencies from A, because &#8220;Dependency&#8221; is valid in all configs, but D does not get
+the &#8220;Files&#8221; from A and B, because &#8220;Files&#8221; is not valid in CustomConfig.</p>
+</div>
+</div>
+<div class="section" id="inheritance-implications">
+<h2>Inheritance implications<a class="headerlink" href="#inheritance-implications" title="Permalink to this headline">¶</a></h2>
+<p>In general it is very easy.</p>
+<ul class="simple">
+<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>
+<li>Elements which can exist only once:<ul>
+<li>if it exists in EITHER child OR parent, use this one</li>
+<li>is it exists in BOTH, attributes are merged (child attributes have high priority) and sub elements are inherited recursively</li>
+</ul>
+</li>
+</ul>
+<p>The following example</p>
+<div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A {
+  Files &quot;x.cpp&quot;
+  Files &quot;y.cpp&quot;
+  ArtifactName &quot;z.exe&quot;
+  DefaultToolchain GCC {
+    Linker {
+      Flags &quot;-O3&quot;
+    }
+  }
+}
+ExecutableConfig B, extends: A {
+  Files &quot;z.cpp&quot;
+  IncludeDir &quot;inc&quot;
+  ArtifactName &quot;a.exe&quot;
+  DefaultToolchain Diab {
+    Compiler CPP {
+      Define &quot;TEST&quot;
+    }
+  }
+}
+</pre></div>
+</div>
+<p>results implicitly in:</p>
+<div class="highlight-text"><div class="highlight"><pre>ExecutableConfig B {
+  Files &quot;x.cpp&quot;
+  Files &quot;y.cpp&quot;
+  Files &quot;z.cpp&quot;
+  IncludeDir &quot;inc&quot;
+  ArtifactName &quot;a.exe&quot;
+  DefaultToolchain Diab {
+    Compiler CPP {
+      Define &quot;TEST&quot;
+    }
+    Linker {
+      Flags &quot;-O3&quot;
+    }
+  }
+}
+</pre></div>
+</div>
+</div>
+<div class="section" id="multiple-inheritance">
+<h2>Multiple inheritance<a class="headerlink" href="#multiple-inheritance" title="Permalink to this headline">¶</a></h2>
+<p>It is possible to derive from several projects:</p>
+<div class="highlight-text"><div class="highlight"><pre>ExecutableConfig A
+LibraryConfig    B
+ExecutableConfig C, extends: &quot;A, B&quot;
+</pre></div>
+</div>
+<p>&#8220;extends&#8221; defines a comma separated list. The merge will be performed with all parent configs.</p>
+</div>
+</div>
+    </div>
+  </div>
+</div>
+<footer class="footer">
+  <div class="container">
+    <p class="pull-right">
+      <a href="#">Back to top</a>
+    </p>
+    <p>
+        &copy; Copyright 2016, E.S.R.Labs AG.<br/>
+      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.1.<br/>
+    </p>
+  </div>
+</footer>
+  </body>
 </html>