Subversion Repositories DevTools

Rev

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

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