Subversion Repositories DevTools

Rev

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

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