Subversion Repositories DevTools

Rev

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

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