Rename the sconsoutput.py script to scons-doc.py, and refactor it to
[scons.git] / Announcement.txt
1 __COPYRIGHT__
2 __FILE__ __REVISION__ __DATE__ __DEVELOPER__
3
4   A new SCons checkpoint release, 0.XX.0dYYYYMMDD, is now available at the
5   SCons download page:
6
7           http://www.scons.org/download.php
8
9   A SCons "checkpoint release" is intended to provide early access to
10   new features so they can be tested in the field before being released
11   for adoption by other software distributions.
12
13   Note that a checkpoint release is developed using the same test-driven
14   development methdology as all SCons releases.  Existing SCons
15   functionality should all work as it does in previous releases (except
16   for any changes identified in the release notes) and early adopters
17   should be able to use a checkpoint release safely for production work
18   with existing SConscript files.  If not, it represents not only a bug
19   in SCons but also a hole in the regression test suite, and we want to
20   hear about it.
21
22   New features may be more lightly tested than in past releases,
23   especially as concerns their interaction with all of the other
24   functionality in SCons.  We are especially interested in hearing bug
25   reports about new functionality.
26
27   We do not recommend that downstream distributions (Debian, Fedora,
28   etc.) package a checkpoint release, mainly to avoid confusing the
29   "public" release numbering with the long checkpoint release names.
30
31   Here is a summary of the changes since 0.XX:
32
33   NEW FUNCTIONALITY
34
35   - List new features (presumably why a checkpoint is being released)
36
37   DEPRECATED FUNCTIONALITY
38
39   - List anything that's been deprecated since the last release
40
41   CHANGED/ENHANCED EXISTING FUNCTIONALITY
42
43   - List modifications to existing features, where the previous behavior
44     wouldn't actually be considered a bug
45
46   FIXES
47
48   - List fixes of outright bugs
49
50   IMPROVEMENTS
51
52   - List improvements that wouldn't be visible to the user in the
53     documentation:  performance improvements (describe the circumstances
54     under which they would be observed), or major code cleanups
55
56   PACKAGING
57
58   - List changes in the way SCons is packaged and/or released
59
60   DOCUMENTATION
61
62   - List any significant changes to the documentation (not individual
63     typo fixes, even if they're mentioned in src/CHANGES.txt to give
64     the contributor credit)
65
66   DEVELOPMENT
67
68   - List visible changes in the way SCons is developed
69
70   Thanks to LARRY, MOE and CURLY for their contributions to this release.
71