Subversion Repositories DevTools

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

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