aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJoerg Bornemann <joerg.bornemann@qt.io>2017-06-12 14:03:59 +0200
committerJoerg Bornemann <joerg.bornemann@qt.io>2017-06-12 14:05:10 +0200
commitf4de86a2f6b91ceb60779543ff7400170420013a (patch)
tree0e0ec212f4c3540e9e62a387114ed28e7a03e11f /doc
parent5ba4fd79ae13fec9c615d4c3892e70b72ed26a99 (diff)
parent5bfef74f12e59bfc699b7c8e93ea05c2625891d5 (diff)
Merge remote-tracking branch 'origin/1.8'
Diffstat (limited to 'doc')
-rw-r--r--doc/qbs.qdoc22
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/qbs.qdoc b/doc/qbs.qdoc
index 80aa2f25b..3b9789f9d 100644
--- a/doc/qbs.qdoc
+++ b/doc/qbs.qdoc
@@ -595,6 +595,28 @@
\endtable
+ \section1 Overriding Property Values from the Command Line
+
+ Property values set in project files or profiles can be overridden on the command line.
+ The syntax is \c{<prefix>.<prop-name>:<prop-value>}. The following command lines
+ demonstrate how to set different kinds of properties:
+ \code
+ $ qbs projects.someProject.projectProperty:false # set a property of a project
+ $ qbs products.someProduct.productProperty:false # set a property of a product
+ $ qbs modules.cpp.treatWarningsAsErrors:true # set a module property for all products
+ \endcode
+
+ Property values on the command line can also be expressed in JavaScript form, the same way
+ as you would write them in a project file. Make sure to take care of proper
+ quoting, so that the shell does not interpret any of the values itself. Properties of type
+ \c stringList can also be provided as comma-separated values, if none of the strings contain
+ special characters:
+ \code
+ $ qbs projects.someProject.listProp:'["a", "b", "c"]'
+ $ qbs projects.someProject.listProp:a,b,c # same as above
+ $ qbs projects.someProject.listProp:'["a b", "c"]' # no CSV equivalent
+ \endcode
+
\section1 File Tags and Taggers
\QBS itself knows nothing about C++ files or file extensions. All source files