Subversion Repositories DevTools

Rev

Rev 4688 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

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