Subversion Repositories DevTools

Rev

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

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