Subversion Repositories DevTools

Rev

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

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