Subversion Repositories DevTools

Rev

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

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