Subversion Repositories DevTools

Rev

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

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