diff options
author | Christian Kandeler <christian.kandeler@qt.io> | 2022-09-22 17:14:55 +0200 |
---|---|---|
committer | Christian Kandeler <christian.kandeler@qt.io> | 2022-10-04 07:43:01 +0000 |
commit | a29bbf5568bf651b076f051720a98e9d0297faa9 (patch) | |
tree | 5d99c12c7d9735e7f113c3a04ccf95746ef8dedc /doc | |
parent | 512001849af89e4b2c5bfb18b039387d6fe7aaa6 (diff) | |
download | qbs-a29bbf5568bf651b076f051720a98e9d0297faa9.tar.gz |
Make handling of deprecated items and properties configurable
As of now, a newly deprecated property leads to users getting bombarded
with warnings, even though they did not yet have a chance to adapt their
project.
Now the warnings appear by default one minor version before removal,
which together with our convention of keeping deprecated properties for
at least two minor versions gives users enough time to adapt without
getting spammed.
There is also a mode for switching to the previous behavior (for early
detection), as well as the possibility to trigger errors instead of
warnings, which should be helpful in CI configurations.
To support the case where the user cannot do anything about them, the
warnings can also be suppressed altogether.
Change-Id: I295f816758f0f111fcb0351581a4328be3af5668
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
Reviewed-by: Ivan Komissarov <ABBAPOH@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/appendix/json-api.qdoc | 1 | ||||
-rw-r--r-- | doc/reference/cli/builtin/cli-resolve.qdoc | 1 | ||||
-rw-r--r-- | doc/reference/cli/cli-options.qdocinc | 21 |
3 files changed, 23 insertions, 0 deletions
diff --git a/doc/appendix/json-api.qdoc b/doc/appendix/json-api.qdoc index 68bb644cf..b555825f9 100644 --- a/doc/appendix/json-api.qdoc +++ b/doc/appendix/json-api.qdoc @@ -117,6 +117,7 @@ \row \li build-root \li \l FilePath \li yes \row \li configuration-name \li string \li no \row \li data-mode \li \l DataMode \li no + \row \li deprecation-warning-mode \li string \li no \row \li dry-run \li bool \li no \row \li environment \li \l Environment \li no \row \li error-handling-mode \li string \li no diff --git a/doc/reference/cli/builtin/cli-resolve.qdoc b/doc/reference/cli/builtin/cli-resolve.qdoc index 273ce8403..4569980bd 100644 --- a/doc/reference/cli/builtin/cli-resolve.qdoc +++ b/doc/reference/cli/builtin/cli-resolve.qdoc @@ -56,6 +56,7 @@ \include cli-options.qdocinc settings-dir \include cli-options.qdocinc show-progress \include cli-options.qdocinc no-fallback-module-provider + \include cli-options.qdocinc deprecation-warnings \section1 Parameters diff --git a/doc/reference/cli/cli-options.qdocinc b/doc/reference/cli/cli-options.qdocinc index db8eeae48..ecb8f5c3e 100644 --- a/doc/reference/cli/cli-options.qdocinc +++ b/doc/reference/cli/cli-options.qdocinc @@ -331,6 +331,27 @@ //! [config-ui-system] +//! [deprecation-warnings] + + \section2 \c {--deprecation-warnings <mode>} + + Uses the specified deprecation warning mode, which controls what to do when deprecated + items or properties are encountered in the project. By default, a warning is emitted + if the item or property is scheduled for removal in the next minor version of \QBS. + Warnings can also be switched on or off unconditionally, and it can be specified that + project resolving should abort if deprecated constructs are present. + + Possible values of \c <mode> are: + + \list + \li \c error + \li \c on + \li \c before-removal (default value) + \li \c off + \endlist + +//! [deprecation-warnings] + //! [log-level] \section2 \c {--log-level <level>} |