Subversion Repositories DevTools

Rev

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

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