Subversion Repositories DevTools

Rev

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

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