Cons is a software construction system. A description appears under "Cons 1.0", below. $Id: CHANGES-2.2.0,v 1.1 2001/02/13 00:48:59 webcvs Exp $ Cons 2.2.0 ********** - Use the Digest::MD5 module in preference to the now-deprecated MD5 module. Use MD5 if Digest::MD5 isn't available. - Fix the Objects method to return meaningful path names even if the object isn't underneath the Conscript directory: a top-relative path name if it's underneath the Construct directory, an absolute path name otherwise. - Fix documentation: CCOM should be CCCOM. Remove POD directives that were showing up in a verbatim paragraph. The verbatim %[-%] example didn't work intuitively. Change misleading use of $ENV for an environment name, which doesn't work because it's special to Perl. - Missed some WIN32-specific -w warnings; now fixed. - File name fixes: Added canonicalization so dir//file and dir/file refer to the same file. Simplified lookups in the root directory to avoid reporting /bin/cat as //bin/cat. - Fix a bug that wouldn't allow SUFOBJ to have more than one dot (that is, no object files with names like .arch.o). - Die with an appropriate message when someone tries to Export ENV or any other special Perl variable that can only exist in the main:: package. (Bug reported by Johan Holmberg and Eric Brown.) - Rework Conscript variable namespace maintenance to allow external packages to be used. Remove variable names from the script:: namespace instead of undef'ing their values. Restore names whenever we execute perl code instead of a shell command. (Based on work by Johan Holmberg.) - When using the -t option, change how the top is located to avoid calling dir::init() too early. This was causing Cons to use full path names for files and causing needless recompiles when jumping back and forth between using -t and not. (Based on a mailing-list patch by Wayne Scott.) - When using the -t option, emulate make by printing a "cons: Entering directory `xxx'" message when we chdir to the Construct directory, to allow the emacs compile feature to keep track of where files with build errors really are. (Based on a mailing-list patch by Wayne Scott.) - Allow the Depends method to take an array ref of targets to specify multiple target dependencies at once. (Bug reported by Zachary Deretsky.) - The QuickScan method's PATH was hard-coded to use ':' as the separator. Fix to use ';' on Windows NT, or to use an array ref of directories. (Bug reported by Zachary Deretsky.) - Fix the SourcePath method so it can process and return an array. Contributions from Gary Oberbrunner - Support executing perl code instead of shell commands to build a target. Cons 2.1.2 ********** - Unlink after rename of similarly named files, per Unix98. (Reported by Bradley White.) - Allow %% to insert a single % anywhere in a command line, even when surrounded by non-whitespace. A lone % still gets passed through untouched, but a lone %% now becomes %. - Cons (and all tests) are now completely Perl -w clean. - Add support for changing directory to the containing directory of Conscript files, controlled by a Conscript_chdir() method, and disabled by default (preserving current behavior). This allows file globbing via Perl's <*.c> syntax. - When building all targets in a directory, explicitly skip '.' and '..' instead of skipping all entries begining with '.', to allow specification of targets with initial '.' names. - Use $Config{} to fetch the platform's file suffixes. Put these in a platform-independent default environment. Put the rest of what used to be the default environment into a separate-but-equal UNIX defaults "overrides" hash, like the Win32 overrides. This will all help future portability to other platforms. - We now call $env->_subst() to expand variables from the construction environment in source and target file names for all cons methods. Existing tests have been modified to verify this for all tested methods. (Bug reported by Johan Holmberg.) - Change the case-insensitive mapping for initial drive letters from lower-case to upper-case. This better conforms to the canonical Win32 representation. - Make futil::copy more robust: Use chmod() to make the file writable before calling utime() (permissions govern the ability to modify file times on some operating systems), and then chmod back to the desired mode if needed. - Fetch a command's exit status by looking at the proper upper-order bits on Win32, too. We were reporting an exit status of 1 as 256, for example. Move where this happens so the WIN32 logic is grouped. - The internal File::Spec::splitpath method wasn't recognizing UNC volume names; now it does. (Bug reported by Bruce Leverett.) - Add a file::addsuffix call to the Program method so it can append SUFEXE if it's not already there, like the Library method appends SUFLIB. This will increase Construct/Conscript file portability by allowing people to drop the ".exe" from the Program specification, like they do with ".lib" for libraries. (Reported by M. C. Srivas.) Contributions from Johan Holmberg - Make Cons execute cleanly under "use strict" (-Mstrict). Cons 2.1.1 ********** - First separate development release. - Specifying a directory target on the command line wouldn't work with -t because it didn't add the updir entry ('..') when it re-blessed the target from a generic entry to a directory. (Bug reported by Damien Neil.) - Executing cons -t from the top level directory unnecessarily prefixed all targets with the current working directory path name. No longer. - Handle WIN32 case-insensitive initial drive letters (C: is the same as c:). Add an internal File::Spec::case_tolerant method (parallel to the real interface) to decide whether we should lower-case the volume name. (Bug reported by Greg Spencer.) - Add file name and line numbers to the error messages for ignoring a non-existent Conscript file and attempting to build a target two different ways. Contributions from Johan Holmberg - Change an explicit check for "file" targets in a directory being built to a less-restrictive check for any non-"dir" targets. This preserves existing behavior if the target is an "entry" (as can happen via the Depends directive). Contributions from Damien Neil - Fix %[ %] processing to match multiple whitespace characters and suppress zero-length arguments. - Remove "use File::Spec" since we ship our own internal copy. Contributions from Gary Oberbrunner - When using -d, add a "Rebuilding" line to the output to identify what's being rebuilt (and, implicitly, what's causing the rebuild). - When computing the signature of a file's contents, add a binmode() call to the file handle so end-of-file character values (like ^Z on WIN32) won't prematurely terminate signature calculation. Contributions from Juan Altmayer Pizzorno - In the Win32 'CXXCOM' command, change the '-c' to '/c' for consistency. Cons 2.0.1 ********** - Fix a QuickScan regression: CODREFs that return arrays broke because the calling context changed from array to scalar. Keep it in array context and use grep to weed out null entries. - The map{} function SplitPath returned was using @_, not $_, so it would return multiple copies of the whole list, thereby only working for a single argument. - Fix the cons.bat file copyright comments. (pointed out by Juan Altmayer Pizzorno ) - Add CXX* default rules for win32. (pointed out by Juan Altmayer Pizzorno ) - Documentation fix in "Adding new methods" section. (pointed out by Juan Altmayer Pizzorno ) Cons 2.0 ******** - Release Version of 1.8b2 (see 1.8b2 for all the changes) - Redo the copyright to be GNU General Public License. - Integrate the tests from the cons-test suite into the cons release, creating separate tar files with and without the tests. Cons 1.8b2 ********** Contributions from Wayne Scott - Create subdirectories in the Cache directory if they don't already exist. - Don't match #include delimiters in comments on the same line. - Prevent scan::quickscan::scan from adding null entries to its include-file list. Contributions from Damien Neill - An initial '@' on a command line suppresses its printing (a la make). - Make Cons realize that topdir is part of the file system, allowing building/installing in directories more than one level up. - Add support for rewriting portions of the command line enclosed by %[-%] by passing them to a named code ref in the Cons environment. - Add a -t flag to walk up the directory hierarchy looking for a Construct file, allowing invocation from child directories. (Contributed with Greg Spencer.) Contributions from Brad Garcia - Make the default environment '%LINK => '%CXX', which in turn transparently maps to '%CC' for anyone not using C++. Contributions from Greg Spencer - Add support for %:b, %:s, %:F and %:a suffixes on pseudo-variables. - Add Win32 default environment overrides for Microsoft VC++ 6.0. - Add a -t flag to walk up the directory hierarchy looking for a Construct file, allowing invocation from child directories. (Contributed with Damien Neill.) Add hooks to builds an associated Linked subdirectory if -t is invoked from a source subdirectory. - Fix futil::install (and the other futil methods) so they warn, not die, and return failure on error. - Add a Precious method to suppress unlinking a file before building. Contributions from Eric Shienbrood - Fix the Objects method to return path names relative to the Conscript file. Contributions from Johan Holmberg - Bug fixes in new File::Spec logic for incorrect use of Boolean tests instead of string comparisons against ''. - Performance optimizations: fix caching values in dir::is_linked and futil::mkdir methods. - CPPPATH as an array ref wasn't properly expanding %-variables, causing missed dependencies. Contributions from Gary Oberbrunner - Have -d print the dependencies in-line with build. Identify what's a Target and what's a dependency we're Checking. Contributions from Steven Knight - Rewrite all path name manipulation using File::Spec so we're as portable as possible (at least between UNIX and NT). Add support for multiple file system volumes through a hash of $root nodes. - Due to incompatibility problems with some versions of File::Spec on some versions of Perl, create our own internal File::Spec class with methods cut-and-pasted from the real module, so people don't have to install an external File::Spec. - Rewrite "options" routine; now hash-driven for speed and readability. - Let Default be called more than once. Document it. - Rewrite the dir::lookup and dir::lookupdir methods to avoid changing a file node into a dir node if the names match. This was causing "Can't locate object method" errors. We now enforce a distinction between the two node types, so add a dir::lookupfile and dir::lookupdir methods and change calls as appropriate. If someone tries to use a dir as a file or vice versa, die and report the error with info about what's wrong, where we detected the conflict, and where the node was created. If a dir was created as a file via "FilePath," change it to a dir (preserve old behavior), but warn them that they should use "DirPath" instead. Add an empty 'entry' subclass for nodes which we don't yet know are files or directories. (Bug reported by Eric Shienbrood.) - Have srcsig return a '' signature, not die, if the file can't be read. - Fix a bunch of perl -w warnings. There are still a few warnings left. - Replace the hard-coded global FLAG_CHARACTER and LIB_FLAG_PREFIX values with INCDIRPREFIX and LIBDIRPREFIX values in the Cons environment, so people can simultaneously use multiple compilers/ linkers with different calling conventions. (Bug reported by Johan Holmberg.) - Documentation cleanup and updates. - Minor changes to make sure Cons still executes under Perl 5.003. Expand the testing to include Cons under Perl versions 5.00[345] as well as 5.6.0. Cons 1.7 ******** Contributions from Rajesh Vaidheeswarran - Add QuickScan documentation. - Add Argument passing from cons to Construct. - Remove modification history feature from cons due to duplication, and bloat. Contributions from Brad Garcia - Add ability to compile both C and C++ files using the same environment. Based off of code written by Michael Polis . Cons 1.6b1 ********** Contributions from Rajesh Vaidheeswarran - Fix futil::copy to return undef if unable to copy a target to the cache instead of aborting the build process. Cons 1.6a3 ********** Contributions from - Fix for Win32: [problem: 'require'ing Win32 won't work when Win32 module isn't installed, as is the case for a generic perl installation (not ActiveState)]. Contributions from Rajesh Vaidheeswarran - InstallAs modified to accept either a single file or a list of files as source and target. Cons 1.6a2 ********** Contributions from Rajesh Vaidheeswarran - Bugfix for Repository to add the path to INC to enable perl packages in the local tree to be used in Cons scripts. - Bugfix for SourcePath to return the correct path in a repositorey enabled build. - Add InstallAs method to link/copy a source file to any arbitrary target file name. - Move all the documentation to cons itself, and get rid of the pod file from the distribution. Users can now use perlpod on cons to see the docs. Cons 1.6a1 ********** Contributions from Steven Knight - Fixed a bug where .consign seems to be closed improperly when cons is terminated with a signal, leading to rebuilds of various targets that had already been built. Contributions from Rajesh Vaidheeswarran - New flag -q (for quiet) to be less verbose about what files were `Install'ed (or `Removed' when used in conjunction with -r). Cons 1.5 ******** Contributions from Steven Knight - Added Repository global function, similar to make's VPATH, and supporting functions: Local, Install_Local, Repository_List, Repository_Sig_Times_OK. - Added -R command-line option as a synonym for Repository. - Bugfix for SplitPath (when given a path with N components, it returned N**2 components). Cons 1.4a3 ********** Contributions from Rajesh Vaidheeswarran - Construction local help. Exported command: Help ; Cons 1.4a2 ********** Contributions from Bob Sidebotham: - LIBPATH, CPPPATH, and program search path ENV->{PATH} may all now be arrays. The old usage (colon separated strings) is deprecated, but still supported. In the old form, on Unix, ":"'s separate path components, and on Windows, ";" separates them. - PATH_SEPERATOR was finally changed to PATH_SEPARATOR Contributions from Steven Knight - Default target support has been added (see RELEASE for details). Cons 1.4 (alpha1) ***************** This release of Cons has a number of changes. Briefly, they are: - a QuickScan function that makes it trivial to set up simple dependency scanners by Bob Sidebotham. - improvements in signature calculation for better control of rebuilds - a caching mechanism for sharing derived files between builds - new global functions: UseCache, Salt, SourcePath, ConsPath. - some minor cleanup Cons 1.3.1 ********** This is a minor release with limited shared library support contributed by Gary Oberbrunner . Documentation is now maintained in pod format, thanks to the cons.pod file from Ulrich Pfeifer. Cons 1.3 ******** This is the first combined Win32 and unix cons contributed by Rajesh Vaidheeswarran . This contains some significant fixes that enables the same cons file to be used for both platforms. Cons 1.2 ******** This is the WIN32 port of cons by Chriss Stephens , Rajesh Vaidheeswarran and Jochen Schwarze . Cons 1.1 ******** This is a minor patch release to cons 1.0. This contains a number of minor changes, a bug fix affecting multi-target commands, and a couple of minor new features. A list of changes from 1.0 to 1.1 is included in the file CHANGES. There are no incompatible changes between 1.0 and 1.1. The NT support is working well here, but it still hasn't been integrated into an single version of cons. The changes are quite simple, and if anyone wants it let me know. Cons 1.0 ******** This is a Perl5-based make replacement, but does not provide make compatibility. You will need Perl 5.002 or better and the Perl MD5 Extension (MD5-1.6.tar.gz), available from CPAN. This program is known to work on a variety of platforms: it's in production use on versions of SunOS, Solaris, HPUX, AIX, and IRIX. The current program will not work correctly on Windows/NT, but we do have an internal version that does appear to work on that platform, but has not been well tested. If anyone is interested, contact me. PostScript documentation is in cons.ps. The following is an excerpt from the introduction in cons.ps: Cons is a system for constructing, primarily, software, but is quite different from previous software construction systems. Cons was designed from the ground up to deal easily with the construction of software spread over multiple source directories. Cons makes it easy to create build scripts that are simple, understandable and maintainable. Cons ensures that complex software is easily and accurately reproducible. Cons uses a number of techniques to accomplish all of this. Construction scripts are just Perl scripts, making them both easy to comprehend and very flexible. Global scoping of variables is replaced with an import/export mechanism for sharing information between scripts, significantly improving the readability and maintainability of each script. Construction environments are introduced: these are Perl objects that capture the information required for controlling the build process. Multiple environments are used when different semantics are required for generating products in the build tree. Cons implements automatic dependency analysis and uses this to globally sequence the entire build. Variant builds are easily produced from a single source tree. Intelligent build subsetting is possible, when working on localized changes. Overrides can be setup to easily override build instructions without modifying any scripts. MD5 cryptographic signatures are associated with derived files, and are used to accurately determine whether a given file needs to be rebuilt. Complaints, suggestions, kudos, etc. to: Bob Sidebotham cons-discuss@eng.fore.com FORE Systems Pittsburgh, PA.