summaryrefslogtreecommitdiff
path: root/docs/features/scripting.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/features/scripting.rst')
-rw-r--r--docs/features/scripting.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/features/scripting.rst b/docs/features/scripting.rst
new file mode 100644
index 00000000..c6869774
--- /dev/null
+++ b/docs/features/scripting.rst
@@ -0,0 +1,18 @@
+Scripting
+=========
+
+Document use cases and commands for ``run_script`` and ``run_pyscript``
+
+Comments
+--------
+
+Any command line input where the first non-whitespace character is a `#` will be treated as a comment.
+This means any `#` character appearing later in the command will be treated as a literal. The same
+applies to a `#` in the middle of a multiline command, even if it is the first character on a line.
+
+Comments can be useful in :ref:`scripts`, but would be pointless within an interactive session.
+
+::
+
+ (Cmd) # this is a comment
+ (Cmd) this # is not a comment \ No newline at end of file