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