Subversion Repositories DevTools

Rev

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

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