Subversion Repositories DevTools

Rev

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

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