Wiki

Clone wiki

SCons / DeprecatedFeatures

This page is intended to track the various features that are, or will be, deprecated, and their progress through our DeprecationCycle. The idea is to have a place to track movement of these through the cycle so that, within the guidelines of the Cycle, we can be reasonably timely about shedding older features that may be slowing down or complicating the code base.

In the table below, a '?' indicates an estimated or unknown value and a '??' indicates a projected future time. The most recently announced are at the top.

TODO: Go through old release notes and/or mailing list archives to nail down "Announced."

Stage Description
Repl Replacement released
Annuc Announcement
Hidden Hidden Warning, off by default, can be turned on
Suppr Suppressible Warning, on by default, can be turned off
Mand Mandatory Warning, always on
Fatal Fatal Error, feature no longer available
Removed Check removed, may cause Python error
Feature Description / Notes Repl Annuc Hidden Suppr Mand Fatal Removed
Python 2.7 Drop support for Python 2.7 N/A ?? ?? ?? ?? ?? never
Python 2.6 Drop support for Python 2.6 N/A ?? ?? ?? ?? ?? never
Python 2.5 Drop support for Python 2.5 N/A ?? ?? ?? ??? ?? never
Python 2.4 Drop support for Python 2.4 N/A 3.0?? ?? ?? ?? 4.0?? never
--cache-<option> Convert to --cache=<option> 2.1?? 2.1?? 2.1?? ?? ?? 3.0?? 3.2??
Python 2.3 Drop support for Python 2.3 N/A 1.3 1.3 1.3 2.0 2.x?? never
Python 2.2 Drop support for Python 2.2 N/A 1.3 1.3 1.3 1.3.1 2.0 never
${,UN}CHANGED_SOURCES ${,UN}CHANGED_TARGETS reserved variables Deprecate the user's ability to set them N/A 1.2 Warning message (and assignment suppressed) as one of the reserved construction variable names
Python 1.5 - 2.1 Drop support for Python versions up to 2.1 N/A TODO 0.98.0 1.3 2.0 never
Options/*.py modules Stub modules, restored when 0.98.1 removed them and broke released configurations 0.98.3 TODO 1.2 2.0 2.1?? 3.0??
*Option names Replaced by *Variable names 0.98.1 TODO 1.2 2.0 2.1?? 3.0??
env.BuildDir() Replaced by env.VariantDir() 0.98.0 TODO 2.0 2.1?? 3.0?? ??
build_dir option Replaced by variant_dir 0.98.0 TODO 2.0 2.1?? 3.0?? ??
env.Copy() Replaced by env.Clone() 0.98.0 TODO 0.98.0 2.0 2.1?? ??
env.SourceSignatures() and env.TargetSignature() Replaced by env.Decider(); eliminating these would speed up a critical code path! 0.98.0 TODO 0.98.0 2.0 2.1?? ??
--debug=dtree option Replaced by --tree=derived 0.98.0 TODO 0.98.0 2.0 2.1?? ??
--debug=stree option Replaced by --tree=all,status 0.98.0 TODO 0.98.0 2.0 2.1?? ??
--debug=tree option Replaced by --tree=all 0.98.0 TODO 0.98.0 2.0 2.1?? ??
Sig module Stub module to maintain backwards compatibility from before the Signature Refactoring 0.97.x TODO 0.98.0 2.0 2.1?? ??
scanner Builder keyword Replaced by separate target_scanner and source_scanner keywords 0.96.90 TODO 0.96.90 2.0 2.1?? ??
overrides Builder keyword Replaced by use of keyword arguments in Builder creation 0.95 TODO 0.95 2.0 2.1?? ??
--debug=nomemoizer option No longer has any effect 0.96.94 TODO 0.96.94 2.0 2.1?? ??
File.win32 attribute Replaced by .windows 0.96.92 TODO none 2.1?? ?? ?? ??
$WIN32* construction variables Replaced by $WINDOWS* construction variables 0.96.92 TODO none 2.1?? ?? ?? ??
$PDFCOM construction variable Replaced by $DVIPDFCOM 0.14 TODO none 2.1?? ?? ?? ??
Taskmaster.Task. needs_execute() TBD: internal method; may be used by user-defined subclasses should always be overridden ? 2.0 2.1?? ?? ??
Scanner.Scanner class TBD: unused internal class; may be used by user code ? ? ? ? ? ? gone
Scanner.Selector class TBD: unused internal class; may be used by user code ? ? ? ? ? ? gone

Updated