Subversion Repositories DevTools

Rev

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

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