Subversion Repositories DevTools

Rev

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

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