Subversion Repositories DevTools

Rev

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

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