Subversion Repositories DevTools

Rev

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

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