Subversion Repositories DevTools

Rev

Rev 3985 | Rev 4002 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

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