1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
|
# __COPYRIGHT__
# __FILE__ __REVISION__ __DATE__ __DEVELOPER__
SCons - a software construction tool
Change Log
RELEASE 0.14 - XXX
From Chad Austin:
- Use .dll (not .so) for shared libraries on Cygwin; use -fPIC
when compiling them.
- Use 'rm' to remove files under Cygwin.
- Add a PLATFORM variable to construction environments.
- Remove the "platform" argument from tool specifications.
- Propogate PYTHONPATH when running the regression tests so distutils
can be found in non-standard locations.
- Using MSVC long command-line linking when running Cygwin.
From Allen Bierbaum:
- Pass an Environment to the Options validator method, and
add an Options.Save() method.
From Steve Christensen:
- Add an optional sort function argument to the GenerateHelpText()
Options function.
From Charles Crain:
- Parse the source .java files for class names (including inner class
names) to figure out the target .class files that will be created.
From Steven Knight:
- Add support for Java (javac and jar).
- Propagate the external SYSTEMROOT environment variable into ENV on
Win32 systems, so external commands that use sockets will work.
- Add a .posix attribute to PathList expansions.
- Check out CVS source files using POSIX path names (forward slashes
as separators) even on Win32.
- Add Node.clear() and Node.FS.Entry.clear() methods to wipe out a
Node's state, allowing it to be re-evaluated by continuous
integration build interfaces.
- Change the name of the Set{Build,Content}SignatureType() functions
to {Target,Source}Signatures(). Deprecate the old names but support
them for backwards compatibility.
From Damyan Pepper:
- Quote the "Entering directory" message like Make.
From Stefan Reichor:
- Add support for using Ghostscript to convert Postscript to PDF files.
From Anthony Roach:
- Add a standalone "Alias" function (separate from an Environment).
- Make Export() work for local variables.
- Support passing a dictionary to Export().
- Support Import('*') to import everything that's been Export()ed.
From David Snopek:
- Contribute the "Autoscons" code for Autoconf-like checking for
the existence of libraries, header files and the like.
From Greg Spencer:
- Support the C preprocessor #import statement.
- Allow the SharedLibrary() Builder on Win32 systems to be able to
register a newly-built dll using regsvr32.
- Add a Builder for Windows type library (.tlb) files from IDL files.
- Add an IDL scanner.
- Refactor the Fortran, C and IDL scanners to share common logic.
- Add .srcpath and .srcdir attributes to $TARGET and $SOURCE.
From Christoph Wiedemann:
- Integrate David Snopek's "Autoscons" code as the new SConf
configuration subsystem, including caching of values between
runs (using normal SCons dependency mechanisms), tests, and
documentation.
RELEASE 0.13 - Mon, 31 Mar 2003 20:22:00 -0600
From Charles Crain:
- Fix a bug when BuildDir(duplicate=0) is used and SConscript
files are called from within other SConscript files.
- Support (older) versions of Perforce which don't set the Windows
registry.
RELEASE 0.12 - Thu, 27 Mar 2003 23:52:09 -0600
From Charles Crain:
- Added support for the Perforce source code management system.
- Fix str(Node.FS) so that it returns a path relative to the calling
SConscript file's directory, not the top-level directory.
- Added support for a separate src_dir argument to SConscript()
that allows explicit specification of where the source files
for an SConscript file can be found.
- Support more easily re-usable flavors of command generators by
calling callable variables when strings are expanded.
From Steven Knight:
- Added an INSTALL construction variable that can be set to a function
to control how the Install() and InstallAs() Builders install files.
The default INSTALL function now copies, not links, files.
- Remove deprecated features: the "name" argument to Builder objects,
and the Environment.Update() method.
- Add an Environment.SourceCode() method to support fetching files
from source code systems. Add factory methods that create Builders
to support BitKeeper, CVS, RCS, and SCCS. Add support for fetching
files from RCS or SCCS transparently (like GNU Make).
- Make the internal to_String() function more efficient.
- Make the error message the same as other build errors when there's a
problem unlinking a target file in preparation for it being built.
- Make TARGET, TARGETS, SOURCE and SOURCES reserved variable names and
warn if the user tries to set them in a construction environment.
- Add support for Tar and Zip files.
- Better documentation of the different ways to export variables to a
subsidiary SConscript file. Fix documentation bugs in a tools
example, places that still assumed SCons split strings on white
space, and typos.
- Support fetching arbitrary files from the TARGETS or SOURCES lists
(e.g. ${SOURCES[2]}) when calculating the build signature of a
command.
- Don't silently swallow exceptions thrown by Scanners (or other
exceptions while finding a node's dependent children).
- Push files to CacheDir() before calling the superclass built()
method (which may clear the build signature as part of clearing
cached implicit dependencies, if the file has a source scanner).
(Bug reported by Jeff Petkau.)
- Raise an internal error if we attempt to push a file to CacheDir()
with a build signature of None.
- Add an explicit Exit() function for terminating early.
- Change the documentation to correctly describe that the -f option
doesn't change to the directory in which the specified file lives.
- Support changing directories locally with SConscript directory
path names relative to any SConstruct file specified with -f.
This allows you to build in another directory by simply changing
there and pointing at the SConstruct file in another directory.
- Change the default SConscriptChdir() behavior to change to the
SConscript directory while it's being read.
- Fix an exception thrown when the -U option was used with no
Default() target specified.
- Fix -u so that it builds things in corresponding build directories
when used in a source directory.
From Lachlan O'Dea:
- Add SharedObject() support to the masm tool.
- Fix WhereIs() to return normalized paths.
From Jeff Petkau:
- Don't copy a built file to a CacheDir() if it's already there.
- Avoid partial copies of built files in a CacheDir() by copying
to a temporary file and renaming.
From Anthony Roach:
- Fix incorrect dependency-cycle errors when an Aliased source doesn't
exist.
RELEASE 0.11 - Tue, 11 Feb 2003 05:24:33 -0600
From Chad Austin:
- Add support for IRIX and the SGI MIPSPro tool chain.
- Support using the MSVC tool chain when running Cygwin Python.
From Michael Cook:
- Avoid losing signal bits in the exit status from a command,
helping terminate builds on interrupt (CTRL+C).
From Charles Crain:
- Added new AddPreAction() and AddPostAction() functions that support
taking additional actions before or after building specific targets.
- Add support for the PharLap ETS tool chain.
From Steven Knight:
- Allow Python function Actions to specify a list of construction
variables that should be included in the Action's signature.
- Allow libraries in the LIBS variable to explicitly include the prefix
and suffix, even when using the GNU linker.
(Bug reported by Neal Becker.)
- Use DOS-standard CR-LF line endings in the scons.bat file.
(Bug reported by Gary Ruben.)
- Doc changes: Eliminate description of deprecated "name" keyword
argument from Builder definition (reported by Gary Ruben).
- Support using env.Append() on BUILDERS (and other dictionaries).
(Bug reported by Bj=F6rn Bylander.)
- Setting the BUILDERS construction variable now properly clears
the previous Builder attributes from the construction Environment.
(Bug reported by Bj=F6rn Bylander.)
- Fix adding a prefix to a file when the target isn't specified.
(Bug reported by Esa Ilari Vuokko.)
- Clean up error messages from problems duplicating into read-only
BuildDir directories or into read-only files.
- Add a CommandAction.strfunction() method, and add an "env" argument
to the FunctionAction.strfunction() method, so that all Action
objects have strfunction() methods, and the functions for building
and returning a string both take the same arguments.
- Add support for new CacheDir() functionality to share derived files
between builds, with related options --cache-disable, --cache-force,
and --cache-show.
- Change the default behavior when no targets are specified to build
everything in the current directory and below (like Make). This
can be disabled by specifying Default(None) in an SConscript.
- Revamp SCons installation to fix a case-sensitive installation
on Win32 systems, and to add SCons-specific --standard-lib,
--standalone-lib, and --version-lib options for easier user
control of where the libraries get installed.
- Fix the ability to directly import and use Platform and Tool modules
that have been implicitly imported into an Environment().
- Add support for allowing an embedding interface to annotate a node
when it's created.
- Extend the SConscript() function to accept build_dir and duplicate
keyword arguments that function like a BuildDir() call.
From Steve Leblanc:
- Fix the output of -c -n when directories are involved, so it
matches -c.
From Anthony Roach:
- Use a different shared object suffix (.os) when using gcc so shared
and static objects can exist side-by-side in the same directory.
- Allow the same object files on Win32 to be linked into either
shared or static libraries.
- Cache implicit cache values when using --implicit-cache.
RELEASE 0.10 - Thu, 16 Jan 2003 04:11:46 -0600
From Derrick 'dman' Hudson:
- Support Repositories on other file systems by symlinking or
copying files when hard linking won't work.
From Steven Knight:
- Remove Python bytecode (*.pyc) files from the scons-local packages.
- Have FunctionActions print a description of what they're doing
(a representation of the Python call).
- Fix the Install() method so that, like other actions, it prints
what would have happened when the -n option is used.
- Don't create duplicate source files in a BuildDir when the -n
option is used.
- Refactor the Scanner interface to eliminate unnecessary Scanner
calls and make it easier to write efficient scanners.
- Added a "recursive" flag to Scanner creation that specifies the
Scanner should be invoked recursively on dependency files returned
by the scanner.
- Significant performance improvement from using a more efficient
check, throughout the code, for whether a Node has a Builder.
- Fix specifying only the source file to MultiStepBuilders such as
the Program Builder. (Bug reported by Dean Bair.)
- Fix an exception when building from a file with the same basename as
the subdirectory in which it lives. (Bug reported by Gerard Patel.)
- Fix automatic deduction of a target file name when there are
multiple source files specified; the target is now deduced from just
the first source file in the list.
- Documentation fixes: better initial explanation of SConscript files;
fix a misformatted "table" in the StaticObject explanation.
From Steven Knight and Steve Leblanc:
- Fix the -c option so it will remove symlinks.
From Steve Leblanc:
- Add a Clean() method to support removing user-specified targets
when using the -c option.
- Add a development script for running SCons through PyChecker.
- Clean up things found by PyChecker (mostly unnecessary imports).
- Add a script to use HappyDoc to create HTML class documentation.
From Lachlan O'Dea:
- Make the Environment.get() method return None by default.
From Anthony Roach:
- Add SetJobs() and GetJobs() methods to allow configuration of the
number of default jobs (still overridden by -j).
- Convert the .sconsign file format from ASCII to a pickled Python
data structure.
- Error message cleanups: Made consistent the format of error
messages (now all start with "scons: ***") and warning messages (now
all start with "scons: warning:"). Caught more cases with the "Do
not know how to build" error message.
- Added support for the MinGW tool chain.
- Added a --debug=includes option.
RELEASE 0.09 - Thu, 5 Dec 2002 04:48:25 -0600
From Chad Austin:
- Add a Prepend() method to Environments, to append values to
the beginning of construction variables.
From Matt Balvin:
- Add long command-line support to the "lib" Tool (Microsoft library
archiver), too.
From Charles Crain:
- Allow $$ in a string to be passed through as $.
- Support file names with odd characters in them.
- Add support for construction variable substition on scanner
directories (in CPPPATH, F77PATH, LIBPATH, etc.).
From Charles Crain and Steven Knight:
- Add Repository() functionality, including the -Y option.
From Steven Knight:
- Fix auto-deduction of target names so that deduced targets end
up in the same subdirectory as the source.
- Don't remove source files specified on the command line!
- Suport the Intel Fortran Compiler (ifl.exe).
- Supply an error message if there are no command-line or
Default() targets specified.
- Fix the ASPPCOM values for the GNU assembler.
(Bug reported by Brett Polivka.)
- Fix an exception thrown when a Default() directory was specified
when using the -U option.
- Issue a warning when -c can't remove a target.
- Eliminate unnecessary Scanner calls by checking for the
existence of a file before scanning it. (This adds a generic
hook to check an arbitrary condition before scanning.)
- Add explicit messages to tell when we're "Reading SConscript files
...," "done reading SConscript files," "Building targets," and
"done building targets." Add a -Q option to supress these.
- Add separate $SHOBJPREFIX and $SHOBJSUFFIX construction variables
(by default, the same as $OBJPREFIX and $OBJSUFFIX).
- Add Make-like error messages when asked to build a source file,
and before trying to build a file that doesn't have all its source
files (including when an invalid drive letter is used on WIN32).
- Add an scons-local-{version} package (in both .tar.gz and .zip
flavors) to help people who want to ship SCons as a stand-alone
build tool in their software packages.
- Prevent SCons from unlinking files in certain situations when
the -n option is used.
- Change the name of Tool/lib.py to Tool/mslib.py.
From Steven Knight and Anthony Roach:
- Man page: document the fact that Builder calls return Node objects.
From Steve LeBlanc:
- Refactor option processing to use our own version of Greg Ward's
Optik module, modified to run under Python 1.5.2.
- Add a ParseConfig() command to modify an environment based on
parsing output from a *-config command.
From Jeff Petkau:
- Fix interpretation of '#/../foo' on Win32 systems.
From Anthony Roach:
- Fixed use of command lines with spaces in their arguments,
and use of Nodes with spaces in their string representation.
- Make access and modification times of files in a BuildDir match
the source file, even when hard linking isn't available.
- Make -U be case insensitive on Win32 systems.
- Issue a warning and continue when finding a corrupt .sconsign file.
- Fix using an alias as a dependency of a target so that if one of the
alias' dependencies gets rebuilt, the resulting target will, too.
- Fix differently ordered targets causing unnecessary rebuilds
on case insensitive systems.
- Use os.system() to execute external commands whenever the "env"
utility is available, which is much faster than fork()/exec(),
and fixes the -j option on several platforms.
- Fix use of -j with multiple targets.
- Add an Options() object for friendlier accomodation of command-
line arguments.
- Add support for Microsoft VC++ precompiled header (.pch) files,
debugger (.pdb) files, and resource (.rc) files.
- Don't compute the $_CPPINCFLAGS, $_F77INCFLAGS, $_LIBFLAGS and
$_LIBDIRFLAGS variables each time a command is executed, define
them so they're computed only as needed. Add a new _concat
function to the Environment that allows people to define their
own similar variables.
- Fix dependency scans when $LIBS is overridden.
- Add EnsurePythonVersion() and EnsureSConsVersion() functions.
- Fix the overly-verbose stack trace on ListBuilder build errors.
- Add a SetContentSignatureType() function, allowing use of file
timestamps instead of MD5 signatures.
- Make -U and Default('source') fail gracefully.
- Allow the File() and Dir() methods to take a path-name string as
the starting directory, in addition to a Dir object.
- Allow the command handler to be selected via the SPAWN, SHELL
and ESCAPE construction variables.
- Allow construction variables to be overridden when a Builder
is called.
From sam th:
- Dynamically check for the existence of utilities with which to
initialize Environments by default.
RELEASE 0.08 - Mon, 15 Jul 2002 12:08:51 -0500
From Charles Crain:
- Fixed a bug with relative CPPPATH dirs when using BuildDir().
(Bug reported by Bob Summerwill.)
- Added a warnings framework and a --warn option to enable or
disable warnings.
- Make the C scanner warn users if files referenced by #include
directives cannot be found and --warn=dependency is specified.
- The BUILDERS construction variable should now be a dictionary
that maps builder names to actions. Existing uses of lists,
and the Builder name= keyword argument, generate warnings
about use of deprecated features.
- Removed the "shared" keyword argument from the Object and
Library builders.
- Added separated StaticObject, SharedObject, StaticLibrary and
SharedLibrary builders. Made Object and Library synonyms for
StaticObject and StaticLibrary, respectively.
- Add LIBS and LIBPATH dependencies for shared libraries.
- Removed support for the prefix, suffix and src_suffix arguments
to Builder() to be callable functions.
- Fix handling file names with multiple dots.
- Allow a build directory to be outside of the SConstruct tree.
- Add a FindFile() function that searches for a file node with a
specified name.
- Add $CPPFLAGS to the shared-object command lines for g++ and gcc.
From Charles Crain and Steven Knight:
- Add a "tools=" keyword argument to Environment instantiation,
and a separate Tools() method, for more flexible specification
of tool-specific environment changes.
From Steven Knight:
- Add a "platform=" keyword argument to Environment instantiation,
and a separate Platform() method, for more flexible specification
of platform-specific environment changes.
- Updated README instructions and setup.py code to catch an
installation failure from not having distutils installed.
- Add descriptions to the -H help text for -D, -u and -U so
people can tell them apart.
- Remove the old feature of automatically splitting strings
of file names on white space.
- Add a dependency Scanner for native Fortran "include" statements,
using a new "F77PATH" construction variable.
- Fix C #include scanning to detect file names with characters like
'-' in them.
- Add more specific version / build output to the -v option.
- Add support for the GNU as, Microsoft masm, and nasm assemblers.
- Allow the "target" argument to a Builder call to be omitted, in
which case the target(s) are deduced from the source file(s) and the
Builder's specified suffix.
- Add a tar archive builder.
- Add preliminary support for the OS/2 Platform, including the icc
and ilink Tools.
From Jeff Petkau:
- Fix --implicit-cache if the scanner returns an empty list.
From Anthony Roach:
- Add a "multi" keyword argument to Builder creation that specifies
it's okay to call the builder multiple times for a target.
- Set a "multi" on Aliases so multiple calls will append to an Alias.
- Fix emitter functions' use of path names when using BuildDir or
in subdirectories.
- Fix --implicit-cache causing redundant rebuilds when the header
file list changed.
- Fix --implicit-cache when a file has no implicit dependencies and
its source is generated.
- Make the drive letters on Windows always be the same case, so that
changes in the case of drive letters don't cause a rebuild.
- Fall back to importing the SCons.TimeStamp module if the SCons.MD5
module can't be imported.
- Fix interrupt handling to guarantee that a single interrupt will
halt SCons both when using -j and not.
- Fix .sconsign signature storage so that output files of one build
can be safely used as input files to another build.
- Added a --debug=time option to print SCons execution times.
- Print an error message if a file can't be unlinked before being
built, rather than just silently terminating the build.
- Add a SideEffect() method that can be used to tell the build
engine that a given file is created as a side effect of building
a target. A file can be specified as a side effect of more than
one build comand, in which case the commands will not be executed
simultaneously.
- Significant performance gains from not using our own version of
the inefficient stock os.path.splitext() method, caching source
suffix computation, code cleanup in MultiStepBuilder.__call__(),
and replicating some logic in scons_subst().
- Add --implicit-deps-changed and --implicit-deps-unchanged options.
- Add a GetLaunchDir() function.
- Add a SetBuildSignatureType() function.
From Zed Shaw:
- Add an Append() method to Environments, to append values to
construction variables.
- Change the name of Update() to Replace(). Keep Update() as a
deprecated synonym, at least for now.
From Terrel Shumway:
- Use a $PYTHON construction variable, initialized to sys.executable,
when using Python to build parts of the SCons packages.
- Use sys.prefix, not sys.exec_prefix, to find pdb.py.
RELEASE 0.07 - Thu, 2 May 2002 13:37:16 -0500
From Chad Austin:
- Changes to build SCons packages on IRIX (and other *NIces).
- Don't create a directory Node when a file already exists there,
and vice versa.
- Add 'dirs' and 'names' keyword arguments to SConscript for
easier specification of subsidiary SConscript files.
From Charles Crain:
- Internal cleanup of environment passing to function Actions.
- Builders can now take arbitrary keyword arguments to create
attributes to be passed to: command generator functions,
FunctionAction functions, Builder emitter functions (below),
and prefix/suffix generator functions (below).
- Command generator functions can now return ANYTHING that can be
converted into an Action (a function, a string, a CommandGenerator
instance, even an ActionBase instance).
- Actions now call get_contents() with the actual target and source
nodes used for the build.
- A new DictCmdGenerator class replaces CompositeBuilder to support
more flexible Builder behavior internally.
- Builders can now take an emitter= keyword argument. An emitter
is a function that takes target, source, and env argument, then
return a 2-tuple of (new sources, new targets). The emitter is
called when the Builder is __call__'ed, allowing a user to modify
source and target lists.
- The prefix, suffix and src_suffix Builder arguments now take a
callable as well a string. The callable is passed the Environment
and any extra Builder keyword arguments and is expected to return
the appropriate prefix or suffix.
- CommandActions can now be a string, a list of command + argument
strings, or a list of commands (strings or lists).
- Added shared library support. The Object and Library Builders now
take a "shared=1" keyword argument to specify that a shared object
or shared library should be built. It is an error to try to build
static objects into a shared library or vice versa.
- Win32 support for .def files has been added. Added the Win32-specific
construction variables $WIN32DEFPREFIX, $WIN32DEFSUFFIX,
$WIN32DLLPREFIX and $WIN32IMPLIBPREFIX. When building a .dll,
the new construction variable $WIN32_INSERT_DEF, controls whether
the appropriately-named .def file is inserted into the target
list (if not already present). A .lib file is always added to
a Library build if not present in the list of targets.
- ListBuilder now passes all targets to the action, not just the first.
- Fix so that -c now deletes generated yacc .h files.
- Builder actions and emitter functions can now be initialized, through
construction variables, to things other than strings.
- Make top-relative '#/dir' lookups work like '#dir'.
- Fix for relative CPPPATH directories in subsidiary SConscript files
(broken in 0.06).
- Add a for_signature argument to command generators, so that
generators that need to can return distinct values for the
command signature and for executing the command.
From Alex Jacques:
- Create a better scons.bat file from a py2bat.py script on the Python
mailing list two years ago (modeled after pl2bat.pl).
From Steven Knight:
- Fix so that -c -n does *not* remove the targets!
- Man page: Add a hierarchical libraries + Program example.
- Support long MSVC linker command lines through a builder action
that writes to a temporary file and uses the magic MSVC "link @file"
argument syntax if the line is longer than 2K characters.
- Fix F77 command-line options on Win32 (use /Fo instead of -o).
- Use the same action to build from .c (lower case) and .C (upper
case) files on case-insensitive systems like Win32.
- Support building a PDF file directly from a TeX or LaTeX file
using pdftex or pdflatex.
- Add a -x option to runtest.py to specify the script being tested.
A -X option indicates it's an executable, not a script to feed
to the Python interpreter.
- Add a Split() function (identical to SCons.Util.argmunge()) for use
in the next release, when Builders will no longer automatically split
strings on white space.
From Steve Leblanc:
- Add the SConscriptChdir() method.
From Anthony Roach:
- Fix --debug=tree when used with directory targets.
- Significant internal restructuring of Scanners and Taskmaster.
- Added new --debug=dtree option.
- Fixes for --profile option.
- Performance improvement in construction variable substitution.
- Implemented caching of content signatures, plus added --max-drift
option to control caching.
- Implemented caching of dependency signatures, enabled by new
--implicit-cache option.
- Added abspath construction variable modifier.
- Added $SOURCE variable as a synonym for $SOURCES[0].
- Write out .sconsign files on error or interrupt so intermediate
build results are saved.
- Change the -U option to -D. Make a new -U that builds just the
targets from the local SConscript file.
- Fixed use of sys.path so Python modules can be imported from
the SConscript directory.
- Fix for using Aliases with the -u, -U and -D options.
- Fix so that Nodes can be passed to SConscript files.
From Moshe Zadka:
- Changes for official Debian packaging.
RELEASE 0.06 - Thu, 28 Mar 2002 01:24:29 -0600
From Charles Crain:
- Fix command generators to expand construction variables.
- Make FunctionAction arguments be Nodes, not strings.
From Stephen Kennedy:
- Performance: Use a dictionary, not a list, for a Node's parents.
From Steven Knight:
- Add .zip files to the packages we build.
- Man page: document LIBS, fix a typo, document ARGUMENTS.
- Added RANLIB and RANLIBFLAGS construction variables. Only use them
in ARCOM if there's a "ranlib" program on the system.
- Add a configurable CFILESUFFIX for the Builder of .l and .y files
into C files.
- Add a CXXFile Builder that turns .ll and .yy files into .cc files
(configurable via a CXXFILESUFFIX construction variable).
- Use the POSIX-standard lex -t flag, not the GNU-specific -o flag.
(Bug reported by Russell Christensen.)
- Fixed an exception when CPPPATH or LIBPATH is a null string.
(Bug reported by Richard Kiss.)
- Add a --profile=FILE option to make profiling SCons easier.
- Modify the new DVI builder to create .dvi files from LaTeX (.ltx
and .latex) files.
- Add support for Aliases (phony targets).
- Add a WhereIs() method for searching for path names to executables.
- Add PDF and PostScript document builders.
- Add support for compiling Fortran programs from a variety of
suffixes (a la GNU Make): .f, .F, .for, .FOR, .fpp and .FPP
- Support a CPPFLAGS variable on all default commands that use the
C preprocessor.
From Steve Leblanc:
- Add support for the -U option.
- Allow CPPPATH, LIBPATH and LIBS to be specified as white-space
separated strings.
- Add a document builder to create .dvi files from TeX (.tex) files.
From Anthony Roach:
- Fix: Construction variables with values of 0 were incorrectly
interpolated as ''.
- Support env['VAR'] to fetch construction variable values.
- Man page: document Precious().
RELEASE 0.05 - Thu, 21 Feb 2002 16:50:03 -0600
From Chad Austin:
- Set PROGSUFFIX to .exe under Cygwin.
From Charles Crain:
- Allow a library to specified as a command-line source file, not just
in the LIBS construction variable.
- Compensate for a bug in os.path.normpath() that returns '' for './'
on WIN32.
- More performance optimizations: cache #include lines from files,
eliminate unnecessary calls.
- If a prefix or suffix contains white space, treat the resulting
concatenation as separate arguments.
- Fix irregularities in the way we fetch DevStudio information from
the Windows registry, and in our registry error handling.
From Steven Knight:
- Flush stdout after print so it intermixes correctly with stderr
when redirected.
- Allow Scanners to return a list of strings, and document how to
write your own Scanners.
- Look up implicit (scanned) dependencies relative to the directory
of file being scanned.
- Make writing .sconsign files more robust by first trying to write
to a temp file that gets renamed.
- Create all of the directories for a list of targets before trying
to build any of the targets.
- WIN32 portability fixes in tests.
- Allow the list of variables exported to an SConscript file to be
a UserList, too.
- Document the overlooked LIBPATH construction variable.
(Bug reported by Eicke Godehardt.)
- Fix so that Ignore() ignores indirect, implicit dependencies
(included files), not just direct dependencies.
- Put the man page in the Debian distribution.
- Run HTML docs through tidy to clean up the HTML (for Konqueror).
- Add preliminary support for Unicode strings.
- Efficiency: don't scan dependencies more than once during the
walk of a tree.
- Fix the -c option so it doesn't stop removing targets if one doesn't
already exist.
(Bug reported by Paul Connell.)
- Fix the --debug=pdb option when run on Windows NT.
(Bug reported by Paul Connell.)
- Add support for the -q option.
From Steve Leblanc:
- Add support for the -u option.
- Add .cc and .hh file suffixes to the C Scanner.
From Anthony Roach:
- Make the scons script return an error code on failures.
- Add support for using code to generate a command to build a target.
RELEASE 0.04 - Wed, 30 Jan 2002 11:09:42 -0600
From Charles Crain:
- Significant performance improvements in the Node.FS and
Scanner subsystems.
- Fix signatures of binary files on Win32 systems.
- Allow LIBS and LIBPATH to be strings, not just arrays.
- Print a traceback if a Python-function builder throws an exception.
From Steven Knight:
- Fix using a directory as a Default(), and allow Default() to
support white space in file names for strings in arrays.
- Man page updates: corrected some mistakes, documented various
missing Environment methods, alphabetized the construction
variables and other functions, defined begin and end macros for
the example sections, regularized white space separation, fixed
the use of Export() in the Multiple Variants example.
- Function action fixes: None is now a successful return value.
Exceptions are now reported. Document function actions.
- Add 'Action' and 'Scanner' to the global keywords so SConscript
files can use them too.
- Removed the Wrapper class between Nodes and Walkers.
- Add examples using Library, LIBS, and LIBPATH.
- The C Scanner now always returns a sorted list of dependencies
so order changes don't cause unnecessary rebuilds.
- Strip $(-$) bracketed text from command lines. Use this to
surround $_INCDIRS and $_LIBDIRS so we don't rebuild in response
to changes to -I or -L options.
- Add the Ignore() method to ignore dependencies.
- Provide an error message when a nonexistent target is specified
on the command line.
- Remove targets before building them, and add an Environment
Precious() method to override that.
- Eliminate redundant calls to the same builder when the target is a
list of targets: Add a ListBuilder class that wraps Builders to
handle lists atomically. Extend the Task class to support building
and updating multiple targets in a single Task. Simplify the
interface between Task and Taskmaster.
- Add a --debug=pdb option to re-run SCons under the Python debugger.
- Only compute a build signature once for each node.
- Changes to our sys.path[] manipulation to support installation into
an arbitrary --prefix value.
From Steve Leblanc:
- Add var=value command-line arguments.
RELEASE 0.03 - Fri, 11 Jan 2002 01:09:30 -0600
From Charles Crain:
- Performance improvements in the Node.FS and Sig.Calculator classes.
- Add the InstallAs() method.
- Execute commands through an external interpreter (sh, cmd.exe, or
command.com) to handle redirection metacharacters.
- Allow the user to supply a command handler.
From Steven Knight:
- Search both /usr/lib and /usr/local/lib for scons directories by
adding them both to sys.path, with whichever is in sys.prefix first.
- Fix interpreting strings of multiple white-space separated file names
as separate file names, allowing prefixes and suffixes to be appended
to each individually.
- Refactor to move CompositeBuilder initialization logic from the
factory wrapper to the __init__() method, and allow a Builder to
have both an action and a src_builder (or array of them).
- Refactor BuilderBase.__call__() to separate Node creation/lookup
from initialization of the Node's builder information.
- Add a CFile Builder object that supports turning lex (.l) and
yacc (.y) files into .c files.
- Document: variable interpretation attributes; how to propogate
the user's environment variables to executed commands; how to
build variants in multiple BuildDirs.
- Collect String, Dict, and List type-checking in common utility
routines so we can accept User{String,Dict,List}s all over.
- Put the Action factory and classes into their own module.
- Use one CPlusPlusAction in the Object Builder's action dictionary,
instead of letting it create multiple identical instances.
- Document the Install() and InstallAs() methods.
From Steve Leblanc:
- Require that a Builder be given a name argument, supplying a
useful error message when it isn't.
From Anthony Roach:
- Add a "duplicate" keyword argument to BuildDir() that can be set
to prevent linking/copying source files into build directories.
- Add a "--debug=tree" option to print an ASCII dependency tree.
- Fetch the location of the Microsoft Visual C++ compiler(s) from
the Registry, instead of hard-coding the location.
- Made Scanner objects take Nodes, not path names.
- Have the C Scanner cache the #include file names instead of
(re-)scanning the file each time it's called.
- Created a separate class for parent "nodes" of file system roots,
eliminating the need for separate is-parent-null checks everywhere.
- Removed defined __hash__() and __cmp() methods from FS.Entry, in
favor of Python's more efficient built-in identity comparisons.
RELEASE 0.02 - Sun, 23 Dec 2001 19:05:09 -0600
From Charles Crain:
- Added the Install(), BuildDir(), and Export() methods.
- Fix the -C option by delaying setting the top of the FS tree.
- Avoid putting the directory path on the libraries in the LIBS
construction variable.
- Added a GetBuildPath() method to return the full path to the
Node for a specified string.
- Fixed variable substitution in CPPPATH and LIBPATH.
From Steven Knight:
- Fixed the version comment in the scons.bat (the UNIX geek used
# instead of @rem).
- Fix to setup.py so it doesn't require a sys.argv[1] argument.
- Provide make-like warning message for "command not found" and
similar errors.
- Added an EXAMPLES section to the man page.
- Make Default() targets properly relative to their SConscript
file's subdirectory.
From Anthony Roach:
- Documented CXXFLAGS, CXXCOM, and CPPPATH.
- Fixed SCONS_LIB_DIR to work as documented.
- Made Default() accept Nodes as arguments.
- Changed Export() to make it easier to use.
- Added the Import() and Return() methods.
RELEASE 0.01 - Thu Dec 13 19:25:23 CST 2001
A brief overview of important functionality available in release 0.01:
- C and C++ compilation on POSIX and Windows NT.
- Automatic scanning of C/C++ source files for #include dependencies.
- Support for building libraries; setting construction variables
allows creation of shared libraries.
- Library and C preprocessor search paths.
- File changes detected using MD5 signatures.
- User-definable Builder objects for building files.
- User-definable Scanner objects for scanning for dependencies.
- Parallel build (-j) support.
- Dependency cycles detected.
- Linux packages available in RPM and Debian format.
- Windows installer available.
|