summaryrefslogtreecommitdiff
path: root/doc/sessions
diff options
context:
space:
mode:
authorTristan Van Berkom <tristan.vanberkom@codethink.co.uk>2018-06-17 21:04:41 -0400
committerTristan Van Berkom <tristan.vanberkom@codethink.co.uk>2018-06-17 21:37:22 -0400
commit73b930024d164e076275868253f92a47593f2dd8 (patch)
tree1789cbea13738ad4f4fcd7167c6741cb41dcccf5 /doc/sessions
parent3f56037896a6f546d6949c70aa65384d78b7a0fc (diff)
downloadbuildstream-73b930024d164e076275868253f92a47593f2dd8.tar.gz
doc: Adding part 2 of the getting started tutorial
o doc/examples/running-commands: New example project of a `manual` build element o doc/sessions/running-commands.run: New session file to capture bst output o doc/source/sessions-stored: Added new generated sessions o doc/source/tutorial/running-commands.rst: New tutorial entry describing how commands are run in the sandbox o tests/examples/running-commands.py: Test case validating the tutorial's assertions
Diffstat (limited to 'doc/sessions')
-rw-r--r--doc/sessions/running-commands.run25
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/sessions/running-commands.run b/doc/sessions/running-commands.run
new file mode 100644
index 000000000..ce8eccd2f
--- /dev/null
+++ b/doc/sessions/running-commands.run
@@ -0,0 +1,25 @@
+
+commands:
+# Make it fetch first
+- directory: ../examples/running-commands
+ command: fetch hello.bst
+
+# Capture a show output
+- directory: ../examples/running-commands
+ output: ../source/sessions/running-commands-show-before.html
+ command: show hello.bst
+
+# Capture a build output
+- directory: ../examples/running-commands
+ output: ../source/sessions/running-commands-build.html
+ command: build hello.bst
+
+# Capture another show output
+- directory: ../examples/running-commands
+ output: ../source/sessions/running-commands-show-after.html
+ command: show hello.bst
+
+# Capture a shell output
+- directory: ../examples/running-commands
+ output: ../source/sessions/running-commands-shell.html
+ command: shell hello.bst -- hello