diff options
author | Christian Kandeler <christian.kandeler@qt.io> | 2018-06-01 11:23:57 +0000 |
---|---|---|
committer | The Qt Project <gerrit-noreply@qt-project.org> | 2018-06-01 11:23:57 +0000 |
commit | 250e6da6cb06eb7ca82fae0d98be8b4b6123cfcf (patch) | |
tree | d06c5d3628b36b4077ce6a05b41150f6a7d00583 /doc/reference/cli/tools/cli-config.qdoc | |
parent | 17059ccd06e56010fa0d44ebcaf0be7b85d69703 (diff) | |
parent | 6a3c4dc21c1a5831618e5604df45abe4b0545bba (diff) |
Merge "Merge 1.12 into master"
Diffstat (limited to 'doc/reference/cli/tools/cli-config.qdoc')
-rw-r--r-- | doc/reference/cli/tools/cli-config.qdoc | 24 |
1 files changed, 21 insertions, 3 deletions
diff --git a/doc/reference/cli/tools/cli-config.qdoc b/doc/reference/cli/tools/cli-config.qdoc index 0d2ba9989..e32ffee0e 100644 --- a/doc/reference/cli/tools/cli-config.qdoc +++ b/doc/reference/cli/tools/cli-config.qdoc @@ -36,10 +36,10 @@ \section1 Synopsis \code - qbs config [--settings-dir <directory>] [--list [<root> ...]] + qbs config [--settings-dir <directory>] [--user|--system] [--list [<root> ...]] [--unset <key>] [--export <file>] [--import <file>] - qbs config [--settings-dir <directory>] <key> - qbs config [--settings-dir <directory>] <key> <value> + qbs config [--settings-dir <directory>] [--user|--system] <key> + qbs config [--settings-dir <directory>] [--user|--system] <key> <value> \endcode \section1 Description @@ -52,6 +52,22 @@ The third form sets the specified \c <key> with the specified \c <value>. + There are two sets of settings: The system-level settings affect all users, + while the user-level settings are specific to the current user. + By default, the read operations consider both sources. If the same key is + present in both settings, then for list values, the system value is + appended to the user value, while for other types of values the user-level + one takes precedence. Write operations go to the user-level settings by default. + Use the \c {--user} and \c {--system} options to change this behavior. + \note It is conceivable that the default system value of the + \c {preferences.qbsSearchPaths} setting could pull in unwanted \QBS modules, + in particular when doing cross-builds. In such a case, you can set + \c {preferences.ignoreSystemSearchPaths} to exclude the search paths coming + from the system settings. You'll typically do this for a specific profile: + \code + $ qbs config profiles.myprofile.preferences.ignoreSystemSearchPaths true + \endcode + You can use the \l{config-ui} command to open the Qbs Settings tool for managing settings in a hierarchical view. @@ -65,6 +81,8 @@ \include cli-options.qdocinc unset \include cli-options.qdocinc export \include cli-options.qdocinc import + \include cli-options.qdocinc config-user + \include cli-options.qdocinc config-system \include cli-options.qdocinc help \section1 Parameters |