Subversion Repositories DevTools

Rev

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

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