Subversion Repositories DevTools

Rev

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

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