aboutsummaryrefslogtreecommitdiffstats
path: root/doc/reference/modules/cpp-module.qdoc
diff options
context:
space:
mode:
authorJoerg Bornemann <joerg.bornemann@qt.io>2017-05-18 16:27:33 +0200
committerJoerg Bornemann <joerg.bornemann@qt.io>2017-05-22 07:59:43 +0000
commit1dd00091f99e62d8c10677de98e753fe332565a9 (patch)
treee7b5a59e853d6e0e961d30e5de2ec595f9fc47fe /doc/reference/modules/cpp-module.qdoc
parentd9909033f53b0d4e79a525b95bf088b23e8ef9e2 (diff)
Make it possible to parametrize dependencies
Modules can declare dependency parameters, e.g. Module { name: "cpp" Parameter { property bool link } } Those parameters can be set in Depends items: CppApplication { Depends { name: "otherProduct" cpp.link: false } } Export items can provide default values for dependency parameters: DynamicLibrary { ... Export { Parameters { cpp.link: false } } } Rules can react on dependency parameters by accessing dep.parameters where dep is an object from the product.dependencies hierarchy. Showcase and test the feature by adding the cpp.link parameter, which can be set to false for library dependencies that should not be linked. [ChangeLog] Added a way to parametrize dependencies. [ChangeLog][Parameters] Added the cpp.link parameter to enable library dependencies to be excluded from linking. Task-number: QBS-585 Change-Id: I3b445ed65d5949a94426879e07a533a1c2af24d8 Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
Diffstat (limited to 'doc/reference/modules/cpp-module.qdoc')
-rw-r--r--doc/reference/modules/cpp-module.qdoc20
1 files changed, 20 insertions, 0 deletions
diff --git a/doc/reference/modules/cpp-module.qdoc b/doc/reference/modules/cpp-module.qdoc
index a65eb659f..c11b788d0 100644
--- a/doc/reference/modules/cpp-module.qdoc
+++ b/doc/reference/modules/cpp-module.qdoc
@@ -781,6 +781,26 @@
User project files should not set this property.
\endtable
+
+ \section1 Dependency Parameters
+
+ \table
+ \header
+ \li Parameter
+ \li Type
+ \li Since
+ \li Default
+ \li Description
+ \row
+ \li \c{link}
+ \li \c{bool}
+ \li 1.9
+ \li undefined
+ \li If \c{false}, the dependency will not be linked, even if
+ it is a valid input for a linker rule. This property
+ affects library dependencies only.
+ \endtable
+
\section1 Relevant File Tags
\table