Subversion Repositories DevTools

------------------------------------------------------------------------
Version: CURRENT                                     Released: 07-Apr-08
------------------------------------------------------------------------
Major changes:
  * MOS68K Toolset (Not MOS68KRM)
    Force compiler option -nOj
    The default compiler option (-Oj) has been seen to cause problems with some
    code. Problem reported/analysed by rparker and thunter.

  * MOS68K Toolset (Not MOS68KRM)
    Correct problem in disabling Global Optimization that was introduced in
    version 2.73.1000

Minor changes:
  * JATS makefiles
    Correct problem where a Production/Debug only build would create OBJ
    directories for both production and debug, and not clean them up.

  * JATS builds
    Allow ANT builds to be run in verbose mode to facilitate debugging
    The command "make all options=args" will run the ANT builds in 'verbose'
    mode.

  * JATS makefiles
    Extended the 'selector' used in all makefile directives - as the first
    argument. Added two non-platform related options:
        --Project=xxxx      True if the package suffix matches
        --Defined=yyy       True if yyy is declared with a SetValue or
                            SetList directive.

    ie: AddSrcDir ('--Project=sls' , 'sls' );
        AddSrcDir ('!--Project=sls', 'default');

  * JATS makefiles. MakeProject directive
    New packaging options to package up programs to be used as JATS plug-ins
        --PackageTool=xxxx
        --PackageToolProd=xxx
        --PackageToolDebug=xxx

  * JATS buildfile processing
    Generate a warning for build platforms that are unknown to JATS
    These may be the result of a user typo or an incompatible version
    of JATS.

  * JATS save_build utility
    Correctly handle autobuild branches that contain multiple checkouts, one of
    which may be reserved.

  * JATS gen_cots utility
    Correctly labels directories up to the VOB root.
    Displays the correct 'Source Path' in the Release Manager Information.
    Ignores the 'administration_view' as this is read-only

  * JATS sandbox (experimental)
    Ensure the AutoBuildTool does not use any sandbox

  * JATS release (cbuilder) utility
    Handle paths that have a trailing path separators.

  * JATS Makefile generation. Packaging directives
    Packaging directives that use the --Dir option have been modified
    such that the direction cannot use a a relative path.

    * Escrow tool
      Creates a simple HTML file that details all the packages with a short
      description.
    
------------------------------------------------------------------------
Version: 2.73.2000.cr                                Released: 06-Mar-08
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Corrected operation of GBE_PLATFORM, when building a GENERIC package.
      A GENERIC package can now be built independently of the value
      of GBE_PLATFORM.

    * MOS Toolset
      If only building for a production target, then don't generate an error
      if there is no debug data and code addresses specified.

      Use to build platform independent MOS Releases. Cannot have debug, but
      can have production (PIC) components.

    * Utility command: jats abt
      Parse and use -buildfile=xxx option

    * Utility command: jats extract -extractfiles
      The extractfiles option will now duplicate empty directories

    * Building ANT projects under JATS
      Ensure that the PATH is correctly setup so that ANT can locate
      utilities within the JAVA directory - for both Solaris and Windows.
      Previously only worked on Windows

------------------------------------------------------------------------
Version: 2.73.1000.cr                                Released: 21-Feb-08
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Jats Label Utility
      Correct use of '-norecurse' operation.

    * Jats command line under Unix
      Corrected problem when command line quoted arguments with a space are
      passed in. ie: -xxx="aaa bbb ccc"

    * Escrow tool
      Added totals to all the tables created in the HTML report

    * Platform MOS68KRM
      Rome builds. Modified compiler options to match the existing build system

------------------------------------------------------------------------
Version: 2.73.0000.cr                                Released: 20-Feb-08
------------------------------------------------------------------------
Major changes:
    * New Toolset: BORLAND
      The toolset uses the Borland C++ Builder 6 to build Borland Project
      files via the MakeProject directive.

      In this release there is no support for native compilation and linking.

      Details are provided in MASS-00166 JATS Reference Manual

Minor changes:
    * Extract/Release utility.
      Handle Source Path option with spaces by creating a config spec
      that can handle spaces

    * MOS Compiler
      The TMP directory used by the assembler will be created before the
      assembler is invoked. This will ensure that the directory exists.

    * Utility: create_dpkg
      Uses the first 'descpkg' file found. Allows packages that have embedded
      descpkg files to be copied.

    * AVR_IAR Toolset
      Added support for AT90SC144144CT - by David Payne.

    * JATS ANT command
      Better selection of the ant build file

    * Build directive: BuildVersion
      Extended the WinRc version file to allow the name of an icon to be
      embedded in the .RC file.

------------------------------------------------------------------------
Version: 2.72.2000.cr                                Released: 06-Feb-08
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Building JATS. Installer will set a+x in dpkg_archive

    * JATS rewrite. Remove the need  for the 'name=' attribute in the
      <project> field.

    * CCdiff utility
      Now ignores blank lines when generating a file difference report.

    * Escrow utility
      Quote 'path' in the generated extraction commands
      Allow escrow to be based on a single Release Manager package

    * Minor Perl-10 tweaks  

------------------------------------------------------------------------
Version: 2.72.2000.cr                                Released: 24-Jan-08
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Jats Tool: CCbc2 [DEVI-044908]
      Locates BeyondCompare through the Windows Registry. This allows
      BeyondCompare to be installed in places other then the default location.

    * Jats test runtime helper scripts set_PLATFORM.bat
      Windows. Batch file modified so that it doesn't exit the shell.

    * Jats wrapper
      If JATS attempts to cache itself and an error is reported by the caching
      utility, then Jats would fail without reporting an error message.

------------------------------------------------------------------------
Version: 2.72.00000.cr                                Released: 11-Jan-08
------------------------------------------------------------------------
Major changes:
    * Jats Release Mechanism
      Jats can now release itself. This is not the same a building all of its
      internal components, but it does mean that a new version of JATS can be
      released using the 'standard' mechanism.

      Jats releases will be tracked in Release Manager.

      A side effect of this is that the labelling scheme will change to align
      itself with Release Manager. ie: <package_name>_<package_version>.

    * Running Jats
      Running Jats from within a ClearCase view is being deprecated.
      Jats should be run from a package present in dpkg_archive.
      This may affect some windows developers.

      This release of JATS can be run from ClearCase, but generates a warning.
      Future versions will generate an error.

      Refer to MASS-00164 Installing and Using JATS.

Minor changes:
    * Perl Version Check
      Jats will generate a warning if the version of Perl in use is newer
      than the version used in test. Newer versions are not always backward
      compatible. Currently JATS has been extensively tested with 5.8.8.

    * Build Directive: BuildVersion
      This directive has been extended to allow the creation of a 'properties'
      file. This file may be used to pass version information into a an ANT
      build.

    * Jats Internals
      Minor fix to interwork with Perl version 5.10.
      Perl 5.10 has not been extensively tested - yet.

    * Jats Tool: CCbc2
      Added utility to use BeyondCompare (BC2) to compare files in two
      packages defined as ClearCase labels. The utility creates two dynamic views
      and starts BeyondCompare. The views are destroyed at the end of the
      process.

      Requires BeyondCompare to be installed in its default location.
      Only works under Windows.

      Use jats CCbc2 -help (or -man) for further details.
      
    * Jats test runtime helper scripts set_PLATFORM.sh
      Marked as executable, so that users can run them directly

    * Jats test runtime helper scripts set_PLATFORM.bat
      Uses SETLOCAL / ENDLOCAL to prevent environment variables being exported
      into the parent space. This mimics the behaviour of Unix.

    * Jats eprog
      Consistent cross-platform handling of programs found in the current
      directory.

    * jats tool jats_metrics
      A new utility that will be used by the Automated Build System to collect
      build metrics.

------------------------------------------------------------------------
Version: 2.71.6.cr                                Released: 18-Dec-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Jats Tool: create_dpkg
      Added options to allow the utility to sanity test the package name and
      version of the package being created. This is intended to be used by the
      automated build system. New options are:
        -pname=Package_Name
        -pversion=Package_Version
      
      Added option to allow the source package form to be tested, without
      transferring the package. New options are:
        -test

    * Jats Tool: CCdiff
      -output=filename now works. Previously only -out=filename worked.
      -vob=name does not generate internal message under unix

    * JATS Environment variables GBE_BUILDFILTER and GBE_PLATFORM can be either
      a space separated or a comma separated list.

    * Solaris Toolset
      Disable the use of purify, purecov and quantify when building shared
      libraries. Shared libraries are not supported by these tools. Executable
      programs are still supported.

------------------------------------------------------------------------
Version: 2.71.5.cr                                Released: 07-Dec-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    * WINCE toolsets
      Added a run-time test for the presence of the required toolset
      This will report an error if the required WINCE toolset has not been
      installed. This is better than obscure message generated by the compilers
      when header files cannot be found.

    * GenerateFiles directive
      If the generating tool can only be found in the users path, don't make
      it a prequisite under Windows. There are problems with spaces in pathnames
      that are difficult to solve.

    * MakePerlModule directive
      Extended the directive syntax to allow command line options to be passed
      to the the module builder.

    * Jats Tool: label
      Add the ability to label specific sub-directories (-dirs=name[,name]+)
      Allow the -up option to be used in conjunction with the  -files=xxx and
      -dirs=xxx options.

    * Jats Tool: release
      Corrected a problem when multiple ant builds where located within the
      build view. Now all ants builds will be perform.

      Expanded the operation of the '-build=name' option such that it can be
      used to limit ANT builds by specifying the name of the depends.xml file.

    * Jats Tool: CCdiff
      Added utility to provide difference reports in a format suitable to be
      uploaded to CodeStriker.

      Use jats CCdiff -help (or -man) for further details.


------------------------------------------------------------------------
Version: 2.71.4.cr                                Released: 30-Nov-07
------------------------------------------------------------------------
Major changes:
    * New Platform : MOS68KRM
      Building MOS for the 68K processor for Rome
      Requires the Microtec 4.5R compiler
      Similar to MOS68K, but has different optimization and definitions

Minor changes:
    * label utility
      Better handling of filenames with embedded spaces.

    * make package and install operations
      Improved the error detection and reported that may occur during a file
      transfer.

    * make clean up
      Improved the cleanup of generated files.

    * Jats Tool: jats_transform_file
      Tool that can be used within makefiles and test harnesses to perform
      minor file transformations such as:
        Copy, with optional rename
        Force Dos or Unix style line endings
        Perform simple TAG replacement

      Use 'jats jats_transform_file -help' for details

    * jats release utility
      Added the -extractfiles option to extract files without leaving a view
      in place.

    * escrow utility
      Added -extract option to assist in creating images of all files in
      the escrow, with a log file to summarize success/failure of the extraction.

------------------------------------------------------------------------
Version: 2.71.3.cr                                Released: 16-Nov-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Makefile generation
      Corrected a problem in the detection of a generated target
      Some JAVA builds were not correctly detecting the need to run the
      generate phase early.

------------------------------------------------------------------------
Version: 2.71.2.cr                                Released: 09-Nov-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    * GBE_PLATFORM operation
      Restored operation of GBE_PLATFORM. This feature is not encouraged.

    * Makefile generation
      Added a sanity check to generate a warning if a file is packaged, or
      installed, from more than one makefile.pl

    * Utilities gen_msproject, gen_dirlist and gen_metrics
      Modified to use generic interface to the makefile data

    * AutoBuilder support tool 'save_build'
      Check for users having placed locks on the build file and the autobuild
      branch. The locks will be removed.

    * jats_rewrite utility
      Better handling of DOS line ending under Unix

    * jats escrow utility
      Can now create a simple escrow build, and information, on a Release.
      Still handles an escrow based on an SBOM.

      Can be used to create an HTML report on unbuildable packages and
      inconsistent packages.

    * jats make help
      Corrected the list of target platforms to only show those that are
      available within the current build.

    * jats makefiles
      Modified the behaviour of jats when multiple instances of the
      MakefileGenerate() directive are found.

      If the MakefileGenerate() directive is found in the 'common' makefile.
      pl, then it will be ignored.

    * gcc toolset
      SharedLibries.
        The --Def=name option supports two types of def file
        The 'old' form is used if the name of the Def file ends in .def

        The 'old' form is created by the existing versions of mod_if.pl
        The 'new' form is created by tne new versions (daf_tools 25.1.5000.cr)
        of mod_if - if the name of the file does not end in .def.

      SharedLibraries and Prog (Experimental)
        New options:
            --MultiScan
            --NoMultiScan ( default)
            MultiScan will scan the libraries until no more undefined references
            can be satisfied. This may simplify linking of complex programs.


------------------------------------------------------------------------
Version: 2.71.1.cr                                Released: 16-Oct-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    PackageLib directive
    The construct "PackageLib( '*', @SHLIBS, @LIBS );" now works as expected.
    Packaging multiple libraries and shared libraries works as expected.
    Packaging multiple shared libraries works as expected.

    MakefileGenerate directive
    This directive should only be called once. JATS will now generate a warning,
    and not produce an erroneous, if the directive is invoked more than once.

    Multiple Parent detection
    A makefile.pl that is invoked from more than one other makefile.pl, or the
    build.pl, is counted as having multiple parents. This condition is
    normally treated as an error. When run by the Auto Built Tool, this
    condition will be treated as a warning.

    Solaris Toolset
    Added option '--WithMisalign' to the SharedLib directive.
    When used in conjunction with the 'misalign' CompleOption this option will
    cause a machine specific object file (misalign.o) to be included in the
    link.

    Programs that are created with 'misalign' will automatically include the
    misalign.o object file. The fact that shared libraries do not may be an
    indication that this is a bad thing to do.

    Make and generation of subdirectories
    Fixed an issue which caused created directories to have a bad timestamp.
    This could result in multiple attempts to generate the source dependency
    file.

------------------------------------------------------------------------
Version: 2.71.0.cr                                Released: 10-Oct-07
------------------------------------------------------------------------
Major changes:
    Makefile generation and make recursion
    Extensive changes to the makefiles that are generated by JATS and method by
    which JATS recuses through subdirectories during a build.

    Summary of changes:
        - Removed the use of 'make' to perform recursion over subdirectories
          and platforms. This has been replaced by a JATS program  that performs
          the same task - only a great deal faster and with a greater scope for
          flexibility.

          The user interface remains identical: jats make ....

        - Replaced the generated 'Makefile' with 'Makefile.gbe'. This is a text
          file that provides sufficient information to allow JATS to locate the
          interface directory and associated build information.

        - Significant speed up in determining the need to rebuild a makefile.
          On a large package this has been reduced from 30+ seconds to less
          than one second.

        - Significant speed up of large recursive builds through intelligent
          building of the 'make_init' target. This is only processed once for
          each platform type. Previously it was processed in each and every
          makefile. This make target is used, internally, to perform sanity
          testing of the compiler environment and to display the name of the
          toolset. It is an expensive operation.

        - Intelligent speed up of large recursive through better mechanism
          for creating required directories. These are now created on the fly,
          rather than via a slow recursive pass though all makefiles.

        - Better makefile rebuilding
          Makefiles can be rebuilt on the fly. The previous system was prone to
          detecting that makefiles needs to be re-built, but then not re-
          building them.

        - Detection of build file changes
          The make process will detect that the build file has been modified
          and that the component has not been rebuilt. This is a warning. It
          does not prevent the 'make' operation.

        - Quieter make output
          The 'Nothing to be done' message has been disabled.


Minor changes:
    MakeAnt Directive
    Allows ANT_HOME to be a path with spaces. ie: c:\Program Files\apache-ant-1.6.5

    JATS command "debug" and "prod"
    These now handle make arguments and options correctly. Thus the command:
        jats prod WIN32 OPTIONS=args
    Will correctly do a production build for WIN32 with command execution
    display. Before, the system would attempt to process prod_OPTIONS=args.

    CSHARP toolset
    Correctly detect missing compiler directories

------------------------------------------------------------------------
Version: 2.70.2.cr                                Released: 27-Sep-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    Java target. Resolve problem of multiple project builds when multiple files
    are generated.

    MakeAnt
    If the Ant build fails JATS will terminate.
    Previously JATS would continue until another error forced its termination.
    This is done through a better startup of ANT using the
    org.apache.tools.ant.launch.Launcher directly.

    MCR platform
    Create '.mod' files from the generated THX files.
    This is a MOS binary and can be download to the MCR devices.

------------------------------------------------------------------------
Version: 2.70.1.cr                                Released: 20-Sep-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    MakeAnt directive extended
    New option: --PackageBase
        This will pass the path to all packages specified with LinkPkgArchive
        directives to the build.xml file. Without the option the path will
        address a 'jar' directory within the package.

    New passed parameter: PACKAGEDIR
        This is the path to the output package that is being created by JATS
        Allows the ant build script to place artifacts directly into the
        package image being created.

------------------------------------------------------------------------
Version: 2.70.0.cr                                Released: 13-Sep-07
------------------------------------------------------------------------
Major changes:
    * Linux compiler
      Changed the linux compiler used to build Embedded Linux platforms
            DEVLINUX
                LINUX_EMU
                LINUX_ETX
                ARM9TDMI

            LMOS
                LMOS_LINUX_EMU
                LMOS_LINUX_ETX
                LMOS_ARM9TDMI


    This is a non-backwardly compatibly release.

    Do not migrate to this version of JATS if you are building against
    existing packages, until the underlying packages have been rebuilt.

    Packages created with the previous version of the compiler should not be
    mixed with packages created with the version in this release.
    Packages will be rebuilt with the new compiler as soon as possible.

    The new compiler will need to be installed on users VM's
    The compiler package is dpkg_archive/linux_gnu_tools/1.1.0000.cots
    The binary is:crosstool-gcc-4.1.1-glibc-2.5.tar.bz2
    This should be extacted, as root, into / with the (one line) command
         tar -xjf /net/auperaunx26/export/devl/dpkg_archive/linux_gnu_tools/1.1.0000.cots/
                    crosstool-gcc-4.1.1-glibc-2.5.tar.bz2 -C/

Minor changes:
    * Skipped 2.69 due to nature of major change


------------------------------------------------------------------------
Version: JATS_2.68.3                                Released: 28-Aug-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    * WIN32 CompileOptions to control use of precompiled headers
      Added a WIN32 specific compiler option to control the pre compiled
      headers.

        CompileOptions ('WIN32', 'PreCompileHdrs' );        (default)
        CompileOptions ('WIN32', 'NoPreCompileHdrs' );
      

------------------------------------------------------------------------
Version: JATS_2.68.2                                Released: 28-Aug-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Reverted changes made in JATS_2.68.1 to the library search path
      Although the search order is broken, we will need to live with it.

      Addressed the search order of /usr/lib under Solaris by adding a new
      AddLibDir option (--System) to add system paths. These will be searched
      last.

      For the record, the search order for header files and libraries is:

        1) As specified with AddIncDir/AddLibDir in the local makefile.pl
           or within any such directive with the --Local option

        2) Within the components 'local' directories. These are populated with
           InstallHdr and InstallLib directives.

        3) Within the 'interface' directory as populated by BuildPkgArchive

        4) As specified with AddIncDir/AddLibDir in the 'global' makefile.pl
           or within any such directive with the --Global option

        5) Within packages specified by a LinkPkgArchive directive


        6) As specified with AddIncDir/AddLibDir in any makefile.pl
           with the --System option

    * LMOS target platform
      Includes LINUX_ETX

------------------------------------------------------------------------
Version: JATS_2.68.1                                Released: 24-Aug-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Solaris Toolset
      Corrected library search order, such that /usr/lib is search after the
      dependent packages.

    * RunTest operation
      Added the current directory '.' to the PATH used when the test is run.

    * Csharp toolkit
      .dtd files are treated as resource files too

------------------------------------------------------------------------
Version: JATS_2.68.0                                Released: 20-Aug-07
------------------------------------------------------------------------
Major changes:
    * Trap use of uncontrolled versions of 'ant' and the Java Compiler (javac)

      It was discovered that a few old makefile.pl's where invoking ant and
      javac directly in order to build small Java components. This was
      normally being done in the guise of the WIN32 target. These packages
      were making assumptions about the version of Java on the users search
      path.

      JATS can invoke ANT and build Java based components using the MakeAnt
      directive and the JAVA platform. This method is controlled and
      reproducible.

      This release provides changes such that these packages will not build.
      This is better than building incorrectly.

      There are several aspects to the change
        1) JATS provides binaries (ant and javac) with an error message. If
           the user invoked ant/javac in a manner that involves searching the
           PATH then these will be used and report an error.

       2) A special command (jats abt) can be used to start up the Auto Build
          Tool in a manner that does not alter the PATH seen by the utilities.
          Moreover it does not alter the JAVA_HOME seen by the build. This is
          controlled separately.

Minor changes:
    * Sanitize the PATH environment variable
        Ensure the JATS bin directory is the first directory searched
        Remove duplicates
        Place non-existent components at the end of the PATH

------------------------------------------------------------------------
Version: JATS_2.67.1                                Released: 17-Aug-07
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Makefile sanity test
      Added a test to ensure that makefiles created on a machine of one type are
      not then run on a machine of a different type.

      This will prevent files created on solaris-sparc being used on a solaris-
      x86 machine.

    * Correct bug in RunTest
      RunTest now extends the PATH to include the local bin directory

------------------------------------------------------------------------
Version: JATS_2.67.0                                Released: 13-Aug-07
------------------------------------------------------------------------
Major changes:
    * RunTest directive
      Added support for running tests within the NUNIT test framework for the
      CSHARP target. In the process a generalized mechanism for accessing
      toolset specific test frameworks has been added.

      Changes to the directive to support a FrameWork.
        The use of a test FrameWork is signaled with the option
        --FrameWork=<name> If this is present then the raw name of the program
        under test will be passed to the framework. program.

        If a FrameWork is in use, then JATS will invoke the specified framework
        builder within the current toolset.

      When a framework is in place JATS will pass arguments of the form:
        '--Tag=Text' to the FrameWork. Other options are processed as normal.

      With in the Nunit FrameWork the program under test will be a DLL Nunit
      will only operate on a DLL. The DLL must have been created by the makefile
      containing the RunTest directive.

      The Nunit Framework supports the following options:
        --Uses=<Name>[,SubOption]+

        This option specifies other DLLs that are used by the TestDLL. They will
        be copied in to the test directory, and may be sourced from an external
        package or the components 'local' lib directory.

        SubOptions available to The --Uses directive are:
            --NonJats       This is not a JATS built library. It will not have a
                            P or D suffix.
            --Jats          (Default) This is a JATS built library. JATS will
                            select the correct library type for this build.

Minor changes:
    * New Cache cleanup mechanism
      When a package is consumed from the 'cache' a flag is updated within
      the cache. The cache aging routines use this file in preference to
      the descpkg file, thus it will prevent the aging of packages that are
      frequently used. The aging policy can be made more aggressive.

    * Save Build Utility
      This utility is used by the Auto Build System to save the 'build.pl' file
      used in a ripple build.

      The utility has been enhanced to detect  a reserved checkout of the
      build.pl. The checkout will be changed to unreserved - if possible.

    * Release Utility
      The 'jats release' command will now unlock any labels that it locked
      when an error is encountered.

      This simplifies the 'release' process as the developers label will be
      unlocked if a build error occurs.

    * Jats caching local copy of itself
      Fixed a bug which resulted in an "Use of individualized value" message
      being displayed a large number of times during the file transfer process.

    * Minor extension to allow plug-in directives to perform a processing step
      before the makefiles are created.

    * TestProg directive
      TestProg's are now built in exactly the same manner as Progs

    * Correct problem introduced in 2.66.1 with packaging of files with
      a 'space' or '$' in the file name.

------------------------------------------------------------------------
Version: JATS_2.66.1                                Released: 20-Jul-07
------------------------------------------------------------------------
Major changes:
    * New build target
            LINUX_ETX           - Support for Linux on an ETX board
            LMOS_LINUX_ETX      - Support for LMOS on the LINUX_ETX target

      These targets have also been added to the following pseudo targets.
            DEVLINUX
            LMOS_DEVLINUX

    * Internal utility dpkg_cache [Windows]
      Modified to remove use of system utilities to perform the the file
      transfer, after having problems the 'cp.exe' provided by JATS.

Minor changes:
    * Added utility class to provide directory searching
      To be used in JATS and JATS support tools

    * tweaks to the C# toolset
      Correct problem with filename that start with "n" as in .\not_nice.cs

      Create resource files with Fully Qualified Names derived from the .resx
      and .cs files.

      Handle Strong Key Names and creates wrappers to provide do the right
      thing.

    * Microtec ColdFire compiler
      Further attempts to get the compiler to place all of its temp files in a
      local directory. The compiler uses a large number of EnVars to control
      were it places temp files.

      Underlying problem is random compiler failures on big builds. Suspected
      interaction with other builds.

    * Release utility command
      Added a -tag=name option to allow the Auto Build Tools to create
      multiple instances of a static view. The tag is used to provide a unique
      component in the clearcase tag name.

------------------------------------------------------------------------
Version: JATS_2.66.0                                Released: 27-Jun-07
------------------------------------------------------------------------
Major changes:
  * Support for building CSHARP code
    Natively build C# within JATS using the Microsoft command line programs

    Supports the handling of .resx files

    Supports the creation of windows programs, console programs and shared
    libraries

Minor changes:
  * Unit Tests
    Allow test scripts to be PERL - with a .pl extension
    These will be correctly initiated under WIndows and Unix

    Correct warning messsage that is generated if a "CopyIn" file is also listed
    as a Script.


------------------------------------------------------------------------
Version: JATS_2.65.3                                Released: 11-Jun-07
------------------------------------------------------------------------
Major changes:

Minor changes:
  * WINCE Support
    Added WCEPA962_500 support. The WINCE target now includes this target.
    Complete list of WINCE targets is:
        WCEIT3000
        WCEPA961
        WCEPA962
        WCEPA962_500
        WCEPCM7220
        WCEPSION_500
        WCEPSPC_arm
        WCEPSPC_emu
        WCEX86A420
        WCEX86A500
        WCEX86A500_SOM4455
    

------------------------------------------------------------------------
Version: JATS_2.65.2                                Released: 06-Jun-07
------------------------------------------------------------------------
Major changes:

Minor changes:
  * WINCE Support
    Added WCEPSION_500 support. The WINCE target now includes this target.

  * Removed the following targets
        TP5600
        TP5600_ARM9TDMI
        TP5600_EMU
        LMOS_TP5600_ARM9TDMI
        LMOS_TP5600_EMU

  * Deployment
    Simplify access to build information during deployment

  * build.pl
    Better error check on a packages version number.

    The --forcebuildpkg has been extended to copy files on a Unix system, rather
    than to use symlinks. This simplifies remote builds.

  * Tool: gen_msprojects
    Has been extended to create either a Debug build (default), or a Production
    build.

        Eg: jats etool gen_msprojects -prod

  * Tool: escrow
     New features
     Given an rtag_id, report determine packages that are in the 'release' but
     are not in the SBOM.
                                                                                
     Prune "patch" package versions.
                                                                                
     Specify packages to be ignored.


------------------------------------------------------------------------
Version: JATS_2.65.1                                Released: 30-May-07
------------------------------------------------------------------------
Major changes:
  * Provided a mechanism by which JATS makefile.pl directives can be extended
    through modules provided by external packages. This will be used to reduce
    the dependancy on JATS of various packaging processes.

  * GenerateFiles
    Added the options:
        --UnknownPreq           - Will force the recipe to be run every time
                                  the generated files are required. May be used
                                  when the dependancies are too complex to
                                  describe. ie: Entire directory tree.

        --AutoGenerate          - Will not force the recipe to be run during the
                                  'generate' phase, unless the recipe generates
                                  source files. Allows recipes to be run very
                                  late. ie: when the dependent files are actually
                                  required.


Minor changes:
  * GenerateFile directive
    Added --Var(BuildRoot)

  * GCC Toolset
    Creating Shared Libaries with a 'Def' file. The library is now dependent
    on the Def file, such that changes to the Def file will cause the library to
    be rebuilt.

  * MakeAnt and MakeProject directives
    Preserve the order in which projects are built.

------------------------------------------------------------------------
Version: JATS_2.65.0                                Released: 16-May-07
------------------------------------------------------------------------
Major changes:
 *  Access to Release Manager and Deployment Manager databases
    The database location, user and password have been made configurable via
    environment variables.

    Reason: The Release Manager and Deployment Manager databases are being
            moved.

    This will affect users that:
        1) Use tools that access RM or DM
           Some tools that build deployable packages

        2) Use the ABT system
           The buildadm user, and the ABT scripts will be modified to provide
           the required configuration

    If you need to use tools that access RM or DM, outside of the ABT scripts on
    the build machine then you will need to add the following environment
    definitions to your .profile_bash, or jats.bat.
    Windows
        set GBE_RM_LOCATION=jdbc:oracle:thin:@auperaora03:1521:RELEASEM
        set GBE_RM_USERNAME=RELEASE_MANAGER
        set GBE_RM_PASSWORD=RELEASE_MANAGER
        set GBE_RM_URL=http://erg:8002/ManagerSuite/Release_Manager
        set GBE_DM_LOCATION=%GBE_DM_LOCATION%
        set GBE_DM_USERNAME=DEPLOYMENT_MANAGER
        set GBE_DM_PASSWORD=DEPLOYMENT_MANAGER
        set GBE_DM_URL=http://erg:8002/ManagerSuite/Deployment_Manager
    Note: GBE_RM_LOCATION will change in the near future.


  * New build platforms
        ARM9TDMI            - To replace TP5600_ARM9TDMI
        LINUX_EMU           - To replace TP5600_EMU

        LMOS_ARM9TDMI       - To replace LMOS_TP5600_ARM9TDMI
        LMOS_LINUX_EMU      - To replace LMOS_TP5600_EMU

        DEVLINUX            - To replace TP5600
        LMOS_DEVLINUX       - To replace LMOS_TP5600
        LMOS                - New platform that expands to known LMOS targets:
                              LMOS_ARM9TDMI, LMOS_LINUX_EMU, LMOS_WIN32

    Many of these targets are designed to replace the badly named platforms
    of TP5600_ARM9TDMI and TP5600_EMU. These will be removed in a future
    release.

    The GBE_BUILDFILTER for linux boxes may need to be changed to
         LINUX_I386 ARM9TDMI LINUX_EMU LMOS_ARM9TDMI LMOS_LINUX_EMU

    The TP5600* targets should be removed to make it obvious that these packages
    need to be converted.

  * Building Linux Device Drivers
    The hard-coded path to the Kernel Headers has been removed.
    Linux Drivers must be built with a suitable package to provide
    the kernel headers. This allows multiple versions of the linux kernel to be
    used for different targets platforms.

  * Sandbox support
    Embryonic support for building multiple packages in a common sandbox
    Will remain undocumented until fully implemented.

    New command: jats sandbox ...

Minor changes:


------------------------------------------------------------------------
Version: JATS_2.64.1                                Released: 03-May-07
------------------------------------------------------------------------
Major changes:
  * MakeAnt directive
    Added options to allow the and project to unit tests.

    New options
        --AutoTest=<target>            # Run as Automated unit test
        --UnitTest=<target>            # Run as Unit test

    This will invoke the ant build file, with the specified target, during the
    run_unit_tests phase.

  * Sandbox support
    Embryonic support for building multiple packages in a common sandbox
    Will remain undocumented until fully implemented

Minor changes:
  * jats build
    Use platform configuration information to prune platforms from the list of
    platforms that will be 'built'.

    This simplies the construction of a GBE_BUILDFILTER

    This information is not available for all supported platforms, but is
    available for psuedo platforms that transform into machine specific
    platforms. These include SOLARIS, LINUX, TP5600 and LMOS_TP5600

  * AVR_IAR Toolset
    Clean up 9 files that may be created by the USB license dongle.

  * JATS.BAT
    Example file now provides a default GBE_DPKG definition that assumes that
    the "V" drive is mapped to \\auperaunx26\devl. This allows access to both
    the dpkg_acrhive and the deploy_archive with the one mapping.

  * jats label
    Correct problem when locking a label in a specified VOB

------------------------------------------------------------------------
Version: JATS_2.64.0                                Released: 16-Apr-07
------------------------------------------------------------------------
Major changes:
  * New build platform:
        LMOS_TP5600
        LMOS_TP5600_ARM9TDMI
        LMOS_TP5600_EMU

    LMOS_TP5600 is a tag that will be expanded to the entire family of LMOS_TP5600
    supported targets. A common alias of LMOS_T5600 will be created to
    describe the group of platforms.

    LMOS_TP5600_ARM9TDMI and LMOS_TP5600_EMU
    These are LMOS based targets. The 'lmos' package must be used in order to
    build these targets.

    The LMOS_TP5600_ARM9TDMI can use components from the TP5600_ARM9TDMI,
    where no LMOS_TP5600_ARM9TDMI components are provided.

    The LMOS_TP5600_EMU can use components from the TP5600_EMU,
    where no LMOS_TP5600_EMU components are provided.

  * New build platform: WINCE
    This is a tag that will be expanded to all the known WINCE targets.
    Use of this platform will simplify the creation of components for
    consumption on all WINCE machines.

    The current list of WINCE targets is:
            WCEIT3000
            WCEPA961
            WCEPA962
            WCEPCM7220
            WCEPSION_420
            WCEPSPC_arm
            WCEPSPC_emu
            WCEX86A420
            WCEX86A500
            WCEX86A500_SOM4455

    The WINCE targets actually built will be affected by GBE_BUILDFILTER.

 *  JATS makefile.pl
    The package descriptor file, 'descpkg', will be packaged in all makefiles
    that contain packaging directives.

    There is now no need to explicitly package the 'descpkg' file, except in
    very unusual configurations.

Minor changes:
  * Directive: PackageFile
    Generate a warning if the source file name does not confirm to good naming
    conventions. The filename must not start with a '-' and must not contain
    an '='.

    Normally the result of an error in the directive. ie: "-Subdir=etc", instead
    of "--Subdir=etc".

  * JATS Internal utility: cmdfile
    Updated Linux and Solaris targets with a version of the cmdfile that
    provides a better error message for libraries that cannot be found.

    This version will display the library search path with one item per line,
    rather than all items on one, very long, line.

------------------------------------------------------------------------
Version: JATS_2.63.0                                Released: 5-Apr-07
------------------------------------------------------------------------
Major changes:

  * JATS release command
    Modified the configuration spec generated when a branching rule is
    specified. The change will ensure that directories are not branched.

    Rules are:
        Modify a file:      File will branch
        Adding a file:      Containing directory will not branch
                            File will be placed on a branch
        Add a directory:    Containing directory will not branch
                            New directory will branch

Minor changes:
  * JATS release command
    Added -noprefex option to allow the creation of a view directory without the
    user name being prefixed to it. This is useful in creating an escrow view.

  * JATS label command
    Detect and report parent directories that are checkedout when a label
    is applied. Previously these had gone unreported.

  * JATS make
    Undo previous change to preserve symbolic links while Packaging and
    Installing files. A problem was encountered when a file from a package
    was re-packaged.

  * JATS escrow
    Added a tool to generate information for creating an escrow drop.
    Use jats escrow -help for details

  * makefile.pl directive: MakeAnt
    This directive will create parameters to specify the location of external java
    packages that have been referenced via a LinkPkgArchive directive.

    This allows the build.xml to contruct a CLASSPATH to access JAR files in
    packages, without the overhead of copying the entire package into the
    interface directory.

  * build.pl directive: BuildPkgArchive
    Modified the processing of 'jar' directories.
    Directories of the form 'jar.<target>' will be transferred into the 'jar'
    directory as seen by the package.

    Intended use: Deployment of oraclient for Solaris 10

  * JAVA 6
    JATS now supports all versions of Java through the use of JAVA_HOME_X_Y
    environment variables. Where X andY specify the version of JAVA.

    The jats.bat and jats.sh example files only provide indication of 1.4, 1.5
    and 1.6 support, but all versions are now supported.

    The "jats vars -v" command will display all JAVA_HOME environment variables

  * Jats command: vars
    Extended to show a "*" for EnvVars that do not address a valid directory
    These indicate potential problems.

------------------------------------------------------------------------
Version: JATS_2.62.4                                Released: 20-Mar-07
------------------------------------------------------------------------
Major changes:
  * JATS create_dpkg + packageing shared libraries (Unix)
    When a shared library is created a simple symbolic link to the versioned
    libarry is also created.

    Previous versions of JATS would replace the symbolic link with a physical
    copy of the file. The effect of this is that when the shared libaries is
    'Installed', 'Packaged' and transferred into dpkg_archive there are two
    files, instead of one file and one link to the file (in the same directory)
    The Solaris shared libraries can be quite large, due to the debug
    information contained within the file.

    This version of JATS will preserve symbolic links when 'Installing',
    'Packaging' and transferring to dpkg_archive.

    The advantage of this will be significant reduction in disk space used
    within the build environment and dpkg_archive.

  * Building Perl Modules
    Modified the process to prevent the module builder attempting to modify the
    documentation on the build machine.

    Integrated the 'jats clean' operation.

Minor changes:
  * jats create_dpkg
    Added an option to create a built.generic file
    This is only used by the Automated Built Tools.

------------------------------------------------------------------------
Version: JATS_2.62.3                                Released: 28-Feb-07
------------------------------------------------------------------------
Major changes:
  * JATS JAVA build target
    The default behaviour of the JAVA build target has changed such that the
    default version of JAVA used will be 1.4.

    Previous behaviour was to use whichever version was specified by the EnvVar
    JAVA_HOME. This was not controlled, thus the build was not controlled.
    Problems occur when using the new AutoBuildTool as it uses Java 1.5 and this
    is then picked up as the default version.

    If a version, other than 1.4, is required then specify it within the
    build.pl file.

Minor changes:
  * jats release
    Ensure that the 'cleartool' command can be found in the users PATH
    Issue an error if it cannot be found.
    This error indicates bad DevEnv setup

    Added facility to create a view based on a config_spec, instead of a label.
    Such a view cannot be used to create a release. It is intended to simplify
    the creation of simple static views. The name of view is, by default,
    based on the name of the config spec. Use the -view=name option to change
    the name of the view.

  * GenerateFiles directive
    Added new --Vars() to allow packaging of JATS plugin tools.

  * MOS Toolset
    When using MOS fast intermodule calls the optimizer will preload commonly
    used memory addresses into a register BEFORE the GDP has been correctly set
    up. Use the following option to suppress this optimization

    Added: CompileOptions ('*', 'NoGlobalOptimization' );


------------------------------------------------------------------------
Version: JATS_2.62.2                                Released: 15-Feb-07
------------------------------------------------------------------------
Major changes:

Minor changes:
  * JATS environment
    Ensure that the true path of the Perl executable is present in the PATH
    environment variable. This allows build tool access to various perl utilities
    that are located in the Perl bin directory.

    Resolves issues in locating utilities such as pod2html

  * Use of GENERIC platforms
    Report an error if a GENERIC platform is mixed with any other platform
    specifier. GENERIC is used for packages that build on all machines because
    they do not use a compiler or linker. They simply contains files that need
    to be packaged.

  * Generated makefiles
    Solaris and Linux: Ensure that LD_LIBRARY_PATH is exported if it is used.

  * Generating MOS THX files
    Added option --BinaryImage to the SharedLib directive used to create MOS THX
    files. This option will create a binary image (.bin) instead of a .thx file.
    This is being used in the creation of BR Applets.

        SharedLib   ( 'MOS', "xxx", @OBJS, "--Rel=xxx.rel", "--BinaryImage" );

  * JATS release
    Correct the operation of the -path option under Unix

  * JATS extract
    New JATS command. This is the same as 'jats release -extract'

  * JATS Toolset
    Added support for the WinCe PSION (WCEPSION_420)
    This is a armv4i device using 4.20 of the WCE SDK    


------------------------------------------------------------------------
Version: JATS_2.62.1                                Released: 18-Jan-07
------------------------------------------------------------------------
Major changes:

Minor changes:
  * jats label
    Added a -vob=name option
    This allwos the label utility to create, lock, unlock, rename and delete
    labels without the user actually being located within the VOB. This option
    cannot be used in conjunction with operations that place labels on files.
    It can only be used for operations that manipulate the label.

    Added a -user=name option
    This extends the operation of the -mine operation to change ownership of the
    label to the named user.

  * jats release
    Displays the path to the view and the build file in a user friendly manner
    Under Windows it uses \, unless running under cygwin.

  * JATS build.pl
    BuildProduct supports the --Uses=xxxx construct on a per-target basis.
    ie:
        BuildProduct ('TP5', 'LMOS_TP5600_EMU', 'LMOS_TP5600_ARM9TDMI,--Uses=TP5600_ARM9TDMI');


------------------------------------------------------------------------
Version: JATS_2.62.0                                Released: 22-Dec-06
------------------------------------------------------------------------
Major changes:
  * GenerateFiles and RunTest directives
    These directives have been extended to allow a large number of makefile
    values to be added to the command lines,without resorting to knowledge of
    the makefile internals. ie:
        --Var(BuildName)
    will be expanded to (hen building MyPackage)
        -BuildName=MyPackage

    The complete list of Variables is provided in the JATS manual.

  * GenerateFiles
    Added a --Clean option to allow tools to be invoked in the 'clean' phase
    This allows external scripts to cleanup.

  * BuildPlatforms
    Restored operation of the --Uses option

Minor changes:
  * GCC Toolset
    Exports path to compiler. Used by scripts to build packages

Internal changes:
  * GenerateFiles
    Maintains the arguments in an array for simpler processing.

    --Shell is now processed by the 'make' shell rather then invoking an
    external shell. It will be the same shell, just easier to setup.


------------------------------------------------------------------------
Version: JATS_2.61.3                                Released: 14-Dec-06
------------------------------------------------------------------------
Major changes:
  * Caching JATS
    Added a mechanism whereby JATS can cache a copy of itself on the users local
    drive. This is applicable to windows.

    This mechanism will allow a user to address JATS via the soft-links in
    dpkg_archive and pick up the current version of JATS without the penalty of
    then using JATS across a slow(network) link.

    The EnvVar GBE_CACHE_JATS controls the operation of this feature.
    Set GBE_CACHE_JATS to one to enable the operation, but it will only be
    effective if JATS is being run from GBE_DPKG in the first place.

    Use: Build Machines and Windows Users

Minor changes:
  * Build directive: BuildAlias with --Target option
    Corrected a problem when the target name is a expanded platform name (ie:
    TP5600) that prevent correct expansion.

  * jats build
    If the user has not configured a cache, then do not attempt to cache
    packages. This will remove an annoying warning message for each package
    processed by the build.

  * jats build
    Modified the error messages generated when JATS fails to create the
    makefiles. The previous system would report failures while creating
    makefiles and, at the end of the process, it would generate a large error
    message to indicate the failure. This large message diverted the users
    from reading the other error messages resulting in confusion.

  * PackageFile, PackageLib, PackageProg and PackageHdr
    Detect and report as an error use of the --Dir=<Path> option where the
    Path is not specified.

    Most instances of this error will be where the option has been mis-used in
    conjunction with a package.pl file, or during transition from using a
    package.pl file. That change is detects errors where the user has specified
        --Dir=$Pinc
    but $Pinc is not defined.

  * Purify and Purecov under Windows
    Changes to correct the operation of Rational's tools when used on the
    Windows platform.

        - OPTIONS=purecov
            Forces the link operations to generate the relocation table required
            by 'purecov.

            Does not attempt to use purecov in the compiler tool chain
            This is required under Solaris, but not Windows

        - OPTIONS=purify
            Does not attempt to use purecov in the compiler tool chain
            This is required under Solaris, but not Windows.
            Under WIndows this option does nothing.


------------------------------------------------------------------------
Version: JATS_2.61.2                                Released: 27-Nov-06
------------------------------------------------------------------------
Major changes:
  * makefile.pl directive Platform
    This directive has been expanded to allow for the negation operation
    Example:
        Platform ('!MOSCF');
            Process makefile for all targets other than MOSCF
            This is the same as Platform ('*', '!MOSCF');

    Excluded platform will be processed after included platforms have
    been determined.

Minor changes:
  * Added the ScanList directive.
    This directive allows a list of files within an external package to be
    located at build-time.

  * Unix based systems
    If the EnvVar LD_LIBRARY_PATH was undefined, then a warning would be
    generated by make under some conditions. The warning has been removed.

  * MakeLinuxDriver
    Added a --Define=text option to allow "defines" to be passed to the
    driver being built.


------------------------------------------------------------------------
Version: JATS_2.61.1                                Released: 20-Nov-06
------------------------------------------------------------------------
Major changes:


Minor changes:
  * jats_rewrite tool
    Handle the BuildPreviousVersion() directive.
    This directive is only used within deployment scripts.

  * Internal package: RmPkgInfo
    Extract modified date when extracting package information

    Added the function getDependenciesHash() to provide a hash of all the
    dependancy information within a package.

    Added NO_WARN option to the classes 'new' method to supress warning
    messages.

------------------------------------------------------------------------
Version: JATS_2.61.0                                Released: 13-Nov-06
------------------------------------------------------------------------
Major changes:
  * makefile.pl directives
    Added directive: MakePerlModule to build and package CPAN style Perl Modules.

    Added directive: MakeLinuxDriver to build and Linux Device Driver.

    GenerateFiles.
        Added option: --NoGenerate to indicate that the directive does
                      not generate any tangible results. The command will
                      be run on every invocation.


Minor changes:
  * Added the jats version command
    Will only print out the current version of JATS

  * GCC Toolset (Used to build Linux)
  Added options to allow the generation of statically linked programs.
  There are two mechanism:

  Globally within the makefile.pl, or if applied in the common makefile.pl
  the option can apply to all programs being built.

  CompileOptions ( 'platform', 'StaticProgs' );     - Generate static programs
  CompileOptions ( 'platform', 'No_StaticProgs' );  - Default

  Within the Prog directive, the following options will override the global
  default.
    --Static    - Create a statically linked program
    --Shared    - Create a dynamically linked program

------------------------------------------------------------------------
Version: JATS_2.60.0                                Released: 03-Nov-06
------------------------------------------------------------------------
Major changes:
  * SunWorks Toolset
    Better determination of the location of the SunWorks compiler and library
    Does not use an environment variable to locate compiler libraries
    It is based on machine type.
    Uses the absolute path to the compiler  and does not use the user's PATH

    Corrects a problem on the Solaris10 installs.

Minor changes:
  * Perl DBI interface
    Removed the message showing database connection

  * JATS internal library
    Better handling of badly formed version numbers

------------------------------------------------------------------------
Version: JATS_2.59.0                                Released: 30-Oct-06
------------------------------------------------------------------------
Major changes:
  * GCC Toolset
    Altered the mechanism used to determine cross compilation
    Extended the cross compilers that can be handled by the toolset
    Removed the use of `uname`.

  * Added platforms
    TP5600                  ( Expands to TP5600_ARM9TDMI and TP5600_EMU )
    TP5600_ARM9TDMI
    TP5600_EMU

Minor changes:
  * descpkg file reader
    Allow handcrafted JAVA based packages that use tabs instead of spaces as a
    field separator.

  * JATS eprog command
    Can now start java programs encapsulated within JAR files

  * Microtec Coldfire compiler
    Force the compiler to create temp files within the interface directory.
    This is an attempt to solve a infrequent problem seen when multiple builds
    are being performed. The 68k compiler already had a similar fix to address a
    similar, but more pronounced, issue.

  * Atmel toolset (DEVI-031788)
    New Products: AT90SC7272C and AT90SC3232CS
        The AT90SC3232CS is identical to the existing AT3232
        The AT90SC7272C replaces the (as yet unused) AT72722

    Note: Products of AT3232 and AT90SC3232CS cannot be mixed.
          AT3232 is provided for backward compatibility.

------------------------------------------------------------------------
Version: JATS_2.58.0                                Released: 16-Oct-06
------------------------------------------------------------------------
Major changes:  Directive: RunTests
  * The --CopyIn option will always copy in the specified files

  * GCC Toolset (Shared Library Generation)
    Added option --Def=file_name to the shared library definitions

    When compiling Shared Library objects the -fPIC flag has been added.


Minor changes:
  * JATS wrapper script
    Added a sanity test to ensure that the JATS machine specific BIN directories
    have been setup. When JATS is installed the PostInstall script must be run
    to setup links to system programs.

------------------------------------------------------------------------
Version: JATS_2.57.1                                Released: 15-Sep-06
------------------------------------------------------------------------
Major changes:

Minor changes:
  * AT3232 toolset
    Added a --Type=PayLoadType field to the Prog directive for this target
    when creating .sxml files

  * Test Tool
    Added: jats_lib_scan.pl
    Use jats jats_lib_scan -man for detailed help


------------------------------------------------------------------------
Version: JATS_2.57.0                                Released: 12-Sep-06
------------------------------------------------------------------------
Major changes:
  * SOLARIS toolset: CompileOptions
    Added CompileOptions
        misalign            - Only allowed on sparc platforms
        no_misalign         - Default

        multithread         - Default
        no_multithread      - Disable multithread compilation and linking

  * SOLARIS toolset: CompileOptions
    Implemented the common CompileOptions

        prod_no_optimise
        prod_no_debuginfo
        prod_optimise
        prod_debuginfo

        debug_no_optimise
        debug_no_debuginfo
        debug_optimise
        debug_debuginfo
        
  * SOLARIS target: New Aliases
    Provided new ALIAS based in the underlying architecture
    Theses are:
        SOLARIS_SPARC
        SOLARIS_AMD
    These may be used to limit operations to only flavor of SOLARIS. eg: The
    utility 'rtc_patch_area' is only usable on sparc machines.

Minor changes:
  * AT3232 toolset
    Create .sxml files in conjunction with .s19 files

  * Jats build
    Altered the programs help mechanism to use perl POD.
    Extended the builtin help text.

------------------------------------------------------------------------
Version: JATS_2.56.3                                Released: 04-Sep-06
------------------------------------------------------------------------
Major changes:

Minor changes:
  * Utility InstallPkg as used by BuildPkgArchive()
    Better dection of directories that have been processed to reduce warning
    messages

  * PackageFile and PackageProg directives
    The --Machine and --Tool options have been modified to allow the JATS tools
    to be created in a directory that is related to GBE_MACHTYPE on which the
    tool is created, rather then the target platform type.

------------------------------------------------------------------------
Version: JATS_2.56.2                                Released: 28-Aug-06 
------------------------------------------------------------------------
Major changes:

Minor changes:
  * WIN32 and WINCE toolsets
    SharedLib operation. Added an option to allow the creation of a 'stub'
    library without creating the body of the library:
        eg: SharedLib ( 'WIN', 'MyStub' , '--Def=windef.def','--MutualDll','--Stubonly' );


  * MOS toolsets
    SharedLib operation. Added an option to allow the creation of a 'stub'
    library without creating the body of the library:
        eg: SharedLib ( 'MOS', 'MyStub' , '--Rel=lib.rel' , '--Implib=lib_stub','--Stubonly' );
        
  * JATS BIN directories
    Added the program 'gmake' as a soft link.
    gmake is required by some COTS packages that are being built from source
    using autoconf.

  * Generate directive
    The shared library search path is extended to allow the tools to locate
    all shared libraies (.dll/.so) in packages and the local area.

    Simplifies the use of Xerces during the build process.


------------------------------------------------------------------------
Version: JATS_2.56.1                                Released: 23-Aug-06
------------------------------------------------------------------------
Major changes:
  * Support for SOLARIS10_X86 and SOLARIS10_X64
    Initial release.

Minor changes:


------------------------------------------------------------------------
Version: JATS_2.56.0                                Released: 18-Aug-06
------------------------------------------------------------------------
Major changes:
  * Support for SOLARIS10_sparc32 and SOLARIS10_sparc64
    Initial release.

  * Packaging directives
    Added option --OsCommon to allow files and header files to be packed into
    a directory known to all platforms being built for a common OS.

    Currently this is only supported to target platforms based on
        SOLARIS
        WIN32

  * Removal of support for badly formed packages
    As of this release libraries that exist in the <packagename>/lib directory
    will not be available to JATS. These libraries are in the incorrect
    directory. They MUST be in a directory that indicates the intended purpose
    of the library. A .so library cannot be used on all machines ( linux,
    solaris-sparc, solaris-amd ... ).

  * Build Platform target name expansion facility
    The build targets of SOLARIS and LINUX are seen as expandable names. They
    will be expanded to suitable targets - depending on the host machine .


Minor changes:
  * Utility: JATS LABEL
    Ensure that the 'cleartool' utility can be found in the users path.
    Generate a suitable error message if it cannot be found.

  * Utility: JATS RELEASE
    Added a -root=dirname to allow the user to place the created view at a given
    location

    Added GBE_VIEWBASE to provide a globally configured mechanism for
    controlling the view location. Performs the same job as -root=xxxx

  * Utility genrc
    Added the company name to the copyright string

  * Utility: jats_save_build
    Added option: -new
    This option forces the saved file only a new branch.
    The option can be used to save a build.pl file onto a new project-specific
    branch. Useful when branching an entire release.

  * Utility: jats_rewrite
    Added options to allow project suffixes to be replaced.
    Use: Convert a .syd project to a .bej project.

 * Deprecated features: package.pl and tree.dir
   These two build features are being deprecated. They are not suitable for
   migration to other SOLARIS based platforms.

   The Package directives provide sufficient power to replace the package.pl
   features - in a uniform manner.


Internal Changes:
  * Major rework of the JATS BuildPlatform, BuildAlias an BuildProducts
    directives, together with the mechanism used to describe the platform builds.

    Introduced a CFG/<PLATFORM>.CFG file to provide:
        1) Platform information available at build time
        2) Dynamic platform names

  * Major rework of the 'SOLARIS' platform
    The SOLARIS platform will generate one or more targets, depending on the
    machine on which the platform is invoked.

    Consolidated a number of SOLARIS specific kludges and converted them into
    configurable items. These kludges are really on applicable to the
    SOLARIS8_SPARC32 platform. New SOLARIS builds will be well formed.

  * BuildPkgArchive operation
    Formalized a number of kludges in operation of the SOLARIS8 under sparc32
    platform. These are configured early in the build process and are no longer
    needed.

    A side effect of this work is that files from external packages may be
    located in 'SOLARIS', 'SOLARIS_sparc' or 'sparc' directories. The change
    should be transparent as the consumer tools should be able to handle
    files from all of these.
    
------------------------------------------------------------------------
Version: JATS_2.55.1                                Released: 17-Aug-06
------------------------------------------------------------------------
Major changes:

Minor changes:
  * WinCE toolset
    Added support for the adv_som_4455_wlan

------------------------------------------------------------------------
Version: JATS_2.55.0                                Released: 3-Aug-06
------------------------------------------------------------------------
Major changes:
  * Jats wrapper: Specify version of JATS to be used
    Added a -version=xxxx option to force JATS to use a specific version of
    JATS. The same operation can be achieved by setting GBE_JATS_VERSION.

    The required version MUST be found in one of the known archives.

    JATS will attempt to cache the version of JATS to assist in speeding up
    the operations.

    The version option MUST be the first option.

    The version option MUST be followed by a '--' option.
    This prevents JATS parsing other options and recursion issues.

    Example:    jats -version=2.54.3.cr -- build

  * Migrated the "jats install" functionality out of the jats wrapper script
    and into the create_dpkg utility. This is transparent to the user.

  * Utility: create_dpkg
    Added a '-quiet' option to allow use within scripts
    Extended the built-in help
    Added useful error messages
    Migrate code to a common error reporting mechanism

  * WinCE toolset
    Added support for the WCEPA962 target.

  * M16 toolset as used in building MCRFirmware
    Added a --MotOnly option to the Prog directives. MOT files 
    are used in the creation of bootstraps.

Minor changes:
  * JATS wrapper script
    Added a -ABT=xxx option to allow the Auto Build Tool to be invoked from
    the command line.

  * Utility: jats_rewrite
    Modified so that it will display changes. These will then be present in the
    ABT log so that a developer can see which packages have been rippled.    

Internal Changes:
  * Common Error Reporting
    Will use environment variables to control DEBUG and VERBOSE levels
    for individual users. A module reporting with a name of XXXX will use EnvVars
    of GBE_XXXX_VERBOSE and GBE_XXXX_DEBUG to control the debug and VERBOSE
    level.

    Force flushing after a "Question" is asked to ensure that the prompt is
    displayed.

    Enable autoflush for both STDOUT and STDERR.

  * Added JatsSystem module
    Common code for accessing system commands        
------------------------------------------------------------------------
Version: JATS_2.54.3                                Released: 17-Jul-06
------------------------------------------------------------------------
Major changes:

Minor changes:
  * BR Compiler toolset
    Add the include file search path to the link command line. Allows
    .def files to include other files.

  * IAR toolset
    Added AT7272 support

  * Tool: jats_manifest
    Added links to a suitable md5sum program on target platforms

------------------------------------------------------------------------
Version: JATS_2.54.2                                Released: 12-Jul-06
------------------------------------------------------------------------
Major changes:

Minor changes:
  * BR Compiler toolset
    Corrected a problem in flagging that the non-version-1 compiler was in
    use.


------------------------------------------------------------------------
Version: JATS_2.54.1                                Released: 29-Jun-06
------------------------------------------------------------------------
Major changes:

Minor changes:
  * Mictotec toolset
    Assembler files. Define DEBUG in debug builds and NDEBUG in production
    builds.

  * JATS Core
    Added GBE_ABT. This is used by the Auto Build Tool to indicate that an
    auto build is in progress. It may be used by various tools to modify their
    behaviour.

------------------------------------------------------------------------
Version: JATS_2.54.0                                Released: 22-Jun-06
------------------------------------------------------------------------
Major changes:
  * Removal of non-core deployment functionality from JATS.
    Deployment package will be affected.

    The build.pl file of deployment package will need to import deployment
    support with a BuildPkgArchive directive. ie:

        BuildPkgArchive ( 'deployfiles', '1.0.0.cr' );

    This version of deployfiles contains the same functionality as that provided
    by the previous version of JATS. Version 2 of this package will be the start
    of a deployment system that will provide support for building InstallShield
    packages.

 * Deployment support utilities must be run under JATS
   The environment required for the deployment support utilities is complex
   and is provided by the JATS wrapper script.

   This is a change in usage. Instead of running the program 'updatenodespec'
   the user will need to run 'jats updatenodespec'

Minor changes:
  * SubDir directive
    Added a sanity test to detect the case when a 'SubDir' directive specifies
    a directory from two different makefiles.

  * Tools: Dependancy generator mkdepend
    If an include file was referenced by a symbolic name, then the generated
    dependancy information would be wrong for all but the first occurrence
    of the file usage.

  * New utility: jats_manifest
    Used by the build system to generate and validate source files.
    Beta Release: Windows only at the moment

  * Unit tests under SOLARIS_sparc
    The LD_LIBRARY_PATH has been modified to correctly pick up libraries
    generated within the build and have been installed locally.

  * Default behaviour of JATS the wrapper script
    This has been changed. Previous unknown commands were passed to make.
    In this release unknown comamnds will be treated a 'etool' commands and 
    will execute a JATS extended command.


Internal Changes:
  * Code refactor
    Created JatsEnv to encapsulate functionality that was multiply defined.

  * Deployment utilities
    The Perl module Ignorelist.pm and the .ccignore file
    Changed the mechanism by which this module locates a .ccignore file.
    The .ccignore file has been moved to the same directory as the module and
    the module can locate the file.

    Previously the module required an environment variable in order to locate
    the file, which was in a fixed location anyway.

  * JATS core
    Removed the use of the environment variable PERLINC.

    Better parsing of descpkg files.

  * JATS core debugging: JatsError.pm
    Allow control over the debug and verbose messages of specific programs
    through the use of environment variables.

    A program reporting errors as "name" can be controlled via environment
    variables GBE_name_VERBOSE and GBE_name_DEBUG.

  * BuildPkgArchive operation
    Modified the subdirectories transferred with this directive to include:
        deployfiles     - as used by the deployment system
        tools/scripts   - as used by perl based extensions

  * Make environment
    Extended the PERL5LIB path seen by perl programs executed under make to
    include 'tools/script' directories that contain Perl Modules.
    

------------------------------------------------------------------------
Version: JATS_2.53.2                                Released: 13-Jun-06
------------------------------------------------------------------------
Major changes:
  * Deployment. GetMassInstId.rul (From George Christidis)
    Added support for SILENT_MODE


------------------------------------------------------------------------
Version: JATS_2.53.1                                Released: Not release
------------------------------------------------------------------------

Not Released.
This label waas used as a place keeper. This version was not used as a basis
for JATS_2.53.2. Its much closer to JATS_2.54.0.


------------------------------------------------------------------------
Version: JATS_2.53.0                                Released: 11-Apr-06
------------------------------------------------------------------------
Major changes:
  * Deployment Scripts: Release Manager Database Access
    The mechanism for communicating with the Release Manager Database has been
    radically replaced.

    A test tool has been added to prove connectivity to Release Manager.
    Usage:
        jats etool test_rmconnection

    The pervious scripts used DBI::ODBC to communicate with the Oracle
    Database that contains Release Manager. There were a number of problems with
    this solution:
         - Required the installation of two Perl Modules
         - Required the installation of an Oracle client
         - Required the use of an ODBC bridge machine when used on Solaris
         - Support for Perl within Oracle appears to be on the decline

    The solutions uses a Java application and Java's jdbc. The oracle:thin
    client is used as this does not require any installation or configuration in
    order to work.

    JATS overrides Perl's DBI package with a package of the same name, but
    reduced functionality.


Minor changes:
  * makefile.pl directive: SetValue
    Added a '--' option to disable and enable parsing of options.
    This allows a value with leading '--' to be set.

  * makefile.pl directive: SetList
    Added this directive to formalise the creation and processing of lists
    within the makefiles.
        Options:
            --NoWarn                    Disable name clash warnings
            --Project=xxxx[,xxxx]+      Add to list in selected projects
            --Unique                    Add only if not already present
            --Clear                     Clear list, before adding new items
            --Append                    Append items to list (default)
            --                          Disable/Enable option parsing
        Useage:

    SetList ('*', 'LibList', 'lib1', 'lib2', '--Project=syd');
    SharedLib ('*', 'MyDLL', @OBJS, @LibList );

  * Makefile.pl directive: RunTest
    Corrected the option of the --CopyIn=file option where the specified file
    is not in the current directory.

  * Jats Command: ant'
    This command has been extended to make use of the -buildfile=xxxx option
    to allow multiple buildfiles to be differentiated.

    eg: jats -buildfile=MyPackage ant

  * TOOLSET: DAFBR Compiler support
    Modified the toolset to support an optimisation feature of the next
    generation of the daf_br_compiler. These will be enabled if the major version
    of the package containing the compiler is greater the "1". ie: 2.0.0.cr

  * Interface helper files: set_XXXX.bat/.sh
    Added provision to process user command arguments.
    Thus

        set_WIN32.bat prog

    will set the WIN32 environment and run the command: prog
    

------------------------------------------------------------------------
Version: JATS_2.52.2                                Released: 30-Mar-06
------------------------------------------------------------------------
Major changes:

Minor changes:
  * Addressed issue with BUILDNAME, an internal variable.
    Due to the use of these 'raw' values in user build.pl's they need to be
    maintained. Previously the values may or may not have had a project
    extension. It was bad. Now:
        $(BUILDNAME) contains two or three space seperated fields - always

  * m16c Toolset - MCRFirmware
    Force the generation of .thx and payload files when the .bin files are
    created. Previously this only occured in the packaging phase.

Internal changes:
  * JATS toolsets
    Added a feature to allow a toolset to flag additional files that get created
    as a part of a "Prog". This allows a "Prog" definition to generate a
    number of files, some which may be packaged.

    Previously such files where only generated during the packaging phase. Now
    they will be generated during the make_prog phase - with the other programs.

------------------------------------------------------------------------
Version: JATS_2.52.1                                Released: 29-Mar-06
------------------------------------------------------------------------
Major changes:
  * Jats command: etool
    Extended to allow execution of deployment tools. This allows the deployment
    tools to use the JATS core perl modules.

  * Address issues with the use of BUILDVER and ScmBuildVer
    Due to the use of these 'raw' values in user makefile.pl's they need to be
    maintained. Previously the values may or may not have had a projectt
    extension. It was bad. Now:
        $(BUILDVERSION) contains the project extension - always
        $ScmBuildVersion does not contain a project extension - always

Minor changes:


------------------------------------------------------------------------
Version: JATS_2.52.0                                Released: 27-Mar-06
------------------------------------------------------------------------
Major changes:
  * JATS environment variables
    Added GBE_DPKG_STORE
        Optionally addresses a dpkg_archive store. This is intended to allow
        read only access to a remote repository. The GBE_DPKG_STORE will be
        searched after GBE_DPKG. It will be searched last. JATS, be default,
        will not publish packages in this repository.

        Uses: Seed repository for a complete build
              Remote repository

    Added GBE_DPLY
        Optionally addresses a Deployment Archive. This is only used in the
        placement of deployment packages. This value may be project specific.

  * MOS_MRI toolset
    Changes the mechanism used to link against the compiler RTL.
    Previously the RTL was included multiple times in the link order. This
    created problem with daf_dsi as the function 'time()' was being satisfied by
    the RTL before being satisfied by the user libraries.

    The compiler RTL is now treated as a library of last resort. It will be
    processed once and it will be processed last.


Minor changes:
  * JATS utility: build
  * JATS utility: cache_dpkg
    Extended the package search algorithm to locate a package within
    GBE_DPKG_STORE. This archive will be searched last.

  * JATS utility: gen_cots
    Ensure label is not locked
    Add option to allow user to specify source directory other than a package
    that already exists in dpkg_archive.

  * JATS directive: PackageFile
    Now supports --Prod and --Debug options to limit the packaging process
    to a specific type of build.

  * JATS directive: GenerateFiles and RunTests
    Added a --PackageInfo() replacement tag to allow package version information
    to be extracted and passed to generator programs.
        ie: --PackageInfo(sysbasetypes,syd,--fullversion)

    Extended the --PackageBase() replacement tag to work with packages such as
    sysbasetypes, where there is a .cr and a .syd type.
        ie: --PackageBase(sysbasetypes,syd)

  * JATS utility: release
    Under windows, ensure that the directory C:\Clearcase exists. There have
    been installations of Clearcase where this is directory does not exist.

  * JATS utility: label
    Added option: "-comment=Text" to allow a comment to be added to a label,
    when it is being created.

Internal Changes
  * JATS utility: create_dpkg
    Refactored code to use JATS DescPkg class.

    Added options to allow packaging to the various archives. This is of no use
    to the normal developer, but will be used within the complete build system.

  * Factored out the parsing of the BuildName directive
    This process was being done in 3 locations - and there were getting
    different results.

  * ToolsetRequire directive
    This has been extended to allow JATS to locate Toolset extensions within
    packages. They should be placed within the tool/scripts directory

------------------------------------------------------------------------
Version: JATS_2.51.0                                Released: 15-Mar-06
------------------------------------------------------------------------
Major changes:

  * MCR toolset
    Generate CD payload files in conjunction with the .BIN files

------------------------------------------------------------------------
Version: JATS_2.50.0                                Released: 15-Feb-06
------------------------------------------------------------------------
Major changes:
  * WIN32 utilities
    Replaced a number of the Windows utilities ( cp, rm, mv ...)
    with versions from the GNUWin32 project.

    The 'cp' previously used could not recursively copy large directories
    under Windows Server 2003, when both the source and destination are on the
    same drive. ( dpkg_cache of ace ).

Minor changes:
  * BuildVersion
    The definition of VERSION_BUILD within the generated version-defs.h file
    will have leading zeros removed, thus allowing it to be used within a 'C'
    program without the number being interpreted as an octal constant.

    The string form (VERSION_BUILD_STR) will retain the zeros.

  * Unix Builds
    Corrected several issues encountered when specifying the name of a static
    library or a shared library.

    JATS will prepend 'lib' to the user specified library name. Problems occurred
    when the user specified a library name that started with 'lib'. Now, on Unix
    systems, JATS will only prepend 'lib' if the library name does not already
    start with 'lib'.

  * BuildPkgArchive
    Since 2.45.0 JATS will only transfer files for the BuildPkgArchive, if
    they have not already been transferred. Added a test for the source
    package being updated and then forceing the copy to be repeated.

------------------------------------------------------------------------
Version: JATS_2.49.0                                Released: 10-Feb-06
------------------------------------------------------------------------
Major changes:
  * MOS_MRI toolset
    Corrected a problem with the dependencies between a .REL file and the target
    THX file. If the .REL files was modified the output THX file did not get
    regenerated. This was only a problem in cases where the .REL file was
    being manually maintained.


Minor changes:
  * MakeAnt directive
    Introduced a check to ensure that this directive is only used with a toolset
    that can handle an 'ant' build file. Currently only the JAVA toolset
    supports ANT builds.

  * BuildPkgArchive directive
    Correct problem in the caching of BuildPkgArchive packages in the case where
    there is no GBE_DPKG_LOCAL on the machine.

  * Label utility
    Added a 'files=filename,filename' option to allow only specified
    files to be labeled.

  * Build. Parsing descpkg files
    Corrected problem in which Java Manifest files were not parsed correctly
    on Solaris.

  * Generated makefiles
    Fix a bug with the CompilerOptions that allowed a '0' definition to be set to
    nothing.

  * MOS Toolset
    Added 'CompileOptions' of CcSupervisor.
    This will set a MOS internal definition suitable for building specialised
    modules.

  * Utility: gen_cots
    This utility will create a JATS buildable package froma dpkg_archive entry
    and then check it in under clearcase.

    JATS etool gen_cots -man will provide only help.

  * Utilty cache_dpkg
    Detect and repair incomplete copy operations.

------------------------------------------------------------------------
Version: JATS_2.48.0                                Released: 24-Jan-06
------------------------------------------------------------------------
Major changes:
  None

Minor changes:
  * DEVI addressed
    DEVI-022055 JATS builds DLLs with wrong copyright symbol in version resource
    DEVI-022054 JATS puts "ERG Group test" in Product Name of Windows resource

  * Utility: release (cbuild)
    Added an option to create a view configured to work with a branching
    rule. A single branch can be named with the -branch option. eg:

        jats release -extract 'label' -branch SITS_LEGACY_BRANCH

    will create a view based on the named label, but suitable for creating
    a patch for Sydney Legacy work.

  * RunTest directive
    The 'PATH' that the test uses is extended to allow access to programs that have
    been installed with a InstallProg directive. This allows a test script to
    test a program that is generated elsewhere within the package.

  * PackageFile, Option --DirTree
    Support for filenames that contain a "$" or a ' ' within the
    --DirTree option. Implemented to allow entire JAVA class trees to be
    packaged under JATS

    Note: In general the use of a $ and space within a filename is not
          supported within JATS.

  * Jats utility wrapper
    Added an eprog option. The allows any program to be run within the
    sanitized environment provided by JATS.

    The specified program may be in the current directory or the user's
    PATH. If the program is a perl script then it will be run with the
    JATS perl interpreter, otherwise it will be processed by the system.

    Eg: jats eprog myscript arg1 arg2
    Eg: jats ant

  * Jats utility wrapper
    Added an 'ant' command. ( "jats ant" )

    This will run an ERG ANT build by scanning the current directory for a file
    called <ProjectName>depends.xml and then looking the a file called
    <ProjectName>.xml. Jats will then create 'auto.xml' based on the
    <ProjectName>depends.xml file and use ant to invoke the
    <ProjectName>.xml file.

    If the ERG build files cannot be found then ant is simply run and it will
    expect a build.pl file.

  * Jats utility wrapper
    Force the environment variable PERL5INC to be unset.

  * Jats utility: create_dpkg
    Simplify handling of ANT based projects. Look for the package within
    the build/pkg subdirectory, in the JANTS style.

  * Utility: gen_winrc (DEVI-022054)
    Added a "'-product=text'" option to allow the product name to be specified.

  * Build files
    Handle the java generated descpkg files. These are a Manifest format with
    ERG extensions.

------------------------------------------------------------------------
Version: JATS_2.47.0                                Released: 20-Dec-05
------------------------------------------------------------------------
Major changes:
  * BuildVersion directive in build.pl
    Correct a problem in the generation of version.c
    The function GetModuleInfo() would return a string with a trailing
    space when the 'array' mode was selected.

    This may cause module validation to fail.

Minor changes:
  * None

------------------------------------------------------------------------
Version: JATS_2.46.0                                Released: 08-Dec-05
------------------------------------------------------------------------
Major changes:
  * BuildProduct and BuildPlatforms directives
    Added option --Uses=NAME
    ie:
        BuildProduct    ( 'OBFTP,--Uses=TP5',    'MOSCF' );

    This will create a OBFTP_MOSCF platform that will 'use' TP5
    headers and libraries if none are specifically provided for the
    OBFTP. It is the users responsibily to ensure that the two build
    environments are compatible.


Minor changes:
  * BuildName option
    Modifications to allow the creation of COTS packages with buildnames
    that do not confirm to the ERG naming scheme (--RelaxedVersion).

  * jats.bat
    Ensure that GBE_BIN is not defined
    It will be set by the jats.pl to a fully qualified path.

------------------------------------------------------------------------
Version: JATS_2.45.0                                Released: 29-Nov-05
------------------------------------------------------------------------
Major changes:
  * BuildPkgArchive directive
    The operation of the BuildPkgArchive directive has been modified
    so that a package will only be installed once. This significantly
    speeds up multiple 'build' operations.

    If the package is being extracted from the 'local archive', then
    this mechanism is suppressed as packages in the local archive are
    considered as under development and are subject to change.

    If package cache is being refreshed, then the package will be
    installed a second time. Thus it is possible to force the package to
    be transferred into the 'interface' directory.

    A BuildTags directory is used to track packages that have been
    transferred.

  * Internal changes to factor common code into a group of packages.
    See notes below.

  * WIN32 toolset
    Allow the Microsoft preprocessor directive #import to operate
    correctly.

    Export the complete library search path into the build environment
    for all Microsoft command, not just the linker and library commands.

  * BuildVersion
    Modifications to allow the generation of version files for C#
    The mechanism has been extended to allow version information for
    other langauges as needed.


Minor changes:
  * Utility: gen_winrc.pl
    Will extracted build number from the patch number, if present.
    This information will be available to be placed into the generation
    version strings.

  * GenerateFiles directive
    Fixed a problem detecting programs that were not in the local
    package or an imported package.

  * Toolsets: MOS_MRI
    Generate an error if required tools are not found.
    Previously this condition would generate a warning.

  * BuildPkgArchive and LinkPkgArchive directives
    Ensure that packages are only included once. The previous check
    was half-hearted and could allow multiple packages of the same
    version to be included. This could result in badly formed
    makefiles and strange error messages.

Internal Changes
  * Started to factor out internal packages and place them into a common
    directory. This will allow common error handling thoughout the suite
    of utilities.

    Modified all utilities to utilize the common error reporting
    functions.

------------------------------------------------------------------------
Version: JATS_2.44.0                                Released: 18-Nov-05
------------------------------------------------------------------------
Major changes:
  * Generated makefiles
    Modified the windows shell to remove the use of the EXTENDED_LINE
    cache. This did not work. Modified the extend.lst file to ensure
    that sed did not process its arguments.

    This has been done to address a problem seen within test scripts
    within unit tests that use wildcard expansion. The windows shell was
    incorrectly processing:
        sed '-es~.*WIN32~~'
    The '.*' construct was being seen as a wildcard and the shell was
    then putting the argument into a command file - it was totally
    confused.

    NOTE: Attempted to remove use of EXTENDED_LINE, but this caused a
    breakage with the DOS based gcc compiler( ie:H8S and others).
    The construct
        -D__SOURCE__=\"name\"
    was corrupted somewhere. If the command is put in a command file,
    then it works.

  * MakeAnt directive
    Added option: --GeneratedFile=PathOfFile

    This option has the following effects
        1) Marks the file a source file. It is then known to JATS and
           can be used installed and manipulated.

        2) Schedules the processing of the ANT build to be done
           early - in the generated files phase.

    Intended use. The creation of packages with a JNI. The Java
    component needs to generate a header file early.


Minor changes:
  * JATS post-installation script
    Flag deployment tools and libraries as executable.

  * Detection of extension type is case insensitive for non-unix
    systems. Thus *.h and *.H files will considered header files in
    windows.

  * Build.pl rewrite tool
    Handle all variants of BuildName

  * Jats wrapper script
    Generate an error if the JATS configuration variables are not usable
        1) Contain spaces
        2) Start with a // - Remote drives must be mapped

  * Toolset
    Added a 'LINUX' platform.

  * JAVA toolset
    Ensure the that build file passed via MakeAnt contains the following
    directive:

        includeAntRuntime="off"'

    This MUST be used to ensure that ANT's classpath is not passed to
    the java compiler thus ensuring that the compiler does not use ANT's
    version of any JAR files that have not been specified by the user.

  * GCC Toolset
    Use -Map name to create map files as needed for GCC under Debian

  * Makefile generation
    When packages are used by name to resolve package location JATS
    has been modified to use the package name specified by the user.
    Previously JATS would use the package name found within the
    descpkg file. In cases where the descpkg file was badly formed the
    package could not be used.

  * Unit Tests
    The following environment variables are set:

        GBE_TYPE    - The type of build. Debug or production. This
                      will be set to either a 'P' or 'D'
                      
        GBE_HOST    - The host machine we are running on.
                      This will be set to 'WIN' or Unix'

    These variable should assist in the production of test scripts.

  * New makefile.pl directive: SetValue
    

------------------------------------------------------------------------
Version: JATS_2.43.0                                Released: 01-Nov-05
------------------------------------------------------------------------
Major changes:
  * New Platform : "MCR" using the Mitsubishi m16c compiler.

    Special features of this toolset.
    1) A .THX source file will be converted to an obtect file
       This allows processing of fonts within a THX file to be
       incorporated within the target image.

    2) Prog directive extensions:
       --Set=Name=Value
                The 'Name' is set to 'Value' at link time.
                This allows the location of program segments to be set

       --Ref=name
                The name of a Release file. If provided, it will be used
                to provide information that will be placed within the
                THX header. The version number will be ignored. It
                will be taken from the build version number.

Minor changes:
  * MOS Toolset
    Create the VisionClick files when the THX file is created.
    Previously the files were created when the THX was installed or
    packaged.

  * Src directive
    No generates a warning if no source files are located within the
    directive. This is normally the result of a missing platform
    specifier.

  * WIN32 runtime support
    Added the following 'Unix' style utilities to assist in testing.
        1) od       - dump files in octal and other formats
        2) cmp      - compare two files byte by byte

Internal:
    Added an extension to allow the target toolset to handle the "Prog"
    dependancy generation if required. This allow complex program
    generation mechanisms to be handled by the toolset.

------------------------------------------------------------------------
Version: JATS_2.42.0                                Released: 19-Oct-05
------------------------------------------------------------------------
Major changes:
    * BuildAlias directive
      Added options.
        --Define        - Does not create implicit platforms
        --Target        - Redeclares the alais as the list of all
                          platforms that are based on a given target or
                          targets.
      Eg:
        BuildAlias      ( 'LMOS,--Target', 'LMOS_WIN32', 'LMOS_linux_armv4' );
        BuildProduct    ( 'GAK',    'LMOS', 'MOS68K', 'MOSCF' );
        BuildProduct    ( 'PCP',    'LMOS', 'MOS68K' );

      Will export an alias of LMOS that can be used within makefile.pl's
      that will be the list of all platforms that have a target of
      'LMOS_WIN32' or 'LMOS_linux_armv4'.

      Note the dual use of LMOS within the example. This is intentional.
      The LMOS alias is used within the BuildProduct to simplify the
      specification of all the LMOS targets.


Minor changes:
  * Label utility
    Will generate a warning message if it labels more than one
    build.pl file

  * Package directives. PackageFile.
    Corrected a problem with wildcard expansion in which a --FilterIn
    needed to be specified in order for the --FilterOut to operate.
    Now all files in the tree are considered 'in' unless modified by the
    --FilterIn option.

  * jats release (cbuilder) utility
    Correct use of the -prodOnly and -debugOnly flags.
    The full name was not accepted; -debug and -prod was.

  * Location of descpkg file
    All makefile.pl's now know where the package descpkg file was
    created. This simplifies the process og packaging this file as it
    can be done within any makefile.pl.

------------------------------------------------------------------------
Version: JATS_2.41.0                                Released: 27-Sep-05
------------------------------------------------------------------------
Major changes:
  * RunTest directive
    Extended the options and operation of RunTest
    Additional options
      --CopyIn=file
        This will copy the specified file into the BIN directory before
        the test is run. The file will be marked as executable. This
        allows scripts and configuration files to be transferred into
        the test area.

    Additional operations
    The arguments passed to the script/program allow a number of
    transformations, similar to GenerateFiles. Transforms
      --File(xxxx[,flags])          - xxxx is a known file
      --Local(xxxx[,flags])         - xxxx is a file that has been Installed
      --PackageBase(xxxx[,flags])   - xxxx is a Package
    Allows flags:
      --dir         - directory part of the pathname
      --file        - file part of the pathname
      --abspath     - as an absolute path
      --absdrive    - as an absolute path with drive letter (Windows)

    Files and directories are prerequisites of the test. Their
    existence is tested.

  * Packaging Directives
    Added a --Derived option to support the packaging of derived targets
    such as LMOS.

        PackageHdr ('*', 'file1.h', '--Derived=LMOS');

    Will place file1.h into .../include/LMOS_WIN32

        PackageHdr ('*', 'file1.h', '--Derived=LMOS,sys');

    Will place file1.h into .../include/LMOS_WIN32/sys

  * JAVA 1.4 and 1.5
    Added support to the JATS JAVA platform to allow the user to specify
    the version of Java to be used to build a package.

        BuildPlatforms  ( 'JAVA,--Version=1.5' );

    The default will use the default machine version of JAVA.
    This may not be sutable for all packages.

    Non-default versions of JAVA require that an environment variable be
    set to the root of the JDK directory. These are:

      JAVA_HOME_1_4
      JAVA_HOME_1_5
    
Minor changes:
  * Script directive
    Scripts may be copied into the BIN directory for use by a test.
    These scripts are now always marked as executable.

  * JATS environment
    Ensure that all programs run under JATS in Windows have an uppercase
    COMSPEC envvar. Windows appears to define a mixed case one. Fixed in
    the JATS wrapper script.

  * Label utility
    Added -[no]checkout to control the labeling of checked out files.
    There are three modes of operation:
        1) -nocheckout      Checked out files are not labeled
        2) -checkout        Only checked out files are labeled
        3) Neither          All files are labeled.
    
        
------------------------------------------------------------------------
Version: JATS_2.40.0                                Released: 15-Sep-05
------------------------------------------------------------------------
Major changes:

Minor changes:
  * label utility
    Added -smartlabel option to unlock and lock the label - if it was locked.
    This options retains the locked state of a label.

  * AVR_IAR toolset
    Extended the 'Prog' directive to allow a Program Loader to be
    added to a program as it is created. The option is:
      --ProgLoader=name

  * Package directives. PackageFile
    Added support for packaging of directory trees.
    Options to do this are:
        --TreeDir=name
        --FilterOut=regexp
        --FilterIn=regexp
        --StripDir

    Only a single directory can be specified.
    Multiple filters are allowed.
    The directories must be within the current directory. It is not
    possible to search outside the subdirectory tree below the makefile.

    The filters allow elements within the directory to be selected.
    The filters are regular expressions. Examples:
    
      '--FilterIn=\.h$'         - Select all files ending with .h
      '--FilterOut=MyHeader.h'  - Except this one

    The --StripDir option will remove the TreeDir directory from the
    files. This allows the top level directory to be stripped off.
      

------------------------------------------------------------------------
Version: JATS_2.39.0                                Released: 14-Sep-05
------------------------------------------------------------------------
Major changes:
    * Make commands
      Consolidated the parsing of the OPTIONS arguments.

      The filter and nofilter options are globally applied to all tools
      sets. ie: jats make debug OPTIONS=nofilter

    * Label utility
      Generate a warning when attempting to label a symbolic link.
      Links are very hard to maintain in a reproducible manner.

Minor changes:
    * Toolsets
      Replaced the use of c:\WINDOWS and c:\Program Files with suitable
      variables and overrides.

      The make_init target is always run.
      This facility had been lost. The target was being used to provide
      compiler sanity testing, but had was not being reliably run.

    * Deployment
      Suppress testing of compiler existence when used in conjunction
      with deployment operations.

    * Release utility
      Add options to build only the debug or the production versions.
      The default is to build both. Note: User option may be further
      restricted by options within the build.

    * PackageLib, InstallLib and MergeLib directives in makefile.pl
      The use of @LIBS and @MLIBS in unix systems was causing a
      problem as these variables already had a 'lib' prepended to the
      list of libraries. These directives would add another 'lib' to the
      list of libraries under unix causing a mismatch.

      Corrected by stripping liblib from the names within these
      directives.

    * MakeProject directive
      If the project build fails the log file was not being displayed
      because 'make' stops when a command fails.

      The MakeProject operations have been modified to ensure that the
      log file is always displayed. The exit code of the build command
      is preserved.

    * Auto build utility jats-rewrite.pl
      Modified to support the rewrite of Java 'using' and 'project'
      statements.

    * Mugfile generation
      Added a --ThxDir=xxxx option to allow the THX and load files to
      be placed in the target package.
        

------------------------------------------------------------------------
Version: JATS_2.38.0                                Released: 01-Sep-05
------------------------------------------------------------------------
Major changes:
    * BuildVersion directive
      The 'defs' mode has been extended to create a file with a build
      number as well as a patch number.

      The patch number is decoded into a patch number and a build
      number.
                          
Minor changes:
    * AddFlags directives
      Added a --NoWarn option that will suppress the warning of
      duplicate flags being added.

    * GBE_CORE environment variable (Windows)
      Ensure that GBE_CORE has a driver letter. This allows use of JATS
      loaded into the same dynamic view as the user code.

    * Mug File Generation
      Added support to allow load files to include other load files.

   * 'cbuild' or 'release' command
     Added a -latestroot=xxxx option. This is a work around for the
     problem where the root level directory in the VOB has not been
     labeled. After using this switch add the label to the root
     directory.

     The need to use this this switch indicates that the view is NOT
     reproducible.

------------------------------------------------------------------------
Version: JATS_2.37.0                                Released: 22-Aug-05
------------------------------------------------------------------------
Major changes:
    * jats.bat and jats.sh
      Changes to include GBE_DPKG and GBE_DPKG_CACHE.
      Most importantly GBE_DPKG must be a single directory. It is no
      longer a list of directories.

      Removal of the setup of Microsoft Visual Studio 6. This is now
      done within the toolset.

      *** Update your jats.bat to follow the format in this release

    * JATS environment variables
      Redefined variable
        GBE_DPKG        - Now the MASTER dpkg_archive
                          Previously was a list that included the
                          dpkg_archive cache.

      New variable
        GBE_DPKG_CACHE  - Optional directory for a local cache of
                          the main dpkg_archive.

                          
Minor changes:
    * Utility: gen_packagelist
      Enhanced (thanks Ross) to allow PATH information for various
      target platforms to be extracted.

      Better support for Product families. This is only an issue
      for WIN32 derived families due to the generation of a list of
      libraries. The list now observes Product hierarchy.

    * Utility: release (cbuilder)
      Added -noruntests option too suppress the running of unit tests
      Units tests will still be run by default.

      Tighten the config specification used to build the sandbox. It has
      no LATEST rules. All directories and files MUST be labeled.

    * Utility: jats_rewrite
      Support ANT based XML files

    * Utility: create_dpkg
      Support ANT flavor Manifest dependancy files and pkg directory
      structure.

    * makefile.pl's
      GenerateFiles directive. Added a --Prog specifier to allow tools
      to be generated within the same script. Example:

            Prog('*', 'Myprog', @OBJS );
            GenerateFiles ('*', "--Prog=MyProg",
                                '--Prereq(infile)',
                                '--GeneratedCommon(outfile)' );

      RunTest directive. Added a --Auto option to flags tests that can
      be run within the Build Systems Auto Build environment. These
      tests will be run with the 'run_unit_tests' target. All tests will
      be run with the 'run_tests' targets. Only tests that confirm to
      the ERG "Unit Test Automation" guidelines should be marked as
      -- Auto.

    * Added a new make target: run_unit_tests
      This will be used by the build tool to run non-interactive
      unit tests within an automated framework.

    * Make run_test and run_unit_test operation
      The search path for DLL's or Shared Libraries is extended to
      include all Shared Libraries in the build package list as well
      as the local and interface directory. This allows tests to
      locate required Shared Libraries at runtime.
        
    * WIN32 targets built using Visual Studio 6
      The path to the compiler is setup within JATS. It is no longer
      imported from the users environment as the environment is
      indeterminate when multiple versions of Visual Studio are
      installed on the machine.

    * WINCE Targets
      The name of the SDK is case sensitive.
      The POCKET PC 2003 was incorrect



------------------------------------------------------------------------
Version: JATS_2.36.0                                Released: 03-Aug-05
------------------------------------------------------------------------
Major changes:
    * WIN32 platforms
      When building Microsoft project files the PATH environment
      variable is extended to include the DLL path of imported packages
      and installed packages.

    * Building DLL or EXE with the --NoPDB option will disable the
      generation of debug information so that the  linker does not
      create CV style debug information in the target.

    * UNIX Platforms (SOLARIS and LINUX)
      Modification to allow BuildProduct and BuildPkgArchive to
      interwork. Previously BuildPkgArchive packages were placed into
      the 'interface/lib/SOLARIS' subdirectory and this was not being
      searched when looking for libraries.

Minor changes:
    * GenerateFiles directive
      New sub-options to filename generation commands
        --abspath       - provide the named file with an absolute path
        --absdrive      - provide the named file with an absolute path
                          and drive letter

    * Src directive
      Modified the --FromPackage' option to allow searching of the root
      directory of a package.

            Src('*', 'etc/data.ini', '--FromPackage' );

      Also prevent warnings on duplicate files if the package is
      imported with a BuildPkgArchive directive. The file was being
      found in the package and the interface directory.

    * jats_rewrite utility
      Process depend.xml files for auto builder


------------------------------------------------------------------------
Version: JATS_2.35.0                                Released: 28-Jul-05
------------------------------------------------------------------------
Major changes:
    * SunWorks production builds
      Corrected the flag used to select the level of compiler
      optimisation. The current flag generates an error of:
            cc: Warning: option -2 passed to ld
      The flag has been changed from -O2 to -xO2 inline with the
      compiler documentation.

    * MOS Toolset
      Implement a workaround for a bug in VisionClick's convert program
      in which the tool would not generate a valid .bdx file.

      The solution was to create the .bdx and .ab file in two steps.

Minor changes:
    * Correct the case of 4 toolset files. The files were created under
      windows, which has a habit of capitalizing filenames.
      This should not affect current users.

    * Mugfile generation
      Extended the --Package option to allow subdirectories to be
      specified.
        "--Package=MyPackage,--Subdir=thx/moscf,thx"  

------------------------------------------------------------------------
Version: JATS_2.34.0                                Released: 22-Jul-05 
------------------------------------------------------------------------
Major changes:
    MOS Toolset
    Modified the optimizations options used to generate 'Production'
    code. A problem with -Ob optimization has been identified.

Minor changes:
    * Jats wrapper script
      Windows: Ensure that cmd.exe is in the users PATH. Without cmd.exe
      scripts will not work properly as the PERL 'system' command assumes
      that cmd.exe is in the users PATH.

    * LinkPkgArchive and BuildPkgArchive
      Processing soft links. Generate a warnings if a package soft
      link and a real package are found in the same directory. The link
      may be suspect.

    * GenerateFiles directive
      Added a --PackageBase(xxx) argument that will be replaced with
      the pathname to the specified package.  

------------------------------------------------------------------------
Version: JATS_2.33.0                                Released: 18-Jul-05
------------------------------------------------------------------------
Major changes:
    * Added a JAVA platform to better support the processing of ANT
      build.xml files.

Minor changes:
    * WIN32 toolset.
      Delete V7 specific temp files when compiling with V7 compiler

    * MakeAnt
      Pass an absolute path to the 'interface' directory to allow the
      build.xml file to be a directory other than the current directory

      Allow the ANT_HOME path to contain spaces: c:\Program Files\Ant

    * gen_winrc - A utility to generate Windows RC files with version
      information. Allow 3 or 4 fields in the version number. If only
      3 fields are provided, then the fourth field is set to 0.

    * MakeAnt directive
      Now supports --Debug and --Prod options to limit the building of
      ANT files. The MakeAnt directive is only going to work in
      conjunction with the JAVA target

      Recommended usage:
      MakeAnt('JAVA',"build.xml","--Jar=java.build/test.jar",'--Prod');

Internal Changes
      The MakeAnt directive is now treated like a MakeProject directive.


------------------------------------------------------------------------
Version: JATS_2.32.0                                Released: 13-Jul-05
------------------------------------------------------------------------
Major changes:
    * Initial release of WINCE and WIN32 V7 based project builds
      The DSW, VCW and SLN files can be built via JATS and selected
      files packaged into the release.

      Refer to the 'MakeProject' directive in
            MASS-00166 JATS Reference Manual
            http://auperaws396/mass/Wiki.jsp?
                                page=UsingJATSToBuildMicrosoftProjects

    * Added support for Visual Studio 2003.
      The recommended platform is:
        BuildProduct    ( 'VS2003', 'WIN32,--Version=MS.NET2003' );

    * Initial release of support for building Ant files.
      JATS can build small Java sub-components using Ant. This is not
      a replacement for JANTS it is intended for mixed C++ and Java
      components.

      Refer to the 'MakeAnt' directive in
            MASS-00166 JATS Reference Manual
            http://auperaws396/mass/Wiki.jsp?
                                page=UsingJATSToBuildSmallJavaComponents

Minor changes:
    * Support for Windows DLLs
      When building a WIN32 target the file interface/set_WIN32.bat is
      created. This file extends the Windows PATH to allow DLLs used
      by the package to be accessed.

      The file may be "called" from a wrapper batch file to start the
      application or visual studio.

    * The descpkg file created by JATS contains a JATS version number
      and the JATS Core path.

    * AddIncDir, AddSrcDir and AddLibDir directives
      Now generate an error if there is only one argument to the
      directive or if no directories where specified.

    * MOS Toolset
      Add support for the TPT device
      Correct error message for unsupported devices.

    * Correct problem with in creating absolute path names to allow
      DOS driver letters to be handled correctly.

    * Added --ExcludeLib(xxx,yyy) processing to allow specified
      libraries to be excluded from a list of libraries processed by
      when creating libraries, shared libraries and programs.

      Used in conjunction with --Using(aaaa) to correct errors.

Internal Changes
    * JATS release process validates the JATS version number contained
      in jats.pl

------------------------------------------------------------------------
Version: JATS_2.31.0                                Released: 28-Jun-05
------------------------------------------------------------------------
Major changes:
    * JATS wrapper script
      Allow multiple alternative build files: auto.pl and build_test.pl

    * Initial support for the building of WINCE based projects

    * Formal release of the toosl to generate Mug Files

Minor changes:
    * Deployment support
      Allow a --PatchNum to be specified in the BuildName
      This is then used to invoke a deploypatch.pl file

    * 'build'
      Added --ForceBuildPkg switch to the 'jats build' command to
      force LinkPkgArchive directives to be interpreted as
      BuildPkgArchive. This option is useful for the creation of
      sandboxes for use within IDEs as the package files are placed
      in a known directory structure within the sandbox.

    * WINCE and WIN32 Toolset
      Options for Program and Shared Library construction
            --Entry=xxxx            - Alternate entry point
            --NoAddLibs             - Do not add default libraries to
                                      the link phase.

    * BuildPkgArchive
      Handle symlink directories at the top level of the package tree
      Previously these were ignored.
      Minor code cleanup

    * "cbuild" or "release" utility
      Add a "-path=xxxx" option to provide sanity testing of the Release
      Manager "Source Path" field.

    * SOLARIS targets
      Modified the TARGET name generated with building a Product Family
      based on SOLARIS. It is treated in the same manner as a Platform
      of SOLARIS and creates a targets of SOLARIS_sparc

    * MugFile generation
      Allows a 'load.cmd' file to be used to list the THX files to be
      included in the final package.

    * Corrected a problem with the processing of platform selection
      arguments used within all directives within a makefile.pl.
      Multiple platforms should be specified as:
            Src( 'PLAT1,PLAT2,PLAT3', .... );
      with only a comma between the platforms: No whitespace
      If whitespace did exist then the makefile.pl would not do what
      was expected - and it would not warn the user. The simplest
      solution was to allow whitespace either side of the comma.        

    * GenerateFiles directive within makefile.pl
      Allow 3 different bracket styles for the arguments to allow for
      embedded  brackets. Now allow
            --Option=(some_text)
            --Option=[some_text]
            --Option={some_text}

Internal Changes
    * Derive the names of the package and install directories from a
      single data structure rather then being hardcoded throughout the
      code.

------------------------------------------------------------------------
Version: JATS_2.30.0                                Released: 01-Jun-05
------------------------------------------------------------------------
Major changes:
    * JATS wrapper script
      Changed the command line parsing. Now use GetOpts.

      Modified "all" command It no longer performs an "install"
      The "install" process is not needed. the build places a shortcut
      to the package into the local_dpkg_archive. This can be used by
      other components.

      Removed "bmake" command. The "all" command is the now that same.

    * JATS
      Created a class to write JATS configuration files.
      Changes to the code to use this new class.

    * Build operations
      Perform one level of package version checking. Generate warnings
      if required packages are built against different versions of
      packages.

    * Make operations
      Added a new target - "deploy". This interfaces to the deployment
      scripts. This is still a work interfaces progress.

Minor changes:
    * Added environment variables to assist in the running of the
      deployment builds.
        PERL5LIB        - Extended based on GBE_CORE
        DEPLOYLIB_DIR   - Calculate based on GBE_CORE

      Extended the "jats vars" display

    * build.pl
        Corrected BuildAlias() operation. Defined options are correctly
        processed. Allows
            BuildAlias('WIN', 'WIN32,--OnlyProduction');
        to define a platform called WIN32 that only builds for
        production.

    * MOS toolset
      Added a '--Acon' options to SharedLib to allow the creation of
      Acon modules. These required special linking.

    * create_dpkg utility
      Adds a files to the published package to indicate which type of
      machine the package was published from. This will be used in a
      multi-machine build environment to assist in determining the
      progress of the build.

    * New utility - jats_save_build.pl
      This is specific to the auto build system. It will be used to
      capture the modified build files back into the version control
      system.

------------------------------------------------------------------------
Version: JATS_2.29.0                                Released: 25-May-05
------------------------------------------------------------------------
Major changes:
    * WIN32 and WINCE toolsets
      Modified the way that PDB files are created.
      The files are now created using absolute pathnames when compiling
      The name of the PDB files embedded in created DLLs is now correct.
      The PDB files created when compiling objects for DLLs are now not
      named after the DLLs - this was causing the linker toolsets crash.

    * WCEX86A500 target
      Corrected problem creating DLLs.

    * MOS Toolsets
      Modified the mechanism by which absolute filenames are passed to
      the compiler.

    * RunTest directive
      This directive will ensure that the named test is either a script
      or a TestProg. If the test to be run is a TestProg then a
      suitable suffix will be added to the named test.

Minor changes:
    * JATS BUILD
      Generate an error if the setting of GBE_BUILDFILTER or
      GBE_PLATFORM prevents any targets being made at all. This should
      highlight bad settings.

    * Publish the JATS toolsets extension pathnames to simplify the
      access to extensions.

------------------------------------------------------------------------
Version: JATS_2.28.0                                Released: 18-May-05
------------------------------------------------------------------------
Major changes:
    * WIN32 and WINCE toolsets
      Enable dependancy file generation of C++ files

    * label utility ( SOLARIS )
      Fix bug with the escaping of '(' and ')' in cleartool commands
      under unix.

Minor changes:
    * label utility
      Added options to:
        o Delete a label
        o Prevent recursion while labeling
        o Control labeling of files missing from a static view

    * WIN32 and WINCE toolsets
      Correct problem with the packaging of PDB files. Packaging of the
      PDB files can be controlled with the -Extras= options to the
      Package directives.

    * Added GBE_UNIX to the JATS_2 controlled environment. Set by
      jats.pl to be used by utilities to determine the underlying
      system.

------------------------------------------------------------------------
Version: JATS_2.27.0                                Released: 10-May-05
------------------------------------------------------------------------
Major changes:
    * MOS Toolset
      The generation of multiple THX's in the one makefile.pl now works
      There was a subtle "closure" problem in the toolset.

    * WIN32 Toolset
      Added CompileOption of AddLibs (default) and NoAddLibs
      toolset suppress the addition of thread libraries toolset the link
      list.

    * Put a version number in the "interface" information toolset
      allow JATS to generate an error when the "interface" changes.

      This version is manually maintained and prone to error.

    * GenerateFiles directive one Unix systems was incorrectly
      invoking "sh.exe" instead of "sh"


Minor changes:
    * SOLARIS_SPARC platform (GCC toolset)
      The process of creating a Shared Libraries creates a soft link
      to the the "GBEBIN" directory. This directory was not listed as
      a prerequisite and was not being created. This problem has been
      corrected.

    * JATS will detect an "auto.pl" file and use it as an alternate
      build.pl file. Previously this file was named build.use.pl.

    * Correct problem when .PDB files are installed from a merged
      library created from libraries that have been 'installed'
      JATS would create a circular dependancy.

------------------------------------------------------------------------
Version: JATS_2.26.0                                Released: 03-May-05
------------------------------------------------------------------------
Major changes:
    * WIN32 Toolset
      Correct a problem linking in required / correct libraries for
      use with multithreaded modes.

    * Complete the support for Global build options of --OnlyDebug and
      --OnlyProd.

      These options can now be provided in the "Platform" directive
      within the makefile.pl.

Minor changes:
    * Platform directive within makefile.pl
      These use of the "*" platform specifier has been modified such
      that options provided within the directive will be added to all
      platforms.

      eg:   Platform ('*', '--OnlyProduction' );

------------------------------------------------------------------------
Version: JATS_2.25.0                                Released: 29-Apr-05
------------------------------------------------------------------------
Major changes:
    * Correct problem in handling the SOLARIS_SPARC platform.
      The SOLARIS platform is a bit of a kludge for backward
      compatibility. JATS was not differentiating between SOLARIS and
      SOLARIS_SPARC correctly.

    * Preliminary Support
      Global build options of --OnlyDebug and --OnlyProd, which are
      mutually exclusive. These may between specified in the build.pl
      file as build arguments in any of the three standard mechanism.

        BuildPlatforms ( 'SOLARIS', '--OnlyDebug' );
        BuildProduct   ( 'GAK', 'MOS68K,--OnlyProduction' );
        BuildArgument  ( 'WIN', '--OnlyProduction' );

      These options limit processing to either Production or Debug
      building. The default build will build both.

Minor changes:
    * Extended the search path that JATS will use attempting to locate
      a build.pl file. JATS will now look in ., build and build/jats
      directories in the current directory and 3 directories up.

    * WCEX86A420 toolset
      Added suitable libflags entry. Prevents the warning:
        warning: undefined variable `WCE_LIBFLAGS'


------------------------------------------------------------------------
Version: JATS_2.24.0                                Released: 21-Apr-05
------------------------------------------------------------------------
Major changes:
    * PackageLib and PackageProg directives now have a --Extra=xxx[,xxx]
      option. Where xxx can be one or more of: none stub map lint debug
      or all.

      This option may be used to limit the files that are packaged with
      the library or program.

      Eg: PackageLib ('MOS', 'MyThx', '--Extra=none' );

      Will only package the .thx file. It will not package the stub
      library or any debug files.

    * GenerateFiles
      All processed arguments now support two options.
      
          ie: --Prerequisite(xxxx,--dir)
              directory in which the prereq file is found

          ie: --Prerequisite(xxxx,--file)
              The filename of the prereq file

    * LinkPkgArchive and BuildPkgArchive will cause the build to fail if
      the required package is not available. A "--package" option, to
      the build command, will prevent this behaviour.


Minor changes:
    * create_dpkg utility
      Touch descpkg files when packages are merged. This will allow
      utilities that use the timestamp of this file to determine that
      the package has been altered.

------------------------------------------------------------------------
Version: JATS_2.23.0                                Released: 14-Apr-05
------------------------------------------------------------------------
Major changes:
    * New toolset: WCEX86A420
      This is a WINCE target
      This uses the ADVANTEC_X86_CE42 SDK

    * New toolset
      mpt for the mpt500 platfomr

    * Modified toolset
      THYRON - updates from An An Tran

    * Modified toolset
      MRI68K. Now supports the Microtec 5.1 68k compiler

Minor changes:
    * "cbuild" or "release" command now has a -merge option to allow
      builds from different machines to be merged into dpkg_archive.

      The default operation is to replace the package indpkg_archive.

    * Simplify the use of GBE_BUILDFILTER
      GBE_BUILDFILTER should be used to limit the creation of makefiles
      to those that are supported by the underlying hardware.

      The change allows the construct
        GBE_BUILDFILTER=SOLARIS --TARGET=SOLARIS
      to be replaced by the simpler
        GBE_BUILDFILTER=SOLARIS

      The default operation is to allow or disallow all TARGETS of the
      specified name.    


------------------------------------------------------------------------
Version: JATS_2.22.0                                Released: 13-Apr-05
------------------------------------------------------------------------
Major changes:
    * Dependancy generator
      Extend the number of header files that can be included
      to allow for 4096 included files.

------------------------------------------------------------------------
Version: JATS_2.21.0                                Released: 12-Apr-05
------------------------------------------------------------------------
Major changes:
    * Dependancy generator
      Extend the number of header files that can be included

------------------------------------------------------------------------
Version: JATS_2.20.0                                Released: 12-Apr-05
------------------------------------------------------------------------
Major changes:
    * The "package.pl" file.
      Setting $Pbase to "." is now supported and will result in the
      package name being taken from the build name

      It is an error to set Pbase to a value other than "." or the
      package Build Name.

Minor changes:
    * create_dpkg utility
      The -m ( merge) option will not replace a file if it already exists

------------------------------------------------------------------------
Version: JATS_2.19.0                                Released: 08-Apr-05
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Dependancy generator
      Correct two common situations
        1) // Style comments. The following line was ignored
        2) Allow preprocessor directives to be indents. This is not
           ansi, but is often done.

    * GCC toolset
      Corrected operation of the C++ compiler. The object file was not
      being created in the correct place.

    * jats "label"
      The -auto -clone options allow a label to be created if its not
      present. Previously this would label all files in the VOB.


------------------------------------------------------------------------
Version: JATS_2.18.0                                Released: 06-Apr-05
------------------------------------------------------------------------
Major changes:

Minor changes:
    * BuildPkgArchive. The transfer of the "pkg" subdirectory has been
      modified. Directories of the form pkg/pkg.$(GBE_MACHTYPE) will
      be transferred to the "pkg" directory.

      If there are no directores of the form "pkg.xxxxx" then the entire
      pkg directory will be transferred.

    * Transfer to dpkg_acrhive
      Corrected a problem in which a file with the same name as the
      package was not being transferred.

------------------------------------------------------------------------
Version: JATS_2.17.0                                Released: 06-Apr-05
------------------------------------------------------------------------
Major changes:
    * Support for solaris_i386
      The JATS toolset has been modified to provide the required
      binaries for this target.

      The platform SOLARIS_I386 has been created to build on this target
      with the GCC compiler.

      The JATS startup shell has been modified to allow specfic values
      to be imported from the environment. Under Unix such values may
      need to be specified in the /etc/profile file.

Minor changes:
    * The InstallHdr, InstallLib, InstallJar and InstallProd directives
      will now generate a warning if a "local" directory has not been specified
      with a "BuildInterface" directive in the build.pl file.

    * cbuild ( release) utility
      Fxied a problem locating VOBs under Solaris

------------------------------------------------------------------------
Version: JATS_2.16.0                                Released: 04-Apr-05
------------------------------------------------------------------------
Major changes:
    * The InstallHdr, InstallLib, InstallJar and InstallProd directives
      will generate an error if a "local" directory has not been specified
      with a "BuildInterface" directive in the build.pl file.

      The "local" directory should be specified to JATS so that it can
      remove the directory tree with the "clobber" command.

    * jats_rewrite.pl utility
      Allow BuildName and LinkPkgArchive directives to contains comments
      with either " or ' characters.

    * BuildSubDir - in build.pl
      It is now an error if the specified subdirectory does not exist
      and  does not contain the file "makefile.pl".

    * SubDir - in makefile.pl
      It is now an error if the specified subdirectory does not exist
      and  does not contain the file "makefile.pl".

    * Jats wrapper
      Added a "-locate" option to force JATS to locate the build.pl file
      and then change to the containing directory before execution
      further commands.

Minor changes:
    * WinCe and Win32 toolsets
      Corrected a problem in the generation of .dep files used in the
      creation of Shared Libraries. There was a miss-match between the
      name of the .dep file and its content.

------------------------------------------------------------------------
Version: JATS_2.15.0                                Released: 22-Mar-05
------------------------------------------------------------------------
Major changes:
    * WIN32 and WinCE Toolset. New CompileOptions
        NoPDB   - Disable the generation of PDBs
        PDB     - Enable the generation of PDBs (default).

      These options operation affect all components within the
      makefile.pl. If the directive is used within the common makefile.pl
      then they will affect all components within the build.

      Note: It is not possible to create a merged library in which some
            of the component libraries have PDB's and some do not.

Minor changes:

------------------------------------------------------------------------
Version: JATS_2.14.0                                Released: 18-Mar-05
------------------------------------------------------------------------
Major changes:
    * The MergeLibrary directive, under WIN32 and WinCe, will publish the
      PDB files associated with the library files being merged.

Minor changes:
    * gen_winrc tool can add an icon to a program.
      The utility supports -icon=filename.ico

    * The JATS wrapper script command "prod" to build and package the
      production parts. This is similar to the "dev" command.

------------------------------------------------------------------------
Version: JATS_2.13.0                                Released: 18-Mar-05
------------------------------------------------------------------------
Major changes:
    * Modified the order in which the makefiles passes operate. Merged
      the make_shlib and the install_shlib into one phase. The
      implication of this is that Shared Libraries that are created can
      "installed" so that other shared libraries can link against them.
      The order in which the makefile.pl's are processed is important as
      this is the order in which the libraries will be created and
      installed.

      This solution does not handle mutual shared libraries: two shared
      libraries that depend on each other.

      This is an issue only in Solaris and Linux systems that do not
      generate separate stub libraries to link against.

Minor changes:
    * WIN32 and WinCE Toolsets
      Building up resources. The RC compiler can now locate resource files
      in the "local" and "interface" directory.

    * The version.c, version.h and descpkg files will be created in the
      first directory named with a BuildDir directive, unless a
      "src" directory is encountered. This mimics the operation
      of the older JATS, without the need for a "src" directory.

------------------------------------------------------------------------
Version: JATS_2.12.0                                Released: 18-Mar-05
------------------------------------------------------------------------
Major changes:

Minor changes:
    * Added a --Depend=xxx[,yyy]+ option to the Src directive
      Not needed for C and C++ files, but may be used in conjunction
      with assembler files to indicate that the file includes another
      file.

    * Fixed problem with the local_dpkg_archive consistency test when
      a soft link is used to redirect to the package.

    * Win32 and WinCE toolsets
      Added a compiler option to enable Run Time Type Information.
            CompileOptions ('WIN32', 'RTTI' );

      Add an option to Shared Library creation to allow the generation of
      a Resource Only DLL. Option is "--ResourceOnly"

      Add an option to allow Resources to be built into Static Libraries
      in the same manner at Shared Libraries.

    * WinCE toolsets
      Mutual DLL support corrected. Library path is used to resolve
      compiler specific libraries.

    * SOLARIS toolset
      Prevent the compiler displaying its command line. This is in line
      with the other tools sets. The commands can be seen with
      OPTIONS=args and this may be set in the users environment.

      Modified the cleanup process to delete the links to shared
      libraries. Only files, and not links to files, where being
      cleaned up.

    * Microtec tools set (MOS)
      Dependancy generation can display commands with OPTIONS=args

    * jats_rewriter.pl
      Allow BuildName and LinkPkgArchive directives to contains arguments
      with either " or ' characters.


------------------------------------------------------------------------
Version: JATS_2.11.0                                Released: 15-Mar-05
------------------------------------------------------------------------
Major changes:
    * BuildPkgArchive operation
      The entire "include" directory is copied into the interface area
      The installer was trying to be too smart and only copy platform
      specific files,but was missing out many needed subdirectories

      Reduce the warnings generated. These were an artifact of the process
      of picking up all the strange variations of the directory structures.

    * Cleaned up the handling of object files that were generated by the
      user.

    * MOS Microtec Toolset
      Always present an absolute filename to the compiler
      Display a shortened filename to allow the user to track progress

      This will remove error messages about the path being too long
      for the   -Gf option.

Minor changes:
    * SOLARIS Toolset
      Remove duplicate -KPIC flags on the command line

    * Win32 and WinCE Toolset
      Source files are either compiled by the C compiler as C files or
      the C++ compiler as C++ files. The option to allow the compiler to
      figure out what sort of file it is has been removed.

------------------------------------------------------------------------
Version: JATS_2.10.0                                Released: 11-Mar-05
------------------------------------------------------------------------
Major changes:
    * Extended BuildName to accept the form
            BuildName ('package_name', 'nn.nn.nn.xxx' );

    * MOS68K and MOSCF toolset.
      Extended the --board option to allow the user to define code and
      data addresses for the board.

            BuildProduct( 'TP5', 'MOSCF','--board=01234H,05678H' );

      Will set the code,data address for the debugable image

    * Extended the PackageXxxxx options
      1) Allow --Platform=xxx,yyy
         Where xxx is a directory prefix and yyy is suffix to the
         "platform" name.  Only useful within the context of the
         PackageFile

      2) The operation of --Platform=xxx when used by the PackageFile
         directive now treats the xxx directory as a prefix to the
         platform name. Other Package directives still treat it as a
         suffix. In practice this is the logical use.

    * Allow InstallLib and PackageLib to install a file that has been
      discovered with a "Src" directive. This allows generated files
      to be installed and packaged.

Minor changes:

    * cache_dpkg utility
      If a package is found in the local_dpkg_archive then the cache
      entry will be deleted and the master archive will not be accessed.

    * label utility
      New option -auto to create and label

    * Build WIN32 and WinCe Mutual DLLs with all the object files
      This allows the generated import library to contain C++ names

    * The BuildDirTree directive now supports an empty first argument
      This allows a NULL tree.dir file, while still creating the root
      directory. ie:

            BuildDirTree    ( '', 'pkg' );

    * Fixed DEVIM 00019520
      The problem was that /bin/pwd could return a different path to
      the Cwd:getpwd() function. Solution: Use one mechanism throughout.


------------------------------------------------------------------------
Version: JATS_2.9.0                                 Released: 28-Feb-05
------------------------------------------------------------------------
Major changes:
    * First release for Back Office and Front Office use.

    * Added the jats tool  jats_rewrite.pl to rewrite build.pl files.
      To be used by the nightly build process.

    * Work around a problem in the Microtec 68K compiler.
      The compiler uses temp files. If the temp file name that the
      compiler uses already exists, then the compiler will not delete
      the file. Instead it appends information to the existing file.

      The workaround is to create the temp files within the build's
      interface directory and to remove all temp files before each
      compilation.

      This bug does not affect the Mictotec CF compiler.

Minor changes:
    * The "jats clobber" command will remove version definition file, if
      one is being produced.

    * Using JATS within a Visual Studio project. The "rebuild all"
      option now translates to the JATS unbuild command to do a better
      job of cleaning the workspace.

    * Added GetPackageRoot() directive to support the packaging of MOS

    * Generate error message for misuse of the SubDir directive

    * Modified BuildName to allow an '-' in the name.
      This provides backward compatibility with existing packages.

------------------------------------------------------------------------
Version: JATS_2.8.0                                 Released: 17-Feb-05
------------------------------------------------------------------------
Major changes:
    * Added some new WINCE based targets. These require WINCE SDKs to be
      installed in order for the compilers to work.

    * New PLATFORMS are WCEIT3000, WCEPA961 and WCEPCM7220

    * All invocations of xmake specify the name of the makefile
      This allow GNUMakefiles and the Jats makefiles to exist in the
      same directory

    * Overcome a limitation of the Microtec compiler in which the flag
      _DEBUG is defined enev in production builds - contrary to the
      documenattion.

Minor changes:
    * Process of descpkg files allows for both Unix and DOS line endings
      Under Unix JATS would report that the package names don't match

    * Corrected a problem with BuildPkgArchive in which file names with
      spaces could not be soft linked. Only affects Unix systems.

    * Added a -rename to the "jats label" utility.
      Ensure that the user specified label exists in the VOB

    * Correct problem with "make clean" that resulted in a verbose display
      when the verbose option had not been selected

    * Correct a problem with "make unbuild". Changes in the build files
      would prevent the execution of the command. This command should
      be exempt from this test.

    * Correct a problem with "make clean" in the WIN32 and WINCE
      platforms where the .exp files were not deleted.

    * The "JATS clobber" command now invokes "make clobber" and "build
      clobber". The result is as clean a clean as it can be.

      Note: Jats "clean" does not remove a lot of files. These can be
      removed with "unbuild" and "unpackage". This is what "clobber"
      does.

    * The operation of "build clobber" has been cleaned up. It will
      not try to invoke make if the makefiles have already been removed.


------------------------------------------------------------------------
Version: JATS_2.7.0                                 Released: 09-Feb-05
------------------------------------------------------------------------
Major changes:
    * First release with support for the DAFBR compiler

    * Extended MergeLibrary. Added per-file options of:
        --Interface         - Pull lib from Interface directory
        --Local             - Pull lib from Local directory (default)
        --SubDir=pathname   - Pull lib from a subdirectory
                              Note: xxxx,pathname still works

    * Added "jats label" to provide a number of useful labeling
      operations.

    * Added extensive help to JATS. JATS -man.
                              
    * Added this manual ChangeLog file

Minor changes
    * Added an 'ebin' command to jats to allow the JATS binary tools to
      be run in a controlled environment from the command line.

    * Prune the list of library paths passed through to the various
      toolsets. If a directory does not have any files in it then the
      directory is not added to the library path.

      Thus if a library is located in xxxx/lib/WIN32 then JATS will
      not add the xxxx/lib to the path.

    * cbuilder will now look in all VOBs for the user specified label.
      The program has a list of "known" labels which it will search
      first in an attempt to speed up the process.

    * The AddFlags directive will issue a warning if the flags does not
      begin with a -D or a -U. The user should not be using compiler
      specific flags.

    * The use of linker flags will issue a warning.

    * Process the common makefile.pl after the toolset has been
      determined. This allows the toolset to extend the CompileOptions
      such they are available to the common makefile.pl.

    * Added the WIN32 CompileOptions "jats_v1" to force JATS to specify
      a number of compile time definitions used by earlier versions of
      JATS.

    * Fixed bug in the --Debug option to the PackageProg directives that
      caused both the production and debug versions to be packaged.

    * The gen_msproject utility now creates simpler names for the MS
      projects that it creates. The name no longer contains the full
      pathname, thus making them shorter and readable.

    * The ShowDlls utility now handles absolute and relative paths to
      the initial DLL or EXE.

    * Correct problem in which the use of Generate/Rule directives may
      fail since prerequisite subdirectories were not being created
      since the "generate" phase was not being run.

      Added messages to prompt the user to remove Generate, Generated
      and Rule directives. Use the GenerateFiles directive

    * JATS.BAT file will exclude LINUX builds by default.

    * The make NODEPEND=1 processing now does not recurse at all.
      Previously each subdirectory was visited - only to do nothing.

    * Correct a problem in creating stub libraries for MOS targets if
      the stub library object was not listed with the SharedLib's
      objects.

    * Correct a problem with the MS Studio support. The invoked make
      command is XXX_all_debug. There was a problem with this command in
      that it did not do any dependancy checking and would not always
      build defendants.