Subversion Repositories DevTools

Rev

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

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