1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
/****************************************************************************
**
** Copyright (C) 2017 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of Qbs.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\contentspage cli.html
\page cli-config.html
\ingroup cli
\title config
\brief Manages \QBS settings, such as preferences and profiles.
\section1 Synopsis
\code
qbs config [--settings-dir <directory>] [--user|--system] [--list [<root> ...]]
[--unset <key>] [--export <file>] [--import <file>]
qbs config [--settings-dir <directory>] [--user|--system] <key>
qbs config [--settings-dir <directory>] [--user|--system] <key> <value>
\endcode
\section1 Description
Manages \QBS settings, such as preferences and profiles. You can list all
keys and remove the specified key, as well as import settings from a file
or export them to a file.
The second form of this command displays the specified \c <key>.
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.
For more information, see \l{Configuring Profiles and Preferences}, \l{Managing Qt Versions},
\l{Modules}, \l {List of Modules}, and \l{Custom Modules and Items}.
\section1 Options
\include cli-options.qdocinc settings-dir
\include cli-options.qdocinc list-root
\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
\include cli-parameters.qdocinc key
\section1 Examples
Lists the existing profiles:
\code
qbs config --list profiles
\endcode
Shows the default profile:
\code
qbs config defaultProfile
\endcode
\note If no output is shown, the default profile used is the built-in
profile \c none, which sets no properties.
Sets the profile called \c gcc as the base profile of the Qt profile called
\c myqt:
\code
qbs config profiles.myqt.baseProfile gcc
\endcode
Adds the location of a custom module to your preferences, to make the module
accessible in several projects:
\code
qbs config preferences.qbsSearchPaths /usr/local/share/custom-qbs-extensions
\endcode
*/
|
