summaryrefslogtreecommitdiff
path: root/docs/config.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/config.rst')
-rw-r--r--docs/config.rst8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/config.rst b/docs/config.rst
index 72028066..a886dab1 100644
--- a/docs/config.rst
+++ b/docs/config.rst
@@ -499,6 +499,14 @@ You can escape curly braces with the ``\`` character if you need them, for examp
commands = echo "\{posargs\}" = {posargs}
+
+Note some substitutions (e.g. ``posargs``, ``env``) may have addition values attached to it,
+via the ``:`` character (e.g. ``posargs`` - default value, ``env`` - key).
+Such substitutions cannot have a space after the ``:`` character
+(e.g. ``{posargs: magic}`` while being at the start of a line
+inside the ini configuration (this would be parsed as factorial ``{posargs``,
+having value magic).
+
Globally available substitutions
++++++++++++++++++++++++++++++++