Subversion Repositories DevTools

Rev

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