Subversion Repositories DevTools

Rev

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

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