Subversion Repositories DevTools

Rev

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

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