summaryrefslogtreecommitdiff
path: root/doc/source/format_declaring.rst
diff options
context:
space:
mode:
authorJonathan Maw <jonathan.maw@codethink.co.uk>2018-08-10 14:52:12 +0100
committerJonathan Maw <jonathan.maw@codethink.co.uk>2018-08-14 09:54:31 +0100
commitc51bbff3941c7a2520fd2d64da3bc8c7c07af982 (patch)
tree63da0b51a9cf76ceee27eadf3c43d0d015faa425 /doc/source/format_declaring.rst
parent476fcfa6323cfbc4777938a0b7d553d25a5cab2a (diff)
downloadbuildstream-c51bbff3941c7a2520fd2d64da3bc8c7c07af982.tar.gz
docs: Add documentation of build-depends and runtime-depends fields
Diffstat (limited to 'doc/source/format_declaring.rst')
-rw-r--r--doc/source/format_declaring.rst68
1 files changed, 66 insertions, 2 deletions
diff --git a/doc/source/format_declaring.rst b/doc/source/format_declaring.rst
index 013e2c82c..38c107c1b 100644
--- a/doc/source/format_declaring.rst
+++ b/doc/source/format_declaring.rst
@@ -98,6 +98,68 @@ relative filename to the elements they depend on here.
See :ref:`format_dependencies` for more information on the dependency model.
+.. _format_build_depends:
+
+Build-Depends
+~~~~~~~~~~~~~
+
+.. code:: yaml
+
+ # Specify some build-dependencies
+ build-depends:
+ - element1.bst
+ - element2.bst
+
+Build dependencies between elements can be specified with the ``build-depends`` attribute.
+The above code snippet is equivalent to:
+
+.. code:: yaml
+
+ # Specify some build-dependencies
+ depends:
+ - filename: element1.bst
+ type: build
+ - filename: element2.bst
+ type: build
+
+See :ref:`format_dependencies` for more information on the dependency model.
+
+.. note::
+
+ The ``build-depends`` configuration is available since :ref:`format version 14 <project_format_version>`
+
+
+.. _format_runtime_depends:
+
+Runtime-Depends
+~~~~~~~~~~~~~~~
+
+.. code:: yaml
+
+ # Specify some runtime-dependencies
+ runtime-depends:
+ - element1.bst
+ - element2.bst
+
+Runtime dependencies between elements can be specified with the ``runtime-depends`` attribute.
+The above code snippet is equivalent to:
+
+.. code:: yaml
+
+ # Specify some runtime-dependencies
+ depends:
+ - filename: element1.bst
+ type: runtime
+ - filename: element2.bst
+ type: runtime
+
+See :ref:`format_dependencies` for more information on the dependency model.
+
+.. note::
+
+ The ``runtime-depends`` configuration is available since :ref:`format version 14 <project_format_version>`
+
+
.. _format_sources:
Sources
@@ -276,8 +338,8 @@ attributes are suitable.
.. note::
- Note the order in which element dependencies are declared in the ``depends``
- list is not meaningful.
+ Note the order in which element dependencies are declared in the ``depends``,
+ ``build-depends`` and ``runtime-depends`` lists are not meaningful.
Dependency dictionary:
@@ -299,6 +361,8 @@ Attributes:
* ``type``
This attribute is used to express the :ref:`dependency type <format_dependencies_types>`.
+ This field is not permitted in :ref:`Build-Depends <format_build_depends>` or
+ :ref:`Runtime-Depends <format_runtime_depends>`.
* ``junction``