Subversion Repositories DevTools

Rev

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

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