Subversion Repositories DevTools

Rev

Rev 4002 | Details | Compare with Previous | Last modification | View Log | RSS feed

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