Subversion Repositories DevTools

Rev

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

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