Subversion Repositories DevTools

Rev

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

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