examples: add project demonstrating a junction element

This is part of the work towards #437.

4 files changed, 28 insertions, 0 deletions

diff --git a/doc/examples/junctions/elements/callHello.bst b/doc/examples/junctions/elements/callHello.bst
new file mode 100644
index 000000000..4b0d583e8
--- /dev/null
+++ b/doc/examples/junctions/elements/callHello.bst
@@ -0,0 +1,9 @@
+kind: import
+
+sources:
+- kind: local
+  path: files/callHello.sh
+
+depends:
+  - filename: hello.bst
+    junction: hello-junction.bst
diff --git a/doc/examples/junctions/elements/hello-junction.bst b/doc/examples/junctions/elements/hello-junction.bst
new file mode 100644
index 000000000..dda865ecf
--- /dev/null
+++ b/doc/examples/junctions/elements/hello-junction.bst
@@ -0,0 +1,8 @@
+kind: junction
+
+# Specify the source of the BuildStream project
+# We are going to use the autotools examples distributed with BuildStream in the
+# doc/examples/autotools directory
+sources:
+- kind: local
+  path: ../autotools
diff --git a/doc/examples/junctions/files/callHello.sh b/doc/examples/junctions/files/callHello.sh
new file mode 100644
index 000000000..21bc424c9
--- /dev/null
+++ b/doc/examples/junctions/files/callHello.sh
@@ -0,0 +1,3 @@
+#!/bin/sh
+echo "Calling hello:"
+hello
diff --git a/doc/examples/junctions/project.conf b/doc/examples/junctions/project.conf
new file mode 100644
index 000000000..7f8ca6a38
--- /dev/null
+++ b/doc/examples/junctions/project.conf
@@ -0,0 +1,8 @@
+# Unique project name
+name: junctions
+
+# Required BuildStream format version
+format-version: 9
+
+# Subdirectory where elements are stored
+element-path: elements