Subversion Repositories DevTools

Rev

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

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