summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTristan van Berkom <tristan.vanberkom@codethink.co.uk>2020-05-28 16:47:13 +0900
committerTristan van Berkom <tristan.vanberkom@codethink.co.uk>2020-05-29 18:59:17 +0900
commit86ed40131a26c5480960f197117da0336905149a (patch)
tree79fa2445cb9c135c80689544e932a2e571134e2a
parent16d6be452cacac08966a14c304351e4d21d07b22 (diff)
downloadbuildstream-tristan/bst-1/version-specific-config.tar.gz
doc/source/using_config.rst: Document support for version specific config files.tristan/bst-1/version-specific-config
-rw-r--r--doc/source/using_config.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/source/using_config.rst b/doc/source/using_config.rst
index 8b6cb58b0..f7469555b 100644
--- a/doc/source/using_config.rst
+++ b/doc/source/using_config.rst
@@ -22,6 +22,17 @@ invoking ``bst``, an attempt is made to load user specific configuration from
``$XDG_CONFIG_HOME/buildstream.conf``. On most Linux based systems, the location
will be ``~/.config/buildstream.conf``
+.. note::
+
+ If you have have multiple major versions of BuildStream installed, you
+ can have separate configuration files in your ``${XDG_CONFIG_HOME}``.
+
+ You can do this by naming them according to the major versions of
+ BuildStream you have installed. BuildStream 1 will load it's configuration
+ from ``$XDG_CONFIG_HOME/buildstream1.conf`` and BuildStream 2 will load
+ it's configuration from ``$XDG_CONFIG_HOME/buildstream2.conf``, while
+ any version will fallback to ``$XDG_CONFIG_HOME/buildstream.conf``.
+
Project specific value
----------------------