Subversion Repositories DevTools

Rev

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

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