Subversion Repositories DevTools

Rev

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

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