Subversion Repositories DevTools

Rev

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

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