summaryrefslogtreecommitdiff
path: root/doc/source/using_config.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/using_config.rst')
-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
----------------------