Subversion Repositories DevTools

Rev

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

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