Subversion Repositories DevTools

Rev

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

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