Subversion Repositories DevTools

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
4362 dpurdie 1
------------------------------------------------------------------------
5868 dpurdie 2
Version:  3.10.12000.cr                              Released: 07-Jul-16
5859 dpurdie 3
------------------------------------------------------------------------
4
 
5
Minor changes:
6
    * Improved use of cppcheck - Static code analysis (Adrien Oliva)
7
        Enable all possible check
8
        Force analysis of all pre-processor branch
9
        Remove false positive
10
            Missing include, unused function and unmatched suppression
11
        Configure cppcheck to ignore files provided by the compiler
5867 dpurdie 12
            We do not want to analyze compiler
5859 dpurdie 13
        Fix variable name
14
 
5862 dpurdie 15
    * GCC Toolchain
16
      Improved header file dependency generation through correct calculation
17
      of the compiler header file search paths.
5859 dpurdie 18
 
5862 dpurdie 19
    * IAR Toolchain
20
      Corrected the generation of the Program Loader
5859 dpurdie 21
 
5862 dpurdie 22
    * Internal Utility: cache_dpkg
23
      Improved handling (under windows) of files with the same name but
24
      different case. Generate a clear warning message.
25
 
5868 dpurdie 26
    * Makefile directive GenerateFiles [JATS-178]
27
      Attempting to generate a file that is also marked as a source file is
5867 dpurdie 28
      now an error.
29
 
5859 dpurdie 30
------------------------------------------------------------------------
5868 dpurdie 31
Version:  3.10.11000.cr                              Released: 01-Jul-16
5848 dpurdie 32
------------------------------------------------------------------------
33
 
34
Minor changes:
5859 dpurdie 35
    * Jats internal utility 'timeout'
36
      Improved stability under Server 2013
37
      Reinstated use of 'timeout' in unit tests running under Windows.
5848 dpurdie 38
 
5859 dpurdie 39
    * Utility: jats -buildfiter=xxx
40
      Corrected the operation of the -buildfilter=xxx option when used 
41
      within a sandbox.
5848 dpurdie 42
 
43
------------------------------------------------------------------------
5868 dpurdie 44
Version:  3.10.10000.cr                              Released: 28-Jun-16 
5818 dpurdie 45
------------------------------------------------------------------------
46
 
47
Minor changes:
5859 dpurdie 48
    * Platform: CORTEXM3_ARM
49
      Corrected the generation of the Program Loader
5830 dpurdie 50
 
5859 dpurdie 51
    * UBUNUTU12C11_INSTRUMENT and UBUNUTU12_INSTRUMENT platforms
52
      lcov includes branch coverage
53
 
54
    * All _INSTRUMENT targets
55
      Limit coverage to file within the package
56
      Now excludes all external libraries
5818 dpurdie 57
 
5859 dpurdie 58
      The 'make clean' operation will remove intermediate files generated 
59
      by the coverage.
5818 dpurdie 60
 
61
    * Unit Tests
5859 dpurdie 62
      'make clean' now removes temp 'rc' file generated while running the test
5818 dpurdie 63
 
5859 dpurdie 64
    * Internal Utility: cache_dpkg
65
      [JATS-388] Package caching does not support multiple instances updating 
66
      the same version
5818 dpurdie 67
 
5859 dpurdie 68
    * Internal Utility: cache_dpkg
69
      assemble_dpkg - purge stale package fragments from the package fragment 
70
      assembly area.
5828 dpurdie 71
 
5859 dpurdie 72
    * Sandbox
73
      [JATS-389] Sandbox does not support packages that use deployment
74
      directives.
5819 dpurdie 75
 
5818 dpurdie 76
------------------------------------------------------------------------
5796 dpurdie 77
Version:  3.10.9000.cr                               Released: 14-Jun-16 
5792 dpurdie 78
------------------------------------------------------------------------
79
 
80
Minor changes:
5859 dpurdie 81
    * [JATS-372] Long pathnames kill metrics gathering
82
      See Jira issue for full details
5792 dpurdie 83
 
5859 dpurdie 84
    * [JATS-373] UBUNUTU12C11 and UBUNUTU12C11_INSTRUMENT platforms
85
      Specify the dynamic linker used to load programs generated by this compiler
5796 dpurdie 86
 
5859 dpurdie 87
        NOTE: Programs generated for this platform require the installation of the
88
              vix-ubuntu12-c11-glibc installer from the 'linux-glibc' package.
5796 dpurdie 89
 
5792 dpurdie 90
------------------------------------------------------------------------
5783 dpurdie 91
Version:  3.10.8000.cr                               Released: 02-Jun-16
92
------------------------------------------------------------------------
93
 
94
Minor changes:
5859 dpurdie 95
    * Platform: CORTEXM3_ARM
96
      Added assembler flags
5783 dpurdie 97
 
5859 dpurdie 98
    * Utility cache_dpkg
99
      Seperate wait-for-replication and copy-to-cache
5783 dpurdie 100
 
5859 dpurdie 101
    * Build Directive - BuildName
102
      Added a 3 argument form
103
        BuildName ('pkgName', 'Version', 'Suffix' );
104
      Improved error reporting.
5783 dpurdie 105
 
106
------------------------------------------------------------------------
5761 dpurdie 107
Version:  3.10.7000.cr                               Released: 19-May-16 
5757 dpurdie 108
------------------------------------------------------------------------
109
 
110
Minor changes:
5859 dpurdie 111
    * Platform: CORTEXM3_ARM
112
      Changed to use Embedded Workbench 7.4
5757 dpurdie 113
 
5859 dpurdie 114
      Added --CrcRange=... option to the CORTEXM3_ARM Prog directive
115
      Used to specify the range to fill and CRC.
5757 dpurdie 116
 
117
------------------------------------------------------------------------
5744 dpurdie 118
Version:  3.10.6000.cr                               Released: 13-May-16
5743 dpurdie 119
------------------------------------------------------------------------
120
 
121
Minor changes:
5859 dpurdie 122
    * Utility cache_dpkg
123
      When used by the build system, the contents of the 'lcov' directory
124
      will not be cached.
5743 dpurdie 125
 
5859 dpurdie 126
      Add facility to allow build system to wait for package replication
127
      to occur. Only active when a replica store is configured.
5744 dpurdie 128
 
5859 dpurdie 129
    * UBUNUTU12C11 and UBUNUTU12C11_INSTRUMENT platforms
130
      Added 'rpath' elements to generated executables to ensure that
131
      the all glibc components required by the runtime can be located.
5744 dpurdie 132
 
5743 dpurdie 133
------------------------------------------------------------------------
5736 dpurdie 134
Version:  3.10.5000.cr                               Released: 06-May-16
135
------------------------------------------------------------------------
136
 
137
Minor changes:
5859 dpurdie 138
    * C11 Support under GCC
139
      Use '-std=gnu++11' for building c++ files (Not -std=c++11) 
140
      Note: Use of the compiler definition 'linux' is non-standard
141
            __linux__ is the standard definition.
5736 dpurdie 142
 
143
------------------------------------------------------------------------
5732 dpurdie 144
Version:  3.10.4000.cr                               Released: 09-May-16
5731 dpurdie 145
------------------------------------------------------------------------
146
 
147
Minor changes:
5859 dpurdie 148
    * Code coverage Support under GCC
149
      Ensure that the correct gcov utility is used. Gcov is a part of the compiler
150
      toolset. Affects UBUNUTU12C11_INSTRUMENT.
5731 dpurdie 151
 
5859 dpurdie 152
    * Platform: CORTEXM3_ARM
153
      Continuing tweaks.
5731 dpurdie 154
 
155
------------------------------------------------------------------------
5726 dpurdie 156
Version:  3.10.3000.cr                               Released: 06-May-16
157
------------------------------------------------------------------------
158
 
159
Minor changes:
5859 dpurdie 160
    * C11 Support under GCC
161
      Added '-std=c++11' for building c++ files
5726 dpurdie 162
 
163
------------------------------------------------------------------------
5717 dpurdie 164
Version:  3.10.2000.cr                               Released: 04-May-16 
5708 dpurdie 165
------------------------------------------------------------------------
166
 
167
Minor changes:
5859 dpurdie 168
    * Removed use of 'timeout' on unit tests in a Windows environment 
169
      pending several Windows issues. Total 'make' time is still being enforced.
5708 dpurdie 170
 
5859 dpurdie 171
    * New platforms
172
      COBRA2 - Similar to COBRA, but using a C11 compliant version of GCC
173
      VIPER2 - Similar to PPC_603E, but using a C11 compliant version of GCC
174
      UBUNUTU12C11 - Similar to UBUNTU12. Uses the same version of GCC as COBRA2 and VIPER2
175
      UBUNUTU12C11_INSTRUMENT - Instrumented builds of UBUNUTU12C11
176
      DEVLINUX includes all of these new platforms.
5708 dpurdie 177
 
5859 dpurdie 178
    * New Utility: 
179
        checkRelease - Locate package-Version required by a Release/SBOM/Package
180
        that are not in dpkg_archive.
5708 dpurdie 181
 
182
Internal:
5859 dpurdie 183
    * Removed runtime warning from buildlib.pl
5708 dpurdie 184
 
5859 dpurdie 185
    * Updated VIX Copyright notices
5710 dpurdie 186
 
5708 dpurdie 187
------------------------------------------------------------------------
5700 dpurdie 188
Version:  3.10.1000.cr                               Released: 19-Apr-16
5695 dpurdie 189
------------------------------------------------------------------------
190
 
5700 dpurdie 191
Minor changes:
5859 dpurdie 192
    * Jats internal utility 'timeout'
193
      Fixed compatibility issue under Windows-7
5700 dpurdie 194
 
195
------------------------------------------------------------------------
196
Version:  3.10.0000.cr                               Released: 15-Apr-16
197
------------------------------------------------------------------------
198
 
5695 dpurdie 199
Major changes:
5859 dpurdie 200
    * Jats make
201
        All make commands are now time limited to a maximum of 3 hours.
202
        This default can be altered with the -maxtime option.
203
        The global default can be set with the EnvVar GBE_MAXMAKE.
5695 dpurdie 204
 
5859 dpurdie 205
      This feature is to prevent unit tests from hijacking the build system.
5695 dpurdie 206
 
5859 dpurdie 207
    * RunTest directive
208
        Runtime of automated unit tests is limited to (default) 30 minutes
209
        The RunTest directive has a --MaxTime parameter to alter the default
210
        time.
5695 dpurdie 211
 
5859 dpurdie 212
      This feature is to prevent unit tests from hijacking the build system.
5695 dpurdie 213
 
5859 dpurdie 214
    * Build Platform Aliases: DEVLINUX and LMOS_DEVLINUX
215
        Removed LINUX_EMU from DEVLINUX
216
        Removed LMOS_LINUX_EMU from LMOS_DEVLINUX
5695 dpurdie 217
 
5859 dpurdie 218
        There is no target environment for LINUX_EMU to run on.
219
        building for this target is pointless.
5695 dpurdie 220
 
221
------------------------------------------------------------------------
5680 dpurdie 222
Version:  3.9.0000.cr                               Released: 11-Apr-16
5679 dpurdie 223
------------------------------------------------------------------------
224
 
5680 dpurdie 225
Major changes:
5859 dpurdie 226
    * New buildfile directive: BuildExclude
227
      Allows spcific targets to be excluded from the build. Intended to be 
228
      used in conjunction with Platform aliases such as DEVLINUX. ie:
229
        BuildPlatforms('DEVLINUX');
230
        BuildExclude('ARM9TDMI', 'LINUX_EMU');      # Targets specfically not supported
5679 dpurdie 231
 
5680 dpurdie 232
Minor changes:
5859 dpurdie 233
    * New Platform: CORTEXM3_ARM
234
      Used by the next generation of Security Module
235
 
5679 dpurdie 236
------------------------------------------------------------------------
5673 dpurdie 237
Version:  3.8.7000.cr                               Released: 04-Apr-16 
5637 dpurdie 238
------------------------------------------------------------------------
239
 
240
Minor changes:
5859 dpurdie 241
    * Visual Studio 2012 support
242
      Added support for update 5. Now allowes either update 4 or update 5.
243
      Note: Update-4 is the documented (required) version.
5637 dpurdie 244
 
5859 dpurdie 245
    * Internal tool for windows : which.exe
246
      Updated the internal utility 'which' provided under windows for shell
247
      compatability. It was found to not work with Server 2003.
5645 dpurdie 248
 
5859 dpurdie 249
    * Makefile directive: MakeLinuxDriver
250
      Added support for Module Versioning bewteen modules in the same build.
5672 dpurdie 251
 
5637 dpurdie 252
------------------------------------------------------------------------
5619 dpurdie 253
Version:  3.8.6000.cr                               Released: 15-Mar-16
254
------------------------------------------------------------------------
255
 
256
Minor changes:
5859 dpurdie 257
    * SK20 Toolchain
258
      Version 4.1.0 of the SK20 toolchain has beencompletely replaced
259
      with a new version. 4.1.1. The SK20V1 target uses the new compiler.
5619 dpurdie 260
 
5859 dpurdie 261
      Version 4.1.0 was not used to generate released software. It is
262
      no longer needed. The new compiler-version is available in the
263
      arm-unknown-linux-gnueabi-sk20 package.
5619 dpurdie 264
 
265
------------------------------------------------------------------------
5582 dpurdie 266
Version:  3.8.5000.cr                               Released: 25-Feb-16
267
------------------------------------------------------------------------
268
 
269
Minor changes:
270
    * System Utility - assemble_dpkg
5859 dpurdie 271
      Allow for both unix and windows generated .tar.gz files
272
      The windows files do not have './' prepended
5582 dpurdie 273
 
274
------------------------------------------------------------------------
5578 dpurdie 275
Version:  3.8.4000.cr                               Released: 24-Feb-16
276
------------------------------------------------------------------------
277
 
278
Minor changes:
279
    * System Utility - assemble_dpkg
5859 dpurdie 280
      Windows and Unix create tar-zip files via different mechanisms
281
      Note: bsdtar has issues with large archives under Server2003
5578 dpurdie 282
 
5859 dpurdie 283
    * Windows utilities. Update the 7zip binaries to latest version
5578 dpurdie 284
 
285
------------------------------------------------------------------------
5568 dpurdie 286
Version:  3.8.3000.cr                               Released: 18-Feb-16
287
------------------------------------------------------------------------
288
 
289
Minor changes:
5859 dpurdie 290
    * Packaging directives
291
      Improved the cleanup of badly specified --Dir options
5568 dpurdie 292
 
293
    * System Utility - assemble_dpkg
5859 dpurdie 294
      Extended to allow deletion of bad and test builds
5568 dpurdie 295
 
296
   * Java Build Support
297
     Only in the build system, set JATS_HOME to the package repostory replica
5859 dpurdie 298
     if one is available.
5568 dpurdie 299
 
300
------------------------------------------------------------------------
5551 dpurdie 301
Version:  3.8.2000.cr                               Released: 12-Feb-16
5485 dpurdie 302
------------------------------------------------------------------------
303
 
304
Minor changes:
5859 dpurdie 305
    * Jats documentation generation. 
306
      Fixed [JATS-227] Pod2Html has a bug with nested items blocks
5542 dpurdie 307
 
5859 dpurdie 308
    * System Utility - create_dpkg
309
      Added support for flagging non-builds. This will be used by a
310
      future release of the build system.
5551 dpurdie 311
 
5542 dpurdie 312
------------------------------------------------------------------------
313
Version:  3.8.1000.cr                               Released: 03-Feb-16 
314
------------------------------------------------------------------------
315
 
316
Minor changes:
5859 dpurdie 317
    * New target: SK20V41
318
      This is the SK20 Platform, With version 4.1.0.0, except that is
319
      a part of the DEVLINUX alias.
5527 dpurdie 320
 
5859 dpurdie 321
    * Windows utilities. Added 'bsdtar', called 'tar'
322
      This utility handles a subset of gnu-tar operations on windows, but 
323
      it does support .gz and .bz2 files.
5485 dpurdie 324
 
5859 dpurdie 325
    * Jats essential binaries
326
      Added symlinks within jats to ensure that gtar can be located on
327
      machines in which a gnu-tar is not native to the machine.
5527 dpurdie 328
 
329
    * System Utility - assemble_dpkg
5859 dpurdie 330
      Used by the build system to assemble a package from package fragments.
5527 dpurdie 331
 
5859 dpurdie 332
    * System Utility - create_dpkg
333
      Added support to create package fragments. This will be used by a
334
      future release of the build system.
5527 dpurdie 335
 
5485 dpurdie 336
------------------------------------------------------------------------
5448 dpurdie 337
Version:  3.8.0000.cr                               Released: 04-Jan-16 
338
------------------------------------------------------------------------
339
 
340
Minor changes:
5859 dpurdie 341
    * ANDROID Platform
342
      Flag the AndroidStudioBuilder that the project does have unit
343
      tests so that they can be built before the tests are run.
5448 dpurdie 344
 
345
------------------------------------------------------------------------
5434 dpurdie 346
Version:  3.7.11000.cr                               Released: 17-Dec-15
347
------------------------------------------------------------------------
348
 
349
Minor changes:
5859 dpurdie 350
    * SK20 Platform, With version 4.1.0.0
351
      Correct the value of HOST_CPU provided to utilities such as 
352
      ShellBuild. The 4.1.0.0 compiler is diffeent to the Version 1.
5434 dpurdie 353
 
354
------------------------------------------------------------------------
5429 dpurdie 355
Version:  3.7.10000.cr                               Released: 14-Dec-15 
356
------------------------------------------------------------------------
357
 
358
Minor changes:
5859 dpurdie 359
    * Build File [JATS-146]
360
      Fix for use in build system
5429 dpurdie 361
 
362
------------------------------------------------------------------------
5415 dpurdie 363
Version:  3.7.9000.cr                               Released: 11-Dec-15 
5411 dpurdie 364
------------------------------------------------------------------------
365
 
366
Minor changes:
5859 dpurdie 367
    * Build File [JATS-146]
368
      Improved reporting of 'alias' conflicts.
369
      Conflicts now generate an error, not a warning.
370
      Within the Build and Escrow system conflicts will generate a warning
371
      to maintain backward compatability.
5411 dpurdie 372
 
5859 dpurdie 373
    * ANDROID AndroidStudio
374
      Added support run automated unit tests
5411 dpurdie 375
 
376
------------------------------------------------------------------------
5387 dpurdie 377
Version:  3.7.8000.cr                               Released: 30-Nov-15
378
------------------------------------------------------------------------
379
 
380
Minor changes:
381
    * Unit Testing
5859 dpurdie 382
      Fixed the name of the Unique Test Identifier passed to the filter - UTFUID
5387 dpurdie 383
 
5859 dpurdie 384
      Auto detect the presence of test results generated by 'UTF' and invoke
385
      the UTF filter, if found. This allows the use of the new 'UTF' without
386
      reworking all UTF consumers.
5387 dpurdie 387
 
388
------------------------------------------------------------------------
5378 dpurdie 389
Version:  3.7.7000.cr                               Released: 26-Nov-15
390
------------------------------------------------------------------------
391
 
392
Minor changes:
393
    * GCC Toolchain
394
      Fixed shell script error message introduced in 3.7.6000.cr 
395
 
396
------------------------------------------------------------------------
5330 dpurdie 397
Version:  3.7.6000.cr                               Released: 05-Nov-15
398
------------------------------------------------------------------------
399
 
400
Minor changes:
401
    * Utility: create_dpkg
402
      Only perform package level locking when invoked from a build daemon
403
      Still performs version level locking
404
 
405
    * Support for new version of the compiler for the SK20 platform
406
      New version is selected via: 
407
          BuildPlatforms('SK20,--Version=4.1.0.0');
408
      Requires the compiler provided in the arm-unknown-linux-gnueabi-sk20
409
      package to be locally installed.
410
 
411
------------------------------------------------------------------------
5315 dpurdie 412
Version:  3.7.5000.cr                               Released: 12-Oct-15
5262 dpurdie 413
------------------------------------------------------------------------
414
 
415
Minor changes:
416
    * Build.pl. BuildAlias directive
417
      Correctly report the detection of multiple aliases in the one specification.
418
 
5264 dpurdie 419
    * Utilities: vcsdiff
420
      Open registry with read-only access
421
 
5284 dpurdie 422
    * Build Metrics
423
      Updated the version of the 'cloc' tool used by JATS to generate metrics.
424
 
5262 dpurdie 425
------------------------------------------------------------------------
5254 dpurdie 426
Version:  3.7.4000.cr                               Released: 14-Sep-15
427
------------------------------------------------------------------------
428
 
429
Minor changes:
430
    * Toolset: UBUNTU14_INSTRUMENT
431
      The UBUNTU14_INSTRUMENT toolchain can consume headers and libraries 
5259 dpurdie 432
      built for UBUNTU14
5254 dpurdie 433
 
434
------------------------------------------------------------------------
5241 dpurdie 435
Version:  3.7.3000.cr                               Released: 31-Aug-15
5206 dpurdie 436
------------------------------------------------------------------------
437
 
438
Minor changes:
439
    * Subversion Support
440
      Detected authentication failure messages provided by new versions of subversion
441
 
5240 dpurdie 442
    * Utilities: vcsdiff
443
      Improved support for BeyondCompare 4 (BC4).
444
      Check more locations for the program.
445
 
5206 dpurdie 446
------------------------------------------------------------------------
5138 dpurdie 447
Version:  3.7.2000.cr                               Released: 30-Jun-15 
448
------------------------------------------------------------------------
449
 
450
Minor changes:
451
    * Platform: HAMMERHEAD
452
      Removed some compiler flags from the c++ builds.
453
      The removed flags are not applicable to c++ and generate warnings about the
454
      misuse of the flags.
455
 
456
------------------------------------------------------------------------
5129 dpurdie 457
Version:  3.7.1000.cr                               Released: 30-Jun-15 
5115 dpurdie 458
------------------------------------------------------------------------
459
 
460
Minor changes:
461
    * BuildProduct directive
462
      The use of the --Alias=xxx suboption has been exetnded.
463
        BuildProduct   ( PROD,--Alias=A1', 'PLATFORM1,--Alias=A2', 'PLATFORM1,--Alias=A3' );
464
      Will result in A1 being an alias for PROD_PLATFORM1 and PROD_PLATFORM2
465
                     A2 being an alias for PROD_PLATFORM1
466
                     A3 being an alias for PROD_PLATFORM2
467
 
468
    * GCC Toolset. New CompileOptions
469
      'pic'     - Generate Position Independent Code (PIC) for static libraries
470
      'nopic'   - Do not generated PIC for static libraries
471
 
472
      Currently the default is to not generate PIC on static libraries, except for
473
      the UBUNTU14 target.
474
 
475
      Note: PIC will always be generated for shared libraries
476
 
477
------------------------------------------------------------------------
5109 dpurdie 478
Version:  3.7.0000.cr                               Released: 18-Jun-15 
5100 dpurdie 479
------------------------------------------------------------------------
480
 
5109 dpurdie 481
Major changes:
482
    * Build File processing - duplicate platforms
483
      Attempting to build duplicate platforms has been elevated from a warning
484
      to an error. The warning was always ignored and created bad side effects.
485
 
486
      The build daemons and the escrow process will allow duplicates for backward
487
      compatibility and reproducibility, but new software should have the 
488
      duplicates corrected.
489
 
490
    * Build File processing - Reodering of build information and warnings
491
      Warnings and Messages generated before the 'Build Configuration' are now
492
      being stored and displayed after the 'Build Configuration'.
493
 
494
      This is intended to bring to the users attention warning that appear at the
495
      start of the build process but are at the top of the screen. Warnings will be
496
      displayed at the end of the build process.
497
 
5100 dpurdie 498
Minor changes:
499
    * Utilities: vcsdiff
500
      Added support for BeyondCompare 4 (BC4)
501
 
502
    * Utilities: CCdiff and CCBc2
503
      Removed. Replaced by vcsdiff
504
 
5104 dpurdie 505
    * Utility: gen_cots
506
      User must specify the source of the package image.
507
 
5109 dpurdie 508
    * Package Cache Control
509
      A new environment variable(GBE_DPKG_CACHE_CTL) allows the GBE_DPKG_CACHE
510
      to be automatically populated. See 'jats man EnvVars' for details.
511
      Use 'jats cache_dpkg' to manage the cache.
512
 
5100 dpurdie 513
------------------------------------------------------------------------
5074 dpurdie 514
Version:  3.6.7000.cr                               Released: 19-May-15
5073 dpurdie 515
------------------------------------------------------------------------
516
 
517
Minor changes:
518
    * Added several make targets:
519
      jats make hdrs        - makes and installs headers
520
      jats make libs        - make and installs static libs
521
      jats make slibs       - make and install shared libs
522
      jats make progs       - make and install programs
523
 
5074 dpurdie 524
    * Subversion comments
525
      Extended the text in the default Subversion comments created by Jats
526
      to include the tag/branch being created. Does not affect user provided
527
      comments.
528
 
5073 dpurdie 529
------------------------------------------------------------------------
5036 dpurdie 530
Version:  3.6.6000.cr                               Released: 08-Apr-15 
5035 dpurdie 531
------------------------------------------------------------------------
532
 
533
Minor changes:
534
    * Unit Testing
535
      Create a simple unit test results file for Unit Tests that do 
536
      not support full results reporting.
537
 
538
------------------------------------------------------------------------
5004 dpurdie 539
Version:  3.6.5000.cr                               Released: 24-Mar-15
540
------------------------------------------------------------------------
541
 
542
Minor changes:
543
    * Platform : VS2012_X64
544
      Searches WIN64 for OSCOMMON header files.
545
 
546
    * Unit Testing
547
      Export EnvVar GBE_UTFFILE.
548
 
549
      The automated and non-automated unit tests are now run in the order
550
      in which they are defined in the makefile.pl.
551
 
552
    * Build System Utility
553
      Use file locking on the build marker file to force it to be flushed 
554
      out to the file server.
555
 
556
------------------------------------------------------------------------
4969 dpurdie 557
Version:  3.6.4000.cr                               Released: 12-Mar-15 
558
------------------------------------------------------------------------
559
 
560
Minor changes:
561
    * Pseudo Platform: LINUX
562
      Corrected the operation of the LINUX alias. It is an alias for
563
      all Back Office Linux targets.
564
 
565
    * Utility: create_dpkg
566
      Use file locking to address contention while merging package instances
567
      into dpkg_archive.
568
 
569
------------------------------------------------------------------------
4950 dpurdie 570
Version:  3.6.3000.cr                               Released: 06-Mar-15
571
------------------------------------------------------------------------
572
 
573
Minor changes:
574
    * New Platform: HAMMERHEAD
575
      Builds under linux using the AVR32_GNU toolchain
576
 
577
------------------------------------------------------------------------
4928 dpurdie 578
Version:  3.6.2000.cr                               Released: 03-Mar-15
579
------------------------------------------------------------------------
580
 
581
Minor changes:
582
    * ANDROID target
583
      Can be build on either Windows and Linux. This does not mean that
584
      all Android packages will build on both, rather that the some Android 
585
      builders can build under Windows and some under Linux.
586
 
587
    * UBUNTU14 target
588
      Always generates (PIC) Position Independent Code.
4931 dpurdie 589
      Addresses issues in the creation of shared libraries from static
4928 dpurdie 590
      libraries.
591
 
592
    * Directive CompileOptions
593
      New options: 'warnings_as_errors' and 'no_warnings_as_errors'
4929 dpurdie 594
      Will convert compiler warnings into errors on supported toolsets.
4928 dpurdie 595
      Currently support by all Windows compilers and those that use 
596
      the GCC toolset.
597
 
598
Internal:
599
    * System function will remove 'undef' parameters
600
 
601
------------------------------------------------------------------------
4903 dpurdie 602
Version:  3.6.1000.cr                               Released: 17-Feb-15 
4898 dpurdie 603
------------------------------------------------------------------------
604
Major changes:
605
 
4902 dpurdie 606
    * Final release of the 64-bit support platforms
607
      VS2012_X64, UBUNTU14 and UBUNTU14_INSTRUMENT 
608
 
4898 dpurdie 609
Minor changes:
610
    * Build system. Rewriting of build files with new dependencies now
611
      preserves the file-endings in the source file. ie: Unix and DOS
612
      file formats will be preserved.
613
 
4902 dpurdie 614
    * Detect and prevent build of software on non-build machines
615
      such as auperaunx01.
4898 dpurdie 616
 
4902 dpurdie 617
Internal:
4903 dpurdie 618
    * Added platform configurable global options
4902 dpurdie 619
 
4898 dpurdie 620
------------------------------------------------------------------------
4889 dpurdie 621
Version:  3.6.0000.cr                               Released: 12-Feb-15 
4778 dpurdie 622
------------------------------------------------------------------------
4889 dpurdie 623
Major changes:
4780 dpurdie 624
    * JAVA Platform
4805 dpurdie 625
      Post process UTF results with a ANT/JUNIT4 specific tool.
4889 dpurdie 626
      Disabled by default
4780 dpurdie 627
 
4889 dpurdie 628
    * New platforms (still under development)
4814 dpurdie 629
      VS2012_X64 - Build 64 bit Windows applications, using VS2012
630
      MSWIN64    - An alias for all supported 64 bit windows compilers
631
                   Currently VS2012_X64 is the only member
632
      UBUNTU14   - Build 64 bit applications targeted at Ubuntu LTS 14.04
633
                   This is not aimed at front office devices and thus
4903 dpurdie 634
                   this target is not a part of DEVLINUX
4814 dpurdie 635
                   It is a part of LINUX
4835 dpurdie 636
      UBUNTU14_INSTRUMENT
637
                 - Build instrumented 64 bit applications targeted 
638
                   at testing under Ubuntu LTS 14.04
4814 dpurdie 639
 
4778 dpurdie 640
------------------------------------------------------------------------
4889 dpurdie 641
Version:  3.5.10000.cr                               Released: 03-Feb-15
642
------------------------------------------------------------------------
643
Minor changes:
644
    * GCC toolset: Handle different versions of lcov
645
 
646
    * Unit Testing. Run the collate test results target only once.
647
 
648
    * Jats build option: -[no]generic
649
      To be used by the build system to verify correct usage of the 
650
      GENERIC platform type.
651
 
652
Internal:
653
    * Adding mechanism to post process Unit Test results.
654
 
655
------------------------------------------------------------------------
4728 dpurdie 656
Version:  3.5.9000.cr                               Released: 04-Dec-14
657
------------------------------------------------------------------------
658
Minor changes:
659
    * New build Alias - NATIVE
660
      NATIVE is a set of platforms, in the current build, which build 
661
      artifacts that can be expected to run on the build machine.
662
 
663
      The NATIVE alias has been created to simplify the support
664
      for automated unit tests.
665
 
4761 dpurdie 666
    * New build platform - UBUNTU12_INSTRUMENT
4728 dpurdie 667
      This build target is similar to UBUNTU12, except that it 
668
      generates instrumented code with gcov. The platform's unit tests 
669
      will create and maintain a set of lcov files.
670
 
4805 dpurdie 671
      Packages generated with this target SHOULD NOT be deployed 
672
      to the field.
4728 dpurdie 673
 
674
------------------------------------------------------------------------
4688 dpurdie 675
Version:  3.5.8000.cr                               Released: 21-Nov-14 
4652 dpurdie 676
------------------------------------------------------------------------
677
Minor changes:
678
    * Build System Utility: create_dpkg
4688 dpurdie 679
      When creating the file list for release notes, convert filenames 
680
      to utf-8 for consistent handling.
4652 dpurdie 681
 
682
      Will add its own 'built' files to the package metadata file.
683
 
684
    * VS2012 Toolset
685
      [JATS-308] Running jats from VS2012 Developer command prompt
686
 
4688 dpurdie 687
    * EnvVars
688
      Added GBE_DPKG_REPLICA. This read-only package store is scanned 
689
      before GBE_DPKG. It is intended to facilitate remote build 
690
      servers that have a local package archive replica.
691
 
692
    * Autobuild support for Java Based Packages
693
      Attempt to overcome shortcomings in ant-using in a remote build 
694
      environment. Set GBE_DPKG to GBE_DPKG_REPLICA if doing an ABT enabled 
695
      build and GBE_DPKG_REPLICA is defined.
696
 
697
    * Jats caching
698
      Modified the cache mechanism such that if the required version is
699
      found in the cache, then it will not be refreshed. This should speed
700
      up jats startup.
701
 
4652 dpurdie 702
------------------------------------------------------------------------
4620 dpurdie 703
Version:  3.5.7000.cr                               Released: 20-Oct-14
704
------------------------------------------------------------------------
705
Minor changes:
706
    * SQL Interface to Release Manager Database
707
      Addressed issues with Java 1.4 compatibility
708
 
709
------------------------------------------------------------------------
4613 dpurdie 710
Version:  3.5.6000.cr                               Released: 16-Oct-14 
4549 dpurdie 711
------------------------------------------------------------------------
712
Minor changes:
713
    * Jats Internal utility: create_dpkg
714
      Interactive features have been removed
715
      Generates XML file of files transferred to the package
716
 
4551 dpurdie 717
    * Jats Internals
718
      Reworked the handling of the 'GENERIC' target
719
 
4549 dpurdie 720
------------------------------------------------------------------------
4538 dpurdie 721
Version:  3.5.5000.cr                               Released: 24-Sep-14
722
------------------------------------------------------------------------
723
Minor changes:
724
    * GCC Toolset: SharedLib creation - dependency file detection
725
      Fixed a bug[JATS-304] in which the dependencies between header files
726
      and source files was not being used, when building a SharedLib.
727
 
728
      The main effect of this is that if a developer modified a .h file
729
      then JATS was not detecting which C files to recompile.      
730
 
731
    * Added a script called jats.unix.sh
732
      On Unix, this is intended to be copied to /usr/local/bin as 'jats'
733
      It will redirect the user to the correct instance of JATS
734
 
735
    * Jats Internal: Database access
736
      Rebuilt the database access tools using Java 1.4
737
      Java 1.4 is lowest common denominator on all of our machines
738
 
739
------------------------------------------------------------------------
4519 dpurdie 740
Version:  3.5.4000.cr                               Released: 19-Sep-14
4488 dpurdie 741
------------------------------------------------------------------------
742
Minor changes:
4501 dpurdie 743
    * Toolset Compiler: M16C for the MCR platform
4488 dpurdie 744
      Added support to ensure that the program does not exceed allocated
745
      flash space.
746
 
4519 dpurdie 747
    * Toolset: GCC [JATS-300]
5859 dpurdie 748
      Added support for linking against shared libraries that have 
4519 dpurdie 749
      dependencies on other shared libraries
750
 
751
 
4501 dpurdie 752
    * Jats Make Directive - Script
753
      Corrected its operation. The Scripts will be copied into the 'bin'
754
      directory before the tests are run.
755
 
4466 dpurdie 756
    * Internal utilities: Database Access
757
      Added support to access the ClearQuest database via sqlserver
758
      Added test_cqconnection
759
      Added EnvVars to support ClearQuest access
760
      Updated the template jats.bat and jats.sh scripts
761
 
4688 dpurdie 762
    * Reverted automated build support for multi-level SVN branches.
4519 dpurdie 763
      It created more issues than it fixed.
764
 
4466 dpurdie 765
------------------------------------------------------------------------
4461 dpurdie 766
Version:  3.5.3000.cr                               Released: 19-Aug-14 
4447 dpurdie 767
------------------------------------------------------------------------
768
Minor changes:
769
    * Automated Build Support. SVN branches in a subdirectory structure
770
      Allow a SVN branch in a multi-level subdirectory to be labeled by
4538 dpurdie 771
      the build tool. [Removed in 3.5.4000.cr]
4447 dpurdie 772
 
4461 dpurdie 773
      Such paths are not encouraged, nor supported by the body of JATS, but
774
      for compatibility with some existing repositories is required.
4447 dpurdie 775
 
4461 dpurdie 776
    * Makefile builder
777
      Removed two warnings detected by recent versions of Perl
778
 
4447 dpurdie 779
------------------------------------------------------------------------
4424 dpurdie 780
Version:  3.5.2000.cr                               Released: 29-Jul-14
781
------------------------------------------------------------------------
782
Minor changes:
783
    * Utility: create_dpkg
784
      Does not copy broken symlinks into dpkg_archive
785
      Will warn about broken symlinks
786
      In test mode it will generate an error if broken symlinks are found
787
 
788
    * Jats Makefile creation
789
      Corrected handling of source files with multiple '.' in their names.
790
      There was a problem with such files in Prog and SharedLib directives
791
 
792
    * Utility: deploy_builder
793
      Initial release of this internal utility.
794
 
795
------------------------------------------------------------------------
4391 dpurdie 796
Version:  3.5.1000.cr                               Released: 07-Jul-14 
4382 dpurdie 797
------------------------------------------------------------------------
798
Minor changes:
799
    * Visual Studio 2005 and above toolset
800
      The programs .exe.manifest will be packaged along with the 
801
      executable, but only if it exists.
802
 
803
------------------------------------------------------------------------
4362 dpurdie 804
Version:  3.5.0000.cr                               Released: 24-Jun-14
805
------------------------------------------------------------------------
806
Minor changes:
807
    * ANDROID Support
808
      The 'populate' phase passes in all arguments from the MakeProject directive
809
      This allows libs and jars to be named during the populate phase.
4345 dpurdie 810
 
361 dpurdie 811
------------------------------------------------------------------------
4345 dpurdie 812
Version:  3.4.9000.cr                               Released: 19-Jun-14
813
------------------------------------------------------------------------
814
Minor changes:
815
    * ANDROID Support
816
      Populate the project during the build phase. This will place 
817
      external JARs and Shared Libraries in the project to facilitate
818
      development.
819
 
820
------------------------------------------------------------------------
4326 dpurdie 821
Version:  3.4.8000.cr                               Released: 18-Jun-14
4324 dpurdie 822
------------------------------------------------------------------------
823
Minor changes:
824
    * New Platform - ANDROID
825
      Basic build support provided though the Makeproject directive
826
      The Sdk and all other tools are provided via packages. These
827
      include: androidBuilder, anddroidSdk and ant
828
 
829
------------------------------------------------------------------------
4309 dpurdie 830
Version:  3.4.7000.cr                               Released: 11-Jun-2014
831
------------------------------------------------------------------------
832
Minor changes:
833
    * GCC toolsets
834
      Removed -Wid-clash-31 from the list of warnings enabled via 'options=wall'
835
 
836
    * New Platform Alias - MSWIN32
837
      This alias will expand to (supported) targets that build Microsoft
838
      Windows 32-bit targets. At this release these targets are:
839
        WIN32   - Visual C 6         
840
        VS2005  - Visual Studio 2005 (Not recommended)
841
        VS2012  - Visual Studio 2012
842
 
843
------------------------------------------------------------------------
4287 dpurdie 844
Version:  3.4.6000.cr                               Released: 26-May-14
845
------------------------------------------------------------------------
846
Minor changes:
847
    * Subversion utilities
4309 dpurdie 848
      Ignored messages about external links while examining the workspace.
4287 dpurdie 849
      Only generated by some versions of SVN.
850
      Note: SVN Externals are not supported - just ignored.
851
 
852
------------------------------------------------------------------------
4266 dpurdie 853
Version:  3.4.5000.cr                               Released: 21-May-14
854
------------------------------------------------------------------------
855
Minor changes:
856
    * PackageFile directive
857
      Improved the --DirTree operation to allow it to work in packages
858
      with an inverted buildfile structure.
859
 
860
------------------------------------------------------------------------
4261 dpurdie 861
Version:  3.4.4000.cr                               Released: 21-May-14
862
------------------------------------------------------------------------
863
Minor changes:
864
    * Makefile Directives MakeProject and MakeAnt
865
      Ensure that each project creates a unique makefile target.
866
      Previously, projects based on the same solution/project file would
867
      only build the last project due to a name clash
868
 
869
------------------------------------------------------------------------
4257 dpurdie 870
Version:  3.4.3000.cr                               Released: 16-May-14 
871
------------------------------------------------------------------------
872
Minor changes:
873
    * PackageFile directive
874
      Improved the --DirTree operation. The directive can package up any
875
      directory within the package - as determined by the PackageBase.
876
 
877
------------------------------------------------------------------------
4248 dpurdie 878
Version:  3.4.2000.cr                               Released: 14-May-14
4197 dpurdie 879
------------------------------------------------------------------------
880
Minor changes:
881
    * Utility: jats sandbox. 
882
      New subcommand called buildfilter, to display and modify the buildfilter
883
      used within the sandbox.
884
 
4247 dpurdie 885
    * Utility: jats_metrics
886
      Detect subversion based workspaces and do not attempt to invoke the
887
      'cleartool' command to count the clearcase branches in the view.
888
 
4197 dpurdie 889
------------------------------------------------------------------------
4193 dpurdie 890
Version:  3.4.1000.cr                               Released: 04-Apr-14
4192 dpurdie 891
------------------------------------------------------------------------
892
Minor changes:
893
    * Preliminary support for VS2012 and CSHARP2012
894
      This is a Beta.
895
      Requires VS2012 professional update 4 to be installed
896
 
897
    * Utility: gen_cots
898
      Fixed the package creation process
899
 
900
    * Utility: sandbox.
901
      The -toPackage, -fromPackage, -justPackage and ignore package now support
902
      a full package_version name, in addition to the simple package name and
903
      the package name.project forms.
904
 
905
      Clarified the forms in the documentation.
906
 
907
------------------------------------------------------------------------
4179 dpurdie 908
Version:  3.4.0000.cr                               Released: 26-Mar-14 
4135 dpurdie 909
------------------------------------------------------------------------
910
Minor changes:
4163 dpurdie 911
    * PackageFile directive
912
      Improved the --DirTree option's detection of paths outside the current
913
      directory.
914
 
4179 dpurdie 915
    * Jats build log
916
      Will display the name of the host machine when being run by the BuildTool
917
      and the build daemons.
918
 
919
    * New JATS supported host machine type: linux_x86
920
      This has been added to support auperaunx01 as a general developer machine
921
      Currently there are no supported compilers for this machine. It is only
922
      the JATS tool chain. It allows the processing of subversion related 
923
      commands.
924
 
4163 dpurdie 925
------------------------------------------------------------------------
926
Version:  3.3.5000.cr                               Released: 21-Feb-14 
927
------------------------------------------------------------------------
928
Minor changes:
4135 dpurdie 929
    * Makefiles. Platform specifier
930
      Corrected issue where the platform specifier consists entirely of 
931
      non-platform arguments.
932
 
933
    * Jats.bat file example/template
934
      Added JAVA 1.7 default location
935
 
936
------------------------------------------------------------------------
4119 dpurdie 937
Version:  3.3.4000.cr                               Released: 22-Jan-14
4115 dpurdie 938
------------------------------------------------------------------------
939
Minor changes:
4119 dpurdie 940
    * SK20 Toolset
941
      Added standard HOST_* definitions to SK20 target
942
 
943
    * Subversion Support
944
      Ignore error text of the form 'QDBusConnection:*' from the SVN error
945
      stream. This may be generated by a dud released of Ubuntu KDE
946
 
947
------------------------------------------------------------------------
948
Version:  3.3.3000.cr                               Released: 15-Jan-14
949
------------------------------------------------------------------------
950
Minor changes:
4115 dpurdie 951
    * Re-release with missing SK20 support files.
952
 
953
------------------------------------------------------------------------
4110 dpurdie 954
Version:  3.3.2000.cr                               Released: 13-Jan-14 
4109 dpurdie 955
------------------------------------------------------------------------
956
Major changes:
957
    * New build target called SK20
958
      This uses a gcc-based cross compiler and can be run on linux development
959
      machines. The compiler and associated SDKs are provided by 'You Transactor'
960
      Controlled in the VIX package named 'arm-iwmmxt-linux-gnueabi'. This package
961
      addresses issues in the 'You Transactor' provided installer.
962
 
963
Minor changes:
964
 
965
------------------------------------------------------------------------
4097 dpurdie 966
Version:  3.3.1000.cr                               Released: 13-Dec-13  
4075 dpurdie 967
------------------------------------------------------------------------
968
Major changes:
969
 
970
Minor changes:
971
    * C# Toolset
972
      Supported named dependencies when specifying a resx file to support
973
      resx files that include other files.
974
 
4097 dpurdie 975
      Resx support. Extend search path for associated .cs file to include
976
      the parent directory.
977
 
4095 dpurdie 978
    * Utility: update_release
979
      Set umask to 0002 to assist in preserving group access to files and
980
      folders created in the 'releases' area.
4075 dpurdie 981
 
4095 dpurdie 982
    * Utility: svn createPackage
983
      Perform a validity check on any directory tree being imported. It 
984
      must not contain any of the following reserved directory names:
985
        .svn, .git, .hg, .cvs, tags, trunk or branches
4075 dpurdie 986
 
4095 dpurdie 987
    * GCC Based build targets
988
      Extended CTAGS support to GCC based targets.
4097 dpurdie 989
      'jats make ctags' will generate a ctags file for GCC based builds in
990
      the same manner as it has for Windows based builds.
4095 dpurdie 991
 
4075 dpurdie 992
------------------------------------------------------------------------
4096 dpurdie 993
Version:  3.3.0000.cr                               Released: 19-Sep-13
4034 dpurdie 994
------------------------------------------------------------------------
995
Major changes:
996
    * GCC Toolchain - Android NDK support
997
      Implemented SharedLibrary option - --NoVersionDll
998
      Implemented CompilerOptions - 'NoVersionDll'
999
 
4036 dpurdie 1000
      Improved the process that creates symbolic links between a Shared
4034 dpurdie 1001
      Libraries 'RealName' and its 'soname' and 'link name'
1002
 
1003
      Added support for a compiler to be provided through a package.
1004
      Specifically implemented to allow Android
1005
 
1006
Minor changes:
1007
    * BuildName directive
1008
      Force '--RelaxedVersion' on COTS packages that have exactly 3 arguments.
1009
 
1010
    * Sandbox utility
4036 dpurdie 1011
      Fixed use of a 'buildfilter' file in the sandbox directory.
4034 dpurdie 1012
 
1013
    * GCC Toolchain - General
4036 dpurdie 1014
      When building a shared library, all unresolved symbols will generate
4034 dpurdie 1015
      a warning.
1016
 
1017
------------------------------------------------------------------------
4003 dpurdie 1018
Version:  3.2.2000.cr                               Released: 27-Aug-13
1019
------------------------------------------------------------------------
1020
Major changes:
1021
 
1022
Minor changes:
1023
    * Automated Build System Support for machines that do not build the package
1024
      This version provides a transparent 'dummy' build under conditions where
1025
      a package does not build for the current machine. All the commands
1026
      used by the 'buildtool' will perform a dummy build. There are no build
1027
      artifacts, but the build will not fail.
1028
 
1029
      This mechanism improved the tracking of files created during the creation
1030
      of makefiles and uses this mechanism to deleted generated files.
1031
 
1032
------------------------------------------------------------------------
3987 dpurdie 1033
Version:  3.2.1000.cr                               Released: 16-Aug-2013
1034
------------------------------------------------------------------------
1035
Major changes:
1036
 
1037
Minor changes:
1038
    * Utility: update_release
1039
      Added options:
1040
        -addfilter=xxx[,yyy]*
1041
        -delfilter=xxx[,yyy]*
1042
      Allowed the -filter option to take a comma separated list of filters.
1043
      Allowed filters to contain a pathname element. ie: scripts/*.sh
1044
      Allow filters without wildcard characters to work correctly.
1045
      Report filter elements that are not used.
1046
 
1047
    * CSharp Toolset: Resx processing
1048
      Backward compatibility with badly formed packages.
1049
      Ignore 'Designer.cs' files that have zero length.
1050
 
1051
    * Build Target: UBUNTU12
1052
      Added missing LMOS aliases.
1053
 
1054
------------------------------------------------------------------------
3967 dpurdie 1055
Version:  3.2.0000.cr                               Released: 8-Aug-2013
1056
------------------------------------------------------------------------
1057
Major changes:
1058
    * New build target: UBUNTU12
1059
      This is intended to facilitate testing of emebedded devices. It is not
1060
      intended to build deployed software.
1061
 
1062
      UBUNTU12 is considered to be an embedded device and as such is included in
1063
      the DEVLINUX alias.
1064
 
1065
      UBUNTU12 is built on an Ubuntu LTS 12.04 platform using
1066
      gcc (Ubuntu/Linaro 4.6.3-1ubuntu5) 4.6.3.
1067
 
1068
Minor changes:
1069
    * Jats wrapper script
1070
      The default version control system has been set to 'svn'. This means that
1071
      the jats commands 'label', 'release' and 'extract' will invoke the
1072
      Subversion instance of the command.
1073
 
1074
      This change will not be picked up by Windows users. They will need to
1075
      update their jats.bat file if they want this change.
1076
 
1077
    * Utility: jats vcsdiff
1078
      Added support for BeyondCompare3 under windows.
1079
 
1080
    * Utility: jats upddep
1081
      Corrected issue that prevented the results being written to the build.pl
1082
      file under windows.
1083
 
1084
    * CSharp Toolset: Resx processing
1085
      Improved the generation of the Resource names. Now supports
1086
      form names that do not match the enclosing resource.
1087
 
1088
      Supports Resources without a matching .cs file - as long as there
1089
      is a matching Designer.cs file.
1090
 
1091
    * GCC Toolchain
1092
      Added version testing of the compiler being invoked by the build.
1093
 
1094
------------------------------------------------------------------------
3859 dpurdie 1095
Version:  3.1.9000.cr                               Released: 21-Jun-13
1096
------------------------------------------------------------------------
1097
Major changes:
1098
    * Jira Issue: JATS-274: Long view name causes legacy package to
1099
                            fail to daemon build
1100
      Create shorter viewnames when extracting Subversion workspace
1101
 
3967 dpurdie 1102
    * Documentation
3859 dpurdie 1103
      Document the EnvVar ANT_HOME  
1104
 
1105
------------------------------------------------------------------------
3833 dpurdie 1106
Version:  3.1.8000.cr                               Released: 04-Jun-13
3832 dpurdie 1107
------------------------------------------------------------------------
1108
Major changes:
1109
    * New Platform: INTELLECT
1110
      Support for Intellect PAX.
1111
      This support does not extend to native building of PAX modules. It is
1112
      intended to 'wrap' the existing PAX Build system.
1113
 
1114
      The body of the Pax Building infrastructure is not within the JATS core
1115
      but is to be provided though a JATS plugin.
1116
 
1117
------------------------------------------------------------------------
3559 dpurdie 1118
Version:  3.1.7000.cr                               Released: 03-May-13
1119
------------------------------------------------------------------------
1120
Major changes:
3564 dpurdie 1121
    * New Platform: VSDEVRC
1122
      Uses an MSP430G2553 processor, a member of the Texas Instruments MSP430
1123
      family
3559 dpurdie 1124
 
1125
Minor changes:
1126
    * Utility: jats sandbox
1127
      Support sandbox specific build filter. A file called 'buildfilter' in
1128
      the root of the sandbox will be used to specify a sandbox-local
1129
      buildfilter. It will override any buildfilter provided on the command
1130
      line.
1131
 
1132
    * Jats Configuration
1133
      Replace auperaunx26 with auperaarc01 as the default package server.
1134
 
1135
    * Jats Utility: rewrite and upddep
1136
      Purify build files that have mixed line endings under both Windows
1137
      and Linux.
1138
 
1139
      Addresses an issue where build files with mixed line endings are not
1140
      correctly rippled.
1141
 
1142
------------------------------------------------------------------------
3347 dpurdie 1143
Version:  3.1.6000.cr                               Released: 05-Apr-13
1144
------------------------------------------------------------------------
1145
Major changes:
1146
 
1147
Minor changes:
1148
    * Jats Core
1149
      Corrected algorithm used to search for a matching package version.
1150
      This is used by the -build option of ccrelease and svnrelease and
1151
      the '-locatepkg' option of JATS.
1152
 
1153
    * Utility: svnsave_build
1154
      Used only by the build daemons.
1155
      Do not propagate the 'author' of the base package if the build is a ripple.
1156
 
1157
    * Utility: svnrelease and svnextract
1158
      The process of backtracking from a tag to a branch/trunk supports
1159
      branches that are more than a single subdirectory.
1160
 
1161
------------------------------------------------------------------------
3045 dpurdie 1162
Version:  3.1.5000.cr                               Released: 13-Feb-13 
1163
------------------------------------------------------------------------
1164
Major changes:
1165
 
1166
Minor changes:
1167
    * svnrelease utility
1168
      The use of the '-branch' option will not replace the build files with
1169
      those from the base tag, nor will it replace any files that were modified
1170
      between the tag and branch from which the tag was taken.
1171
 
1172
      The resultant workspace will be the HEAD of the named branch, although
1173
      the extraction process will highlight changes between the named branch and
1174
      the named tag.
1175
 
1176
    * svnrelease utility
1177
      Corrected a problem in backtracking from a tag to the development branch
1178
      with some releases of TortoiseSVN.
1179
 
1180
------------------------------------------------------------------------
2931 dpurdie 1181
Version:  3.1.4000.cr                               Released: 31-Jan-13
1182
------------------------------------------------------------------------
1183
Major changes:
1184
 
1185
Minor changes:
1186
    * CHSHARP Toolset
1187
      New CompileOption: NoVersionDLL
1188
        Suppress the creation of versioned DLL for all Shared Libraries
1189
        covered by the makefile.
1190
 
1191
      New SharedLib option: --NoVersionDll
1192
        Suppress the creation of versioned DLLs.
1193
        Unversioned DLLs will always be generated.
1194
 
1195
    * ALL Toolsets
1196
      Ensure that some EnvVars that confuse the GNU automake are not exported
1197
 
1198
    * Utility vcsdiff
1199
      Under Unix will perform a 'diff' of the two views.
1200
      Added '-diff' option to force a text mode diff under Windows, rather than
1201
      the default use of BeyondCompare.
1202
 
1203
------------------------------------------------------------------------
2764 dpurdie 1204
Version:  3.1.3000.cr                               Released: 04-Jan-13
1205
------------------------------------------------------------------------
1206
Major changes:
1207
 
1208
Minor changes:
1209
    * Subversion Extraction
1210
      Detect and report error condition where a tag references a parent
1211
      directory of the tag.
1212
 
1213
      Better handling of tagged versions that have been moved within the
1214
      repository.
1215
 
1216
    * Subversion Support
1217
      Detect authentication errors and issue user-friendly error messages
1218
      showing the user what to do.
1219
 
1220
    * Added Support for LMOS_COBRA
1221
      This does not imply that LMOS is fully supported on the COBRA, only that
1222
      we have build support for this target.
1223
 
1224
      Note: LMOS is not fully supported by VIX on the COBRA platform.
1225
            LMOS should not be used on the COBRA.
1226
 
1227
Internal:
1228
    * Jats Utility: JatsFileUtil usage
1229
      Better handling of files with nasty characters(%'&) in them.
1230
      Now use a modified Url encoding scheme to pass them into JatsFileUtil
1231
      JatsFileUtil Will perform Url decoding of all arguments
1232
 
1233
------------------------------------------------------------------------
2478 dpurdie 1234
Version:  3.1.2000.cr                               Released: 15-Nov-12
1235
------------------------------------------------------------------------
1236
Major changes:
1237
 
1238
Minor changes:
1239
    * Makefile Generation.
1240
      Fixed issue with packaging files with a single quote(') in the name
1241
 
1242
------------------------------------------------------------------------
2450 dpurdie 1243
Version:  3.1.1000.cr                               Released: 14-Nov-12
1244
------------------------------------------------------------------------
1245
Major changes:
1246
 
1247
Minor changes:
1248
    * Makefile generation
1249
      Warning generation of bad source paths does not generate an error
1250
      if the path test escapes the directopry tree. It will generate a
1251
      warning, which allows the build to progress as before - with lots
1252
      of warnings.
1253
 
1254
    * Makefile Generation
1255
      BuildSubDir and SubDir directives - cleanup paths.
1256
 
1257
    * Jats Utility: JatsFileUtil
1258
      Better handling of double '\' in pathnames under windows.
1259
 
1260
 
1261
------------------------------------------------------------------------
2439 dpurdie 1262
Version:  3.1.0000.cr                               Released: 08-Nov-12
2429 dpurdie 1263
------------------------------------------------------------------------
1264
Major changes:
1265
    * Make-time performance improvement of packaging
1266
      Improved the performance of the 'packaging' and 'installing' operations
1267
      by an order of magnitude under windows. Replaced the shell scripting of
1268
      these operations with a dedicated program.
1269
 
1270
      This change also addressed a long-time Windows issue with the packaging
1271
      of files into very long (>~250) paths as the utility supports the full
1272
      windows path scheme.
1273
 
1274
Minor changes:
1275
    * Command Changes: jats clobber
1276
      The 'jats clobber' command has been significantly sped up
1277
      The 'clobber' no longer unpackages and uninstalls files one by one
1278
      from the relevant directories. The entire directory is deleted.
1279
 
1280
      The original sequence can still be perform, if required, with the commands
1281
        jats make clobber
1282
      This operates as before.
1283
 
1284
    * Utility: escrow
1285
      Support to extract packages with a subdirectory structure that
1286
      breaks the JATS rule that the TTB directory names are reserved.
1287
      Some COTS packages break the rule.
1288
 
1289
    * Utility: svn : delete-branch
1290
      Modified the svn branch deletion operation.
1291
        With no arguments it will show the current branch.
1292
 
1293
    * Utility: svn : url
1294
      Improved the conversions supported. Now handles leading SVN::
1295
      and will decode tags of the form SVN::path::tag
1296
 
1297
    * Utility: svn : import
1298
      Added a '-nocommit' option to allow the results of the import to be
1299
      inspected before committing them to the Repository.
1300
 
1301
    * Subversion Support
1302
      Detect authentication errors and issue user-friendly error messages
1303
      showing the user what to do.
1304
 
1305
      The special label of TIMESTAMP now creates a tag with a .WIP
1306
      suffix. This allows the tag to be deleted in the VIX protected
1307
      repositories.
1308
 
1309
------------------------------------------------------------------------
2078 dpurdie 1310
Version:  3.0.5000.cr                               Released: 05-Oct-12
1311
------------------------------------------------------------------------
1312
 
1313
Minor changes:
1314
    * Jats build
1315
      Added a '-nopackages' option to allow the creation of version information
1316
      files under conditions where the external packages are not available, such
1317
      as within a JATS Sandbox.
1318
 
1319
      This option is intended to be used in conjunction with the 'interface'
2080 dpurdie 1320
      command, with a sandbox.
2078 dpurdie 1321
 
1322
      ie: jats sandbox cmd -keepgoing build interface -nopackages
1323
 
1324
------------------------------------------------------------------------
2054 dpurdie 1325
Version:  3.0.4000.cr                               Released: 27-Sep-12
2049 dpurdie 1326
------------------------------------------------------------------------
1327
 
1328
Minor changes:
1329
    * Utility: svn
1330
      Added two subcommands
1331
        branch - to create a branch within a workspace
1332
        switch - to switch a workspace to a branch, or tag.
1333
                 Can also display available branches.
1334
 
2054 dpurdie 1335
    * Utility: sandbox. Subcommand: cmd
1336
      Added '-keepgoing' option to allow the user to ignore errors
2040 dpurdie 1337
 
1338
    * Utility: rtag_extract
1339
        * Added -[no]log option to control the output
1340
        * Extended the examples in the documentation
1341
 
1342
    * Utility: svnrelease and svnextract
1343
      Modified the way that branches are created and used.
1344
      Modified two options:
1345
        -mkbranch=name. Will create a branch while extracting the package
1346
                        The named branch must not exist
1347
        -branch=name.   Will extract the head of the named branch - if it exists
1348
                        The named branch must exist
1349
      The two options are mutually exclusive.
1350
 
1351
------------------------------------------------------------------------
2017 dpurdie 1352
Version:  3.0.3000.cr                               Released: 24-Sep-12
1353
------------------------------------------------------------------------
1354
 
1355
Minor changes:
1356
    * Utility: rtag_extract
1357
      The following enhancements have been made to this utility
1358
        * Only allow extracting into a jats sandbox
1359
        * Create workspaces with a name that is the package name
1360
        * Skip extraction of a package if it already exists in the sandbox
1361
 
1362
------------------------------------------------------------------------
1456 dpurdie 1363
Version:  3.0.2000.cr                               Released: 21-Sep-12
1364
------------------------------------------------------------------------
1365
 
1366
Minor changes:
2017 dpurdie 1367
    * Utility: svnrelease and svnextract
1456 dpurdie 1368
      The name of the directory into which the package will be etracted
1369
      has been greatly simplified, under most cases.
1370
 
1371
------------------------------------------------------------------------
1447 dpurdie 1372
Version:  3.0.1000.cr                               Released: 18-Sep-12
1373
------------------------------------------------------------------------
1374
 
1375
Minor changes:
1376
    * Utility: svnrelease
1377
      Correctly handle build files that are not in the root directory
1378
      Missed in previous release.
1379
 
1380
------------------------------------------------------------------------
1381
Version:  3.0.0000.cr                               Released: 13-Sep-12
1382
------------------------------------------------------------------------
1383
 
1384
Major changes:
1385
    * Jats Version Number
1386
      Rolled to version 3 as the build number was confusingly high
1387
      Although the major version number has changed, JATS has not changed
1388
      significantly.
1389
 
1390
Minor changes:
1391
    * Makefile Generation
1392
      Packing of directories filters out .svn subdirectories
1393
 
1394
    * Utility: svnrelease
1395
      Correctly handle build files that are not in the root directory
1396
 
1397
------------------------------------------------------------------------
1403 dpurdie 1398
Version:  2.101.0000.cr                               Released: 11-Sep-12
1399
------------------------------------------------------------------------
1400
Major changes:
1401
    * Subversion support
1402
      Multiple changes to subversion support to simplify development with
1403
      SubVersion. Changes include:
1404
        - New VcsTag that has a path and a tag component
1405
        - Multiple extraction modes with checks to highlight unexpected
1406
          file changes between workspace and branch head.
1407
 
1408
Minor changes:
1409
    * Utility: New utility - rtag_extract
1410
      Tool to extract a set of packages based on a Release Manager Release.
1411
      Can limit the files extracted to one or more paths, or a list of packages.
1412
      Provides supervised extraction of the set of packages.
1413
      Use 'jats man rtag_extract' or online documentation.
1414
 
1415
    * Utility: svnsave_build
1416
      Failure to change the author of the build is not an error.
1417
      This allows for non-standard repositories being used during consolidation
1418
 
1419
    * Linux support utilities
1420
      Add a version of 'addr2line' that understands the ELF file format
1421
      which has debug information striped out into a separate file.
1422
      Used to support backtracing within unit tests.
1423
 
1424
------------------------------------------------------------------------
1329 dpurdie 1425
Version:  2.100.6000.cr                               Released: 30-Jul-12
1426
------------------------------------------------------------------------
1427
Major changes:
1428
    * Subversion Repository location
1429
      The correct paths to the various SubVersion repositories is:
1430
        GBE_SVN_URL_AUPERASVN01: https://auperasvn01.aupera.erggroup.com/svn
1431
        GBE_SVN_URL_FRBESASVN01: http://frbesasvn01.frbesa.erggroup.com/svn
1432
      Windows users may need to update there jats.bat file.
1433
      These are Fully Qualified Domain Names.    
1434
 
1435
Minor changes:
1436
    * Jats startup warning introduced in 2.100.5000.cr
1437
      Now accepts both / and \ as path separators.
1438
 
1439
    * Utility: svnrelease
1440
      Modified the operation of the '-branch' to better mimic the ClearCase
1441
      operation of the same command. If the specified branch exists, then it
1442
      will be used, otherwise it will be created based on the specified tag.
1443
 
1444
    * Utility: svnsave_build
1445
      Modify the operation such that the 'author' of the saved build is set to
1446
      that of the user that created the version that that build is based upon.
1447
      This preserves the history of the build a lot better than tagging all
1448
      builds as being done by 'buildadm'.
1449
 
1450
    * Utility: ccdelete_view
1451
      Allow the user to specify ClearCase viewtags or a viewstore path.
1452
 
1453
    * Utility: sandbox
1454
      Added options to control the packages processed. The user can specify
1455
      a range of packages and exclude or include specific packages.
1456
 
1457
      Subcommand: populate
1458
      Added -exclude=name[,name]+ to allow specific packages to be excluded
1459
      Add -all option to force dependency testing of packages already in the
1460
      sandbox.
1461
 
1462
    * Subversion Support
1463
      With an automated build environment the use of a default Subversion
1464
      repository is not supported.
1465
 
1466
      Creating a workspace will display the files being extracted providing
1467
      a progress indication.
1468
 
1469
    * Jats Online Documentation
1470
      Migrated several items from the VIX Wiki to the FAQ section of the
1471
      online documentation.
1472
 
1473
    * Generated makefiles
1474
      Improved tracing of package archive source in comments
1475
 
1476
------------------------------------------------------------------------
401 dpurdie 1477
Version:  2.100.5000.cr                               Released: 28-May-12
399 dpurdie 1478
------------------------------------------------------------------------
1479
Major changes:
1480
 
1481
Minor changes:
1482
    * New Platform: WCENAUTIZX5
1483
     "Nautiz eTicket Pro" built under VS2005
1484
 
400 dpurdie 1485
    * Jats startup will warn Windows Users if jats.bat does not
1486
      link to the dynamically updated version of JATS. 
1487
 
399 dpurdie 1488
Internal:
1489
    * Corrected error handling in Release Manager Database connection
1490
      Worked on Windows, but not linux.
1491
 
1492
------------------------------------------------------------------------
387 dpurdie 1493
Version:  2.100.4000.cr                               Released: 30-Apr-12
1494
------------------------------------------------------------------------
1495
Major changes:
1496
 
1497
Minor changes:
1498
    * Jats makefile directive: MakeProject
1499
      Improved support for packaging files with spaces and other make-unfriendly
1500
      characters in their pathname.
1501
 
1502
------------------------------------------------------------------------
385 dpurdie 1503
Version:  2.100.3000.cr                               Released: 20-Apr-12
1504
------------------------------------------------------------------------
1505
Major changes:
1506
 
1507
Minor changes:
1508
    * Platform: VIXITP
1509
      Minor enhancements
1510
 
1511
    * JATS wrappers
1512
      Updated default paths to Subversion Servers
1513
 
1514
    * Subversion Support
399 dpurdie 1515
      Added svn delete-branch
385 dpurdie 1516
 
1517
------------------------------------------------------------------------
383 dpurdie 1518
Version:  2.100.2000.cr                               Released: 13-Apr-12
1519
------------------------------------------------------------------------
1520
Major changes:
1521
 
1522
Minor changes:
387 dpurdie 1523
    * GCC Toolmaking
383 dpurdie 1524
      Use JATS' internal dependency generator. This is much faster than the
1525
      use of the gcc as previously implemented.
1526
 
1527
    * New Platform: VIXITP
387 dpurdie 1528
      Specialized platform for the VIX 'ITP' product.
383 dpurdie 1529
 
1530
    * Subversion Support
1531
      Documented the use of 'TIMESTAMP' in svn commands
1532
      svnrelease. The -branch option supports the special name TIMESTAMP
1533
 
1534
 
1535
------------------------------------------------------------------------
381 dpurdie 1536
Version:  2.100.1000.cr                               Released: 28-Mar-12
1537
------------------------------------------------------------------------
1538
Major changes:
1539
 
1540
Minor changes:
1541
    * Jats makefile directive: MakeLinuxDriver
1542
      Added support for source files not in the same directory as the
1543
      makefile.
1544
 
1545
    * Jats makefile directives: SharedLib and Lib
1546
      Improved support for named source files with directory elements
1547
 
1548
------------------------------------------------------------------------
379 dpurdie 1549
Version:  2.100.0000.cr                               Released: 23-Mar-12
1550
------------------------------------------------------------------------
1551
Major changes:
1552
 
1553
    * WIN32 Target (Visual Studio 6)
1554
      This target will now consume headers/libraries from a VS6 directory.
1555
      This has been provided to allow the use of Dinkumware_STL to be limited
1556
      to this one compiler. Specifically we need to excluded the use of
1557
      Dinkumware from VS2010 builds.
1558
 
1559
    * C# Toolchain
1560
      Correctly detect missing .cs file in .resx /.cs file pair.
1561
 
1562
Minor changes:
1563
    * Jats wrapper script
1564
      New option: -logfile=name
1565
 
1566
    * Jats configuration
1567
      jats.bat example (Windows)
1568
      jats.sh example (Unix)
1569
      Redefined location of the Perth Subversion server AUPERASVN01
1570
 
1571
    * Escrow build on solaris_x86
1572
      Added workaround for strange issue on X86 based Solaris machines
1573
      The GBE_MACHTYPE EnvVar would disappear during the build process
1574
 
1575
    * Utility ccrelease
1576
      The -extractfiles option nolonger uses a dynamic view to perform the
1577
      extraction. It uses the same process as normal view creation.
1578
 
1579
    * Utility: svn
1580
      Improved package import processing.
1581
      Allow Date, Author and Log to be added to the imported package
1582
 
1583
    * Jats Utility: gen_cots
1584
      Added support for Subversion.
1585
      Subversion is supported on Windows and Unix.
1586
      ClearCase is supported on Windows.
1587
 
1588
    * Jats Utility: vcsdiff
1589
      New Utility. Will diff two versions of a package. Supports
1590
      mixed ClearCase and Subversion versions.
1591
      Under windows it can invoke BeyondCompare
1592
      Under Windows and Unix it can perform a MD5 check over both directories.
1593
 
1594
------------------------------------------------------------------------
377 dpurdie 1595
Version:  2.99.2000.cr                               Released: 3-Feb-12
1596
------------------------------------------------------------------------
1597
Major changes:
1598
 
1599
Minor changes:
1600
    * BuildVersion directive
1601
      Updated Company Name, Copyright and Trademark strings to 'Vix IP Pty Ltd'
1602
 
1603
    * GCC Toolset
1604
      Added support for filterering warning messages, via a warnings.gcc file
1605
 
1606
------------------------------------------------------------------------
375 dpurdie 1607
Version:  2.99.1000.cr                               Released: 13-Jan-12
1608
------------------------------------------------------------------------
1609
Major changes:
1610
 
1611
Minor changes:
1612
    * Command: jats clobber
1613
      When building packages that use deploylib - remove the 'build/deploy'
1614
      directory as a part of the clobber processing.
1615
 
1616
    * Jats wrapper. Environment Variable Cleanup (Windows Only)
1617
      Force ALL EnvVars stored in the environment and passed to programs
1618
      invoked by JATS to be converted to upper case.
1619
 
1620
      This solves problems associated with some programs that do not treat
1621
      Windows EnvVars as case insensitive.
1622
 
377 dpurdie 1623
      A useful side effect of this change is that VS2010 running on
1624
      64-bit Windows-7 will now locate the default installation of VS2010, as
1625
      will many other toolsets.
375 dpurdie 1626
 
1627
    * jats svnlabel
1628
      Report conflicting options: Label and Clone
1629
 
1630
      Correct the 'label' operation. The user is not allowed to provide
1631
      path. The user must provide a simple label. JATS will determine the
1632
      workspace and the correct branch/tag to place the label in.
1633
 
1634
    * Built Daemon support
1635
      jats_svn_savebuild will now delete a WIP if its in the /tags/ directory.
1636
      This allows WIPs to be tags or branches
1637
 
1638
------------------------------------------------------------------------
373 dpurdie 1639
Version:  2.99.0000.cr                               Released: 06-Jan-12
1640
------------------------------------------------------------------------
1641
Major changes:
1642
    * GCC Toolset
1643
      Modified the creation and maintenance of debug information.
1644
      New methodology is:
1645
        Debug information is created for both production and debug builds
1646
        Debug information is placed in a .dbg file, which is linked to the
1647
        executable, or shared library. The .dbg file is packaged in the manner
1648
        as the main binary.
1649
 
1650
      This methodology does not bloat the binary with debug information, while
1651
      retaining debug information. The binary transferred to an embedded
1652
      device does not contain debug information, yet the image used in the
1653
      debugger can still access the debug information. This is the best of
1654
      both worlds.
1655
 
1656
Minor changes:
1657
    * HTML Documentation
1658
      JatsWelcome.html - Extended references to BMS documentation.
1659
 
1660
Internal changes:
1661
    * Generated makefiles
1662
      Removed the make_usage target as it is inaccessible. It was replaced by
1663
      jmake's 'help' command a long time back.
1664
 
1665
------------------------------------------------------------------------
371 dpurdie 1666
Version:  2.98.4000.cr                               Released: 23-Dec-11
1667
------------------------------------------------------------------------
1668
Major changes:
1669
    * Jats Sandbox
1670
      Softlinks to packages within the sandbox are now relative to the root of
1671
      the sandbox. This allows packages in the sandbox to be created under one
1672
      machine architecture and consumed under another.
1673
 
1674
    * RIORDS Platform
1675
      Generate output files with the package version embedded in the name
1676
      This can be disabled with --NoVersion
1677
 
1678
      Package up the 'hex' file created when the .img file is processed.
1679
 
1680
 
1681
Minor changes:
1682
    * Processing makefile.pl
1683
      Better handling of some shared library arguments for undeclared files
1684
      Error detection of some arguments that start with white-space
1685
 
1686
------------------------------------------------------------------------
369 dpurdie 1687
Version:  2.98.3000.cr                               Released: 14-Dec-11
1688
------------------------------------------------------------------------
1689
Major changes:
1690
 
1691
Minor changes:
1692
    * New Platform and Toolchain
371 dpurdie 1693
      Platform is RIORDS. This uses the MSP430 toolchain.
369 dpurdie 1694
      Beta release of this toolchain
1695
 
1696
    * Jats Escrow. Escrow extraction
1697
      Force views created to be done in the same manner as the build daemon.
1698
      Under Clearcase, do not include the /main/0 rule.
1699
 
1700
    * Utility: ccrelease (jats release, jats extract)
1701
      Correct use of /main/0 on Unix platforms to match Windows behavior.
1702
      Only add /main/0 if the user has provided a path to a directory within
1703
      a vob.
1704
 
1705
    * Various changes to remove warnings when used with perl 5.14.
1706
      Note: Perl 5.14 is not recommended.
1707
            Perl 5.8.8 is recommended.
1708
 
1709
    * Windows utilities
1710
      Updated 7z to version 9.20.
1711
 
1712
    * Subversion Support
1713
      Support for 1.7 error messages
1714
      Extended the 'jats svn' utility. New subcommands:
1715
        paths - Display Subversion tag to URL conversions
1716
        tag   - Convert a path or URL to a Release Manager Tag
1717
        url   - Convert Release Manager tag to URL
1718
 
1719
    * COBRA Toolset
1720
      Suppress compiler warning on incompatible ABI
1721
 
1722
    * Create dpkg utility
1723
      Allows packaging from a sandbox, but only of package versions 99.99.99
1724
 
1725
Internal changes:
1726
    * Generated makefiles are now dependent on DPACKAGE files from dependant
1727
      packages, if present.
1728
 
1729
------------------------------------------------------------------------
367 dpurdie 1730
Version:  2.98.2000.cr                               Released: 15-Nov-11
1731
------------------------------------------------------------------------
1732
Major changes:
1733
 
1734
Minor changes:
1735
    * Jats Utility:
1736
      Added 'ccdelete_view'. This utility will delete a Clear Case view given a
1737
      viewtag, even if the view has been deleted from disk.
1738
 
1739
    * Jats startup
1740
      Jats will report an error if started in a directory that is inaccessible
1741
      to the user. An error will also be report if jats is directed to change to
1742
      in inaccessible directory.
1743
 
1744
    * Building an ANT project.
1745
      Jats will warn if a buildfile does not have an associated depends file.
1746
 
1747
    * TOOLSET: GCC
1748
      The 'options=args' now shows the operation of the dependency generation step.
1749
 
1750
    * TOOLSET: WINCE
1751
      Better detection of missing SDK components.  
1752
 
1753
    * Subversion support
1754
      Allow untrusted certificates in https connections.
1755
      VisualSvnServer provides self signed certificates
1756
 
1757
Internal:
1758
    * Makefile generation
1759
        Removed the use of the .rul file. Now generated in place.
1760
        Removed PLATFORM.mk dependencies. Work is done in jmake.
1761
 
1762
------------------------------------------------------------------------
365 dpurdie 1763
Version:  2.98.1000.cr                               Released: 15-Sep-11
1764
------------------------------------------------------------------------
1765
Major changes:
1766
 
1767
Minor changes:
1768
    * Utility: cclabel
1769
      Handle VCS tags of the form CC::path::label and extract the vob name and
1770
      the clearcase label.
1771
 
1772
    * Subversion support
1773
      Report errors when required utilities cannot be found
1774
      Delay reporting until utilities are required to allow the help system
1775
      to operate.
1776
 
1777
------------------------------------------------------------------------
363 dpurdie 1778
Version:  2.98.0000.cr                               Released: 09-Aug-11
1779
------------------------------------------------------------------------
1780
Major changes:
1781
    * New toolset: ARM251
1782
 
1783
    * New target platform: ARM_I5100
1784
      Uses the ARM251 toolset.
1785
 
1786
Minor changes:
1787
    * HTML Help
1788
      Correct display of subheadings in the Table of Contents under IE8
1789
 
1790
    * jats build -noforce
1791
      The 'quick' test to force a re-build now takes the value of
1792
      GBE_BUILDFILTER into account. If the value changes, then a rebuild will
1793
      be forced.
1794
 
1795
      This affect the 'jats all' and associated 'sandbox' commands.
1796
 
1797
    * Utility: ccrelease (jats release, jats extract)
1798
      Improved the ClearCase config spec used to create the view.
1799
 
1800
      If the command specifies a branching rule, then the view will not allow
1801
      directories above the package base to be branched. This will prevent
1802
      unintentional branching within the root of the VOB.
1803
 
1804
      If the command does not specify a branching rule, the view now allows
1805
      files and folders to be 'added' within the view, within the package. This
1806
      feature is suppressed when the tool is used by the AutoBuilder, or when
1807
      the load path contains only the name of the VOB.
1808
 
1809
    * Utility: svnrelease
1810
      Remove duplicate package-name words from the generated workspace name to
1811
      provide a cleaner workspace name.
1812
 
1813
      Allow the workspace to be deleted in 'release' mode by changing out of the
1814
      workspace directory before attempting the delete.
1815
 
1816
    * Utility: svn
1817
      Added 'test' to verify that the subversion CLI utility has been
1818
      installed and can be used.
1819
 
1820
    * Toolset: CSharp
1821
      Utilize features of cmdfile to simplify the generated makefile
1822
      Force the generated command file to have correct directory separation
1823
      character.
1824
 
1825
    * Toolset: SunWorks
1826
      Corrected usage of the -erroff directive
1827
      The later SunWorks compilers are more strict about its usage.
1828
      May affect 64 Solaris builds as the incorrect usage may have been
1829
      masking an error.
1830
 
1831
    * Toolset: Delphi7
1832
      Correct library building process that had been broken by previous
1833
      enhancement.
1834
 
1835
    * Toolset: dafbr
1836
      Internal option to simplify compiler testing
1837
 
1838
    * makefile.pl directive: GenerateFiles and RunTests
1839
      Corrected operation of the '--PackageInfo' expansion
1840
        - Return correct path to package
1841
        - If no info is selected, then assume '--path'
1842
 
1843
    * build.pl directive: BuildPlatforms
1844
      Added a '--Alias=Name[,Name]+' option. This allows the setting of
1845
      a platform alias, when the platform is defined.
1846
 
1847
    * build.pl directive: BuildVersion
1848
      Generate well formed VB6 definitions for packages that have dependent
1849
      packages.
1850
 
1851
    * make command: show
1852
      Improved the readability of the 'Alias Targets' list in the
1853
      'jats make show' command.
1854
 
1855
    * Utility: create_dpkg
1856
      When transferring files from a Windows file system to dpkg_archive
1857
      ensure that the execute permission is set for all users.
1858
 
1859
      Allows 'GENERIC' packages to package up executables that will be
1860
      executed on Unix machines.
1861
 
1862
------------------------------------------------------------------------
361 dpurdie 1863
Version:  2.97.0000.cr                               Released: 24-Jun-11 
1864
------------------------------------------------------------------------
1865
Major changes:
1866
    * HTML Help (Experimental)
1867
      Generated documentation for the various JATS utilities
1868
      It is based on the internal JATS documentation available on the command
1869
      line.
1870
 
1871
      Use http://auperaunx26.aupera.erggroup.com/devl/core_devl2/HTML/index.html
1872
 
1873
Minor changes:
1874
    * PackageFile directive
1875
      Allow packaging of files with a comma in the name.
1876
      Used by some COTS packages.
1877
 
1878
    * Windows utilities used by jats
1879
      stdmux and rpccpp: provide production versions that do not use debug
1880
      libraries as these are not present for all users.
1881
 
1882
    * Jats utility: dstatus
1883
      Shows the user friendly host name rather then the internal machine name.
1884
      This change is in line with the changes to Release Manager
1885
 
1886
    * Utility: svnrelease
1887
      Better deletion of workspaces referenced with non-standard URLs
1888
      Corrected problem with -branch=name option
1889
 
1890
    * Utility: svnrelease and ccrelease
1891
      Better deletion of workingspace directory.
1892
      Attempt to correct for directory permission problems.
1893
 
1894
    * Updated definition of GBE_SVN_URL_FRBESASVN01 to use
1895
      the server by name, rather than IP address: 'frbesasvn01'
1896
 
1897
    * Added EnvVar GBE_VCS to control the default Version Control System
1898
      employed by the 'jats release' and 'jats extract' commands.
1899
 
1900
      Usable values are: 'cc' and 'svn'.
1901
      The default value is 'cc', providing backward compatability to existing
1902
      developers.
1903
 
1904
 
1905
------------------------------------------------------------------------
359 dpurdie 1906
Version:  2.96.4000.cr                               Released: 06-May-11
1907
------------------------------------------------------------------------
1908
Major changes:
1909
 
1910
Minor changes:
1911
    * WIN32 Toolset
1912
      Remove .exp and .lib files that may be created when building a program.
1913
      These files may be generated when using code to create a DLL is used
1914
      to create an EXE.
1915
 
1916
    * Utility: upddep
1917
      Handle packages with version strings like: 1.6.0,REV=2006.11.29.05.03
1918
      The '=' was causing issues.
1919
 
1920
    * Utility: sandbox
1921
      New sub command - populate. Beta Release of this command
1922
      This sub command can be used to populate a sandbox with a specific package
1923
      and (optionally) its dependents, that (optionally) are not available
1924
      in a package archive.
1925
 
1926
      Sub command: create
1927
      New option '-exact'. This will create a sandbox in which the package
1928
      version numbers are significant. This is useful when recreating a specific
1929
      package version.
1930
 
1931
      Command specific help
1932
      Each sub command now has its own help.
1933
      ie: 'jats sandbox populate -help' will provide help on the populate
1934
      command.
1935
 
1936
    * BuildVersion directive
1937
      Will create well formed Windows Resource files when the Packages Build
1938
      Number is greater than 7.
1939
 
1940
Internal:
1941
    * Removed jats_save_build.pl
1942
      No longer used by the build tool.
1943
 
361 dpurdie 1944
------------------------------------------------------------------------
357 dpurdie 1945
Version:  2.96.3000.cr                               Released: 14-Mar-11
1946
------------------------------------------------------------------------
1947
Major changes:
1948
 
1949
Minor changes:
1950
    * Minor tweaks for WCEIPA280 support
1951
 
1952
    * Build tool support: jats_vcssave_build
1953
      Deprecated unused options.
1954
 
361 dpurdie 1955
------------------------------------------------------------------------
355 dpurdie 1956
Version:  2.96.2000.cr                               Released: 10-Mar-11
1957
------------------------------------------------------------------------
1958
Major changes:
1959
 
1960
Minor changes:
1961
    * New WinCE platform: WCEIPA280
1962
      Uses VS2005 and the IPA280 SDK from Ingenico
1963
 
361 dpurdie 1964
------------------------------------------------------------------------
353 dpurdie 1965
Version:  2.96.1000.cr                               Released: 09-Mar-11
1966
------------------------------------------------------------------------
1967
Major changes:
1968
 
1969
Minor changes:
1970
    * EnvVars
1971
      Support for GBE_SVN_URL_xxx to support multiple SubVersion repositories
1972
      at multiple locations.
1973
 
1974
    * Build tool support: jats_vcssave_build
1975
      New option -isawip to allow deprecation of -wiplabel option in
1976
      a future release.
1977
 
361 dpurdie 1978
------------------------------------------------------------------------
351 dpurdie 1979
Version:  2.96.0000.cr                               Released: 01-Mar-11
1980
------------------------------------------------------------------------
1981
Major changes:
1982
    * CSHARP2010 target
1983
      Force all C# compilations to be targeted at a 32-bit platform.
1984
 
1985
Minor changes:
1986
    * jats escrow utility
1987
      Uses VcsTag and jats_vcsrelease to be version control system agnostic.
1988
 
361 dpurdie 1989
------------------------------------------------------------------------
349 dpurdie 1990
Version:  2.95.1000.cr                               Released: 14-Feb-11
1991
------------------------------------------------------------------------
1992
Patch changes:
1993
    * Built Tool Interface Changes
1994
        Rename jats_vcs_save_build.pl to jats_vcssave_build.pl
1995
        Rename jats_release.pl to  jats_vcsrelease.pl
1996
      to create a consistent naming convention for the buildtool
1997
      interface to Version Control System aware tools.    
1998
 
361 dpurdie 1999
------------------------------------------------------------------------
347 dpurdie 2000
Version:  2.95.0000.cr                               Released: 11-Jan-11
2001
------------------------------------------------------------------------
2002
Major changes:
2003
    * Initial (experimental) support for VS2010, both for C# and C/C++
2004
    Introduces two new platforms:
2005
        CSHARP2010 (.NET 4.0)
2006
        VS2010
2007
 
2008
Minor changes:
2009
    * jats_rewrite - used only by the build daemons
2010
      Better handling of 'cots' packages.
2011
 
2012
    * jats upddep utility
2013
      Add -keep option to retain the config data extracted from the
2014
      Release Manager data base for diagnistic use.
2015
 
2016
    * Added Linux profile scripts to build installers
2017
      Added TEMPLATES/INSTALL to the packaged version of JATS
2018
      Support for Linux under
2019
        RHEL4
2020
        Ubuntu 10.04
2021
 
2022
Internal:
2023
    * System(--Shell) escaping - improved.
2024
      Only escape spaces if there are multiple arguments.
2025
 
2026
------------------------------------------------------------------------
345 dpurdie 2027
Version:  2.94.0000.cr                               Released: 16-Dec-10
227 dpurdie 2028
------------------------------------------------------------------------
345 dpurdie 2029
Major changes:
2030
 
2031
Minor changes:
2032
    * New target platform - PHP
2033
      This target is only available on a Windows Platform. It is used to limit
2034
      the processing of PHP artifacts by the ZendGaurd.
2035
 
2036
    * Utility: cache_dpkg
2037
      Used internally to cache packages to a local archive.
2038
      When an error is encountered in the transfer the utility will now
347 dpurdie 2039
      correctly delete the package that it was transferring. Previously it
345 dpurdie 2040
      could leave a partially transferred package.
2041
 
2042
    * Utility: create_dpkg [DEVI-063950 ]
2043
      Creates build.<MachineName> marker files as well as built.<MachType>.
2044
      Partial work for DEVI-063950
2045
 
2046
    * makefile.pl directives
2047
      Corrects and extended the operation of the platform-specifier.
2048
      All non-platform options must be true, while the platform names are
2049
      treated as before - any of them may be true. See MASS-00166 for full
2050
      details.
2051
 
2052
Internal:
2053
    * System(--Shell) operations will escape spaces in the argument
2054
      Allows the use c:\Program Files\... in path elements.
2055
 
2056
------------------------------------------------------------------------
343 dpurdie 2057
Version:  2.93.0000.cr                               Released: 03-Dec-10
2058
------------------------------------------------------------------------
2059
Major changes:
2060
 
2061
Minor changes:
2062
    * Jats Sandbox operation
2063
      Don't remove .RUL files in sandbox testing of the build files
2064
 
2065
    * Jats MakeProject directive
2066
      Added --TargetDebug= and --TargetProd=  to allow the default target
2067
      of the project builds to be specified.
2068
 
2069
      Can be used in all targets that use a Visual Studio project or solution
2070
      to build a package.
2071
 
2072
    * MergeLibrary directive
2073
      New sub-option --InterfacePlain
2074
      This will allow the use of 3rd party libraries that do not have a P or D
2075
      suffix in the library name.
2076
 
2077
    * GenerateFiles directive
2078
      Use of --Var(ObjDir) will cause the Object directory to a prequisite
2079
      of the command. Similar for BinDir and LibDir.
2080
 
2081
    * BuildPlatform
2082
      New option: --NoToolSet
2083
      Supresses the check for the existance of the underlying toolset.
2084
      Ensures that the user does not attempt to use the underlying toolset.
2085
 
2086
      To be used in packages that generate installers, where there is
2087
      no compilation phase, but the package search mechanism may still
2088
      need toolset specific information.
2089
 
2090
      Normally used in conjunction with --OnlyProd.
2091
 
2092
      eg: BuildPlatforms ( 'WIN32,--OnlyProd,--NoToolSet' );
2093
 
2094
Internal:
2095
    * Jats EnvVars, ccrelease and svnrelease
2096
      Factored out the default value of GBE_VIEWBASE and associated
2097
      processing into jats.pl
2098
 
2099
      Expect GBE_VIEWBASE to be site specific. Defaults are suitable for
2100
      a ClearCase site.
2101
 
2102
------------------------------------------------------------------------
341 dpurdie 2103
Version:  2.92.0000.cr                               Released: 08-Nov-10
2104
------------------------------------------------------------------------
2105
Major changes:
2106
 
2107
Minor changes:
2108
    * DEVI-059977: 64-bit Solaris libraries try to link against 32-bit libs
2109
      The 64-bit Solaris build will no longer attempt to consume 32-bit
2110
      libraries or header files.
2111
 
2112
    * New tool update_release
2113
      Extracts current package version list from Deployment Manager SBom(s)
2114
      and copy resultant packages to release specific directory.
2115
 
2116
      Use 'jats man update_release' for full details
2117
 
2118
    * New tool ccmerge_build
2119
      Merge an autobuilt build.pl file back to the parent branch
2120
      and leave the resultant file checked out.
2121
 
2122
      Use 'jats man ccmerge_build' for full details
2123
 
2124
    * Jats Sandbox command
2125
      Improved operation of 'sandbox all' and packages that use
2126
      BuildPkgArchive.
2127
 
2128
    * GCC and SUNWORKS tools
2129
      Allow shlib dependency generation to be displayed in verbose mode
2130
 
2131
Internal:
2132
    * Work for subversion support
2133
 
2134
    * Build
2135
      Use Perl 'File' operations instead of system function to delete
2136
      directories. Is faster under Windows.
2137
 
2138
------------------------------------------------------------------------
339 dpurdie 2139
Version:  2.91.0000.cr                               Released: 15-Sep-10
2140
------------------------------------------------------------------------
2141
Major changes:
2142
    * SharedLib directives for Solaris and GCC targets
2143
      Added support to control the 'soname' embedded within the shared
2144
      library. Refer the MASS-00166 for full details. Use with care.
2145
 
2146
------------------------------------------------------------------------
337 dpurdie 2147
Version:  2.90.0000.cr                               Released: 14-Sep-10
2148
------------------------------------------------------------------------
2149
Major changes:
2150
    * New platform - 'COBRA'.
2151
      Support for the ARM926EJS based hardware.
2152
      This is a Linux based target.
2153
      Requires a new compiler to be installed into build machines
2154
 
2155
Minor changes:
2156
    * Jats sandbox command
2157
      Basic support for the 'cache' command.
2158
      Allows external dependent packages to be cached for disconnected
2159
      development.
2160
 
2161
------------------------------------------------------------------------
335 dpurdie 2162
Version:  2.89.0000.cr                               Released: 13-Sep-10
2163
------------------------------------------------------------------------
2164
Major changes:
2165
    * [DEVI-062103]
2166
      Many (11) toolsets - all that generate linker dependency
2167
      files for creating shared libraries or programs.
2168
        Solaris, Gcc, WIN32, Wince, MOS, Verix, Keil, AVR_IAR,
2169
        CSHARP, MCR, Pharlap.
2170
 
2171
      Better, simpler, and in some cases correct, generation
2172
      of dependency files used in linking. Also generate separate
2173
      files for Production and Debug builds.
2174
 
2175
Minor changes:
2176
    * Jats sandbox command
2177
      The 'info' subcommand will highlight external packages that cannot be
2178
      found in any of the the package archives.
2179
 
2180
    * Jats release -extract
2181
      The ClearCase view that is created will have a comment tag added that
2182
      describes:
2183
        - the directory in which the user created the view
2184
        - the date of creation
2185
 
2186
    * PackageFile directive
2187
      Now supports --NoRecurse and --Recurse in conjunction with --DirTree
2188
 
2189
Internal:
2190
    * PackageFile, PackageHdr and InstallHdr directives
2191
      Removed --Abs option - its not supported
2192
      Fixed --Full option.
2193
 
2194
------------------------------------------------------------------------
2195
Version:  2.88.0000.cr                               Released: 26-Jul-10
2196
------------------------------------------------------------------------
2197
Major changes:
2198
 
2199
Minor changes:
2200
    * Dependency Generation Tool - mkdepend
2201
      Correct a problem encountered when the name of an included file
2202
      matches the name of a subdirectory within the include search path
2203
      resulting in multiple builds.
2204
 
2205
    * SOLARIS and LINUX toolsets
2206
      Corrected problem in dependency tracking of shared libraries
2207
      Dependency between shared librares was not being used at all.
2208
 
2209
      Only affected Solaris and Linux builds
2210
 
2211
      Still an issue that affect all platforms that build shared libaries.
2212
      Dependency tracking does not work correctly for both debug and
2213
      production builds. It will work for the first one done.
2214
 
2215
------------------------------------------------------------------------
331 dpurdie 2216
Version:  2.87.0000.cr                               Released: 13-Jul-10
2217
------------------------------------------------------------------------
2218
Major changes:
2219
 
2220
Minor changes:
2221
    * Jats label command
2222
      New option '-entireview' to be used by the build daemon
2223
      Not recommended for general use.
2224
      Will locate the root of the current view and label all files and
2225
      directories within the current view.
2226
 
2227
      Removed the double check of labeled files introduced in
2228
      version 2.80.3000.cr as the problem has been found and corrected
2229
      elsewhere.
2230
 
2231
    * Jats save_build
2232
      Use a better set of options of 'cleartool find' to speed up
2233
      the determination of a branch.
2234
 
2235
      Use the -entireview option of the jats label utility to speed
2236
      up labeling by the build daemons.
2237
 
2238
    * Jats build
2239
      Better handling of sandboxed packages.
2240
        Indicates that the dependency is from a sandbox
2241
        No overwrite warnings when reinstalling a package
2242
 
2243
    * Borland6 toolset
2244
      Changed the default value of where Borland6 is installed
2245
      to match the documented install location of:
2246
        c:\BCB6\CBuilder6
2247
 
2248
    * Jats build
2249
      Added -noforce option to only generate build files if they
2250
      are out of date. It will only recreate makefiles if needed.
2251
      This is a very quick operation.
2252
 
2253
      The default operation is '-force'. This will populate the
2254
      interface directory and generate makefiles.
2255
 
2256
    * Jats all [Experimental. Feed back welcome]
2257
      Uses the '-noforce' form of the build command such that build
2258
      files are only recreated if need be.
2259
 
2260
      The 'all' command will do what is needed in order to rebuild
2261
      the package. It will do a build, if need be, and then
2262
      make the package.
2263
 
2264
    * Jats sandbox
2265
      The 'all' command will perform a '-noforce' build followed by a make.
2266
 
2267
      The 'build' command will perform a build followed by a make. This will
2268
      be a complete build of all component packages.
2269
 
2270
      The 'jats sandbox all' command can be used to rebuild all
2271
      components in an efficient manner. If the build files have changed,
2272
      then the makefiles will be regenerated, other wise only the make phase
2273
      is performed.
2274
 
2275
Internal:
2276
    * build.pl
2277
      Cleanup the start-up processing of build.pl and buildlib.pl            
2278
 
2279
 
2280
------------------------------------------------------------------------
329 dpurdie 2281
Version:  2.86.2000.cr                               Released: 21-May-10
2282
------------------------------------------------------------------------
2283
Major changes:
2284
 
2285
Minor changes:
2286
    * RunTest directive
2287
      Corrected problems with the --Var(xxxx) option when used in conjunction
2288
      with the --abspath option.
2289
 
2290
    * Jats label command
2291
      Removed redundant 'cleartool describe' operations to speed up the process.
2292
 
2293
------------------------------------------------------------------------
327 dpurdie 2294
Version:  2.86.1000.cr                               Released: 11-May-10
2295
------------------------------------------------------------------------
2296
Major changes:
2297
    * New compiler support
2298
      Support for the Keil Arm V4.03a compiler
2299
      This is enabled via:
2300
        build.pl: BuildPlatforms ( 'H400,--Version=4.03a' );
2301
 
2302
Minor changes:
2303
 
2304
Internal changes:
2305
 
2306
------------------------------------------------------------------------
325 dpurdie 2307
Version:  2.86.0000.cr                               Released: 30-Apr-10
2308
------------------------------------------------------------------------
2309
Major changes:
2310
 
2311
Minor changes:
2312
    * jats label command - Renaming a label
2313
      Address issue when renaming a label when the current ClearCase view is
2314
      based on the label. All operation after the rename must specify the VOB
2315
      name as ClearCase may no longer be able to determine the VOB.
2316
 
2317
    * Better handling of .lnk files used within sandboxes and local package
2318
      archives. Now strip all trailing white space correctly
2319
 
2320
    * Jats Sandbox stop files
2321
      Added 'stop.<GBE_MACHTYPE>' stop files to better support multi
2322
      platform builds.
2323
 
2324
    * Makefile rebuild test correctly locates interface directory in
2325
      cases where the source directory is above the build file in the
2326
      directory tree.
2327
 
2328
    * New command: jats man
2329
      Produces full help on a specified item.
2330
 
2331
Internal changes:
2332
    * jats upddep
2333
      Delete temp .cfg file created during the process.
2334
 
2335
    * Jats makefiles: Platform directive
2336
      Initial release of ++Machtype, ++Project and ++Defined
2337
      Not yet in use.
2338
 
2339
------------------------------------------------------------------------
323 dpurdie 2340
Version:  2.85.0000.cr                               Released: 17-Mar-10
2341
------------------------------------------------------------------------
2342
Major changes:
2343
    * New Utility: upddep - Update Dependencies
2344
      This utility will update the dependencies in a build.pl file to be
2345
      consistent with those of a given Release Manager Release. This simplifies
2346
      the operation of maintain build files during development.
2347
 
2348
      It will create an 'auto.pl' file, which JATS uses in preference to a
2349
      build.pl file. DO NOT check this file in.
2350
 
2351
      See:  'jats upddep -help'         - For brief help
2352
            'jats upddep -man'          - For full manual
2353
 
2354
      Examples:
2355
            jats upddep -show
2356
            jats upddep -show=vtk
2357
            jats upddep -rtag=6684
2358
 
2359
    * MicroTec Compiler toolset
2360
      When creating a ShardLibrary (THX) report missing libraries before
2361
      compiling the objects that go into the THX.
2362
 
2363
      This ensures that the error messages the describe the missing library
2364
      can be seen and are not masked by the building of the objects.
2365
 
2366
Minor changes:
2367
 
2368
Internal changes:
2369
    * Utility: jats_rewrite
2370
      Modifications to interwork with the upddep utility.
2371
 
2372
------------------------------------------------------------------------
321 dpurdie 2373
Version:  2.84.0000.cr                               Released: 16-Feb-10
2374
------------------------------------------------------------------------
2375
Major changes:
2376
    * Makefile directive helper function: If
2377
      Used within another directive to enable or disable arguments passed to the
2378
      outer directive. The first argument is a 'platform' specifier - as in
2379
      all Jats Make directives. If making for the specified platform, then the
2380
      remainder of the arguments are inserted into the directives argument
2381
      stream.
2382
 
2383
      Example:
2384
 
2385
      SharedLib ( '*', 'mySharedLib', @OBJS
2386
                     , If ('WIN32',   '-llibrary1', '-llibrary2' )
2387
                     , If ('SOLARIS', '-llibrary3' )
2388
                     );
2389
Minor changes:
2390
    * Makefile directive: InstallLibs
2391
      Correctly installs, as libraries, files that are specified with a 'Src'
2392
      directive. This is consistent with the operation of the PackageLibs
2393
      directive.
2394
 
2395
    * GCC Toolkit
2396
      Changes to the shared library dependency processing to bring it inline
2397
      with other toolers. Will terminate after determining that some
2398
      libraries cannot be found. This will ensure that the error message is at
2399
      the point of termination.
2400
 
2401
    * Jats save_build utility
2402
      Corrected problem in unreserving a reserved checkout of a build.pl file
2403
      under windows.
2404
 
2405
    * Jats sandbox
2406
      ClearCase views created with in the sandbox are created with a tag that
2407
      is named after the sandbox. This allows multiple instances of a view
2408
      in different sandboxes.
2409
 
2410
    * Jats release
2411
      Display cleartool error messages when view creation fails.    
2412
 
2413
------------------------------------------------------------------------
319 dpurdie 2414
Version:  2.83.1000.cr                               Released: 04-Feb-10
2415
------------------------------------------------------------------------
2416
Major changes:
2417
 
2418
Minor changes:
2419
    * jats options
321 dpurdie 2420
      Added -locatedir=name
2421
      Will scan from CWD to the root of the file system looking for the named
319 dpurdie 2422
      directory.
2423
 
2424
    * jats label utility
2425
      Improved handling of the -file and -dir options
2426
      These options will now label the directory elements within the paths
2427
      specified by these options, when used in conjunction with the -up option.
2428
      This simplified the process of labeling complex directory structures.
2429
 
2430
      Added -admin, to allow creation of global labels
2431
 
2432
------------------------------------------------------------------------
317 dpurdie 2433
Version:  2.83.0000.cr                               Released: 20-Jan-10
315 dpurdie 2434
------------------------------------------------------------------------
2435
Major changes:
317 dpurdie 2436
 
2437
Minor changes:
2438
    * WinCe Toolsets
2439
      New CompileOptions operations:
321 dpurdie 2440
        Exceptions              - Enable exception handling
317 dpurdie 2441
        noExceptions            - Disable
2442
      Default is to retain backward compatibility. It is mixed.
2443
      Example:
2444
        CompileOptions ('*', 'Exceptions' );
2445
 
2446
    * Solaris targets
2447
      Full support for a target called SOLARIS8_SPARC32
2448
      It is identical to SOLARIS in a 'sparc' build machine, but it is only
2449
      available on a 'sparc' build machine. Can be used to limit builds to one
2450
      machine type.
2451
 
2452
------------------------------------------------------------------------
2453
Version:  2.82.0000.cr                               Released: 18-Jan-10
2454
------------------------------------------------------------------------
2455
Major changes:
315 dpurdie 2456
    * New Build Platform: VB6
2457
      Jats has been enhanced to support the building of VB6 .vbg and .vbp
2458
      project files.
2459
 
2460
    * Build Directive BuildVersion.
2461
      This has been extended to allow the creation of Version Information in a
2462
      form that can be consumed by Visual Basic using '--Style=VB'
2463
 
2464
Minor changes:
2465
    * Added more internal documentation
2466
      Use jats help to see available documentation
2467
 
2468
    * Jats label -info command [DEVI-059929]
2469
      Fixed problem that prevent this command running on Unix systems.
2470
 
2471
    * Jats save_build utility
2472
      Corrected problem in unreserving a reserved checkout of a build.pl file
2473
      under windows.
2474
 
2475
    * Solaris 10, 64 Bit Sparc Builds
2476
      All compiles are done in a position independent manner (-KPIC)
2477
      This solved issues where static libraries are linked into shared
2478
      libraries.
2479
 
2480
    * Solaris builds
2481
      Program and Shared library dependency checking is now done before
2482
      the program/library objects are built. Thus errors associated with missing
2483
      dependencies occur before objects are built and the user can see the cause
2484
      of the build failure.
2485
 
2486
 
2487
Internal changes:
2488
    * Moved 'jats vars' functionality into a separate program
2489
      Moved associated documentation into the jats_vars tool
2490
 
2491
    * Moved some other internal documentation into InstallationNotes and
2492
      PkgArchive topics.
2493
 
2494
------------------------------------------------------------------------
313 dpurdie 2495
Version:  2.81.0000.cr                               Released: 12-Jan-10
2496
------------------------------------------------------------------------
2497
Major changes:
2498
    * Solaris Builds for 64 bit targets
2499
      Changes to fully support the SOLARIS10_X86 and SOLARIS10_SPARC64
2500
      targets. These are using a different version of the compiler than the
2501
      existing 32-bit builds.
2502
 
2503
      64-Bit Solaris10 builds are performed with Sun Studio 12.1
2504
      32-Bit Solaris10 builds are performed with Sun Studio 11
2505
 
2506
Minor changes:
2507
    * jats label -exclude=nnn
2508
      Corrected problem with the -exclude option introduced in 2.80.3000.cr
2509
 
2510
    * Package searching
2511
      The BuildpkgArchive and LinkPkgArchive directives will search
2512
      both dpkg_archive and deploy_archive paths for packages.
2513
 
2514
      Allows JATS to be used to process deployable packages.
2515
 
2516
    * jats help
2517
      Modified the operation of the 'jats help' command.
2518
      This command now provides a gateway to the jats help system.
2519
 
2520
      Information provided by the previous 'jats help' can be achieved
2521
      with one of:
2522
        jats -h
2523
        jats help jats
2524
 
2525
Internal:
2526
    * cmdfile utility
2527
      Added macros:
2528
        @(sep,x,text)               - Reformat text with specified file sep
2529
        @(env,VarName)              - Extract text from an EnvVar
2530
 
2531
      Corrected
2532
        @(vsep,ident)               - Set path seperator (: or ;)
2533
        @(vhost,ident)              - Modify @(vlib) operation
2534
 
2535
      Extended
2536
        @(vpath)                    - Added optional 'sep' argument.
2537
        @(vlib)                     - Added optional 'sep' argument.
2538
        @(vlint)                    - Added optional 'sep' argument.
2539
        @(vglob)                    - Added optional 'sep' argument.
2540
 
2541
------------------------------------------------------------------------
311 dpurdie 2542
Version:  2.80.4000.cr                               Released: 17-Dec-09
2543
------------------------------------------------------------------------
2544
Major changes:
2545
 
2546
Minor changes:
2547
 
2548
Internal changes
2549
    * Created a Pseudo package to describe the interface directory
2550
      This simplifies the various scanning algorithms within JATS
2551
      Useful side effects include:
2552
 
2553
        JATS plugins will be sourced from the interface directory if included
2554
        with a BuildPkgArchive. This will simplify debugging.
2555
 
2556
        [DEVI-059682] QtBase can be consumed via a BuildPkgArchive directive,
2557
        simplifying the process of packaging additional fonts.
2558
 
2559
        [DEVI-059685] Simplify implementation of --FromPackage options in other
2560
        tools, which obviates the need for QtBase to be consumed via a
2561
        BuildPkgArchive
2562
 
313 dpurdie 2563
    * Perl Modules
2564
      Included the most recent version of the Pod module within the JATS
2565
      release. This will:
2566
        * Ensure consistent cross platform behaviour
2567
        * Corrects issues within earlier releases of the Pod module - some
2568
          reported by ERG.
2569
        * Provide a basis for a better help system within JATS.
2570
 
311 dpurdie 2571
------------------------------------------------------------------------
309 dpurdie 2572
Version:  2.80.3000.cr                               Released: 01-Dec-09
2573
------------------------------------------------------------------------
2574
Major changes:
2575
 
2576
Minor changes:
2577
    * BuildTool utility: jats_save_build
2578
      Returns non-zero error code on labeling errors.
2579
      Deletes label on labeling errors.
2580
      Removed backward compatibility options as they are no longer used.
2581
 
2582
    * Jats label utility
2583
      Changes to assist in tracking down clearcase labeling errors
2584
 
2585
      Once labels have been applied a check is done to ensure that
2586
      the labels have been placed. The check is to attempt to find
2587
      new files and folders to label - there should be none.
2588
 
2589
    * Jats core
2590
      Improved the auto location of the base directory of the build to allow
2591
      for ant-based packages. Allows the jats 'create_dpkg' command to be
2592
      used to package ant based builds.
2593
 
2594
------------------------------------------------------------------------
307 dpurdie 2595
Version:  2.80.2000.cr                               Released: 12-Nov-09
305 dpurdie 2596
------------------------------------------------------------------------
2597
Major changes:
2598
 
2599
Minor changes:
307 dpurdie 2600
    * CSHARP toolset
2601
      Creation of unit tests was broken by 2.80.0000.cr
2602
      This is now fixed.
2603
 
309 dpurdie 2604
      The cmdfile utility creates paths with file path separators as discovered
307 dpurdie 2605
      in the PATH EnvVar. Now that PATH is nice it means that the use of cmdfile
309 dpurdie 2606
      to create shell scripts resulted in scripts with unsuitable separators.
307 dpurdie 2607
 
2608
    * WCEPSION_500_VS2005
2609
      Extended the list of nodefaultlibs to include secchk.lib and ccrtrtti.lib
2610
 
2611
------------------------------------------------------------------------
2612
Version:  2.80.1000.cr                               Released: 12-Nov-09
2613
------------------------------------------------------------------------
2614
Major changes:
2615
 
2616
Minor changes:
305 dpurdie 2617
    * Generating makefiles
2618
      Ensure that the 'BuildMake' directive is the last one in the build.pl file
307 dpurdie 2619
      Directives after this will not be processed correctly and now generate
305 dpurdie 2620
      an error.
2621
 
2622
    * WCEPSION_500_VS2005
307 dpurdie 2623
      Suppress use of -debug:cv when building libraries.
305 dpurdie 2624
 
2625
    * Build directive: BuildSrcArchive
307 dpurdie 2626
      Highly specialized directive.
305 dpurdie 2627
      Refer the JATS Manual.
2628
 
2629
------------------------------------------------------------------------
303 dpurdie 2630
Version:  2.80.0000.cr                               Released: 04-Nov-09
2631
------------------------------------------------------------------------
2632
Major changes:
2633
    * New target: WCEPSION_500_VS2005
2634
      A build of the Psion CE 5.0 under VS2005
2635
      This target has been added to the WINCE target.
2636
 
2637
      WCEPSION_500_VS2005 build cannot consume build artifacts from the
2638
      WCEPSION_500. The two are separate.
2639
 
2640
    * Support for building WinCE targets under VS2005
2641
      Currently only the WCEPSION_500_VS2005 is fully supported
2642
      Support includes
2643
        * Building of executables and DLLs via jats directives
2644
        * Building of components via VS2005 'solution' files
2645
 
2646
Minor changes:
2647
    * Build file processing
2648
      Better detection of bad platform names under Windows
2649
      Note: All platform names should be in uppercase.
2650
 
2651
    * MOS builds
2652
      If a 'product' name not known to JATS is used and a board base address
2653
      is specified then no warnings are generated indicating an unknown 'product'
2654
 
2655
    * MOS builds
2656
      New 'known' product: PICP
2657
      Identical to the TP5 in all but name.
2658
 
2659
    * GenerateFiles directive
2660
        Better handling of '\' when passing arguments to a command line
2661
        under windows.
2662
 
2663
        .
2664
 
2665
    * Verbose builds now show command files
2666
      Currently only supported for WIN32 and WINCE builds.
2667
 
2668
      The use of 'OPTIONS=args' will cause the linker command file to be dumped
2669
      to the output stream.
2670
 
2671
      This facility will be retrofitted to other platform targets in the future.
2672
 
2673
    * Windows Shell
2674
      The shell provided with JATS for use under Windows has been modified so
2675
      that the COMSPEC and PATH variables are correctly formatted with '\'
2676
 
2677
      Addresses issues when invoking Windows tools and programs from within JATS.
2678
 
2679
    * H8S toolset
2680
      Ensure the the EnvVar CYGWIN is not set.
2681
 
2682
      If 'binmode' is set then the gcc compiler used by the H8S toolset cannot
2683
      handle macros that use line continuation.
2684
 
2685
Internal changes
2686
    * WinCe builds
2687
      Changed name of internal file 'toolset/vcwce' to better represent the
2688
      content of the file.
2689
 
2690
      Many internal changes to better support VS2005 and EVC
2691
 
2692
      Macros to encode and decode paths with embedded spaces.
2693
      Currently only used in WIN32 and WINCE toolsets.
2694
 
2695
------------------------------------------------------------------------
301 dpurdie 2696
Version:  2.79.6000.cr                               Released: 18-Sep-09
2697
------------------------------------------------------------------------
2698
Minor changes:
2699
    * PackageFile directive with spaces in names.
2700
      Corrected problem.
2701
 
2702
------------------------------------------------------------------------
299 dpurdie 2703
Version:  2.79.5000.cr                               Released: 14-Sep-09
2704
------------------------------------------------------------------------
2705
Major changes:
2706
 
2707
Minor changes:
2708
    * DPACKAGE file created on multiple machines [DEVI-054973]
2709
      DPACKAGE files are now machine specific.
2710
      Changes are transparent to users.
2711
 
2712
    * Creating static libraries without any object files is treated
2713
      as an error. The Microtec tools sets will create a 'pop-up' if
2714
      this occurs.
2715
 
2716
    * The LinkSandbox directive is not allowed when GBE_ABT is set.
2717
      This directive is highly discouraged in development: Use a jats 'sandbox'
2718
      Moreover it is not reproducible and thus not supported within the
2719
      automated build framework.
2720
 
2721
    * jats sandbox command
2722
      Added support to delete the sandbox metadata. This undoes the
2723
      'create' command.
2724
 
2725
    * jats command aliases. Added
2726
        jats extractfiles to be jats release -extractfiles
2727
        jats extract      to be jats release -extract
2728
 
2729
------------------------------------------------------------------------
297 dpurdie 2730
Version:  2.79.4000.cr                               Released: 29-Jul-09
2731
------------------------------------------------------------------------
2732
Major changes:
2733
    * Jats Command line and -java option
2734
      This version will place the specified java's 'bin' directory into
2735
      the PATH. Thus the commands:
2736
            jats -java=1.6 eprog java -version
2737
            jats -java=1.6 ant build
2738
      will work as expected
2739
 
2740
Minor changes:
2741
    * VS2008 Toolset
2742
      Picking up incorrect config details
2743
      May result in a warning message.
2744
 
2745
    * gen_cots utility
2746
      New option to allow use without ClearCase dependencies.
2747
      Its simply creates a buildable package image.
2748
 
2749
    * DELPHI7 toolset
2750
      Correct the definition of the Debug option '-$D+'
2751
      In debug mode, add $DELPHI/lib/debug to the search paths
2752
 
2753
------------------------------------------------------------------------
295 dpurdie 2754
Version:  2.79.3000.cr                               Released: 01-Jul-09
2755
------------------------------------------------------------------------
2756
Major changes:
2757
Minor changes:
2758
    * Escrow Utility
2759
      Add header to generated HTML describing the source of the data
2760
 
2761
    * IAR Compiler
2762
      Fixed test for loader file
2763
 
2764
    * GCC Toolset
2765
      Fixed DLL Version Number
2766
 
2767
    * DELPHI7 Toolset
2768
      Minor correction discovered during use.
2769
      Existing tools to create a .lib from .dll had serious path length issues
2770
      Extended the compiler search paths
2771
 
2772
    * Deployment utilities (old)
2773
      Correct SQL statement to work without any Schema assumptions
2774
 
2775
------------------------------------------------------------------------
293 dpurdie 2776
Version:  2.79.2000.cr                               Released: 11-Jun-09
2777
------------------------------------------------------------------------
2778
Major changes:
2779
Minor changes:
2780
    * Minor bug fix to address issues introduced in previous release
2781
      Affects SOLARIS and MOS builds
2782
 
2783
------------------------------------------------------------------------
291 dpurdie 2784
Version:  2.79.1000.cr                               Released: 10-Jun-09
2785
------------------------------------------------------------------------
2786
Major changes:
2787
Minor changes:
2788
    * Initial Support for Visual Studio 2008
2789
      New platforms: CSHARP2008 and VS2008
2790
 
2791
    * WIN32 Toolset
2792
      Corrected the -machine option passed to the Windows linker
2793
      Now passes -machine:X86 instead of -machine:IX86
2794
 
2795
------------------------------------------------------------------------
289 dpurdie 2796
Version:  2.79.0000.cr                               Released: 10-Jun-09
2797
------------------------------------------------------------------------
2798
Major changes:
2799
    * New Platform: DELPHI7
2800
      Support the creation of Units,Libraries, Packages and Programs using
2801
      Borlands Delphi Version 7.
2802
 
2803
      See Jats Reference Manual for complete details and Delphi specific options
2804
      to the Prog and SharedLib directives.
2805
 
2806
      This toolset has a number of limitations:
2807
        1) It can build either Debug or Production, but not both, in a single
2808
           makefile.pl. This is caused by the Delphi limitation that library
2809
           names cannot be changed.
2810
 
2811
        2) The generation of dependencies between the source and the generated
2812
           artifacts is very simplistic.
2813
 
2814
      Units are generated with the 'Lib' directive. The name of the Unit and the
2815
      name of the source are linked. The source should not be provided.
2816
        ie: Lib ('*', 'MyUnit' );
2817
      Will create a unit called MyUnit.dcu from the source file 'MyUnit.pas'
2818
 
2819
      Packages are generated with the SharedLib directive starting with a .dpk
2820
      file.
2821
        ie: SharedLib  ( '*', 'MyPackage' );
2822
      will create a package called MyPackage.bpl/dcp from the source file
2823
      MyPackage.dpk.
2824
 
2825
      Libraries are generated with the SharedLib directive starting with a .dpr
2826
      file.
2827
        ie: SharedLib  ( '*', 'MyDll' );
2828
      will create a package called MyDll.dll/lib from the source file
2829
      MyDll.dpr.
2830
 
2831
      Programs are generated with the Prog directive starting with a .dpr
2832
      file.
2833
        ie: Prog  ( '*', 'MyProg' );
2834
      will create a package called MyProg.exe from the source file
2835
      MyProg.dpr.
2836
 
2837
Minor changes:
2838
    * New EnvVar: DELPHI7
2839
      Required only if Borland Delphi 7 has not being installed in the
2840
      standard location or if the Windows Short Name is not
2841
      c:\PROGRA~1\Borland\Delphi7
2842
 
2843
    * BuildVersion directive
2844
      Added a 'Style' of 'Delphi' to allow the generation of version information
2845
      in a Delphi Unit.
2846
 
2847
      Modified the operation of the "C" style generation.
2848
      If the name of the file is provided via '--File', then the generated files
2849
      will be 'known' to JATS and can be consumed from any makefile. JATS will
2850
      'know' the location of the files.
2851
 
2852
    * Sanity test on the names of libraries and programs
2853
      Some characters are not allowed: ie: '/' as this is a mistake.
2854
 
2855
Internal Changes:
2856
    * ToolsetSHLD functions
2857
      Pass in the shared library version string as an argument
2858
      Means that the core of JATS can manage this information in a manner
2859
      that is decoupled from the toolsets.
2860
 
2861
    * Reworked the mechanism used to hold data about libraries, shared libraries
2862
      merged libraries and programs. Created a class to manipulate build targets
2863
      and to maintain information about the contents of the targets.
2864
 
2865
------------------------------------------------------------------------
287 dpurdie 2866
Version:  2.78.4000.cr                               Released: 30-Apr-09
2867
------------------------------------------------------------------------
2868
Major changes:
2869
    * Correctly generate dependencies for C++ only builds
2870
      Many tools sets ( gcc and others) would not generate makefile dependency
2871
      information for purely C++ builds.
2872
 
289 dpurdie 2873
    * Jats.bat and Jats.sh now provide a default Read Only username/password
2874
      for Release Manager and Deployment Manager.
287 dpurdie 2875
 
289 dpurdie 2876
      NOTE: Windows users will need to update their JATS.BAT file in order
2877
            to pick up changed passwords for Release Manager and Deployment
2878
            Manager
287 dpurdie 2879
 
2880
Minor changes:
2881
    * The jats option '-noexportvars' deletes selected JATS EnvVars from the
2882
      environment. This only affects the build daemons.
2883
 
2884
    * updatenodespec utility
2885
      Correct the SQL statements to work with ReadOnly access to the Deployment
2886
      Manager database.
2887
 
2888
------------------------------------------------------------------------
285 dpurdie 2889
Version:  2.78.3000.cr                               Released: 30-Mar-09
2890
------------------------------------------------------------------------
2891
Major changes:
2892
 
2893
Minor changes:
2894
    * Creation of DPACKAGE file [DEVI-054973]
2895
      Better support for packages that build on multiple platforms
2896
      Not completly fixed, but much better than before.
2897
 
2898
    * Escrow tool
2899
      Remove warning created during normal operation
2900
 
2901
    * Minor code cleanup as suggested by code analysis tools
2902
 
2903
------------------------------------------------------------------------
283 dpurdie 2904
Version:  2.78.2000.cr                               Released: 05-Mar-09
2905
------------------------------------------------------------------------
2906
Major changes:
2907
    * New Platform: H400
2908
      Supported by the KIELARMV3 toolset.
2909
      Refer to the Jats Reference Manual for toolset specific options
2910
 
2911
Minor changes:
2912
    * MergeLibrary directive
2913
      Allow a library that has been created in the same makefile.pl as the
2914
      directive to be located, without the need to 'install' it first.
2915
 
2916
 
2917
------------------------------------------------------------------------
281 dpurdie 2918
Version:  2.78.1000.cr                               Released: 26-Feb-09
2919
------------------------------------------------------------------------
2920
Major changes:
2921
 
2922
Minor changes:
2923
    * New command: jats make show
2924
      Will display the platfroms, alias definitions and the makefile paths
2925
      used in the build.
2926
 
2927
    * Escrow command
2928
      Now supports extraction based on a single package and version
2929
 
2930
    * Build File Rewrite Utility
2931
      Added a '-validate' option to allow the build daemons to validate the
2932
      build files against the Release Manager information.
2933
 
2934
      Improved error reporting to make it clear that the problem is a mis-match
2935
      between Release Manager and the package's build files.
2936
 
2937
------------------------------------------------------------------------
279 dpurdie 2938
Version:  2.78.0000.cr                               Released: 18-Feb-09
277 dpurdie 2939
------------------------------------------------------------------------
2940
Major changes:
279 dpurdie 2941
    * GBE_BUILDFILTER configuration has been simplified
277 dpurdie 2942
 
279 dpurdie 2943
      JATS will automatically filter out target platforms that cannot be built
2944
      on the users machine. ie: It will not try to build Solaris targets on a
2945
      Windows machine. Thus, under the new scheme a Windows GBE_BUILDFILTER need
281 dpurdie 2946
      not contain '!SOLARIS'
279 dpurdie 2947
 
2948
      This greatly simplifies the creation of GBE_BUILDFILTER as it does not
2949
      need to be configured to exclude targets that cannot by built.
2950
 
2951
      Existing GBE_BUILDFILTER definitions are backward compatible.
2952
 
2953
    * Jats utility : gen_cots
2954
      Requires the user to specify a target VOB with the -vob option
2955
        Ensures the user is aware of the target VOB
2956
 
2957
      Now creates temporary directory within the users TEMP directory.
2958
        Addresses problems where the user's CWD is within the package being
2959
        processed.
2960
 
2961
      Removed the '-delete' option
2962
        Always delete the temp work directory if it exists.    
2963
 
277 dpurdie 2964
Minor changes:
279 dpurdie 2965
    * Sandbox command
2966
      Added build, make, clean, clobber commands
2967
 
2968
      Sandbox packages may contain a file called 'stop', to exclude the
2969
      target from consideration in the build set.
2970
 
2971
    * MCR Toolset
2972
      This toolset only supports 16 compiler search paths. An descriptive error
2973
      has been added to detect and report on this error.
2974
 
2975
    * WIN32 and PHARLAP toolsets
2976
      The --Resource=xxx option specifies a comma separated list of files.
2977
      Spaces are now allowed either side of the comma.
2978
        ie: "--Resource=file1.h, File2.h"
2979
 
2980
    * Jats run_test command
2981
      Removed a non-fatal warning message that was being generated when the
2982
      tests we run on a Window machine.
2983
 
2984
    * descpkg file
2985
      Now contains HOSTNAME of the build machine
2986
      Not (yet) aggregated when packages are merged
2987
 
2988
   * built.<machine> tag files created by create_dpkg
2989
     Now contains build trace information
2990
        Date-Time, Machine, User, ABT config
2991
 
2992
   * jats abt command simplified usage
2993
     This command now appends the current directory as a library path to ANT if
2994
     it contains 'jar' files.
2995
 
2996
     Uses ANT 1.6 as the default version of ANT
2997
 
2998
     Both changes will simplify the use of this command within the escrow
2999
     environment. ie: 'jats abt -buildfile=build1.xml'
3000
 
3001
   * BuildVersion directive
3002
     Form:
3003
        BuildVersion ('--Style=C');
3004
     now works as expected.
3005
     Slightly better error detection on the directives arguments.
3006
 
3007
Internal Changes:
3008
 
3009
    * Error reporting mechanism
3010
      Improved the error reporting mechanism. Allowed a function to
3011
      create modify the error reporting parameters in such a manner that the
3012
      original values are restored at the end of a function.
3013
 
3014
 
3015
------------------------------------------------------------------------
3016
Version:  2.77.8000.cr                               Released: 18-Dec-08
3017
------------------------------------------------------------------------
3018
Major changes:
3019
 
3020
Minor changes:
277 dpurdie 3021
  * Jats Wrapper
3022
    Added -NoExportVars option to allow use of JATS to startup build daemons
3023
    without fixing the version of JATS that is used by the processes the daemon
3024
    then starts.
3025
 
3026
    Limit searches for local and sandbox archives to the '/home' directory
3027
    so that the Unix auto mounter does not report errors.
3028
 
3029
  * Jats makefiles. Platform Specifier
3030
    The Platform Specifier has been extended to support a '--MachType=name'
3031
    non-platform option.
3032
 
279 dpurdie 3033
    This may be used to limit Java builds to a 'win32' machine if required.
277 dpurdie 3034
 
3035
------------------------------------------------------------------------
275 dpurdie 3036
Version:  2.77.7000.cr                               Released: 17-Dec-08
3037
------------------------------------------------------------------------
3038
Major changes:
3039
 
3040
Minor changes:
3041
    * MugFile support
3042
      Added facilities to allow named files to be added the the Thx Fileset
3043
      Added options to facilitate the creation of sets of THX files
3044
      Refer to MASS-00099 for complete details.
3045
 
3046
    * Jats Utility: dstatus
3047
      Limit display width of the build machine named to 20 characters
3048
 
3049
    * Jats sandbox command (experimental)
3050
        A files called 'stop' within the root directory of the component
3051
        packages will prevent the utility from processing that subdirectory.
3052
 
3053
        Extended command sets to allow the command 'all', 'build' and 'make'
3054
        to be processed as commands to be invoked in all sandbox components
3055
 
3056
    * Jats Make: New EnvVars
3057
        GBE_MAKE_TYPE               - P or D
3058
        GBE_MAKE_TARGET             - Target platform
3059
        GBE_MAKE_CMD                - Current make target
3060
        GBE_MAKE_CFG                - Internal config
3061
 
3062
    * Jats generated scripts: set_<platform>.sh
3063
      The generated scripts preserve any spaces in the argument list passed
3064
      to the invoked application.
3065
 
3066
Internal Changes:
3067
    * JatsCopy Package
3068
      CopyFile operation can copy an array of files
3069
      CopyDir now supports MatchDirs
3070
 
3071
    * JatsMakeConfig Package
3072
      Added class to read in the parsed makefile.pl data for the current
3073
      build target.
3074
 
3075
    * Jmake - Jats Makefile Supervisor
3076
      Export GBE_MAKE_* EnvVars to directly export the current makefile
3077
      environment. 
3078
 
3079
 
3080
------------------------------------------------------------------------
273 dpurdie 3081
Version:  2.77.6000.cr                               Released: 11-Dec-08
3082
------------------------------------------------------------------------
3083
Major changes:
3084
 
3085
Minor changes:
3086
    * Jats command: sandbox
3087
      Support subcommands "clean" and "clobber"
3088
      These traverse the sandbox in the reverse direction so that the clean
3089
      up operations work correctly.
3090
 
3091
    * Makefile generation
3092
      Removed warning on the use of --OnlyProd and --OnlyDebug
3093
 
3094
    * JatsCopy Package
3095
      Minor enhancements to this internal package
3096
        CopyFile operation returns path to target file
3097
        CopyDir can, if asked, returns an array of files copied
3098
        Wildcard correctly supports the [0-9] construct
3099
 
3100
Internal Changes:
3101
    * Environment
3102
      Export EnvVar GBE_HOSTMACH
3103
      This is the same as GBE_MACHTYPE, but it is not modified by legacy
3104
      makefiles. Available for sanity testing.
3105
 
3106
    * Remove unused references to the File::Find package in Perl scripts
3107
 
3108
    * Jats building Jats now uses the JatsCopy package to perform the many
3109
      copy operations in the build.
3110
 
3111
 
3112
------------------------------------------------------------------------
271 dpurdie 3113
Version:  2.77.5000.cr                               Released: 24-Nov-08 
267 dpurdie 3114
------------------------------------------------------------------------
3115
Major changes:
3116
 
3117
Minor changes:
271 dpurdie 3118
    * Added LMOS_PPC_603E to the LMOS target
269 dpurdie 3119
 
271 dpurdie 3120
    * Jats Utility: dstatus
3121
      Improved handling of closed and archived releases
3122
      Displays include activity time information
269 dpurdie 3123
 
271 dpurdie 3124
Internal Changes
3125
    * jats.pl
3126
      Removed unused function
3127
 
3128
    * makeif.pl
3129
      Added significant documentation
3130
      Provided access to some of the functions via and API
3131
      Renamed to MakeIf.pm
3132
      Moved location to the LIB directory.
3133
 
3134
    * MakeEntry.pm
3135
      Added support for the use of in-memory files
3136
      Allows the output to be 'printed' to a memory variable rather then a file
3137
 
3138
    * ReadBuildConfig.pm
3139
      Added routines to access package information in a manner that is
3140
      independent of the underlying data.
3141
 
3142
    * makelib.pl2
3143
      Added mechanism to allow toolsets to register for notification
3144
      of specific source files present in the build.
3145
 
3146
      Improved readability of the generated makefiles.
3147
      Added informationas to the source of included files
3148
 
3149
      Added docuementation to previously undocumented functions
3150
 
3151
      Corrected usage of the MakeIf package.
3152
      Use it as a package.
3153
 
3154
    * Win32 binary tools
3155
      Added 7z.exe - command line utility to process various compressed
3156
      file formats. Can be used to perform tar-like operations underlying
3157
      windows.
3158
 
3159
    * JatsSvnCore.pm
3160
      Made use of a new binary utility ('stdmux') to multiplex stdout and
3161
      stderr into one data stream that can be handled by perl one allow
3162
      platforms.
3163
 
3164
 
269 dpurdie 3165
------------------------------------------------------------------------
271 dpurdie 3166
Version:  2.77.4000.cr                               Released: 11-Nov-08
269 dpurdie 3167
------------------------------------------------------------------------
3168
Major changes:
3169
 
3170
Minor changes:
271 dpurdie 3171
    Jats utility 'release' [DEVI-051370 ]
3172
    The utility will place a tag file in the root of the package
3173
    as specified by the '-path' option. This will be used by the build tool
3174
    tool re-locate the root of the package and thus allow the correct generation
3175
    of the ClearCase related metrics.
3176
 
3177
    Generation of Resource Files for WIN32 builds
3178
    Corrected version identifier
3179
 
3180
 
3181
------------------------------------------------------------------------
3182
Version:  2.77.3000.cr                               Released: 28-Oct-08
3183
------------------------------------------------------------------------
3184
Major changes:
3185
 
3186
Minor changes:
267 dpurdie 3187
    * Jats option '-locate' correctly locates ANT build files [DEVI-052423]
3188
 
3189
    * Allow Deployable packages to be built on some, but not all, of the
3190
      build machines and correctly package the descpkg file. [DEVI-052422]
3191
 
3192
    * JATS CompileOptions directive  [DEVI-052426]
3193
      New options:
3194
        no_define_source_file
3195
        define_source_file              (Default)
3196
 
3197
      The 'no_define_source_file' will suppress the compile definition __SOURCE__
3198
      Currently only implemented for WIN32 and WINCE toolsets.
3199
 
3200
      The __SOURCE__ definition renders pre-compiled headers useless.
3201
      This option has not be enabled by default to ensure backward
3202
      compatibility.
3203
 
3204
    * Jats directives: MakeProject
3205
      Now supports the following new options:
3206
            --InstallProgDebug=list
3207
            --InstallProgProd=list
3208
            --InstallProg=list
3209
 
3210
      These allows files that are created by the project builder to be
3211
      installed locally to be consumed by such packaging directives as
3212
      GenerateCab.
3213
 
3214
    * Jats directives: AddLDFlags and AddASFlags
3215
      Now supports the --Debug and --Prod options like the other AddFlags
3216
      directives.
3217
 
3218
    * Jats builder directive: BuildVersion
3219
      New options that can be used when generating a WinRC style version
3220
      information:
3221
            --Definitions                   - Create definitions only
3222
            --Comment=text
3223
            --Description=text
3224
            --Product=name
3225
 
3226
Internal Changes:
3227
    * These utility 'gen_winrc' now uses module used by the BuildVersion
3228
      directive to created the resource file.
3229
 
3230
      The BuildVersion.pm module has been modified to allows it to be used in
3231
      a standalone manner by gen_winrc.pl.
3232
 
3233
------------------------------------------------------------------------
265 dpurdie 3234
Version:  2.77.2000.cr                               Released: 26-Sep-08
261 dpurdie 3235
------------------------------------------------------------------------
3236
Major changes:
263 dpurdie 3237
 
3238
Minor changes:
265 dpurdie 3239
    * Jats utility jats_save_build.pl
3240
      Fix problem when used in new mode.
3241
      These label is now applied from the root of the VOB and not from
3242
      the location of the builder file.
3243
 
3244
------------------------------------------------------------------------
3245
Version:  2.77.1000.cr                               Released: 18-Sep-08
3246
------------------------------------------------------------------------
3247
Major changes:
3248
 
3249
Minor changes:
263 dpurdie 3250
    * New JATS Platform : PHARLAP [DEVI-051359]
3251
      Added support for PharLap 10.1
3252
      Requires that both PharLap 10.1 and Visual Studio 6 be installed
3253
      Full details in the JATS manual.
3254
 
3255
    * Windows utilities  [DEVI-051360]
3256
      Added rpccpp to assist in the creation of rcpgen based modules under
3257
      windows.
3258
 
3259
    * MOS68K and MOSCF toolsets
3260
      Made used of rpccpp. These platforms can now support the creation
3261
      of XDR based modules.
3262
 
3263
    * Jats GenerateFiles directive
3264
      New option '--PreDelete' will delete all generated files before
3265
      the generator process is run. This may be used in cases where the
3266
      generator process does not operate if the output files already exist,
3267
      such as the rpcgen utility.
3268
 
3269
    * Jats MakeAnt directive
3270
      Correct problem where unit_tests could not be run.
3271
      Automated unit_tests tests could be run.
3272
 
3273
    * Buildtool utility: jats_rewrite
3274
      Added -noconfig option to allow the creation of auto.xml files
3275
      in escrow.
3276
 
3277
    * create_dpkg utility
3278
      Merged files that exist in the target archive are now compared
3279
      against the local file. A difference is considered to be an error.
3280
 
3281
Internal Changes:
3282
    * Resolved issues with JatsEnv modules that make it difficult to include
3283
      the modules in other modules. This is now a package
3284
 
3285
    * JatsSystem Module
3286
      Resolved issues when 'shell' is used to invoke a 'system' command.
3287
      Now quote the command string being passed to the shell.
3288
 
3289
      Resolved issues with JatsCmd
3290
      Now takes an array of arguments.
3291
 
3292
      Added JatsTool to be more efficient where a known JATS tool is being
3293
      invoked. This is faster assist it does not invoked three unneeded
3294
      programs.
3295
 
3296
    * Renamed jats_cbuilder tool to jats_ccrelease.
3297
      Changes is not visible to the users, assist they go through the 'jats'
3298
      wrapper. Internally the changes is in preparation to alternate version
3299
      control systems.
3300
 
3301
 
3302
------------------------------------------------------------------------
3303
Version:  2.77.0000.cr                                Released: 1-Sep-08
3304
------------------------------------------------------------------------
3305
Major changes:
261 dpurdie 3306
    * Perl Version. Must be at least version 5.8.2
3307
      This is the first version that supports Windows 2003 server.
3308
 
3309
      After discovering that several operations are not fully function under
3310
      Perl 5.6.1 the minimum version of Active State Perl that is required has
3311
      been increased.
3312
 
3313
      A suitable windows installer can be found at:
3314
        \\auperaunx26\devl\releases\3rdParty-Products\ActivePerl\5.8.8.819\
3315
                                    ActivePerl-5.8.8.819-MSWin32-x86-267479.msi
3316
 
3317
    * Jats Build Targets
3318
      New target and toolset: VERIX
3319
 
3320
    * Jats utility: jats_save_build
3321
      Extended to allow all ClearCase specific operations to be removed
3322
      from the Build Daemons.
3323
 
3324
      This utility is only used by "Release Planner" and the "Build Daemons".
3325
 
3326
      Suggested new usage:
3327
        jats etool jats_save_build
3328
                        -pname=xxxx
3329
                        -pversion=yyyy
3330
                        -infofile=path_name
3331
                        -locatepkg=zzzz     (Optional)
3332
                        -infile=aaaa        (Optional)
3333
                        -outfile=bbbb       (Optional)
3334
                        -wiplabel=ccccc     (Optional)
3335
 
3336
Minor changes:
3337
    * JATS make: Merge Library Operation [DEVI-049475]
3338
      Fixed such that Library Merge operations don't delete other build
3339
      artifacts.
3340
 
3341
    * JATS make: New option expert=0|1
3342
      Runtime processing of 'expert' mode to allow dependencies between the
3343
      object files and the makefile to be ignored.
3344
 
3345
      Previous this operation could only be invoked at 'build' time. Now the
3346
      default state will be set at build time and it can be overridden at 'make'
3347
      time.
3348
 
3349
    * JATS utility: CCdiff
3350
      Corrected operation of the option "-new=dir=."
3351
 
3352
    * Nunit support in CSHARP
3353
      Improved support for different version of Nunit
3354
      Allow the DLLs that are required by nunit to be specified 
3355
      within the package.
3356
 
3357
    * Jats utility: dstatus
3358
      Suppresses archived releases.
3359
      Shows release state
3360
 
3361
    * Build file directive: BuildPkgArchive
3362
      Extended list of supported directories to include 'wsdl'.
3363
 
3364
Internal Changes:
3365
    * JATS make: Detection of makefile dependencies
3366
      Isolated the detection process to one point.
3367
      Previously was being done at two places
3368
        - Within jmake - jats makefile supervisor
3369
        - Within the generated makefile. This is still present but
3370
          is suppressed if jmake is used to invoke the makefile.
3371
 
3372
    * JATS make: Command line
3373
      Removed the use of the un used "VERBOSE=1" operation
3374
      Improved use of "options=args|allargs"
3375
 
3376
      It didn't work on all platforms.
3377
      Is better does with "options=args" or "options=allargs"
3378
 
3379
    * JATS command line
3380
      Improved operation of the -help,-man, -verbose and -debug options
3381
      to allow:
3382
        + Direct level specification (-verbose=3)
3383
        + Better use of Perl Option Parsing Utilities
3384
        + Consistent use of option parsing
3385
 
3386
    * JATS makefile generation
3387
      Simplifies creation of internal rules
3388
      Improved readability of the generation process
3389
      Improved readability of the generated makefile
3390
      Removed dead code
3391
      Improved the creation of Progs
3392
 
3393
    * JATS error reporting
3394
      Added a Fatal call to allow utilities to report infrastructure
3395
      problems.
3396
 
3397
      Corrected problem in the use of GBE_[tag]_VERBOSE and GBE_[tag]_DEBUG
3398
      environment variables where the 'tag' contains a space.
3399
 
3400
    * Assorted Perl files
3401
      Minor corrected after running Perl Syntax check over JATS files.
3402
 
3403
    * Made the use of IFLAGS uniform for all JATS toolsets
3404
      Removed the need, and use of IFLAGS3; simplifying the generated
3405
      makefiles
3406
 
3407
    * Corrected tagging  of files generated by the various toolsets
3408
      Many files where incorrectly tagged and were not being cleaned up.
3409
 
3410
    * FileUtils package.
3411
      Added functions to create and append text to small text files.
3412
      Provides consistent error messages and simplifies creation of small files.
3413
      Used functions within JATS.
3414
 
3415
 
3416
------------------------------------------------------------------------
259 dpurdie 3417
Version:  2.76.2000.cr                               Released: 23-Jul-08
257 dpurdie 3418
------------------------------------------------------------------------
259 dpurdie 3419
Minor changes:
3420
    * New Platform and Toolset : ACEX
3421
      Provides support for the Fairchild ACEx assebmler
3422
 
3423
------------------------------------------------------------------------
3424
Version:  2.76.1000.cr                               Released: 10-Jul-08
3425
------------------------------------------------------------------------
257 dpurdie 3426
Major changes:
3427
 
3428
    * Jats make: Package and Install directives [DEVI-049299]
3429
      Convert relative pathnames to absolute pathnames before passing
3430
      to copy command. This makes the most of Windows limited path length
3431
      as implemented by many Windows utilities.
3432
 
3433
Minor changes:
3434
    * JATS makefile generation: Provide case-corrected pathnames for
3435
      library and include files in dpkg_archive.
3436
 
3437
      Needed to support badly formed legacy packages when used with
3438
      some windows tools.
3439
 
259 dpurdie 3440
------------------------------------------------------------------------
255 dpurdie 3441
Version:  2.76.0000.cr                               Released: 24-Jun-08
3442
------------------------------------------------------------------------
3443
Major changes:
3444
    * Support for Microsoft Visual Studio 2005 [DEVI-049017]
3445
      The product must be installed in its default location.
3446
 
3447
      New platforms:
3448
        CSHARP2005
3449
         Uses C# Framework Version 2.0.50727
3450
         Support extends to allow:
3451
            1) Building of Csharp source using standard JATS
3452
            2) Build Visual Studio solutions
3453
         Can consume files from CSHARP and WIN32 components.
3454
 
3455
        VS2005
3456
         Support extends to allow:
3457
            1) Building of C and C++ source using standard JATS
3458
            2) Build Visual Studio solutions
3459
         Can consume files from VS2003 and WIN32 components.
3460
 
3461
      The existing WIN32 and CSHARP platforms can also utilize VS2005
3462
      through a version selector:
3463
        WIN32 Toolset   - "MS.NET2005"
3464
        CSHARP Toolset  - "MS.NET2005"
3465
 
3466
    * Version of Make for Win32 builds
3467
      The version of Make has been upgraded to 3.81 to provide access
3468
      to macros to simplify support for the MS VS2005.
3469
 
3470
    * CSHARP and WIN32 platforms
3471
      The LIB path uses to locate libraries and DLLs has been altered to:
3472
        - Contain absolute paths. Relative paths did not work under all
3473
          conditions when building projects and solutions.
3474
        - Contain valid paths. JATS generated paths that do not physically exist
3475
          will be removed from the search path. This removes warning messages
3476
          under VS2005.
3477
 
3478
Minor changes:
3479
    * New Jats utility: dstatus
3480
      Display Build Daemon Status. A text based utility.
3481
      Use 'jats dstatus -man' for full details.
3482
 
3483
    * PPC_603E Toolset
3484
      Changed the definition of HOST_CPU to be correct for the linux
3485
      architecture that uses the value - powerpc.
3486
 
3487
      Extended LinuxDrivers directive to allow for powerpc.
3488
 
3489
      Updated the MakeLinuxDriver directive to use EXTRA_CFLAGS as CFLAGS
3490
      has been removed. This change is backwardly compatible.
3491
 
3492
    * Modified all utilities to avoid a Perl-10 warning message [DEVI-049018]
3493
      Improved usage of the 'require' statement used to check for
3494
      a minimal value of perl.
3495
 
3496
      Removed excessive require statements.
3497
 
3498
    * JATS internal utilities - xmake
3499
      Source for Make 3.81 is now controlled
3500
      Include JATS specific files for
3501
        1) Windows
3502
        2) Linux
3503
 
3504
      JATS now includes binaries for make.
3505
      This will ensure that the version of make being used will be known for all
3506
      machines. Gnu make does not need to be installed for the various build
3507
      machines.
3508
 
3509
    * JATS internal utility sh.exe (windows)
3510
      Extended internal debugging via EnvVar SHDEBUGEXEC
3511
 
3512
    * JATS Environment
3513
      Allow Jats Environment variables that are used to specify a directory
3514
      to be set to either '-' or 'none'. The associated path will set to empty.
3515
 
3516
      This can be used to override defaults that may be inserted by the JATS
3517
      wrapper scripts.
3518
 
3519
    * JATS utility: sandbox (Experimental)
3520
      Correct problem with location of build files.
3521
      Spell check help and code.
3522
 
3523
------------------------------------------------------------------------
253 dpurdie 3524
Version:  2.75.3000.cr                               Released: 06-Jun-08
251 dpurdie 3525
------------------------------------------------------------------------
3526
Major changes:
3527
 
3528
Minor changes:
253 dpurdie 3529
    * Jats utility: release [DEVI-047291]
3530
      A race condition within clearcase will cause a view to fail during
3531
      creation. This is detected and the command will be retried a number
3532
      of times.
3533
 
3534
------------------------------------------------------------------------
3535
Version:  2.75.2000.cr                               Released: 27-May-08
3536
------------------------------------------------------------------------
3537
Major changes:
3538
 
3539
Minor changes:
251 dpurdie 3540
    * PPC_603E Toolset
3541
      Changed the definition of HOST_CPU to be non-numeric
3542
 
3543
    * GCC Toolset
3544
      Correct the operation of the assembler interface to 'gas' such that
3545
      options are passed correctly.
3546
 
3547
    * Jats utility: CCdiff [DEVI-048127] [DEVI-048439]
3548
      Sped up the label-label comparison.
3549
      Restored speed to that of observed before the label-view comparison
3550
      was added.
3551
 
3552
      Restored ability to perform a one-sided comparison. This is used when
3553
      reviewing a new package.
3554
 
3555
    * Makefile creation: BuildVersion directive
3556
      Better handling of the generated files such that they are
3557
      automatically included in the source file list.
3558
 
253 dpurdie 3559
    * Toolset updates
3560
      Thyron and gnu_mpt. From An Tran.
3561
 
251 dpurdie 3562
------------------------------------------------------------------------
249 dpurdie 3563
Version:  2.75.1000.cr                               Released: 14-May-08
229 dpurdie 3564
------------------------------------------------------------------------
3565
Major changes:
249 dpurdie 3566
 
3567
Minor changes:
3568
    * PackageFile directive [DEVI-048037][DEVI-047541]
3569
      Now supports the packaging of files with ( or ) in the name
3570
 
3571
------------------------------------------------------------------------
3572
Version:  2.75.0000.cr                               Released: 07-May-08
3573
------------------------------------------------------------------------
3574
Major changes:
247 dpurdie 3575
  * New toolset and platform
3576
    Added support for the PPC_603E platform.
3577
    This uses the powerpc-603e-linux-gnu compiler
3578
    The DEVLINUX and LMOS_DEVLINUX targets have been extended to include
3579
    this platform.
3580
 
3581
Minor changes:
3582
  * Jats utility: CCdiff
3583
    Extended operation to allow one side of the comparison to be a directory
3584
    within a static view. This allows comparison between a label and current
3585
    work.
3586
 
3587
  * Jats utility: release
3588
    Added checking of correct package name and version when files are
3589
    published to dpkg_archive.
3590
 
249 dpurdie 3591
  * Jats utility: jats_rewrite [DEVI-034837]
247 dpurdie 3592
    Extended operation to allow the special properties to be transferred from
3593
    Release Manager to the build tool to the target build. Currently only
3594
    supported for ANT builds.
3595
 
3596
    New 'known' ANT properties are:
3597
        releasemanager.releasename
3598
        releasemanager.projectname
3599
 
3600
    The configuration file, used by this utility, has been extended to support
3601
    tagged data item of the form
3602
 
3603
        releasemanager.releasename = value
3604
        releasemanager.projectname = value
3605
 
3606
  * Mug File Generation
3607
    Added --NoMugFiles option to suppress the creation of Mug Files
3608
    This allows THX files to be collected for possible deployment.
3609
 
3610
    When this option is enabled, the user does not need to specify the
3611
    Device ID, Name or Tier Number, nor are the external tools packages
3612
    required.
3613
 
3614
  * Makefile creation: BuildVersion directive
3615
    Modified the operation of the BuildVersion directive such that the
3616
    location of the files that are generated will be known to the Jats
3617
    makefiles. In this manner the user doesn't not need to know the location of
3618
    the files in order to use them.
3619
 
3620
    The file will need to be declared with a 'Src' directive, but JATS will
3621
    locate the file.
3622
 
3623
    This options does not occur for the 'C' version files. This is intentional
3624
    to ensure backward compatibility.
3625
 
3626
    The operation does occur for version files of Style:
3627
        * CSharp
3628
        * Properties
3629
        * WinRC
3630
 
3631
  * JATS directive: CompileOptions
3632
    Correct operation of options that make use of assigned values.
3633
    The case of the value is now preserved.
3634
    Value is correctly assigned.
3635
 
3636
------------------------------------------------------------------------
3637
Version:  2.74.0000.cr                               Released: 29-Apr-08
3638
------------------------------------------------------------------------
3639
Major changes:
245 dpurdie 3640
  * M16C toolset. Used by the MPR platform to build MCRFirmware [DEVI-047555]
3641
    Corrected the version number embedded in the generated THX file.
3642
 
3643
    Major and minor numbers greater than 9 were incorrectly represented
3644
    Added a test to ensure that the major and minor numbers are in the range
3645
    of 0 to 99 inclusive.
3646
 
3647
  * Auto-build when multiple build.pl files are labelled [DEVI-047461]
3648
    Modified JATS to allow support for the automated building of packages that
3649
    contain multiple, labeled, build files.
3650
 
3651
    Added a '-locatepkg=pkg' option to the Jats wrapper script. This allows the
3652
    user to specify the package to be selected from those that can be found.
3653
    This will be integrated into the build tool.
3654
 
3655
    Modified the operation of the 'jats release' command to use the
3656
    infrastructure provided by the above feature. Testing a release uses the
3657
    additional information to ensure that the created package name and version are
3658
    correct.
3659
 
3660
    Modified the operation of the (experimental) 'jats sandbox command to use
3661
    the infrastructure provided by the above feature.
3662
 
3663
Minor changes:
3664
  * Solaris Toolset [DEVI-047398]
3665
    The toolset no longer requires that the user have the compiler and the
247 dpurdie 3666
    'ar' utility in their path. It will be controlled by the toolset.
245 dpurdie 3667
 
3668
    This should improve build reproducibility.
3669
    This will simplify new user setup.
3670
 
3671
  * All Unix Toolsets
3672
    Corrected the operation of the 'options=showenv' so that it works
3673
    on unix systems
3674
 
3675
  * JATS release utility  [DEVI-047356]
3676
    Fixed problem where utility would issue a 'Broken Pipe' message
3677
    on some Solaris Machines.
3678
 
3679
  * JATS -version=<version>
3680
    Fixed operation on machines that do not have a GBE_DPKG_CACHE such that
3681
    JATS does not attempt to cache the alternate version.
3682
 
3683
------------------------------------------------------------------------
3684
Version:  2.73.4000.cr                               Released: 10-Apr-08
3685
------------------------------------------------------------------------
3686
Major changes:
243 dpurdie 3687
    * New platform: WCEPSION_500_emu [DEVI-047234]
245 dpurdie 3688
      Creates binaries for the WCEPSION_500 emulator
243 dpurdie 3689
      Added this platform to the default 'WINCE' alias.
3690
 
3691
Minor changes:
3692
    * JATS escrow utility [DEVI-047232]
3693
      Handle package names that have spaces and brackets
3694
 
3695
    * JATS release utility [DEVI-047232]
3696
      Handle view names that have spaces and brackets
3697
 
3698
    * Removed detection of unknown platforms
3699
      Does not work with LMOS
3700
 
3701
    * Readme.txt file
3702
      Added a brief description on the core_devl directory structure.
3703
 
3704
    * Misc Cleanup
3705
      Removed version-1 test that is not applicable to the current jats
3706
      Move PostInstall script into the BUILD directory.
3707
 
3708
------------------------------------------------------------------------
3709
Version:  2.73.3000.cr                               Released: 07-Apr-08
3710
------------------------------------------------------------------------
3711
Major changes:
241 dpurdie 3712
  * MOS68K Toolset (Not MOS68KRM)
3713
    Force compiler option -nOj
3714
    The default compiler option (-Oj) has been seen to cause problems with some
3715
    code. Problem reported/analysed by rparker and thunter.
237 dpurdie 3716
 
241 dpurdie 3717
  * MOS68K Toolset (Not MOS68KRM)
3718
    Correct problem in disabling Global Optimization that was introduced in
3719
    version 2.73.1000
3720
 
237 dpurdie 3721
Minor changes:
241 dpurdie 3722
  * JATS makefiles
3723
    Correct problem where a Production/Debug only build would create OBJ
3724
    directories for both production and debug, and not clean them up.
3725
 
3726
  * JATS builds
3727
    Allow ANT builds to be run in verbose mode to facilitate debugging
3728
    The command "make all options=args" will run the ANT builds in 'verbose'
3729
    mode.
3730
 
3731
  * JATS makefiles
3732
    Extended the 'selector' used in all makefile directives - as the first
3733
    argument. Added two non-platform related options:
3734
        --Project=xxxx      True if the package suffix matches
3735
        --Defined=yyy       True if yyy is declared with a SetValue or
3736
                            SetList directive.
3737
 
3738
    ie: AddSrcDir ('--Project=sls' , 'sls' );
3739
        AddSrcDir ('!--Project=sls', 'default');
3740
 
3741
  * JATS makefiles. MakeProject directive
3742
    New packaging options to package up programs to be used as JATS plug-ins
3743
        --PackageTool=xxxx
3744
        --PackageToolProd=xxx
3745
        --PackageToolDebug=xxx
3746
 
3747
  * JATS buildfile processing
3748
    Generate a warning for build platforms that are unknown to JATS
3749
    These may be the result of a user typo or an incompatible version
3750
    of JATS.
3751
 
3752
  * JATS save_build utility
3753
    Correctly handle autobuild branches that contain multiple checkouts, one of
3754
    which may be reserved.
3755
 
3756
  * JATS gen_cots utility
3757
    Correctly labels directories up to the VOB root.
3758
    Displays the correct 'Source Path' in the Release Manager Information.
3759
    Ignores the 'administration_view' as this is read-only
3760
 
3761
  * JATS sandbox (experimental)
3762
    Ensure the AutoBuildTool does not use any sandbox
3763
 
3764
  * JATS release (cbuilder) utility
3765
    Handle paths that have a trailing path separators.
3766
 
3767
  * JATS Makefile generation. Packaging directives
3768
    Packaging directives that use the --Dir option have been modified
3769
    such that the direction cannot use a a relative path.
3770
 
3771
    * Escrow tool
3772
      Creates a simple HTML file that details all the packages with a short
3773
      description.
3774
 
3775
------------------------------------------------------------------------
3776
Version: 2.73.2000.cr                                Released: 06-Mar-08
3777
------------------------------------------------------------------------
3778
Major changes:
3779
 
3780
Minor changes:
239 dpurdie 3781
    * Corrected operation of GBE_PLATFORM, when building a GENERIC package.
3782
      A GENERIC package can now be built independently of the value
3783
      of GBE_PLATFORM.
3784
 
3785
    * MOS Toolset
3786
      If only building for a production target, then don't generate an error
3787
      if there is no debug data and code addresses specified.
3788
 
3789
      Use to build platform independent MOS Releases. Cannot have debug, but
3790
      can have production (PIC) components.
3791
 
3792
    * Utility command: jats abt
3793
      Parse and use -buildfile=xxx option
3794
 
3795
    * Utility command: jats extract -extractfiles
3796
      The extractfiles option will now duplicate empty directories
3797
 
3798
    * Building ANT projects under JATS
3799
      Ensure that the PATH is correctly setup so that ANT can locate
3800
      utilities within the JAVA directory - for both Solaris and Windows.
3801
      Previously only worked on Windows
3802
 
3803
------------------------------------------------------------------------
3804
Version: 2.73.1000.cr                                Released: 21-Feb-08
3805
------------------------------------------------------------------------
3806
Major changes:
3807
 
3808
Minor changes:
237 dpurdie 3809
    * Jats Label Utility
3810
      Correct use of '-norecurse' operation.
3811
 
3812
    * Jats command line under Unix
3813
      Corrected problem when command line quoted arguments with a space are
241 dpurdie 3814
      passed in. ie: -xxx="aaa bbb ccc"
237 dpurdie 3815
 
3816
    * Escrow tool
3817
      Added totals to all the tables created in the HTML report
3818
 
3819
    * Platform MOS68KRM
3820
      Rome builds. Modified compiler options to match the existing build system
3821
 
3822
------------------------------------------------------------------------
239 dpurdie 3823
Version: 2.73.0000.cr                                Released: 20-Feb-08
237 dpurdie 3824
------------------------------------------------------------------------
3825
Major changes:
235 dpurdie 3826
    * New Toolset: BORLAND
3827
      The toolset uses the Borland C++ Builder 6 to build Borland Project
3828
      files via the MakeProject directive.
231 dpurdie 3829
 
235 dpurdie 3830
      In this release there is no support for native compilation and linking.
3831
 
3832
      Details are provided in MASS-00166 JATS Reference Manual
3833
 
231 dpurdie 3834
Minor changes:
235 dpurdie 3835
    * Extract/Release utility.
3836
      Handle Source Path option with spaces by creating a config spec
3837
      that can handle spaces
3838
 
3839
    * MOS Compiler
3840
      The TMP directory used by the assembler will be created before the
3841
      assembler is invoked. This will ensure that the directory exists.
3842
 
3843
    * Utility: create_dpkg
3844
      Uses the first 'descpkg' file found. Allows packages that have embedded
3845
      descpkg files to be copied.
3846
 
3847
    * AVR_IAR Toolset
3848
      Added support for AT90SC144144CT - by David Payne.
3849
 
3850
    * JATS ANT command
3851
      Better selection of the ant build file
3852
 
3853
    * Build directive: BuildVersion
3854
      Extended the WinRc version file to allow the name of an icon to be
3855
      embedded in the .RC file.
3856
 
3857
------------------------------------------------------------------------
3858
Version: 2.72.2000.cr                                Released: 06-Feb-08
3859
------------------------------------------------------------------------
3860
Major changes:
3861
 
3862
Minor changes:
233 dpurdie 3863
    * Building JATS. Installer will set a+x in dpkg_archive
3864
 
3865
    * JATS rewrite. Remove the need  for the 'name=' attribute in the
3866
      <project> field.
3867
 
3868
    * CCdiff utility
3869
      Now ignores blank lines when generating a file difference report.
3870
 
3871
    * Escrow utility
3872
      Quote 'path' in the generated extraction commands
3873
      Allow escrow to be based on a single Release Manager package
3874
 
3875
    * Minor Perl-10 tweaks  
3876
 
3877
------------------------------------------------------------------------
3878
Version: 2.72.2000.cr                                Released: 24-Jan-08
3879
------------------------------------------------------------------------
3880
Major changes:
3881
 
3882
Minor changes:
231 dpurdie 3883
    * Jats Tool: CCbc2 [DEVI-044908]
3884
      Locates BeyondCompare through the Windows Registry. This allows
3885
      BeyondCompare to be installed in places other then the default location.
3886
 
3887
    * Jats test runtime helper scripts set_PLATFORM.bat
3888
      Windows. Batch file modified so that it doesn't exit the shell.
3889
 
3890
    * Jats wrapper
3891
      If JATS attempts to cache itself and an error is reported by the caching
3892
      utility, then Jats would fail without reporting an error message.
3893
 
3894
------------------------------------------------------------------------
3895
Version: 2.72.00000.cr                                Released: 11-Jan-08
3896
------------------------------------------------------------------------
3897
Major changes:
229 dpurdie 3898
    * Jats Release Mechanism
3899
      Jats can now release itself. This is not the same a building all of its
3900
      internal components, but it does mean that a new version of JATS can be
3901
      released using the 'standard' mechanism.
3902
 
3903
      Jats releases will be tracked in Release Manager.
3904
 
3905
      A side effect of this is that the labelling scheme will change to align
3906
      itself with Release Manager. ie: <package_name>_<package_version>.
3907
 
3908
    * Running Jats
3909
      Running Jats from within a ClearCase view is being deprecated.
3910
      Jats should be run from a package present in dpkg_archive.
3911
      This may affect some windows developers.
3912
 
3913
      This release of JATS can be run from ClearCase, but generates a warning.
3914
      Future versions will generate an error.
3915
 
3916
      Refer to MASS-00164 Installing and Using JATS.
3917
 
3918
Minor changes:
3919
    * Perl Version Check
3920
      Jats will generate a warning if the version of Perl in use is newer
3921
      than the version used in test. Newer versions are not always backward
3922
      compatible. Currently JATS has been extensively tested with 5.8.8.
3923
 
3924
    * Build Directive: BuildVersion
3925
      This directive has been extended to allow the creation of a 'properties'
3926
      file. This file may be used to pass version information into a an ANT
3927
      build.
3928
 
3929
    * Jats Internals
3930
      Minor fix to interwork with Perl version 5.10.
3931
      Perl 5.10 has not been extensively tested - yet.
3932
 
3933
    * Jats Tool: CCbc2
3934
      Added utility to use BeyondCompare (BC2) to compare files in two
3935
      packages defined as ClearCase labels. The utility creates two dynamic views
3936
      and starts BeyondCompare. The views are destroyed at the end of the
3937
      process.
3938
 
3939
      Requires BeyondCompare to be installed in its default location.
3940
      Only works under Windows.
3941
 
3942
      Use jats CCbc2 -help (or -man) for further details.
3943
 
3944
    * Jats test runtime helper scripts set_PLATFORM.sh
3945
      Marked as executable, so that users can run them directly
3946
 
3947
    * Jats test runtime helper scripts set_PLATFORM.bat
3948
      Uses SETLOCAL / ENDLOCAL to prevent environment variables being exported
3949
      into the parent space. This mimics the behaviour of Unix.
3950
 
3951
    * Jats eprog
3952
      Consistent cross-platform handling of programs found in the current
3953
      directory.
3954
 
3955
    * jats tool jats_metrics
3956
      A new utility that will be used by the Automated Build System to collect
3957
      build metrics.
3958
 
3959
------------------------------------------------------------------------
227 dpurdie 3960
Version: 2.71.6.cr                                Released: 18-Dec-07
3961
------------------------------------------------------------------------
3962
Major changes:
3963
 
3964
Minor changes:
3965
    * Jats Tool: create_dpkg
3966
      Added options to allow the utility to sanity test the package name and
3967
      version of the package being created. This is intended to be used by the
3968
      automated build system. New options are:
3969
        -pname=Package_Name
3970
        -pversion=Package_Version
3971
 
3972
      Added option to allow the source package form to be tested, without
3973
      transferring the package. New options are:
3974
        -test
3975
 
3976
    * Jats Tool: CCdiff
3977
      -output=filename now works. Previously only -out=filename worked.
3978
      -vob=name does not generate internal message under unix
3979
 
3980
    * JATS Environment variables GBE_BUILDFILTER and GBE_PLATFORM can be either
3981
      a space separated or a comma separated list.
3982
 
3983
    * Solaris Toolset
3984
      Disable the use of purify, purecov and quantify when building shared
3985
      libraries. Shared libraries are not supported by these tools. Executable
3986
      programs are still supported.
3987
 
3988
------------------------------------------------------------------------
3989
Version: 2.71.5.cr                                Released: 07-Dec-07
3990
------------------------------------------------------------------------
3991
Major changes:
3992
 
3993
Minor changes:
3994
    * WINCE toolsets
3995
      Added a run-time test for the presence of the required toolset
3996
      This will report an error if the required WINCE toolset has not been
3997
      installed. This is better than obscure message generated by the compilers
3998
      when header files cannot be found.
3999
 
4000
    * GenerateFiles directive
4001
      If the generating tool can only be found in the users path, don't make
4002
      it a prequisite under Windows. There are problems with spaces in pathnames
4003
      that are difficult to solve.
4004
 
4005
    * MakePerlModule directive
4006
      Extended the directive syntax to allow command line options to be passed
4007
      to the the module builder.
4008
 
4009
    * Jats Tool: label
4010
      Add the ability to label specific sub-directories (-dirs=name[,name]+)
4011
      Allow the -up option to be used in conjunction with the  -files=xxx and
4012
      -dirs=xxx options.
4013
 
4014
    * Jats Tool: release
4015
      Corrected a problem when multiple ant builds where located within the
4016
      build view. Now all ants builds will be perform.
4017
 
4018
      Expanded the operation of the '-build=name' option such that it can be
4019
      used to limit ANT builds by specifying the name of the depends.xml file.
4020
 
4021
    * Jats Tool: CCdiff
4022
      Added utility to provide difference reports in a format suitable to be
4023
      uploaded to CodeStriker.
4024
 
4025
      Use jats CCdiff -help (or -man) for further details.
4026
 
4027
 
4028
------------------------------------------------------------------------
4029
Version: 2.71.4.cr                                Released: 30-Nov-07
4030
------------------------------------------------------------------------
4031
Major changes:
4032
    * New Platform : MOS68KRM
4033
      Building MOS for the 68K processor for Rome
4034
      Requires the Microtec 4.5R compiler
4035
      Similar to MOS68K, but has different optimization and definitions
4036
 
4037
Minor changes:
4038
    * label utility
4039
      Better handling of filenames with embedded spaces.
4040
 
4041
    * make package and install operations
4042
      Improved the error detection and reported that may occur during a file
4043
      transfer.
4044
 
4045
    * make clean up
4046
      Improved the cleanup of generated files.
4047
 
4048
    * Jats Tool: jats_transform_file
4049
      Tool that can be used within makefiles and test harnesses to perform
4050
      minor file transformations such as:
4051
        Copy, with optional rename
4052
        Force Dos or Unix style line endings
4053
        Perform simple TAG replacement
4054
 
4055
      Use 'jats jats_transform_file -help' for details
4056
 
4057
    * jats release utility
4058
      Added the -extractfiles option to extract files without leaving a view
4059
      in place.
4060
 
4061
    * escrow utility
4062
      Added -extract option to assist in creating images of all files in
4063
      the escrow, with a log file to summarize success/failure of the extraction.
4064
 
4065
------------------------------------------------------------------------
4066
Version: 2.71.3.cr                                Released: 16-Nov-07
4067
------------------------------------------------------------------------
4068
Major changes:
4069
 
4070
Minor changes:
4071
    * Makefile generation
4072
      Corrected a problem in the detection of a generated target
4073
      Some JAVA builds were not correctly detecting the need to run the
4074
      generate phase early.
4075
 
4076
------------------------------------------------------------------------
4077
Version: 2.71.2.cr                                Released: 09-Nov-07
4078
------------------------------------------------------------------------
4079
Major changes:
4080
 
4081
Minor changes:
4082
    * GBE_PLATFORM operation
4083
      Restored operation of GBE_PLATFORM. This feature is not encouraged.
4084
 
4085
    * Makefile generation
4086
      Added a sanity check to generate a warning if a file is packaged, or
4087
      installed, from more than one makefile.pl
4088
 
4089
    * Utilities gen_msproject, gen_dirlist and gen_metrics
4090
      Modified to use generic interface to the makefile data
4091
 
4092
    * AutoBuilder support tool 'save_build'
4093
      Check for users having placed locks on the build file and the autobuild
4094
      branch. The locks will be removed.
4095
 
4096
    * jats_rewrite utility
4097
      Better handling of DOS line ending under Unix
4098
 
4099
    * jats escrow utility
4100
      Can now create a simple escrow build, and information, on a Release.
4101
      Still handles an escrow based on an SBOM.
4102
 
4103
      Can be used to create an HTML report on unbuildable packages and
4104
      inconsistent packages.
4105
 
4106
    * jats make help
4107
      Corrected the list of target platforms to only show those that are
4108
      available within the current build.
4109
 
4110
    * jats makefiles
4111
      Modified the behaviour of jats when multiple instances of the
4112
      MakefileGenerate() directive are found.
4113
 
4114
      If the MakefileGenerate() directive is found in the 'common' makefile.
4115
      pl, then it will be ignored.
4116
 
4117
    * gcc toolset
4118
      SharedLibries.
4119
        The --Def=name option supports two types of def file
4120
        The 'old' form is used if the name of the Def file ends in .def
4121
 
4122
        The 'old' form is created by the existing versions of mod_if.pl
4123
        The 'new' form is created by tne new versions (daf_tools 25.1.5000.cr)
4124
        of mod_if - if the name of the file does not end in .def.
4125
 
4126
      SharedLibraries and Prog (Experimental)
4127
        New options:
4128
            --MultiScan
4129
            --NoMultiScan ( default)
4130
            MultiScan will scan the libraries until no more undefined references
4131
            can be satisfied. This may simplify linking of complex programs.
4132
 
4133
 
4134
------------------------------------------------------------------------
4135
Version: 2.71.1.cr                                Released: 16-Oct-07
4136
------------------------------------------------------------------------
4137
Major changes:
4138
 
4139
Minor changes:
4140
    PackageLib directive
4141
    The construct "PackageLib( '*', @SHLIBS, @LIBS );" now works as expected.
4142
    Packaging multiple libraries and shared libraries works as expected.
4143
    Packaging multiple shared libraries works as expected.
4144
 
4145
    MakefileGenerate directive
4146
    This directive should only be called once. JATS will now generate a warning,
4147
    and not produce an erroneous, if the directive is invoked more than once.
4148
 
4149
    Multiple Parent detection
4150
    A makefile.pl that is invoked from more than one other makefile.pl, or the
4151
    build.pl, is counted as having multiple parents. This condition is
4152
    normally treated as an error. When run by the Auto Built Tool, this
4153
    condition will be treated as a warning.
4154
 
4155
    Solaris Toolset
4156
    Added option '--WithMisalign' to the SharedLib directive.
4157
    When used in conjunction with the 'misalign' CompleOption this option will
4158
    cause a machine specific object file (misalign.o) to be included in the
4159
    link.
4160
 
4161
    Programs that are created with 'misalign' will automatically include the
4162
    misalign.o object file. The fact that shared libraries do not may be an
4163
    indication that this is a bad thing to do.
4164
 
4165
    Make and generation of subdirectories
4166
    Fixed an issue which caused created directories to have a bad timestamp.
4167
    This could result in multiple attempts to generate the source dependency
4168
    file.
4169
 
4170
------------------------------------------------------------------------
4171
Version: 2.71.0.cr                                Released: 10-Oct-07
4172
------------------------------------------------------------------------
4173
Major changes:
4174
    Makefile generation and make recursion
4175
    Extensive changes to the makefiles that are generated by JATS and method by
4176
    which JATS recuses through subdirectories during a build.
4177
 
4178
    Summary of changes:
4179
        - Removed the use of 'make' to perform recursion over subdirectories
4180
          and platforms. This has been replaced by a JATS program  that performs
4181
          the same task - only a great deal faster and with a greater scope for
4182
          flexibility.
4183
 
4184
          The user interface remains identical: jats make ....
4185
 
4186
        - Replaced the generated 'Makefile' with 'Makefile.gbe'. This is a text
4187
          file that provides sufficient information to allow JATS to locate the
4188
          interface directory and associated build information.
4189
 
4190
        - Significant speed up in determining the need to rebuild a makefile.
4191
          On a large package this has been reduced from 30+ seconds to less
4192
          than one second.
4193
 
4194
        - Significant speed up of large recursive builds through intelligent
4195
          building of the 'make_init' target. This is only processed once for
4196
          each platform type. Previously it was processed in each and every
4197
          makefile. This make target is used, internally, to perform sanity
4198
          testing of the compiler environment and to display the name of the
4199
          toolset. It is an expensive operation.
4200
 
4201
        - Intelligent speed up of large recursive through better mechanism
4202
          for creating required directories. These are now created on the fly,
4203
          rather than via a slow recursive pass though all makefiles.
4204
 
4205
        - Better makefile rebuilding
4206
          Makefiles can be rebuilt on the fly. The previous system was prone to
4207
          detecting that makefiles needs to be re-built, but then not re-
4208
          building them.
4209
 
4210
        - Detection of build file changes
4211
          The make process will detect that the build file has been modified
4212
          and that the component has not been rebuilt. This is a warning. It
4213
          does not prevent the 'make' operation.
4214
 
4215
        - Quieter make output
4216
          The 'Nothing to be done' message has been disabled.
4217
 
4218
 
4219
Minor changes:
4220
    MakeAnt Directive
4221
    Allows ANT_HOME to be a path with spaces. ie: c:\Program Files\apache-ant-1.6.5
4222
 
4223
    JATS command "debug" and "prod"
4224
    These now handle make arguments and options correctly. Thus the command:
4225
        jats prod WIN32 OPTIONS=args
4226
    Will correctly do a production build for WIN32 with command execution
4227
    display. Before, the system would attempt to process prod_OPTIONS=args.
4228
 
4229
    CSHARP toolset
4230
    Correctly detect missing compiler directories
4231
 
4232
------------------------------------------------------------------------
4233
Version: 2.70.2.cr                                Released: 27-Sep-07
4234
------------------------------------------------------------------------
4235
Major changes:
4236
 
4237
Minor changes:
4238
    Java target. Resolve problem of multiple project builds when multiple files
4239
    are generated.
4240
 
4241
    MakeAnt
4242
    If the Ant build fails JATS will terminate.
4243
    Previously JATS would continue until another error forced its termination.
4244
    This is done through a better startup of ANT using the
4245
    org.apache.tools.ant.launch.Launcher directly.
4246
 
4247
    MCR platform
4248
    Create '.mod' files from the generated THX files.
4249
    This is a MOS binary and can be download to the MCR devices.
4250
 
4251
------------------------------------------------------------------------
4252
Version: 2.70.1.cr                                Released: 20-Sep-07
4253
------------------------------------------------------------------------
4254
Major changes:
4255
 
4256
Minor changes:
4257
    MakeAnt directive extended
4258
    New option: --PackageBase
4259
        This will pass the path to all packages specified with LinkPkgArchive
4260
        directives to the build.xml file. Without the option the path will
4261
        address a 'jar' directory within the package.
4262
 
4263
    New passed parameter: PACKAGEDIR
4264
        This is the path to the output package that is being created by JATS
4265
        Allows the ant build script to place artifacts directly into the
4266
        package image being created.
4267
 
4268
------------------------------------------------------------------------
4269
Version: 2.70.0.cr                                Released: 13-Sep-07
4270
------------------------------------------------------------------------
4271
Major changes:
4272
    * Linux compiler
4273
      Changed the linux compiler used to build Embedded Linux platforms
4274
            DEVLINUX
4275
                LINUX_EMU
4276
                LINUX_ETX
4277
                ARM9TDMI
4278
 
4279
            LMOS
4280
                LMOS_LINUX_EMU
4281
                LMOS_LINUX_ETX
4282
                LMOS_ARM9TDMI
4283
 
4284
 
4285
    This is a non-backwardly compatibly release.
4286
 
4287
    Do not migrate to this version of JATS if you are building against
4288
    existing packages, until the underlying packages have been rebuilt.
4289
 
4290
    Packages created with the previous version of the compiler should not be
4291
    mixed with packages created with the version in this release.
4292
    Packages will be rebuilt with the new compiler as soon as possible.
4293
 
4294
    The new compiler will need to be installed on users VM's
4295
    The compiler package is dpkg_archive/linux_gnu_tools/1.1.0000.cots
4296
    The binary is:crosstool-gcc-4.1.1-glibc-2.5.tar.bz2
4297
    This should be extacted, as root, into / with the (one line) command
4298
         tar -xjf /net/auperaunx26/export/devl/dpkg_archive/linux_gnu_tools/1.1.0000.cots/
4299
                    crosstool-gcc-4.1.1-glibc-2.5.tar.bz2 -C/
4300
 
4301
Minor changes:
4302
    * Skipped 2.69 due to nature of major change
4303
 
4304
 
4305
------------------------------------------------------------------------
4306
Version: JATS_2.68.3                                Released: 28-Aug-07
4307
------------------------------------------------------------------------
4308
Major changes:
4309
 
4310
Minor changes:
4311
    * WIN32 CompileOptions to control use of precompiled headers
4312
      Added a WIN32 specific compiler option to control the pre compiled
4313
      headers.
4314
 
4315
        CompileOptions ('WIN32', 'PreCompileHdrs' );        (default)
4316
        CompileOptions ('WIN32', 'NoPreCompileHdrs' );
4317
 
4318
 
4319
------------------------------------------------------------------------
4320
Version: JATS_2.68.2                                Released: 28-Aug-07
4321
------------------------------------------------------------------------
4322
Major changes:
4323
 
4324
Minor changes:
4325
    * Reverted changes made in JATS_2.68.1 to the library search path
4326
      Although the search order is broken, we will need to live with it.
4327
 
4328
      Addressed the search order of /usr/lib under Solaris by adding a new
4329
      AddLibDir option (--System) to add system paths. These will be searched
4330
      last.
4331
 
4332
      For the record, the search order for header files and libraries is:
4333
 
4334
        1) As specified with AddIncDir/AddLibDir in the local makefile.pl
4335
           or within any such directive with the --Local option
4336
 
4337
        2) Within the components 'local' directories. These are populated with
4338
           InstallHdr and InstallLib directives.
4339
 
4340
        3) Within the 'interface' directory as populated by BuildPkgArchive
4341
 
4342
        4) As specified with AddIncDir/AddLibDir in the 'global' makefile.pl
4343
           or within any such directive with the --Global option
4344
 
4345
        5) Within packages specified by a LinkPkgArchive directive
4346
 
4347
 
4348
        6) As specified with AddIncDir/AddLibDir in any makefile.pl
4349
           with the --System option
4350
 
4351
    * LMOS target platform
4352
      Includes LINUX_ETX
4353
 
4354
------------------------------------------------------------------------
4355
Version: JATS_2.68.1                                Released: 24-Aug-07
4356
------------------------------------------------------------------------
4357
Major changes:
4358
 
4359
Minor changes:
4360
    * Solaris Toolset
4361
      Corrected library search order, such that /usr/lib is search after the
4362
      dependent packages.
4363
 
4364
    * RunTest operation
4365
      Added the current directory '.' to the PATH used when the test is run.
4366
 
4367
    * Csharp toolkit
4368
      .dtd files are treated as resource files too
4369
 
4370
------------------------------------------------------------------------
4371
Version: JATS_2.68.0                                Released: 20-Aug-07
4372
------------------------------------------------------------------------
4373
Major changes:
4374
    * Trap use of uncontrolled versions of 'ant' and the Java Compiler (javac)
4375
 
4376
      It was discovered that a few old makefile.pl's where invoking ant and
4377
      javac directly in order to build small Java components. This was
4378
      normally being done in the guise of the WIN32 target. These packages
4379
      were making assumptions about the version of Java on the users search
4380
      path.
4381
 
4382
      JATS can invoke ANT and build Java based components using the MakeAnt
4383
      directive and the JAVA platform. This method is controlled and
4384
      reproducible.
4385
 
4386
      This release provides changes such that these packages will not build.
4387
      This is better than building incorrectly.
4388
 
4389
      There are several aspects to the change
4390
        1) JATS provides binaries (ant and javac) with an error message. If
4391
           the user invoked ant/javac in a manner that involves searching the
4392
           PATH then these will be used and report an error.
4393
 
4394
       2) A special command (jats abt) can be used to start up the Auto Build
4395
          Tool in a manner that does not alter the PATH seen by the utilities.
4396
          Moreover it does not alter the JAVA_HOME seen by the build. This is
4397
          controlled separately.
4398
 
4399
Minor changes:
4400
    * Sanitize the PATH environment variable
4401
        Ensure the JATS bin directory is the first directory searched
4402
        Remove duplicates
4403
        Place non-existent components at the end of the PATH
4404
 
4405
------------------------------------------------------------------------
4406
Version: JATS_2.67.1                                Released: 17-Aug-07
4407
------------------------------------------------------------------------
4408
Major changes:
4409
 
4410
Minor changes:
4411
    * Makefile sanity test
4412
      Added a test to ensure that makefiles created on a machine of one type are
4413
      not then run on a machine of a different type.
4414
 
4415
      This will prevent files created on solaris-sparc being used on a solaris-
4416
      x86 machine.
4417
 
4418
    * Correct bug in RunTest
4419
      RunTest now extends the PATH to include the local bin directory
4420
 
4421
------------------------------------------------------------------------
4422
Version: JATS_2.67.0                                Released: 13-Aug-07
4423
------------------------------------------------------------------------
4424
Major changes:
4425
    * RunTest directive
4426
      Added support for running tests within the NUNIT test framework for the
4427
      CSHARP target. In the process a generalized mechanism for accessing
4428
      toolset specific test frameworks has been added.
4429
 
4430
      Changes to the directive to support a FrameWork.
4431
        The use of a test FrameWork is signaled with the option
4432
        --FrameWork=<name> If this is present then the raw name of the program
4433
        under test will be passed to the framework. program.
4434
 
4435
        If a FrameWork is in use, then JATS will invoke the specified framework
4436
        builder within the current toolset.
4437
 
4438
      When a framework is in place JATS will pass arguments of the form:
4439
        '--Tag=Text' to the FrameWork. Other options are processed as normal.
4440
 
4441
      With in the Nunit FrameWork the program under test will be a DLL Nunit
4442
      will only operate on a DLL. The DLL must have been created by the makefile
4443
      containing the RunTest directive.
4444
 
4445
      The Nunit Framework supports the following options:
4446
        --Uses=<Name>[,SubOption]+
4447
 
4448
        This option specifies other DLLs that are used by the TestDLL. They will
4449
        be copied in to the test directory, and may be sourced from an external
4450
        package or the components 'local' lib directory.
4451
 
4452
        SubOptions available to The --Uses directive are:
4453
            --NonJats       This is not a JATS built library. It will not have a
4454
                            P or D suffix.
4455
            --Jats          (Default) This is a JATS built library. JATS will
4456
                            select the correct library type for this build.
4457
 
4458
Minor changes:
4459
    * New Cache cleanup mechanism
4460
      When a package is consumed from the 'cache' a flag is updated within
4461
      the cache. The cache aging routines use this file in preference to
4462
      the descpkg file, thus it will prevent the aging of packages that are
4463
      frequently used. The aging policy can be made more aggressive.
4464
 
4465
    * Save Build Utility
4466
      This utility is used by the Auto Build System to save the 'build.pl' file
4467
      used in a ripple build.
4468
 
4469
      The utility has been enhanced to detect  a reserved checkout of the
4470
      build.pl. The checkout will be changed to unreserved - if possible.
4471
 
4472
    * Release Utility
4473
      The 'jats release' command will now unlock any labels that it locked
4474
      when an error is encountered.
4475
 
4476
      This simplifies the 'release' process as the developers label will be
4477
      unlocked if a build error occurs.
4478
 
4479
    * Jats caching local copy of itself
4480
      Fixed a bug which resulted in an "Use of individualized value" message
4481
      being displayed a large number of times during the file transfer process.
4482
 
4483
    * Minor extension to allow plug-in directives to perform a processing step
4484
      before the makefiles are created.
4485
 
4486
    * TestProg directive
4487
      TestProg's are now built in exactly the same manner as Progs
4488
 
4489
    * Correct problem introduced in 2.66.1 with packaging of files with
4490
      a 'space' or '$' in the file name.
4491
 
4492
------------------------------------------------------------------------
4493
Version: JATS_2.66.1                                Released: 20-Jul-07
4494
------------------------------------------------------------------------
4495
Major changes:
4496
    * New build target
4497
            LINUX_ETX           - Support for Linux on an ETX board
4498
            LMOS_LINUX_ETX      - Support for LMOS on the LINUX_ETX target
4499
 
4500
      These targets have also been added to the following pseudo targets.
4501
            DEVLINUX
4502
            LMOS_DEVLINUX
4503
 
4504
    * Internal utility dpkg_cache [Windows]
4505
      Modified to remove use of system utilities to perform the the file
4506
      transfer, after having problems the 'cp.exe' provided by JATS.
4507
 
4508
Minor changes:
4509
    * Added utility class to provide directory searching
4510
      To be used in JATS and JATS support tools
4511
 
4512
    * tweaks to the C# toolset
4513
      Correct problem with filename that start with "n" as in .\not_nice.cs
4514
 
4515
      Create resource files with Fully Qualified Names derived from the .resx
4516
      and .cs files.
4517
 
4518
      Handle Strong Key Names and creates wrappers to provide do the right
4519
      thing.
4520
 
4521
    * Microtec ColdFire compiler
4522
      Further attempts to get the compiler to place all of its temp files in a
4523
      local directory. The compiler uses a large number of EnVars to control
4524
      were it places temp files.
4525
 
4526
      Underlying problem is random compiler failures on big builds. Suspected
4527
      interaction with other builds.
4528
 
4529
    * Release utility command
4530
      Added a -tag=name option to allow the Auto Build Tools to create
4531
      multiple instances of a static view. The tag is used to provide a unique
4532
      component in the clearcase tag name.
4533
 
4534
------------------------------------------------------------------------
4535
Version: JATS_2.66.0                                Released: 27-Jun-07
4536
------------------------------------------------------------------------
4537
Major changes:
4538
  * Support for building CSHARP code
4539
    Natively build C# within JATS using the Microsoft command line programs
4540
 
4541
    Supports the handling of .resx files
4542
 
4543
    Supports the creation of windows programs, console programs and shared
4544
    libraries
4545
 
4546
Minor changes:
4547
  * Unit Tests
4548
    Allow test scripts to be PERL - with a .pl extension
4549
    These will be correctly initiated under WIndows and Unix
4550
 
4551
    Correct warning messsage that is generated if a "CopyIn" file is also listed
4552
    as a Script.
4553
 
4554
 
4555
------------------------------------------------------------------------
4556
Version: JATS_2.65.3                                Released: 11-Jun-07
4557
------------------------------------------------------------------------
4558
Major changes:
4559
 
4560
Minor changes:
4561
  * WINCE Support
4562
    Added WCEPA962_500 support. The WINCE target now includes this target.
4563
    Complete list of WINCE targets is:
4564
        WCEIT3000
4565
        WCEPA961
4566
        WCEPA962
4567
        WCEPA962_500
4568
        WCEPCM7220
4569
        WCEPSION_500
4570
        WCEPSPC_arm
4571
        WCEPSPC_emu
4572
        WCEX86A420
4573
        WCEX86A500
4574
        WCEX86A500_SOM4455
4575
 
4576
 
4577
------------------------------------------------------------------------
4578
Version: JATS_2.65.2                                Released: 06-Jun-07
4579
------------------------------------------------------------------------
4580
Major changes:
4581
 
4582
Minor changes:
4583
  * WINCE Support
4584
    Added WCEPSION_500 support. The WINCE target now includes this target.
4585
 
4586
  * Removed the following targets
4587
        TP5600
4588
        TP5600_ARM9TDMI
4589
        TP5600_EMU
4590
        LMOS_TP5600_ARM9TDMI
4591
        LMOS_TP5600_EMU
4592
 
4593
  * Deployment
4594
    Simplify access to build information during deployment
4595
 
4596
  * build.pl
4597
    Better error check on a packages version number.
4598
 
4599
    The --forcebuildpkg has been extended to copy files on a Unix system, rather
4600
    than to use symlinks. This simplifies remote builds.
4601
 
4602
  * Tool: gen_msprojects
4603
    Has been extended to create either a Debug build (default), or a Production
4604
    build.
4605
 
4606
        Eg: jats etool gen_msprojects -prod
4607
 
4608
  * Tool: escrow
4609
     New features
4610
     Given an rtag_id, report determine packages that are in the 'release' but
4611
     are not in the SBOM.
4612
 
4613
     Prune "patch" package versions.
4614
 
4615
     Specify packages to be ignored.
4616
 
4617
 
4618
------------------------------------------------------------------------
4619
Version: JATS_2.65.1                                Released: 30-May-07
4620
------------------------------------------------------------------------
4621
Major changes:
4622
  * Provided a mechanism by which JATS makefile.pl directives can be extended
4623
    through modules provided by external packages. This will be used to reduce
4624
    the dependancy on JATS of various packaging processes.
4625
 
4626
  * GenerateFiles
4627
    Added the options:
4628
        --UnknownPreq           - Will force the recipe to be run every time
4629
                                  the generated files are required. May be used
4630
                                  when the dependancies are too complex to
4631
                                  describe. ie: Entire directory tree.
4632
 
4633
        --AutoGenerate          - Will not force the recipe to be run during the
4634
                                  'generate' phase, unless the recipe generates
4635
                                  source files. Allows recipes to be run very
4636
                                  late. ie: when the dependent files are actually
4637
                                  required.
4638
 
4639
 
4640
Minor changes:
4641
  * GenerateFile directive
4642
    Added --Var(BuildRoot)
4643
 
4644
  * GCC Toolset
4645
    Creating Shared Libaries with a 'Def' file. The library is now dependent
4646
    on the Def file, such that changes to the Def file will cause the library to
4647
    be rebuilt.
4648
 
4649
  * MakeAnt and MakeProject directives
4650
    Preserve the order in which projects are built.
4651
 
4652
------------------------------------------------------------------------
4653
Version: JATS_2.65.0                                Released: 16-May-07
4654
------------------------------------------------------------------------
4655
Major changes:
4656
 *  Access to Release Manager and Deployment Manager databases
4657
    The database location, user and password have been made configurable via
4658
    environment variables.
4659
 
4660
    Reason: The Release Manager and Deployment Manager databases are being
4661
            moved.
4662
 
4663
    This will affect users that:
4664
        1) Use tools that access RM or DM
4665
           Some tools that build deployable packages
4666
 
4667
        2) Use the ABT system
4668
           The buildadm user, and the ABT scripts will be modified to provide
4669
           the required configuration
4670
 
4671
    If you need to use tools that access RM or DM, outside of the ABT scripts on
4672
    the build machine then you will need to add the following environment
4673
    definitions to your .profile_bash, or jats.bat.
4674
    Windows
4675
        set GBE_RM_LOCATION=jdbc:oracle:thin:@auperaora03:1521:RELEASEM
4676
        set GBE_RM_USERNAME=RELEASE_MANAGER
4677
        set GBE_RM_PASSWORD=RELEASE_MANAGER
5710 dpurdie 4678
        set GBE_RM_URL=http://bms:8002/ManagerSuite/Release_Manager
227 dpurdie 4679
        set GBE_DM_LOCATION=%GBE_DM_LOCATION%
4680
        set GBE_DM_USERNAME=DEPLOYMENT_MANAGER
4681
        set GBE_DM_PASSWORD=DEPLOYMENT_MANAGER
5710 dpurdie 4682
        set GBE_DM_URL=http://bms:8002/ManagerSuite/Deployment_Manager
227 dpurdie 4683
    Note: GBE_RM_LOCATION will change in the near future.
4684
 
4685
 
4686
  * New build platforms
4687
        ARM9TDMI            - To replace TP5600_ARM9TDMI
4688
        LINUX_EMU           - To replace TP5600_EMU
4689
 
4690
        LMOS_ARM9TDMI       - To replace LMOS_TP5600_ARM9TDMI
4691
        LMOS_LINUX_EMU      - To replace LMOS_TP5600_EMU
4692
 
4693
        DEVLINUX            - To replace TP5600
4694
        LMOS_DEVLINUX       - To replace LMOS_TP5600
4695
        LMOS                - New platform that expands to known LMOS targets:
4696
                              LMOS_ARM9TDMI, LMOS_LINUX_EMU, LMOS_WIN32
4697
 
4698
    Many of these targets are designed to replace the badly named platforms
4699
    of TP5600_ARM9TDMI and TP5600_EMU. These will be removed in a future
4700
    release.
4701
 
4702
    The GBE_BUILDFILTER for linux boxes may need to be changed to
4703
         LINUX_I386 ARM9TDMI LINUX_EMU LMOS_ARM9TDMI LMOS_LINUX_EMU
4704
 
4705
    The TP5600* targets should be removed to make it obvious that these packages
4706
    need to be converted.
4707
 
4708
  * Building Linux Device Drivers
4709
    The hard-coded path to the Kernel Headers has been removed.
4710
    Linux Drivers must be built with a suitable package to provide
4711
    the kernel headers. This allows multiple versions of the linux kernel to be
4712
    used for different targets platforms.
4713
 
4714
  * Sandbox support
4715
    Embryonic support for building multiple packages in a common sandbox
4716
    Will remain undocumented until fully implemented.
4717
 
4718
    New command: jats sandbox ...
4719
 
4720
Minor changes:
4721
 
4722
 
4723
------------------------------------------------------------------------
4724
Version: JATS_2.64.1                                Released: 03-May-07
4725
------------------------------------------------------------------------
4726
Major changes:
4727
  * MakeAnt directive
4728
    Added options to allow the and project to unit tests.
4729
 
4730
    New options
4731
        --AutoTest=<target>            # Run as Automated unit test
4732
        --UnitTest=<target>            # Run as Unit test
4733
 
4734
    This will invoke the ant build file, with the specified target, during the
4735
    run_unit_tests phase.
4736
 
4737
  * Sandbox support
4738
    Embryonic support for building multiple packages in a common sandbox
4739
    Will remain undocumented until fully implemented
4740
 
4741
Minor changes:
4742
  * jats build
4743
    Use platform configuration information to prune platforms from the list of
4744
    platforms that will be 'built'.
4745
 
4746
    This simplies the construction of a GBE_BUILDFILTER
4747
 
4748
    This information is not available for all supported platforms, but is
4749
    available for psuedo platforms that transform into machine specific
4750
    platforms. These include SOLARIS, LINUX, TP5600 and LMOS_TP5600
4751
 
4752
  * AVR_IAR Toolset
4753
    Clean up 9 files that may be created by the USB license dongle.
4754
 
4755
  * JATS.BAT
4756
    Example file now provides a default GBE_DPKG definition that assumes that
4757
    the "V" drive is mapped to \\auperaunx26\devl. This allows access to both
4758
    the dpkg_acrhive and the deploy_archive with the one mapping.
4759
 
4760
  * jats label
4761
    Correct problem when locking a label in a specified VOB
4762
 
4763
------------------------------------------------------------------------
4764
Version: JATS_2.64.0                                Released: 16-Apr-07
4765
------------------------------------------------------------------------
4766
Major changes:
4767
  * New build platform:
4768
        LMOS_TP5600
4769
        LMOS_TP5600_ARM9TDMI
4770
        LMOS_TP5600_EMU
4771
 
4772
    LMOS_TP5600 is a tag that will be expanded to the entire family of LMOS_TP5600
4773
    supported targets. A common alias of LMOS_T5600 will be created to
4774
    describe the group of platforms.
4775
 
4776
    LMOS_TP5600_ARM9TDMI and LMOS_TP5600_EMU
4777
    These are LMOS based targets. The 'lmos' package must be used in order to
4778
    build these targets.
4779
 
4780
    The LMOS_TP5600_ARM9TDMI can use components from the TP5600_ARM9TDMI,
4781
    where no LMOS_TP5600_ARM9TDMI components are provided.
4782
 
4783
    The LMOS_TP5600_EMU can use components from the TP5600_EMU,
4784
    where no LMOS_TP5600_EMU components are provided.
4785
 
4786
  * New build platform: WINCE
4787
    This is a tag that will be expanded to all the known WINCE targets.
4788
    Use of this platform will simplify the creation of components for
4789
    consumption on all WINCE machines.
4790
 
4791
    The current list of WINCE targets is:
4792
            WCEIT3000
4793
            WCEPA961
4794
            WCEPA962
4795
            WCEPCM7220
4796
            WCEPSION_420
4797
            WCEPSPC_arm
4798
            WCEPSPC_emu
4799
            WCEX86A420
4800
            WCEX86A500
4801
            WCEX86A500_SOM4455
4802
 
4803
    The WINCE targets actually built will be affected by GBE_BUILDFILTER.
4804
 
4805
 *  JATS makefile.pl
4806
    The package descriptor file, 'descpkg', will be packaged in all makefiles
4807
    that contain packaging directives.
4808
 
4809
    There is now no need to explicitly package the 'descpkg' file, except in
4810
    very unusual configurations.
4811
 
4812
Minor changes:
4813
  * Directive: PackageFile
4814
    Generate a warning if the source file name does not confirm to good naming
4815
    conventions. The filename must not start with a '-' and must not contain
4816
    an '='.
4817
 
4818
    Normally the result of an error in the directive. ie: "-Subdir=etc", instead
4819
    of "--Subdir=etc".
4820
 
4821
  * JATS Internal utility: cmdfile
4822
    Updated Linux and Solaris targets with a version of the cmdfile that
4823
    provides a better error message for libraries that cannot be found.
4824
 
4825
    This version will display the library search path with one item per line,
4826
    rather than all items on one, very long, line.
4827
 
4828
------------------------------------------------------------------------
4829
Version: JATS_2.63.0                                Released: 5-Apr-07
4830
------------------------------------------------------------------------
4831
Major changes:
4832
 
4833
  * JATS release command
4834
    Modified the configuration spec generated when a branching rule is
4835
    specified. The change will ensure that directories are not branched.
4836
 
4837
    Rules are:
4838
        Modify a file:      File will branch
4839
        Adding a file:      Containing directory will not branch
4840
                            File will be placed on a branch
4841
        Add a directory:    Containing directory will not branch
4842
                            New directory will branch
4843
 
4844
Minor changes:
4845
  * JATS release command
4846
    Added -noprefex option to allow the creation of a view directory without the
4847
    user name being prefixed to it. This is useful in creating an escrow view.
4848
 
4849
  * JATS label command
4850
    Detect and report parent directories that are checkedout when a label
4851
    is applied. Previously these had gone unreported.
4852
 
4853
  * JATS make
4854
    Undo previous change to preserve symbolic links while Packaging and
4855
    Installing files. A problem was encountered when a file from a package
4856
    was re-packaged.
4857
 
4858
  * JATS escrow
4859
    Added a tool to generate information for creating an escrow drop.
4860
    Use jats escrow -help for details
4861
 
4862
  * makefile.pl directive: MakeAnt
4863
    This directive will create parameters to specify the location of external java
4864
    packages that have been referenced via a LinkPkgArchive directive.
4865
 
4866
    This allows the build.xml to contruct a CLASSPATH to access JAR files in
4867
    packages, without the overhead of copying the entire package into the
4868
    interface directory.
4869
 
4870
  * build.pl directive: BuildPkgArchive
4871
    Modified the processing of 'jar' directories.
4872
    Directories of the form 'jar.<target>' will be transferred into the 'jar'
4873
    directory as seen by the package.
4874
 
4875
    Intended use: Deployment of oraclient for Solaris 10
4876
 
4877
  * JAVA 6
4878
    JATS now supports all versions of Java through the use of JAVA_HOME_X_Y
4879
    environment variables. Where X andY specify the version of JAVA.
4880
 
4881
    The jats.bat and jats.sh example files only provide indication of 1.4, 1.5
4882
    and 1.6 support, but all versions are now supported.
4883
 
4884
    The "jats vars -v" command will display all JAVA_HOME environment variables
4885
 
4886
  * Jats command: vars
4887
    Extended to show a "*" for EnvVars that do not address a valid directory
4888
    These indicate potential problems.
4889
 
4890
------------------------------------------------------------------------
4891
Version: JATS_2.62.4                                Released: 20-Mar-07
4892
------------------------------------------------------------------------
4893
Major changes:
4894
  * JATS create_dpkg + packageing shared libraries (Unix)
4895
    When a shared library is created a simple symbolic link to the versioned
4896
    libarry is also created.
4897
 
4898
    Previous versions of JATS would replace the symbolic link with a physical
4899
    copy of the file. The effect of this is that when the shared libaries is
4900
    'Installed', 'Packaged' and transferred into dpkg_archive there are two
4901
    files, instead of one file and one link to the file (in the same directory)
4902
    The Solaris shared libraries can be quite large, due to the debug
4903
    information contained within the file.
4904
 
4905
    This version of JATS will preserve symbolic links when 'Installing',
4906
    'Packaging' and transferring to dpkg_archive.
4907
 
4908
    The advantage of this will be significant reduction in disk space used
4909
    within the build environment and dpkg_archive.
4910
 
4911
  * Building Perl Modules
4912
    Modified the process to prevent the module builder attempting to modify the
4913
    documentation on the build machine.
4914
 
4915
    Integrated the 'jats clean' operation.
4916
 
4917
Minor changes:
4918
  * jats create_dpkg
4919
    Added an option to create a built.generic file
4920
    This is only used by the Automated Built Tools.
4921
 
4922
------------------------------------------------------------------------
4923
Version: JATS_2.62.3                                Released: 28-Feb-07
4924
------------------------------------------------------------------------
4925
Major changes:
4926
  * JATS JAVA build target
4927
    The default behaviour of the JAVA build target has changed such that the
4928
    default version of JAVA used will be 1.4.
4929
 
4930
    Previous behaviour was to use whichever version was specified by the EnvVar
4931
    JAVA_HOME. This was not controlled, thus the build was not controlled.
4932
    Problems occur when using the new AutoBuildTool as it uses Java 1.5 and this
4933
    is then picked up as the default version.
4934
 
4935
    If a version, other than 1.4, is required then specify it within the
4936
    build.pl file.
4937
 
4938
Minor changes:
4939
  * jats release
4940
    Ensure that the 'cleartool' command can be found in the users PATH
4941
    Issue an error if it cannot be found.
4942
    This error indicates bad DevEnv setup
4943
 
4944
    Added facility to create a view based on a config_spec, instead of a label.
4945
    Such a view cannot be used to create a release. It is intended to simplify
4946
    the creation of simple static views. The name of view is, by default,
4947
    based on the name of the config spec. Use the -view=name option to change
4948
    the name of the view.
4949
 
4950
  * GenerateFiles directive
4951
    Added new --Vars() to allow packaging of JATS plugin tools.
4952
 
4953
  * MOS Toolset
4954
    When using MOS fast intermodule calls the optimizer will preload commonly
4955
    used memory addresses into a register BEFORE the GDP has been correctly set
4956
    up. Use the following option to suppress this optimization
4957
 
4958
    Added: CompileOptions ('*', 'NoGlobalOptimization' );
4959
 
4960
 
4961
------------------------------------------------------------------------
4962
Version: JATS_2.62.2                                Released: 15-Feb-07
4963
------------------------------------------------------------------------
4964
Major changes:
4965
 
4966
Minor changes:
4967
  * JATS environment
4968
    Ensure that the true path of the Perl executable is present in the PATH
4969
    environment variable. This allows build tool access to various perl utilities
4970
    that are located in the Perl bin directory.
4971
 
4972
    Resolves issues in locating utilities such as pod2html
4973
 
4974
  * Use of GENERIC platforms
4975
    Report an error if a GENERIC platform is mixed with any other platform
4976
    specifier. GENERIC is used for packages that build on all machines because
4977
    they do not use a compiler or linker. They simply contains files that need
4978
    to be packaged.
4979
 
4980
  * Generated makefiles
4981
    Solaris and Linux: Ensure that LD_LIBRARY_PATH is exported if it is used.
4982
 
4983
  * Generating MOS THX files
4984
    Added option --BinaryImage to the SharedLib directive used to create MOS THX
4985
    files. This option will create a binary image (.bin) instead of a .thx file.
4986
    This is being used in the creation of BR Applets.
4987
 
4988
        SharedLib   ( 'MOS', "xxx", @OBJS, "--Rel=xxx.rel", "--BinaryImage" );
4989
 
4990
  * JATS release
4991
    Correct the operation of the -path option under Unix
4992
 
4993
  * JATS extract
4994
    New JATS command. This is the same as 'jats release -extract'
4995
 
4996
  * JATS Toolset
4997
    Added support for the WinCe PSION (WCEPSION_420)
4998
    This is a armv4i device using 4.20 of the WCE SDK    
4999
 
5000
 
5001
------------------------------------------------------------------------
5002
Version: JATS_2.62.1                                Released: 18-Jan-07
5003
------------------------------------------------------------------------
5004
Major changes:
5005
 
5006
Minor changes:
5007
  * jats label
5008
    Added a -vob=name option
5009
    This allwos the label utility to create, lock, unlock, rename and delete
5010
    labels without the user actually being located within the VOB. This option
5011
    cannot be used in conjunction with operations that place labels on files.
5012
    It can only be used for operations that manipulate the label.
5013
 
5014
    Added a -user=name option
5015
    This extends the operation of the -mine operation to change ownership of the
5016
    label to the named user.
5017
 
5018
  * jats release
5019
    Displays the path to the view and the build file in a user friendly manner
5020
    Under Windows it uses \, unless running under cygwin.
5021
 
5022
  * JATS build.pl
5023
    BuildProduct supports the --Uses=xxxx construct on a per-target basis.
5024
    ie:
5025
        BuildProduct ('TP5', 'LMOS_TP5600_EMU', 'LMOS_TP5600_ARM9TDMI,--Uses=TP5600_ARM9TDMI');
5026
 
5027
 
5028
------------------------------------------------------------------------
5029
Version: JATS_2.62.0                                Released: 22-Dec-06
5030
------------------------------------------------------------------------
5031
Major changes:
5032
  * GenerateFiles and RunTest directives
5033
    These directives have been extended to allow a large number of makefile
5034
    values to be added to the command lines,without resorting to knowledge of
5035
    the makefile internals. ie:
5036
        --Var(BuildName)
5037
    will be expanded to (hen building MyPackage)
5038
        -BuildName=MyPackage
5039
 
5040
    The complete list of Variables is provided in the JATS manual.
5041
 
5042
  * GenerateFiles
5043
    Added a --Clean option to allow tools to be invoked in the 'clean' phase
5044
    This allows external scripts to cleanup.
5045
 
5046
  * BuildPlatforms
5047
    Restored operation of the --Uses option
5048
 
5049
Minor changes:
5050
  * GCC Toolset
5051
    Exports path to compiler. Used by scripts to build packages
5052
 
5053
Internal changes:
5054
  * GenerateFiles
5055
    Maintains the arguments in an array for simpler processing.
5056
 
5057
    --Shell is now processed by the 'make' shell rather then invoking an
5058
    external shell. It will be the same shell, just easier to setup.
5059
 
5060
 
5061
------------------------------------------------------------------------
5062
Version: JATS_2.61.3                                Released: 14-Dec-06
5063
------------------------------------------------------------------------
5064
Major changes:
5065
  * Caching JATS
5066
    Added a mechanism whereby JATS can cache a copy of itself on the users local
5067
    drive. This is applicable to windows.
5068
 
5069
    This mechanism will allow a user to address JATS via the soft-links in
5070
    dpkg_archive and pick up the current version of JATS without the penalty of
5071
    then using JATS across a slow(network) link.
5072
 
5073
    The EnvVar GBE_CACHE_JATS controls the operation of this feature.
5074
    Set GBE_CACHE_JATS to one to enable the operation, but it will only be
5075
    effective if JATS is being run from GBE_DPKG in the first place.
5076
 
5077
    Use: Build Machines and Windows Users
5078
 
5079
Minor changes:
5080
  * Build directive: BuildAlias with --Target option
5081
    Corrected a problem when the target name is a expanded platform name (ie:
5082
    TP5600) that prevent correct expansion.
5083
 
5084
  * jats build
5085
    If the user has not configured a cache, then do not attempt to cache
5086
    packages. This will remove an annoying warning message for each package
5087
    processed by the build.
5088
 
5089
  * jats build
5090
    Modified the error messages generated when JATS fails to create the
5091
    makefiles. The previous system would report failures while creating
5092
    makefiles and, at the end of the process, it would generate a large error
5093
    message to indicate the failure. This large message diverted the users
5094
    from reading the other error messages resulting in confusion.
5095
 
5096
  * PackageFile, PackageLib, PackageProg and PackageHdr
5097
    Detect and report as an error use of the --Dir=<Path> option where the
5098
    Path is not specified.
5099
 
5100
    Most instances of this error will be where the option has been mis-used in
5101
    conjunction with a package.pl file, or during transition from using a
5102
    package.pl file. That change is detects errors where the user has specified
5103
        --Dir=$Pinc
5104
    but $Pinc is not defined.
5105
 
5106
  * Purify and Purecov under Windows
5107
    Changes to correct the operation of Rational's tools when used on the
5108
    Windows platform.
5109
 
5110
        - OPTIONS=purecov
5111
            Forces the link operations to generate the relocation table required
5112
            by 'purecov.
5113
 
5114
            Does not attempt to use purecov in the compiler tool chain
5115
            This is required under Solaris, but not Windows
5116
 
5117
        - OPTIONS=purify
5118
            Does not attempt to use purecov in the compiler tool chain
5119
            This is required under Solaris, but not Windows.
5120
            Under WIndows this option does nothing.
5121
 
5122
 
5123
------------------------------------------------------------------------
5124
Version: JATS_2.61.2                                Released: 27-Nov-06
5125
------------------------------------------------------------------------
5126
Major changes:
5127
  * makefile.pl directive Platform
5128
    This directive has been expanded to allow for the negation operation
5129
    Example:
5130
        Platform ('!MOSCF');
5131
            Process makefile for all targets other than MOSCF
5132
            This is the same as Platform ('*', '!MOSCF');
5133
 
5134
    Excluded platform will be processed after included platforms have
5135
    been determined.
5136
 
5137
Minor changes:
5138
  * Added the ScanList directive.
5139
    This directive allows a list of files within an external package to be
5140
    located at build-time.
5141
 
5142
  * Unix based systems
5143
    If the EnvVar LD_LIBRARY_PATH was undefined, then a warning would be
5144
    generated by make under some conditions. The warning has been removed.
5145
 
5146
  * MakeLinuxDriver
5147
    Added a --Define=text option to allow "defines" to be passed to the
5148
    driver being built.
5149
 
5150
 
5151
------------------------------------------------------------------------
5152
Version: JATS_2.61.1                                Released: 20-Nov-06
5153
------------------------------------------------------------------------
5154
Major changes:
5155
 
5156
 
5157
Minor changes:
5158
  * jats_rewrite tool
5159
    Handle the BuildPreviousVersion() directive.
5160
    This directive is only used within deployment scripts.
5161
 
5162
  * Internal package: RmPkgInfo
5163
    Extract modified date when extracting package information
5164
 
5165
    Added the function getDependenciesHash() to provide a hash of all the
5166
    dependancy information within a package.
5167
 
5168
    Added NO_WARN option to the classes 'new' method to supress warning
5169
    messages.
5170
 
5171
------------------------------------------------------------------------
5172
Version: JATS_2.61.0                                Released: 13-Nov-06
5173
------------------------------------------------------------------------
5174
Major changes:
5175
  * makefile.pl directives
5176
    Added directive: MakePerlModule to build and package CPAN style Perl Modules.
5177
 
5178
    Added directive: MakeLinuxDriver to build and Linux Device Driver.
5179
 
5180
    GenerateFiles.
5181
        Added option: --NoGenerate to indicate that the directive does
5182
                      not generate any tangible results. The command will
5183
                      be run on every invocation.
5184
 
5185
 
5186
Minor changes:
5187
  * Added the jats version command
5188
    Will only print out the current version of JATS
5189
 
5190
  * GCC Toolset (Used to build Linux)
5191
  Added options to allow the generation of statically linked programs.
5192
  There are two mechanism:
5193
 
5194
  Globally within the makefile.pl, or if applied in the common makefile.pl
5195
  the option can apply to all programs being built.
5196
 
5197
  CompileOptions ( 'platform', 'StaticProgs' );     - Generate static programs
5198
  CompileOptions ( 'platform', 'No_StaticProgs' );  - Default
5199
 
5200
  Within the Prog directive, the following options will override the global
5201
  default.
5202
    --Static    - Create a statically linked program
5203
    --Shared    - Create a dynamically linked program
5204
 
5205
------------------------------------------------------------------------
5206
Version: JATS_2.60.0                                Released: 03-Nov-06
5207
------------------------------------------------------------------------
5208
Major changes:
5209
  * SunWorks Toolset
5210
    Better determination of the location of the SunWorks compiler and library
5211
    Does not use an environment variable to locate compiler libraries
5212
    It is based on machine type.
5213
    Uses the absolute path to the compiler  and does not use the user's PATH
5214
 
5215
    Corrects a problem on the Solaris10 installs.
5216
 
5217
Minor changes:
5218
  * Perl DBI interface
5219
    Removed the message showing database connection
5220
 
5221
  * JATS internal library
5222
    Better handling of badly formed version numbers
5223
 
5224
------------------------------------------------------------------------
5225
Version: JATS_2.59.0                                Released: 30-Oct-06
5226
------------------------------------------------------------------------
5227
Major changes:
5228
  * GCC Toolset
5229
    Altered the mechanism used to determine cross compilation
5230
    Extended the cross compilers that can be handled by the toolset
5231
    Removed the use of `uname`.
5232
 
5233
  * Added platforms
5234
    TP5600                  ( Expands to TP5600_ARM9TDMI and TP5600_EMU )
5235
    TP5600_ARM9TDMI
5236
    TP5600_EMU
5237
 
5238
Minor changes:
5239
  * descpkg file reader
5240
    Allow handcrafted JAVA based packages that use tabs instead of spaces as a
5241
    field separator.
5242
 
5243
  * JATS eprog command
5244
    Can now start java programs encapsulated within JAR files
5245
 
5246
  * Microtec Coldfire compiler
5247
    Force the compiler to create temp files within the interface directory.
5248
    This is an attempt to solve a infrequent problem seen when multiple builds
5249
    are being performed. The 68k compiler already had a similar fix to address a
5250
    similar, but more pronounced, issue.
5251
 
5252
  * Atmel toolset (DEVI-031788)
5253
    New Products: AT90SC7272C and AT90SC3232CS
5254
        The AT90SC3232CS is identical to the existing AT3232
5255
        The AT90SC7272C replaces the (as yet unused) AT72722
5256
 
5257
    Note: Products of AT3232 and AT90SC3232CS cannot be mixed.
5258
          AT3232 is provided for backward compatibility.
5259
 
5260
------------------------------------------------------------------------
5261
Version: JATS_2.58.0                                Released: 16-Oct-06
5262
------------------------------------------------------------------------
5263
Major changes:  Directive: RunTests
5264
  * The --CopyIn option will always copy in the specified files
5265
 
5266
  * GCC Toolset (Shared Library Generation)
5267
    Added option --Def=file_name to the shared library definitions
5268
 
5269
    When compiling Shared Library objects the -fPIC flag has been added.
5270
 
5271
 
5272
Minor changes:
5273
  * JATS wrapper script
5274
    Added a sanity test to ensure that the JATS machine specific BIN directories
5275
    have been setup. When JATS is installed the PostInstall script must be run
5276
    to setup links to system programs.
5277
 
5278
------------------------------------------------------------------------
5279
Version: JATS_2.57.1                                Released: 15-Sep-06
5280
------------------------------------------------------------------------
5281
Major changes:
5282
 
5283
Minor changes:
5284
  * AT3232 toolset
5285
    Added a --Type=PayLoadType field to the Prog directive for this target
5286
    when creating .sxml files
5287
 
5288
  * Test Tool
5289
    Added: jats_lib_scan.pl
5290
    Use jats jats_lib_scan -man for detailed help
5291
 
5292
 
5293
------------------------------------------------------------------------
5294
Version: JATS_2.57.0                                Released: 12-Sep-06
5295
------------------------------------------------------------------------
5296
Major changes:
5297
  * SOLARIS toolset: CompileOptions
5298
    Added CompileOptions
5299
        misalign            - Only allowed on sparc platforms
5300
        no_misalign         - Default
5301
 
5302
        multithread         - Default
5303
        no_multithread      - Disable multithread compilation and linking
5304
 
5305
  * SOLARIS toolset: CompileOptions
5306
    Implemented the common CompileOptions
5307
 
5308
        prod_no_optimise
5309
        prod_no_debuginfo
5310
        prod_optimise
5311
        prod_debuginfo
5312
 
5313
        debug_no_optimise
5314
        debug_no_debuginfo
5315
        debug_optimise
5316
        debug_debuginfo
5317
 
5318
  * SOLARIS target: New Aliases
5319
    Provided new ALIAS based in the underlying architecture
5320
    Theses are:
5321
        SOLARIS_SPARC
5322
        SOLARIS_AMD
5323
    These may be used to limit operations to only flavor of SOLARIS. eg: The
5324
    utility 'rtc_patch_area' is only usable on sparc machines.
5325
 
5326
Minor changes:
5327
  * AT3232 toolset
5328
    Create .sxml files in conjunction with .s19 files
5329
 
5330
  * Jats build
5331
    Altered the programs help mechanism to use perl POD.
5332
    Extended the builtin help text.
5333
 
5334
------------------------------------------------------------------------
5335
Version: JATS_2.56.3                                Released: 04-Sep-06
5336
------------------------------------------------------------------------
5337
Major changes:
5338
 
5339
Minor changes:
5340
  * Utility InstallPkg as used by BuildPkgArchive()
5341
    Better dection of directories that have been processed to reduce warning
5342
    messages
5343
 
5344
  * PackageFile and PackageProg directives
5345
    The --Machine and --Tool options have been modified to allow the JATS tools
5346
    to be created in a directory that is related to GBE_MACHTYPE on which the
5347
    tool is created, rather then the target platform type.
5348
 
5349
------------------------------------------------------------------------
5350
Version: JATS_2.56.2                                Released: 28-Aug-06 
5351
------------------------------------------------------------------------
5352
Major changes:
5353
 
5354
Minor changes:
5355
  * WIN32 and WINCE toolsets
5356
    SharedLib operation. Added an option to allow the creation of a 'stub'
5357
    library without creating the body of the library:
5358
        eg: SharedLib ( 'WIN', 'MyStub' , '--Def=windef.def','--MutualDll','--Stubonly' );
5359
 
5360
 
5361
  * MOS toolsets
5362
    SharedLib operation. Added an option to allow the creation of a 'stub'
5363
    library without creating the body of the library:
5364
        eg: SharedLib ( 'MOS', 'MyStub' , '--Rel=lib.rel' , '--Implib=lib_stub','--Stubonly' );
5365
 
5366
  * JATS BIN directories
5367
    Added the program 'gmake' as a soft link.
5368
    gmake is required by some COTS packages that are being built from source
5369
    using autoconf.
5370
 
5371
  * Generate directive
5372
    The shared library search path is extended to allow the tools to locate
5373
    all shared libraies (.dll/.so) in packages and the local area.
5374
 
5375
    Simplifies the use of Xerces during the build process.
5376
 
5377
 
5378
------------------------------------------------------------------------
5379
Version: JATS_2.56.1                                Released: 23-Aug-06
5380
------------------------------------------------------------------------
5381
Major changes:
5382
  * Support for SOLARIS10_X86 and SOLARIS10_X64
5383
    Initial release.
5384
 
5385
Minor changes:
5386
 
5387
 
5388
------------------------------------------------------------------------
5389
Version: JATS_2.56.0                                Released: 18-Aug-06
5390
------------------------------------------------------------------------
5391
Major changes:
5392
  * Support for SOLARIS10_sparc32 and SOLARIS10_sparc64
5393
    Initial release.
5394
 
5395
  * Packaging directives
5396
    Added option --OsCommon to allow files and header files to be packed into
5397
    a directory known to all platforms being built for a common OS.
5398
 
5399
    Currently this is only supported to target platforms based on
5400
        SOLARIS
5401
        WIN32
5402
 
5403
  * Removal of support for badly formed packages
5404
    As of this release libraries that exist in the <packagename>/lib directory
5405
    will not be available to JATS. These libraries are in the incorrect
5406
    directory. They MUST be in a directory that indicates the intended purpose
5407
    of the library. A .so library cannot be used on all machines ( linux,
5408
    solaris-sparc, solaris-amd ... ).
5409
 
5410
  * Build Platform target name expansion facility
5411
    The build targets of SOLARIS and LINUX are seen as expandable names. They
5412
    will be expanded to suitable targets - depending on the host machine .
5413
 
5414
 
5415
Minor changes:
5416
  * Utility: JATS LABEL
5417
    Ensure that the 'cleartool' utility can be found in the users path.
5418
    Generate a suitable error message if it cannot be found.
5419
 
5420
  * Utility: JATS RELEASE
5421
    Added a -root=dirname to allow the user to place the created view at a given
5422
    location
5423
 
5424
    Added GBE_VIEWBASE to provide a globally configured mechanism for
5425
    controlling the view location. Performs the same job as -root=xxxx
5426
 
5427
  * Utility genrc
5428
    Added the company name to the copyright string
5429
 
5430
  * Utility: jats_save_build
5431
    Added option: -new
5432
    This option forces the saved file only a new branch.
5433
    The option can be used to save a build.pl file onto a new project-specific
5434
    branch. Useful when branching an entire release.
5435
 
5436
  * Utility: jats_rewrite
5437
    Added options to allow project suffixes to be replaced.
5438
    Use: Convert a .syd project to a .bej project.
5439
 
5440
 * Deprecated features: package.pl and tree.dir
5441
   These two build features are being deprecated. They are not suitable for
5442
   migration to other SOLARIS based platforms.
5443
 
5444
   The Package directives provide sufficient power to replace the package.pl
5445
   features - in a uniform manner.
5446
 
5447
 
5448
Internal Changes:
5449
  * Major rework of the JATS BuildPlatform, BuildAlias an BuildProducts
5450
    directives, together with the mechanism used to describe the platform builds.
5451
 
5452
    Introduced a CFG/<PLATFORM>.CFG file to provide:
5453
        1) Platform information available at build time
5454
        2) Dynamic platform names
5455
 
5456
  * Major rework of the 'SOLARIS' platform
5457
    The SOLARIS platform will generate one or more targets, depending on the
5458
    machine on which the platform is invoked.
5459
 
5460
    Consolidated a number of SOLARIS specific kludges and converted them into
5461
    configurable items. These kludges are really on applicable to the
5462
    SOLARIS8_SPARC32 platform. New SOLARIS builds will be well formed.
5463
 
5464
  * BuildPkgArchive operation
5465
    Formalized a number of kludges in operation of the SOLARIS8 under sparc32
5466
    platform. These are configured early in the build process and are no longer
5467
    needed.
5468
 
5469
    A side effect of this work is that files from external packages may be
5470
    located in 'SOLARIS', 'SOLARIS_sparc' or 'sparc' directories. The change
5471
    should be transparent as the consumer tools should be able to handle
5472
    files from all of these.
5473
 
5474
------------------------------------------------------------------------
5475
Version: JATS_2.55.1                                Released: 17-Aug-06
5476
------------------------------------------------------------------------
5477
Major changes:
5478
 
5479
Minor changes:
5480
  * WinCE toolset
5481
    Added support for the adv_som_4455_wlan
5482
 
5483
------------------------------------------------------------------------
5484
Version: JATS_2.55.0                                Released: 3-Aug-06
5485
------------------------------------------------------------------------
5486
Major changes:
5487
  * Jats wrapper: Specify version of JATS to be used
5488
    Added a -version=xxxx option to force JATS to use a specific version of
5489
    JATS. The same operation can be achieved by setting GBE_JATS_VERSION.
5490
 
5491
    The required version MUST be found in one of the known archives.
5492
 
5493
    JATS will attempt to cache the version of JATS to assist in speeding up
5494
    the operations.
5495
 
5496
    The version option MUST be the first option.
5497
 
5498
    The version option MUST be followed by a '--' option.
5499
    This prevents JATS parsing other options and recursion issues.
5500
 
5501
    Example:    jats -version=2.54.3.cr -- build
5502
 
5503
  * Migrated the "jats install" functionality out of the jats wrapper script
5504
    and into the create_dpkg utility. This is transparent to the user.
5505
 
5506
  * Utility: create_dpkg
5507
    Added a '-quiet' option to allow use within scripts
5508
    Extended the built-in help
5509
    Added useful error messages
5510
    Migrate code to a common error reporting mechanism
5511
 
5512
  * WinCE toolset
5513
    Added support for the WCEPA962 target.
5514
 
5515
  * M16 toolset as used in building MCRFirmware
5516
    Added a --MotOnly option to the Prog directives. MOT files 
5517
    are used in the creation of bootstraps.
5518
 
5519
Minor changes:
5520
  * JATS wrapper script
5521
    Added a -ABT=xxx option to allow the Auto Build Tool to be invoked from
5522
    the command line.
5523
 
5524
  * Utility: jats_rewrite
5525
    Modified so that it will display changes. These will then be present in the
5526
    ABT log so that a developer can see which packages have been rippled.    
5527
 
5528
Internal Changes:
5529
  * Common Error Reporting
5530
    Will use environment variables to control DEBUG and VERBOSE levels
5531
    for individual users. A module reporting with a name of XXXX will use EnvVars
5532
    of GBE_XXXX_VERBOSE and GBE_XXXX_DEBUG to control the debug and VERBOSE
5533
    level.
5534
 
5535
    Force flushing after a "Question" is asked to ensure that the prompt is
5536
    displayed.
5537
 
5538
    Enable autoflush for both STDOUT and STDERR.
5539
 
5540
  * Added JatsSystem module
5541
    Common code for accessing system commands        
5542
------------------------------------------------------------------------
5543
Version: JATS_2.54.3                                Released: 17-Jul-06
5544
------------------------------------------------------------------------
5545
Major changes:
5546
 
5547
Minor changes:
5548
  * BR Compiler toolset
5549
    Add the include file search path to the link command line. Allows
5550
    .def files to include other files.
5551
 
5552
  * IAR toolset
5553
    Added AT7272 support
5554
 
5555
  * Tool: jats_manifest
5556
    Added links to a suitable md5sum program on target platforms
5557
 
5558
------------------------------------------------------------------------
5559
Version: JATS_2.54.2                                Released: 12-Jul-06
5560
------------------------------------------------------------------------
5561
Major changes:
5562
 
5563
Minor changes:
5564
  * BR Compiler toolset
5565
    Corrected a problem in flagging that the non-version-1 compiler was in
5566
    use.
5567
 
5568
 
5569
------------------------------------------------------------------------
5570
Version: JATS_2.54.1                                Released: 29-Jun-06
5571
------------------------------------------------------------------------
5572
Major changes:
5573
 
5574
Minor changes:
5575
  * Mictotec toolset
5576
    Assembler files. Define DEBUG in debug builds and NDEBUG in production
5577
    builds.
5578
 
5579
  * JATS Core
5580
    Added GBE_ABT. This is used by the Auto Build Tool to indicate that an
5581
    auto build is in progress. It may be used by various tools to modify their
5582
    behaviour.
5583
 
5584
------------------------------------------------------------------------
5585
Version: JATS_2.54.0                                Released: 22-Jun-06
5586
------------------------------------------------------------------------
5587
Major changes:
5588
  * Removal of non-core deployment functionality from JATS.
5589
    Deployment package will be affected.
5590
 
5591
    The build.pl file of deployment package will need to import deployment
5592
    support with a BuildPkgArchive directive. ie:
5593
 
5594
        BuildPkgArchive ( 'deployfiles', '1.0.0.cr' );
5595
 
5596
    This version of deployfiles contains the same functionality as that provided
5597
    by the previous version of JATS. Version 2 of this package will be the start
5598
    of a deployment system that will provide support for building InstallShield
5599
    packages.
5600
 
5601
 * Deployment support utilities must be run under JATS
5602
   The environment required for the deployment support utilities is complex
5603
   and is provided by the JATS wrapper script.
5604
 
5605
   This is a change in usage. Instead of running the program 'updatenodespec'
5606
   the user will need to run 'jats updatenodespec'
5607
 
5608
Minor changes:
5609
  * SubDir directive
5610
    Added a sanity test to detect the case when a 'SubDir' directive specifies
5611
    a directory from two different makefiles.
5612
 
5613
  * Tools: Dependancy generator mkdepend
5614
    If an include file was referenced by a symbolic name, then the generated
5615
    dependancy information would be wrong for all but the first occurrence
5616
    of the file usage.
5617
 
5618
  * New utility: jats_manifest
5619
    Used by the build system to generate and validate source files.
5620
    Beta Release: Windows only at the moment
5621
 
5622
  * Unit tests under SOLARIS_sparc
5623
    The LD_LIBRARY_PATH has been modified to correctly pick up libraries
5624
    generated within the build and have been installed locally.
5625
 
5626
  * Default behaviour of JATS the wrapper script
5627
    This has been changed. Previous unknown commands were passed to make.
5628
    In this release unknown comamnds will be treated a 'etool' commands and 
5629
    will execute a JATS extended command.
5630
 
5631
 
5632
Internal Changes:
5633
  * Code refactor
5634
    Created JatsEnv to encapsulate functionality that was multiply defined.
5635
 
5636
  * Deployment utilities
5637
    The Perl module Ignorelist.pm and the .ccignore file
5638
    Changed the mechanism by which this module locates a .ccignore file.
5639
    The .ccignore file has been moved to the same directory as the module and
5640
    the module can locate the file.
5641
 
5642
    Previously the module required an environment variable in order to locate
5643
    the file, which was in a fixed location anyway.
5644
 
5645
  * JATS core
5646
    Removed the use of the environment variable PERLINC.
5647
 
5648
    Better parsing of descpkg files.
5649
 
5650
  * JATS core debugging: JatsError.pm
5651
    Allow control over the debug and verbose messages of specific programs
5652
    through the use of environment variables.
5653
 
5654
    A program reporting errors as "name" can be controlled via environment
5655
    variables GBE_name_VERBOSE and GBE_name_DEBUG.
5656
 
5657
  * BuildPkgArchive operation
5658
    Modified the subdirectories transferred with this directive to include:
5659
        deployfiles     - as used by the deployment system
5660
        tools/scripts   - as used by perl based extensions
5661
 
5662
  * Make environment
5663
    Extended the PERL5LIB path seen by perl programs executed under make to
5664
    include 'tools/script' directories that contain Perl Modules.
5665
 
5666
 
5667
------------------------------------------------------------------------
5668
Version: JATS_2.53.2                                Released: 13-Jun-06
5669
------------------------------------------------------------------------
5670
Major changes:
5671
  * Deployment. GetMassInstId.rul (From George Christidis)
5672
    Added support for SILENT_MODE
5673
 
5674
 
5675
------------------------------------------------------------------------
5676
Version: JATS_2.53.1                                Released: Not release
5677
------------------------------------------------------------------------
5678
 
5679
Not Released.
5680
This label waas used as a place keeper. This version was not used as a basis
5681
for JATS_2.53.2. Its much closer to JATS_2.54.0.
5682
 
5683
 
5684
------------------------------------------------------------------------
5685
Version: JATS_2.53.0                                Released: 11-Apr-06
5686
------------------------------------------------------------------------
5687
Major changes:
5688
  * Deployment Scripts: Release Manager Database Access
5689
    The mechanism for communicating with the Release Manager Database has been
5690
    radically replaced.
5691
 
5692
    A test tool has been added to prove connectivity to Release Manager.
5693
    Usage:
5694
        jats etool test_rmconnection
5695
 
5696
    The pervious scripts used DBI::ODBC to communicate with the Oracle
5697
    Database that contains Release Manager. There were a number of problems with
5698
    this solution:
5699
         - Required the installation of two Perl Modules
5700
         - Required the installation of an Oracle client
5701
         - Required the use of an ODBC bridge machine when used on Solaris
5702
         - Support for Perl within Oracle appears to be on the decline
5703
 
5704
    The solutions uses a Java application and Java's jdbc. The oracle:thin
5705
    client is used as this does not require any installation or configuration in
5706
    order to work.
5707
 
5708
    JATS overrides Perl's DBI package with a package of the same name, but
5709
    reduced functionality.
5710
 
5711
 
5712
Minor changes:
5713
  * makefile.pl directive: SetValue
5714
    Added a '--' option to disable and enable parsing of options.
5715
    This allows a value with leading '--' to be set.
5716
 
5717
  * makefile.pl directive: SetList
5718
    Added this directive to formalise the creation and processing of lists
5719
    within the makefiles.
5720
        Options:
5721
            --NoWarn                    Disable name clash warnings
5722
            --Project=xxxx[,xxxx]+      Add to list in selected projects
5723
            --Unique                    Add only if not already present
5724
            --Clear                     Clear list, before adding new items
5725
            --Append                    Append items to list (default)
5726
            --                          Disable/Enable option parsing
5727
        Useage:
5728
 
5729
    SetList ('*', 'LibList', 'lib1', 'lib2', '--Project=syd');
5730
    SharedLib ('*', 'MyDLL', @OBJS, @LibList );
5731
 
5732
  * Makefile.pl directive: RunTest
5733
    Corrected the option of the --CopyIn=file option where the specified file
5734
    is not in the current directory.
5735
 
5736
  * Jats Command: ant'
5737
    This command has been extended to make use of the -buildfile=xxxx option
5738
    to allow multiple buildfiles to be differentiated.
5739
 
5740
    eg: jats -buildfile=MyPackage ant
5741
 
5742
  * TOOLSET: DAFBR Compiler support
5743
    Modified the toolset to support an optimisation feature of the next
5744
    generation of the daf_br_compiler. These will be enabled if the major version
5745
    of the package containing the compiler is greater the "1". ie: 2.0.0.cr
5746
 
5747
  * Interface helper files: set_XXXX.bat/.sh
5748
    Added provision to process user command arguments.
5749
    Thus
5750
 
5751
        set_WIN32.bat prog
5752
 
5753
    will set the WIN32 environment and run the command: prog
5754
 
5755
 
5756
------------------------------------------------------------------------
5757
Version: JATS_2.52.2                                Released: 30-Mar-06
5758
------------------------------------------------------------------------
5759
Major changes:
5760
 
5761
Minor changes:
5762
  * Addressed issue with BUILDNAME, an internal variable.
5763
    Due to the use of these 'raw' values in user build.pl's they need to be
5764
    maintained. Previously the values may or may not have had a project
5765
    extension. It was bad. Now:
5766
        $(BUILDNAME) contains two or three space seperated fields - always
5767
 
5768
  * m16c Toolset - MCRFirmware
5769
    Force the generation of .thx and payload files when the .bin files are
5770
    created. Previously this only occured in the packaging phase.
5771
 
5772
Internal changes:
5773
  * JATS toolsets
5774
    Added a feature to allow a toolset to flag additional files that get created
5775
    as a part of a "Prog". This allows a "Prog" definition to generate a
5776
    number of files, some which may be packaged.
5777
 
5778
    Previously such files where only generated during the packaging phase. Now
5779
    they will be generated during the make_prog phase - with the other programs.
5780
 
5781
------------------------------------------------------------------------
5782
Version: JATS_2.52.1                                Released: 29-Mar-06
5783
------------------------------------------------------------------------
5784
Major changes:
5785
  * Jats command: etool
5786
    Extended to allow execution of deployment tools. This allows the deployment
5787
    tools to use the JATS core perl modules.
5788
 
5789
  * Address issues with the use of BUILDVER and ScmBuildVer
5790
    Due to the use of these 'raw' values in user makefile.pl's they need to be
5791
    maintained. Previously the values may or may not have had a projectt
5792
    extension. It was bad. Now:
5793
        $(BUILDVERSION) contains the project extension - always
5794
        $ScmBuildVersion does not contain a project extension - always
5795
 
5796
Minor changes:
5797
 
5798
 
5799
------------------------------------------------------------------------
5800
Version: JATS_2.52.0                                Released: 27-Mar-06
5801
------------------------------------------------------------------------
5802
Major changes:
5803
  * JATS environment variables
5804
    Added GBE_DPKG_STORE
5805
        Optionally addresses a dpkg_archive store. This is intended to allow
5806
        read only access to a remote repository. The GBE_DPKG_STORE will be
5807
        searched after GBE_DPKG. It will be searched last. JATS, be default,
5808
        will not publish packages in this repository.
5809
 
5810
        Uses: Seed repository for a complete build
5811
              Remote repository
5812
 
5813
    Added GBE_DPLY
5814
        Optionally addresses a Deployment Archive. This is only used in the
5815
        placement of deployment packages. This value may be project specific.
5816
 
5817
  * MOS_MRI toolset
5818
    Changes the mechanism used to link against the compiler RTL.
5819
    Previously the RTL was included multiple times in the link order. This
5820
    created problem with daf_dsi as the function 'time()' was being satisfied by
5821
    the RTL before being satisfied by the user libraries.
5822
 
5823
    The compiler RTL is now treated as a library of last resort. It will be
5824
    processed once and it will be processed last.
5825
 
5826
 
5827
Minor changes:
5828
  * JATS utility: build
5829
  * JATS utility: cache_dpkg
5830
    Extended the package search algorithm to locate a package within
5831
    GBE_DPKG_STORE. This archive will be searched last.
5832
 
5833
  * JATS utility: gen_cots
5834
    Ensure label is not locked
5835
    Add option to allow user to specify source directory other than a package
5836
    that already exists in dpkg_archive.
5837
 
5838
  * JATS directive: PackageFile
5839
    Now supports --Prod and --Debug options to limit the packaging process
5840
    to a specific type of build.
5841
 
5842
  * JATS directive: GenerateFiles and RunTests
5843
    Added a --PackageInfo() replacement tag to allow package version information
5844
    to be extracted and passed to generator programs.
5845
        ie: --PackageInfo(sysbasetypes,syd,--fullversion)
5846
 
5847
    Extended the --PackageBase() replacement tag to work with packages such as
5848
    sysbasetypes, where there is a .cr and a .syd type.
5849
        ie: --PackageBase(sysbasetypes,syd)
5850
 
5851
  * JATS utility: release
5852
    Under windows, ensure that the directory C:\Clearcase exists. There have
5853
    been installations of Clearcase where this is directory does not exist.
5854
 
5855
  * JATS utility: label
5856
    Added option: "-comment=Text" to allow a comment to be added to a label,
5857
    when it is being created.
5858
 
5859
Internal Changes
5860
  * JATS utility: create_dpkg
5861
    Refactored code to use JATS DescPkg class.
5862
 
5863
    Added options to allow packaging to the various archives. This is of no use
5864
    to the normal developer, but will be used within the complete build system.
5865
 
5866
  * Factored out the parsing of the BuildName directive
5867
    This process was being done in 3 locations - and there were getting
5868
    different results.
5869
 
5870
  * ToolsetRequire directive
5871
    This has been extended to allow JATS to locate Toolset extensions within
5872
    packages. They should be placed within the tool/scripts directory
5873
 
5874
------------------------------------------------------------------------
5875
Version: JATS_2.51.0                                Released: 15-Mar-06
5876
------------------------------------------------------------------------
5877
Major changes:
5878
 
5879
  * MCR toolset
5880
    Generate CD payload files in conjunction with the .BIN files
5881
 
5882
------------------------------------------------------------------------
5883
Version: JATS_2.50.0                                Released: 15-Feb-06
5884
------------------------------------------------------------------------
5885
Major changes:
5886
  * WIN32 utilities
5887
    Replaced a number of the Windows utilities ( cp, rm, mv ...)
5888
    with versions from the GNUWin32 project.
5889
 
5890
    The 'cp' previously used could not recursively copy large directories
5891
    under Windows Server 2003, when both the source and destination are on the
5892
    same drive. ( dpkg_cache of ace ).
5893
 
5894
Minor changes:
5895
  * BuildVersion
5896
    The definition of VERSION_BUILD within the generated version-defs.h file
5897
    will have leading zeros removed, thus allowing it to be used within a 'C'
5898
    program without the number being interpreted as an octal constant.
5899
 
5900
    The string form (VERSION_BUILD_STR) will retain the zeros.
5901
 
5902
  * Unix Builds
5903
    Corrected several issues encountered when specifying the name of a static
5904
    library or a shared library.
5905
 
5906
    JATS will prepend 'lib' to the user specified library name. Problems occurred
5907
    when the user specified a library name that started with 'lib'. Now, on Unix
5908
    systems, JATS will only prepend 'lib' if the library name does not already
5909
    start with 'lib'.
5910
 
5911
  * BuildPkgArchive
5912
    Since 2.45.0 JATS will only transfer files for the BuildPkgArchive, if
5913
    they have not already been transferred. Added a test for the source
5914
    package being updated and then forceing the copy to be repeated.
5915
 
5916
------------------------------------------------------------------------
5917
Version: JATS_2.49.0                                Released: 10-Feb-06
5918
------------------------------------------------------------------------
5919
Major changes:
5920
  * MOS_MRI toolset
5921
    Corrected a problem with the dependencies between a .REL file and the target
5922
    THX file. If the .REL files was modified the output THX file did not get
5923
    regenerated. This was only a problem in cases where the .REL file was
5924
    being manually maintained.
5925
 
5926
 
5927
Minor changes:
5928
  * MakeAnt directive
5929
    Introduced a check to ensure that this directive is only used with a toolset
5930
    that can handle an 'ant' build file. Currently only the JAVA toolset
5931
    supports ANT builds.
5932
 
5933
  * BuildPkgArchive directive
5934
    Correct problem in the caching of BuildPkgArchive packages in the case where
5935
    there is no GBE_DPKG_LOCAL on the machine.
5936
 
5937
  * Label utility
5938
    Added a 'files=filename,filename' option to allow only specified
5939
    files to be labeled.
5940
 
5941
  * Build. Parsing descpkg files
5942
    Corrected problem in which Java Manifest files were not parsed correctly
5943
    on Solaris.
5944
 
5945
  * Generated makefiles
5946
    Fix a bug with the CompilerOptions that allowed a '0' definition to be set to
5947
    nothing.
5948
 
5949
  * MOS Toolset
5950
    Added 'CompileOptions' of CcSupervisor.
5951
    This will set a MOS internal definition suitable for building specialised
5952
    modules.
5953
 
5954
  * Utility: gen_cots
5955
    This utility will create a JATS buildable package froma dpkg_archive entry
5956
    and then check it in under clearcase.
5957
 
5958
    JATS etool gen_cots -man will provide only help.
5959
 
5960
  * Utilty cache_dpkg
5961
    Detect and repair incomplete copy operations.
5962
 
5963
------------------------------------------------------------------------
5964
Version: JATS_2.48.0                                Released: 24-Jan-06
5965
------------------------------------------------------------------------
5966
Major changes:
5967
  None
5968
 
5969
Minor changes:
5970
  * DEVI addressed
5971
    DEVI-022055 JATS builds DLLs with wrong copyright symbol in version resource
5710 dpurdie 5972
    DEVI-022054 JATS puts "VIX Group test" in Product Name of Windows resource
227 dpurdie 5973
 
5974
  * Utility: release (cbuild)
5975
    Added an option to create a view configured to work with a branching
5976
    rule. A single branch can be named with the -branch option. eg:
5977
 
5978
        jats release -extract 'label' -branch SITS_LEGACY_BRANCH
5979
 
5980
    will create a view based on the named label, but suitable for creating
5981
    a patch for Sydney Legacy work.
5982
 
5983
  * RunTest directive
5984
    The 'PATH' that the test uses is extended to allow access to programs that have
5985
    been installed with a InstallProg directive. This allows a test script to
5986
    test a program that is generated elsewhere within the package.
5987
 
5988
  * PackageFile, Option --DirTree
5989
    Support for filenames that contain a "$" or a ' ' within the
5990
    --DirTree option. Implemented to allow entire JAVA class trees to be
5991
    packaged under JATS
5992
 
5993
    Note: In general the use of a $ and space within a filename is not
5994
          supported within JATS.
5995
 
5996
  * Jats utility wrapper
5997
    Added an eprog option. The allows any program to be run within the
5998
    sanitized environment provided by JATS.
5999
 
6000
    The specified program may be in the current directory or the user's
6001
    PATH. If the program is a perl script then it will be run with the
6002
    JATS perl interpreter, otherwise it will be processed by the system.
6003
 
6004
    Eg: jats eprog myscript arg1 arg2
6005
    Eg: jats ant
6006
 
6007
  * Jats utility wrapper
6008
    Added an 'ant' command. ( "jats ant" )
6009
 
5710 dpurdie 6010
    This will run an VIX ANT build by scanning the current directory for a file
227 dpurdie 6011
    called <ProjectName>depends.xml and then looking the a file called
6012
    <ProjectName>.xml. Jats will then create 'auto.xml' based on the
6013
    <ProjectName>depends.xml file and use ant to invoke the
6014
    <ProjectName>.xml file.
6015
 
5710 dpurdie 6016
    If the VIX build files cannot be found then ant is simply run and it will
227 dpurdie 6017
    expect a build.pl file.
6018
 
6019
  * Jats utility wrapper
6020
    Force the environment variable PERL5INC to be unset.
6021
 
6022
  * Jats utility: create_dpkg
6023
    Simplify handling of ANT based projects. Look for the package within
6024
    the build/pkg subdirectory, in the JANTS style.
6025
 
6026
  * Utility: gen_winrc (DEVI-022054)
6027
    Added a "'-product=text'" option to allow the product name to be specified.
6028
 
6029
  * Build files
6030
    Handle the java generated descpkg files. These are a Manifest format with
5710 dpurdie 6031
    VIX extensions.
227 dpurdie 6032
 
6033
------------------------------------------------------------------------
6034
Version: JATS_2.47.0                                Released: 20-Dec-05
6035
------------------------------------------------------------------------
6036
Major changes:
6037
  * BuildVersion directive in build.pl
6038
    Correct a problem in the generation of version.c
6039
    The function GetModuleInfo() would return a string with a trailing
6040
    space when the 'array' mode was selected.
6041
 
6042
    This may cause module validation to fail.
6043
 
6044
Minor changes:
6045
  * None
6046
 
6047
------------------------------------------------------------------------
6048
Version: JATS_2.46.0                                Released: 08-Dec-05
6049
------------------------------------------------------------------------
6050
Major changes:
6051
  * BuildProduct and BuildPlatforms directives
6052
    Added option --Uses=NAME
6053
    ie:
6054
        BuildProduct    ( 'OBFTP,--Uses=TP5',    'MOSCF' );
6055
 
6056
    This will create a OBFTP_MOSCF platform that will 'use' TP5
6057
    headers and libraries if none are specifically provided for the
6058
    OBFTP. It is the users responsibily to ensure that the two build
6059
    environments are compatible.
6060
 
6061
 
6062
Minor changes:
6063
  * BuildName option
6064
    Modifications to allow the creation of COTS packages with buildnames
5710 dpurdie 6065
    that do not confirm to the VIX naming scheme (--RelaxedVersion).
227 dpurdie 6066
 
6067
  * jats.bat
6068
    Ensure that GBE_BIN is not defined
6069
    It will be set by the jats.pl to a fully qualified path.
6070
 
6071
------------------------------------------------------------------------
6072
Version: JATS_2.45.0                                Released: 29-Nov-05
6073
------------------------------------------------------------------------
6074
Major changes:
6075
  * BuildPkgArchive directive
6076
    The operation of the BuildPkgArchive directive has been modified
6077
    so that a package will only be installed once. This significantly
6078
    speeds up multiple 'build' operations.
6079
 
6080
    If the package is being extracted from the 'local archive', then
6081
    this mechanism is suppressed as packages in the local archive are
6082
    considered as under development and are subject to change.
6083
 
6084
    If package cache is being refreshed, then the package will be
6085
    installed a second time. Thus it is possible to force the package to
6086
    be transferred into the 'interface' directory.
6087
 
6088
    A BuildTags directory is used to track packages that have been
6089
    transferred.
6090
 
6091
  * Internal changes to factor common code into a group of packages.
6092
    See notes below.
6093
 
6094
  * WIN32 toolset
6095
    Allow the Microsoft preprocessor directive #import to operate
6096
    correctly.
6097
 
6098
    Export the complete library search path into the build environment
6099
    for all Microsoft command, not just the linker and library commands.
6100
 
6101
  * BuildVersion
6102
    Modifications to allow the generation of version files for C#
6103
    The mechanism has been extended to allow version information for
6104
    other langauges as needed.
6105
 
6106
 
6107
Minor changes:
6108
  * Utility: gen_winrc.pl
6109
    Will extracted build number from the patch number, if present.
6110
    This information will be available to be placed into the generation
6111
    version strings.
6112
 
6113
  * GenerateFiles directive
6114
    Fixed a problem detecting programs that were not in the local
6115
    package or an imported package.
6116
 
6117
  * Toolsets: MOS_MRI
6118
    Generate an error if required tools are not found.
6119
    Previously this condition would generate a warning.
6120
 
6121
  * BuildPkgArchive and LinkPkgArchive directives
6122
    Ensure that packages are only included once. The previous check
6123
    was half-hearted and could allow multiple packages of the same
6124
    version to be included. This could result in badly formed
6125
    makefiles and strange error messages.
6126
 
6127
Internal Changes
6128
  * Started to factor out internal packages and place them into a common
6129
    directory. This will allow common error handling thoughout the suite
6130
    of utilities.
6131
 
6132
    Modified all utilities to utilize the common error reporting
6133
    functions.
6134
 
6135
------------------------------------------------------------------------
6136
Version: JATS_2.44.0                                Released: 18-Nov-05
6137
------------------------------------------------------------------------
6138
Major changes:
6139
  * Generated makefiles
6140
    Modified the windows shell to remove the use of the EXTENDED_LINE
6141
    cache. This did not work. Modified the extend.lst file to ensure
6142
    that sed did not process its arguments.
6143
 
6144
    This has been done to address a problem seen within test scripts
6145
    within unit tests that use wildcard expansion. The windows shell was
6146
    incorrectly processing:
6147
        sed '-es~.*WIN32~~'
6148
    The '.*' construct was being seen as a wildcard and the shell was
6149
    then putting the argument into a command file - it was totally
6150
    confused.
6151
 
6152
    NOTE: Attempted to remove use of EXTENDED_LINE, but this caused a
6153
    breakage with the DOS based gcc compiler( ie:H8S and others).
6154
    The construct
6155
        -D__SOURCE__=\"name\"
6156
    was corrupted somewhere. If the command is put in a command file,
6157
    then it works.
6158
 
6159
  * MakeAnt directive
6160
    Added option: --GeneratedFile=PathOfFile
6161
 
6162
    This option has the following effects
6163
        1) Marks the file a source file. It is then known to JATS and
6164
           can be used installed and manipulated.
6165
 
6166
        2) Schedules the processing of the ANT build to be done
6167
           early - in the generated files phase.
6168
 
6169
    Intended use. The creation of packages with a JNI. The Java
6170
    component needs to generate a header file early.
6171
 
6172
 
6173
Minor changes:
6174
  * JATS post-installation script
6175
    Flag deployment tools and libraries as executable.
6176
 
6177
  * Detection of extension type is case insensitive for non-unix
6178
    systems. Thus *.h and *.H files will considered header files in
6179
    windows.
6180
 
6181
  * Build.pl rewrite tool
6182
    Handle all variants of BuildName
6183
 
6184
  * Jats wrapper script
6185
    Generate an error if the JATS configuration variables are not usable
6186
        1) Contain spaces
6187
        2) Start with a // - Remote drives must be mapped
6188
 
6189
  * Toolset
6190
    Added a 'LINUX' platform.
6191
 
6192
  * JAVA toolset
6193
    Ensure the that build file passed via MakeAnt contains the following
6194
    directive:
6195
 
6196
        includeAntRuntime="off"'
6197
 
6198
    This MUST be used to ensure that ANT's classpath is not passed to
6199
    the java compiler thus ensuring that the compiler does not use ANT's
6200
    version of any JAR files that have not been specified by the user.
6201
 
6202
  * GCC Toolset
6203
    Use -Map name to create map files as needed for GCC under Debian
6204
 
6205
  * Makefile generation
6206
    When packages are used by name to resolve package location JATS
6207
    has been modified to use the package name specified by the user.
6208
    Previously JATS would use the package name found within the
6209
    descpkg file. In cases where the descpkg file was badly formed the
6210
    package could not be used.
6211
 
6212
  * Unit Tests
6213
    The following environment variables are set:
6214
 
6215
        GBE_TYPE    - The type of build. Debug or production. This
6216
                      will be set to either a 'P' or 'D'
6217
 
6218
        GBE_HOST    - The host machine we are running on.
6219
                      This will be set to 'WIN' or Unix'
6220
 
6221
    These variable should assist in the production of test scripts.
6222
 
6223
  * New makefile.pl directive: SetValue
6224
 
6225
 
6226
------------------------------------------------------------------------
6227
Version: JATS_2.43.0                                Released: 01-Nov-05
6228
------------------------------------------------------------------------
6229
Major changes:
6230
  * New Platform : "MCR" using the Mitsubishi m16c compiler.
6231
 
6232
    Special features of this toolset.
6233
    1) A .THX source file will be converted to an obtect file
6234
       This allows processing of fonts within a THX file to be
6235
       incorporated within the target image.
6236
 
6237
    2) Prog directive extensions:
6238
       --Set=Name=Value
6239
                The 'Name' is set to 'Value' at link time.
6240
                This allows the location of program segments to be set
6241
 
6242
       --Ref=name
6243
                The name of a Release file. If provided, it will be used
6244
                to provide information that will be placed within the
6245
                THX header. The version number will be ignored. It
6246
                will be taken from the build version number.
6247
 
6248
Minor changes:
6249
  * MOS Toolset
6250
    Create the VisionClick files when the THX file is created.
6251
    Previously the files were created when the THX was installed or
6252
    packaged.
6253
 
6254
  * Src directive
6255
    No generates a warning if no source files are located within the
6256
    directive. This is normally the result of a missing platform
6257
    specifier.
6258
 
6259
  * WIN32 runtime support
6260
    Added the following 'Unix' style utilities to assist in testing.
6261
        1) od       - dump files in octal and other formats
6262
        2) cmp      - compare two files byte by byte
6263
 
6264
Internal:
6265
    Added an extension to allow the target toolset to handle the "Prog"
6266
    dependancy generation if required. This allow complex program
6267
    generation mechanisms to be handled by the toolset.
6268
 
6269
------------------------------------------------------------------------
6270
Version: JATS_2.42.0                                Released: 19-Oct-05
6271
------------------------------------------------------------------------
6272
Major changes:
6273
    * BuildAlias directive
6274
      Added options.
6275
        --Define        - Does not create implicit platforms
6276
        --Target        - Redeclares the alais as the list of all
6277
                          platforms that are based on a given target or
6278
                          targets.
6279
      Eg:
6280
        BuildAlias      ( 'LMOS,--Target', 'LMOS_WIN32', 'LMOS_linux_armv4' );
6281
        BuildProduct    ( 'GAK',    'LMOS', 'MOS68K', 'MOSCF' );
6282
        BuildProduct    ( 'PCP',    'LMOS', 'MOS68K' );
6283
 
6284
      Will export an alias of LMOS that can be used within makefile.pl's
6285
      that will be the list of all platforms that have a target of
6286
      'LMOS_WIN32' or 'LMOS_linux_armv4'.
6287
 
6288
      Note the dual use of LMOS within the example. This is intentional.
6289
      The LMOS alias is used within the BuildProduct to simplify the
6290
      specification of all the LMOS targets.
6291
 
6292
 
6293
Minor changes:
6294
  * Label utility
6295
    Will generate a warning message if it labels more than one
6296
    build.pl file
6297
 
6298
  * Package directives. PackageFile.
6299
    Corrected a problem with wildcard expansion in which a --FilterIn
6300
    needed to be specified in order for the --FilterOut to operate.
6301
    Now all files in the tree are considered 'in' unless modified by the
6302
    --FilterIn option.
6303
 
6304
  * jats release (cbuilder) utility
6305
    Correct use of the -prodOnly and -debugOnly flags.
6306
    The full name was not accepted; -debug and -prod was.
6307
 
6308
  * Location of descpkg file
6309
    All makefile.pl's now know where the package descpkg file was
6310
    created. This simplifies the process og packaging this file as it
6311
    can be done within any makefile.pl.
6312
 
6313
------------------------------------------------------------------------
6314
Version: JATS_2.41.0                                Released: 27-Sep-05
6315
------------------------------------------------------------------------
6316
Major changes:
6317
  * RunTest directive
6318
    Extended the options and operation of RunTest
6319
    Additional options
6320
      --CopyIn=file
6321
        This will copy the specified file into the BIN directory before
6322
        the test is run. The file will be marked as executable. This
6323
        allows scripts and configuration files to be transferred into
6324
        the test area.
6325
 
6326
    Additional operations
6327
    The arguments passed to the script/program allow a number of
6328
    transformations, similar to GenerateFiles. Transforms
6329
      --File(xxxx[,flags])          - xxxx is a known file
6330
      --Local(xxxx[,flags])         - xxxx is a file that has been Installed
6331
      --PackageBase(xxxx[,flags])   - xxxx is a Package
6332
    Allows flags:
6333
      --dir         - directory part of the pathname
6334
      --file        - file part of the pathname
6335
      --abspath     - as an absolute path
6336
      --absdrive    - as an absolute path with drive letter (Windows)
6337
 
6338
    Files and directories are prerequisites of the test. Their
6339
    existence is tested.
6340
 
6341
  * Packaging Directives
6342
    Added a --Derived option to support the packaging of derived targets
6343
    such as LMOS.
6344
 
6345
        PackageHdr ('*', 'file1.h', '--Derived=LMOS');
6346
 
6347
    Will place file1.h into .../include/LMOS_WIN32
6348
 
6349
        PackageHdr ('*', 'file1.h', '--Derived=LMOS,sys');
6350
 
6351
    Will place file1.h into .../include/LMOS_WIN32/sys
6352
 
6353
  * JAVA 1.4 and 1.5
6354
    Added support to the JATS JAVA platform to allow the user to specify
6355
    the version of Java to be used to build a package.
6356
 
6357
        BuildPlatforms  ( 'JAVA,--Version=1.5' );
6358
 
6359
    The default will use the default machine version of JAVA.
6360
    This may not be sutable for all packages.
6361
 
6362
    Non-default versions of JAVA require that an environment variable be
6363
    set to the root of the JDK directory. These are:
6364
 
6365
      JAVA_HOME_1_4
6366
      JAVA_HOME_1_5
6367
 
6368
Minor changes:
6369
  * Script directive
6370
    Scripts may be copied into the BIN directory for use by a test.
6371
    These scripts are now always marked as executable.
6372
 
6373
  * JATS environment
6374
    Ensure that all programs run under JATS in Windows have an uppercase
6375
    COMSPEC envvar. Windows appears to define a mixed case one. Fixed in
6376
    the JATS wrapper script.
6377
 
6378
  * Label utility
6379
    Added -[no]checkout to control the labeling of checked out files.
6380
    There are three modes of operation:
6381
        1) -nocheckout      Checked out files are not labeled
6382
        2) -checkout        Only checked out files are labeled
6383
        3) Neither          All files are labeled.
6384
 
6385
 
6386
------------------------------------------------------------------------
6387
Version: JATS_2.40.0                                Released: 15-Sep-05
6388
------------------------------------------------------------------------
6389
Major changes:
6390
 
6391
Minor changes:
6392
  * label utility
6393
    Added -smartlabel option to unlock and lock the label - if it was locked.
6394
    This options retains the locked state of a label.
6395
 
6396
  * AVR_IAR toolset
6397
    Extended the 'Prog' directive to allow a Program Loader to be
6398
    added to a program as it is created. The option is:
6399
      --ProgLoader=name
6400
 
6401
  * Package directives. PackageFile
6402
    Added support for packaging of directory trees.
6403
    Options to do this are:
6404
        --TreeDir=name
6405
        --FilterOut=regexp
6406
        --FilterIn=regexp
6407
        --StripDir
6408
 
6409
    Only a single directory can be specified.
6410
    Multiple filters are allowed.
6411
    The directories must be within the current directory. It is not
6412
    possible to search outside the subdirectory tree below the makefile.
6413
 
6414
    The filters allow elements within the directory to be selected.
6415
    The filters are regular expressions. Examples:
6416
 
6417
      '--FilterIn=\.h$'         - Select all files ending with .h
6418
      '--FilterOut=MyHeader.h'  - Except this one
6419
 
6420
    The --StripDir option will remove the TreeDir directory from the
6421
    files. This allows the top level directory to be stripped off.
6422
 
6423
 
6424
------------------------------------------------------------------------
6425
Version: JATS_2.39.0                                Released: 14-Sep-05
6426
------------------------------------------------------------------------
6427
Major changes:
6428
    * Make commands
6429
      Consolidated the parsing of the OPTIONS arguments.
6430
 
6431
      The filter and nofilter options are globally applied to all tools
6432
      sets. ie: jats make debug OPTIONS=nofilter
6433
 
6434
    * Label utility
6435
      Generate a warning when attempting to label a symbolic link.
6436
      Links are very hard to maintain in a reproducible manner.
6437
 
6438
Minor changes:
6439
    * Toolsets
6440
      Replaced the use of c:\WINDOWS and c:\Program Files with suitable
6441
      variables and overrides.
6442
 
6443
      The make_init target is always run.
6444
      This facility had been lost. The target was being used to provide
6445
      compiler sanity testing, but had was not being reliably run.
6446
 
6447
    * Deployment
6448
      Suppress testing of compiler existence when used in conjunction
6449
      with deployment operations.
6450
 
6451
    * Release utility
6452
      Add options to build only the debug or the production versions.
6453
      The default is to build both. Note: User option may be further
6454
      restricted by options within the build.
6455
 
6456
    * PackageLib, InstallLib and MergeLib directives in makefile.pl
6457
      The use of @LIBS and @MLIBS in unix systems was causing a
6458
      problem as these variables already had a 'lib' prepended to the
6459
      list of libraries. These directives would add another 'lib' to the
6460
      list of libraries under unix causing a mismatch.
6461
 
6462
      Corrected by stripping liblib from the names within these
6463
      directives.
6464
 
6465
    * MakeProject directive
6466
      If the project build fails the log file was not being displayed
6467
      because 'make' stops when a command fails.
6468
 
6469
      The MakeProject operations have been modified to ensure that the
6470
      log file is always displayed. The exit code of the build command
6471
      is preserved.
6472
 
6473
    * Auto build utility jats-rewrite.pl
6474
      Modified to support the rewrite of Java 'using' and 'project'
6475
      statements.
6476
 
6477
    * Mugfile generation
6478
      Added a --ThxDir=xxxx option to allow the THX and load files to
6479
      be placed in the target package.
6480
 
6481
 
6482
------------------------------------------------------------------------
6483
Version: JATS_2.38.0                                Released: 01-Sep-05
6484
------------------------------------------------------------------------
6485
Major changes:
6486
    * BuildVersion directive
6487
      The 'defs' mode has been extended to create a file with a build
6488
      number as well as a patch number.
6489
 
6490
      The patch number is decoded into a patch number and a build
6491
      number.
6492
 
6493
Minor changes:
6494
    * AddFlags directives
6495
      Added a --NoWarn option that will suppress the warning of
6496
      duplicate flags being added.
6497
 
6498
    * GBE_CORE environment variable (Windows)
6499
      Ensure that GBE_CORE has a driver letter. This allows use of JATS
6500
      loaded into the same dynamic view as the user code.
6501
 
6502
    * Mug File Generation
6503
      Added support to allow load files to include other load files.
6504
 
6505
   * 'cbuild' or 'release' command
6506
     Added a -latestroot=xxxx option. This is a work around for the
6507
     problem where the root level directory in the VOB has not been
6508
     labeled. After using this switch add the label to the root
6509
     directory.
6510
 
6511
     The need to use this this switch indicates that the view is NOT
6512
     reproducible.
6513
 
6514
------------------------------------------------------------------------
6515
Version: JATS_2.37.0                                Released: 22-Aug-05
6516
------------------------------------------------------------------------
6517
Major changes:
6518
    * jats.bat and jats.sh
6519
      Changes to include GBE_DPKG and GBE_DPKG_CACHE.
6520
      Most importantly GBE_DPKG must be a single directory. It is no
6521
      longer a list of directories.
6522
 
6523
      Removal of the setup of Microsoft Visual Studio 6. This is now
6524
      done within the toolset.
6525
 
6526
      *** Update your jats.bat to follow the format in this release
6527
 
6528
    * JATS environment variables
6529
      Redefined variable
6530
        GBE_DPKG        - Now the MASTER dpkg_archive
6531
                          Previously was a list that included the
6532
                          dpkg_archive cache.
6533
 
6534
      New variable
6535
        GBE_DPKG_CACHE  - Optional directory for a local cache of
6536
                          the main dpkg_archive.
6537
 
6538
 
6539
Minor changes:
6540
    * Utility: gen_packagelist
6541
      Enhanced (thanks Ross) to allow PATH information for various
6542
      target platforms to be extracted.
6543
 
6544
      Better support for Product families. This is only an issue
6545
      for WIN32 derived families due to the generation of a list of
6546
      libraries. The list now observes Product hierarchy.
6547
 
6548
    * Utility: release (cbuilder)
6549
      Added -noruntests option too suppress the running of unit tests
6550
      Units tests will still be run by default.
6551
 
6552
      Tighten the config specification used to build the sandbox. It has
6553
      no LATEST rules. All directories and files MUST be labeled.
6554
 
6555
    * Utility: jats_rewrite
6556
      Support ANT based XML files
6557
 
6558
    * Utility: create_dpkg
6559
      Support ANT flavor Manifest dependancy files and pkg directory
6560
      structure.
6561
 
6562
    * makefile.pl's
6563
      GenerateFiles directive. Added a --Prog specifier to allow tools
6564
      to be generated within the same script. Example:
6565
 
6566
            Prog('*', 'Myprog', @OBJS );
6567
            GenerateFiles ('*', "--Prog=MyProg",
6568
                                '--Prereq(infile)',
6569
                                '--GeneratedCommon(outfile)' );
6570
 
6571
      RunTest directive. Added a --Auto option to flags tests that can
6572
      be run within the Build Systems Auto Build environment. These
6573
      tests will be run with the 'run_unit_tests' target. All tests will
6574
      be run with the 'run_tests' targets. Only tests that confirm to
5710 dpurdie 6575
      the VIX "Unit Test Automation" guidelines should be marked as
227 dpurdie 6576
      -- Auto.
6577
 
6578
    * Added a new make target: run_unit_tests
6579
      This will be used by the build tool to run non-interactive
6580
      unit tests within an automated framework.
6581
 
6582
    * Make run_test and run_unit_test operation
6583
      The search path for DLL's or Shared Libraries is extended to
6584
      include all Shared Libraries in the build package list as well
6585
      as the local and interface directory. This allows tests to
6586
      locate required Shared Libraries at runtime.
6587
 
6588
    * WIN32 targets built using Visual Studio 6
6589
      The path to the compiler is setup within JATS. It is no longer
6590
      imported from the users environment as the environment is
6591
      indeterminate when multiple versions of Visual Studio are
6592
      installed on the machine.
6593
 
6594
    * WINCE Targets
6595
      The name of the SDK is case sensitive.
6596
      The POCKET PC 2003 was incorrect
6597
 
6598
 
6599
 
6600
------------------------------------------------------------------------
6601
Version: JATS_2.36.0                                Released: 03-Aug-05
6602
------------------------------------------------------------------------
6603
Major changes:
6604
    * WIN32 platforms
6605
      When building Microsoft project files the PATH environment
6606
      variable is extended to include the DLL path of imported packages
6607
      and installed packages.
6608
 
6609
    * Building DLL or EXE with the --NoPDB option will disable the
6610
      generation of debug information so that the  linker does not
6611
      create CV style debug information in the target.
6612
 
6613
    * UNIX Platforms (SOLARIS and LINUX)
6614
      Modification to allow BuildProduct and BuildPkgArchive to
6615
      interwork. Previously BuildPkgArchive packages were placed into
6616
      the 'interface/lib/SOLARIS' subdirectory and this was not being
6617
      searched when looking for libraries.
6618
 
6619
Minor changes:
6620
    * GenerateFiles directive
6621
      New sub-options to filename generation commands
6622
        --abspath       - provide the named file with an absolute path
6623
        --absdrive      - provide the named file with an absolute path
6624
                          and drive letter
6625
 
6626
    * Src directive
6627
      Modified the --FromPackage' option to allow searching of the root
6628
      directory of a package.
6629
 
6630
            Src('*', 'etc/data.ini', '--FromPackage' );
6631
 
6632
      Also prevent warnings on duplicate files if the package is
6633
      imported with a BuildPkgArchive directive. The file was being
6634
      found in the package and the interface directory.
6635
 
6636
    * jats_rewrite utility
6637
      Process depend.xml files for auto builder
6638
 
6639
 
6640
------------------------------------------------------------------------
6641
Version: JATS_2.35.0                                Released: 28-Jul-05
6642
------------------------------------------------------------------------
6643
Major changes:
6644
    * SunWorks production builds
6645
      Corrected the flag used to select the level of compiler
6646
      optimisation. The current flag generates an error of:
6647
            cc: Warning: option -2 passed to ld
6648
      The flag has been changed from -O2 to -xO2 inline with the
6649
      compiler documentation.
6650
 
6651
    * MOS Toolset
6652
      Implement a workaround for a bug in VisionClick's convert program
6653
      in which the tool would not generate a valid .bdx file.
6654
 
6655
      The solution was to create the .bdx and .ab file in two steps.
6656
 
6657
Minor changes:
6658
    * Correct the case of 4 toolset files. The files were created under
6659
      windows, which has a habit of capitalizing filenames.
6660
      This should not affect current users.
6661
 
6662
    * Mugfile generation
6663
      Extended the --Package option to allow subdirectories to be
6664
      specified.
6665
        "--Package=MyPackage,--Subdir=thx/moscf,thx"  
6666
 
6667
------------------------------------------------------------------------
6668
Version: JATS_2.34.0                                Released: 22-Jul-05 
6669
------------------------------------------------------------------------
6670
Major changes:
6671
    MOS Toolset
6672
    Modified the optimizations options used to generate 'Production'
6673
    code. A problem with -Ob optimization has been identified.
6674
 
6675
Minor changes:
6676
    * Jats wrapper script
6677
      Windows: Ensure that cmd.exe is in the users PATH. Without cmd.exe
6678
      scripts will not work properly as the PERL 'system' command assumes
6679
      that cmd.exe is in the users PATH.
6680
 
6681
    * LinkPkgArchive and BuildPkgArchive
6682
      Processing soft links. Generate a warnings if a package soft
6683
      link and a real package are found in the same directory. The link
6684
      may be suspect.
6685
 
6686
    * GenerateFiles directive
6687
      Added a --PackageBase(xxx) argument that will be replaced with
6688
      the pathname to the specified package.  
6689
 
6690
------------------------------------------------------------------------
6691
Version: JATS_2.33.0                                Released: 18-Jul-05
6692
------------------------------------------------------------------------
6693
Major changes:
6694
    * Added a JAVA platform to better support the processing of ANT
6695
      build.xml files.
6696
 
6697
Minor changes:
6698
    * WIN32 toolset.
6699
      Delete V7 specific temp files when compiling with V7 compiler
6700
 
6701
    * MakeAnt
6702
      Pass an absolute path to the 'interface' directory to allow the
6703
      build.xml file to be a directory other than the current directory
6704
 
6705
      Allow the ANT_HOME path to contain spaces: c:\Program Files\Ant
6706
 
6707
    * gen_winrc - A utility to generate Windows RC files with version
6708
      information. Allow 3 or 4 fields in the version number. If only
6709
      3 fields are provided, then the fourth field is set to 0.
6710
 
6711
    * MakeAnt directive
6712
      Now supports --Debug and --Prod options to limit the building of
6713
      ANT files. The MakeAnt directive is only going to work in
6714
      conjunction with the JAVA target
6715
 
6716
      Recommended usage:
6717
      MakeAnt('JAVA',"build.xml","--Jar=java.build/test.jar",'--Prod');
6718
 
6719
Internal Changes
6720
      The MakeAnt directive is now treated like a MakeProject directive.
6721
 
6722
 
6723
------------------------------------------------------------------------
6724
Version: JATS_2.32.0                                Released: 13-Jul-05
6725
------------------------------------------------------------------------
6726
Major changes:
6727
    * Initial release of WINCE and WIN32 V7 based project builds
6728
      The DSW, VCW and SLN files can be built via JATS and selected
6729
      files packaged into the release.
6730
 
6731
      Refer to the 'MakeProject' directive in
6732
            MASS-00166 JATS Reference Manual
6733
            http://auperaws396/mass/Wiki.jsp?
6734
                                page=UsingJATSToBuildMicrosoftProjects
6735
 
6736
    * Added support for Visual Studio 2003.
6737
      The recommended platform is:
6738
        BuildProduct    ( 'VS2003', 'WIN32,--Version=MS.NET2003' );
6739
 
6740
    * Initial release of support for building Ant files.
6741
      JATS can build small Java sub-components using Ant. This is not
6742
      a replacement for JANTS it is intended for mixed C++ and Java
6743
      components.
6744
 
6745
      Refer to the 'MakeAnt' directive in
6746
            MASS-00166 JATS Reference Manual
6747
            http://auperaws396/mass/Wiki.jsp?
6748
                                page=UsingJATSToBuildSmallJavaComponents
6749
 
6750
Minor changes:
6751
    * Support for Windows DLLs
6752
      When building a WIN32 target the file interface/set_WIN32.bat is
6753
      created. This file extends the Windows PATH to allow DLLs used
6754
      by the package to be accessed.
6755
 
6756
      The file may be "called" from a wrapper batch file to start the
6757
      application or visual studio.
6758
 
6759
    * The descpkg file created by JATS contains a JATS version number
6760
      and the JATS Core path.
6761
 
6762
    * AddIncDir, AddSrcDir and AddLibDir directives
6763
      Now generate an error if there is only one argument to the
6764
      directive or if no directories where specified.
6765
 
6766
    * MOS Toolset
6767
      Add support for the TPT device
6768
      Correct error message for unsupported devices.
6769
 
6770
    * Correct problem with in creating absolute path names to allow
6771
      DOS driver letters to be handled correctly.
6772
 
6773
    * Added --ExcludeLib(xxx,yyy) processing to allow specified
6774
      libraries to be excluded from a list of libraries processed by
6775
      when creating libraries, shared libraries and programs.
6776
 
6777
      Used in conjunction with --Using(aaaa) to correct errors.
6778
 
6779
Internal Changes
6780
    * JATS release process validates the JATS version number contained
6781
      in jats.pl
6782
 
6783
------------------------------------------------------------------------
6784
Version: JATS_2.31.0                                Released: 28-Jun-05
6785
------------------------------------------------------------------------
6786
Major changes:
6787
    * JATS wrapper script
6788
      Allow multiple alternative build files: auto.pl and build_test.pl
6789
 
6790
    * Initial support for the building of WINCE based projects
6791
 
6792
    * Formal release of the toosl to generate Mug Files
6793
 
6794
Minor changes:
6795
    * Deployment support
6796
      Allow a --PatchNum to be specified in the BuildName
6797
      This is then used to invoke a deploypatch.pl file
6798
 
6799
    * 'build'
6800
      Added --ForceBuildPkg switch to the 'jats build' command to
6801
      force LinkPkgArchive directives to be interpreted as
6802
      BuildPkgArchive. This option is useful for the creation of
6803
      sandboxes for use within IDEs as the package files are placed
6804
      in a known directory structure within the sandbox.
6805
 
6806
    * WINCE and WIN32 Toolset
6807
      Options for Program and Shared Library construction
6808
            --Entry=xxxx            - Alternate entry point
6809
            --NoAddLibs             - Do not add default libraries to
6810
                                      the link phase.
6811
 
6812
    * BuildPkgArchive
6813
      Handle symlink directories at the top level of the package tree
6814
      Previously these were ignored.
6815
      Minor code cleanup
6816
 
6817
    * "cbuild" or "release" utility
6818
      Add a "-path=xxxx" option to provide sanity testing of the Release
6819
      Manager "Source Path" field.
6820
 
6821
    * SOLARIS targets
6822
      Modified the TARGET name generated with building a Product Family
6823
      based on SOLARIS. It is treated in the same manner as a Platform
6824
      of SOLARIS and creates a targets of SOLARIS_sparc
6825
 
6826
    * MugFile generation
6827
      Allows a 'load.cmd' file to be used to list the THX files to be
6828
      included in the final package.
6829
 
6830
    * Corrected a problem with the processing of platform selection
6831
      arguments used within all directives within a makefile.pl.
6832
      Multiple platforms should be specified as:
6833
            Src( 'PLAT1,PLAT2,PLAT3', .... );
6834
      with only a comma between the platforms: No whitespace
6835
      If whitespace did exist then the makefile.pl would not do what
6836
      was expected - and it would not warn the user. The simplest
6837
      solution was to allow whitespace either side of the comma.        
6838
 
6839
    * GenerateFiles directive within makefile.pl
6840
      Allow 3 different bracket styles for the arguments to allow for
6841
      embedded  brackets. Now allow
6842
            --Option=(some_text)
6843
            --Option=[some_text]
6844
            --Option={some_text}
6845
 
6846
Internal Changes
6847
    * Derive the names of the package and install directories from a
6848
      single data structure rather then being hardcoded throughout the
6849
      code.
6850
 
6851
------------------------------------------------------------------------
6852
Version: JATS_2.30.0                                Released: 01-Jun-05
6853
------------------------------------------------------------------------
6854
Major changes:
6855
    * JATS wrapper script
6856
      Changed the command line parsing. Now use GetOpts.
6857
 
6858
      Modified "all" command It no longer performs an "install"
6859
      The "install" process is not needed. the build places a shortcut
6860
      to the package into the local_dpkg_archive. This can be used by
6861
      other components.
6862
 
6863
      Removed "bmake" command. The "all" command is the now that same.
6864
 
6865
    * JATS
6866
      Created a class to write JATS configuration files.
6867
      Changes to the code to use this new class.
6868
 
6869
    * Build operations
6870
      Perform one level of package version checking. Generate warnings
6871
      if required packages are built against different versions of
6872
      packages.
6873
 
6874
    * Make operations
6875
      Added a new target - "deploy". This interfaces to the deployment
6876
      scripts. This is still a work interfaces progress.
6877
 
6878
Minor changes:
6879
    * Added environment variables to assist in the running of the
6880
      deployment builds.
6881
        PERL5LIB        - Extended based on GBE_CORE
6882
        DEPLOYLIB_DIR   - Calculate based on GBE_CORE
6883
 
6884
      Extended the "jats vars" display
6885
 
6886
    * build.pl
6887
        Corrected BuildAlias() operation. Defined options are correctly
6888
        processed. Allows
6889
            BuildAlias('WIN', 'WIN32,--OnlyProduction');
6890
        to define a platform called WIN32 that only builds for
6891
        production.
6892
 
6893
    * MOS toolset
6894
      Added a '--Acon' options to SharedLib to allow the creation of
6895
      Acon modules. These required special linking.
6896
 
6897
    * create_dpkg utility
6898
      Adds a files to the published package to indicate which type of
6899
      machine the package was published from. This will be used in a
6900
      multi-machine build environment to assist in determining the
6901
      progress of the build.
6902
 
6903
    * New utility - jats_save_build.pl
6904
      This is specific to the auto build system. It will be used to
6905
      capture the modified build files back into the version control
6906
      system.
6907
 
6908
------------------------------------------------------------------------
6909
Version: JATS_2.29.0                                Released: 25-May-05
6910
------------------------------------------------------------------------
6911
Major changes:
6912
    * WIN32 and WINCE toolsets
6913
      Modified the way that PDB files are created.
6914
      The files are now created using absolute pathnames when compiling
6915
      The name of the PDB files embedded in created DLLs is now correct.
6916
      The PDB files created when compiling objects for DLLs are now not
6917
      named after the DLLs - this was causing the linker toolsets crash.
6918
 
6919
    * WCEX86A500 target
6920
      Corrected problem creating DLLs.
6921
 
6922
    * MOS Toolsets
6923
      Modified the mechanism by which absolute filenames are passed to
6924
      the compiler.
6925
 
6926
    * RunTest directive
6927
      This directive will ensure that the named test is either a script
6928
      or a TestProg. If the test to be run is a TestProg then a
6929
      suitable suffix will be added to the named test.
6930
 
6931
Minor changes:
6932
    * JATS BUILD
6933
      Generate an error if the setting of GBE_BUILDFILTER or
6934
      GBE_PLATFORM prevents any targets being made at all. This should
6935
      highlight bad settings.
6936
 
6937
    * Publish the JATS toolsets extension pathnames to simplify the
6938
      access to extensions.
6939
 
6940
------------------------------------------------------------------------
6941
Version: JATS_2.28.0                                Released: 18-May-05
6942
------------------------------------------------------------------------
6943
Major changes:
6944
    * WIN32 and WINCE toolsets
6945
      Enable dependancy file generation of C++ files
6946
 
6947
    * label utility ( SOLARIS )
6948
      Fix bug with the escaping of '(' and ')' in cleartool commands
6949
      under unix.
6950
 
6951
Minor changes:
6952
    * label utility
6953
      Added options to:
6954
        o Delete a label
6955
        o Prevent recursion while labeling
6956
        o Control labeling of files missing from a static view
6957
 
6958
    * WIN32 and WINCE toolsets
6959
      Correct problem with the packaging of PDB files. Packaging of the
6960
      PDB files can be controlled with the -Extras= options to the
6961
      Package directives.
6962
 
6963
    * Added GBE_UNIX to the JATS_2 controlled environment. Set by
6964
      jats.pl to be used by utilities to determine the underlying
6965
      system.
6966
 
6967
------------------------------------------------------------------------
6968
Version: JATS_2.27.0                                Released: 10-May-05
6969
------------------------------------------------------------------------
6970
Major changes:
6971
    * MOS Toolset
6972
      The generation of multiple THX's in the one makefile.pl now works
6973
      There was a subtle "closure" problem in the toolset.
6974
 
6975
    * WIN32 Toolset
6976
      Added CompileOption of AddLibs (default) and NoAddLibs
6977
      toolset suppress the addition of thread libraries toolset the link
6978
      list.
6979
 
6980
    * Put a version number in the "interface" information toolset
6981
      allow JATS to generate an error when the "interface" changes.
6982
 
6983
      This version is manually maintained and prone to error.
6984
 
6985
    * GenerateFiles directive one Unix systems was incorrectly
6986
      invoking "sh.exe" instead of "sh"
6987
 
6988
 
6989
Minor changes:
6990
    * SOLARIS_SPARC platform (GCC toolset)
6991
      The process of creating a Shared Libraries creates a soft link
6992
      to the the "GBEBIN" directory. This directory was not listed as
6993
      a prerequisite and was not being created. This problem has been
6994
      corrected.
6995
 
6996
    * JATS will detect an "auto.pl" file and use it as an alternate
6997
      build.pl file. Previously this file was named build.use.pl.
6998
 
6999
    * Correct problem when .PDB files are installed from a merged
7000
      library created from libraries that have been 'installed'
7001
      JATS would create a circular dependancy.
7002
 
7003
------------------------------------------------------------------------
7004
Version: JATS_2.26.0                                Released: 03-May-05
7005
------------------------------------------------------------------------
7006
Major changes:
7007
    * WIN32 Toolset
7008
      Correct a problem linking in required / correct libraries for
7009
      use with multithreaded modes.
7010
 
7011
    * Complete the support for Global build options of --OnlyDebug and
7012
      --OnlyProd.
7013
 
7014
      These options can now be provided in the "Platform" directive
7015
      within the makefile.pl.
7016
 
7017
Minor changes:
7018
    * Platform directive within makefile.pl
7019
      These use of the "*" platform specifier has been modified such
7020
      that options provided within the directive will be added to all
7021
      platforms.
7022
 
7023
      eg:   Platform ('*', '--OnlyProduction' );
7024
 
7025
------------------------------------------------------------------------
7026
Version: JATS_2.25.0                                Released: 29-Apr-05
7027
------------------------------------------------------------------------
7028
Major changes:
7029
    * Correct problem in handling the SOLARIS_SPARC platform.
7030
      The SOLARIS platform is a bit of a kludge for backward
7031
      compatibility. JATS was not differentiating between SOLARIS and
7032
      SOLARIS_SPARC correctly.
7033
 
7034
    * Preliminary Support
7035
      Global build options of --OnlyDebug and --OnlyProd, which are
7036
      mutually exclusive. These may between specified in the build.pl
7037
      file as build arguments in any of the three standard mechanism.
7038
 
7039
        BuildPlatforms ( 'SOLARIS', '--OnlyDebug' );
7040
        BuildProduct   ( 'GAK', 'MOS68K,--OnlyProduction' );
7041
        BuildArgument  ( 'WIN', '--OnlyProduction' );
7042
 
7043
      These options limit processing to either Production or Debug
7044
      building. The default build will build both.
7045
 
7046
Minor changes:
7047
    * Extended the search path that JATS will use attempting to locate
7048
      a build.pl file. JATS will now look in ., build and build/jats
7049
      directories in the current directory and 3 directories up.
7050
 
7051
    * WCEX86A420 toolset
7052
      Added suitable libflags entry. Prevents the warning:
7053
        warning: undefined variable `WCE_LIBFLAGS'
7054
 
7055
 
7056
------------------------------------------------------------------------
7057
Version: JATS_2.24.0                                Released: 21-Apr-05
7058
------------------------------------------------------------------------
7059
Major changes:
7060
    * PackageLib and PackageProg directives now have a --Extra=xxx[,xxx]
7061
      option. Where xxx can be one or more of: none stub map lint debug
7062
      or all.
7063
 
7064
      This option may be used to limit the files that are packaged with
7065
      the library or program.
7066
 
7067
      Eg: PackageLib ('MOS', 'MyThx', '--Extra=none' );
7068
 
7069
      Will only package the .thx file. It will not package the stub
7070
      library or any debug files.
7071
 
7072
    * GenerateFiles
7073
      All processed arguments now support two options.
7074
 
7075
          ie: --Prerequisite(xxxx,--dir)
7076
              directory in which the prereq file is found
7077
 
7078
          ie: --Prerequisite(xxxx,--file)
7079
              The filename of the prereq file
7080
 
7081
    * LinkPkgArchive and BuildPkgArchive will cause the build to fail if
7082
      the required package is not available. A "--package" option, to
7083
      the build command, will prevent this behaviour.
7084
 
7085
 
7086
Minor changes:
7087
    * create_dpkg utility
7088
      Touch descpkg files when packages are merged. This will allow
7089
      utilities that use the timestamp of this file to determine that
7090
      the package has been altered.
7091
 
7092
------------------------------------------------------------------------
7093
Version: JATS_2.23.0                                Released: 14-Apr-05
7094
------------------------------------------------------------------------
7095
Major changes:
7096
    * New toolset: WCEX86A420
7097
      This is a WINCE target
7098
      This uses the ADVANTEC_X86_CE42 SDK
7099
 
7100
    * New toolset
7101
      mpt for the mpt500 platfomr
7102
 
7103
    * Modified toolset
7104
      THYRON - updates from An An Tran
7105
 
7106
    * Modified toolset
7107
      MRI68K. Now supports the Microtec 5.1 68k compiler
7108
 
7109
Minor changes:
7110
    * "cbuild" or "release" command now has a -merge option to allow
7111
      builds from different machines to be merged into dpkg_archive.
7112
 
7113
      The default operation is to replace the package indpkg_archive.
7114
 
7115
    * Simplify the use of GBE_BUILDFILTER
7116
      GBE_BUILDFILTER should be used to limit the creation of makefiles
7117
      to those that are supported by the underlying hardware.
7118
 
7119
      The change allows the construct
7120
        GBE_BUILDFILTER=SOLARIS --TARGET=SOLARIS
7121
      to be replaced by the simpler
7122
        GBE_BUILDFILTER=SOLARIS
7123
 
7124
      The default operation is to allow or disallow all TARGETS of the
7125
      specified name.    
7126
 
7127
 
7128
------------------------------------------------------------------------
7129
Version: JATS_2.22.0                                Released: 13-Apr-05
7130
------------------------------------------------------------------------
7131
Major changes:
7132
    * Dependancy generator
7133
      Extend the number of header files that can be included
7134
      to allow for 4096 included files.
7135
 
7136
------------------------------------------------------------------------
7137
Version: JATS_2.21.0                                Released: 12-Apr-05
7138
------------------------------------------------------------------------
7139
Major changes:
7140
    * Dependancy generator
7141
      Extend the number of header files that can be included
7142
 
7143
------------------------------------------------------------------------
7144
Version: JATS_2.20.0                                Released: 12-Apr-05
7145
------------------------------------------------------------------------
7146
Major changes:
7147
    * The "package.pl" file.
7148
      Setting $Pbase to "." is now supported and will result in the
7149
      package name being taken from the build name
7150
 
7151
      It is an error to set Pbase to a value other than "." or the
7152
      package Build Name.
7153
 
7154
Minor changes:
7155
    * create_dpkg utility
7156
      The -m ( merge) option will not replace a file if it already exists
7157
 
7158
------------------------------------------------------------------------
7159
Version: JATS_2.19.0                                Released: 08-Apr-05
7160
------------------------------------------------------------------------
7161
Major changes:
7162
 
7163
Minor changes:
7164
    * Dependancy generator
7165
      Correct two common situations
7166
        1) // Style comments. The following line was ignored
7167
        2) Allow preprocessor directives to be indents. This is not
7168
           ansi, but is often done.
7169
 
7170
    * GCC toolset
7171
      Corrected operation of the C++ compiler. The object file was not
7172
      being created in the correct place.
7173
 
7174
    * jats "label"
7175
      The -auto -clone options allow a label to be created if its not
7176
      present. Previously this would label all files in the VOB.
7177
 
7178
 
7179
------------------------------------------------------------------------
7180
Version: JATS_2.18.0                                Released: 06-Apr-05
7181
------------------------------------------------------------------------
7182
Major changes:
7183
 
7184
Minor changes:
7185
    * BuildPkgArchive. The transfer of the "pkg" subdirectory has been
7186
      modified. Directories of the form pkg/pkg.$(GBE_MACHTYPE) will
7187
      be transferred to the "pkg" directory.
7188
 
7189
      If there are no directores of the form "pkg.xxxxx" then the entire
7190
      pkg directory will be transferred.
7191
 
7192
    * Transfer to dpkg_acrhive
7193
      Corrected a problem in which a file with the same name as the
7194
      package was not being transferred.
7195
 
7196
------------------------------------------------------------------------
7197
Version: JATS_2.17.0                                Released: 06-Apr-05
7198
------------------------------------------------------------------------
7199
Major changes:
7200
    * Support for solaris_i386
7201
      The JATS toolset has been modified to provide the required
7202
      binaries for this target.
7203
 
7204
      The platform SOLARIS_I386 has been created to build on this target
7205
      with the GCC compiler.
7206
 
7207
      The JATS startup shell has been modified to allow specfic values
7208
      to be imported from the environment. Under Unix such values may
7209
      need to be specified in the /etc/profile file.
7210
 
7211
Minor changes:
7212
    * The InstallHdr, InstallLib, InstallJar and InstallProd directives
7213
      will now generate a warning if a "local" directory has not been specified
7214
      with a "BuildInterface" directive in the build.pl file.
7215
 
7216
    * cbuild ( release) utility
7217
      Fxied a problem locating VOBs under Solaris
7218
 
7219
------------------------------------------------------------------------
7220
Version: JATS_2.16.0                                Released: 04-Apr-05
7221
------------------------------------------------------------------------
7222
Major changes:
7223
    * The InstallHdr, InstallLib, InstallJar and InstallProd directives
7224
      will generate an error if a "local" directory has not been specified
7225
      with a "BuildInterface" directive in the build.pl file.
7226
 
7227
      The "local" directory should be specified to JATS so that it can
7228
      remove the directory tree with the "clobber" command.
7229
 
7230
    * jats_rewrite.pl utility
7231
      Allow BuildName and LinkPkgArchive directives to contains comments
7232
      with either " or ' characters.
7233
 
7234
    * BuildSubDir - in build.pl
7235
      It is now an error if the specified subdirectory does not exist
7236
      and  does not contain the file "makefile.pl".
7237
 
7238
    * SubDir - in makefile.pl
7239
      It is now an error if the specified subdirectory does not exist
7240
      and  does not contain the file "makefile.pl".
7241
 
7242
    * Jats wrapper
7243
      Added a "-locate" option to force JATS to locate the build.pl file
7244
      and then change to the containing directory before execution
7245
      further commands.
7246
 
7247
Minor changes:
7248
    * WinCe and Win32 toolsets
7249
      Corrected a problem in the generation of .dep files used in the
7250
      creation of Shared Libraries. There was a miss-match between the
7251
      name of the .dep file and its content.
7252
 
7253
------------------------------------------------------------------------
7254
Version: JATS_2.15.0                                Released: 22-Mar-05
7255
------------------------------------------------------------------------
7256
Major changes:
7257
    * WIN32 and WinCE Toolset. New CompileOptions
7258
        NoPDB   - Disable the generation of PDBs
7259
        PDB     - Enable the generation of PDBs (default).
7260
 
7261
      These options operation affect all components within the
7262
      makefile.pl. If the directive is used within the common makefile.pl
7263
      then they will affect all components within the build.
7264
 
7265
      Note: It is not possible to create a merged library in which some
7266
            of the component libraries have PDB's and some do not.
7267
 
7268
Minor changes:
7269
 
7270
------------------------------------------------------------------------
7271
Version: JATS_2.14.0                                Released: 18-Mar-05
7272
------------------------------------------------------------------------
7273
Major changes:
7274
    * The MergeLibrary directive, under WIN32 and WinCe, will publish the
7275
      PDB files associated with the library files being merged.
7276
 
7277
Minor changes:
7278
    * gen_winrc tool can add an icon to a program.
7279
      The utility supports -icon=filename.ico
7280
 
7281
    * The JATS wrapper script command "prod" to build and package the
7282
      production parts. This is similar to the "dev" command.
7283
 
7284
------------------------------------------------------------------------
7285
Version: JATS_2.13.0                                Released: 18-Mar-05
7286
------------------------------------------------------------------------
7287
Major changes:
7288
    * Modified the order in which the makefiles passes operate. Merged
7289
      the make_shlib and the install_shlib into one phase. The
7290
      implication of this is that Shared Libraries that are created can
7291
      "installed" so that other shared libraries can link against them.
7292
      The order in which the makefile.pl's are processed is important as
7293
      this is the order in which the libraries will be created and
7294
      installed.
7295
 
7296
      This solution does not handle mutual shared libraries: two shared
7297
      libraries that depend on each other.
7298
 
7299
      This is an issue only in Solaris and Linux systems that do not
7300
      generate separate stub libraries to link against.
7301
 
7302
Minor changes:
7303
    * WIN32 and WinCE Toolsets
7304
      Building up resources. The RC compiler can now locate resource files
7305
      in the "local" and "interface" directory.
7306
 
7307
    * The version.c, version.h and descpkg files will be created in the
7308
      first directory named with a BuildDir directive, unless a
7309
      "src" directory is encountered. This mimics the operation
7310
      of the older JATS, without the need for a "src" directory.
7311
 
7312
------------------------------------------------------------------------
7313
Version: JATS_2.12.0                                Released: 18-Mar-05
7314
------------------------------------------------------------------------
7315
Major changes:
7316
 
7317
Minor changes:
7318
    * Added a --Depend=xxx[,yyy]+ option to the Src directive
7319
      Not needed for C and C++ files, but may be used in conjunction
7320
      with assembler files to indicate that the file includes another
7321
      file.
7322
 
7323
    * Fixed problem with the local_dpkg_archive consistency test when
7324
      a soft link is used to redirect to the package.
7325
 
7326
    * Win32 and WinCE toolsets
7327
      Added a compiler option to enable Run Time Type Information.
7328
            CompileOptions ('WIN32', 'RTTI' );
7329
 
7330
      Add an option to Shared Library creation to allow the generation of
7331
      a Resource Only DLL. Option is "--ResourceOnly"
7332
 
7333
      Add an option to allow Resources to be built into Static Libraries
7334
      in the same manner at Shared Libraries.
7335
 
7336
    * WinCE toolsets
7337
      Mutual DLL support corrected. Library path is used to resolve
7338
      compiler specific libraries.
7339
 
7340
    * SOLARIS toolset
7341
      Prevent the compiler displaying its command line. This is in line
7342
      with the other tools sets. The commands can be seen with
7343
      OPTIONS=args and this may be set in the users environment.
7344
 
7345
      Modified the cleanup process to delete the links to shared
7346
      libraries. Only files, and not links to files, where being
7347
      cleaned up.
7348
 
7349
    * Microtec tools set (MOS)
7350
      Dependancy generation can display commands with OPTIONS=args
7351
 
7352
    * jats_rewriter.pl
7353
      Allow BuildName and LinkPkgArchive directives to contains arguments
7354
      with either " or ' characters.
7355
 
7356
 
7357
------------------------------------------------------------------------
7358
Version: JATS_2.11.0                                Released: 15-Mar-05
7359
------------------------------------------------------------------------
7360
Major changes:
7361
    * BuildPkgArchive operation
7362
      The entire "include" directory is copied into the interface area
7363
      The installer was trying to be too smart and only copy platform
7364
      specific files,but was missing out many needed subdirectories
7365
 
7366
      Reduce the warnings generated. These were an artifact of the process
7367
      of picking up all the strange variations of the directory structures.
7368
 
7369
    * Cleaned up the handling of object files that were generated by the
7370
      user.
7371
 
7372
    * MOS Microtec Toolset
7373
      Always present an absolute filename to the compiler
7374
      Display a shortened filename to allow the user to track progress
7375
 
7376
      This will remove error messages about the path being too long
7377
      for the   -Gf option.
7378
 
7379
Minor changes:
7380
    * SOLARIS Toolset
7381
      Remove duplicate -KPIC flags on the command line
7382
 
7383
    * Win32 and WinCE Toolset
7384
      Source files are either compiled by the C compiler as C files or
7385
      the C++ compiler as C++ files. The option to allow the compiler to
7386
      figure out what sort of file it is has been removed.
7387
 
7388
------------------------------------------------------------------------
7389
Version: JATS_2.10.0                                Released: 11-Mar-05
7390
------------------------------------------------------------------------
7391
Major changes:
7392
    * Extended BuildName to accept the form
7393
            BuildName ('package_name', 'nn.nn.nn.xxx' );
7394
 
7395
    * MOS68K and MOSCF toolset.
7396
      Extended the --board option to allow the user to define code and
7397
      data addresses for the board.
7398
 
7399
            BuildProduct( 'TP5', 'MOSCF','--board=01234H,05678H' );
7400
 
7401
      Will set the code,data address for the debugable image
7402
 
7403
    * Extended the PackageXxxxx options
7404
      1) Allow --Platform=xxx,yyy
7405
         Where xxx is a directory prefix and yyy is suffix to the
7406
         "platform" name.  Only useful within the context of the
7407
         PackageFile
7408
 
7409
      2) The operation of --Platform=xxx when used by the PackageFile
7410
         directive now treats the xxx directory as a prefix to the
7411
         platform name. Other Package directives still treat it as a
7412
         suffix. In practice this is the logical use.
7413
 
7414
    * Allow InstallLib and PackageLib to install a file that has been
7415
      discovered with a "Src" directive. This allows generated files
7416
      to be installed and packaged.
7417
 
7418
Minor changes:
7419
 
7420
    * cache_dpkg utility
7421
      If a package is found in the local_dpkg_archive then the cache
7422
      entry will be deleted and the master archive will not be accessed.
7423
 
7424
    * label utility
7425
      New option -auto to create and label
7426
 
7427
    * Build WIN32 and WinCe Mutual DLLs with all the object files
7428
      This allows the generated import library to contain C++ names
7429
 
7430
    * The BuildDirTree directive now supports an empty first argument
7431
      This allows a NULL tree.dir file, while still creating the root
7432
      directory. ie:
7433
 
7434
            BuildDirTree    ( '', 'pkg' );
7435
 
7436
    * Fixed DEVIM 00019520
7437
      The problem was that /bin/pwd could return a different path to
7438
      the Cwd:getpwd() function. Solution: Use one mechanism throughout.
7439
 
7440
 
7441
------------------------------------------------------------------------
7442
Version: JATS_2.9.0                                 Released: 28-Feb-05
7443
------------------------------------------------------------------------
7444
Major changes:
7445
    * First release for Back Office and Front Office use.
7446
 
7447
    * Added the jats tool  jats_rewrite.pl to rewrite build.pl files.
7448
      To be used by the nightly build process.
7449
 
7450
    * Work around a problem in the Microtec 68K compiler.
7451
      The compiler uses temp files. If the temp file name that the
7452
      compiler uses already exists, then the compiler will not delete
7453
      the file. Instead it appends information to the existing file.
7454
 
7455
      The workaround is to create the temp files within the build's
7456
      interface directory and to remove all temp files before each
7457
      compilation.
7458
 
7459
      This bug does not affect the Mictotec CF compiler.
7460
 
7461
Minor changes:
7462
    * The "jats clobber" command will remove version definition file, if
7463
      one is being produced.
7464
 
7465
    * Using JATS within a Visual Studio project. The "rebuild all"
7466
      option now translates to the JATS unbuild command to do a better
7467
      job of cleaning the workspace.
7468
 
7469
    * Added GetPackageRoot() directive to support the packaging of MOS
7470
 
7471
    * Generate error message for misuse of the SubDir directive
7472
 
7473
    * Modified BuildName to allow an '-' in the name.
7474
      This provides backward compatibility with existing packages.
7475
 
7476
------------------------------------------------------------------------
7477
Version: JATS_2.8.0                                 Released: 17-Feb-05
7478
------------------------------------------------------------------------
7479
Major changes:
7480
    * Added some new WINCE based targets. These require WINCE SDKs to be
7481
      installed in order for the compilers to work.
7482
 
7483
    * New PLATFORMS are WCEIT3000, WCEPA961 and WCEPCM7220
7484
 
7485
    * All invocations of xmake specify the name of the makefile
7486
      This allow GNUMakefiles and the Jats makefiles to exist in the
7487
      same directory
7488
 
7489
    * Overcome a limitation of the Microtec compiler in which the flag
7490
      _DEBUG is defined enev in production builds - contrary to the
7491
      documenattion.
7492
 
7493
Minor changes:
7494
    * Process of descpkg files allows for both Unix and DOS line endings
7495
      Under Unix JATS would report that the package names don't match
7496
 
7497
    * Corrected a problem with BuildPkgArchive in which file names with
7498
      spaces could not be soft linked. Only affects Unix systems.
7499
 
7500
    * Added a -rename to the "jats label" utility.
7501
      Ensure that the user specified label exists in the VOB
7502
 
7503
    * Correct problem with "make clean" that resulted in a verbose display
7504
      when the verbose option had not been selected
7505
 
7506
    * Correct a problem with "make unbuild". Changes in the build files
7507
      would prevent the execution of the command. This command should
7508
      be exempt from this test.
7509
 
7510
    * Correct a problem with "make clean" in the WIN32 and WINCE
7511
      platforms where the .exp files were not deleted.
7512
 
7513
    * The "JATS clobber" command now invokes "make clobber" and "build
7514
      clobber". The result is as clean a clean as it can be.
7515
 
7516
      Note: Jats "clean" does not remove a lot of files. These can be
7517
      removed with "unbuild" and "unpackage". This is what "clobber"
7518
      does.
7519
 
7520
    * The operation of "build clobber" has been cleaned up. It will
7521
      not try to invoke make if the makefiles have already been removed.
7522
 
7523
 
7524
------------------------------------------------------------------------
7525
Version: JATS_2.7.0                                 Released: 09-Feb-05
7526
------------------------------------------------------------------------
7527
Major changes:
7528
    * First release with support for the DAFBR compiler
7529
 
7530
    * Extended MergeLibrary. Added per-file options of:
7531
        --Interface         - Pull lib from Interface directory
7532
        --Local             - Pull lib from Local directory (default)
7533
        --SubDir=pathname   - Pull lib from a subdirectory
7534
                              Note: xxxx,pathname still works
7535
 
7536
    * Added "jats label" to provide a number of useful labeling
7537
      operations.
7538
 
7539
    * Added extensive help to JATS. JATS -man.
7540
 
7541
    * Added this manual ChangeLog file
7542
 
7543
Minor changes
7544
    * Added an 'ebin' command to jats to allow the JATS binary tools to
7545
      be run in a controlled environment from the command line.
7546
 
7547
    * Prune the list of library paths passed through to the various
7548
      toolsets. If a directory does not have any files in it then the
7549
      directory is not added to the library path.
7550
 
7551
      Thus if a library is located in xxxx/lib/WIN32 then JATS will
7552
      not add the xxxx/lib to the path.
7553
 
7554
    * cbuilder will now look in all VOBs for the user specified label.
7555
      The program has a list of "known" labels which it will search
7556
      first in an attempt to speed up the process.
7557
 
7558
    * The AddFlags directive will issue a warning if the flags does not
7559
      begin with a -D or a -U. The user should not be using compiler
7560
      specific flags.
7561
 
7562
    * The use of linker flags will issue a warning.
7563
 
7564
    * Process the common makefile.pl after the toolset has been
7565
      determined. This allows the toolset to extend the CompileOptions
7566
      such they are available to the common makefile.pl.
7567
 
7568
    * Added the WIN32 CompileOptions "jats_v1" to force JATS to specify
7569
      a number of compile time definitions used by earlier versions of
7570
      JATS.
7571
 
7572
    * Fixed bug in the --Debug option to the PackageProg directives that
7573
      caused both the production and debug versions to be packaged.
7574
 
7575
    * The gen_msproject utility now creates simpler names for the MS
7576
      projects that it creates. The name no longer contains the full
7577
      pathname, thus making them shorter and readable.
7578
 
7579
    * The ShowDlls utility now handles absolute and relative paths to
7580
      the initial DLL or EXE.
7581
 
7582
    * Correct problem in which the use of Generate/Rule directives may
7583
      fail since prerequisite subdirectories were not being created
7584
      since the "generate" phase was not being run.
7585
 
7586
      Added messages to prompt the user to remove Generate, Generated
7587
      and Rule directives. Use the GenerateFiles directive
7588
 
7589
    * JATS.BAT file will exclude LINUX builds by default.
7590
 
7591
    * The make NODEPEND=1 processing now does not recurse at all.
7592
      Previously each subdirectory was visited - only to do nothing.
7593
 
7594
    * Correct a problem in creating stub libraries for MOS targets if
7595
      the stub library object was not listed with the SharedLib's
7596
      objects.
7597
 
7598
    * Correct a problem with the MS Studio support. The invoked make
7599
      command is XXX_all_debug. There was a problem with this command in
7600
      that it did not do any dependancy checking and would not always
7601
      build defendants.