From 86ed40131a26c5480960f197117da0336905149a Mon Sep 17 00:00:00 2001 From: Tristan van Berkom Date: Thu, 28 May 2020 16:47:13 +0900 Subject: doc/source/using_config.rst: Document support for version specific config files. --- doc/source/using_config.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) 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 ---------------------- -- cgit v1.2.1