Subversion Repositories DevTools

Rev

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

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