Subversion Repositories DevTools

Rev

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

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