Subversion Repositories DevTools

Rev

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

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