summaryrefslogtreecommitdiff
path: root/src/buildstream/plugins/elements/script.yaml
diff options
context:
space:
mode:
Diffstat (limited to 'src/buildstream/plugins/elements/script.yaml')
-rw-r--r--src/buildstream/plugins/elements/script.yaml28
1 files changed, 18 insertions, 10 deletions
diff --git a/src/buildstream/plugins/elements/script.yaml b/src/buildstream/plugins/elements/script.yaml
index b388378da..390f60355 100644
--- a/src/buildstream/plugins/elements/script.yaml
+++ b/src/buildstream/plugins/elements/script.yaml
@@ -1,3 +1,21 @@
+# The script element allows staging elements into specific locations
+# via it's "location" dependency configuration
+#
+# For example, if you want to stage "foo-tools.bst" into the "/" of
+# the sandbox at buildtime, and the "foo-system.bst" element into
+# the %{build-root}, you can do so as follows:
+#
+# build-depends:
+# - foo-tools.bst
+# - filename: foo-system.bst
+# config:
+# location: "%{build-root}"
+#
+# Note: the default of the "location" parameter is "/", so it is not
+# necessary to specify the location if you want to stage the
+# element in "/"
+#
+
# Common script element variables
variables:
# Defines the directory commands will be run from.
@@ -10,16 +28,6 @@ config:
# It is recommended to set root as read-only wherever possible.
root-read-only: False
- # Defines where to stage elements which are direct or indirect dependencies.
- # By default, all direct dependencies are staged to '/'.
- # This is also commonly used to take one element as an environment
- # containing the tools used to operate on the other element.
- # layout:
- # - element: foo-tools.bst
- # destination: /
- # - element: foo-system.bst
- # destination: %{build-root}
-
# List of commands to run in the sandbox.
commands: []