Subversion Repositories DevTools

Rev

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

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