doc/examples/directives: Add user guide for using project options and directives

1 files changed, 35 insertions, 0 deletions

diff --git a/doc/sessions/directives.run b/doc/sessions/directives.run
new file mode 100644
index 000000000..5fd10bd3d
--- /dev/null
+++ b/doc/sessions/directives.run
@@ -0,0 +1,35 @@
+
+commands:
+# Make it fetch first
+- directory: ../examples/directives
+  command: source fetch hello.bst
+
+# Capture a build output
+- directory: ../examples/directives
+  output: ../source/sessions/directives-build-normal.html
+  command: build hello.bst
+
+# Capture a build output
+- directory: ../examples/directives
+  output: ../source/sessions/directives-build-somber.html
+  command: --option flavor somber build hello.bst
+
+# Capture a build output
+- directory: ../examples/directives
+  output: ../source/sessions/directives-build-excited.html
+  command: --option flavor excited build hello.bst
+
+# Capture a shell output
+- directory: ../examples/directives
+  output: ../source/sessions/directives-shell-normal.html
+  command: shell hello.bst -- hello
+
+# Capture a shell output
+- directory: ../examples/directives
+  output: ../source/sessions/directives-shell-somber.html
+  command: --option flavor somber shell hello.bst -- hello
+
+# Capture a shell output
+- directory: ../examples/directives
+  output: ../source/sessions/directives-shell-excited.html
+  command: --option flavor excited shell hello.bst -- hello