diff options
author | Steven Knight <knight@baldmt.com> | 2008-12-11 05:37:35 +0000 |
---|---|---|
committer | Steven Knight <knight@baldmt.com> | 2008-12-11 05:37:35 +0000 |
commit | 522962e437958f137f8cdef05dab61f955f8387e (patch) | |
tree | bd97fc1cfe788c0328ac7b83b415b94de5aa52e8 /doc | |
parent | 09cef8493ea7a7bef9140b3b1dac51ff71fed971 (diff) | |
download | scons-522962e437958f137f8cdef05dab61f955f8387e.tar.gz |
Issue 2231: Add a --warn=future-deprecated option, along with
FutureDeprecatedWarning and MandatoryDeprecatedWarning subclasses.
Use these to future-deprecate the Taskmaster.Task class, which we intend
to turn into an abstract base class by requiring subclasses to implement
the .needs_execute() method.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/man/scons.1 | 22 |
1 files changed, 21 insertions, 1 deletions
diff --git a/doc/man/scons.1 b/doc/man/scons.1 index 123ca5cf..300e14ce 100644 --- a/doc/man/scons.1 +++ b/doc/man/scons.1 @@ -1352,8 +1352,16 @@ These warnings are disabled by default. .TP --warn=deprecated, --warn=no-deprecated -Enables or disables all warnings about use of deprecated features. +Enables or disables all warnings about use of +currently deprecated features. These warnings are enabled by default. +Note that the +.b --warn=no-deprecated +option does not disable warnings about absolutely all deprecated features. +Warnings for some deprecated features that have already been through +several releases with deprecation warnings +may be mandatory for a release or two +before they are officially no longer supported by SCons. Warnings for some specific deprecated features may be enabled or disabled individually; see below. @@ -1396,6 +1404,18 @@ Fortran and C++ object files in a single executable, which can yield unpredictable behavior with some compilers. .TP +--warn=future-deprecated, --warn=no-future-deprecated +Enables or disables warnings about features +that will be deprecated in the future. +These warnings are disabled by default. +Enabling this warning is especially +recommended for projects that redistribute +SCons configurations for other users to build, +so that the project can be warned as soon as possible +about to-be-deprecated features +that may require changes to the configuration. + +.TP --warn=link, --warn=no-link Enables or disables warnings about link steps. |