Subversion Repositories DevTools

Rev

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

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