Subversion Repositories DevTools

Rev

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

Rev Author Line No. Line
6073 dpurdie 1
------------------------------------------------------------------------
6442 dpurdie 2
Version:  3.17.2000.cr                              Released: 17-Apr-18 
3
------------------------------------------------------------------------
4
 
5
Minor changes:
6
    * WINCE toolchains. Shared Library generation.
7
      The use of --ResourceOnly and -Entry=xxxx are mutually exclusive
8
 
9
    * ANDROID NDK Build Sepport
10
      Added new platforms: ANDROIDARM64, ANDOROIDMIPS64 and ANDROIDX86_X64
11
      The are a part of the ANDROIDNDK alias
12
 
13
------------------------------------------------------------------------
6423 dpurdie 14
Version:  3.17.1000.cr                              Released: 10-Apr-18
15
------------------------------------------------------------------------
16
 
17
Minor changes:
18
    * VS2015_X64. Added flags to allow the NSIS packager to generate
19
      an installer tagged as X64 instead of WIN32, but default.
20
 
21
    * GenerateFiles directive.
22
      Will display the RecipeTag, if provided, as a hint in backets when 
23
      building the package.
24
 
25
    * Makefile generation
26
      Fixed issues with $(BUILDVERNUM) embedded in rules
27
 
28
Internal:
29
    * Added FileUtils::CatPaths will silently ignore 'undef' arguents
30
      This will simplify creation of optional elements.
31
 
32
------------------------------------------------------------------------
6415 dpurdie 33
Version:  3.17.0000.cr                              Released: 06-Apr-18 
34
------------------------------------------------------------------------
35
 
36
Minor changes:
37
    * GenerateFiles directive.
38
        Added option --RecipeTag=name
39
        Remove 'undef' arguments for the call parameters
40
Internal:
41
    * Added FileUtils::ValidatePath
6423 dpurdie 42
        Centralise the testing of a user-provided path to ensure that
6415 dpurdie 43
        it is within the package being built and is sane.
44
 
45
------------------------------------------------------------------------
6403 dpurdie 46
Version:  3.16.9000.cr                              Released: 04-Apr-18
47
------------------------------------------------------------------------
48
 
49
Minor changes:
50
    * Correct buildfilter calculation on build machines
51
 
52
------------------------------------------------------------------------
6387 dpurdie 53
Version:  3.16.8000.cr                              Released: 27-Mar-18
54
------------------------------------------------------------------------
55
 
56
Minor changes:
57
    * New Directives:
58
        PackageDir  - Packages an entire directory tree
59
            Can be used to package generated components - unlike 
60
            PackageFile with the --DirTree option, which will only package
61
            files present when the makefile is generated.
62
 
63
        InstallDir  - Installs an entire directory tree
64
 
65
    * Makefile directive - RunTest
66
        Added --Dir=(path) option to allow paths to tests to be massaged
67
        as required.
68
 
69
    * Build Alias for LMOS based platforms
70
      Corrected the generation of internal alias for LMOS based platforms
71
      In particular PKG_DEB.
72
 
73
Internal:
74
    * Makefile generation. 
75
        Sped up directory searching over large number of items. 
76
        UniquePush is slow for large items.
77
 
78
    * Add helper routine to assist in creation of plugins
79
        AddToSrc() - Like Src, but will only process one file if not already known
80
 
81
    * Src directive. Add --IgnoreDup option. Suppress warnings on duplicate adds
82
 
83
    * Extended 'jats_runtime' to support PackageDir
84
 
85
------------------------------------------------------------------------
6353 dpurdie 86
Version:  3.16.7000.cr                              Released: 15-Feb-18
87
------------------------------------------------------------------------
88
 
89
Minor changes:
90
    * Directive: MakeProject and the ANDROID platform
91
      Enhanced to allow the the population of the build environment
92
      to work in production or debug Only modes - as well as the normal
93
      production and debug mode.
94
 
95
    * Subversion interface
96
      Detect newer credentials error messages and provide suitable prompt
97
 
98
Internal:
6387 dpurdie 99
    * Removed some files that are now a part of the Release Note 
100
      generation package.
6353 dpurdie 101
 
102
------------------------------------------------------------------------
6294 dpurdie 103
Version:  3.16.6000.cr                              Released: 18-Jan-18
6281 dpurdie 104
------------------------------------------------------------------------
105
 
106
Minor changes:
6294 dpurdie 107
    * Fixed build target LMOS_LINUX_I386
108
      It is meaningless, but is needed for historical builds
6285 dpurdie 109
 
6294 dpurdie 110
    * Toolset: GCC
111
      Correctly tagged the 'dbg' files such that will not be packaged
112
      when packages with the option of '--Extras=none'
113
 
114
    * Makefile generation. DPACKAGE processing
115
      Generated sorted entries so that the file is the same on all machines
116
 
6285 dpurdie 117
------------------------------------------------------------------------
6294 dpurdie 118
Version:  3.16.5000.cr                              Released: 15-Jan-18
6285 dpurdie 119
------------------------------------------------------------------------
120
 
121
Minor changes:
6294 dpurdie 122
    * WINCE Platform tweaks
123
      Prog directive: Added --Stack=0x10000,0x1000
124
      SharedLib directive: Set default entry point to _DllMainCRTStartup
125
 
126
    * Platform: WCE6ARMV4I
127
      Removed from the WINCE alias
128
      Added to the WINCE6 alias
129
 
130
------------------------------------------------------------------------
131
Version:  3.16.4000.cr                              Released: 10-Jan-18
132
------------------------------------------------------------------------
133
 
134
Minor changes:
135
    * New Platform: WCE6ARMV4I
136
      A generic Windows Embedded 6.0 platform
137
      Used under VS2008
138
 
139
    * MakeAnt directive. New option: --AllPackages.
140
      This will cause JATS to pass to the ANT build definitions to all
141
      the dependent packages, not just those specified with a 
142
      LinkPkgArchive.
143
 
6281 dpurdie 144
    * Utility: create_dpkg
145
      Added compatibility for noBuild with Ant Builds
146
 
147
------------------------------------------------------------------------
6277 dpurdie 148
Version:  3.16.3000.cr                              Released: 2-Jan-2018 
149
------------------------------------------------------------------------
150
 
151
Minor changes:
152
    * Utility: jats_generate_deployable
153
        Removed
154
 
155
    * Utility: create_dpkg
156
        Will warn on symlinks with absolute path references
157
        Will warn on symlinks that escape the package
158
        Will warn on broken symlinks
159
        Will not transfer bad links
160
 
161
    * MOS68K and MOSCF Toolsets
162
        Added support to build MOS with JATS
163
        Added Compiler directive: BuildMosOs
164
        Auto detect correct glob.lib file to be used
165
 
166
------------------------------------------------------------------------
167
Version:  3.16.2000.cr                              Released: 20-Nov-17 
168
------------------------------------------------------------------------
169
 
170
Minor changes:
171
    * Reinstated TOOLS\jats_generate_deployable.pl
172
 
173
    * Subversion Repository location
174
      The correct paths to the various SubVersion repositories is:
175
        GBE_SVN_URL_AUPERASVN01: https://auawsasvn001.vix.local/svn
176
        GBE_SVN_URL_FRBESASVN01: http://frbesasvn01.frbesa.erggroup.com/svn
177
      Windows users may need to update there jats.bat file.
178
      These are Fully Qualified Domain Names.    
179
 
180
------------------------------------------------------------------------
181
Version:  3.16.1000.cr                              Released: 17-Nov-17
182
------------------------------------------------------------------------
183
 
184
Minor changes:
185
    * Makefile creating
186
      Fixed issue locating tools in packages and the failure to extend
187
      PERLs search path to locate some extensions - ie in the utf package.
188
 
189
    * BuildArgument directive
190
      Delay processing the arguments so that aliases may work as expected.
191
 
192
   * jUnit Test Prost Process
193
     Support the <skipped /> tag correctly
194
 
195
------------------------------------------------------------------------
196
Version:  3.16.0000.cr                              Released: 02-Nov-17
197
------------------------------------------------------------------------
198
 
199
Minor changes:
200
    * Fix issue with empty GBE_BUILDFILTER and user defined GBE_PLATFORM
201
 
202
    * Deprecated use of SOLARIS under Solaris8
203
      Must use SOLARIS8_SPARC32
204
 
205
    * Sandbox
206
      Detect, report and ignore nested sandboxes
207
      Added --OnlyLevel=n option to facilitate escrow builds.
208
 
209
    * Escrow Builds
210
      Added GBE_DPKG_ESCROW to greatly simplify the process of escrow
211
      building by allowing an escrow to be performed within a jats
212
      sandbox. Unfortunately the sandbox does not support the old 
213
      JANTS style packages that many older projects use.
214
 
215
    * RHEL7, UBUNTU14 and UBUNTU16 builds
216
      Use '-std=gnu++11' for building c++ files.
217
 
218
    * Makefile generation
219
      Fix issues with the '--FromPackage' option when working against the secured
220
      dpkg_archive.
221
 
222
    * Extraction from subversion
223
      Relaxed the check for a 'tags' subdirectory with a package.
224
 
225
    * Directive: InstallHdr and PackageHdr
226
      Added --Strip=nn option to strip the first 'n' elements from the path.
227
 
228
Internal:
229
    * Major rework of the build target processing
230
      Simplified the creation of platform morphs
231
      Better detection of platforms not covered in the build
232
      Extended some displays form 79 character to 100.
233
 
234
------------------------------------------------------------------------
235
Version:  3.15.1000.cr                              Released: 19-Oct-17
236
------------------------------------------------------------------------
237
 
238
Minor changes:
239
    * Utility: jats_generate_deployable
240
      Tweaks to support non-standard debian packages provided by Oracle.
241
 
242
------------------------------------------------------------------------
243
Version:  3.15.0000.cr                              Released: 02-Oct-17
244
------------------------------------------------------------------------
245
 
246
Minor changes:
247
    * Platforms GENRIC_<MACHTYPE>
248
      Corrected generation of makefiles - 2nd attempt
249
 
250
    * Utility: jats_generate_deployable
251
      Added RHEL7 support
252
 
253
------------------------------------------------------------------------
254
Version:  3.14.9000.cr                              Released: 27-Sep-17
255
------------------------------------------------------------------------
256
 
257
Minor changes:
258
    * Platforms GENRIC_<MACHTYPE>
259
      Corrected generation of makefiles.
260
 
261
------------------------------------------------------------------------
6198 dpurdie 262
Version:  3.14.8000.cr                              Released: 26-Sep-17
263
------------------------------------------------------------------------
264
 
265
Minor changes:
266
    * Makefile generation: 
267
        [JATS-425] WCEPSPC_emu not seen as a part of the WINCE alias
268
        Affects all platforms with lowercase characters in the platform 
269
        name.
270
 
271
------------------------------------------------------------------------
272
Version:  3.14.7000.cr                              Released: 15-Sep-17 
273
------------------------------------------------------------------------
274
 
275
Minor changes:
276
    * Utility: sandbox
277
      Fixed issues with the 'buildfilter' command. The data is stored in the 
278
      sandbox_dpkg_archive subdirectory.
279
 
280
      Added options to:
281
         - Display path to build file
282
         - Handle packages with multiple builders
283
 
284
    * Templates
285
      Fixed some poor examples
286
 
287
    * New platform: SK100 (Experimental)
288
      Added an alias for the SK family of platforms.
289
      Includes special handling of Linker Scripts
290
 
291
    * Utility: jats_generate_deployable
292
      Added option to generate symlinks to packages instead of transferring
293
      the body of the package. 
294
 
295
Internal changes:
296
    * Error directive support message prefix to simplify error processing.
297
 
298
------------------------------------------------------------------------
6192 dpurdie 299
Version:  3.14.6000.cr                              Released: 04-Sep-17
300
------------------------------------------------------------------------
301
 
302
Minor changes:
303
    * Utility: jats_generate_deployable
304
      Support for RPM cots packages.
305
 
306
    * Utility: sandbox
307
      Add command: scandepth - to display/set the default scan depth for build files
308
 
309
      Added options to the 'info' command:
310
        -[no]dependencies   - Display external dependencies (default)
311
        -[no]buildorder     - Display build order (default)
312
 
313
------------------------------------------------------------------------
314
Version:  3.14.5000.cr                              Released:16-Aug-17 
315
------------------------------------------------------------------------
316
 
317
Minor changes:
318
    * Utility: jats_generate_deployable
319
      Added support to allow the inclusion of the uigen-pulse package
320
      Changes to the 'alas' name generation process
321
 
322
    * Build Directives: BuildPlatforms and BuildProducts
323
        The --Uses=XXX and --Alias=XXX options support a comma and a colon 
324
        separated list. The colon seperated list will aviod parsing 
325
        confusion.
326
 
327
        The following all have the same effect:
328
            BuildPlatforms ('P1', '--Uses=P2:P3' );
329
            BuildPlatforms ('P1', '--Uses=P2,P3' );
330
            BuildPlatforms ('P1,--Uses=P2:P3' );
331
            BuildPlatforms ('P1','--Uses=P2', '--Uses=P3' );
332
 
333
       The folling will not:
334
            BuildPlatforms ('P1,--Uses=P2,P3' );
335
 
336
    * Utility: sandbox
337
      Add 'testlinks' command to test, and optionally delete, the package
338
      symlinks.
339
 
340
------------------------------------------------------------------------
6177 dpurdie 341
Version:  3.14.4000.cr                              Released: 07-Aug-17 
6142 dpurdie 342
------------------------------------------------------------------------
343
 
344
Minor changes:
6177 dpurdie 345
    * Utility: jat_svnrelease [JATS-424]
346
      Handle obscure condition where the tag has been created directly from
347
      a merge and the merge involved the deletion of files from the fileset.
348
 
349
    * Buildfiles.
350
      Restored VS2005 to the MSWIN32 alias
351
 
352
------------------------------------------------------------------------
353
Version:  3.14.3000.cr                              Released: 02-Aug-17 
354
------------------------------------------------------------------------
355
 
356
Minor changes:
357
    * Utility: jats_generate_deployable
358
      Can create .bomGen file from scratch
359
      Improved reporting of files add, removed and updated
360
 
361
    * Makefile generation
362
      Correctly export 'PACKAGE_ARCH' as a global
363
 
364
------------------------------------------------------------------------
365
Version:  3.14.2000.cr                              Released: 04-Jul-17 
366
------------------------------------------------------------------------
367
 
368
Minor changes:
369
    * Platform: RHEL7_INSTRUMENT
370
      Marked as a NATIVE build.
371
 
372
    * Platforms: LMOS_*
373
      Inherit system aliases from base platform configuration.
374
 
375
------------------------------------------------------------------------
376
Version:  3.14.1000.cr                              Released: 03-Jul-17 
377
------------------------------------------------------------------------
378
 
379
Minor changes:
380
    * Updated copyright notices in all files
381
 
382
    * jats_extract
383
      Will no longer create a 'local_dpkg_archive'
384
      The use of a 'local_dpkg_archive' is deprecated in favor of the jats 
385
      'sandbox', which does a much better job.
386
 
387
    * Utility: jats_generate_deployable
388
        Windows: Fixed compilation error
389
 
390
    * Platform: RHEL7_INSTRUMENT
391
      Added missing configuration file
392
 
393
------------------------------------------------------------------------
394
Version:  3.14.0000.cr                              Released: 23-Jun-17
395
------------------------------------------------------------------------
396
 
397
Minor changes:
398
    * JAVA Platform [JATS-420]
399
      The java builder can use an 'ant' provided by a suitable package
400
      ie: ant_1.9.2.0000.cots
401
 
402
------------------------------------------------------------------------
403
Version:  3.13.9000.cr                              Released: 22-Jun-17 
404
------------------------------------------------------------------------
405
 
406
Minor changes:
407
    * Corrected use of shell 'echo' command
408
        Always quote the string
409
        Issue was the unquoted use of a string that contained matching square brackets
410
            ie: echo [$<] Compiling..
411
        The [..] construct is a filename expanding construct.
412
 
413
     * Win32 and Win64 makefile generation
414
       Allow the 'cmdfile' commands to be shown in verbose mode.
415
 
416
     * Makefile generation
417
       Fixed issue with some build formats and a bug in cmdfile when no path item
418
       has a directory separator.
419
 
420
------------------------------------------------------------------------
421
Version:  3.13.8000.cr                              Released: 16-Jun-17  
422
------------------------------------------------------------------------
423
 
424
Minor changes:
425
    * Makefiles: New Directive: ExtendIncDir
426
        ExtendIncDir ('*', 'private' );
427
      Specialised use only. See MASS-00166
428
 
429
    * Utility: jats_svnrelease
430
      The 'extractFiles' option will display the files extracted when 
431
      running on a build machine.
432
 
433
    * Windows builds
434
      [JATS-419] Visual Studio builds fail with fatal error C1090: PDB API call failed, error code '23'
435
      Use same value for _MSPDBSRV_ENDPOINT_ in all makefiles
436
 
437
 
438
------------------------------------------------------------------------
439
Version:  3.13.7000.cr                              Released: 13-Jun-17 
440
------------------------------------------------------------------------
441
 
442
Minor changes:
443
    * Utility: jats
444
        Added option -script. Supresses internal warnings when capturing
445
        output within a scripting environment.
446
 
447
    * Utility: sandbox
448
      Allow the build.pl file to be upto 4 directories deep
449
        Slows down sandbox scanning
450
        Provides backward compatability with old projects
451
 
452
    * Makefile directive: MakePerl
453
        Added option to control the output format to better support multiple
454
        build machines.
455
 
456
    * Build File
457
      Fixed handling of aliases that broke the (not recommended) construct
6142 dpurdie 458
        BuildProduct ( 'CSHARP2010', 'WIN32,--Version=MS.NET2010' );
459
 
6177 dpurdie 460
    * Windows builds
461
      [JATS-419] Visual Studio builds fail with fatal error C1090: PDB API call failed, error code '23'
462
 
463
Experimental:
464
    * New platform: RHEL7_INSTRUMENT and RHEL7
465
        Supported on RHEL7 and Centos with a MACHTYPE of linux_el7_x64
466
 
467
    * Makefiles. New aliases
468
        PKG_DEB, PKG_RPM and PKG_WIN
469
        Internal use only at the moment
470
 
6142 dpurdie 471
------------------------------------------------------------------------
6133 dpurdie 472
Version:  3.13.6000.cr                              Released: 04-May-17
6085 dpurdie 473
------------------------------------------------------------------------
474
 
475
Minor changes:
6133 dpurdie 476
    * Makefile directive: PackageFiles
477
      Added option: --PreserveSymlinks. 
478
        Used internally for preserving symlinks when building SDKs
479
 
480
    * Utility: jats_generate_deployable
481
      Ongoing improvements.
482
 
483
Internal:
484
    Class: JatsCopy::CopyDir
485
        Added options
486
            NoRecurse
487
            NoSubDirList
488
 
489
------------------------------------------------------------------------
490
Version:  3.13.5000.cr                              Released: 13-Apr-17
491
------------------------------------------------------------------------
492
 
493
Minor changes:
494
    * Makefiles: Enhanced platform specifier
495
      Allows mixed use of included and excluded platform names.
496
        ie: Src ('DEVLINUX,!UBUNUT12', .... )
497
 
498
    * New Utilities: jats_generate_deployable, jats_generate_bom
499
      Experimental utilities for generation of BOMS
500
 
501
------------------------------------------------------------------------
502
Version:  3.13.4000.cr                              Released: 31-Mar-17 
503
------------------------------------------------------------------------
504
 
505
Minor changes:
506
    * Build Files. BuildSrcArchive
507
      Exclude .svn sub directories.
508
 
509
    * Utility: jats_sandbox
510
      Improved behaviour of packages that do not build with the current
511
      build filters. They will be silently skipped and not create 
512
      build errors.
513
 
514
    * Build Files - New alias : INSTRUMENT
515
      This is an alias for active instrumented build targets
516
 
517
    * Build Files - New directive : BuildAliasDef
518
      Shorthand for
519
        BuildAlias ('xxx,--Define', ... );
520
      This is the preferred method for defining aliases
521
 
522
    * Build Files - BuildAlias directive
523
      The build alias has been extended to support the use of a '!' operator
524
      This allows one, or more platforms to be removed from a definition.
525
      Examples: 
526
        BuildAlias( 'A1,--Define', 'DEVLINUX,!ARM9TDMI');
527
        BuildAliasDef ('A1', 'DEVLINUX,!ARM9TDMI'); 
528
            All platforms covered by the DEVLINUX alias, except ARM9TDMI
529
 
530
        BuildAlias( 'A2,--Define', '!ARM9TDMI');
531
        BuildAliasDef( 'A2', '!ARM9TDMI');
532
            All active platforms, except the ARM9TDMI.
533
 
534
    * Platforms: GENERIC_XXX
535
      Improved operation of machType based generic platforms when used within the
536
      build system.
537
 
538
Experimental:
539
    * Support for Red Hat Enterprise Linux 7
540
      Compiler is supported via the new platform RHEL7
541
      Jats support is provided via a machine type of linux_x64.
6177 dpurdie 542
      This will change 
6133 dpurdie 543
 
544
------------------------------------------------------------------------
545
Version:  3.13.3000.cr                              Released: 13-Mar-17
546
------------------------------------------------------------------------
547
 
548
Minor changes:
549
    * Build Files. BuildSrcArchive
550
      Added a 'platform' argument. It is only used on build machines to
551
      prevent the archive being build on multiple machines.
552
 
553
------------------------------------------------------------------------
554
Version:  3.13.1000.cr                              Released: 01-Mar-17 
555
------------------------------------------------------------------------
556
 
557
Minor changes:
558
    * Directive: MakePerlModule
559
      Fixed build issues associated with building Perl Modules under VS2012.
560
      Minor differences in the operation of nmake.
561
 
562
    * Build Files
563
      Handle build.pl files with out a BuildInterface directive
564
      Will force an interface directory called 'interface'
565
 
566
      Modified parsing of the BuildName to handle some instances of
567
      incorrect use of the '--RelaxedVersion' option.
568
 
569
      Note: This option is to be deprecated. Do not use it.
570
            Jats will handle '.cots' packages correctly by itself.
571
 
572
   * New Platforms: GENERIC_XXX
573
     A collection of platforms (Alias of GENERICS) that provide an architecture 
574
     specific  build target. The name of the target is created by joining the
575
     keyword GENERIC_ with the Jats Machine Type. 
576
        ie: GENERIC_WIN32, GENERIC_LINUX_I386, GENERIC_LINUX_X64
577
 
578
     These targets cannot be mixed with non-generic targets (on the same machine), nor the GENERIC
579
     build target. It is possible to mix GENERIC_WIN32 with UBUNTU16 as they appear on
580
     different architectures.
581
 
582
     The targets function is in a similar manner to the GENERIC build target, but
583
     are directed to one or more machines.
584
 
585
     Intended uses:
586
        Windows: Creating installers. 
587
                 The NSIS builder does not require a compiler toolchain.
588
 
589
       All: Specialized packaging.
590
 
591
    * Makefiles
592
      New option in the platform specifier. --Alias=alias1[:alias2]*
593
      Allows the directive to be true if the current build has the specified alias.
594
      Eg:
595
        PackageFile ('--Alias=TOOLSET',DEVLINUX', ...)
596
      Will package the file(s) if the current build is for a platform that is
597
      a part of the TOOLSET alias AND is also member of the DEVLINUX alias.
598
      It could also have been written as:
599
        PackageFile ('--Alias=TOOLSET',--Alias=DEVLINUX', ...)
600
      but NOT as:
601
        PackageFile ('--Alias=TOOLSET:DEVLINUX', ...)
602
        PackageFile ('TOOLSET,DEVLINUX', ...)
603
            as these will be true if current platform is a TOOLSET or DEVLINUX
604
 
605
    * Utility: sandbox
606
      Subcommand info 
607
        - Added option to test fingerprints
608
        - Display status in a column for easy reading
609
 
610
------------------------------------------------------------------------
611
Version:  3.13.0000.cr                              Released: 20-Feb-17
612
------------------------------------------------------------------------
613
 
614
Minor changes:
615
    * New build.pl directive BuilToolset.
616
      This directive will enable the generation of the TOOLSET alias.
617
      Provides a sanity test to ensure that tools can be built.
618
      Includes options to limit use to specific architectures
619
 
620
    * Support for building many of the platforms on a linux_x64 based machine
621
      Previously many of the compiler were limited to the Ubuntu12 machines.
622
      These can now be built on an Ubuntu16 based machine.
623
 
624
    * GenerateFiles directive
625
      Added --Var(Toolset) and --Var(Native).
626
 
627
    * Utility: sandbox
628
      Added a 'fingerprint' command to manipulate packages fingerprints.
629
 
630
      Sped up the location of build files. The results are cached and 
631
      recalulated if the user adds or removes packages from the sandbox.
632
 
633
Internal changes:
634
    * Centralizing build platform information.
635
 
636
------------------------------------------------------------------------
637
Version:  3.12.9000.cr                              Released: 10-Feb-17 
638
------------------------------------------------------------------------
639
 
640
Minor changes:
641
    * Build File. BuildExclude directive
642
      Added special platform of 'INSTRUMENT'. This will exclude 
643
      all Instrumented builds.
644
 
645
    * 64 Bit Linux Build Machines
646
      Allowed Java to be built on such machine - if it is installed.
647
 
648
    * Build Alias - TOOLSET
649
      Changed the manor in which the alias is calculated.
650
      On a build machine it will use the BUILDFILTER to determine which 
651
      machine may build the toolset.
652
 
653
      On a developers machine it will use the first suitable available 
654
      platform.
655
 
656
------------------------------------------------------------------------
657
Version:  3.12.8000.cr                              Released: 07-Feb-17
658
------------------------------------------------------------------------
659
 
660
Minor changes:
661
    * Utility: sandbox
662
      Changed method of accessing SHA1 routines to allow compatibility
663
      with older versions of Perl.
664
 
665
------------------------------------------------------------------------
666
Version:  3.12.7000.cr                              Released: 07-Feb-17
667
------------------------------------------------------------------------
668
 
669
Minor changes:
670
    * Build Processing
671
      Removed processing of CVS change log and associated command line options
672
      It is not used.
673
 
674
      Tweaks to the calculation of the TOOLSET alias to allow it to work when
675
      the build system is split across multiple machines.
676
 
677
    * Utility: escrow
678
      Added -skim option
679
 
680
    * Utility: sandbox
681
      Many improvements:
682
        Can be invoked in a subdirectory and will only build packages required
683
        by the package that contains the current subdirectory.
684
 
685
        Package build order is alphabetic, within each build level.
686
 
687
        Added '-keepgoing' option to several commands to allow processing even
688
        if an error is detected.
689
 
690
        Generate a package fingerprint and use it to determine if a package
691
        needs to be rebuilt at all.
692
 
693
        Added 'skip' and 'unskip' commands to allow a package to be marked to be
694
        skipped during the build.
695
 
696
        The 'info' subcommand indicates which packages have been built.
697
 
698
------------------------------------------------------------------------
699
Version:  3.12.6000.cr                              Released: 06-Feb-17
700
------------------------------------------------------------------------
701
 
702
Minor changes:
703
    * New build Alias - TOOLSET
704
      TOOLSET is, at most, one platform in the current build, which build 
705
      artifacts that can be expected to run on the build machine.
706
 
707
      The TOOLSET alias has been created to simplify the support
708
      for building and packaging of JATS-internal utilities.
709
 
710
------------------------------------------------------------------------
711
Version:  3.12.5000.cr                              Released: 30-Jan-17
712
------------------------------------------------------------------------
713
 
714
Minor changes:
715
    * JATS Wrapper
716
      Changes to the package location library to allow JATS to locate
717
      build files in very deep directory trees. Windows path limits
718
      were causing some issues.
719
 
720
------------------------------------------------------------------------
721
Version:  3.12.4000.cr                              Released: 25-Jan-17
722
------------------------------------------------------------------------
723
 
724
Minor changes:
725
    * VS2015, VS2015_X64 and CSHARP2015 builds
726
      Minor tweaks to the configuration and detection of the installed compiler
727
 
728
------------------------------------------------------------------------
729
Version:  3.12.3000.cr                              Released: 24-Jan-17
730
------------------------------------------------------------------------
731
 
732
Minor changes:
733
    * New JATS Platforms: VS2015, VS2015_X64 and CSHARP2015
734
 
735
Internal:
736
    * Support to extract build aliases from the build metadata.
737
 
738
------------------------------------------------------------------------
739
Version:  3.12.2000.cr                              Released: 11-Jan-17
740
------------------------------------------------------------------------
741
 
742
Minor changes:
743
    * JATS Build
744
      Removed warning about duplicate function definition
745
 
746
------------------------------------------------------------------------
747
Version:  3.12.1000.cr                              Released: 10-Jan-17
748
------------------------------------------------------------------------
749
 
750
Minor changes:
751
    * New Platforms: UBUNTU16 and UBUNTU16_INSTRUMENT
752
      Uses gcc 5.4.0
753
      For packages to be deployed under Ubuntu16 LTS
754
 
6085 dpurdie 755
    * Utility: vcsdiff
756
      Added option to allow users to extend the 'diff' command line
757
      Requires knowledge of the underliying diff utility being used
758
      on the particular platform.
759
 
760
------------------------------------------------------------------------
6079 dpurdie 761
Version:  3.12.0000.cr                              Released: 16-Nov-16
762
------------------------------------------------------------------------
763
 
764
Minor changes:
765
    * Build Alias
766
      Removed 'LINUX_I386' from the 'LINUX' alias
767
      LINUX_I386 should only be used to build JATS tools.
768
 
769
------------------------------------------------------------------------
6073 dpurdie 770
Version:  3.11.9000.cr                              Released: 11-Nov-16
771
------------------------------------------------------------------------
6065 dpurdie 772
 
6073 dpurdie 773
Minor changes:
774
    * Packaging directives
775
      Corrected escaping of ${GBE_TYPE} as well as the preferred $(GBE_TYPE)
776
      as seen in some Java-centric packages.
777
 
778
    * BuildPkgArchive directive
779
      [JATS-411] Detect when the the users build filter has been modified
780
      pick up new build artifacts.
781
 
4362 dpurdie 782
------------------------------------------------------------------------
6065 dpurdie 783
Version:  3.11.8000.cr                              Released: 08-Nov-16 
784
------------------------------------------------------------------------
785
 
786
Minor changes:
787
    * jats.bat and related example config files
788
      Added GBE_SVN_URL_AUPERASVN02 to support the new Repo Server
789
 
790
    * MergeLibrary directive
791
      Corrected escaping of $(OBJDIR).
792
 
793
------------------------------------------------------------------------
5999 dpurdie 794
Version:  3.11.7000.cr                              Released: 23-Sep-16
795
------------------------------------------------------------------------
796
 
797
Minor changes:
798
    * Makefile Package and Install directives
799
      Addressed [JATS-405] - PackageFile does not handle files with a colon 
800
                             in the name
801
      Prevent colon escaping on Windows machines as it doesn't work and
802
      interferes with sme valid file names.
803
 
804
------------------------------------------------------------------------
5995 dpurdie 805
Version:  3.11.6000.cr                              Released: 23-Sep-16
806
------------------------------------------------------------------------
807
 
808
Minor changes:
5999 dpurdie 809
    * [JATS-406] Dependency generation fails when building linux_drivers_viper
5995 dpurdie 810
      Fixed an issue in JATS' mkdepend utility. Detect attempts to divide 
811
      and mod by zero and generate an error and not a program fault.
812
 
813
------------------------------------------------------------------------
814
Version:  3.11.5000.cr                              Released: 22-Sep-16
815
------------------------------------------------------------------------
816
 
817
Minor changes:
818
    * Makefile Package and Install directives
819
      Addressed [JATS-405] - PackageFile does not handle files with a colon 
820
                             in the name
821
      Centralized handling of filename escaping.
822
 
823
      Note: The 'colon' character is not supported under Windows. This is a
824
      limitation of Windows, not JATS. The use of a colon in a file name is
825
      strongly discouraged. Such files can only be manipulated under Unix.
826
 
827
    * Make operations uninstall, unpackage and clobber
828
      Improved the deletion of files such that only files that exist will 
829
      be logged as deleted.
830
 
831
------------------------------------------------------------------------
5987 dpurdie 832
Version:  3.11.4000.cr                              Released: 21-Sep-16
833
------------------------------------------------------------------------
834
 
835
Minor changes:
836
    * RunTest directive. Windows Only
837
      [JATS-404] RunTest under Windows does not handle paths correctly
838
 
839
------------------------------------------------------------------------
5970 dpurdie 840
Version:  3.11.3000.cr                              Released: 29-Aug-16
841
------------------------------------------------------------------------
842
 
843
Minor changes:
844
    * Platform: VS2010 and VS2012
845
      [JATS-176] Generate Visual Studio Property Sheet to simplify use within JATS
846
      Add build directive 'BuildPropertyPages' - See MASS-00166
847
 
848
------------------------------------------------------------------------
5941 dpurdie 849
Version:  3.11.2000.cr                              Released: 04-Aug-16
850
------------------------------------------------------------------------
851
 
852
Minor changes:
853
    * Utility: timeout - All supported Unix platforms
854
      Addressed [JATS-396] - timeout utility can hang - Unix 
855
 
856
------------------------------------------------------------------------
5935 dpurdie 857
Version:  3.11.1000.cr                              Released: 03-Aug-16
858
------------------------------------------------------------------------
859
 
860
Minor changes:
861
    * Utility: timeout (linux)
862
      Addressed [JATS-396] - timeout utility can hang - linux
863
 
864
------------------------------------------------------------------------
5910 dpurdie 865
Version:  3.11.0000.cr                              Released: 27-Jul-16
5909 dpurdie 866
------------------------------------------------------------------------
867
 
868
Minor changes:
869
    * Configuration
870
      Changed templates and scripts to reflect the new location of the
871
      Release Manager database. Correct configuration is:
5914 dpurdie 872
        GBE_RM_LOCATION=jdbc:oracle:thin:@auawsards001.vix.local:1521:RELEASEM
5909 dpurdie 873
 
874
    * Release Manager Database interface
875
      Improved performance of tools that access the Release Manager database.
876
 
877
    * Utility: test_rmconnection
5914 dpurdie 878
      Added options to allow separate testing of the Database and the Webserver.
5909 dpurdie 879
 
880
------------------------------------------------------------------------
5885 dpurdie 881
Version:  3.10.14000.cr                              Released: 12-Jul-16
5882 dpurdie 882
------------------------------------------------------------------------
883
 
884
Minor changes:
885
    * Jats Build
886
      [JATS-266] jats install and package - does not preserve symbolic links
5885 dpurdie 887
      Shared libraries, under Unix, are created with one or two symlinks to 
5882 dpurdie 888
      the library: link and soname.
889
      When the shared library is Installed or Packaged the symlink was not 
890
      preserved resulting in a much larger package that really required.
891
 
892
      Shared library symlinks are marked and are now copied so as to 
893
      preserve the symlink.
894
 
5884 dpurdie 895
    * Jats make - Instrumented builds
896
      [JATS-350] GCOV creates files in uncontrolled locations within the build system
897
      The files generated by gcov are now contained within the package
5882 dpurdie 898
 
5884 dpurdie 899
      [JATS-395] GCOV does not work for all build topologies
900
      Improved the extraction of gcov information to allow for all 
901
      build topologies.
902
 
903
      Reduced the output when running the code coverage tools
5885 dpurdie 904
      The can be re-enabled by adding an 'options=args' to the make 
5884 dpurdie 905
      command.
906
 
907
      Simplified the processing of the coverage data.
908
 
909
 
5882 dpurdie 910
------------------------------------------------------------------------
5878 dpurdie 911
Version:  3.10.13000.cr                              Released: 08-Jul-16
5872 dpurdie 912
------------------------------------------------------------------------
913
 
914
Minor changes:
915
    * Jats Installation
916
      Improved post install script to hook into build system automated 
917
      deployment.
918
 
5878 dpurdie 919
    * Build Generation
920
      [JATS-374] Units tests can't run if soname libraries are not present
921
        Generate sonames to the shared libraries present in dependent packages
922
        Extend the library search path to include this sonames.
923
 
924
    * Makefile directive GenerateFiles
925
      Corrected error introduced in 3.10.12000.cr 
926
 
5872 dpurdie 927
------------------------------------------------------------------------
5868 dpurdie 928
Version:  3.10.12000.cr                              Released: 07-Jul-16
5859 dpurdie 929
------------------------------------------------------------------------
930
 
931
Minor changes:
932
    * Improved use of cppcheck - Static code analysis (Adrien Oliva)
933
        Enable all possible check
934
        Force analysis of all pre-processor branch
935
        Remove false positive
936
            Missing include, unused function and unmatched suppression
937
        Configure cppcheck to ignore files provided by the compiler
5867 dpurdie 938
            We do not want to analyze compiler
5859 dpurdie 939
        Fix variable name
940
 
5862 dpurdie 941
    * GCC Toolchain
942
      Improved header file dependency generation through correct calculation
943
      of the compiler header file search paths.
5859 dpurdie 944
 
5862 dpurdie 945
    * IAR Toolchain
946
      Corrected the generation of the Program Loader
5859 dpurdie 947
 
5862 dpurdie 948
    * Internal Utility: cache_dpkg
949
      Improved handling (under windows) of files with the same name but
950
      different case. Generate a clear warning message.
951
 
5868 dpurdie 952
    * Makefile directive GenerateFiles [JATS-178]
953
      Attempting to generate a file that is also marked as a source file is
5867 dpurdie 954
      now an error.
955
 
5859 dpurdie 956
------------------------------------------------------------------------
5868 dpurdie 957
Version:  3.10.11000.cr                              Released: 01-Jul-16
5848 dpurdie 958
------------------------------------------------------------------------
959
 
960
Minor changes:
5859 dpurdie 961
    * Jats internal utility 'timeout'
962
      Improved stability under Server 2013
963
      Reinstated use of 'timeout' in unit tests running under Windows.
5848 dpurdie 964
 
5859 dpurdie 965
    * Utility: jats -buildfiter=xxx
966
      Corrected the operation of the -buildfilter=xxx option when used 
967
      within a sandbox.
5848 dpurdie 968
 
969
------------------------------------------------------------------------
5868 dpurdie 970
Version:  3.10.10000.cr                              Released: 28-Jun-16 
5818 dpurdie 971
------------------------------------------------------------------------
972
 
973
Minor changes:
5859 dpurdie 974
    * Platform: CORTEXM3_ARM
975
      Corrected the generation of the Program Loader
5830 dpurdie 976
 
5859 dpurdie 977
    * UBUNUTU12C11_INSTRUMENT and UBUNUTU12_INSTRUMENT platforms
978
      lcov includes branch coverage
979
 
980
    * All _INSTRUMENT targets
981
      Limit coverage to file within the package
982
      Now excludes all external libraries
5818 dpurdie 983
 
5859 dpurdie 984
      The 'make clean' operation will remove intermediate files generated 
985
      by the coverage.
5818 dpurdie 986
 
987
    * Unit Tests
5859 dpurdie 988
      'make clean' now removes temp 'rc' file generated while running the test
5818 dpurdie 989
 
5859 dpurdie 990
    * Internal Utility: cache_dpkg
991
      [JATS-388] Package caching does not support multiple instances updating 
992
      the same version
5818 dpurdie 993
 
5859 dpurdie 994
    * Internal Utility: cache_dpkg
995
      assemble_dpkg - purge stale package fragments from the package fragment 
996
      assembly area.
5828 dpurdie 997
 
5859 dpurdie 998
    * Sandbox
999
      [JATS-389] Sandbox does not support packages that use deployment
1000
      directives.
5819 dpurdie 1001
 
5818 dpurdie 1002
------------------------------------------------------------------------
5796 dpurdie 1003
Version:  3.10.9000.cr                               Released: 14-Jun-16 
5792 dpurdie 1004
------------------------------------------------------------------------
1005
 
1006
Minor changes:
5859 dpurdie 1007
    * [JATS-372] Long pathnames kill metrics gathering
1008
      See Jira issue for full details
5792 dpurdie 1009
 
5859 dpurdie 1010
    * [JATS-373] UBUNUTU12C11 and UBUNUTU12C11_INSTRUMENT platforms
1011
      Specify the dynamic linker used to load programs generated by this compiler
5796 dpurdie 1012
 
5859 dpurdie 1013
        NOTE: Programs generated for this platform require the installation of the
1014
              vix-ubuntu12-c11-glibc installer from the 'linux-glibc' package.
5796 dpurdie 1015
 
5792 dpurdie 1016
------------------------------------------------------------------------
5783 dpurdie 1017
Version:  3.10.8000.cr                               Released: 02-Jun-16
1018
------------------------------------------------------------------------
1019
 
1020
Minor changes:
5859 dpurdie 1021
    * Platform: CORTEXM3_ARM
1022
      Added assembler flags
5783 dpurdie 1023
 
5859 dpurdie 1024
    * Utility cache_dpkg
1025
      Seperate wait-for-replication and copy-to-cache
5783 dpurdie 1026
 
5859 dpurdie 1027
    * Build Directive - BuildName
1028
      Added a 3 argument form
1029
        BuildName ('pkgName', 'Version', 'Suffix' );
1030
      Improved error reporting.
5783 dpurdie 1031
 
1032
------------------------------------------------------------------------
5761 dpurdie 1033
Version:  3.10.7000.cr                               Released: 19-May-16 
5757 dpurdie 1034
------------------------------------------------------------------------
1035
 
1036
Minor changes:
5859 dpurdie 1037
    * Platform: CORTEXM3_ARM
1038
      Changed to use Embedded Workbench 7.4
5757 dpurdie 1039
 
5859 dpurdie 1040
      Added --CrcRange=... option to the CORTEXM3_ARM Prog directive
1041
      Used to specify the range to fill and CRC.
5757 dpurdie 1042
 
1043
------------------------------------------------------------------------
5744 dpurdie 1044
Version:  3.10.6000.cr                               Released: 13-May-16
5743 dpurdie 1045
------------------------------------------------------------------------
1046
 
1047
Minor changes:
5859 dpurdie 1048
    * Utility cache_dpkg
1049
      When used by the build system, the contents of the 'lcov' directory
1050
      will not be cached.
5743 dpurdie 1051
 
5859 dpurdie 1052
      Add facility to allow build system to wait for package replication
1053
      to occur. Only active when a replica store is configured.
5744 dpurdie 1054
 
5859 dpurdie 1055
    * UBUNUTU12C11 and UBUNUTU12C11_INSTRUMENT platforms
1056
      Added 'rpath' elements to generated executables to ensure that
1057
      the all glibc components required by the runtime can be located.
5744 dpurdie 1058
 
5743 dpurdie 1059
------------------------------------------------------------------------
5736 dpurdie 1060
Version:  3.10.5000.cr                               Released: 06-May-16
1061
------------------------------------------------------------------------
1062
 
1063
Minor changes:
5859 dpurdie 1064
    * C11 Support under GCC
1065
      Use '-std=gnu++11' for building c++ files (Not -std=c++11) 
1066
      Note: Use of the compiler definition 'linux' is non-standard
1067
            __linux__ is the standard definition.
5736 dpurdie 1068
 
1069
------------------------------------------------------------------------
5732 dpurdie 1070
Version:  3.10.4000.cr                               Released: 09-May-16
5731 dpurdie 1071
------------------------------------------------------------------------
1072
 
1073
Minor changes:
5859 dpurdie 1074
    * Code coverage Support under GCC
1075
      Ensure that the correct gcov utility is used. Gcov is a part of the compiler
1076
      toolset. Affects UBUNUTU12C11_INSTRUMENT.
5731 dpurdie 1077
 
5859 dpurdie 1078
    * Platform: CORTEXM3_ARM
1079
      Continuing tweaks.
5731 dpurdie 1080
 
1081
------------------------------------------------------------------------
5726 dpurdie 1082
Version:  3.10.3000.cr                               Released: 06-May-16
1083
------------------------------------------------------------------------
1084
 
1085
Minor changes:
5859 dpurdie 1086
    * C11 Support under GCC
1087
      Added '-std=c++11' for building c++ files
5726 dpurdie 1088
 
1089
------------------------------------------------------------------------
5717 dpurdie 1090
Version:  3.10.2000.cr                               Released: 04-May-16 
5708 dpurdie 1091
------------------------------------------------------------------------
1092
 
1093
Minor changes:
5859 dpurdie 1094
    * Removed use of 'timeout' on unit tests in a Windows environment 
1095
      pending several Windows issues. Total 'make' time is still being enforced.
5708 dpurdie 1096
 
5859 dpurdie 1097
    * New platforms
1098
      COBRA2 - Similar to COBRA, but using a C11 compliant version of GCC
1099
      VIPER2 - Similar to PPC_603E, but using a C11 compliant version of GCC
1100
      UBUNUTU12C11 - Similar to UBUNTU12. Uses the same version of GCC as COBRA2 and VIPER2
1101
      UBUNUTU12C11_INSTRUMENT - Instrumented builds of UBUNUTU12C11
1102
      DEVLINUX includes all of these new platforms.
5708 dpurdie 1103
 
5859 dpurdie 1104
    * New Utility: 
1105
        checkRelease - Locate package-Version required by a Release/SBOM/Package
1106
        that are not in dpkg_archive.
5708 dpurdie 1107
 
1108
Internal:
5859 dpurdie 1109
    * Removed runtime warning from buildlib.pl
5708 dpurdie 1110
 
5859 dpurdie 1111
    * Updated VIX Copyright notices
5710 dpurdie 1112
 
5708 dpurdie 1113
------------------------------------------------------------------------
5700 dpurdie 1114
Version:  3.10.1000.cr                               Released: 19-Apr-16
5695 dpurdie 1115
------------------------------------------------------------------------
1116
 
5700 dpurdie 1117
Minor changes:
5859 dpurdie 1118
    * Jats internal utility 'timeout'
1119
      Fixed compatibility issue under Windows-7
5700 dpurdie 1120
 
1121
------------------------------------------------------------------------
1122
Version:  3.10.0000.cr                               Released: 15-Apr-16
1123
------------------------------------------------------------------------
1124
 
5695 dpurdie 1125
Major changes:
5859 dpurdie 1126
    * Jats make
1127
        All make commands are now time limited to a maximum of 3 hours.
1128
        This default can be altered with the -maxtime option.
1129
        The global default can be set with the EnvVar GBE_MAXMAKE.
5695 dpurdie 1130
 
5859 dpurdie 1131
      This feature is to prevent unit tests from hijacking the build system.
5695 dpurdie 1132
 
5859 dpurdie 1133
    * RunTest directive
1134
        Runtime of automated unit tests is limited to (default) 30 minutes
1135
        The RunTest directive has a --MaxTime parameter to alter the default
1136
        time.
5695 dpurdie 1137
 
5859 dpurdie 1138
      This feature is to prevent unit tests from hijacking the build system.
5695 dpurdie 1139
 
5859 dpurdie 1140
    * Build Platform Aliases: DEVLINUX and LMOS_DEVLINUX
1141
        Removed LINUX_EMU from DEVLINUX
1142
        Removed LMOS_LINUX_EMU from LMOS_DEVLINUX
5695 dpurdie 1143
 
5859 dpurdie 1144
        There is no target environment for LINUX_EMU to run on.
1145
        building for this target is pointless.
5695 dpurdie 1146
 
1147
------------------------------------------------------------------------
5680 dpurdie 1148
Version:  3.9.0000.cr                               Released: 11-Apr-16
5679 dpurdie 1149
------------------------------------------------------------------------
1150
 
5680 dpurdie 1151
Major changes:
5859 dpurdie 1152
    * New buildfile directive: BuildExclude
1153
      Allows spcific targets to be excluded from the build. Intended to be 
1154
      used in conjunction with Platform aliases such as DEVLINUX. ie:
1155
        BuildPlatforms('DEVLINUX');
1156
        BuildExclude('ARM9TDMI', 'LINUX_EMU');      # Targets specfically not supported
5679 dpurdie 1157
 
5680 dpurdie 1158
Minor changes:
5859 dpurdie 1159
    * New Platform: CORTEXM3_ARM
1160
      Used by the next generation of Security Module
1161
 
5679 dpurdie 1162
------------------------------------------------------------------------
5673 dpurdie 1163
Version:  3.8.7000.cr                               Released: 04-Apr-16 
5637 dpurdie 1164
------------------------------------------------------------------------
1165
 
1166
Minor changes:
5859 dpurdie 1167
    * Visual Studio 2012 support
1168
      Added support for update 5. Now allowes either update 4 or update 5.
1169
      Note: Update-4 is the documented (required) version.
5637 dpurdie 1170
 
5859 dpurdie 1171
    * Internal tool for windows : which.exe
1172
      Updated the internal utility 'which' provided under windows for shell
1173
      compatability. It was found to not work with Server 2003.
5645 dpurdie 1174
 
5859 dpurdie 1175
    * Makefile directive: MakeLinuxDriver
1176
      Added support for Module Versioning bewteen modules in the same build.
5672 dpurdie 1177
 
5637 dpurdie 1178
------------------------------------------------------------------------
5619 dpurdie 1179
Version:  3.8.6000.cr                               Released: 15-Mar-16
1180
------------------------------------------------------------------------
1181
 
1182
Minor changes:
5859 dpurdie 1183
    * SK20 Toolchain
1184
      Version 4.1.0 of the SK20 toolchain has beencompletely replaced
1185
      with a new version. 4.1.1. The SK20V1 target uses the new compiler.
5619 dpurdie 1186
 
5859 dpurdie 1187
      Version 4.1.0 was not used to generate released software. It is
1188
      no longer needed. The new compiler-version is available in the
1189
      arm-unknown-linux-gnueabi-sk20 package.
5619 dpurdie 1190
 
1191
------------------------------------------------------------------------
5582 dpurdie 1192
Version:  3.8.5000.cr                               Released: 25-Feb-16
1193
------------------------------------------------------------------------
1194
 
1195
Minor changes:
1196
    * System Utility - assemble_dpkg
5859 dpurdie 1197
      Allow for both unix and windows generated .tar.gz files
1198
      The windows files do not have './' prepended
5582 dpurdie 1199
 
1200
------------------------------------------------------------------------
5578 dpurdie 1201
Version:  3.8.4000.cr                               Released: 24-Feb-16
1202
------------------------------------------------------------------------
1203
 
1204
Minor changes:
1205
    * System Utility - assemble_dpkg
5859 dpurdie 1206
      Windows and Unix create tar-zip files via different mechanisms
1207
      Note: bsdtar has issues with large archives under Server2003
5578 dpurdie 1208
 
5859 dpurdie 1209
    * Windows utilities. Update the 7zip binaries to latest version
5578 dpurdie 1210
 
1211
------------------------------------------------------------------------
5568 dpurdie 1212
Version:  3.8.3000.cr                               Released: 18-Feb-16
1213
------------------------------------------------------------------------
1214
 
1215
Minor changes:
5859 dpurdie 1216
    * Packaging directives
1217
      Improved the cleanup of badly specified --Dir options
5568 dpurdie 1218
 
1219
    * System Utility - assemble_dpkg
5859 dpurdie 1220
      Extended to allow deletion of bad and test builds
5568 dpurdie 1221
 
1222
   * Java Build Support
1223
     Only in the build system, set JATS_HOME to the package repostory replica
5859 dpurdie 1224
     if one is available.
5568 dpurdie 1225
 
1226
------------------------------------------------------------------------
5551 dpurdie 1227
Version:  3.8.2000.cr                               Released: 12-Feb-16
5485 dpurdie 1228
------------------------------------------------------------------------
1229
 
1230
Minor changes:
5859 dpurdie 1231
    * Jats documentation generation. 
1232
      Fixed [JATS-227] Pod2Html has a bug with nested items blocks
5542 dpurdie 1233
 
5859 dpurdie 1234
    * System Utility - create_dpkg
1235
      Added support for flagging non-builds. This will be used by a
1236
      future release of the build system.
5551 dpurdie 1237
 
5542 dpurdie 1238
------------------------------------------------------------------------
1239
Version:  3.8.1000.cr                               Released: 03-Feb-16 
1240
------------------------------------------------------------------------
1241
 
1242
Minor changes:
5859 dpurdie 1243
    * New target: SK20V41
1244
      This is the SK20 Platform, With version 4.1.0.0, except that is
1245
      a part of the DEVLINUX alias.
5527 dpurdie 1246
 
5859 dpurdie 1247
    * Windows utilities. Added 'bsdtar', called 'tar'
1248
      This utility handles a subset of gnu-tar operations on windows, but 
1249
      it does support .gz and .bz2 files.
5485 dpurdie 1250
 
5859 dpurdie 1251
    * Jats essential binaries
1252
      Added symlinks within jats to ensure that gtar can be located on
1253
      machines in which a gnu-tar is not native to the machine.
5527 dpurdie 1254
 
1255
    * System Utility - assemble_dpkg
5859 dpurdie 1256
      Used by the build system to assemble a package from package fragments.
5527 dpurdie 1257
 
5859 dpurdie 1258
    * System Utility - create_dpkg
1259
      Added support to create package fragments. This will be used by a
1260
      future release of the build system.
5527 dpurdie 1261
 
5485 dpurdie 1262
------------------------------------------------------------------------
5448 dpurdie 1263
Version:  3.8.0000.cr                               Released: 04-Jan-16 
1264
------------------------------------------------------------------------
1265
 
1266
Minor changes:
5859 dpurdie 1267
    * ANDROID Platform
1268
      Flag the AndroidStudioBuilder that the project does have unit
1269
      tests so that they can be built before the tests are run.
5448 dpurdie 1270
 
1271
------------------------------------------------------------------------
5434 dpurdie 1272
Version:  3.7.11000.cr                               Released: 17-Dec-15
1273
------------------------------------------------------------------------
1274
 
1275
Minor changes:
5859 dpurdie 1276
    * SK20 Platform, With version 4.1.0.0
1277
      Correct the value of HOST_CPU provided to utilities such as 
1278
      ShellBuild. The 4.1.0.0 compiler is diffeent to the Version 1.
5434 dpurdie 1279
 
1280
------------------------------------------------------------------------
5429 dpurdie 1281
Version:  3.7.10000.cr                               Released: 14-Dec-15 
1282
------------------------------------------------------------------------
1283
 
1284
Minor changes:
5859 dpurdie 1285
    * Build File [JATS-146]
1286
      Fix for use in build system
5429 dpurdie 1287
 
1288
------------------------------------------------------------------------
5415 dpurdie 1289
Version:  3.7.9000.cr                               Released: 11-Dec-15 
5411 dpurdie 1290
------------------------------------------------------------------------
1291
 
1292
Minor changes:
5859 dpurdie 1293
    * Build File [JATS-146]
1294
      Improved reporting of 'alias' conflicts.
1295
      Conflicts now generate an error, not a warning.
1296
      Within the Build and Escrow system conflicts will generate a warning
1297
      to maintain backward compatability.
5411 dpurdie 1298
 
5859 dpurdie 1299
    * ANDROID AndroidStudio
1300
      Added support run automated unit tests
5411 dpurdie 1301
 
1302
------------------------------------------------------------------------
5387 dpurdie 1303
Version:  3.7.8000.cr                               Released: 30-Nov-15
1304
------------------------------------------------------------------------
1305
 
1306
Minor changes:
1307
    * Unit Testing
5859 dpurdie 1308
      Fixed the name of the Unique Test Identifier passed to the filter - UTFUID
5387 dpurdie 1309
 
5859 dpurdie 1310
      Auto detect the presence of test results generated by 'UTF' and invoke
1311
      the UTF filter, if found. This allows the use of the new 'UTF' without
1312
      reworking all UTF consumers.
5387 dpurdie 1313
 
1314
------------------------------------------------------------------------
5378 dpurdie 1315
Version:  3.7.7000.cr                               Released: 26-Nov-15
1316
------------------------------------------------------------------------
1317
 
1318
Minor changes:
1319
    * GCC Toolchain
1320
      Fixed shell script error message introduced in 3.7.6000.cr 
1321
 
1322
------------------------------------------------------------------------
5330 dpurdie 1323
Version:  3.7.6000.cr                               Released: 05-Nov-15
1324
------------------------------------------------------------------------
1325
 
1326
Minor changes:
1327
    * Utility: create_dpkg
1328
      Only perform package level locking when invoked from a build daemon
1329
      Still performs version level locking
1330
 
1331
    * Support for new version of the compiler for the SK20 platform
1332
      New version is selected via: 
1333
          BuildPlatforms('SK20,--Version=4.1.0.0');
1334
      Requires the compiler provided in the arm-unknown-linux-gnueabi-sk20
1335
      package to be locally installed.
1336
 
1337
------------------------------------------------------------------------
5315 dpurdie 1338
Version:  3.7.5000.cr                               Released: 12-Oct-15
5262 dpurdie 1339
------------------------------------------------------------------------
1340
 
1341
Minor changes:
1342
    * Build.pl. BuildAlias directive
1343
      Correctly report the detection of multiple aliases in the one specification.
1344
 
5264 dpurdie 1345
    * Utilities: vcsdiff
1346
      Open registry with read-only access
1347
 
5284 dpurdie 1348
    * Build Metrics
1349
      Updated the version of the 'cloc' tool used by JATS to generate metrics.
1350
 
5262 dpurdie 1351
------------------------------------------------------------------------
5254 dpurdie 1352
Version:  3.7.4000.cr                               Released: 14-Sep-15
1353
------------------------------------------------------------------------
1354
 
1355
Minor changes:
1356
    * Toolset: UBUNTU14_INSTRUMENT
1357
      The UBUNTU14_INSTRUMENT toolchain can consume headers and libraries 
5259 dpurdie 1358
      built for UBUNTU14
5254 dpurdie 1359
 
1360
------------------------------------------------------------------------
5241 dpurdie 1361
Version:  3.7.3000.cr                               Released: 31-Aug-15
5206 dpurdie 1362
------------------------------------------------------------------------
1363
 
1364
Minor changes:
1365
    * Subversion Support
1366
      Detected authentication failure messages provided by new versions of subversion
1367
 
5240 dpurdie 1368
    * Utilities: vcsdiff
1369
      Improved support for BeyondCompare 4 (BC4).
1370
      Check more locations for the program.
1371
 
5206 dpurdie 1372
------------------------------------------------------------------------
5138 dpurdie 1373
Version:  3.7.2000.cr                               Released: 30-Jun-15 
1374
------------------------------------------------------------------------
1375
 
1376
Minor changes:
1377
    * Platform: HAMMERHEAD
1378
      Removed some compiler flags from the c++ builds.
1379
      The removed flags are not applicable to c++ and generate warnings about the
1380
      misuse of the flags.
1381
 
1382
------------------------------------------------------------------------
5129 dpurdie 1383
Version:  3.7.1000.cr                               Released: 30-Jun-15 
5115 dpurdie 1384
------------------------------------------------------------------------
1385
 
1386
Minor changes:
1387
    * BuildProduct directive
1388
      The use of the --Alias=xxx suboption has been exetnded.
1389
        BuildProduct   ( PROD,--Alias=A1', 'PLATFORM1,--Alias=A2', 'PLATFORM1,--Alias=A3' );
1390
      Will result in A1 being an alias for PROD_PLATFORM1 and PROD_PLATFORM2
1391
                     A2 being an alias for PROD_PLATFORM1
1392
                     A3 being an alias for PROD_PLATFORM2
1393
 
1394
    * GCC Toolset. New CompileOptions
1395
      'pic'     - Generate Position Independent Code (PIC) for static libraries
1396
      'nopic'   - Do not generated PIC for static libraries
1397
 
1398
      Currently the default is to not generate PIC on static libraries, except for
1399
      the UBUNTU14 target.
1400
 
1401
      Note: PIC will always be generated for shared libraries
1402
 
1403
------------------------------------------------------------------------
5109 dpurdie 1404
Version:  3.7.0000.cr                               Released: 18-Jun-15 
5100 dpurdie 1405
------------------------------------------------------------------------
1406
 
5109 dpurdie 1407
Major changes:
1408
    * Build File processing - duplicate platforms
1409
      Attempting to build duplicate platforms has been elevated from a warning
1410
      to an error. The warning was always ignored and created bad side effects.
1411
 
1412
      The build daemons and the escrow process will allow duplicates for backward
1413
      compatibility and reproducibility, but new software should have the 
1414
      duplicates corrected.
1415
 
1416
    * Build File processing - Reodering of build information and warnings
1417
      Warnings and Messages generated before the 'Build Configuration' are now
1418
      being stored and displayed after the 'Build Configuration'.
1419
 
1420
      This is intended to bring to the users attention warning that appear at the
1421
      start of the build process but are at the top of the screen. Warnings will be
1422
      displayed at the end of the build process.
1423
 
5100 dpurdie 1424
Minor changes:
1425
    * Utilities: vcsdiff
1426
      Added support for BeyondCompare 4 (BC4)
1427
 
1428
    * Utilities: CCdiff and CCBc2
1429
      Removed. Replaced by vcsdiff
1430
 
5104 dpurdie 1431
    * Utility: gen_cots
1432
      User must specify the source of the package image.
1433
 
5109 dpurdie 1434
    * Package Cache Control
1435
      A new environment variable(GBE_DPKG_CACHE_CTL) allows the GBE_DPKG_CACHE
1436
      to be automatically populated. See 'jats man EnvVars' for details.
1437
      Use 'jats cache_dpkg' to manage the cache.
1438
 
5100 dpurdie 1439
------------------------------------------------------------------------
5074 dpurdie 1440
Version:  3.6.7000.cr                               Released: 19-May-15
5073 dpurdie 1441
------------------------------------------------------------------------
1442
 
1443
Minor changes:
1444
    * Added several make targets:
1445
      jats make hdrs        - makes and installs headers
1446
      jats make libs        - make and installs static libs
1447
      jats make slibs       - make and install shared libs
1448
      jats make progs       - make and install programs
1449
 
5074 dpurdie 1450
    * Subversion comments
1451
      Extended the text in the default Subversion comments created by Jats
1452
      to include the tag/branch being created. Does not affect user provided
1453
      comments.
1454
 
5073 dpurdie 1455
------------------------------------------------------------------------
5036 dpurdie 1456
Version:  3.6.6000.cr                               Released: 08-Apr-15 
5035 dpurdie 1457
------------------------------------------------------------------------
1458
 
1459
Minor changes:
1460
    * Unit Testing
1461
      Create a simple unit test results file for Unit Tests that do 
1462
      not support full results reporting.
1463
 
1464
------------------------------------------------------------------------
5004 dpurdie 1465
Version:  3.6.5000.cr                               Released: 24-Mar-15
1466
------------------------------------------------------------------------
1467
 
1468
Minor changes:
1469
    * Platform : VS2012_X64
1470
      Searches WIN64 for OSCOMMON header files.
1471
 
1472
    * Unit Testing
1473
      Export EnvVar GBE_UTFFILE.
1474
 
1475
      The automated and non-automated unit tests are now run in the order
1476
      in which they are defined in the makefile.pl.
1477
 
1478
    * Build System Utility
1479
      Use file locking on the build marker file to force it to be flushed 
1480
      out to the file server.
1481
 
1482
------------------------------------------------------------------------
4969 dpurdie 1483
Version:  3.6.4000.cr                               Released: 12-Mar-15 
1484
------------------------------------------------------------------------
1485
 
1486
Minor changes:
1487
    * Pseudo Platform: LINUX
1488
      Corrected the operation of the LINUX alias. It is an alias for
1489
      all Back Office Linux targets.
1490
 
1491
    * Utility: create_dpkg
1492
      Use file locking to address contention while merging package instances
1493
      into dpkg_archive.
1494
 
1495
------------------------------------------------------------------------
4950 dpurdie 1496
Version:  3.6.3000.cr                               Released: 06-Mar-15
1497
------------------------------------------------------------------------
1498
 
1499
Minor changes:
1500
    * New Platform: HAMMERHEAD
1501
      Builds under linux using the AVR32_GNU toolchain
1502
 
1503
------------------------------------------------------------------------
4928 dpurdie 1504
Version:  3.6.2000.cr                               Released: 03-Mar-15
1505
------------------------------------------------------------------------
1506
 
1507
Minor changes:
1508
    * ANDROID target
1509
      Can be build on either Windows and Linux. This does not mean that
1510
      all Android packages will build on both, rather that the some Android 
1511
      builders can build under Windows and some under Linux.
1512
 
1513
    * UBUNTU14 target
1514
      Always generates (PIC) Position Independent Code.
4931 dpurdie 1515
      Addresses issues in the creation of shared libraries from static
4928 dpurdie 1516
      libraries.
1517
 
1518
    * Directive CompileOptions
1519
      New options: 'warnings_as_errors' and 'no_warnings_as_errors'
4929 dpurdie 1520
      Will convert compiler warnings into errors on supported toolsets.
4928 dpurdie 1521
      Currently support by all Windows compilers and those that use 
1522
      the GCC toolset.
1523
 
1524
Internal:
1525
    * System function will remove 'undef' parameters
1526
 
1527
------------------------------------------------------------------------
4903 dpurdie 1528
Version:  3.6.1000.cr                               Released: 17-Feb-15 
4898 dpurdie 1529
------------------------------------------------------------------------
1530
Major changes:
1531
 
4902 dpurdie 1532
    * Final release of the 64-bit support platforms
1533
      VS2012_X64, UBUNTU14 and UBUNTU14_INSTRUMENT 
1534
 
4898 dpurdie 1535
Minor changes:
1536
    * Build system. Rewriting of build files with new dependencies now
1537
      preserves the file-endings in the source file. ie: Unix and DOS
1538
      file formats will be preserved.
1539
 
4902 dpurdie 1540
    * Detect and prevent build of software on non-build machines
1541
      such as auperaunx01.
4898 dpurdie 1542
 
4902 dpurdie 1543
Internal:
4903 dpurdie 1544
    * Added platform configurable global options
4902 dpurdie 1545
 
4898 dpurdie 1546
------------------------------------------------------------------------
4889 dpurdie 1547
Version:  3.6.0000.cr                               Released: 12-Feb-15 
4778 dpurdie 1548
------------------------------------------------------------------------
4889 dpurdie 1549
Major changes:
4780 dpurdie 1550
    * JAVA Platform
4805 dpurdie 1551
      Post process UTF results with a ANT/JUNIT4 specific tool.
4889 dpurdie 1552
      Disabled by default
4780 dpurdie 1553
 
4889 dpurdie 1554
    * New platforms (still under development)
4814 dpurdie 1555
      VS2012_X64 - Build 64 bit Windows applications, using VS2012
1556
      MSWIN64    - An alias for all supported 64 bit windows compilers
1557
                   Currently VS2012_X64 is the only member
1558
      UBUNTU14   - Build 64 bit applications targeted at Ubuntu LTS 14.04
1559
                   This is not aimed at front office devices and thus
4903 dpurdie 1560
                   this target is not a part of DEVLINUX
4814 dpurdie 1561
                   It is a part of LINUX
4835 dpurdie 1562
      UBUNTU14_INSTRUMENT
1563
                 - Build instrumented 64 bit applications targeted 
1564
                   at testing under Ubuntu LTS 14.04
4814 dpurdie 1565
 
4778 dpurdie 1566
------------------------------------------------------------------------
4889 dpurdie 1567
Version:  3.5.10000.cr                               Released: 03-Feb-15
1568
------------------------------------------------------------------------
1569
Minor changes:
1570
    * GCC toolset: Handle different versions of lcov
1571
 
1572
    * Unit Testing. Run the collate test results target only once.
1573
 
1574
    * Jats build option: -[no]generic
1575
      To be used by the build system to verify correct usage of the 
1576
      GENERIC platform type.
1577
 
1578
Internal:
1579
    * Adding mechanism to post process Unit Test results.
1580
 
1581
------------------------------------------------------------------------
4728 dpurdie 1582
Version:  3.5.9000.cr                               Released: 04-Dec-14
1583
------------------------------------------------------------------------
1584
Minor changes:
1585
    * New build Alias - NATIVE
1586
      NATIVE is a set of platforms, in the current build, which build 
1587
      artifacts that can be expected to run on the build machine.
1588
 
1589
      The NATIVE alias has been created to simplify the support
1590
      for automated unit tests.
1591
 
4761 dpurdie 1592
    * New build platform - UBUNTU12_INSTRUMENT
4728 dpurdie 1593
      This build target is similar to UBUNTU12, except that it 
1594
      generates instrumented code with gcov. The platform's unit tests 
1595
      will create and maintain a set of lcov files.
1596
 
4805 dpurdie 1597
      Packages generated with this target SHOULD NOT be deployed 
1598
      to the field.
4728 dpurdie 1599
 
1600
------------------------------------------------------------------------
4688 dpurdie 1601
Version:  3.5.8000.cr                               Released: 21-Nov-14 
4652 dpurdie 1602
------------------------------------------------------------------------
1603
Minor changes:
1604
    * Build System Utility: create_dpkg
4688 dpurdie 1605
      When creating the file list for release notes, convert filenames 
1606
      to utf-8 for consistent handling.
4652 dpurdie 1607
 
1608
      Will add its own 'built' files to the package metadata file.
1609
 
1610
    * VS2012 Toolset
1611
      [JATS-308] Running jats from VS2012 Developer command prompt
1612
 
4688 dpurdie 1613
    * EnvVars
1614
      Added GBE_DPKG_REPLICA. This read-only package store is scanned 
1615
      before GBE_DPKG. It is intended to facilitate remote build 
1616
      servers that have a local package archive replica.
1617
 
1618
    * Autobuild support for Java Based Packages
1619
      Attempt to overcome shortcomings in ant-using in a remote build 
1620
      environment. Set GBE_DPKG to GBE_DPKG_REPLICA if doing an ABT enabled 
1621
      build and GBE_DPKG_REPLICA is defined.
1622
 
1623
    * Jats caching
1624
      Modified the cache mechanism such that if the required version is
1625
      found in the cache, then it will not be refreshed. This should speed
1626
      up jats startup.
1627
 
4652 dpurdie 1628
------------------------------------------------------------------------
4620 dpurdie 1629
Version:  3.5.7000.cr                               Released: 20-Oct-14
1630
------------------------------------------------------------------------
1631
Minor changes:
1632
    * SQL Interface to Release Manager Database
1633
      Addressed issues with Java 1.4 compatibility
1634
 
1635
------------------------------------------------------------------------
4613 dpurdie 1636
Version:  3.5.6000.cr                               Released: 16-Oct-14 
4549 dpurdie 1637
------------------------------------------------------------------------
1638
Minor changes:
1639
    * Jats Internal utility: create_dpkg
1640
      Interactive features have been removed
1641
      Generates XML file of files transferred to the package
1642
 
4551 dpurdie 1643
    * Jats Internals
1644
      Reworked the handling of the 'GENERIC' target
1645
 
4549 dpurdie 1646
------------------------------------------------------------------------
4538 dpurdie 1647
Version:  3.5.5000.cr                               Released: 24-Sep-14
1648
------------------------------------------------------------------------
1649
Minor changes:
1650
    * GCC Toolset: SharedLib creation - dependency file detection
1651
      Fixed a bug[JATS-304] in which the dependencies between header files
1652
      and source files was not being used, when building a SharedLib.
1653
 
1654
      The main effect of this is that if a developer modified a .h file
1655
      then JATS was not detecting which C files to recompile.      
1656
 
1657
    * Added a script called jats.unix.sh
1658
      On Unix, this is intended to be copied to /usr/local/bin as 'jats'
1659
      It will redirect the user to the correct instance of JATS
1660
 
1661
    * Jats Internal: Database access
1662
      Rebuilt the database access tools using Java 1.4
1663
      Java 1.4 is lowest common denominator on all of our machines
1664
 
1665
------------------------------------------------------------------------
4519 dpurdie 1666
Version:  3.5.4000.cr                               Released: 19-Sep-14
4488 dpurdie 1667
------------------------------------------------------------------------
1668
Minor changes:
4501 dpurdie 1669
    * Toolset Compiler: M16C for the MCR platform
4488 dpurdie 1670
      Added support to ensure that the program does not exceed allocated
1671
      flash space.
1672
 
4519 dpurdie 1673
    * Toolset: GCC [JATS-300]
5859 dpurdie 1674
      Added support for linking against shared libraries that have 
4519 dpurdie 1675
      dependencies on other shared libraries
1676
 
1677
 
4501 dpurdie 1678
    * Jats Make Directive - Script
1679
      Corrected its operation. The Scripts will be copied into the 'bin'
1680
      directory before the tests are run.
1681
 
4466 dpurdie 1682
    * Internal utilities: Database Access
1683
      Added support to access the ClearQuest database via sqlserver
1684
      Added test_cqconnection
1685
      Added EnvVars to support ClearQuest access
1686
      Updated the template jats.bat and jats.sh scripts
1687
 
4688 dpurdie 1688
    * Reverted automated build support for multi-level SVN branches.
4519 dpurdie 1689
      It created more issues than it fixed.
1690
 
4466 dpurdie 1691
------------------------------------------------------------------------
4461 dpurdie 1692
Version:  3.5.3000.cr                               Released: 19-Aug-14 
4447 dpurdie 1693
------------------------------------------------------------------------
1694
Minor changes:
1695
    * Automated Build Support. SVN branches in a subdirectory structure
1696
      Allow a SVN branch in a multi-level subdirectory to be labeled by
4538 dpurdie 1697
      the build tool. [Removed in 3.5.4000.cr]
4447 dpurdie 1698
 
4461 dpurdie 1699
      Such paths are not encouraged, nor supported by the body of JATS, but
1700
      for compatibility with some existing repositories is required.
4447 dpurdie 1701
 
4461 dpurdie 1702
    * Makefile builder
1703
      Removed two warnings detected by recent versions of Perl
1704
 
4447 dpurdie 1705
------------------------------------------------------------------------
4424 dpurdie 1706
Version:  3.5.2000.cr                               Released: 29-Jul-14
1707
------------------------------------------------------------------------
1708
Minor changes:
1709
    * Utility: create_dpkg
1710
      Does not copy broken symlinks into dpkg_archive
1711
      Will warn about broken symlinks
1712
      In test mode it will generate an error if broken symlinks are found
1713
 
1714
    * Jats Makefile creation
1715
      Corrected handling of source files with multiple '.' in their names.
1716
      There was a problem with such files in Prog and SharedLib directives
1717
 
1718
    * Utility: deploy_builder
1719
      Initial release of this internal utility.
1720
 
1721
------------------------------------------------------------------------
4391 dpurdie 1722
Version:  3.5.1000.cr                               Released: 07-Jul-14 
4382 dpurdie 1723
------------------------------------------------------------------------
1724
Minor changes:
1725
    * Visual Studio 2005 and above toolset
1726
      The programs .exe.manifest will be packaged along with the 
1727
      executable, but only if it exists.
1728
 
1729
------------------------------------------------------------------------
4362 dpurdie 1730
Version:  3.5.0000.cr                               Released: 24-Jun-14
1731
------------------------------------------------------------------------
1732
Minor changes:
1733
    * ANDROID Support
1734
      The 'populate' phase passes in all arguments from the MakeProject directive
1735
      This allows libs and jars to be named during the populate phase.
4345 dpurdie 1736
 
361 dpurdie 1737
------------------------------------------------------------------------
4345 dpurdie 1738
Version:  3.4.9000.cr                               Released: 19-Jun-14
1739
------------------------------------------------------------------------
1740
Minor changes:
1741
    * ANDROID Support
1742
      Populate the project during the build phase. This will place 
1743
      external JARs and Shared Libraries in the project to facilitate
1744
      development.
1745
 
1746
------------------------------------------------------------------------
4326 dpurdie 1747
Version:  3.4.8000.cr                               Released: 18-Jun-14
4324 dpurdie 1748
------------------------------------------------------------------------
1749
Minor changes:
1750
    * New Platform - ANDROID
1751
      Basic build support provided though the Makeproject directive
1752
      The Sdk and all other tools are provided via packages. These
1753
      include: androidBuilder, anddroidSdk and ant
1754
 
1755
------------------------------------------------------------------------
4309 dpurdie 1756
Version:  3.4.7000.cr                               Released: 11-Jun-2014
1757
------------------------------------------------------------------------
1758
Minor changes:
1759
    * GCC toolsets
1760
      Removed -Wid-clash-31 from the list of warnings enabled via 'options=wall'
1761
 
1762
    * New Platform Alias - MSWIN32
1763
      This alias will expand to (supported) targets that build Microsoft
1764
      Windows 32-bit targets. At this release these targets are:
1765
        WIN32   - Visual C 6         
1766
        VS2005  - Visual Studio 2005 (Not recommended)
1767
        VS2012  - Visual Studio 2012
1768
 
1769
------------------------------------------------------------------------
4287 dpurdie 1770
Version:  3.4.6000.cr                               Released: 26-May-14
1771
------------------------------------------------------------------------
1772
Minor changes:
1773
    * Subversion utilities
4309 dpurdie 1774
      Ignored messages about external links while examining the workspace.
4287 dpurdie 1775
      Only generated by some versions of SVN.
1776
      Note: SVN Externals are not supported - just ignored.
1777
 
1778
------------------------------------------------------------------------
4266 dpurdie 1779
Version:  3.4.5000.cr                               Released: 21-May-14
1780
------------------------------------------------------------------------
1781
Minor changes:
1782
    * PackageFile directive
1783
      Improved the --DirTree operation to allow it to work in packages
1784
      with an inverted buildfile structure.
1785
 
1786
------------------------------------------------------------------------
4261 dpurdie 1787
Version:  3.4.4000.cr                               Released: 21-May-14
1788
------------------------------------------------------------------------
1789
Minor changes:
1790
    * Makefile Directives MakeProject and MakeAnt
1791
      Ensure that each project creates a unique makefile target.
1792
      Previously, projects based on the same solution/project file would
1793
      only build the last project due to a name clash
1794
 
1795
------------------------------------------------------------------------
4257 dpurdie 1796
Version:  3.4.3000.cr                               Released: 16-May-14 
1797
------------------------------------------------------------------------
1798
Minor changes:
1799
    * PackageFile directive
1800
      Improved the --DirTree operation. The directive can package up any
1801
      directory within the package - as determined by the PackageBase.
1802
 
1803
------------------------------------------------------------------------
4248 dpurdie 1804
Version:  3.4.2000.cr                               Released: 14-May-14
4197 dpurdie 1805
------------------------------------------------------------------------
1806
Minor changes:
1807
    * Utility: jats sandbox. 
1808
      New subcommand called buildfilter, to display and modify the buildfilter
1809
      used within the sandbox.
1810
 
4247 dpurdie 1811
    * Utility: jats_metrics
1812
      Detect subversion based workspaces and do not attempt to invoke the
1813
      'cleartool' command to count the clearcase branches in the view.
1814
 
4197 dpurdie 1815
------------------------------------------------------------------------
4193 dpurdie 1816
Version:  3.4.1000.cr                               Released: 04-Apr-14
4192 dpurdie 1817
------------------------------------------------------------------------
1818
Minor changes:
1819
    * Preliminary support for VS2012 and CSHARP2012
1820
      This is a Beta.
1821
      Requires VS2012 professional update 4 to be installed
1822
 
1823
    * Utility: gen_cots
1824
      Fixed the package creation process
1825
 
1826
    * Utility: sandbox.
1827
      The -toPackage, -fromPackage, -justPackage and ignore package now support
1828
      a full package_version name, in addition to the simple package name and
1829
      the package name.project forms.
1830
 
1831
      Clarified the forms in the documentation.
1832
 
1833
------------------------------------------------------------------------
4179 dpurdie 1834
Version:  3.4.0000.cr                               Released: 26-Mar-14 
4135 dpurdie 1835
------------------------------------------------------------------------
1836
Minor changes:
4163 dpurdie 1837
    * PackageFile directive
1838
      Improved the --DirTree option's detection of paths outside the current
1839
      directory.
1840
 
4179 dpurdie 1841
    * Jats build log
1842
      Will display the name of the host machine when being run by the BuildTool
1843
      and the build daemons.
1844
 
1845
    * New JATS supported host machine type: linux_x86
1846
      This has been added to support auperaunx01 as a general developer machine
1847
      Currently there are no supported compilers for this machine. It is only
1848
      the JATS tool chain. It allows the processing of subversion related 
1849
      commands.
1850
 
4163 dpurdie 1851
------------------------------------------------------------------------
1852
Version:  3.3.5000.cr                               Released: 21-Feb-14 
1853
------------------------------------------------------------------------
1854
Minor changes:
4135 dpurdie 1855
    * Makefiles. Platform specifier
1856
      Corrected issue where the platform specifier consists entirely of 
1857
      non-platform arguments.
1858
 
1859
    * Jats.bat file example/template
1860
      Added JAVA 1.7 default location
1861
 
1862
------------------------------------------------------------------------
4119 dpurdie 1863
Version:  3.3.4000.cr                               Released: 22-Jan-14
4115 dpurdie 1864
------------------------------------------------------------------------
1865
Minor changes:
4119 dpurdie 1866
    * SK20 Toolset
1867
      Added standard HOST_* definitions to SK20 target
1868
 
1869
    * Subversion Support
1870
      Ignore error text of the form 'QDBusConnection:*' from the SVN error
1871
      stream. This may be generated by a dud released of Ubuntu KDE
1872
 
1873
------------------------------------------------------------------------
1874
Version:  3.3.3000.cr                               Released: 15-Jan-14
1875
------------------------------------------------------------------------
1876
Minor changes:
4115 dpurdie 1877
    * Re-release with missing SK20 support files.
1878
 
1879
------------------------------------------------------------------------
4110 dpurdie 1880
Version:  3.3.2000.cr                               Released: 13-Jan-14 
4109 dpurdie 1881
------------------------------------------------------------------------
1882
Major changes:
1883
    * New build target called SK20
1884
      This uses a gcc-based cross compiler and can be run on linux development
1885
      machines. The compiler and associated SDKs are provided by 'You Transactor'
1886
      Controlled in the VIX package named 'arm-iwmmxt-linux-gnueabi'. This package
1887
      addresses issues in the 'You Transactor' provided installer.
1888
 
1889
Minor changes:
1890
 
1891
------------------------------------------------------------------------
4097 dpurdie 1892
Version:  3.3.1000.cr                               Released: 13-Dec-13  
4075 dpurdie 1893
------------------------------------------------------------------------
1894
Major changes:
1895
 
1896
Minor changes:
1897
    * C# Toolset
1898
      Supported named dependencies when specifying a resx file to support
1899
      resx files that include other files.
1900
 
4097 dpurdie 1901
      Resx support. Extend search path for associated .cs file to include
1902
      the parent directory.
1903
 
4095 dpurdie 1904
    * Utility: update_release
1905
      Set umask to 0002 to assist in preserving group access to files and
1906
      folders created in the 'releases' area.
4075 dpurdie 1907
 
4095 dpurdie 1908
    * Utility: svn createPackage
1909
      Perform a validity check on any directory tree being imported. It 
1910
      must not contain any of the following reserved directory names:
1911
        .svn, .git, .hg, .cvs, tags, trunk or branches
4075 dpurdie 1912
 
4095 dpurdie 1913
    * GCC Based build targets
1914
      Extended CTAGS support to GCC based targets.
4097 dpurdie 1915
      'jats make ctags' will generate a ctags file for GCC based builds in
1916
      the same manner as it has for Windows based builds.
4095 dpurdie 1917
 
4075 dpurdie 1918
------------------------------------------------------------------------
4096 dpurdie 1919
Version:  3.3.0000.cr                               Released: 19-Sep-13
4034 dpurdie 1920
------------------------------------------------------------------------
1921
Major changes:
1922
    * GCC Toolchain - Android NDK support
1923
      Implemented SharedLibrary option - --NoVersionDll
1924
      Implemented CompilerOptions - 'NoVersionDll'
1925
 
4036 dpurdie 1926
      Improved the process that creates symbolic links between a Shared
4034 dpurdie 1927
      Libraries 'RealName' and its 'soname' and 'link name'
1928
 
1929
      Added support for a compiler to be provided through a package.
1930
      Specifically implemented to allow Android
1931
 
1932
Minor changes:
1933
    * BuildName directive
1934
      Force '--RelaxedVersion' on COTS packages that have exactly 3 arguments.
1935
 
1936
    * Sandbox utility
4036 dpurdie 1937
      Fixed use of a 'buildfilter' file in the sandbox directory.
4034 dpurdie 1938
 
1939
    * GCC Toolchain - General
4036 dpurdie 1940
      When building a shared library, all unresolved symbols will generate
4034 dpurdie 1941
      a warning.
1942
 
1943
------------------------------------------------------------------------
4003 dpurdie 1944
Version:  3.2.2000.cr                               Released: 27-Aug-13
1945
------------------------------------------------------------------------
1946
Major changes:
1947
 
1948
Minor changes:
1949
    * Automated Build System Support for machines that do not build the package
1950
      This version provides a transparent 'dummy' build under conditions where
1951
      a package does not build for the current machine. All the commands
1952
      used by the 'buildtool' will perform a dummy build. There are no build
1953
      artifacts, but the build will not fail.
1954
 
1955
      This mechanism improved the tracking of files created during the creation
1956
      of makefiles and uses this mechanism to deleted generated files.
1957
 
1958
------------------------------------------------------------------------
3987 dpurdie 1959
Version:  3.2.1000.cr                               Released: 16-Aug-2013
1960
------------------------------------------------------------------------
1961
Major changes:
1962
 
1963
Minor changes:
1964
    * Utility: update_release
1965
      Added options:
1966
        -addfilter=xxx[,yyy]*
1967
        -delfilter=xxx[,yyy]*
1968
      Allowed the -filter option to take a comma separated list of filters.
1969
      Allowed filters to contain a pathname element. ie: scripts/*.sh
1970
      Allow filters without wildcard characters to work correctly.
1971
      Report filter elements that are not used.
1972
 
1973
    * CSharp Toolset: Resx processing
1974
      Backward compatibility with badly formed packages.
1975
      Ignore 'Designer.cs' files that have zero length.
1976
 
1977
    * Build Target: UBUNTU12
1978
      Added missing LMOS aliases.
1979
 
1980
------------------------------------------------------------------------
3967 dpurdie 1981
Version:  3.2.0000.cr                               Released: 8-Aug-2013
1982
------------------------------------------------------------------------
1983
Major changes:
1984
    * New build target: UBUNTU12
1985
      This is intended to facilitate testing of emebedded devices. It is not
1986
      intended to build deployed software.
1987
 
1988
      UBUNTU12 is considered to be an embedded device and as such is included in
1989
      the DEVLINUX alias.
1990
 
1991
      UBUNTU12 is built on an Ubuntu LTS 12.04 platform using
1992
      gcc (Ubuntu/Linaro 4.6.3-1ubuntu5) 4.6.3.
1993
 
1994
Minor changes:
1995
    * Jats wrapper script
1996
      The default version control system has been set to 'svn'. This means that
1997
      the jats commands 'label', 'release' and 'extract' will invoke the
1998
      Subversion instance of the command.
1999
 
2000
      This change will not be picked up by Windows users. They will need to
2001
      update their jats.bat file if they want this change.
2002
 
2003
    * Utility: jats vcsdiff
2004
      Added support for BeyondCompare3 under windows.
2005
 
2006
    * Utility: jats upddep
2007
      Corrected issue that prevented the results being written to the build.pl
2008
      file under windows.
2009
 
2010
    * CSharp Toolset: Resx processing
2011
      Improved the generation of the Resource names. Now supports
2012
      form names that do not match the enclosing resource.
2013
 
2014
      Supports Resources without a matching .cs file - as long as there
2015
      is a matching Designer.cs file.
2016
 
2017
    * GCC Toolchain
2018
      Added version testing of the compiler being invoked by the build.
2019
 
2020
------------------------------------------------------------------------
3859 dpurdie 2021
Version:  3.1.9000.cr                               Released: 21-Jun-13
2022
------------------------------------------------------------------------
2023
Major changes:
2024
    * Jira Issue: JATS-274: Long view name causes legacy package to
2025
                            fail to daemon build
2026
      Create shorter viewnames when extracting Subversion workspace
2027
 
3967 dpurdie 2028
    * Documentation
3859 dpurdie 2029
      Document the EnvVar ANT_HOME  
2030
 
2031
------------------------------------------------------------------------
3833 dpurdie 2032
Version:  3.1.8000.cr                               Released: 04-Jun-13
3832 dpurdie 2033
------------------------------------------------------------------------
2034
Major changes:
2035
    * New Platform: INTELLECT
2036
      Support for Intellect PAX.
2037
      This support does not extend to native building of PAX modules. It is
2038
      intended to 'wrap' the existing PAX Build system.
2039
 
2040
      The body of the Pax Building infrastructure is not within the JATS core
2041
      but is to be provided though a JATS plugin.
2042
 
2043
------------------------------------------------------------------------
3559 dpurdie 2044
Version:  3.1.7000.cr                               Released: 03-May-13
2045
------------------------------------------------------------------------
2046
Major changes:
3564 dpurdie 2047
    * New Platform: VSDEVRC
2048
      Uses an MSP430G2553 processor, a member of the Texas Instruments MSP430
2049
      family
3559 dpurdie 2050
 
2051
Minor changes:
2052
    * Utility: jats sandbox
2053
      Support sandbox specific build filter. A file called 'buildfilter' in
2054
      the root of the sandbox will be used to specify a sandbox-local
2055
      buildfilter. It will override any buildfilter provided on the command
2056
      line.
2057
 
2058
    * Jats Configuration
2059
      Replace auperaunx26 with auperaarc01 as the default package server.
2060
 
2061
    * Jats Utility: rewrite and upddep
2062
      Purify build files that have mixed line endings under both Windows
2063
      and Linux.
2064
 
2065
      Addresses an issue where build files with mixed line endings are not
2066
      correctly rippled.
2067
 
2068
------------------------------------------------------------------------
3347 dpurdie 2069
Version:  3.1.6000.cr                               Released: 05-Apr-13
2070
------------------------------------------------------------------------
2071
Major changes:
2072
 
2073
Minor changes:
2074
    * Jats Core
2075
      Corrected algorithm used to search for a matching package version.
2076
      This is used by the -build option of ccrelease and svnrelease and
2077
      the '-locatepkg' option of JATS.
2078
 
2079
    * Utility: svnsave_build
2080
      Used only by the build daemons.
2081
      Do not propagate the 'author' of the base package if the build is a ripple.
2082
 
2083
    * Utility: svnrelease and svnextract
2084
      The process of backtracking from a tag to a branch/trunk supports
2085
      branches that are more than a single subdirectory.
2086
 
2087
------------------------------------------------------------------------
3045 dpurdie 2088
Version:  3.1.5000.cr                               Released: 13-Feb-13 
2089
------------------------------------------------------------------------
2090
Major changes:
2091
 
2092
Minor changes:
2093
    * svnrelease utility
2094
      The use of the '-branch' option will not replace the build files with
2095
      those from the base tag, nor will it replace any files that were modified
2096
      between the tag and branch from which the tag was taken.
2097
 
2098
      The resultant workspace will be the HEAD of the named branch, although
2099
      the extraction process will highlight changes between the named branch and
2100
      the named tag.
2101
 
2102
    * svnrelease utility
2103
      Corrected a problem in backtracking from a tag to the development branch
2104
      with some releases of TortoiseSVN.
2105
 
2106
------------------------------------------------------------------------
2931 dpurdie 2107
Version:  3.1.4000.cr                               Released: 31-Jan-13
2108
------------------------------------------------------------------------
2109
Major changes:
2110
 
2111
Minor changes:
2112
    * CHSHARP Toolset
2113
      New CompileOption: NoVersionDLL
2114
        Suppress the creation of versioned DLL for all Shared Libraries
2115
        covered by the makefile.
2116
 
2117
      New SharedLib option: --NoVersionDll
2118
        Suppress the creation of versioned DLLs.
2119
        Unversioned DLLs will always be generated.
2120
 
2121
    * ALL Toolsets
2122
      Ensure that some EnvVars that confuse the GNU automake are not exported
2123
 
2124
    * Utility vcsdiff
2125
      Under Unix will perform a 'diff' of the two views.
2126
      Added '-diff' option to force a text mode diff under Windows, rather than
2127
      the default use of BeyondCompare.
2128
 
2129
------------------------------------------------------------------------
2764 dpurdie 2130
Version:  3.1.3000.cr                               Released: 04-Jan-13
2131
------------------------------------------------------------------------
2132
Major changes:
2133
 
2134
Minor changes:
2135
    * Subversion Extraction
2136
      Detect and report error condition where a tag references a parent
2137
      directory of the tag.
2138
 
2139
      Better handling of tagged versions that have been moved within the
2140
      repository.
2141
 
2142
    * Subversion Support
2143
      Detect authentication errors and issue user-friendly error messages
2144
      showing the user what to do.
2145
 
2146
    * Added Support for LMOS_COBRA
2147
      This does not imply that LMOS is fully supported on the COBRA, only that
2148
      we have build support for this target.
2149
 
2150
      Note: LMOS is not fully supported by VIX on the COBRA platform.
2151
            LMOS should not be used on the COBRA.
2152
 
2153
Internal:
2154
    * Jats Utility: JatsFileUtil usage
2155
      Better handling of files with nasty characters(%'&) in them.
2156
      Now use a modified Url encoding scheme to pass them into JatsFileUtil
2157
      JatsFileUtil Will perform Url decoding of all arguments
2158
 
2159
------------------------------------------------------------------------
2478 dpurdie 2160
Version:  3.1.2000.cr                               Released: 15-Nov-12
2161
------------------------------------------------------------------------
2162
Major changes:
2163
 
2164
Minor changes:
2165
    * Makefile Generation.
2166
      Fixed issue with packaging files with a single quote(') in the name
2167
 
2168
------------------------------------------------------------------------
2450 dpurdie 2169
Version:  3.1.1000.cr                               Released: 14-Nov-12
2170
------------------------------------------------------------------------
2171
Major changes:
2172
 
2173
Minor changes:
2174
    * Makefile generation
2175
      Warning generation of bad source paths does not generate an error
2176
      if the path test escapes the directopry tree. It will generate a
2177
      warning, which allows the build to progress as before - with lots
2178
      of warnings.
2179
 
2180
    * Makefile Generation
2181
      BuildSubDir and SubDir directives - cleanup paths.
2182
 
2183
    * Jats Utility: JatsFileUtil
2184
      Better handling of double '\' in pathnames under windows.
2185
 
2186
 
2187
------------------------------------------------------------------------
2439 dpurdie 2188
Version:  3.1.0000.cr                               Released: 08-Nov-12
2429 dpurdie 2189
------------------------------------------------------------------------
2190
Major changes:
2191
    * Make-time performance improvement of packaging
2192
      Improved the performance of the 'packaging' and 'installing' operations
2193
      by an order of magnitude under windows. Replaced the shell scripting of
2194
      these operations with a dedicated program.
2195
 
2196
      This change also addressed a long-time Windows issue with the packaging
2197
      of files into very long (>~250) paths as the utility supports the full
2198
      windows path scheme.
2199
 
2200
Minor changes:
2201
    * Command Changes: jats clobber
2202
      The 'jats clobber' command has been significantly sped up
2203
      The 'clobber' no longer unpackages and uninstalls files one by one
2204
      from the relevant directories. The entire directory is deleted.
2205
 
2206
      The original sequence can still be perform, if required, with the commands
2207
        jats make clobber
2208
      This operates as before.
2209
 
2210
    * Utility: escrow
2211
      Support to extract packages with a subdirectory structure that
2212
      breaks the JATS rule that the TTB directory names are reserved.
2213
      Some COTS packages break the rule.
2214
 
2215
    * Utility: svn : delete-branch
2216
      Modified the svn branch deletion operation.
2217
        With no arguments it will show the current branch.
2218
 
2219
    * Utility: svn : url
2220
      Improved the conversions supported. Now handles leading SVN::
2221
      and will decode tags of the form SVN::path::tag
2222
 
2223
    * Utility: svn : import
2224
      Added a '-nocommit' option to allow the results of the import to be
2225
      inspected before committing them to the Repository.
2226
 
2227
    * Subversion Support
2228
      Detect authentication errors and issue user-friendly error messages
2229
      showing the user what to do.
2230
 
2231
      The special label of TIMESTAMP now creates a tag with a .WIP
2232
      suffix. This allows the tag to be deleted in the VIX protected
2233
      repositories.
2234
 
2235
------------------------------------------------------------------------
2078 dpurdie 2236
Version:  3.0.5000.cr                               Released: 05-Oct-12
2237
------------------------------------------------------------------------
2238
 
2239
Minor changes:
2240
    * Jats build
2241
      Added a '-nopackages' option to allow the creation of version information
2242
      files under conditions where the external packages are not available, such
2243
      as within a JATS Sandbox.
2244
 
2245
      This option is intended to be used in conjunction with the 'interface'
2080 dpurdie 2246
      command, with a sandbox.
2078 dpurdie 2247
 
2248
      ie: jats sandbox cmd -keepgoing build interface -nopackages
2249
 
2250
------------------------------------------------------------------------
2054 dpurdie 2251
Version:  3.0.4000.cr                               Released: 27-Sep-12
2049 dpurdie 2252
------------------------------------------------------------------------
2253
 
2254
Minor changes:
2255
    * Utility: svn
2256
      Added two subcommands
2257
        branch - to create a branch within a workspace
2258
        switch - to switch a workspace to a branch, or tag.
2259
                 Can also display available branches.
2260
 
2054 dpurdie 2261
    * Utility: sandbox. Subcommand: cmd
2262
      Added '-keepgoing' option to allow the user to ignore errors
2040 dpurdie 2263
 
2264
    * Utility: rtag_extract
2265
        * Added -[no]log option to control the output
2266
        * Extended the examples in the documentation
2267
 
2268
    * Utility: svnrelease and svnextract
2269
      Modified the way that branches are created and used.
2270
      Modified two options:
2271
        -mkbranch=name. Will create a branch while extracting the package
2272
                        The named branch must not exist
2273
        -branch=name.   Will extract the head of the named branch - if it exists
2274
                        The named branch must exist
2275
      The two options are mutually exclusive.
2276
 
2277
------------------------------------------------------------------------
2017 dpurdie 2278
Version:  3.0.3000.cr                               Released: 24-Sep-12
2279
------------------------------------------------------------------------
2280
 
2281
Minor changes:
2282
    * Utility: rtag_extract
2283
      The following enhancements have been made to this utility
2284
        * Only allow extracting into a jats sandbox
2285
        * Create workspaces with a name that is the package name
2286
        * Skip extraction of a package if it already exists in the sandbox
2287
 
2288
------------------------------------------------------------------------
1456 dpurdie 2289
Version:  3.0.2000.cr                               Released: 21-Sep-12
2290
------------------------------------------------------------------------
2291
 
2292
Minor changes:
2017 dpurdie 2293
    * Utility: svnrelease and svnextract
1456 dpurdie 2294
      The name of the directory into which the package will be etracted
2295
      has been greatly simplified, under most cases.
2296
 
2297
------------------------------------------------------------------------
1447 dpurdie 2298
Version:  3.0.1000.cr                               Released: 18-Sep-12
2299
------------------------------------------------------------------------
2300
 
2301
Minor changes:
2302
    * Utility: svnrelease
2303
      Correctly handle build files that are not in the root directory
2304
      Missed in previous release.
2305
 
2306
------------------------------------------------------------------------
2307
Version:  3.0.0000.cr                               Released: 13-Sep-12
2308
------------------------------------------------------------------------
2309
 
2310
Major changes:
2311
    * Jats Version Number
2312
      Rolled to version 3 as the build number was confusingly high
2313
      Although the major version number has changed, JATS has not changed
2314
      significantly.
2315
 
2316
Minor changes:
2317
    * Makefile Generation
2318
      Packing of directories filters out .svn subdirectories
2319
 
2320
    * Utility: svnrelease
2321
      Correctly handle build files that are not in the root directory
2322
 
2323
------------------------------------------------------------------------
1403 dpurdie 2324
Version:  2.101.0000.cr                               Released: 11-Sep-12
2325
------------------------------------------------------------------------
2326
Major changes:
2327
    * Subversion support
2328
      Multiple changes to subversion support to simplify development with
2329
      SubVersion. Changes include:
2330
        - New VcsTag that has a path and a tag component
2331
        - Multiple extraction modes with checks to highlight unexpected
2332
          file changes between workspace and branch head.
2333
 
2334
Minor changes:
2335
    * Utility: New utility - rtag_extract
2336
      Tool to extract a set of packages based on a Release Manager Release.
2337
      Can limit the files extracted to one or more paths, or a list of packages.
2338
      Provides supervised extraction of the set of packages.
2339
      Use 'jats man rtag_extract' or online documentation.
2340
 
2341
    * Utility: svnsave_build
2342
      Failure to change the author of the build is not an error.
2343
      This allows for non-standard repositories being used during consolidation
2344
 
2345
    * Linux support utilities
2346
      Add a version of 'addr2line' that understands the ELF file format
2347
      which has debug information striped out into a separate file.
2348
      Used to support backtracing within unit tests.
2349
 
2350
------------------------------------------------------------------------
1329 dpurdie 2351
Version:  2.100.6000.cr                               Released: 30-Jul-12
2352
------------------------------------------------------------------------
2353
Major changes:
2354
    * Subversion Repository location
2355
      The correct paths to the various SubVersion repositories is:
2356
        GBE_SVN_URL_AUPERASVN01: https://auperasvn01.aupera.erggroup.com/svn
2357
        GBE_SVN_URL_FRBESASVN01: http://frbesasvn01.frbesa.erggroup.com/svn
2358
      Windows users may need to update there jats.bat file.
2359
      These are Fully Qualified Domain Names.    
2360
 
2361
Minor changes:
2362
    * Jats startup warning introduced in 2.100.5000.cr
2363
      Now accepts both / and \ as path separators.
2364
 
2365
    * Utility: svnrelease
2366
      Modified the operation of the '-branch' to better mimic the ClearCase
2367
      operation of the same command. If the specified branch exists, then it
2368
      will be used, otherwise it will be created based on the specified tag.
2369
 
2370
    * Utility: svnsave_build
2371
      Modify the operation such that the 'author' of the saved build is set to
2372
      that of the user that created the version that that build is based upon.
2373
      This preserves the history of the build a lot better than tagging all
2374
      builds as being done by 'buildadm'.
2375
 
2376
    * Utility: ccdelete_view
2377
      Allow the user to specify ClearCase viewtags or a viewstore path.
2378
 
2379
    * Utility: sandbox
2380
      Added options to control the packages processed. The user can specify
2381
      a range of packages and exclude or include specific packages.
2382
 
2383
      Subcommand: populate
2384
      Added -exclude=name[,name]+ to allow specific packages to be excluded
2385
      Add -all option to force dependency testing of packages already in the
2386
      sandbox.
2387
 
2388
    * Subversion Support
2389
      With an automated build environment the use of a default Subversion
2390
      repository is not supported.
2391
 
2392
      Creating a workspace will display the files being extracted providing
2393
      a progress indication.
2394
 
2395
    * Jats Online Documentation
2396
      Migrated several items from the VIX Wiki to the FAQ section of the
2397
      online documentation.
2398
 
2399
    * Generated makefiles
2400
      Improved tracing of package archive source in comments
2401
 
2402
------------------------------------------------------------------------
401 dpurdie 2403
Version:  2.100.5000.cr                               Released: 28-May-12
399 dpurdie 2404
------------------------------------------------------------------------
2405
Major changes:
2406
 
2407
Minor changes:
2408
    * New Platform: WCENAUTIZX5
2409
     "Nautiz eTicket Pro" built under VS2005
2410
 
400 dpurdie 2411
    * Jats startup will warn Windows Users if jats.bat does not
2412
      link to the dynamically updated version of JATS. 
2413
 
399 dpurdie 2414
Internal:
2415
    * Corrected error handling in Release Manager Database connection
2416
      Worked on Windows, but not linux.
2417
 
2418
------------------------------------------------------------------------
387 dpurdie 2419
Version:  2.100.4000.cr                               Released: 30-Apr-12
2420
------------------------------------------------------------------------
2421
Major changes:
2422
 
2423
Minor changes:
2424
    * Jats makefile directive: MakeProject
2425
      Improved support for packaging files with spaces and other make-unfriendly
2426
      characters in their pathname.
2427
 
2428
------------------------------------------------------------------------
385 dpurdie 2429
Version:  2.100.3000.cr                               Released: 20-Apr-12
2430
------------------------------------------------------------------------
2431
Major changes:
2432
 
2433
Minor changes:
2434
    * Platform: VIXITP
2435
      Minor enhancements
2436
 
2437
    * JATS wrappers
2438
      Updated default paths to Subversion Servers
2439
 
2440
    * Subversion Support
399 dpurdie 2441
      Added svn delete-branch
385 dpurdie 2442
 
2443
------------------------------------------------------------------------
383 dpurdie 2444
Version:  2.100.2000.cr                               Released: 13-Apr-12
2445
------------------------------------------------------------------------
2446
Major changes:
2447
 
2448
Minor changes:
387 dpurdie 2449
    * GCC Toolmaking
383 dpurdie 2450
      Use JATS' internal dependency generator. This is much faster than the
2451
      use of the gcc as previously implemented.
2452
 
2453
    * New Platform: VIXITP
387 dpurdie 2454
      Specialized platform for the VIX 'ITP' product.
383 dpurdie 2455
 
2456
    * Subversion Support
2457
      Documented the use of 'TIMESTAMP' in svn commands
2458
      svnrelease. The -branch option supports the special name TIMESTAMP
2459
 
2460
 
2461
------------------------------------------------------------------------
381 dpurdie 2462
Version:  2.100.1000.cr                               Released: 28-Mar-12
2463
------------------------------------------------------------------------
2464
Major changes:
2465
 
2466
Minor changes:
2467
    * Jats makefile directive: MakeLinuxDriver
2468
      Added support for source files not in the same directory as the
2469
      makefile.
2470
 
2471
    * Jats makefile directives: SharedLib and Lib
2472
      Improved support for named source files with directory elements
2473
 
2474
------------------------------------------------------------------------
379 dpurdie 2475
Version:  2.100.0000.cr                               Released: 23-Mar-12
2476
------------------------------------------------------------------------
2477
Major changes:
2478
 
2479
    * WIN32 Target (Visual Studio 6)
2480
      This target will now consume headers/libraries from a VS6 directory.
2481
      This has been provided to allow the use of Dinkumware_STL to be limited
2482
      to this one compiler. Specifically we need to excluded the use of
2483
      Dinkumware from VS2010 builds.
2484
 
2485
    * C# Toolchain
2486
      Correctly detect missing .cs file in .resx /.cs file pair.
2487
 
2488
Minor changes:
2489
    * Jats wrapper script
2490
      New option: -logfile=name
2491
 
2492
    * Jats configuration
2493
      jats.bat example (Windows)
2494
      jats.sh example (Unix)
2495
      Redefined location of the Perth Subversion server AUPERASVN01
2496
 
2497
    * Escrow build on solaris_x86
2498
      Added workaround for strange issue on X86 based Solaris machines
2499
      The GBE_MACHTYPE EnvVar would disappear during the build process
2500
 
2501
    * Utility ccrelease
2502
      The -extractfiles option nolonger uses a dynamic view to perform the
2503
      extraction. It uses the same process as normal view creation.
2504
 
2505
    * Utility: svn
2506
      Improved package import processing.
2507
      Allow Date, Author and Log to be added to the imported package
2508
 
2509
    * Jats Utility: gen_cots
2510
      Added support for Subversion.
2511
      Subversion is supported on Windows and Unix.
2512
      ClearCase is supported on Windows.
2513
 
2514
    * Jats Utility: vcsdiff
2515
      New Utility. Will diff two versions of a package. Supports
2516
      mixed ClearCase and Subversion versions.
2517
      Under windows it can invoke BeyondCompare
2518
      Under Windows and Unix it can perform a MD5 check over both directories.
2519
 
2520
------------------------------------------------------------------------
377 dpurdie 2521
Version:  2.99.2000.cr                               Released: 3-Feb-12
2522
------------------------------------------------------------------------
2523
Major changes:
2524
 
2525
Minor changes:
2526
    * BuildVersion directive
2527
      Updated Company Name, Copyright and Trademark strings to 'Vix IP Pty Ltd'
2528
 
2529
    * GCC Toolset
2530
      Added support for filterering warning messages, via a warnings.gcc file
2531
 
2532
------------------------------------------------------------------------
375 dpurdie 2533
Version:  2.99.1000.cr                               Released: 13-Jan-12
2534
------------------------------------------------------------------------
2535
Major changes:
2536
 
2537
Minor changes:
2538
    * Command: jats clobber
2539
      When building packages that use deploylib - remove the 'build/deploy'
2540
      directory as a part of the clobber processing.
2541
 
2542
    * Jats wrapper. Environment Variable Cleanup (Windows Only)
2543
      Force ALL EnvVars stored in the environment and passed to programs
2544
      invoked by JATS to be converted to upper case.
2545
 
2546
      This solves problems associated with some programs that do not treat
2547
      Windows EnvVars as case insensitive.
2548
 
377 dpurdie 2549
      A useful side effect of this change is that VS2010 running on
2550
      64-bit Windows-7 will now locate the default installation of VS2010, as
2551
      will many other toolsets.
375 dpurdie 2552
 
2553
    * jats svnlabel
2554
      Report conflicting options: Label and Clone
2555
 
2556
      Correct the 'label' operation. The user is not allowed to provide
2557
      path. The user must provide a simple label. JATS will determine the
2558
      workspace and the correct branch/tag to place the label in.
2559
 
2560
    * Built Daemon support
2561
      jats_svn_savebuild will now delete a WIP if its in the /tags/ directory.
2562
      This allows WIPs to be tags or branches
2563
 
2564
------------------------------------------------------------------------
373 dpurdie 2565
Version:  2.99.0000.cr                               Released: 06-Jan-12
2566
------------------------------------------------------------------------
2567
Major changes:
2568
    * GCC Toolset
2569
      Modified the creation and maintenance of debug information.
2570
      New methodology is:
2571
        Debug information is created for both production and debug builds
2572
        Debug information is placed in a .dbg file, which is linked to the
2573
        executable, or shared library. The .dbg file is packaged in the manner
2574
        as the main binary.
2575
 
2576
      This methodology does not bloat the binary with debug information, while
2577
      retaining debug information. The binary transferred to an embedded
2578
      device does not contain debug information, yet the image used in the
2579
      debugger can still access the debug information. This is the best of
2580
      both worlds.
2581
 
2582
Minor changes:
2583
    * HTML Documentation
2584
      JatsWelcome.html - Extended references to BMS documentation.
2585
 
2586
Internal changes:
2587
    * Generated makefiles
2588
      Removed the make_usage target as it is inaccessible. It was replaced by
2589
      jmake's 'help' command a long time back.
2590
 
2591
------------------------------------------------------------------------
371 dpurdie 2592
Version:  2.98.4000.cr                               Released: 23-Dec-11
2593
------------------------------------------------------------------------
2594
Major changes:
2595
    * Jats Sandbox
2596
      Softlinks to packages within the sandbox are now relative to the root of
2597
      the sandbox. This allows packages in the sandbox to be created under one
2598
      machine architecture and consumed under another.
2599
 
2600
    * RIORDS Platform
2601
      Generate output files with the package version embedded in the name
2602
      This can be disabled with --NoVersion
2603
 
2604
      Package up the 'hex' file created when the .img file is processed.
2605
 
2606
 
2607
Minor changes:
2608
    * Processing makefile.pl
2609
      Better handling of some shared library arguments for undeclared files
2610
      Error detection of some arguments that start with white-space
2611
 
2612
------------------------------------------------------------------------
369 dpurdie 2613
Version:  2.98.3000.cr                               Released: 14-Dec-11
2614
------------------------------------------------------------------------
2615
Major changes:
2616
 
2617
Minor changes:
2618
    * New Platform and Toolchain
371 dpurdie 2619
      Platform is RIORDS. This uses the MSP430 toolchain.
369 dpurdie 2620
      Beta release of this toolchain
2621
 
2622
    * Jats Escrow. Escrow extraction
2623
      Force views created to be done in the same manner as the build daemon.
2624
      Under Clearcase, do not include the /main/0 rule.
2625
 
2626
    * Utility: ccrelease (jats release, jats extract)
2627
      Correct use of /main/0 on Unix platforms to match Windows behavior.
2628
      Only add /main/0 if the user has provided a path to a directory within
2629
      a vob.
2630
 
2631
    * Various changes to remove warnings when used with perl 5.14.
2632
      Note: Perl 5.14 is not recommended.
2633
            Perl 5.8.8 is recommended.
2634
 
2635
    * Windows utilities
2636
      Updated 7z to version 9.20.
2637
 
2638
    * Subversion Support
2639
      Support for 1.7 error messages
2640
      Extended the 'jats svn' utility. New subcommands:
2641
        paths - Display Subversion tag to URL conversions
2642
        tag   - Convert a path or URL to a Release Manager Tag
2643
        url   - Convert Release Manager tag to URL
2644
 
2645
    * COBRA Toolset
2646
      Suppress compiler warning on incompatible ABI
2647
 
2648
    * Create dpkg utility
2649
      Allows packaging from a sandbox, but only of package versions 99.99.99
2650
 
2651
Internal changes:
2652
    * Generated makefiles are now dependent on DPACKAGE files from dependant
2653
      packages, if present.
2654
 
2655
------------------------------------------------------------------------
367 dpurdie 2656
Version:  2.98.2000.cr                               Released: 15-Nov-11
2657
------------------------------------------------------------------------
2658
Major changes:
2659
 
2660
Minor changes:
2661
    * Jats Utility:
2662
      Added 'ccdelete_view'. This utility will delete a Clear Case view given a
2663
      viewtag, even if the view has been deleted from disk.
2664
 
2665
    * Jats startup
2666
      Jats will report an error if started in a directory that is inaccessible
2667
      to the user. An error will also be report if jats is directed to change to
2668
      in inaccessible directory.
2669
 
2670
    * Building an ANT project.
2671
      Jats will warn if a buildfile does not have an associated depends file.
2672
 
2673
    * TOOLSET: GCC
2674
      The 'options=args' now shows the operation of the dependency generation step.
2675
 
2676
    * TOOLSET: WINCE
2677
      Better detection of missing SDK components.  
2678
 
2679
    * Subversion support
2680
      Allow untrusted certificates in https connections.
2681
      VisualSvnServer provides self signed certificates
2682
 
2683
Internal:
2684
    * Makefile generation
2685
        Removed the use of the .rul file. Now generated in place.
2686
        Removed PLATFORM.mk dependencies. Work is done in jmake.
2687
 
2688
------------------------------------------------------------------------
365 dpurdie 2689
Version:  2.98.1000.cr                               Released: 15-Sep-11
2690
------------------------------------------------------------------------
2691
Major changes:
2692
 
2693
Minor changes:
2694
    * Utility: cclabel
2695
      Handle VCS tags of the form CC::path::label and extract the vob name and
2696
      the clearcase label.
2697
 
2698
    * Subversion support
2699
      Report errors when required utilities cannot be found
2700
      Delay reporting until utilities are required to allow the help system
2701
      to operate.
2702
 
2703
------------------------------------------------------------------------
363 dpurdie 2704
Version:  2.98.0000.cr                               Released: 09-Aug-11
2705
------------------------------------------------------------------------
2706
Major changes:
2707
    * New toolset: ARM251
2708
 
2709
    * New target platform: ARM_I5100
2710
      Uses the ARM251 toolset.
2711
 
2712
Minor changes:
2713
    * HTML Help
2714
      Correct display of subheadings in the Table of Contents under IE8
2715
 
2716
    * jats build -noforce
2717
      The 'quick' test to force a re-build now takes the value of
2718
      GBE_BUILDFILTER into account. If the value changes, then a rebuild will
2719
      be forced.
2720
 
2721
      This affect the 'jats all' and associated 'sandbox' commands.
2722
 
2723
    * Utility: ccrelease (jats release, jats extract)
2724
      Improved the ClearCase config spec used to create the view.
2725
 
2726
      If the command specifies a branching rule, then the view will not allow
2727
      directories above the package base to be branched. This will prevent
2728
      unintentional branching within the root of the VOB.
2729
 
2730
      If the command does not specify a branching rule, the view now allows
2731
      files and folders to be 'added' within the view, within the package. This
2732
      feature is suppressed when the tool is used by the AutoBuilder, or when
2733
      the load path contains only the name of the VOB.
2734
 
2735
    * Utility: svnrelease
2736
      Remove duplicate package-name words from the generated workspace name to
2737
      provide a cleaner workspace name.
2738
 
2739
      Allow the workspace to be deleted in 'release' mode by changing out of the
2740
      workspace directory before attempting the delete.
2741
 
2742
    * Utility: svn
2743
      Added 'test' to verify that the subversion CLI utility has been
2744
      installed and can be used.
2745
 
2746
    * Toolset: CSharp
2747
      Utilize features of cmdfile to simplify the generated makefile
2748
      Force the generated command file to have correct directory separation
2749
      character.
2750
 
2751
    * Toolset: SunWorks
2752
      Corrected usage of the -erroff directive
2753
      The later SunWorks compilers are more strict about its usage.
2754
      May affect 64 Solaris builds as the incorrect usage may have been
2755
      masking an error.
2756
 
2757
    * Toolset: Delphi7
2758
      Correct library building process that had been broken by previous
2759
      enhancement.
2760
 
2761
    * Toolset: dafbr
2762
      Internal option to simplify compiler testing
2763
 
2764
    * makefile.pl directive: GenerateFiles and RunTests
2765
      Corrected operation of the '--PackageInfo' expansion
2766
        - Return correct path to package
2767
        - If no info is selected, then assume '--path'
2768
 
2769
    * build.pl directive: BuildPlatforms
2770
      Added a '--Alias=Name[,Name]+' option. This allows the setting of
2771
      a platform alias, when the platform is defined.
2772
 
2773
    * build.pl directive: BuildVersion
2774
      Generate well formed VB6 definitions for packages that have dependent
2775
      packages.
2776
 
2777
    * make command: show
2778
      Improved the readability of the 'Alias Targets' list in the
2779
      'jats make show' command.
2780
 
2781
    * Utility: create_dpkg
2782
      When transferring files from a Windows file system to dpkg_archive
2783
      ensure that the execute permission is set for all users.
2784
 
2785
      Allows 'GENERIC' packages to package up executables that will be
2786
      executed on Unix machines.
2787
 
2788
------------------------------------------------------------------------
361 dpurdie 2789
Version:  2.97.0000.cr                               Released: 24-Jun-11 
2790
------------------------------------------------------------------------
2791
Major changes:
2792
    * HTML Help (Experimental)
2793
      Generated documentation for the various JATS utilities
2794
      It is based on the internal JATS documentation available on the command
2795
      line.
2796
 
2797
      Use http://auperaunx26.aupera.erggroup.com/devl/core_devl2/HTML/index.html
2798
 
2799
Minor changes:
2800
    * PackageFile directive
2801
      Allow packaging of files with a comma in the name.
2802
      Used by some COTS packages.
2803
 
2804
    * Windows utilities used by jats
2805
      stdmux and rpccpp: provide production versions that do not use debug
2806
      libraries as these are not present for all users.
2807
 
2808
    * Jats utility: dstatus
2809
      Shows the user friendly host name rather then the internal machine name.
2810
      This change is in line with the changes to Release Manager
2811
 
2812
    * Utility: svnrelease
2813
      Better deletion of workspaces referenced with non-standard URLs
2814
      Corrected problem with -branch=name option
2815
 
2816
    * Utility: svnrelease and ccrelease
2817
      Better deletion of workingspace directory.
2818
      Attempt to correct for directory permission problems.
2819
 
2820
    * Updated definition of GBE_SVN_URL_FRBESASVN01 to use
2821
      the server by name, rather than IP address: 'frbesasvn01'
2822
 
2823
    * Added EnvVar GBE_VCS to control the default Version Control System
2824
      employed by the 'jats release' and 'jats extract' commands.
2825
 
2826
      Usable values are: 'cc' and 'svn'.
2827
      The default value is 'cc', providing backward compatability to existing
2828
      developers.
2829
 
2830
 
2831
------------------------------------------------------------------------
359 dpurdie 2832
Version:  2.96.4000.cr                               Released: 06-May-11
2833
------------------------------------------------------------------------
2834
Major changes:
2835
 
2836
Minor changes:
2837
    * WIN32 Toolset
2838
      Remove .exp and .lib files that may be created when building a program.
2839
      These files may be generated when using code to create a DLL is used
2840
      to create an EXE.
2841
 
2842
    * Utility: upddep
2843
      Handle packages with version strings like: 1.6.0,REV=2006.11.29.05.03
2844
      The '=' was causing issues.
2845
 
2846
    * Utility: sandbox
2847
      New sub command - populate. Beta Release of this command
2848
      This sub command can be used to populate a sandbox with a specific package
2849
      and (optionally) its dependents, that (optionally) are not available
2850
      in a package archive.
2851
 
2852
      Sub command: create
2853
      New option '-exact'. This will create a sandbox in which the package
2854
      version numbers are significant. This is useful when recreating a specific
2855
      package version.
2856
 
2857
      Command specific help
2858
      Each sub command now has its own help.
2859
      ie: 'jats sandbox populate -help' will provide help on the populate
2860
      command.
2861
 
2862
    * BuildVersion directive
2863
      Will create well formed Windows Resource files when the Packages Build
2864
      Number is greater than 7.
2865
 
2866
Internal:
2867
    * Removed jats_save_build.pl
2868
      No longer used by the build tool.
2869
 
361 dpurdie 2870
------------------------------------------------------------------------
357 dpurdie 2871
Version:  2.96.3000.cr                               Released: 14-Mar-11
2872
------------------------------------------------------------------------
2873
Major changes:
2874
 
2875
Minor changes:
2876
    * Minor tweaks for WCEIPA280 support
2877
 
2878
    * Build tool support: jats_vcssave_build
2879
      Deprecated unused options.
2880
 
361 dpurdie 2881
------------------------------------------------------------------------
355 dpurdie 2882
Version:  2.96.2000.cr                               Released: 10-Mar-11
2883
------------------------------------------------------------------------
2884
Major changes:
2885
 
2886
Minor changes:
2887
    * New WinCE platform: WCEIPA280
2888
      Uses VS2005 and the IPA280 SDK from Ingenico
2889
 
361 dpurdie 2890
------------------------------------------------------------------------
353 dpurdie 2891
Version:  2.96.1000.cr                               Released: 09-Mar-11
2892
------------------------------------------------------------------------
2893
Major changes:
2894
 
2895
Minor changes:
2896
    * EnvVars
2897
      Support for GBE_SVN_URL_xxx to support multiple SubVersion repositories
2898
      at multiple locations.
2899
 
2900
    * Build tool support: jats_vcssave_build
2901
      New option -isawip to allow deprecation of -wiplabel option in
2902
      a future release.
2903
 
361 dpurdie 2904
------------------------------------------------------------------------
351 dpurdie 2905
Version:  2.96.0000.cr                               Released: 01-Mar-11
2906
------------------------------------------------------------------------
2907
Major changes:
2908
    * CSHARP2010 target
2909
      Force all C# compilations to be targeted at a 32-bit platform.
2910
 
2911
Minor changes:
2912
    * jats escrow utility
2913
      Uses VcsTag and jats_vcsrelease to be version control system agnostic.
2914
 
361 dpurdie 2915
------------------------------------------------------------------------
349 dpurdie 2916
Version:  2.95.1000.cr                               Released: 14-Feb-11
2917
------------------------------------------------------------------------
2918
Patch changes:
2919
    * Built Tool Interface Changes
2920
        Rename jats_vcs_save_build.pl to jats_vcssave_build.pl
2921
        Rename jats_release.pl to  jats_vcsrelease.pl
2922
      to create a consistent naming convention for the buildtool
2923
      interface to Version Control System aware tools.    
2924
 
361 dpurdie 2925
------------------------------------------------------------------------
347 dpurdie 2926
Version:  2.95.0000.cr                               Released: 11-Jan-11
2927
------------------------------------------------------------------------
2928
Major changes:
2929
    * Initial (experimental) support for VS2010, both for C# and C/C++
2930
    Introduces two new platforms:
2931
        CSHARP2010 (.NET 4.0)
2932
        VS2010
2933
 
2934
Minor changes:
2935
    * jats_rewrite - used only by the build daemons
2936
      Better handling of 'cots' packages.
2937
 
2938
    * jats upddep utility
2939
      Add -keep option to retain the config data extracted from the
2940
      Release Manager data base for diagnistic use.
2941
 
2942
    * Added Linux profile scripts to build installers
2943
      Added TEMPLATES/INSTALL to the packaged version of JATS
2944
      Support for Linux under
2945
        RHEL4
2946
        Ubuntu 10.04
2947
 
2948
Internal:
2949
    * System(--Shell) escaping - improved.
2950
      Only escape spaces if there are multiple arguments.
2951
 
2952
------------------------------------------------------------------------
345 dpurdie 2953
Version:  2.94.0000.cr                               Released: 16-Dec-10
227 dpurdie 2954
------------------------------------------------------------------------
345 dpurdie 2955
Major changes:
2956
 
2957
Minor changes:
2958
    * New target platform - PHP
2959
      This target is only available on a Windows Platform. It is used to limit
2960
      the processing of PHP artifacts by the ZendGaurd.
2961
 
2962
    * Utility: cache_dpkg
2963
      Used internally to cache packages to a local archive.
2964
      When an error is encountered in the transfer the utility will now
347 dpurdie 2965
      correctly delete the package that it was transferring. Previously it
345 dpurdie 2966
      could leave a partially transferred package.
2967
 
2968
    * Utility: create_dpkg [DEVI-063950 ]
2969
      Creates build.<MachineName> marker files as well as built.<MachType>.
2970
      Partial work for DEVI-063950
2971
 
2972
    * makefile.pl directives
2973
      Corrects and extended the operation of the platform-specifier.
2974
      All non-platform options must be true, while the platform names are
2975
      treated as before - any of them may be true. See MASS-00166 for full
2976
      details.
2977
 
2978
Internal:
2979
    * System(--Shell) operations will escape spaces in the argument
2980
      Allows the use c:\Program Files\... in path elements.
2981
 
2982
------------------------------------------------------------------------
343 dpurdie 2983
Version:  2.93.0000.cr                               Released: 03-Dec-10
2984
------------------------------------------------------------------------
2985
Major changes:
2986
 
2987
Minor changes:
2988
    * Jats Sandbox operation
2989
      Don't remove .RUL files in sandbox testing of the build files
2990
 
2991
    * Jats MakeProject directive
2992
      Added --TargetDebug= and --TargetProd=  to allow the default target
2993
      of the project builds to be specified.
2994
 
2995
      Can be used in all targets that use a Visual Studio project or solution
2996
      to build a package.
2997
 
2998
    * MergeLibrary directive
2999
      New sub-option --InterfacePlain
3000
      This will allow the use of 3rd party libraries that do not have a P or D
3001
      suffix in the library name.
3002
 
3003
    * GenerateFiles directive
3004
      Use of --Var(ObjDir) will cause the Object directory to a prequisite
3005
      of the command. Similar for BinDir and LibDir.
3006
 
3007
    * BuildPlatform
3008
      New option: --NoToolSet
3009
      Supresses the check for the existance of the underlying toolset.
3010
      Ensures that the user does not attempt to use the underlying toolset.
3011
 
3012
      To be used in packages that generate installers, where there is
3013
      no compilation phase, but the package search mechanism may still
3014
      need toolset specific information.
3015
 
3016
      Normally used in conjunction with --OnlyProd.
3017
 
3018
      eg: BuildPlatforms ( 'WIN32,--OnlyProd,--NoToolSet' );
3019
 
3020
Internal:
3021
    * Jats EnvVars, ccrelease and svnrelease
3022
      Factored out the default value of GBE_VIEWBASE and associated
3023
      processing into jats.pl
3024
 
3025
      Expect GBE_VIEWBASE to be site specific. Defaults are suitable for
3026
      a ClearCase site.
3027
 
3028
------------------------------------------------------------------------
341 dpurdie 3029
Version:  2.92.0000.cr                               Released: 08-Nov-10
3030
------------------------------------------------------------------------
3031
Major changes:
3032
 
3033
Minor changes:
3034
    * DEVI-059977: 64-bit Solaris libraries try to link against 32-bit libs
3035
      The 64-bit Solaris build will no longer attempt to consume 32-bit
3036
      libraries or header files.
3037
 
3038
    * New tool update_release
3039
      Extracts current package version list from Deployment Manager SBom(s)
3040
      and copy resultant packages to release specific directory.
3041
 
3042
      Use 'jats man update_release' for full details
3043
 
3044
    * New tool ccmerge_build
3045
      Merge an autobuilt build.pl file back to the parent branch
3046
      and leave the resultant file checked out.
3047
 
3048
      Use 'jats man ccmerge_build' for full details
3049
 
3050
    * Jats Sandbox command
3051
      Improved operation of 'sandbox all' and packages that use
3052
      BuildPkgArchive.
3053
 
3054
    * GCC and SUNWORKS tools
3055
      Allow shlib dependency generation to be displayed in verbose mode
3056
 
3057
Internal:
3058
    * Work for subversion support
3059
 
3060
    * Build
3061
      Use Perl 'File' operations instead of system function to delete
3062
      directories. Is faster under Windows.
3063
 
3064
------------------------------------------------------------------------
339 dpurdie 3065
Version:  2.91.0000.cr                               Released: 15-Sep-10
3066
------------------------------------------------------------------------
3067
Major changes:
3068
    * SharedLib directives for Solaris and GCC targets
3069
      Added support to control the 'soname' embedded within the shared
3070
      library. Refer the MASS-00166 for full details. Use with care.
3071
 
3072
------------------------------------------------------------------------
337 dpurdie 3073
Version:  2.90.0000.cr                               Released: 14-Sep-10
3074
------------------------------------------------------------------------
3075
Major changes:
3076
    * New platform - 'COBRA'.
3077
      Support for the ARM926EJS based hardware.
3078
      This is a Linux based target.
3079
      Requires a new compiler to be installed into build machines
3080
 
3081
Minor changes:
3082
    * Jats sandbox command
3083
      Basic support for the 'cache' command.
3084
      Allows external dependent packages to be cached for disconnected
3085
      development.
3086
 
3087
------------------------------------------------------------------------
335 dpurdie 3088
Version:  2.89.0000.cr                               Released: 13-Sep-10
3089
------------------------------------------------------------------------
3090
Major changes:
3091
    * [DEVI-062103]
3092
      Many (11) toolsets - all that generate linker dependency
3093
      files for creating shared libraries or programs.
3094
        Solaris, Gcc, WIN32, Wince, MOS, Verix, Keil, AVR_IAR,
3095
        CSHARP, MCR, Pharlap.
3096
 
3097
      Better, simpler, and in some cases correct, generation
3098
      of dependency files used in linking. Also generate separate
3099
      files for Production and Debug builds.
3100
 
3101
Minor changes:
3102
    * Jats sandbox command
3103
      The 'info' subcommand will highlight external packages that cannot be
3104
      found in any of the the package archives.
3105
 
3106
    * Jats release -extract
3107
      The ClearCase view that is created will have a comment tag added that
3108
      describes:
3109
        - the directory in which the user created the view
3110
        - the date of creation
3111
 
3112
    * PackageFile directive
3113
      Now supports --NoRecurse and --Recurse in conjunction with --DirTree
3114
 
3115
Internal:
3116
    * PackageFile, PackageHdr and InstallHdr directives
3117
      Removed --Abs option - its not supported
3118
      Fixed --Full option.
3119
 
3120
------------------------------------------------------------------------
3121
Version:  2.88.0000.cr                               Released: 26-Jul-10
3122
------------------------------------------------------------------------
3123
Major changes:
3124
 
3125
Minor changes:
3126
    * Dependency Generation Tool - mkdepend
3127
      Correct a problem encountered when the name of an included file
3128
      matches the name of a subdirectory within the include search path
3129
      resulting in multiple builds.
3130
 
3131
    * SOLARIS and LINUX toolsets
3132
      Corrected problem in dependency tracking of shared libraries
3133
      Dependency between shared librares was not being used at all.
3134
 
3135
      Only affected Solaris and Linux builds
3136
 
3137
      Still an issue that affect all platforms that build shared libaries.
3138
      Dependency tracking does not work correctly for both debug and
3139
      production builds. It will work for the first one done.
3140
 
3141
------------------------------------------------------------------------
331 dpurdie 3142
Version:  2.87.0000.cr                               Released: 13-Jul-10
3143
------------------------------------------------------------------------
3144
Major changes:
3145
 
3146
Minor changes:
3147
    * Jats label command
3148
      New option '-entireview' to be used by the build daemon
3149
      Not recommended for general use.
3150
      Will locate the root of the current view and label all files and
3151
      directories within the current view.
3152
 
3153
      Removed the double check of labeled files introduced in
3154
      version 2.80.3000.cr as the problem has been found and corrected
3155
      elsewhere.
3156
 
3157
    * Jats save_build
3158
      Use a better set of options of 'cleartool find' to speed up
3159
      the determination of a branch.
3160
 
3161
      Use the -entireview option of the jats label utility to speed
3162
      up labeling by the build daemons.
3163
 
3164
    * Jats build
3165
      Better handling of sandboxed packages.
3166
        Indicates that the dependency is from a sandbox
3167
        No overwrite warnings when reinstalling a package
3168
 
3169
    * Borland6 toolset
3170
      Changed the default value of where Borland6 is installed
3171
      to match the documented install location of:
3172
        c:\BCB6\CBuilder6
3173
 
3174
    * Jats build
3175
      Added -noforce option to only generate build files if they
3176
      are out of date. It will only recreate makefiles if needed.
3177
      This is a very quick operation.
3178
 
3179
      The default operation is '-force'. This will populate the
3180
      interface directory and generate makefiles.
3181
 
3182
    * Jats all [Experimental. Feed back welcome]
3183
      Uses the '-noforce' form of the build command such that build
3184
      files are only recreated if need be.
3185
 
3186
      The 'all' command will do what is needed in order to rebuild
3187
      the package. It will do a build, if need be, and then
3188
      make the package.
3189
 
3190
    * Jats sandbox
3191
      The 'all' command will perform a '-noforce' build followed by a make.
3192
 
3193
      The 'build' command will perform a build followed by a make. This will
3194
      be a complete build of all component packages.
3195
 
3196
      The 'jats sandbox all' command can be used to rebuild all
3197
      components in an efficient manner. If the build files have changed,
3198
      then the makefiles will be regenerated, other wise only the make phase
3199
      is performed.
3200
 
3201
Internal:
3202
    * build.pl
3203
      Cleanup the start-up processing of build.pl and buildlib.pl            
3204
 
3205
 
3206
------------------------------------------------------------------------
329 dpurdie 3207
Version:  2.86.2000.cr                               Released: 21-May-10
3208
------------------------------------------------------------------------
3209
Major changes:
3210
 
3211
Minor changes:
3212
    * RunTest directive
3213
      Corrected problems with the --Var(xxxx) option when used in conjunction
3214
      with the --abspath option.
3215
 
3216
    * Jats label command
3217
      Removed redundant 'cleartool describe' operations to speed up the process.
3218
 
3219
------------------------------------------------------------------------
327 dpurdie 3220
Version:  2.86.1000.cr                               Released: 11-May-10
3221
------------------------------------------------------------------------
3222
Major changes:
3223
    * New compiler support
3224
      Support for the Keil Arm V4.03a compiler
3225
      This is enabled via:
3226
        build.pl: BuildPlatforms ( 'H400,--Version=4.03a' );
3227
 
3228
Minor changes:
3229
 
3230
Internal changes:
3231
 
3232
------------------------------------------------------------------------
325 dpurdie 3233
Version:  2.86.0000.cr                               Released: 30-Apr-10
3234
------------------------------------------------------------------------
3235
Major changes:
3236
 
3237
Minor changes:
3238
    * jats label command - Renaming a label
3239
      Address issue when renaming a label when the current ClearCase view is
3240
      based on the label. All operation after the rename must specify the VOB
3241
      name as ClearCase may no longer be able to determine the VOB.
3242
 
3243
    * Better handling of .lnk files used within sandboxes and local package
3244
      archives. Now strip all trailing white space correctly
3245
 
3246
    * Jats Sandbox stop files
3247
      Added 'stop.<GBE_MACHTYPE>' stop files to better support multi
3248
      platform builds.
3249
 
3250
    * Makefile rebuild test correctly locates interface directory in
3251
      cases where the source directory is above the build file in the
3252
      directory tree.
3253
 
3254
    * New command: jats man
3255
      Produces full help on a specified item.
3256
 
3257
Internal changes:
3258
    * jats upddep
3259
      Delete temp .cfg file created during the process.
3260
 
3261
    * Jats makefiles: Platform directive
3262
      Initial release of ++Machtype, ++Project and ++Defined
3263
      Not yet in use.
3264
 
3265
------------------------------------------------------------------------
323 dpurdie 3266
Version:  2.85.0000.cr                               Released: 17-Mar-10
3267
------------------------------------------------------------------------
3268
Major changes:
3269
    * New Utility: upddep - Update Dependencies
3270
      This utility will update the dependencies in a build.pl file to be
3271
      consistent with those of a given Release Manager Release. This simplifies
3272
      the operation of maintain build files during development.
3273
 
3274
      It will create an 'auto.pl' file, which JATS uses in preference to a
3275
      build.pl file. DO NOT check this file in.
3276
 
3277
      See:  'jats upddep -help'         - For brief help
3278
            'jats upddep -man'          - For full manual
3279
 
3280
      Examples:
3281
            jats upddep -show
3282
            jats upddep -show=vtk
3283
            jats upddep -rtag=6684
3284
 
3285
    * MicroTec Compiler toolset
3286
      When creating a ShardLibrary (THX) report missing libraries before
3287
      compiling the objects that go into the THX.
3288
 
3289
      This ensures that the error messages the describe the missing library
3290
      can be seen and are not masked by the building of the objects.
3291
 
3292
Minor changes:
3293
 
3294
Internal changes:
3295
    * Utility: jats_rewrite
3296
      Modifications to interwork with the upddep utility.
3297
 
3298
------------------------------------------------------------------------
321 dpurdie 3299
Version:  2.84.0000.cr                               Released: 16-Feb-10
3300
------------------------------------------------------------------------
3301
Major changes:
3302
    * Makefile directive helper function: If
3303
      Used within another directive to enable or disable arguments passed to the
3304
      outer directive. The first argument is a 'platform' specifier - as in
3305
      all Jats Make directives. If making for the specified platform, then the
3306
      remainder of the arguments are inserted into the directives argument
3307
      stream.
3308
 
3309
      Example:
3310
 
3311
      SharedLib ( '*', 'mySharedLib', @OBJS
3312
                     , If ('WIN32',   '-llibrary1', '-llibrary2' )
3313
                     , If ('SOLARIS', '-llibrary3' )
3314
                     );
3315
Minor changes:
3316
    * Makefile directive: InstallLibs
3317
      Correctly installs, as libraries, files that are specified with a 'Src'
3318
      directive. This is consistent with the operation of the PackageLibs
3319
      directive.
3320
 
3321
    * GCC Toolkit
3322
      Changes to the shared library dependency processing to bring it inline
3323
      with other toolers. Will terminate after determining that some
3324
      libraries cannot be found. This will ensure that the error message is at
3325
      the point of termination.
3326
 
3327
    * Jats save_build utility
3328
      Corrected problem in unreserving a reserved checkout of a build.pl file
3329
      under windows.
3330
 
3331
    * Jats sandbox
3332
      ClearCase views created with in the sandbox are created with a tag that
3333
      is named after the sandbox. This allows multiple instances of a view
3334
      in different sandboxes.
3335
 
3336
    * Jats release
3337
      Display cleartool error messages when view creation fails.    
3338
 
3339
------------------------------------------------------------------------
319 dpurdie 3340
Version:  2.83.1000.cr                               Released: 04-Feb-10
3341
------------------------------------------------------------------------
3342
Major changes:
3343
 
3344
Minor changes:
3345
    * jats options
321 dpurdie 3346
      Added -locatedir=name
3347
      Will scan from CWD to the root of the file system looking for the named
319 dpurdie 3348
      directory.
3349
 
3350
    * jats label utility
3351
      Improved handling of the -file and -dir options
3352
      These options will now label the directory elements within the paths
3353
      specified by these options, when used in conjunction with the -up option.
3354
      This simplified the process of labeling complex directory structures.
3355
 
3356
      Added -admin, to allow creation of global labels
3357
 
3358
------------------------------------------------------------------------
317 dpurdie 3359
Version:  2.83.0000.cr                               Released: 20-Jan-10
315 dpurdie 3360
------------------------------------------------------------------------
3361
Major changes:
317 dpurdie 3362
 
3363
Minor changes:
3364
    * WinCe Toolsets
3365
      New CompileOptions operations:
321 dpurdie 3366
        Exceptions              - Enable exception handling
317 dpurdie 3367
        noExceptions            - Disable
3368
      Default is to retain backward compatibility. It is mixed.
3369
      Example:
3370
        CompileOptions ('*', 'Exceptions' );
3371
 
3372
    * Solaris targets
3373
      Full support for a target called SOLARIS8_SPARC32
3374
      It is identical to SOLARIS in a 'sparc' build machine, but it is only
3375
      available on a 'sparc' build machine. Can be used to limit builds to one
3376
      machine type.
3377
 
3378
------------------------------------------------------------------------
3379
Version:  2.82.0000.cr                               Released: 18-Jan-10
3380
------------------------------------------------------------------------
3381
Major changes:
315 dpurdie 3382
    * New Build Platform: VB6
3383
      Jats has been enhanced to support the building of VB6 .vbg and .vbp
3384
      project files.
3385
 
3386
    * Build Directive BuildVersion.
3387
      This has been extended to allow the creation of Version Information in a
3388
      form that can be consumed by Visual Basic using '--Style=VB'
3389
 
3390
Minor changes:
3391
    * Added more internal documentation
3392
      Use jats help to see available documentation
3393
 
3394
    * Jats label -info command [DEVI-059929]
3395
      Fixed problem that prevent this command running on Unix systems.
3396
 
3397
    * Jats save_build utility
3398
      Corrected problem in unreserving a reserved checkout of a build.pl file
3399
      under windows.
3400
 
3401
    * Solaris 10, 64 Bit Sparc Builds
3402
      All compiles are done in a position independent manner (-KPIC)
3403
      This solved issues where static libraries are linked into shared
3404
      libraries.
3405
 
3406
    * Solaris builds
3407
      Program and Shared library dependency checking is now done before
3408
      the program/library objects are built. Thus errors associated with missing
3409
      dependencies occur before objects are built and the user can see the cause
3410
      of the build failure.
3411
 
3412
 
3413
Internal changes:
3414
    * Moved 'jats vars' functionality into a separate program
3415
      Moved associated documentation into the jats_vars tool
3416
 
3417
    * Moved some other internal documentation into InstallationNotes and
3418
      PkgArchive topics.
3419
 
3420
------------------------------------------------------------------------
313 dpurdie 3421
Version:  2.81.0000.cr                               Released: 12-Jan-10
3422
------------------------------------------------------------------------
3423
Major changes:
3424
    * Solaris Builds for 64 bit targets
3425
      Changes to fully support the SOLARIS10_X86 and SOLARIS10_SPARC64
3426
      targets. These are using a different version of the compiler than the
3427
      existing 32-bit builds.
3428
 
3429
      64-Bit Solaris10 builds are performed with Sun Studio 12.1
3430
      32-Bit Solaris10 builds are performed with Sun Studio 11
3431
 
3432
Minor changes:
3433
    * jats label -exclude=nnn
3434
      Corrected problem with the -exclude option introduced in 2.80.3000.cr
3435
 
3436
    * Package searching
3437
      The BuildpkgArchive and LinkPkgArchive directives will search
3438
      both dpkg_archive and deploy_archive paths for packages.
3439
 
3440
      Allows JATS to be used to process deployable packages.
3441
 
3442
    * jats help
3443
      Modified the operation of the 'jats help' command.
3444
      This command now provides a gateway to the jats help system.
3445
 
3446
      Information provided by the previous 'jats help' can be achieved
3447
      with one of:
3448
        jats -h
3449
        jats help jats
3450
 
3451
Internal:
3452
    * cmdfile utility
3453
      Added macros:
3454
        @(sep,x,text)               - Reformat text with specified file sep
3455
        @(env,VarName)              - Extract text from an EnvVar
3456
 
3457
      Corrected
3458
        @(vsep,ident)               - Set path seperator (: or ;)
3459
        @(vhost,ident)              - Modify @(vlib) operation
3460
 
3461
      Extended
3462
        @(vpath)                    - Added optional 'sep' argument.
3463
        @(vlib)                     - Added optional 'sep' argument.
3464
        @(vlint)                    - Added optional 'sep' argument.
3465
        @(vglob)                    - Added optional 'sep' argument.
3466
 
3467
------------------------------------------------------------------------
311 dpurdie 3468
Version:  2.80.4000.cr                               Released: 17-Dec-09
3469
------------------------------------------------------------------------
3470
Major changes:
3471
 
3472
Minor changes:
3473
 
3474
Internal changes
3475
    * Created a Pseudo package to describe the interface directory
3476
      This simplifies the various scanning algorithms within JATS
3477
      Useful side effects include:
3478
 
3479
        JATS plugins will be sourced from the interface directory if included
3480
        with a BuildPkgArchive. This will simplify debugging.
3481
 
3482
        [DEVI-059682] QtBase can be consumed via a BuildPkgArchive directive,
3483
        simplifying the process of packaging additional fonts.
3484
 
3485
        [DEVI-059685] Simplify implementation of --FromPackage options in other
3486
        tools, which obviates the need for QtBase to be consumed via a
3487
        BuildPkgArchive
3488
 
313 dpurdie 3489
    * Perl Modules
3490
      Included the most recent version of the Pod module within the JATS
3491
      release. This will:
3492
        * Ensure consistent cross platform behaviour
3493
        * Corrects issues within earlier releases of the Pod module - some
3494
          reported by ERG.
3495
        * Provide a basis for a better help system within JATS.
3496
 
311 dpurdie 3497
------------------------------------------------------------------------
309 dpurdie 3498
Version:  2.80.3000.cr                               Released: 01-Dec-09
3499
------------------------------------------------------------------------
3500
Major changes:
3501
 
3502
Minor changes:
3503
    * BuildTool utility: jats_save_build
3504
      Returns non-zero error code on labeling errors.
3505
      Deletes label on labeling errors.
3506
      Removed backward compatibility options as they are no longer used.
3507
 
3508
    * Jats label utility
3509
      Changes to assist in tracking down clearcase labeling errors
3510
 
3511
      Once labels have been applied a check is done to ensure that
3512
      the labels have been placed. The check is to attempt to find
3513
      new files and folders to label - there should be none.
3514
 
3515
    * Jats core
3516
      Improved the auto location of the base directory of the build to allow
3517
      for ant-based packages. Allows the jats 'create_dpkg' command to be
3518
      used to package ant based builds.
3519
 
3520
------------------------------------------------------------------------
307 dpurdie 3521
Version:  2.80.2000.cr                               Released: 12-Nov-09
305 dpurdie 3522
------------------------------------------------------------------------
3523
Major changes:
3524
 
3525
Minor changes:
307 dpurdie 3526
    * CSHARP toolset
3527
      Creation of unit tests was broken by 2.80.0000.cr
3528
      This is now fixed.
3529
 
309 dpurdie 3530
      The cmdfile utility creates paths with file path separators as discovered
307 dpurdie 3531
      in the PATH EnvVar. Now that PATH is nice it means that the use of cmdfile
309 dpurdie 3532
      to create shell scripts resulted in scripts with unsuitable separators.
307 dpurdie 3533
 
3534
    * WCEPSION_500_VS2005
3535
      Extended the list of nodefaultlibs to include secchk.lib and ccrtrtti.lib
3536
 
3537
------------------------------------------------------------------------
3538
Version:  2.80.1000.cr                               Released: 12-Nov-09
3539
------------------------------------------------------------------------
3540
Major changes:
3541
 
3542
Minor changes:
305 dpurdie 3543
    * Generating makefiles
3544
      Ensure that the 'BuildMake' directive is the last one in the build.pl file
307 dpurdie 3545
      Directives after this will not be processed correctly and now generate
305 dpurdie 3546
      an error.
3547
 
3548
    * WCEPSION_500_VS2005
307 dpurdie 3549
      Suppress use of -debug:cv when building libraries.
305 dpurdie 3550
 
3551
    * Build directive: BuildSrcArchive
307 dpurdie 3552
      Highly specialized directive.
305 dpurdie 3553
      Refer the JATS Manual.
3554
 
3555
------------------------------------------------------------------------
303 dpurdie 3556
Version:  2.80.0000.cr                               Released: 04-Nov-09
3557
------------------------------------------------------------------------
3558
Major changes:
3559
    * New target: WCEPSION_500_VS2005
3560
      A build of the Psion CE 5.0 under VS2005
3561
      This target has been added to the WINCE target.
3562
 
3563
      WCEPSION_500_VS2005 build cannot consume build artifacts from the
3564
      WCEPSION_500. The two are separate.
3565
 
3566
    * Support for building WinCE targets under VS2005
3567
      Currently only the WCEPSION_500_VS2005 is fully supported
3568
      Support includes
3569
        * Building of executables and DLLs via jats directives
3570
        * Building of components via VS2005 'solution' files
3571
 
3572
Minor changes:
3573
    * Build file processing
3574
      Better detection of bad platform names under Windows
3575
      Note: All platform names should be in uppercase.
3576
 
3577
    * MOS builds
3578
      If a 'product' name not known to JATS is used and a board base address
3579
      is specified then no warnings are generated indicating an unknown 'product'
3580
 
3581
    * MOS builds
3582
      New 'known' product: PICP
3583
      Identical to the TP5 in all but name.
3584
 
3585
    * GenerateFiles directive
3586
        Better handling of '\' when passing arguments to a command line
3587
        under windows.
3588
 
3589
        .
3590
 
3591
    * Verbose builds now show command files
3592
      Currently only supported for WIN32 and WINCE builds.
3593
 
3594
      The use of 'OPTIONS=args' will cause the linker command file to be dumped
3595
      to the output stream.
3596
 
3597
      This facility will be retrofitted to other platform targets in the future.
3598
 
3599
    * Windows Shell
3600
      The shell provided with JATS for use under Windows has been modified so
3601
      that the COMSPEC and PATH variables are correctly formatted with '\'
3602
 
3603
      Addresses issues when invoking Windows tools and programs from within JATS.
3604
 
3605
    * H8S toolset
3606
      Ensure the the EnvVar CYGWIN is not set.
3607
 
3608
      If 'binmode' is set then the gcc compiler used by the H8S toolset cannot
3609
      handle macros that use line continuation.
3610
 
3611
Internal changes
3612
    * WinCe builds
3613
      Changed name of internal file 'toolset/vcwce' to better represent the
3614
      content of the file.
3615
 
3616
      Many internal changes to better support VS2005 and EVC
3617
 
3618
      Macros to encode and decode paths with embedded spaces.
3619
      Currently only used in WIN32 and WINCE toolsets.
3620
 
3621
------------------------------------------------------------------------
301 dpurdie 3622
Version:  2.79.6000.cr                               Released: 18-Sep-09
3623
------------------------------------------------------------------------
3624
Minor changes:
3625
    * PackageFile directive with spaces in names.
3626
      Corrected problem.
3627
 
3628
------------------------------------------------------------------------
299 dpurdie 3629
Version:  2.79.5000.cr                               Released: 14-Sep-09
3630
------------------------------------------------------------------------
3631
Major changes:
3632
 
3633
Minor changes:
3634
    * DPACKAGE file created on multiple machines [DEVI-054973]
3635
      DPACKAGE files are now machine specific.
3636
      Changes are transparent to users.
3637
 
3638
    * Creating static libraries without any object files is treated
3639
      as an error. The Microtec tools sets will create a 'pop-up' if
3640
      this occurs.
3641
 
3642
    * The LinkSandbox directive is not allowed when GBE_ABT is set.
3643
      This directive is highly discouraged in development: Use a jats 'sandbox'
3644
      Moreover it is not reproducible and thus not supported within the
3645
      automated build framework.
3646
 
3647
    * jats sandbox command
3648
      Added support to delete the sandbox metadata. This undoes the
3649
      'create' command.
3650
 
3651
    * jats command aliases. Added
3652
        jats extractfiles to be jats release -extractfiles
3653
        jats extract      to be jats release -extract
3654
 
3655
------------------------------------------------------------------------
297 dpurdie 3656
Version:  2.79.4000.cr                               Released: 29-Jul-09
3657
------------------------------------------------------------------------
3658
Major changes:
3659
    * Jats Command line and -java option
3660
      This version will place the specified java's 'bin' directory into
3661
      the PATH. Thus the commands:
3662
            jats -java=1.6 eprog java -version
3663
            jats -java=1.6 ant build
3664
      will work as expected
3665
 
3666
Minor changes:
3667
    * VS2008 Toolset
3668
      Picking up incorrect config details
3669
      May result in a warning message.
3670
 
3671
    * gen_cots utility
3672
      New option to allow use without ClearCase dependencies.
3673
      Its simply creates a buildable package image.
3674
 
3675
    * DELPHI7 toolset
3676
      Correct the definition of the Debug option '-$D+'
3677
      In debug mode, add $DELPHI/lib/debug to the search paths
3678
 
3679
------------------------------------------------------------------------
295 dpurdie 3680
Version:  2.79.3000.cr                               Released: 01-Jul-09
3681
------------------------------------------------------------------------
3682
Major changes:
3683
Minor changes:
3684
    * Escrow Utility
3685
      Add header to generated HTML describing the source of the data
3686
 
3687
    * IAR Compiler
3688
      Fixed test for loader file
3689
 
3690
    * GCC Toolset
3691
      Fixed DLL Version Number
3692
 
3693
    * DELPHI7 Toolset
3694
      Minor correction discovered during use.
3695
      Existing tools to create a .lib from .dll had serious path length issues
3696
      Extended the compiler search paths
3697
 
3698
    * Deployment utilities (old)
3699
      Correct SQL statement to work without any Schema assumptions
3700
 
3701
------------------------------------------------------------------------
293 dpurdie 3702
Version:  2.79.2000.cr                               Released: 11-Jun-09
3703
------------------------------------------------------------------------
3704
Major changes:
3705
Minor changes:
3706
    * Minor bug fix to address issues introduced in previous release
3707
      Affects SOLARIS and MOS builds
3708
 
3709
------------------------------------------------------------------------
291 dpurdie 3710
Version:  2.79.1000.cr                               Released: 10-Jun-09
3711
------------------------------------------------------------------------
3712
Major changes:
3713
Minor changes:
3714
    * Initial Support for Visual Studio 2008
3715
      New platforms: CSHARP2008 and VS2008
3716
 
3717
    * WIN32 Toolset
3718
      Corrected the -machine option passed to the Windows linker
3719
      Now passes -machine:X86 instead of -machine:IX86
3720
 
3721
------------------------------------------------------------------------
289 dpurdie 3722
Version:  2.79.0000.cr                               Released: 10-Jun-09
3723
------------------------------------------------------------------------
3724
Major changes:
3725
    * New Platform: DELPHI7
3726
      Support the creation of Units,Libraries, Packages and Programs using
3727
      Borlands Delphi Version 7.
3728
 
3729
      See Jats Reference Manual for complete details and Delphi specific options
3730
      to the Prog and SharedLib directives.
3731
 
3732
      This toolset has a number of limitations:
3733
        1) It can build either Debug or Production, but not both, in a single
3734
           makefile.pl. This is caused by the Delphi limitation that library
3735
           names cannot be changed.
3736
 
3737
        2) The generation of dependencies between the source and the generated
3738
           artifacts is very simplistic.
3739
 
3740
      Units are generated with the 'Lib' directive. The name of the Unit and the
3741
      name of the source are linked. The source should not be provided.
3742
        ie: Lib ('*', 'MyUnit' );
3743
      Will create a unit called MyUnit.dcu from the source file 'MyUnit.pas'
3744
 
3745
      Packages are generated with the SharedLib directive starting with a .dpk
3746
      file.
3747
        ie: SharedLib  ( '*', 'MyPackage' );
3748
      will create a package called MyPackage.bpl/dcp from the source file
3749
      MyPackage.dpk.
3750
 
3751
      Libraries are generated with the SharedLib directive starting with a .dpr
3752
      file.
3753
        ie: SharedLib  ( '*', 'MyDll' );
3754
      will create a package called MyDll.dll/lib from the source file
3755
      MyDll.dpr.
3756
 
3757
      Programs are generated with the Prog directive starting with a .dpr
3758
      file.
3759
        ie: Prog  ( '*', 'MyProg' );
3760
      will create a package called MyProg.exe from the source file
3761
      MyProg.dpr.
3762
 
3763
Minor changes:
3764
    * New EnvVar: DELPHI7
3765
      Required only if Borland Delphi 7 has not being installed in the
3766
      standard location or if the Windows Short Name is not
3767
      c:\PROGRA~1\Borland\Delphi7
3768
 
3769
    * BuildVersion directive
3770
      Added a 'Style' of 'Delphi' to allow the generation of version information
3771
      in a Delphi Unit.
3772
 
3773
      Modified the operation of the "C" style generation.
3774
      If the name of the file is provided via '--File', then the generated files
3775
      will be 'known' to JATS and can be consumed from any makefile. JATS will
3776
      'know' the location of the files.
3777
 
3778
    * Sanity test on the names of libraries and programs
3779
      Some characters are not allowed: ie: '/' as this is a mistake.
3780
 
3781
Internal Changes:
3782
    * ToolsetSHLD functions
3783
      Pass in the shared library version string as an argument
3784
      Means that the core of JATS can manage this information in a manner
3785
      that is decoupled from the toolsets.
3786
 
3787
    * Reworked the mechanism used to hold data about libraries, shared libraries
3788
      merged libraries and programs. Created a class to manipulate build targets
3789
      and to maintain information about the contents of the targets.
3790
 
3791
------------------------------------------------------------------------
287 dpurdie 3792
Version:  2.78.4000.cr                               Released: 30-Apr-09
3793
------------------------------------------------------------------------
3794
Major changes:
3795
    * Correctly generate dependencies for C++ only builds
3796
      Many tools sets ( gcc and others) would not generate makefile dependency
3797
      information for purely C++ builds.
3798
 
289 dpurdie 3799
    * Jats.bat and Jats.sh now provide a default Read Only username/password
3800
      for Release Manager and Deployment Manager.
287 dpurdie 3801
 
289 dpurdie 3802
      NOTE: Windows users will need to update their JATS.BAT file in order
3803
            to pick up changed passwords for Release Manager and Deployment
3804
            Manager
287 dpurdie 3805
 
3806
Minor changes:
3807
    * The jats option '-noexportvars' deletes selected JATS EnvVars from the
3808
      environment. This only affects the build daemons.
3809
 
3810
    * updatenodespec utility
3811
      Correct the SQL statements to work with ReadOnly access to the Deployment
3812
      Manager database.
3813
 
3814
------------------------------------------------------------------------
285 dpurdie 3815
Version:  2.78.3000.cr                               Released: 30-Mar-09
3816
------------------------------------------------------------------------
3817
Major changes:
3818
 
3819
Minor changes:
3820
    * Creation of DPACKAGE file [DEVI-054973]
3821
      Better support for packages that build on multiple platforms
3822
      Not completly fixed, but much better than before.
3823
 
3824
    * Escrow tool
3825
      Remove warning created during normal operation
3826
 
3827
    * Minor code cleanup as suggested by code analysis tools
3828
 
3829
------------------------------------------------------------------------
283 dpurdie 3830
Version:  2.78.2000.cr                               Released: 05-Mar-09
3831
------------------------------------------------------------------------
3832
Major changes:
3833
    * New Platform: H400
3834
      Supported by the KIELARMV3 toolset.
3835
      Refer to the Jats Reference Manual for toolset specific options
3836
 
3837
Minor changes:
3838
    * MergeLibrary directive
3839
      Allow a library that has been created in the same makefile.pl as the
3840
      directive to be located, without the need to 'install' it first.
3841
 
3842
 
3843
------------------------------------------------------------------------
281 dpurdie 3844
Version:  2.78.1000.cr                               Released: 26-Feb-09
3845
------------------------------------------------------------------------
3846
Major changes:
3847
 
3848
Minor changes:
3849
    * New command: jats make show
3850
      Will display the platfroms, alias definitions and the makefile paths
3851
      used in the build.
3852
 
3853
    * Escrow command
3854
      Now supports extraction based on a single package and version
3855
 
3856
    * Build File Rewrite Utility
3857
      Added a '-validate' option to allow the build daemons to validate the
3858
      build files against the Release Manager information.
3859
 
3860
      Improved error reporting to make it clear that the problem is a mis-match
3861
      between Release Manager and the package's build files.
3862
 
3863
------------------------------------------------------------------------
279 dpurdie 3864
Version:  2.78.0000.cr                               Released: 18-Feb-09
277 dpurdie 3865
------------------------------------------------------------------------
3866
Major changes:
279 dpurdie 3867
    * GBE_BUILDFILTER configuration has been simplified
277 dpurdie 3868
 
279 dpurdie 3869
      JATS will automatically filter out target platforms that cannot be built
3870
      on the users machine. ie: It will not try to build Solaris targets on a
3871
      Windows machine. Thus, under the new scheme a Windows GBE_BUILDFILTER need
281 dpurdie 3872
      not contain '!SOLARIS'
279 dpurdie 3873
 
3874
      This greatly simplifies the creation of GBE_BUILDFILTER as it does not
3875
      need to be configured to exclude targets that cannot by built.
3876
 
3877
      Existing GBE_BUILDFILTER definitions are backward compatible.
3878
 
3879
    * Jats utility : gen_cots
3880
      Requires the user to specify a target VOB with the -vob option
3881
        Ensures the user is aware of the target VOB
3882
 
3883
      Now creates temporary directory within the users TEMP directory.
3884
        Addresses problems where the user's CWD is within the package being
3885
        processed.
3886
 
3887
      Removed the '-delete' option
3888
        Always delete the temp work directory if it exists.    
3889
 
277 dpurdie 3890
Minor changes:
279 dpurdie 3891
    * Sandbox command
3892
      Added build, make, clean, clobber commands
3893
 
3894
      Sandbox packages may contain a file called 'stop', to exclude the
3895
      target from consideration in the build set.
3896
 
3897
    * MCR Toolset
3898
      This toolset only supports 16 compiler search paths. An descriptive error
3899
      has been added to detect and report on this error.
3900
 
3901
    * WIN32 and PHARLAP toolsets
3902
      The --Resource=xxx option specifies a comma separated list of files.
3903
      Spaces are now allowed either side of the comma.
3904
        ie: "--Resource=file1.h, File2.h"
3905
 
3906
    * Jats run_test command
3907
      Removed a non-fatal warning message that was being generated when the
3908
      tests we run on a Window machine.
3909
 
3910
    * descpkg file
3911
      Now contains HOSTNAME of the build machine
3912
      Not (yet) aggregated when packages are merged
3913
 
3914
   * built.<machine> tag files created by create_dpkg
3915
     Now contains build trace information
3916
        Date-Time, Machine, User, ABT config
3917
 
3918
   * jats abt command simplified usage
3919
     This command now appends the current directory as a library path to ANT if
3920
     it contains 'jar' files.
3921
 
3922
     Uses ANT 1.6 as the default version of ANT
3923
 
3924
     Both changes will simplify the use of this command within the escrow
3925
     environment. ie: 'jats abt -buildfile=build1.xml'
3926
 
3927
   * BuildVersion directive
3928
     Form:
3929
        BuildVersion ('--Style=C');
3930
     now works as expected.
3931
     Slightly better error detection on the directives arguments.
3932
 
3933
Internal Changes:
3934
 
3935
    * Error reporting mechanism
3936
      Improved the error reporting mechanism. Allowed a function to
3937
      create modify the error reporting parameters in such a manner that the
3938
      original values are restored at the end of a function.
3939
 
3940
 
3941
------------------------------------------------------------------------
3942
Version:  2.77.8000.cr                               Released: 18-Dec-08
3943
------------------------------------------------------------------------
3944
Major changes:
3945
 
3946
Minor changes:
277 dpurdie 3947
  * Jats Wrapper
3948
    Added -NoExportVars option to allow use of JATS to startup build daemons
3949
    without fixing the version of JATS that is used by the processes the daemon
3950
    then starts.
3951
 
3952
    Limit searches for local and sandbox archives to the '/home' directory
3953
    so that the Unix auto mounter does not report errors.
3954
 
3955
  * Jats makefiles. Platform Specifier
3956
    The Platform Specifier has been extended to support a '--MachType=name'
3957
    non-platform option.
3958
 
279 dpurdie 3959
    This may be used to limit Java builds to a 'win32' machine if required.
277 dpurdie 3960
 
3961
------------------------------------------------------------------------
275 dpurdie 3962
Version:  2.77.7000.cr                               Released: 17-Dec-08
3963
------------------------------------------------------------------------
3964
Major changes:
3965
 
3966
Minor changes:
3967
    * MugFile support
3968
      Added facilities to allow named files to be added the the Thx Fileset
3969
      Added options to facilitate the creation of sets of THX files
3970
      Refer to MASS-00099 for complete details.
3971
 
3972
    * Jats Utility: dstatus
3973
      Limit display width of the build machine named to 20 characters
3974
 
3975
    * Jats sandbox command (experimental)
3976
        A files called 'stop' within the root directory of the component
3977
        packages will prevent the utility from processing that subdirectory.
3978
 
3979
        Extended command sets to allow the command 'all', 'build' and 'make'
3980
        to be processed as commands to be invoked in all sandbox components
3981
 
3982
    * Jats Make: New EnvVars
3983
        GBE_MAKE_TYPE               - P or D
3984
        GBE_MAKE_TARGET             - Target platform
3985
        GBE_MAKE_CMD                - Current make target
3986
        GBE_MAKE_CFG                - Internal config
3987
 
3988
    * Jats generated scripts: set_<platform>.sh
3989
      The generated scripts preserve any spaces in the argument list passed
3990
      to the invoked application.
3991
 
3992
Internal Changes:
3993
    * JatsCopy Package
3994
      CopyFile operation can copy an array of files
3995
      CopyDir now supports MatchDirs
3996
 
3997
    * JatsMakeConfig Package
3998
      Added class to read in the parsed makefile.pl data for the current
3999
      build target.
4000
 
4001
    * Jmake - Jats Makefile Supervisor
4002
      Export GBE_MAKE_* EnvVars to directly export the current makefile
4003
      environment. 
4004
 
4005
 
4006
------------------------------------------------------------------------
273 dpurdie 4007
Version:  2.77.6000.cr                               Released: 11-Dec-08
4008
------------------------------------------------------------------------
4009
Major changes:
4010
 
4011
Minor changes:
4012
    * Jats command: sandbox
4013
      Support subcommands "clean" and "clobber"
4014
      These traverse the sandbox in the reverse direction so that the clean
4015
      up operations work correctly.
4016
 
4017
    * Makefile generation
4018
      Removed warning on the use of --OnlyProd and --OnlyDebug
4019
 
4020
    * JatsCopy Package
4021
      Minor enhancements to this internal package
4022
        CopyFile operation returns path to target file
4023
        CopyDir can, if asked, returns an array of files copied
4024
        Wildcard correctly supports the [0-9] construct
4025
 
4026
Internal Changes:
4027
    * Environment
4028
      Export EnvVar GBE_HOSTMACH
4029
      This is the same as GBE_MACHTYPE, but it is not modified by legacy
4030
      makefiles. Available for sanity testing.
4031
 
4032
    * Remove unused references to the File::Find package in Perl scripts
4033
 
4034
    * Jats building Jats now uses the JatsCopy package to perform the many
4035
      copy operations in the build.
4036
 
4037
 
4038
------------------------------------------------------------------------
271 dpurdie 4039
Version:  2.77.5000.cr                               Released: 24-Nov-08 
267 dpurdie 4040
------------------------------------------------------------------------
4041
Major changes:
4042
 
4043
Minor changes:
271 dpurdie 4044
    * Added LMOS_PPC_603E to the LMOS target
269 dpurdie 4045
 
271 dpurdie 4046
    * Jats Utility: dstatus
4047
      Improved handling of closed and archived releases
4048
      Displays include activity time information
269 dpurdie 4049
 
271 dpurdie 4050
Internal Changes
4051
    * jats.pl
4052
      Removed unused function
4053
 
4054
    * makeif.pl
4055
      Added significant documentation
4056
      Provided access to some of the functions via and API
4057
      Renamed to MakeIf.pm
4058
      Moved location to the LIB directory.
4059
 
4060
    * MakeEntry.pm
4061
      Added support for the use of in-memory files
4062
      Allows the output to be 'printed' to a memory variable rather then a file
4063
 
4064
    * ReadBuildConfig.pm
4065
      Added routines to access package information in a manner that is
4066
      independent of the underlying data.
4067
 
4068
    * makelib.pl2
4069
      Added mechanism to allow toolsets to register for notification
4070
      of specific source files present in the build.
4071
 
4072
      Improved readability of the generated makefiles.
4073
      Added informationas to the source of included files
4074
 
4075
      Added docuementation to previously undocumented functions
4076
 
4077
      Corrected usage of the MakeIf package.
4078
      Use it as a package.
4079
 
4080
    * Win32 binary tools
4081
      Added 7z.exe - command line utility to process various compressed
4082
      file formats. Can be used to perform tar-like operations underlying
4083
      windows.
4084
 
4085
    * JatsSvnCore.pm
4086
      Made use of a new binary utility ('stdmux') to multiplex stdout and
4087
      stderr into one data stream that can be handled by perl one allow
4088
      platforms.
4089
 
4090
 
269 dpurdie 4091
------------------------------------------------------------------------
271 dpurdie 4092
Version:  2.77.4000.cr                               Released: 11-Nov-08
269 dpurdie 4093
------------------------------------------------------------------------
4094
Major changes:
4095
 
4096
Minor changes:
271 dpurdie 4097
    Jats utility 'release' [DEVI-051370 ]
4098
    The utility will place a tag file in the root of the package
4099
    as specified by the '-path' option. This will be used by the build tool
4100
    tool re-locate the root of the package and thus allow the correct generation
4101
    of the ClearCase related metrics.
4102
 
4103
    Generation of Resource Files for WIN32 builds
4104
    Corrected version identifier
4105
 
4106
 
4107
------------------------------------------------------------------------
4108
Version:  2.77.3000.cr                               Released: 28-Oct-08
4109
------------------------------------------------------------------------
4110
Major changes:
4111
 
4112
Minor changes:
267 dpurdie 4113
    * Jats option '-locate' correctly locates ANT build files [DEVI-052423]
4114
 
4115
    * Allow Deployable packages to be built on some, but not all, of the
4116
      build machines and correctly package the descpkg file. [DEVI-052422]
4117
 
4118
    * JATS CompileOptions directive  [DEVI-052426]
4119
      New options:
4120
        no_define_source_file
4121
        define_source_file              (Default)
4122
 
4123
      The 'no_define_source_file' will suppress the compile definition __SOURCE__
4124
      Currently only implemented for WIN32 and WINCE toolsets.
4125
 
4126
      The __SOURCE__ definition renders pre-compiled headers useless.
4127
      This option has not be enabled by default to ensure backward
4128
      compatibility.
4129
 
4130
    * Jats directives: MakeProject
4131
      Now supports the following new options:
4132
            --InstallProgDebug=list
4133
            --InstallProgProd=list
4134
            --InstallProg=list
4135
 
4136
      These allows files that are created by the project builder to be
4137
      installed locally to be consumed by such packaging directives as
4138
      GenerateCab.
4139
 
4140
    * Jats directives: AddLDFlags and AddASFlags
4141
      Now supports the --Debug and --Prod options like the other AddFlags
4142
      directives.
4143
 
4144
    * Jats builder directive: BuildVersion
4145
      New options that can be used when generating a WinRC style version
4146
      information:
4147
            --Definitions                   - Create definitions only
4148
            --Comment=text
4149
            --Description=text
4150
            --Product=name
4151
 
4152
Internal Changes:
4153
    * These utility 'gen_winrc' now uses module used by the BuildVersion
4154
      directive to created the resource file.
4155
 
4156
      The BuildVersion.pm module has been modified to allows it to be used in
4157
      a standalone manner by gen_winrc.pl.
4158
 
4159
------------------------------------------------------------------------
265 dpurdie 4160
Version:  2.77.2000.cr                               Released: 26-Sep-08
261 dpurdie 4161
------------------------------------------------------------------------
4162
Major changes:
263 dpurdie 4163
 
4164
Minor changes:
265 dpurdie 4165
    * Jats utility jats_save_build.pl
4166
      Fix problem when used in new mode.
4167
      These label is now applied from the root of the VOB and not from
4168
      the location of the builder file.
4169
 
4170
------------------------------------------------------------------------
4171
Version:  2.77.1000.cr                               Released: 18-Sep-08
4172
------------------------------------------------------------------------
4173
Major changes:
4174
 
4175
Minor changes:
263 dpurdie 4176
    * New JATS Platform : PHARLAP [DEVI-051359]
4177
      Added support for PharLap 10.1
4178
      Requires that both PharLap 10.1 and Visual Studio 6 be installed
4179
      Full details in the JATS manual.
4180
 
4181
    * Windows utilities  [DEVI-051360]
4182
      Added rpccpp to assist in the creation of rcpgen based modules under
4183
      windows.
4184
 
4185
    * MOS68K and MOSCF toolsets
4186
      Made used of rpccpp. These platforms can now support the creation
4187
      of XDR based modules.
4188
 
4189
    * Jats GenerateFiles directive
4190
      New option '--PreDelete' will delete all generated files before
4191
      the generator process is run. This may be used in cases where the
4192
      generator process does not operate if the output files already exist,
4193
      such as the rpcgen utility.
4194
 
4195
    * Jats MakeAnt directive
4196
      Correct problem where unit_tests could not be run.
4197
      Automated unit_tests tests could be run.
4198
 
4199
    * Buildtool utility: jats_rewrite
4200
      Added -noconfig option to allow the creation of auto.xml files
4201
      in escrow.
4202
 
4203
    * create_dpkg utility
4204
      Merged files that exist in the target archive are now compared
4205
      against the local file. A difference is considered to be an error.
4206
 
4207
Internal Changes:
4208
    * Resolved issues with JatsEnv modules that make it difficult to include
4209
      the modules in other modules. This is now a package
4210
 
4211
    * JatsSystem Module
4212
      Resolved issues when 'shell' is used to invoke a 'system' command.
4213
      Now quote the command string being passed to the shell.
4214
 
4215
      Resolved issues with JatsCmd
4216
      Now takes an array of arguments.
4217
 
4218
      Added JatsTool to be more efficient where a known JATS tool is being
4219
      invoked. This is faster assist it does not invoked three unneeded
4220
      programs.
4221
 
4222
    * Renamed jats_cbuilder tool to jats_ccrelease.
4223
      Changes is not visible to the users, assist they go through the 'jats'
4224
      wrapper. Internally the changes is in preparation to alternate version
4225
      control systems.
4226
 
4227
 
4228
------------------------------------------------------------------------
4229
Version:  2.77.0000.cr                                Released: 1-Sep-08
4230
------------------------------------------------------------------------
4231
Major changes:
261 dpurdie 4232
    * Perl Version. Must be at least version 5.8.2
4233
      This is the first version that supports Windows 2003 server.
4234
 
4235
      After discovering that several operations are not fully function under
4236
      Perl 5.6.1 the minimum version of Active State Perl that is required has
4237
      been increased.
4238
 
4239
      A suitable windows installer can be found at:
4240
        \\auperaunx26\devl\releases\3rdParty-Products\ActivePerl\5.8.8.819\
4241
                                    ActivePerl-5.8.8.819-MSWin32-x86-267479.msi
4242
 
4243
    * Jats Build Targets
4244
      New target and toolset: VERIX
4245
 
4246
    * Jats utility: jats_save_build
4247
      Extended to allow all ClearCase specific operations to be removed
4248
      from the Build Daemons.
4249
 
4250
      This utility is only used by "Release Planner" and the "Build Daemons".
4251
 
4252
      Suggested new usage:
4253
        jats etool jats_save_build
4254
                        -pname=xxxx
4255
                        -pversion=yyyy
4256
                        -infofile=path_name
4257
                        -locatepkg=zzzz     (Optional)
4258
                        -infile=aaaa        (Optional)
4259
                        -outfile=bbbb       (Optional)
4260
                        -wiplabel=ccccc     (Optional)
4261
 
4262
Minor changes:
4263
    * JATS make: Merge Library Operation [DEVI-049475]
4264
      Fixed such that Library Merge operations don't delete other build
4265
      artifacts.
4266
 
4267
    * JATS make: New option expert=0|1
4268
      Runtime processing of 'expert' mode to allow dependencies between the
4269
      object files and the makefile to be ignored.
4270
 
4271
      Previous this operation could only be invoked at 'build' time. Now the
4272
      default state will be set at build time and it can be overridden at 'make'
4273
      time.
4274
 
4275
    * JATS utility: CCdiff
4276
      Corrected operation of the option "-new=dir=."
4277
 
4278
    * Nunit support in CSHARP
4279
      Improved support for different version of Nunit
4280
      Allow the DLLs that are required by nunit to be specified 
4281
      within the package.
4282
 
4283
    * Jats utility: dstatus
4284
      Suppresses archived releases.
4285
      Shows release state
4286
 
4287
    * Build file directive: BuildPkgArchive
4288
      Extended list of supported directories to include 'wsdl'.
4289
 
4290
Internal Changes:
4291
    * JATS make: Detection of makefile dependencies
4292
      Isolated the detection process to one point.
4293
      Previously was being done at two places
4294
        - Within jmake - jats makefile supervisor
4295
        - Within the generated makefile. This is still present but
4296
          is suppressed if jmake is used to invoke the makefile.
4297
 
4298
    * JATS make: Command line
4299
      Removed the use of the un used "VERBOSE=1" operation
4300
      Improved use of "options=args|allargs"
4301
 
4302
      It didn't work on all platforms.
4303
      Is better does with "options=args" or "options=allargs"
4304
 
4305
    * JATS command line
4306
      Improved operation of the -help,-man, -verbose and -debug options
4307
      to allow:
4308
        + Direct level specification (-verbose=3)
4309
        + Better use of Perl Option Parsing Utilities
4310
        + Consistent use of option parsing
4311
 
4312
    * JATS makefile generation
4313
      Simplifies creation of internal rules
4314
      Improved readability of the generation process
4315
      Improved readability of the generated makefile
4316
      Removed dead code
4317
      Improved the creation of Progs
4318
 
4319
    * JATS error reporting
4320
      Added a Fatal call to allow utilities to report infrastructure
4321
      problems.
4322
 
4323
      Corrected problem in the use of GBE_[tag]_VERBOSE and GBE_[tag]_DEBUG
4324
      environment variables where the 'tag' contains a space.
4325
 
4326
    * Assorted Perl files
4327
      Minor corrected after running Perl Syntax check over JATS files.
4328
 
4329
    * Made the use of IFLAGS uniform for all JATS toolsets
4330
      Removed the need, and use of IFLAGS3; simplifying the generated
4331
      makefiles
4332
 
4333
    * Corrected tagging  of files generated by the various toolsets
4334
      Many files where incorrectly tagged and were not being cleaned up.
4335
 
4336
    * FileUtils package.
4337
      Added functions to create and append text to small text files.
4338
      Provides consistent error messages and simplifies creation of small files.
4339
      Used functions within JATS.
4340
 
4341
 
4342
------------------------------------------------------------------------
259 dpurdie 4343
Version:  2.76.2000.cr                               Released: 23-Jul-08
257 dpurdie 4344
------------------------------------------------------------------------
259 dpurdie 4345
Minor changes:
4346
    * New Platform and Toolset : ACEX
4347
      Provides support for the Fairchild ACEx assebmler
4348
 
4349
------------------------------------------------------------------------
4350
Version:  2.76.1000.cr                               Released: 10-Jul-08
4351
------------------------------------------------------------------------
257 dpurdie 4352
Major changes:
4353
 
4354
    * Jats make: Package and Install directives [DEVI-049299]
4355
      Convert relative pathnames to absolute pathnames before passing
4356
      to copy command. This makes the most of Windows limited path length
4357
      as implemented by many Windows utilities.
4358
 
4359
Minor changes:
4360
    * JATS makefile generation: Provide case-corrected pathnames for
4361
      library and include files in dpkg_archive.
4362
 
4363
      Needed to support badly formed legacy packages when used with
4364
      some windows tools.
4365
 
259 dpurdie 4366
------------------------------------------------------------------------
255 dpurdie 4367
Version:  2.76.0000.cr                               Released: 24-Jun-08
4368
------------------------------------------------------------------------
4369
Major changes:
4370
    * Support for Microsoft Visual Studio 2005 [DEVI-049017]
4371
      The product must be installed in its default location.
4372
 
4373
      New platforms:
4374
        CSHARP2005
4375
         Uses C# Framework Version 2.0.50727
4376
         Support extends to allow:
4377
            1) Building of Csharp source using standard JATS
4378
            2) Build Visual Studio solutions
4379
         Can consume files from CSHARP and WIN32 components.
4380
 
4381
        VS2005
4382
         Support extends to allow:
4383
            1) Building of C and C++ source using standard JATS
4384
            2) Build Visual Studio solutions
4385
         Can consume files from VS2003 and WIN32 components.
4386
 
4387
      The existing WIN32 and CSHARP platforms can also utilize VS2005
4388
      through a version selector:
4389
        WIN32 Toolset   - "MS.NET2005"
4390
        CSHARP Toolset  - "MS.NET2005"
4391
 
4392
    * Version of Make for Win32 builds
4393
      The version of Make has been upgraded to 3.81 to provide access
4394
      to macros to simplify support for the MS VS2005.
4395
 
4396
    * CSHARP and WIN32 platforms
4397
      The LIB path uses to locate libraries and DLLs has been altered to:
4398
        - Contain absolute paths. Relative paths did not work under all
4399
          conditions when building projects and solutions.
4400
        - Contain valid paths. JATS generated paths that do not physically exist
4401
          will be removed from the search path. This removes warning messages
4402
          under VS2005.
4403
 
4404
Minor changes:
4405
    * New Jats utility: dstatus
4406
      Display Build Daemon Status. A text based utility.
4407
      Use 'jats dstatus -man' for full details.
4408
 
4409
    * PPC_603E Toolset
4410
      Changed the definition of HOST_CPU to be correct for the linux
4411
      architecture that uses the value - powerpc.
4412
 
4413
      Extended LinuxDrivers directive to allow for powerpc.
4414
 
4415
      Updated the MakeLinuxDriver directive to use EXTRA_CFLAGS as CFLAGS
4416
      has been removed. This change is backwardly compatible.
4417
 
4418
    * Modified all utilities to avoid a Perl-10 warning message [DEVI-049018]
4419
      Improved usage of the 'require' statement used to check for
4420
      a minimal value of perl.
4421
 
4422
      Removed excessive require statements.
4423
 
4424
    * JATS internal utilities - xmake
4425
      Source for Make 3.81 is now controlled
4426
      Include JATS specific files for
4427
        1) Windows
4428
        2) Linux
4429
 
4430
      JATS now includes binaries for make.
4431
      This will ensure that the version of make being used will be known for all
4432
      machines. Gnu make does not need to be installed for the various build
4433
      machines.
4434
 
4435
    * JATS internal utility sh.exe (windows)
4436
      Extended internal debugging via EnvVar SHDEBUGEXEC
4437
 
4438
    * JATS Environment
4439
      Allow Jats Environment variables that are used to specify a directory
4440
      to be set to either '-' or 'none'. The associated path will set to empty.
4441
 
4442
      This can be used to override defaults that may be inserted by the JATS
4443
      wrapper scripts.
4444
 
4445
    * JATS utility: sandbox (Experimental)
4446
      Correct problem with location of build files.
4447
      Spell check help and code.
4448
 
4449
------------------------------------------------------------------------
253 dpurdie 4450
Version:  2.75.3000.cr                               Released: 06-Jun-08
251 dpurdie 4451
------------------------------------------------------------------------
4452
Major changes:
4453
 
4454
Minor changes:
253 dpurdie 4455
    * Jats utility: release [DEVI-047291]
4456
      A race condition within clearcase will cause a view to fail during
4457
      creation. This is detected and the command will be retried a number
4458
      of times.
4459
 
4460
------------------------------------------------------------------------
4461
Version:  2.75.2000.cr                               Released: 27-May-08
4462
------------------------------------------------------------------------
4463
Major changes:
4464
 
4465
Minor changes:
251 dpurdie 4466
    * PPC_603E Toolset
4467
      Changed the definition of HOST_CPU to be non-numeric
4468
 
4469
    * GCC Toolset
4470
      Correct the operation of the assembler interface to 'gas' such that
4471
      options are passed correctly.
4472
 
4473
    * Jats utility: CCdiff [DEVI-048127] [DEVI-048439]
4474
      Sped up the label-label comparison.
4475
      Restored speed to that of observed before the label-view comparison
4476
      was added.
4477
 
4478
      Restored ability to perform a one-sided comparison. This is used when
4479
      reviewing a new package.
4480
 
4481
    * Makefile creation: BuildVersion directive
4482
      Better handling of the generated files such that they are
4483
      automatically included in the source file list.
4484
 
253 dpurdie 4485
    * Toolset updates
4486
      Thyron and gnu_mpt. From An Tran.
4487
 
251 dpurdie 4488
------------------------------------------------------------------------
249 dpurdie 4489
Version:  2.75.1000.cr                               Released: 14-May-08
229 dpurdie 4490
------------------------------------------------------------------------
4491
Major changes:
249 dpurdie 4492
 
4493
Minor changes:
4494
    * PackageFile directive [DEVI-048037][DEVI-047541]
4495
      Now supports the packaging of files with ( or ) in the name
4496
 
4497
------------------------------------------------------------------------
4498
Version:  2.75.0000.cr                               Released: 07-May-08
4499
------------------------------------------------------------------------
4500
Major changes:
247 dpurdie 4501
  * New toolset and platform
4502
    Added support for the PPC_603E platform.
4503
    This uses the powerpc-603e-linux-gnu compiler
4504
    The DEVLINUX and LMOS_DEVLINUX targets have been extended to include
4505
    this platform.
4506
 
4507
Minor changes:
4508
  * Jats utility: CCdiff
4509
    Extended operation to allow one side of the comparison to be a directory
4510
    within a static view. This allows comparison between a label and current
4511
    work.
4512
 
4513
  * Jats utility: release
4514
    Added checking of correct package name and version when files are
4515
    published to dpkg_archive.
4516
 
249 dpurdie 4517
  * Jats utility: jats_rewrite [DEVI-034837]
247 dpurdie 4518
    Extended operation to allow the special properties to be transferred from
4519
    Release Manager to the build tool to the target build. Currently only
4520
    supported for ANT builds.
4521
 
4522
    New 'known' ANT properties are:
4523
        releasemanager.releasename
4524
        releasemanager.projectname
4525
 
4526
    The configuration file, used by this utility, has been extended to support
4527
    tagged data item of the form
4528
 
4529
        releasemanager.releasename = value
4530
        releasemanager.projectname = value
4531
 
4532
  * Mug File Generation
4533
    Added --NoMugFiles option to suppress the creation of Mug Files
4534
    This allows THX files to be collected for possible deployment.
4535
 
4536
    When this option is enabled, the user does not need to specify the
4537
    Device ID, Name or Tier Number, nor are the external tools packages
4538
    required.
4539
 
4540
  * Makefile creation: BuildVersion directive
4541
    Modified the operation of the BuildVersion directive such that the
4542
    location of the files that are generated will be known to the Jats
4543
    makefiles. In this manner the user doesn't not need to know the location of
4544
    the files in order to use them.
4545
 
4546
    The file will need to be declared with a 'Src' directive, but JATS will
4547
    locate the file.
4548
 
4549
    This options does not occur for the 'C' version files. This is intentional
4550
    to ensure backward compatibility.
4551
 
4552
    The operation does occur for version files of Style:
4553
        * CSharp
4554
        * Properties
4555
        * WinRC
4556
 
4557
  * JATS directive: CompileOptions
4558
    Correct operation of options that make use of assigned values.
4559
    The case of the value is now preserved.
4560
    Value is correctly assigned.
4561
 
4562
------------------------------------------------------------------------
4563
Version:  2.74.0000.cr                               Released: 29-Apr-08
4564
------------------------------------------------------------------------
4565
Major changes:
245 dpurdie 4566
  * M16C toolset. Used by the MPR platform to build MCRFirmware [DEVI-047555]
4567
    Corrected the version number embedded in the generated THX file.
4568
 
4569
    Major and minor numbers greater than 9 were incorrectly represented
4570
    Added a test to ensure that the major and minor numbers are in the range
4571
    of 0 to 99 inclusive.
4572
 
4573
  * Auto-build when multiple build.pl files are labelled [DEVI-047461]
4574
    Modified JATS to allow support for the automated building of packages that
4575
    contain multiple, labeled, build files.
4576
 
4577
    Added a '-locatepkg=pkg' option to the Jats wrapper script. This allows the
4578
    user to specify the package to be selected from those that can be found.
4579
    This will be integrated into the build tool.
4580
 
4581
    Modified the operation of the 'jats release' command to use the
4582
    infrastructure provided by the above feature. Testing a release uses the
4583
    additional information to ensure that the created package name and version are
4584
    correct.
4585
 
4586
    Modified the operation of the (experimental) 'jats sandbox command to use
4587
    the infrastructure provided by the above feature.
4588
 
4589
Minor changes:
4590
  * Solaris Toolset [DEVI-047398]
4591
    The toolset no longer requires that the user have the compiler and the
247 dpurdie 4592
    'ar' utility in their path. It will be controlled by the toolset.
245 dpurdie 4593
 
4594
    This should improve build reproducibility.
4595
    This will simplify new user setup.
4596
 
4597
  * All Unix Toolsets
4598
    Corrected the operation of the 'options=showenv' so that it works
4599
    on unix systems
4600
 
4601
  * JATS release utility  [DEVI-047356]
4602
    Fixed problem where utility would issue a 'Broken Pipe' message
4603
    on some Solaris Machines.
4604
 
4605
  * JATS -version=<version>
4606
    Fixed operation on machines that do not have a GBE_DPKG_CACHE such that
4607
    JATS does not attempt to cache the alternate version.
4608
 
4609
------------------------------------------------------------------------
4610
Version:  2.73.4000.cr                               Released: 10-Apr-08
4611
------------------------------------------------------------------------
4612
Major changes:
243 dpurdie 4613
    * New platform: WCEPSION_500_emu [DEVI-047234]
245 dpurdie 4614
      Creates binaries for the WCEPSION_500 emulator
243 dpurdie 4615
      Added this platform to the default 'WINCE' alias.
4616
 
4617
Minor changes:
4618
    * JATS escrow utility [DEVI-047232]
4619
      Handle package names that have spaces and brackets
4620
 
4621
    * JATS release utility [DEVI-047232]
4622
      Handle view names that have spaces and brackets
4623
 
4624
    * Removed detection of unknown platforms
4625
      Does not work with LMOS
4626
 
4627
    * Readme.txt file
4628
      Added a brief description on the core_devl directory structure.
4629
 
4630
    * Misc Cleanup
4631
      Removed version-1 test that is not applicable to the current jats
4632
      Move PostInstall script into the BUILD directory.
4633
 
4634
------------------------------------------------------------------------
4635
Version:  2.73.3000.cr                               Released: 07-Apr-08
4636
------------------------------------------------------------------------
4637
Major changes:
241 dpurdie 4638
  * MOS68K Toolset (Not MOS68KRM)
4639
    Force compiler option -nOj
4640
    The default compiler option (-Oj) has been seen to cause problems with some
4641
    code. Problem reported/analysed by rparker and thunter.
237 dpurdie 4642
 
241 dpurdie 4643
  * MOS68K Toolset (Not MOS68KRM)
4644
    Correct problem in disabling Global Optimization that was introduced in
4645
    version 2.73.1000
4646
 
237 dpurdie 4647
Minor changes:
241 dpurdie 4648
  * JATS makefiles
4649
    Correct problem where a Production/Debug only build would create OBJ
4650
    directories for both production and debug, and not clean them up.
4651
 
4652
  * JATS builds
4653
    Allow ANT builds to be run in verbose mode to facilitate debugging
4654
    The command "make all options=args" will run the ANT builds in 'verbose'
4655
    mode.
4656
 
4657
  * JATS makefiles
4658
    Extended the 'selector' used in all makefile directives - as the first
4659
    argument. Added two non-platform related options:
4660
        --Project=xxxx      True if the package suffix matches
4661
        --Defined=yyy       True if yyy is declared with a SetValue or
4662
                            SetList directive.
4663
 
4664
    ie: AddSrcDir ('--Project=sls' , 'sls' );
4665
        AddSrcDir ('!--Project=sls', 'default');
4666
 
4667
  * JATS makefiles. MakeProject directive
4668
    New packaging options to package up programs to be used as JATS plug-ins
4669
        --PackageTool=xxxx
4670
        --PackageToolProd=xxx
4671
        --PackageToolDebug=xxx
4672
 
4673
  * JATS buildfile processing
4674
    Generate a warning for build platforms that are unknown to JATS
4675
    These may be the result of a user typo or an incompatible version
4676
    of JATS.
4677
 
4678
  * JATS save_build utility
4679
    Correctly handle autobuild branches that contain multiple checkouts, one of
4680
    which may be reserved.
4681
 
4682
  * JATS gen_cots utility
4683
    Correctly labels directories up to the VOB root.
4684
    Displays the correct 'Source Path' in the Release Manager Information.
4685
    Ignores the 'administration_view' as this is read-only
4686
 
4687
  * JATS sandbox (experimental)
4688
    Ensure the AutoBuildTool does not use any sandbox
4689
 
4690
  * JATS release (cbuilder) utility
4691
    Handle paths that have a trailing path separators.
4692
 
4693
  * JATS Makefile generation. Packaging directives
4694
    Packaging directives that use the --Dir option have been modified
4695
    such that the direction cannot use a a relative path.
4696
 
4697
    * Escrow tool
4698
      Creates a simple HTML file that details all the packages with a short
4699
      description.
4700
 
4701
------------------------------------------------------------------------
4702
Version: 2.73.2000.cr                                Released: 06-Mar-08
4703
------------------------------------------------------------------------
4704
Major changes:
4705
 
4706
Minor changes:
239 dpurdie 4707
    * Corrected operation of GBE_PLATFORM, when building a GENERIC package.
4708
      A GENERIC package can now be built independently of the value
4709
      of GBE_PLATFORM.
4710
 
4711
    * MOS Toolset
4712
      If only building for a production target, then don't generate an error
4713
      if there is no debug data and code addresses specified.
4714
 
4715
      Use to build platform independent MOS Releases. Cannot have debug, but
4716
      can have production (PIC) components.
4717
 
4718
    * Utility command: jats abt
4719
      Parse and use -buildfile=xxx option
4720
 
4721
    * Utility command: jats extract -extractfiles
4722
      The extractfiles option will now duplicate empty directories
4723
 
4724
    * Building ANT projects under JATS
4725
      Ensure that the PATH is correctly setup so that ANT can locate
4726
      utilities within the JAVA directory - for both Solaris and Windows.
4727
      Previously only worked on Windows
4728
 
4729
------------------------------------------------------------------------
4730
Version: 2.73.1000.cr                                Released: 21-Feb-08
4731
------------------------------------------------------------------------
4732
Major changes:
4733
 
4734
Minor changes:
237 dpurdie 4735
    * Jats Label Utility
4736
      Correct use of '-norecurse' operation.
4737
 
4738
    * Jats command line under Unix
4739
      Corrected problem when command line quoted arguments with a space are
241 dpurdie 4740
      passed in. ie: -xxx="aaa bbb ccc"
237 dpurdie 4741
 
4742
    * Escrow tool
4743
      Added totals to all the tables created in the HTML report
4744
 
4745
    * Platform MOS68KRM
4746
      Rome builds. Modified compiler options to match the existing build system
4747
 
4748
------------------------------------------------------------------------
239 dpurdie 4749
Version: 2.73.0000.cr                                Released: 20-Feb-08
237 dpurdie 4750
------------------------------------------------------------------------
4751
Major changes:
235 dpurdie 4752
    * New Toolset: BORLAND
4753
      The toolset uses the Borland C++ Builder 6 to build Borland Project
4754
      files via the MakeProject directive.
231 dpurdie 4755
 
235 dpurdie 4756
      In this release there is no support for native compilation and linking.
4757
 
4758
      Details are provided in MASS-00166 JATS Reference Manual
4759
 
231 dpurdie 4760
Minor changes:
235 dpurdie 4761
    * Extract/Release utility.
4762
      Handle Source Path option with spaces by creating a config spec
4763
      that can handle spaces
4764
 
4765
    * MOS Compiler
4766
      The TMP directory used by the assembler will be created before the
4767
      assembler is invoked. This will ensure that the directory exists.
4768
 
4769
    * Utility: create_dpkg
4770
      Uses the first 'descpkg' file found. Allows packages that have embedded
4771
      descpkg files to be copied.
4772
 
4773
    * AVR_IAR Toolset
4774
      Added support for AT90SC144144CT - by David Payne.
4775
 
4776
    * JATS ANT command
4777
      Better selection of the ant build file
4778
 
4779
    * Build directive: BuildVersion
4780
      Extended the WinRc version file to allow the name of an icon to be
4781
      embedded in the .RC file.
4782
 
4783
------------------------------------------------------------------------
4784
Version: 2.72.2000.cr                                Released: 06-Feb-08
4785
------------------------------------------------------------------------
4786
Major changes:
4787
 
4788
Minor changes:
233 dpurdie 4789
    * Building JATS. Installer will set a+x in dpkg_archive
4790
 
4791
    * JATS rewrite. Remove the need  for the 'name=' attribute in the
4792
      <project> field.
4793
 
4794
    * CCdiff utility
4795
      Now ignores blank lines when generating a file difference report.
4796
 
4797
    * Escrow utility
4798
      Quote 'path' in the generated extraction commands
4799
      Allow escrow to be based on a single Release Manager package
4800
 
4801
    * Minor Perl-10 tweaks  
4802
 
4803
------------------------------------------------------------------------
4804
Version: 2.72.2000.cr                                Released: 24-Jan-08
4805
------------------------------------------------------------------------
4806
Major changes:
4807
 
4808
Minor changes:
231 dpurdie 4809
    * Jats Tool: CCbc2 [DEVI-044908]
4810
      Locates BeyondCompare through the Windows Registry. This allows
4811
      BeyondCompare to be installed in places other then the default location.
4812
 
4813
    * Jats test runtime helper scripts set_PLATFORM.bat
4814
      Windows. Batch file modified so that it doesn't exit the shell.
4815
 
4816
    * Jats wrapper
4817
      If JATS attempts to cache itself and an error is reported by the caching
4818
      utility, then Jats would fail without reporting an error message.
4819
 
4820
------------------------------------------------------------------------
4821
Version: 2.72.00000.cr                                Released: 11-Jan-08
4822
------------------------------------------------------------------------
4823
Major changes:
229 dpurdie 4824
    * Jats Release Mechanism
4825
      Jats can now release itself. This is not the same a building all of its
4826
      internal components, but it does mean that a new version of JATS can be
4827
      released using the 'standard' mechanism.
4828
 
4829
      Jats releases will be tracked in Release Manager.
4830
 
4831
      A side effect of this is that the labelling scheme will change to align
4832
      itself with Release Manager. ie: <package_name>_<package_version>.
4833
 
4834
    * Running Jats
4835
      Running Jats from within a ClearCase view is being deprecated.
4836
      Jats should be run from a package present in dpkg_archive.
4837
      This may affect some windows developers.
4838
 
4839
      This release of JATS can be run from ClearCase, but generates a warning.
4840
      Future versions will generate an error.
4841
 
4842
      Refer to MASS-00164 Installing and Using JATS.
4843
 
4844
Minor changes:
4845
    * Perl Version Check
4846
      Jats will generate a warning if the version of Perl in use is newer
4847
      than the version used in test. Newer versions are not always backward
4848
      compatible. Currently JATS has been extensively tested with 5.8.8.
4849
 
4850
    * Build Directive: BuildVersion
4851
      This directive has been extended to allow the creation of a 'properties'
4852
      file. This file may be used to pass version information into a an ANT
4853
      build.
4854
 
4855
    * Jats Internals
4856
      Minor fix to interwork with Perl version 5.10.
4857
      Perl 5.10 has not been extensively tested - yet.
4858
 
4859
    * Jats Tool: CCbc2
4860
      Added utility to use BeyondCompare (BC2) to compare files in two
4861
      packages defined as ClearCase labels. The utility creates two dynamic views
4862
      and starts BeyondCompare. The views are destroyed at the end of the
4863
      process.
4864
 
4865
      Requires BeyondCompare to be installed in its default location.
4866
      Only works under Windows.
4867
 
4868
      Use jats CCbc2 -help (or -man) for further details.
4869
 
4870
    * Jats test runtime helper scripts set_PLATFORM.sh
4871
      Marked as executable, so that users can run them directly
4872
 
4873
    * Jats test runtime helper scripts set_PLATFORM.bat
4874
      Uses SETLOCAL / ENDLOCAL to prevent environment variables being exported
4875
      into the parent space. This mimics the behaviour of Unix.
4876
 
4877
    * Jats eprog
4878
      Consistent cross-platform handling of programs found in the current
4879
      directory.
4880
 
4881
    * jats tool jats_metrics
4882
      A new utility that will be used by the Automated Build System to collect
4883
      build metrics.
4884
 
4885
------------------------------------------------------------------------
227 dpurdie 4886
Version: 2.71.6.cr                                Released: 18-Dec-07
4887
------------------------------------------------------------------------
4888
Major changes:
4889
 
4890
Minor changes:
4891
    * Jats Tool: create_dpkg
4892
      Added options to allow the utility to sanity test the package name and
4893
      version of the package being created. This is intended to be used by the
4894
      automated build system. New options are:
4895
        -pname=Package_Name
4896
        -pversion=Package_Version
4897
 
4898
      Added option to allow the source package form to be tested, without
4899
      transferring the package. New options are:
4900
        -test
4901
 
4902
    * Jats Tool: CCdiff
4903
      -output=filename now works. Previously only -out=filename worked.
4904
      -vob=name does not generate internal message under unix
4905
 
4906
    * JATS Environment variables GBE_BUILDFILTER and GBE_PLATFORM can be either
4907
      a space separated or a comma separated list.
4908
 
4909
    * Solaris Toolset
4910
      Disable the use of purify, purecov and quantify when building shared
4911
      libraries. Shared libraries are not supported by these tools. Executable
4912
      programs are still supported.
4913
 
4914
------------------------------------------------------------------------
4915
Version: 2.71.5.cr                                Released: 07-Dec-07
4916
------------------------------------------------------------------------
4917
Major changes:
4918
 
4919
Minor changes:
4920
    * WINCE toolsets
4921
      Added a run-time test for the presence of the required toolset
4922
      This will report an error if the required WINCE toolset has not been
4923
      installed. This is better than obscure message generated by the compilers
4924
      when header files cannot be found.
4925
 
4926
    * GenerateFiles directive
4927
      If the generating tool can only be found in the users path, don't make
4928
      it a prequisite under Windows. There are problems with spaces in pathnames
4929
      that are difficult to solve.
4930
 
4931
    * MakePerlModule directive
4932
      Extended the directive syntax to allow command line options to be passed
4933
      to the the module builder.
4934
 
4935
    * Jats Tool: label
4936
      Add the ability to label specific sub-directories (-dirs=name[,name]+)
4937
      Allow the -up option to be used in conjunction with the  -files=xxx and
4938
      -dirs=xxx options.
4939
 
4940
    * Jats Tool: release
4941
      Corrected a problem when multiple ant builds where located within the
4942
      build view. Now all ants builds will be perform.
4943
 
4944
      Expanded the operation of the '-build=name' option such that it can be
4945
      used to limit ANT builds by specifying the name of the depends.xml file.
4946
 
4947
    * Jats Tool: CCdiff
4948
      Added utility to provide difference reports in a format suitable to be
4949
      uploaded to CodeStriker.
4950
 
4951
      Use jats CCdiff -help (or -man) for further details.
4952
 
4953
 
4954
------------------------------------------------------------------------
4955
Version: 2.71.4.cr                                Released: 30-Nov-07
4956
------------------------------------------------------------------------
4957
Major changes:
4958
    * New Platform : MOS68KRM
4959
      Building MOS for the 68K processor for Rome
4960
      Requires the Microtec 4.5R compiler
4961
      Similar to MOS68K, but has different optimization and definitions
4962
 
4963
Minor changes:
4964
    * label utility
4965
      Better handling of filenames with embedded spaces.
4966
 
4967
    * make package and install operations
4968
      Improved the error detection and reported that may occur during a file
4969
      transfer.
4970
 
4971
    * make clean up
4972
      Improved the cleanup of generated files.
4973
 
4974
    * Jats Tool: jats_transform_file
4975
      Tool that can be used within makefiles and test harnesses to perform
4976
      minor file transformations such as:
4977
        Copy, with optional rename
4978
        Force Dos or Unix style line endings
4979
        Perform simple TAG replacement
4980
 
4981
      Use 'jats jats_transform_file -help' for details
4982
 
4983
    * jats release utility
4984
      Added the -extractfiles option to extract files without leaving a view
4985
      in place.
4986
 
4987
    * escrow utility
4988
      Added -extract option to assist in creating images of all files in
4989
      the escrow, with a log file to summarize success/failure of the extraction.
4990
 
4991
------------------------------------------------------------------------
4992
Version: 2.71.3.cr                                Released: 16-Nov-07
4993
------------------------------------------------------------------------
4994
Major changes:
4995
 
4996
Minor changes:
4997
    * Makefile generation
4998
      Corrected a problem in the detection of a generated target
4999
      Some JAVA builds were not correctly detecting the need to run the
5000
      generate phase early.
5001
 
5002
------------------------------------------------------------------------
5003
Version: 2.71.2.cr                                Released: 09-Nov-07
5004
------------------------------------------------------------------------
5005
Major changes:
5006
 
5007
Minor changes:
5008
    * GBE_PLATFORM operation
5009
      Restored operation of GBE_PLATFORM. This feature is not encouraged.
5010
 
5011
    * Makefile generation
5012
      Added a sanity check to generate a warning if a file is packaged, or
5013
      installed, from more than one makefile.pl
5014
 
5015
    * Utilities gen_msproject, gen_dirlist and gen_metrics
5016
      Modified to use generic interface to the makefile data
5017
 
5018
    * AutoBuilder support tool 'save_build'
5019
      Check for users having placed locks on the build file and the autobuild
5020
      branch. The locks will be removed.
5021
 
5022
    * jats_rewrite utility
5023
      Better handling of DOS line ending under Unix
5024
 
5025
    * jats escrow utility
5026
      Can now create a simple escrow build, and information, on a Release.
5027
      Still handles an escrow based on an SBOM.
5028
 
5029
      Can be used to create an HTML report on unbuildable packages and
5030
      inconsistent packages.
5031
 
5032
    * jats make help
5033
      Corrected the list of target platforms to only show those that are
5034
      available within the current build.
5035
 
5036
    * jats makefiles
5037
      Modified the behaviour of jats when multiple instances of the
5038
      MakefileGenerate() directive are found.
5039
 
5040
      If the MakefileGenerate() directive is found in the 'common' makefile.
5041
      pl, then it will be ignored.
5042
 
5043
    * gcc toolset
5044
      SharedLibries.
5045
        The --Def=name option supports two types of def file
5046
        The 'old' form is used if the name of the Def file ends in .def
5047
 
5048
        The 'old' form is created by the existing versions of mod_if.pl
5049
        The 'new' form is created by tne new versions (daf_tools 25.1.5000.cr)
5050
        of mod_if - if the name of the file does not end in .def.
5051
 
5052
      SharedLibraries and Prog (Experimental)
5053
        New options:
5054
            --MultiScan
5055
            --NoMultiScan ( default)
5056
            MultiScan will scan the libraries until no more undefined references
5057
            can be satisfied. This may simplify linking of complex programs.
5058
 
5059
 
5060
------------------------------------------------------------------------
5061
Version: 2.71.1.cr                                Released: 16-Oct-07
5062
------------------------------------------------------------------------
5063
Major changes:
5064
 
5065
Minor changes:
5066
    PackageLib directive
5067
    The construct "PackageLib( '*', @SHLIBS, @LIBS );" now works as expected.
5068
    Packaging multiple libraries and shared libraries works as expected.
5069
    Packaging multiple shared libraries works as expected.
5070
 
5071
    MakefileGenerate directive
5072
    This directive should only be called once. JATS will now generate a warning,
5073
    and not produce an erroneous, if the directive is invoked more than once.
5074
 
5075
    Multiple Parent detection
5076
    A makefile.pl that is invoked from more than one other makefile.pl, or the
5077
    build.pl, is counted as having multiple parents. This condition is
5078
    normally treated as an error. When run by the Auto Built Tool, this
5079
    condition will be treated as a warning.
5080
 
5081
    Solaris Toolset
5082
    Added option '--WithMisalign' to the SharedLib directive.
5083
    When used in conjunction with the 'misalign' CompleOption this option will
5084
    cause a machine specific object file (misalign.o) to be included in the
5085
    link.
5086
 
5087
    Programs that are created with 'misalign' will automatically include the
5088
    misalign.o object file. The fact that shared libraries do not may be an
5089
    indication that this is a bad thing to do.
5090
 
5091
    Make and generation of subdirectories
5092
    Fixed an issue which caused created directories to have a bad timestamp.
5093
    This could result in multiple attempts to generate the source dependency
5094
    file.
5095
 
5096
------------------------------------------------------------------------
5097
Version: 2.71.0.cr                                Released: 10-Oct-07
5098
------------------------------------------------------------------------
5099
Major changes:
5100
    Makefile generation and make recursion
5101
    Extensive changes to the makefiles that are generated by JATS and method by
5102
    which JATS recuses through subdirectories during a build.
5103
 
5104
    Summary of changes:
5105
        - Removed the use of 'make' to perform recursion over subdirectories
5106
          and platforms. This has been replaced by a JATS program  that performs
5107
          the same task - only a great deal faster and with a greater scope for
5108
          flexibility.
5109
 
5110
          The user interface remains identical: jats make ....
5111
 
5112
        - Replaced the generated 'Makefile' with 'Makefile.gbe'. This is a text
5113
          file that provides sufficient information to allow JATS to locate the
5114
          interface directory and associated build information.
5115
 
5116
        - Significant speed up in determining the need to rebuild a makefile.
5117
          On a large package this has been reduced from 30+ seconds to less
5118
          than one second.
5119
 
5120
        - Significant speed up of large recursive builds through intelligent
5121
          building of the 'make_init' target. This is only processed once for
5122
          each platform type. Previously it was processed in each and every
5123
          makefile. This make target is used, internally, to perform sanity
5124
          testing of the compiler environment and to display the name of the
5125
          toolset. It is an expensive operation.
5126
 
5127
        - Intelligent speed up of large recursive through better mechanism
5128
          for creating required directories. These are now created on the fly,
5129
          rather than via a slow recursive pass though all makefiles.
5130
 
5131
        - Better makefile rebuilding
5132
          Makefiles can be rebuilt on the fly. The previous system was prone to
5133
          detecting that makefiles needs to be re-built, but then not re-
5134
          building them.
5135
 
5136
        - Detection of build file changes
5137
          The make process will detect that the build file has been modified
5138
          and that the component has not been rebuilt. This is a warning. It
5139
          does not prevent the 'make' operation.
5140
 
5141
        - Quieter make output
5142
          The 'Nothing to be done' message has been disabled.
5143
 
5144
 
5145
Minor changes:
5146
    MakeAnt Directive
5147
    Allows ANT_HOME to be a path with spaces. ie: c:\Program Files\apache-ant-1.6.5
5148
 
5149
    JATS command "debug" and "prod"
5150
    These now handle make arguments and options correctly. Thus the command:
5151
        jats prod WIN32 OPTIONS=args
5152
    Will correctly do a production build for WIN32 with command execution
5153
    display. Before, the system would attempt to process prod_OPTIONS=args.
5154
 
5155
    CSHARP toolset
5156
    Correctly detect missing compiler directories
5157
 
5158
------------------------------------------------------------------------
5159
Version: 2.70.2.cr                                Released: 27-Sep-07
5160
------------------------------------------------------------------------
5161
Major changes:
5162
 
5163
Minor changes:
5164
    Java target. Resolve problem of multiple project builds when multiple files
5165
    are generated.
5166
 
5167
    MakeAnt
5168
    If the Ant build fails JATS will terminate.
5169
    Previously JATS would continue until another error forced its termination.
5170
    This is done through a better startup of ANT using the
5171
    org.apache.tools.ant.launch.Launcher directly.
5172
 
5173
    MCR platform
5174
    Create '.mod' files from the generated THX files.
5175
    This is a MOS binary and can be download to the MCR devices.
5176
 
5177
------------------------------------------------------------------------
5178
Version: 2.70.1.cr                                Released: 20-Sep-07
5179
------------------------------------------------------------------------
5180
Major changes:
5181
 
5182
Minor changes:
5183
    MakeAnt directive extended
5184
    New option: --PackageBase
5185
        This will pass the path to all packages specified with LinkPkgArchive
5186
        directives to the build.xml file. Without the option the path will
5187
        address a 'jar' directory within the package.
5188
 
5189
    New passed parameter: PACKAGEDIR
5190
        This is the path to the output package that is being created by JATS
5191
        Allows the ant build script to place artifacts directly into the
5192
        package image being created.
5193
 
5194
------------------------------------------------------------------------
5195
Version: 2.70.0.cr                                Released: 13-Sep-07
5196
------------------------------------------------------------------------
5197
Major changes:
5198
    * Linux compiler
5199
      Changed the linux compiler used to build Embedded Linux platforms
5200
            DEVLINUX
5201
                LINUX_EMU
5202
                LINUX_ETX
5203
                ARM9TDMI
5204
 
5205
            LMOS
5206
                LMOS_LINUX_EMU
5207
                LMOS_LINUX_ETX
5208
                LMOS_ARM9TDMI
5209
 
5210
 
5211
    This is a non-backwardly compatibly release.
5212
 
5213
    Do not migrate to this version of JATS if you are building against
5214
    existing packages, until the underlying packages have been rebuilt.
5215
 
5216
    Packages created with the previous version of the compiler should not be
5217
    mixed with packages created with the version in this release.
5218
    Packages will be rebuilt with the new compiler as soon as possible.
5219
 
5220
    The new compiler will need to be installed on users VM's
5221
    The compiler package is dpkg_archive/linux_gnu_tools/1.1.0000.cots
5222
    The binary is:crosstool-gcc-4.1.1-glibc-2.5.tar.bz2
5223
    This should be extacted, as root, into / with the (one line) command
5224
         tar -xjf /net/auperaunx26/export/devl/dpkg_archive/linux_gnu_tools/1.1.0000.cots/
5225
                    crosstool-gcc-4.1.1-glibc-2.5.tar.bz2 -C/
5226
 
5227
Minor changes:
5228
    * Skipped 2.69 due to nature of major change
5229
 
5230
 
5231
------------------------------------------------------------------------
5232
Version: JATS_2.68.3                                Released: 28-Aug-07
5233
------------------------------------------------------------------------
5234
Major changes:
5235
 
5236
Minor changes:
5237
    * WIN32 CompileOptions to control use of precompiled headers
5238
      Added a WIN32 specific compiler option to control the pre compiled
5239
      headers.
5240
 
5241
        CompileOptions ('WIN32', 'PreCompileHdrs' );        (default)
5242
        CompileOptions ('WIN32', 'NoPreCompileHdrs' );
5243
 
5244
 
5245
------------------------------------------------------------------------
5246
Version: JATS_2.68.2                                Released: 28-Aug-07
5247
------------------------------------------------------------------------
5248
Major changes:
5249
 
5250
Minor changes:
5251
    * Reverted changes made in JATS_2.68.1 to the library search path
5252
      Although the search order is broken, we will need to live with it.
5253
 
5254
      Addressed the search order of /usr/lib under Solaris by adding a new
5255
      AddLibDir option (--System) to add system paths. These will be searched
5256
      last.
5257
 
5258
      For the record, the search order for header files and libraries is:
5259
 
5260
        1) As specified with AddIncDir/AddLibDir in the local makefile.pl
5261
           or within any such directive with the --Local option
5262
 
5263
        2) Within the components 'local' directories. These are populated with
5264
           InstallHdr and InstallLib directives.
5265
 
5266
        3) Within the 'interface' directory as populated by BuildPkgArchive
5267
 
5268
        4) As specified with AddIncDir/AddLibDir in the 'global' makefile.pl
5269
           or within any such directive with the --Global option
5270
 
5271
        5) Within packages specified by a LinkPkgArchive directive
5272
 
5273
 
5274
        6) As specified with AddIncDir/AddLibDir in any makefile.pl
5275
           with the --System option
5276
 
5277
    * LMOS target platform
5278
      Includes LINUX_ETX
5279
 
5280
------------------------------------------------------------------------
5281
Version: JATS_2.68.1                                Released: 24-Aug-07
5282
------------------------------------------------------------------------
5283
Major changes:
5284
 
5285
Minor changes:
5286
    * Solaris Toolset
5287
      Corrected library search order, such that /usr/lib is search after the
5288
      dependent packages.
5289
 
5290
    * RunTest operation
5291
      Added the current directory '.' to the PATH used when the test is run.
5292
 
5293
    * Csharp toolkit
5294
      .dtd files are treated as resource files too
5295
 
5296
------------------------------------------------------------------------
5297
Version: JATS_2.68.0                                Released: 20-Aug-07
5298
------------------------------------------------------------------------
5299
Major changes:
5300
    * Trap use of uncontrolled versions of 'ant' and the Java Compiler (javac)
5301
 
5302
      It was discovered that a few old makefile.pl's where invoking ant and
5303
      javac directly in order to build small Java components. This was
5304
      normally being done in the guise of the WIN32 target. These packages
5305
      were making assumptions about the version of Java on the users search
5306
      path.
5307
 
5308
      JATS can invoke ANT and build Java based components using the MakeAnt
5309
      directive and the JAVA platform. This method is controlled and
5310
      reproducible.
5311
 
5312
      This release provides changes such that these packages will not build.
5313
      This is better than building incorrectly.
5314
 
5315
      There are several aspects to the change
5316
        1) JATS provides binaries (ant and javac) with an error message. If
5317
           the user invoked ant/javac in a manner that involves searching the
5318
           PATH then these will be used and report an error.
5319
 
5320
       2) A special command (jats abt) can be used to start up the Auto Build
5321
          Tool in a manner that does not alter the PATH seen by the utilities.
5322
          Moreover it does not alter the JAVA_HOME seen by the build. This is
5323
          controlled separately.
5324
 
5325
Minor changes:
5326
    * Sanitize the PATH environment variable
5327
        Ensure the JATS bin directory is the first directory searched
5328
        Remove duplicates
5329
        Place non-existent components at the end of the PATH
5330
 
5331
------------------------------------------------------------------------
5332
Version: JATS_2.67.1                                Released: 17-Aug-07
5333
------------------------------------------------------------------------
5334
Major changes:
5335
 
5336
Minor changes:
5337
    * Makefile sanity test
5338
      Added a test to ensure that makefiles created on a machine of one type are
5339
      not then run on a machine of a different type.
5340
 
5341
      This will prevent files created on solaris-sparc being used on a solaris-
5342
      x86 machine.
5343
 
5344
    * Correct bug in RunTest
5345
      RunTest now extends the PATH to include the local bin directory
5346
 
5347
------------------------------------------------------------------------
5348
Version: JATS_2.67.0                                Released: 13-Aug-07
5349
------------------------------------------------------------------------
5350
Major changes:
5351
    * RunTest directive
5352
      Added support for running tests within the NUNIT test framework for the
5353
      CSHARP target. In the process a generalized mechanism for accessing
5354
      toolset specific test frameworks has been added.
5355
 
5356
      Changes to the directive to support a FrameWork.
5357
        The use of a test FrameWork is signaled with the option
5358
        --FrameWork=<name> If this is present then the raw name of the program
5359
        under test will be passed to the framework. program.
5360
 
5361
        If a FrameWork is in use, then JATS will invoke the specified framework
5362
        builder within the current toolset.
5363
 
5364
      When a framework is in place JATS will pass arguments of the form:
5365
        '--Tag=Text' to the FrameWork. Other options are processed as normal.
5366
 
5367
      With in the Nunit FrameWork the program under test will be a DLL Nunit
5368
      will only operate on a DLL. The DLL must have been created by the makefile
5369
      containing the RunTest directive.
5370
 
5371
      The Nunit Framework supports the following options:
5372
        --Uses=<Name>[,SubOption]+
5373
 
5374
        This option specifies other DLLs that are used by the TestDLL. They will
5375
        be copied in to the test directory, and may be sourced from an external
5376
        package or the components 'local' lib directory.
5377
 
5378
        SubOptions available to The --Uses directive are:
5379
            --NonJats       This is not a JATS built library. It will not have a
5380
                            P or D suffix.
5381
            --Jats          (Default) This is a JATS built library. JATS will
5382
                            select the correct library type for this build.
5383
 
5384
Minor changes:
5385
    * New Cache cleanup mechanism
5386
      When a package is consumed from the 'cache' a flag is updated within
5387
      the cache. The cache aging routines use this file in preference to
5388
      the descpkg file, thus it will prevent the aging of packages that are
5389
      frequently used. The aging policy can be made more aggressive.
5390
 
5391
    * Save Build Utility
5392
      This utility is used by the Auto Build System to save the 'build.pl' file
5393
      used in a ripple build.
5394
 
5395
      The utility has been enhanced to detect  a reserved checkout of the
5396
      build.pl. The checkout will be changed to unreserved - if possible.
5397
 
5398
    * Release Utility
5399
      The 'jats release' command will now unlock any labels that it locked
5400
      when an error is encountered.
5401
 
5402
      This simplifies the 'release' process as the developers label will be
5403
      unlocked if a build error occurs.
5404
 
5405
    * Jats caching local copy of itself
5406
      Fixed a bug which resulted in an "Use of individualized value" message
5407
      being displayed a large number of times during the file transfer process.
5408
 
5409
    * Minor extension to allow plug-in directives to perform a processing step
5410
      before the makefiles are created.
5411
 
5412
    * TestProg directive
5413
      TestProg's are now built in exactly the same manner as Progs
5414
 
5415
    * Correct problem introduced in 2.66.1 with packaging of files with
5416
      a 'space' or '$' in the file name.
5417
 
5418
------------------------------------------------------------------------
5419
Version: JATS_2.66.1                                Released: 20-Jul-07
5420
------------------------------------------------------------------------
5421
Major changes:
5422
    * New build target
5423
            LINUX_ETX           - Support for Linux on an ETX board
5424
            LMOS_LINUX_ETX      - Support for LMOS on the LINUX_ETX target
5425
 
5426
      These targets have also been added to the following pseudo targets.
5427
            DEVLINUX
5428
            LMOS_DEVLINUX
5429
 
5430
    * Internal utility dpkg_cache [Windows]
5431
      Modified to remove use of system utilities to perform the the file
5432
      transfer, after having problems the 'cp.exe' provided by JATS.
5433
 
5434
Minor changes:
5435
    * Added utility class to provide directory searching
5436
      To be used in JATS and JATS support tools
5437
 
5438
    * tweaks to the C# toolset
5439
      Correct problem with filename that start with "n" as in .\not_nice.cs
5440
 
5441
      Create resource files with Fully Qualified Names derived from the .resx
5442
      and .cs files.
5443
 
5444
      Handle Strong Key Names and creates wrappers to provide do the right
5445
      thing.
5446
 
5447
    * Microtec ColdFire compiler
5448
      Further attempts to get the compiler to place all of its temp files in a
5449
      local directory. The compiler uses a large number of EnVars to control
5450
      were it places temp files.
5451
 
5452
      Underlying problem is random compiler failures on big builds. Suspected
5453
      interaction with other builds.
5454
 
5455
    * Release utility command
5456
      Added a -tag=name option to allow the Auto Build Tools to create
5457
      multiple instances of a static view. The tag is used to provide a unique
5458
      component in the clearcase tag name.
5459
 
5460
------------------------------------------------------------------------
5461
Version: JATS_2.66.0                                Released: 27-Jun-07
5462
------------------------------------------------------------------------
5463
Major changes:
5464
  * Support for building CSHARP code
5465
    Natively build C# within JATS using the Microsoft command line programs
5466
 
5467
    Supports the handling of .resx files
5468
 
5469
    Supports the creation of windows programs, console programs and shared
5470
    libraries
5471
 
5472
Minor changes:
5473
  * Unit Tests
5474
    Allow test scripts to be PERL - with a .pl extension
5475
    These will be correctly initiated under WIndows and Unix
5476
 
5477
    Correct warning messsage that is generated if a "CopyIn" file is also listed
5478
    as a Script.
5479
 
5480
 
5481
------------------------------------------------------------------------
5482
Version: JATS_2.65.3                                Released: 11-Jun-07
5483
------------------------------------------------------------------------
5484
Major changes:
5485
 
5486
Minor changes:
5487
  * WINCE Support
5488
    Added WCEPA962_500 support. The WINCE target now includes this target.
5489
    Complete list of WINCE targets is:
5490
        WCEIT3000
5491
        WCEPA961
5492
        WCEPA962
5493
        WCEPA962_500
5494
        WCEPCM7220
5495
        WCEPSION_500
5496
        WCEPSPC_arm
5497
        WCEPSPC_emu
5498
        WCEX86A420
5499
        WCEX86A500
5500
        WCEX86A500_SOM4455
5501
 
5502
 
5503
------------------------------------------------------------------------
5504
Version: JATS_2.65.2                                Released: 06-Jun-07
5505
------------------------------------------------------------------------
5506
Major changes:
5507
 
5508
Minor changes:
5509
  * WINCE Support
5510
    Added WCEPSION_500 support. The WINCE target now includes this target.
5511
 
5512
  * Removed the following targets
5513
        TP5600
5514
        TP5600_ARM9TDMI
5515
        TP5600_EMU
5516
        LMOS_TP5600_ARM9TDMI
5517
        LMOS_TP5600_EMU
5518
 
5519
  * Deployment
5520
    Simplify access to build information during deployment
5521
 
5522
  * build.pl
5523
    Better error check on a packages version number.
5524
 
5525
    The --forcebuildpkg has been extended to copy files on a Unix system, rather
5526
    than to use symlinks. This simplifies remote builds.
5527
 
5528
  * Tool: gen_msprojects
5529
    Has been extended to create either a Debug build (default), or a Production
5530
    build.
5531
 
5532
        Eg: jats etool gen_msprojects -prod
5533
 
5534
  * Tool: escrow
5535
     New features
5536
     Given an rtag_id, report determine packages that are in the 'release' but
5537
     are not in the SBOM.
5538
 
5539
     Prune "patch" package versions.
5540
 
5541
     Specify packages to be ignored.
5542
 
5543
 
5544
------------------------------------------------------------------------
5545
Version: JATS_2.65.1                                Released: 30-May-07
5546
------------------------------------------------------------------------
5547
Major changes:
5548
  * Provided a mechanism by which JATS makefile.pl directives can be extended
5549
    through modules provided by external packages. This will be used to reduce
5550
    the dependancy on JATS of various packaging processes.
5551
 
5552
  * GenerateFiles
5553
    Added the options:
5554
        --UnknownPreq           - Will force the recipe to be run every time
5555
                                  the generated files are required. May be used
5556
                                  when the dependancies are too complex to
5557
                                  describe. ie: Entire directory tree.
5558
 
5559
        --AutoGenerate          - Will not force the recipe to be run during the
5560
                                  'generate' phase, unless the recipe generates
5561
                                  source files. Allows recipes to be run very
5562
                                  late. ie: when the dependent files are actually
5563
                                  required.
5564
 
5565
 
5566
Minor changes:
5567
  * GenerateFile directive
5568
    Added --Var(BuildRoot)
5569
 
5570
  * GCC Toolset
5571
    Creating Shared Libaries with a 'Def' file. The library is now dependent
5572
    on the Def file, such that changes to the Def file will cause the library to
5573
    be rebuilt.
5574
 
5575
  * MakeAnt and MakeProject directives
5576
    Preserve the order in which projects are built.
5577
 
5578
------------------------------------------------------------------------
5579
Version: JATS_2.65.0                                Released: 16-May-07
5580
------------------------------------------------------------------------
5581
Major changes:
5582
 *  Access to Release Manager and Deployment Manager databases
5583
    The database location, user and password have been made configurable via
5584
    environment variables.
5585
 
5586
    Reason: The Release Manager and Deployment Manager databases are being
5587
            moved.
5588
 
5589
    This will affect users that:
5590
        1) Use tools that access RM or DM
5591
           Some tools that build deployable packages
5592
 
5593
        2) Use the ABT system
5594
           The buildadm user, and the ABT scripts will be modified to provide
5595
           the required configuration
5596
 
5597
    If you need to use tools that access RM or DM, outside of the ABT scripts on
5598
    the build machine then you will need to add the following environment
5599
    definitions to your .profile_bash, or jats.bat.
5600
    Windows
5601
        set GBE_RM_LOCATION=jdbc:oracle:thin:@auperaora03:1521:RELEASEM
5909 dpurdie 5602
        set GBE_RM_USERNAME=RM_READONLY
5603
        set GBE_RM_PASSWORD=RM_READONLY
5710 dpurdie 5604
        set GBE_RM_URL=http://bms:8002/ManagerSuite/Release_Manager
227 dpurdie 5605
        set GBE_DM_LOCATION=%GBE_DM_LOCATION%
5909 dpurdie 5606
        set GBE_DM_USERNAME=DM_READONLY
5607
        set GBE_DM_PASSWORD=DM_READONLY
5710 dpurdie 5608
        set GBE_DM_URL=http://bms:8002/ManagerSuite/Deployment_Manager
227 dpurdie 5609
    Note: GBE_RM_LOCATION will change in the near future.
5610
 
5611
 
5612
  * New build platforms
5613
        ARM9TDMI            - To replace TP5600_ARM9TDMI
5614
        LINUX_EMU           - To replace TP5600_EMU
5615
 
5616
        LMOS_ARM9TDMI       - To replace LMOS_TP5600_ARM9TDMI
5617
        LMOS_LINUX_EMU      - To replace LMOS_TP5600_EMU
5618
 
5619
        DEVLINUX            - To replace TP5600
5620
        LMOS_DEVLINUX       - To replace LMOS_TP5600
5621
        LMOS                - New platform that expands to known LMOS targets:
5622
                              LMOS_ARM9TDMI, LMOS_LINUX_EMU, LMOS_WIN32
5623
 
5624
    Many of these targets are designed to replace the badly named platforms
5625
    of TP5600_ARM9TDMI and TP5600_EMU. These will be removed in a future
5626
    release.
5627
 
5628
    The GBE_BUILDFILTER for linux boxes may need to be changed to
5629
         LINUX_I386 ARM9TDMI LINUX_EMU LMOS_ARM9TDMI LMOS_LINUX_EMU
5630
 
5631
    The TP5600* targets should be removed to make it obvious that these packages
5632
    need to be converted.
5633
 
5634
  * Building Linux Device Drivers
5635
    The hard-coded path to the Kernel Headers has been removed.
5636
    Linux Drivers must be built with a suitable package to provide
5637
    the kernel headers. This allows multiple versions of the linux kernel to be
5638
    used for different targets platforms.
5639
 
5640
  * Sandbox support
5641
    Embryonic support for building multiple packages in a common sandbox
5642
    Will remain undocumented until fully implemented.
5643
 
5644
    New command: jats sandbox ...
5645
 
5646
Minor changes:
5647
 
5648
 
5649
------------------------------------------------------------------------
5650
Version: JATS_2.64.1                                Released: 03-May-07
5651
------------------------------------------------------------------------
5652
Major changes:
5653
  * MakeAnt directive
5654
    Added options to allow the and project to unit tests.
5655
 
5656
    New options
5657
        --AutoTest=<target>            # Run as Automated unit test
5658
        --UnitTest=<target>            # Run as Unit test
5659
 
5660
    This will invoke the ant build file, with the specified target, during the
5661
    run_unit_tests phase.
5662
 
5663
  * Sandbox support
5664
    Embryonic support for building multiple packages in a common sandbox
5665
    Will remain undocumented until fully implemented
5666
 
5667
Minor changes:
5668
  * jats build
5669
    Use platform configuration information to prune platforms from the list of
5670
    platforms that will be 'built'.
5671
 
5672
    This simplies the construction of a GBE_BUILDFILTER
5673
 
5674
    This information is not available for all supported platforms, but is
5675
    available for psuedo platforms that transform into machine specific
5676
    platforms. These include SOLARIS, LINUX, TP5600 and LMOS_TP5600
5677
 
5678
  * AVR_IAR Toolset
5679
    Clean up 9 files that may be created by the USB license dongle.
5680
 
5681
  * JATS.BAT
5682
    Example file now provides a default GBE_DPKG definition that assumes that
5683
    the "V" drive is mapped to \\auperaunx26\devl. This allows access to both
5684
    the dpkg_acrhive and the deploy_archive with the one mapping.
5685
 
5686
  * jats label
5687
    Correct problem when locking a label in a specified VOB
5688
 
5689
------------------------------------------------------------------------
5690
Version: JATS_2.64.0                                Released: 16-Apr-07
5691
------------------------------------------------------------------------
5692
Major changes:
5693
  * New build platform:
5694
        LMOS_TP5600
5695
        LMOS_TP5600_ARM9TDMI
5696
        LMOS_TP5600_EMU
5697
 
5698
    LMOS_TP5600 is a tag that will be expanded to the entire family of LMOS_TP5600
5699
    supported targets. A common alias of LMOS_T5600 will be created to
5700
    describe the group of platforms.
5701
 
5702
    LMOS_TP5600_ARM9TDMI and LMOS_TP5600_EMU
5703
    These are LMOS based targets. The 'lmos' package must be used in order to
5704
    build these targets.
5705
 
5706
    The LMOS_TP5600_ARM9TDMI can use components from the TP5600_ARM9TDMI,
5707
    where no LMOS_TP5600_ARM9TDMI components are provided.
5708
 
5709
    The LMOS_TP5600_EMU can use components from the TP5600_EMU,
5710
    where no LMOS_TP5600_EMU components are provided.
5711
 
5712
  * New build platform: WINCE
5713
    This is a tag that will be expanded to all the known WINCE targets.
5714
    Use of this platform will simplify the creation of components for
5715
    consumption on all WINCE machines.
5716
 
5717
    The current list of WINCE targets is:
5718
            WCEIT3000
5719
            WCEPA961
5720
            WCEPA962
5721
            WCEPCM7220
5722
            WCEPSION_420
5723
            WCEPSPC_arm
5724
            WCEPSPC_emu
5725
            WCEX86A420
5726
            WCEX86A500
5727
            WCEX86A500_SOM4455
5728
 
5729
    The WINCE targets actually built will be affected by GBE_BUILDFILTER.
5730
 
5731
 *  JATS makefile.pl
5732
    The package descriptor file, 'descpkg', will be packaged in all makefiles
5733
    that contain packaging directives.
5734
 
5735
    There is now no need to explicitly package the 'descpkg' file, except in
5736
    very unusual configurations.
5737
 
5738
Minor changes:
5739
  * Directive: PackageFile
5740
    Generate a warning if the source file name does not confirm to good naming
5741
    conventions. The filename must not start with a '-' and must not contain
5742
    an '='.
5743
 
5744
    Normally the result of an error in the directive. ie: "-Subdir=etc", instead
5745
    of "--Subdir=etc".
5746
 
5747
  * JATS Internal utility: cmdfile
5748
    Updated Linux and Solaris targets with a version of the cmdfile that
5749
    provides a better error message for libraries that cannot be found.
5750
 
5751
    This version will display the library search path with one item per line,
5752
    rather than all items on one, very long, line.
5753
 
5754
------------------------------------------------------------------------
5755
Version: JATS_2.63.0                                Released: 5-Apr-07
5756
------------------------------------------------------------------------
5757
Major changes:
5758
 
5759
  * JATS release command
5760
    Modified the configuration spec generated when a branching rule is
5761
    specified. The change will ensure that directories are not branched.
5762
 
5763
    Rules are:
5764
        Modify a file:      File will branch
5765
        Adding a file:      Containing directory will not branch
5766
                            File will be placed on a branch
5767
        Add a directory:    Containing directory will not branch
5768
                            New directory will branch
5769
 
5770
Minor changes:
5771
  * JATS release command
5772
    Added -noprefex option to allow the creation of a view directory without the
5773
    user name being prefixed to it. This is useful in creating an escrow view.
5774
 
5775
  * JATS label command
5776
    Detect and report parent directories that are checkedout when a label
5777
    is applied. Previously these had gone unreported.
5778
 
5779
  * JATS make
5780
    Undo previous change to preserve symbolic links while Packaging and
5781
    Installing files. A problem was encountered when a file from a package
5782
    was re-packaged.
5783
 
5784
  * JATS escrow
5785
    Added a tool to generate information for creating an escrow drop.
5786
    Use jats escrow -help for details
5787
 
5788
  * makefile.pl directive: MakeAnt
5789
    This directive will create parameters to specify the location of external java
5790
    packages that have been referenced via a LinkPkgArchive directive.
5791
 
5792
    This allows the build.xml to contruct a CLASSPATH to access JAR files in
5793
    packages, without the overhead of copying the entire package into the
5794
    interface directory.
5795
 
5796
  * build.pl directive: BuildPkgArchive
5797
    Modified the processing of 'jar' directories.
5798
    Directories of the form 'jar.<target>' will be transferred into the 'jar'
5799
    directory as seen by the package.
5800
 
5801
    Intended use: Deployment of oraclient for Solaris 10
5802
 
5803
  * JAVA 6
5804
    JATS now supports all versions of Java through the use of JAVA_HOME_X_Y
5805
    environment variables. Where X andY specify the version of JAVA.
5806
 
5807
    The jats.bat and jats.sh example files only provide indication of 1.4, 1.5
5808
    and 1.6 support, but all versions are now supported.
5809
 
5810
    The "jats vars -v" command will display all JAVA_HOME environment variables
5811
 
5812
  * Jats command: vars
5813
    Extended to show a "*" for EnvVars that do not address a valid directory
5814
    These indicate potential problems.
5815
 
5816
------------------------------------------------------------------------
5817
Version: JATS_2.62.4                                Released: 20-Mar-07
5818
------------------------------------------------------------------------
5819
Major changes:
5820
  * JATS create_dpkg + packageing shared libraries (Unix)
5821
    When a shared library is created a simple symbolic link to the versioned
5822
    libarry is also created.
5823
 
5824
    Previous versions of JATS would replace the symbolic link with a physical
5825
    copy of the file. The effect of this is that when the shared libaries is
5826
    'Installed', 'Packaged' and transferred into dpkg_archive there are two
5827
    files, instead of one file and one link to the file (in the same directory)
5828
    The Solaris shared libraries can be quite large, due to the debug
5829
    information contained within the file.
5830
 
5831
    This version of JATS will preserve symbolic links when 'Installing',
5832
    'Packaging' and transferring to dpkg_archive.
5833
 
5834
    The advantage of this will be significant reduction in disk space used
5835
    within the build environment and dpkg_archive.
5836
 
5837
  * Building Perl Modules
5838
    Modified the process to prevent the module builder attempting to modify the
5839
    documentation on the build machine.
5840
 
5841
    Integrated the 'jats clean' operation.
5842
 
5843
Minor changes:
5844
  * jats create_dpkg
5845
    Added an option to create a built.generic file
5846
    This is only used by the Automated Built Tools.
5847
 
5848
------------------------------------------------------------------------
5849
Version: JATS_2.62.3                                Released: 28-Feb-07
5850
------------------------------------------------------------------------
5851
Major changes:
5852
  * JATS JAVA build target
5853
    The default behaviour of the JAVA build target has changed such that the
5854
    default version of JAVA used will be 1.4.
5855
 
5856
    Previous behaviour was to use whichever version was specified by the EnvVar
5857
    JAVA_HOME. This was not controlled, thus the build was not controlled.
5858
    Problems occur when using the new AutoBuildTool as it uses Java 1.5 and this
5859
    is then picked up as the default version.
5860
 
5861
    If a version, other than 1.4, is required then specify it within the
5862
    build.pl file.
5863
 
5864
Minor changes:
5865
  * jats release
5866
    Ensure that the 'cleartool' command can be found in the users PATH
5867
    Issue an error if it cannot be found.
5868
    This error indicates bad DevEnv setup
5869
 
5870
    Added facility to create a view based on a config_spec, instead of a label.
5871
    Such a view cannot be used to create a release. It is intended to simplify
5872
    the creation of simple static views. The name of view is, by default,
5873
    based on the name of the config spec. Use the -view=name option to change
5874
    the name of the view.
5875
 
5876
  * GenerateFiles directive
5877
    Added new --Vars() to allow packaging of JATS plugin tools.
5878
 
5879
  * MOS Toolset
5880
    When using MOS fast intermodule calls the optimizer will preload commonly
5881
    used memory addresses into a register BEFORE the GDP has been correctly set
5882
    up. Use the following option to suppress this optimization
5883
 
5884
    Added: CompileOptions ('*', 'NoGlobalOptimization' );
5885
 
5886
 
5887
------------------------------------------------------------------------
5888
Version: JATS_2.62.2                                Released: 15-Feb-07
5889
------------------------------------------------------------------------
5890
Major changes:
5891
 
5892
Minor changes:
5893
  * JATS environment
5894
    Ensure that the true path of the Perl executable is present in the PATH
5895
    environment variable. This allows build tool access to various perl utilities
5896
    that are located in the Perl bin directory.
5897
 
5898
    Resolves issues in locating utilities such as pod2html
5899
 
5900
  * Use of GENERIC platforms
5901
    Report an error if a GENERIC platform is mixed with any other platform
5902
    specifier. GENERIC is used for packages that build on all machines because
5903
    they do not use a compiler or linker. They simply contains files that need
5904
    to be packaged.
5905
 
5906
  * Generated makefiles
5907
    Solaris and Linux: Ensure that LD_LIBRARY_PATH is exported if it is used.
5908
 
5909
  * Generating MOS THX files
5910
    Added option --BinaryImage to the SharedLib directive used to create MOS THX
5911
    files. This option will create a binary image (.bin) instead of a .thx file.
5912
    This is being used in the creation of BR Applets.
5913
 
5914
        SharedLib   ( 'MOS', "xxx", @OBJS, "--Rel=xxx.rel", "--BinaryImage" );
5915
 
5916
  * JATS release
5917
    Correct the operation of the -path option under Unix
5918
 
5919
  * JATS extract
5920
    New JATS command. This is the same as 'jats release -extract'
5921
 
5922
  * JATS Toolset
5923
    Added support for the WinCe PSION (WCEPSION_420)
5924
    This is a armv4i device using 4.20 of the WCE SDK    
5925
 
5926
 
5927
------------------------------------------------------------------------
5928
Version: JATS_2.62.1                                Released: 18-Jan-07
5929
------------------------------------------------------------------------
5930
Major changes:
5931
 
5932
Minor changes:
5933
  * jats label
5934
    Added a -vob=name option
5935
    This allwos the label utility to create, lock, unlock, rename and delete
5936
    labels without the user actually being located within the VOB. This option
5937
    cannot be used in conjunction with operations that place labels on files.
5938
    It can only be used for operations that manipulate the label.
5939
 
5940
    Added a -user=name option
5941
    This extends the operation of the -mine operation to change ownership of the
5942
    label to the named user.
5943
 
5944
  * jats release
5945
    Displays the path to the view and the build file in a user friendly manner
5946
    Under Windows it uses \, unless running under cygwin.
5947
 
5948
  * JATS build.pl
5949
    BuildProduct supports the --Uses=xxxx construct on a per-target basis.
5950
    ie:
5951
        BuildProduct ('TP5', 'LMOS_TP5600_EMU', 'LMOS_TP5600_ARM9TDMI,--Uses=TP5600_ARM9TDMI');
5952
 
5953
 
5954
------------------------------------------------------------------------
5955
Version: JATS_2.62.0                                Released: 22-Dec-06
5956
------------------------------------------------------------------------
5957
Major changes:
5958
  * GenerateFiles and RunTest directives
5959
    These directives have been extended to allow a large number of makefile
5960
    values to be added to the command lines,without resorting to knowledge of
5961
    the makefile internals. ie:
5962
        --Var(BuildName)
5963
    will be expanded to (hen building MyPackage)
5964
        -BuildName=MyPackage
5965
 
5966
    The complete list of Variables is provided in the JATS manual.
5967
 
5968
  * GenerateFiles
5969
    Added a --Clean option to allow tools to be invoked in the 'clean' phase
5970
    This allows external scripts to cleanup.
5971
 
5972
  * BuildPlatforms
5973
    Restored operation of the --Uses option
5974
 
5975
Minor changes:
5976
  * GCC Toolset
5977
    Exports path to compiler. Used by scripts to build packages
5978
 
5979
Internal changes:
5980
  * GenerateFiles
5981
    Maintains the arguments in an array for simpler processing.
5982
 
5983
    --Shell is now processed by the 'make' shell rather then invoking an
5984
    external shell. It will be the same shell, just easier to setup.
5985
 
5986
 
5987
------------------------------------------------------------------------
5988
Version: JATS_2.61.3                                Released: 14-Dec-06
5989
------------------------------------------------------------------------
5990
Major changes:
5991
  * Caching JATS
5992
    Added a mechanism whereby JATS can cache a copy of itself on the users local
5993
    drive. This is applicable to windows.
5994
 
5995
    This mechanism will allow a user to address JATS via the soft-links in
5996
    dpkg_archive and pick up the current version of JATS without the penalty of
5997
    then using JATS across a slow(network) link.
5998
 
5999
    The EnvVar GBE_CACHE_JATS controls the operation of this feature.
6000
    Set GBE_CACHE_JATS to one to enable the operation, but it will only be
6001
    effective if JATS is being run from GBE_DPKG in the first place.
6002
 
6003
    Use: Build Machines and Windows Users
6004
 
6005
Minor changes:
6006
  * Build directive: BuildAlias with --Target option
6007
    Corrected a problem when the target name is a expanded platform name (ie:
6008
    TP5600) that prevent correct expansion.
6009
 
6010
  * jats build
6011
    If the user has not configured a cache, then do not attempt to cache
6012
    packages. This will remove an annoying warning message for each package
6013
    processed by the build.
6014
 
6015
  * jats build
6016
    Modified the error messages generated when JATS fails to create the
6017
    makefiles. The previous system would report failures while creating
6018
    makefiles and, at the end of the process, it would generate a large error
6019
    message to indicate the failure. This large message diverted the users
6020
    from reading the other error messages resulting in confusion.
6021
 
6022
  * PackageFile, PackageLib, PackageProg and PackageHdr
6023
    Detect and report as an error use of the --Dir=<Path> option where the
6024
    Path is not specified.
6025
 
6026
    Most instances of this error will be where the option has been mis-used in
6027
    conjunction with a package.pl file, or during transition from using a
6028
    package.pl file. That change is detects errors where the user has specified
6029
        --Dir=$Pinc
6030
    but $Pinc is not defined.
6031
 
6032
  * Purify and Purecov under Windows
6033
    Changes to correct the operation of Rational's tools when used on the
6034
    Windows platform.
6035
 
6036
        - OPTIONS=purecov
6037
            Forces the link operations to generate the relocation table required
6038
            by 'purecov.
6039
 
6040
            Does not attempt to use purecov in the compiler tool chain
6041
            This is required under Solaris, but not Windows
6042
 
6043
        - OPTIONS=purify
6044
            Does not attempt to use purecov in the compiler tool chain
6045
            This is required under Solaris, but not Windows.
6046
            Under WIndows this option does nothing.
6047
 
6048
 
6049
------------------------------------------------------------------------
6050
Version: JATS_2.61.2                                Released: 27-Nov-06
6051
------------------------------------------------------------------------
6052
Major changes:
6053
  * makefile.pl directive Platform
6054
    This directive has been expanded to allow for the negation operation
6055
    Example:
6056
        Platform ('!MOSCF');
6057
            Process makefile for all targets other than MOSCF
6058
            This is the same as Platform ('*', '!MOSCF');
6059
 
6060
    Excluded platform will be processed after included platforms have
6061
    been determined.
6062
 
6063
Minor changes:
6064
  * Added the ScanList directive.
6065
    This directive allows a list of files within an external package to be
6066
    located at build-time.
6067
 
6068
  * Unix based systems
6069
    If the EnvVar LD_LIBRARY_PATH was undefined, then a warning would be
6070
    generated by make under some conditions. The warning has been removed.
6071
 
6072
  * MakeLinuxDriver
6073
    Added a --Define=text option to allow "defines" to be passed to the
6074
    driver being built.
6075
 
6076
 
6077
------------------------------------------------------------------------
6078
Version: JATS_2.61.1                                Released: 20-Nov-06
6079
------------------------------------------------------------------------
6080
Major changes:
6081
 
6082
 
6083
Minor changes:
6084
  * jats_rewrite tool
6085
    Handle the BuildPreviousVersion() directive.
6086
    This directive is only used within deployment scripts.
6087
 
6088
  * Internal package: RmPkgInfo
6089
    Extract modified date when extracting package information
6090
 
6091
    Added the function getDependenciesHash() to provide a hash of all the
6092
    dependancy information within a package.
6093
 
6094
    Added NO_WARN option to the classes 'new' method to supress warning
6095
    messages.
6096
 
6097
------------------------------------------------------------------------
6098
Version: JATS_2.61.0                                Released: 13-Nov-06
6099
------------------------------------------------------------------------
6100
Major changes:
6101
  * makefile.pl directives
6102
    Added directive: MakePerlModule to build and package CPAN style Perl Modules.
6103
 
6104
    Added directive: MakeLinuxDriver to build and Linux Device Driver.
6105
 
6106
    GenerateFiles.
6107
        Added option: --NoGenerate to indicate that the directive does
6108
                      not generate any tangible results. The command will
6109
                      be run on every invocation.
6110
 
6111
 
6112
Minor changes:
6113
  * Added the jats version command
6114
    Will only print out the current version of JATS
6115
 
6116
  * GCC Toolset (Used to build Linux)
6117
  Added options to allow the generation of statically linked programs.
6118
  There are two mechanism:
6119
 
6120
  Globally within the makefile.pl, or if applied in the common makefile.pl
6121
  the option can apply to all programs being built.
6122
 
6123
  CompileOptions ( 'platform', 'StaticProgs' );     - Generate static programs
6124
  CompileOptions ( 'platform', 'No_StaticProgs' );  - Default
6125
 
6126
  Within the Prog directive, the following options will override the global
6127
  default.
6128
    --Static    - Create a statically linked program
6129
    --Shared    - Create a dynamically linked program
6130
 
6131
------------------------------------------------------------------------
6132
Version: JATS_2.60.0                                Released: 03-Nov-06
6133
------------------------------------------------------------------------
6134
Major changes:
6135
  * SunWorks Toolset
6136
    Better determination of the location of the SunWorks compiler and library
6137
    Does not use an environment variable to locate compiler libraries
6138
    It is based on machine type.
6139
    Uses the absolute path to the compiler  and does not use the user's PATH
6140
 
6141
    Corrects a problem on the Solaris10 installs.
6142
 
6143
Minor changes:
6144
  * Perl DBI interface
6145
    Removed the message showing database connection
6146
 
6147
  * JATS internal library
6148
    Better handling of badly formed version numbers
6149
 
6150
------------------------------------------------------------------------
6151
Version: JATS_2.59.0                                Released: 30-Oct-06
6152
------------------------------------------------------------------------
6153
Major changes:
6154
  * GCC Toolset
6155
    Altered the mechanism used to determine cross compilation
6156
    Extended the cross compilers that can be handled by the toolset
6157
    Removed the use of `uname`.
6158
 
6159
  * Added platforms
6160
    TP5600                  ( Expands to TP5600_ARM9TDMI and TP5600_EMU )
6161
    TP5600_ARM9TDMI
6162
    TP5600_EMU
6163
 
6164
Minor changes:
6165
  * descpkg file reader
6166
    Allow handcrafted JAVA based packages that use tabs instead of spaces as a
6167
    field separator.
6168
 
6169
  * JATS eprog command
6170
    Can now start java programs encapsulated within JAR files
6171
 
6172
  * Microtec Coldfire compiler
6173
    Force the compiler to create temp files within the interface directory.
6174
    This is an attempt to solve a infrequent problem seen when multiple builds
6175
    are being performed. The 68k compiler already had a similar fix to address a
6176
    similar, but more pronounced, issue.
6177
 
6178
  * Atmel toolset (DEVI-031788)
6179
    New Products: AT90SC7272C and AT90SC3232CS
6180
        The AT90SC3232CS is identical to the existing AT3232
6181
        The AT90SC7272C replaces the (as yet unused) AT72722
6182
 
6183
    Note: Products of AT3232 and AT90SC3232CS cannot be mixed.
6184
          AT3232 is provided for backward compatibility.
6185
 
6186
------------------------------------------------------------------------
6187
Version: JATS_2.58.0                                Released: 16-Oct-06
6188
------------------------------------------------------------------------
6189
Major changes:  Directive: RunTests
6190
  * The --CopyIn option will always copy in the specified files
6191
 
6192
  * GCC Toolset (Shared Library Generation)
6193
    Added option --Def=file_name to the shared library definitions
6194
 
6195
    When compiling Shared Library objects the -fPIC flag has been added.
6196
 
6197
 
6198
Minor changes:
6199
  * JATS wrapper script
6200
    Added a sanity test to ensure that the JATS machine specific BIN directories
6201
    have been setup. When JATS is installed the PostInstall script must be run
6202
    to setup links to system programs.
6203
 
6204
------------------------------------------------------------------------
6205
Version: JATS_2.57.1                                Released: 15-Sep-06
6206
------------------------------------------------------------------------
6207
Major changes:
6208
 
6209
Minor changes:
6210
  * AT3232 toolset
6211
    Added a --Type=PayLoadType field to the Prog directive for this target
6212
    when creating .sxml files
6213
 
6214
  * Test Tool
6215
    Added: jats_lib_scan.pl
6216
    Use jats jats_lib_scan -man for detailed help
6217
 
6218
 
6219
------------------------------------------------------------------------
6220
Version: JATS_2.57.0                                Released: 12-Sep-06
6221
------------------------------------------------------------------------
6222
Major changes:
6223
  * SOLARIS toolset: CompileOptions
6224
    Added CompileOptions
6225
        misalign            - Only allowed on sparc platforms
6226
        no_misalign         - Default
6227
 
6228
        multithread         - Default
6229
        no_multithread      - Disable multithread compilation and linking
6230
 
6231
  * SOLARIS toolset: CompileOptions
6232
    Implemented the common CompileOptions
6233
 
6234
        prod_no_optimise
6235
        prod_no_debuginfo
6236
        prod_optimise
6237
        prod_debuginfo
6238
 
6239
        debug_no_optimise
6240
        debug_no_debuginfo
6241
        debug_optimise
6242
        debug_debuginfo
6243
 
6244
  * SOLARIS target: New Aliases
6245
    Provided new ALIAS based in the underlying architecture
6246
    Theses are:
6247
        SOLARIS_SPARC
6248
        SOLARIS_AMD
6249
    These may be used to limit operations to only flavor of SOLARIS. eg: The
6250
    utility 'rtc_patch_area' is only usable on sparc machines.
6251
 
6252
Minor changes:
6253
  * AT3232 toolset
6254
    Create .sxml files in conjunction with .s19 files
6255
 
6256
  * Jats build
6257
    Altered the programs help mechanism to use perl POD.
6258
    Extended the builtin help text.
6259
 
6260
------------------------------------------------------------------------
6261
Version: JATS_2.56.3                                Released: 04-Sep-06
6262
------------------------------------------------------------------------
6263
Major changes:
6264
 
6265
Minor changes:
6266
  * Utility InstallPkg as used by BuildPkgArchive()
6267
    Better dection of directories that have been processed to reduce warning
6268
    messages
6269
 
6270
  * PackageFile and PackageProg directives
6271
    The --Machine and --Tool options have been modified to allow the JATS tools
6272
    to be created in a directory that is related to GBE_MACHTYPE on which the
6273
    tool is created, rather then the target platform type.
6274
 
6275
------------------------------------------------------------------------
6276
Version: JATS_2.56.2                                Released: 28-Aug-06 
6277
------------------------------------------------------------------------
6278
Major changes:
6279
 
6280
Minor changes:
6281
  * WIN32 and WINCE toolsets
6282
    SharedLib operation. Added an option to allow the creation of a 'stub'
6283
    library without creating the body of the library:
6284
        eg: SharedLib ( 'WIN', 'MyStub' , '--Def=windef.def','--MutualDll','--Stubonly' );
6285
 
6286
 
6287
  * MOS toolsets
6288
    SharedLib operation. Added an option to allow the creation of a 'stub'
6289
    library without creating the body of the library:
6290
        eg: SharedLib ( 'MOS', 'MyStub' , '--Rel=lib.rel' , '--Implib=lib_stub','--Stubonly' );
6291
 
6292
  * JATS BIN directories
6293
    Added the program 'gmake' as a soft link.
6294
    gmake is required by some COTS packages that are being built from source
6295
    using autoconf.
6296
 
6297
  * Generate directive
6298
    The shared library search path is extended to allow the tools to locate
6299
    all shared libraies (.dll/.so) in packages and the local area.
6300
 
6301
    Simplifies the use of Xerces during the build process.
6302
 
6303
 
6304
------------------------------------------------------------------------
6305
Version: JATS_2.56.1                                Released: 23-Aug-06
6306
------------------------------------------------------------------------
6307
Major changes:
6308
  * Support for SOLARIS10_X86 and SOLARIS10_X64
6309
    Initial release.
6310
 
6311
Minor changes:
6312
 
6313
 
6314
------------------------------------------------------------------------
6315
Version: JATS_2.56.0                                Released: 18-Aug-06
6316
------------------------------------------------------------------------
6317
Major changes:
6318
  * Support for SOLARIS10_sparc32 and SOLARIS10_sparc64
6319
    Initial release.
6320
 
6321
  * Packaging directives
6322
    Added option --OsCommon to allow files and header files to be packed into
6323
    a directory known to all platforms being built for a common OS.
6324
 
6325
    Currently this is only supported to target platforms based on
6326
        SOLARIS
6327
        WIN32
6328
 
6329
  * Removal of support for badly formed packages
6330
    As of this release libraries that exist in the <packagename>/lib directory
6331
    will not be available to JATS. These libraries are in the incorrect
6332
    directory. They MUST be in a directory that indicates the intended purpose
6333
    of the library. A .so library cannot be used on all machines ( linux,
6334
    solaris-sparc, solaris-amd ... ).
6335
 
6336
  * Build Platform target name expansion facility
6337
    The build targets of SOLARIS and LINUX are seen as expandable names. They
6338
    will be expanded to suitable targets - depending on the host machine .
6339
 
6340
 
6341
Minor changes:
6342
  * Utility: JATS LABEL
6343
    Ensure that the 'cleartool' utility can be found in the users path.
6344
    Generate a suitable error message if it cannot be found.
6345
 
6346
  * Utility: JATS RELEASE
6347
    Added a -root=dirname to allow the user to place the created view at a given
6348
    location
6349
 
6350
    Added GBE_VIEWBASE to provide a globally configured mechanism for
6351
    controlling the view location. Performs the same job as -root=xxxx
6352
 
6353
  * Utility genrc
6354
    Added the company name to the copyright string
6355
 
6356
  * Utility: jats_save_build
6357
    Added option: -new
6358
    This option forces the saved file only a new branch.
6359
    The option can be used to save a build.pl file onto a new project-specific
6360
    branch. Useful when branching an entire release.
6361
 
6362
  * Utility: jats_rewrite
6363
    Added options to allow project suffixes to be replaced.
6364
    Use: Convert a .syd project to a .bej project.
6365
 
6366
 * Deprecated features: package.pl and tree.dir
6367
   These two build features are being deprecated. They are not suitable for
6368
   migration to other SOLARIS based platforms.
6369
 
6370
   The Package directives provide sufficient power to replace the package.pl
6371
   features - in a uniform manner.
6372
 
6373
 
6374
Internal Changes:
6375
  * Major rework of the JATS BuildPlatform, BuildAlias an BuildProducts
6376
    directives, together with the mechanism used to describe the platform builds.
6377
 
6378
    Introduced a CFG/<PLATFORM>.CFG file to provide:
6379
        1) Platform information available at build time
6380
        2) Dynamic platform names
6381
 
6382
  * Major rework of the 'SOLARIS' platform
6383
    The SOLARIS platform will generate one or more targets, depending on the
6384
    machine on which the platform is invoked.
6385
 
6386
    Consolidated a number of SOLARIS specific kludges and converted them into
6387
    configurable items. These kludges are really on applicable to the
6388
    SOLARIS8_SPARC32 platform. New SOLARIS builds will be well formed.
6389
 
6390
  * BuildPkgArchive operation
6391
    Formalized a number of kludges in operation of the SOLARIS8 under sparc32
6392
    platform. These are configured early in the build process and are no longer
6393
    needed.
6394
 
6395
    A side effect of this work is that files from external packages may be
6396
    located in 'SOLARIS', 'SOLARIS_sparc' or 'sparc' directories. The change
6397
    should be transparent as the consumer tools should be able to handle
6398
    files from all of these.
6399
 
6400
------------------------------------------------------------------------
6401
Version: JATS_2.55.1                                Released: 17-Aug-06
6402
------------------------------------------------------------------------
6403
Major changes:
6404
 
6405
Minor changes:
6406
  * WinCE toolset
6407
    Added support for the adv_som_4455_wlan
6408
 
6409
------------------------------------------------------------------------
6410
Version: JATS_2.55.0                                Released: 3-Aug-06
6411
------------------------------------------------------------------------
6412
Major changes:
6413
  * Jats wrapper: Specify version of JATS to be used
6414
    Added a -version=xxxx option to force JATS to use a specific version of
6415
    JATS. The same operation can be achieved by setting GBE_JATS_VERSION.
6416
 
6417
    The required version MUST be found in one of the known archives.
6418
 
6419
    JATS will attempt to cache the version of JATS to assist in speeding up
6420
    the operations.
6421
 
6422
    The version option MUST be the first option.
6423
 
6424
    The version option MUST be followed by a '--' option.
6425
    This prevents JATS parsing other options and recursion issues.
6426
 
6427
    Example:    jats -version=2.54.3.cr -- build
6428
 
6429
  * Migrated the "jats install" functionality out of the jats wrapper script
6430
    and into the create_dpkg utility. This is transparent to the user.
6431
 
6432
  * Utility: create_dpkg
6433
    Added a '-quiet' option to allow use within scripts
6434
    Extended the built-in help
6435
    Added useful error messages
6436
    Migrate code to a common error reporting mechanism
6437
 
6438
  * WinCE toolset
6439
    Added support for the WCEPA962 target.
6440
 
6441
  * M16 toolset as used in building MCRFirmware
6442
    Added a --MotOnly option to the Prog directives. MOT files 
6443
    are used in the creation of bootstraps.
6444
 
6445
Minor changes:
6446
  * JATS wrapper script
6447
    Added a -ABT=xxx option to allow the Auto Build Tool to be invoked from
6448
    the command line.
6449
 
6450
  * Utility: jats_rewrite
6451
    Modified so that it will display changes. These will then be present in the
6452
    ABT log so that a developer can see which packages have been rippled.    
6453
 
6454
Internal Changes:
6455
  * Common Error Reporting
6456
    Will use environment variables to control DEBUG and VERBOSE levels
6457
    for individual users. A module reporting with a name of XXXX will use EnvVars
6458
    of GBE_XXXX_VERBOSE and GBE_XXXX_DEBUG to control the debug and VERBOSE
6459
    level.
6460
 
6461
    Force flushing after a "Question" is asked to ensure that the prompt is
6462
    displayed.
6463
 
6464
    Enable autoflush for both STDOUT and STDERR.
6465
 
6466
  * Added JatsSystem module
6467
    Common code for accessing system commands        
6468
------------------------------------------------------------------------
6469
Version: JATS_2.54.3                                Released: 17-Jul-06
6470
------------------------------------------------------------------------
6471
Major changes:
6472
 
6473
Minor changes:
6474
  * BR Compiler toolset
6475
    Add the include file search path to the link command line. Allows
6476
    .def files to include other files.
6477
 
6478
  * IAR toolset
6479
    Added AT7272 support
6480
 
6481
  * Tool: jats_manifest
6482
    Added links to a suitable md5sum program on target platforms
6483
 
6484
------------------------------------------------------------------------
6485
Version: JATS_2.54.2                                Released: 12-Jul-06
6486
------------------------------------------------------------------------
6487
Major changes:
6488
 
6489
Minor changes:
6490
  * BR Compiler toolset
6491
    Corrected a problem in flagging that the non-version-1 compiler was in
6492
    use.
6493
 
6494
 
6495
------------------------------------------------------------------------
6496
Version: JATS_2.54.1                                Released: 29-Jun-06
6497
------------------------------------------------------------------------
6498
Major changes:
6499
 
6500
Minor changes:
6501
  * Mictotec toolset
6502
    Assembler files. Define DEBUG in debug builds and NDEBUG in production
6503
    builds.
6504
 
6505
  * JATS Core
6506
    Added GBE_ABT. This is used by the Auto Build Tool to indicate that an
6507
    auto build is in progress. It may be used by various tools to modify their
6508
    behaviour.
6509
 
6510
------------------------------------------------------------------------
6511
Version: JATS_2.54.0                                Released: 22-Jun-06
6512
------------------------------------------------------------------------
6513
Major changes:
6514
  * Removal of non-core deployment functionality from JATS.
6515
    Deployment package will be affected.
6516
 
6517
    The build.pl file of deployment package will need to import deployment
6518
    support with a BuildPkgArchive directive. ie:
6519
 
6520
        BuildPkgArchive ( 'deployfiles', '1.0.0.cr' );
6521
 
6522
    This version of deployfiles contains the same functionality as that provided
6523
    by the previous version of JATS. Version 2 of this package will be the start
6524
    of a deployment system that will provide support for building InstallShield
6525
    packages.
6526
 
6527
 * Deployment support utilities must be run under JATS
6528
   The environment required for the deployment support utilities is complex
6529
   and is provided by the JATS wrapper script.
6530
 
6531
   This is a change in usage. Instead of running the program 'updatenodespec'
6532
   the user will need to run 'jats updatenodespec'
6533
 
6534
Minor changes:
6535
  * SubDir directive
6536
    Added a sanity test to detect the case when a 'SubDir' directive specifies
6537
    a directory from two different makefiles.
6538
 
6539
  * Tools: Dependancy generator mkdepend
6540
    If an include file was referenced by a symbolic name, then the generated
6541
    dependancy information would be wrong for all but the first occurrence
6542
    of the file usage.
6543
 
6544
  * New utility: jats_manifest
6545
    Used by the build system to generate and validate source files.
6546
    Beta Release: Windows only at the moment
6547
 
6548
  * Unit tests under SOLARIS_sparc
6549
    The LD_LIBRARY_PATH has been modified to correctly pick up libraries
6550
    generated within the build and have been installed locally.
6551
 
6552
  * Default behaviour of JATS the wrapper script
6553
    This has been changed. Previous unknown commands were passed to make.
6554
    In this release unknown comamnds will be treated a 'etool' commands and 
6555
    will execute a JATS extended command.
6556
 
6557
 
6558
Internal Changes:
6559
  * Code refactor
6560
    Created JatsEnv to encapsulate functionality that was multiply defined.
6561
 
6562
  * Deployment utilities
6563
    The Perl module Ignorelist.pm and the .ccignore file
6564
    Changed the mechanism by which this module locates a .ccignore file.
6565
    The .ccignore file has been moved to the same directory as the module and
6566
    the module can locate the file.
6567
 
6568
    Previously the module required an environment variable in order to locate
6569
    the file, which was in a fixed location anyway.
6570
 
6571
  * JATS core
6572
    Removed the use of the environment variable PERLINC.
6573
 
6574
    Better parsing of descpkg files.
6575
 
6576
  * JATS core debugging: JatsError.pm
6577
    Allow control over the debug and verbose messages of specific programs
6578
    through the use of environment variables.
6579
 
6580
    A program reporting errors as "name" can be controlled via environment
6581
    variables GBE_name_VERBOSE and GBE_name_DEBUG.
6582
 
6583
  * BuildPkgArchive operation
6584
    Modified the subdirectories transferred with this directive to include:
6585
        deployfiles     - as used by the deployment system
6586
        tools/scripts   - as used by perl based extensions
6587
 
6588
  * Make environment
6589
    Extended the PERL5LIB path seen by perl programs executed under make to
6590
    include 'tools/script' directories that contain Perl Modules.
6591
 
6592
 
6593
------------------------------------------------------------------------
6594
Version: JATS_2.53.2                                Released: 13-Jun-06
6595
------------------------------------------------------------------------
6596
Major changes:
6597
  * Deployment. GetMassInstId.rul (From George Christidis)
6598
    Added support for SILENT_MODE
6599
 
6600
 
6601
------------------------------------------------------------------------
6602
Version: JATS_2.53.1                                Released: Not release
6603
------------------------------------------------------------------------
6604
 
6605
Not Released.
6606
This label waas used as a place keeper. This version was not used as a basis
6607
for JATS_2.53.2. Its much closer to JATS_2.54.0.
6608
 
6609
 
6610
------------------------------------------------------------------------
6611
Version: JATS_2.53.0                                Released: 11-Apr-06
6612
------------------------------------------------------------------------
6613
Major changes:
6614
  * Deployment Scripts: Release Manager Database Access
6615
    The mechanism for communicating with the Release Manager Database has been
6616
    radically replaced.
6617
 
6618
    A test tool has been added to prove connectivity to Release Manager.
6619
    Usage:
6620
        jats etool test_rmconnection
6621
 
6622
    The pervious scripts used DBI::ODBC to communicate with the Oracle
6623
    Database that contains Release Manager. There were a number of problems with
6624
    this solution:
6625
         - Required the installation of two Perl Modules
6626
         - Required the installation of an Oracle client
6627
         - Required the use of an ODBC bridge machine when used on Solaris
6628
         - Support for Perl within Oracle appears to be on the decline
6629
 
6630
    The solutions uses a Java application and Java's jdbc. The oracle:thin
6631
    client is used as this does not require any installation or configuration in
6632
    order to work.
6633
 
6634
    JATS overrides Perl's DBI package with a package of the same name, but
6635
    reduced functionality.
6636
 
6637
 
6638
Minor changes:
6639
  * makefile.pl directive: SetValue
6640
    Added a '--' option to disable and enable parsing of options.
6641
    This allows a value with leading '--' to be set.
6642
 
6643
  * makefile.pl directive: SetList
6644
    Added this directive to formalise the creation and processing of lists
6645
    within the makefiles.
6646
        Options:
6647
            --NoWarn                    Disable name clash warnings
6648
            --Project=xxxx[,xxxx]+      Add to list in selected projects
6649
            --Unique                    Add only if not already present
6650
            --Clear                     Clear list, before adding new items
6651
            --Append                    Append items to list (default)
6652
            --                          Disable/Enable option parsing
6653
        Useage:
6654
 
6655
    SetList ('*', 'LibList', 'lib1', 'lib2', '--Project=syd');
6656
    SharedLib ('*', 'MyDLL', @OBJS, @LibList );
6657
 
6658
  * Makefile.pl directive: RunTest
6659
    Corrected the option of the --CopyIn=file option where the specified file
6660
    is not in the current directory.
6661
 
6662
  * Jats Command: ant'
6663
    This command has been extended to make use of the -buildfile=xxxx option
6664
    to allow multiple buildfiles to be differentiated.
6665
 
6666
    eg: jats -buildfile=MyPackage ant
6667
 
6668
  * TOOLSET: DAFBR Compiler support
6669
    Modified the toolset to support an optimisation feature of the next
6670
    generation of the daf_br_compiler. These will be enabled if the major version
6671
    of the package containing the compiler is greater the "1". ie: 2.0.0.cr
6672
 
6673
  * Interface helper files: set_XXXX.bat/.sh
6674
    Added provision to process user command arguments.
6675
    Thus
6676
 
6677
        set_WIN32.bat prog
6678
 
6679
    will set the WIN32 environment and run the command: prog
6680
 
6681
 
6682
------------------------------------------------------------------------
6683
Version: JATS_2.52.2                                Released: 30-Mar-06
6684
------------------------------------------------------------------------
6685
Major changes:
6686
 
6687
Minor changes:
6688
  * Addressed issue with BUILDNAME, an internal variable.
6689
    Due to the use of these 'raw' values in user build.pl's they need to be
6690
    maintained. Previously the values may or may not have had a project
6691
    extension. It was bad. Now:
6692
        $(BUILDNAME) contains two or three space seperated fields - always
6693
 
6694
  * m16c Toolset - MCRFirmware
6695
    Force the generation of .thx and payload files when the .bin files are
6696
    created. Previously this only occured in the packaging phase.
6697
 
6698
Internal changes:
6699
  * JATS toolsets
6700
    Added a feature to allow a toolset to flag additional files that get created
6701
    as a part of a "Prog". This allows a "Prog" definition to generate a
6702
    number of files, some which may be packaged.
6703
 
6704
    Previously such files where only generated during the packaging phase. Now
6705
    they will be generated during the make_prog phase - with the other programs.
6706
 
6707
------------------------------------------------------------------------
6708
Version: JATS_2.52.1                                Released: 29-Mar-06
6709
------------------------------------------------------------------------
6710
Major changes:
6711
  * Jats command: etool
6712
    Extended to allow execution of deployment tools. This allows the deployment
6713
    tools to use the JATS core perl modules.
6714
 
6715
  * Address issues with the use of BUILDVER and ScmBuildVer
6716
    Due to the use of these 'raw' values in user makefile.pl's they need to be
6717
    maintained. Previously the values may or may not have had a projectt
6718
    extension. It was bad. Now:
6719
        $(BUILDVERSION) contains the project extension - always
6720
        $ScmBuildVersion does not contain a project extension - always
6721
 
6722
Minor changes:
6723
 
6724
 
6725
------------------------------------------------------------------------
6726
Version: JATS_2.52.0                                Released: 27-Mar-06
6727
------------------------------------------------------------------------
6728
Major changes:
6729
  * JATS environment variables
6730
    Added GBE_DPKG_STORE
6731
        Optionally addresses a dpkg_archive store. This is intended to allow
6732
        read only access to a remote repository. The GBE_DPKG_STORE will be
6733
        searched after GBE_DPKG. It will be searched last. JATS, be default,
6734
        will not publish packages in this repository.
6735
 
6736
        Uses: Seed repository for a complete build
6737
              Remote repository
6738
 
6739
    Added GBE_DPLY
6740
        Optionally addresses a Deployment Archive. This is only used in the
6741
        placement of deployment packages. This value may be project specific.
6742
 
6743
  * MOS_MRI toolset
6744
    Changes the mechanism used to link against the compiler RTL.
6745
    Previously the RTL was included multiple times in the link order. This
6746
    created problem with daf_dsi as the function 'time()' was being satisfied by
6747
    the RTL before being satisfied by the user libraries.
6748
 
6749
    The compiler RTL is now treated as a library of last resort. It will be
6750
    processed once and it will be processed last.
6751
 
6752
 
6753
Minor changes:
6754
  * JATS utility: build
6755
  * JATS utility: cache_dpkg
6756
    Extended the package search algorithm to locate a package within
6757
    GBE_DPKG_STORE. This archive will be searched last.
6758
 
6759
  * JATS utility: gen_cots
6760
    Ensure label is not locked
6761
    Add option to allow user to specify source directory other than a package
6762
    that already exists in dpkg_archive.
6763
 
6764
  * JATS directive: PackageFile
6765
    Now supports --Prod and --Debug options to limit the packaging process
6766
    to a specific type of build.
6767
 
6768
  * JATS directive: GenerateFiles and RunTests
6769
    Added a --PackageInfo() replacement tag to allow package version information
6770
    to be extracted and passed to generator programs.
6771
        ie: --PackageInfo(sysbasetypes,syd,--fullversion)
6772
 
6773
    Extended the --PackageBase() replacement tag to work with packages such as
6774
    sysbasetypes, where there is a .cr and a .syd type.
6775
        ie: --PackageBase(sysbasetypes,syd)
6776
 
6777
  * JATS utility: release
6778
    Under windows, ensure that the directory C:\Clearcase exists. There have
6779
    been installations of Clearcase where this is directory does not exist.
6780
 
6781
  * JATS utility: label
6782
    Added option: "-comment=Text" to allow a comment to be added to a label,
6783
    when it is being created.
6784
 
6785
Internal Changes
6786
  * JATS utility: create_dpkg
6787
    Refactored code to use JATS DescPkg class.
6788
 
6789
    Added options to allow packaging to the various archives. This is of no use
6790
    to the normal developer, but will be used within the complete build system.
6791
 
6792
  * Factored out the parsing of the BuildName directive
6793
    This process was being done in 3 locations - and there were getting
6794
    different results.
6795
 
6796
  * ToolsetRequire directive
6797
    This has been extended to allow JATS to locate Toolset extensions within
6798
    packages. They should be placed within the tool/scripts directory
6799
 
6800
------------------------------------------------------------------------
6801
Version: JATS_2.51.0                                Released: 15-Mar-06
6802
------------------------------------------------------------------------
6803
Major changes:
6804
 
6805
  * MCR toolset
6806
    Generate CD payload files in conjunction with the .BIN files
6807
 
6808
------------------------------------------------------------------------
6809
Version: JATS_2.50.0                                Released: 15-Feb-06
6810
------------------------------------------------------------------------
6811
Major changes:
6812
  * WIN32 utilities
6813
    Replaced a number of the Windows utilities ( cp, rm, mv ...)
6814
    with versions from the GNUWin32 project.
6815
 
6816
    The 'cp' previously used could not recursively copy large directories
6817
    under Windows Server 2003, when both the source and destination are on the
6818
    same drive. ( dpkg_cache of ace ).
6819
 
6820
Minor changes:
6821
  * BuildVersion
6822
    The definition of VERSION_BUILD within the generated version-defs.h file
6823
    will have leading zeros removed, thus allowing it to be used within a 'C'
6824
    program without the number being interpreted as an octal constant.
6825
 
6826
    The string form (VERSION_BUILD_STR) will retain the zeros.
6827
 
6828
  * Unix Builds
6829
    Corrected several issues encountered when specifying the name of a static
6830
    library or a shared library.
6831
 
6832
    JATS will prepend 'lib' to the user specified library name. Problems occurred
6833
    when the user specified a library name that started with 'lib'. Now, on Unix
6834
    systems, JATS will only prepend 'lib' if the library name does not already
6835
    start with 'lib'.
6836
 
6837
  * BuildPkgArchive
6838
    Since 2.45.0 JATS will only transfer files for the BuildPkgArchive, if
6839
    they have not already been transferred. Added a test for the source
6840
    package being updated and then forceing the copy to be repeated.
6841
 
6842
------------------------------------------------------------------------
6843
Version: JATS_2.49.0                                Released: 10-Feb-06
6844
------------------------------------------------------------------------
6845
Major changes:
6846
  * MOS_MRI toolset
6847
    Corrected a problem with the dependencies between a .REL file and the target
6848
    THX file. If the .REL files was modified the output THX file did not get
6849
    regenerated. This was only a problem in cases where the .REL file was
6850
    being manually maintained.
6851
 
6852
 
6853
Minor changes:
6854
  * MakeAnt directive
6855
    Introduced a check to ensure that this directive is only used with a toolset
6856
    that can handle an 'ant' build file. Currently only the JAVA toolset
6857
    supports ANT builds.
6858
 
6859
  * BuildPkgArchive directive
6860
    Correct problem in the caching of BuildPkgArchive packages in the case where
6861
    there is no GBE_DPKG_LOCAL on the machine.
6862
 
6863
  * Label utility
6864
    Added a 'files=filename,filename' option to allow only specified
6865
    files to be labeled.
6866
 
6867
  * Build. Parsing descpkg files
6868
    Corrected problem in which Java Manifest files were not parsed correctly
6869
    on Solaris.
6870
 
6871
  * Generated makefiles
6872
    Fix a bug with the CompilerOptions that allowed a '0' definition to be set to
6873
    nothing.
6874
 
6875
  * MOS Toolset
6876
    Added 'CompileOptions' of CcSupervisor.
6877
    This will set a MOS internal definition suitable for building specialised
6878
    modules.
6879
 
6880
  * Utility: gen_cots
6881
    This utility will create a JATS buildable package froma dpkg_archive entry
6882
    and then check it in under clearcase.
6883
 
6884
    JATS etool gen_cots -man will provide only help.
6885
 
6886
  * Utilty cache_dpkg
6887
    Detect and repair incomplete copy operations.
6888
 
6889
------------------------------------------------------------------------
6890
Version: JATS_2.48.0                                Released: 24-Jan-06
6891
------------------------------------------------------------------------
6892
Major changes:
6893
  None
6894
 
6895
Minor changes:
6896
  * DEVI addressed
6897
    DEVI-022055 JATS builds DLLs with wrong copyright symbol in version resource
5710 dpurdie 6898
    DEVI-022054 JATS puts "VIX Group test" in Product Name of Windows resource
227 dpurdie 6899
 
6900
  * Utility: release (cbuild)
6901
    Added an option to create a view configured to work with a branching
6902
    rule. A single branch can be named with the -branch option. eg:
6903
 
6904
        jats release -extract 'label' -branch SITS_LEGACY_BRANCH
6905
 
6906
    will create a view based on the named label, but suitable for creating
6907
    a patch for Sydney Legacy work.
6908
 
6909
  * RunTest directive
6910
    The 'PATH' that the test uses is extended to allow access to programs that have
6911
    been installed with a InstallProg directive. This allows a test script to
6912
    test a program that is generated elsewhere within the package.
6913
 
6914
  * PackageFile, Option --DirTree
6915
    Support for filenames that contain a "$" or a ' ' within the
6916
    --DirTree option. Implemented to allow entire JAVA class trees to be
6917
    packaged under JATS
6918
 
6919
    Note: In general the use of a $ and space within a filename is not
6920
          supported within JATS.
6921
 
6922
  * Jats utility wrapper
6923
    Added an eprog option. The allows any program to be run within the
6924
    sanitized environment provided by JATS.
6925
 
6926
    The specified program may be in the current directory or the user's
6927
    PATH. If the program is a perl script then it will be run with the
6928
    JATS perl interpreter, otherwise it will be processed by the system.
6929
 
6930
    Eg: jats eprog myscript arg1 arg2
6931
    Eg: jats ant
6932
 
6933
  * Jats utility wrapper
6934
    Added an 'ant' command. ( "jats ant" )
6935
 
5710 dpurdie 6936
    This will run an VIX ANT build by scanning the current directory for a file
227 dpurdie 6937
    called <ProjectName>depends.xml and then looking the a file called
6938
    <ProjectName>.xml. Jats will then create 'auto.xml' based on the
6939
    <ProjectName>depends.xml file and use ant to invoke the
6940
    <ProjectName>.xml file.
6941
 
5710 dpurdie 6942
    If the VIX build files cannot be found then ant is simply run and it will
227 dpurdie 6943
    expect a build.pl file.
6944
 
6945
  * Jats utility wrapper
6946
    Force the environment variable PERL5INC to be unset.
6947
 
6948
  * Jats utility: create_dpkg
6949
    Simplify handling of ANT based projects. Look for the package within
6950
    the build/pkg subdirectory, in the JANTS style.
6951
 
6952
  * Utility: gen_winrc (DEVI-022054)
6953
    Added a "'-product=text'" option to allow the product name to be specified.
6954
 
6955
  * Build files
6956
    Handle the java generated descpkg files. These are a Manifest format with
5710 dpurdie 6957
    VIX extensions.
227 dpurdie 6958
 
6959
------------------------------------------------------------------------
6960
Version: JATS_2.47.0                                Released: 20-Dec-05
6961
------------------------------------------------------------------------
6962
Major changes:
6963
  * BuildVersion directive in build.pl
6964
    Correct a problem in the generation of version.c
6965
    The function GetModuleInfo() would return a string with a trailing
6966
    space when the 'array' mode was selected.
6967
 
6968
    This may cause module validation to fail.
6969
 
6970
Minor changes:
6971
  * None
6972
 
6973
------------------------------------------------------------------------
6974
Version: JATS_2.46.0                                Released: 08-Dec-05
6975
------------------------------------------------------------------------
6976
Major changes:
6977
  * BuildProduct and BuildPlatforms directives
6978
    Added option --Uses=NAME
6979
    ie:
6980
        BuildProduct    ( 'OBFTP,--Uses=TP5',    'MOSCF' );
6981
 
6982
    This will create a OBFTP_MOSCF platform that will 'use' TP5
6983
    headers and libraries if none are specifically provided for the
6984
    OBFTP. It is the users responsibily to ensure that the two build
6985
    environments are compatible.
6986
 
6987
 
6988
Minor changes:
6989
  * BuildName option
6990
    Modifications to allow the creation of COTS packages with buildnames
5710 dpurdie 6991
    that do not confirm to the VIX naming scheme (--RelaxedVersion).
227 dpurdie 6992
 
6993
  * jats.bat
6994
    Ensure that GBE_BIN is not defined
6995
    It will be set by the jats.pl to a fully qualified path.
6996
 
6997
------------------------------------------------------------------------
6998
Version: JATS_2.45.0                                Released: 29-Nov-05
6999
------------------------------------------------------------------------
7000
Major changes:
7001
  * BuildPkgArchive directive
7002
    The operation of the BuildPkgArchive directive has been modified
7003
    so that a package will only be installed once. This significantly
7004
    speeds up multiple 'build' operations.
7005
 
7006
    If the package is being extracted from the 'local archive', then
7007
    this mechanism is suppressed as packages in the local archive are
7008
    considered as under development and are subject to change.
7009
 
7010
    If package cache is being refreshed, then the package will be
7011
    installed a second time. Thus it is possible to force the package to
7012
    be transferred into the 'interface' directory.
7013
 
7014
    A BuildTags directory is used to track packages that have been
7015
    transferred.
7016
 
7017
  * Internal changes to factor common code into a group of packages.
7018
    See notes below.
7019
 
7020
  * WIN32 toolset
7021
    Allow the Microsoft preprocessor directive #import to operate
7022
    correctly.
7023
 
7024
    Export the complete library search path into the build environment
7025
    for all Microsoft command, not just the linker and library commands.
7026
 
7027
  * BuildVersion
7028
    Modifications to allow the generation of version files for C#
7029
    The mechanism has been extended to allow version information for
7030
    other langauges as needed.
7031
 
7032
 
7033
Minor changes:
7034
  * Utility: gen_winrc.pl
7035
    Will extracted build number from the patch number, if present.
7036
    This information will be available to be placed into the generation
7037
    version strings.
7038
 
7039
  * GenerateFiles directive
7040
    Fixed a problem detecting programs that were not in the local
7041
    package or an imported package.
7042
 
7043
  * Toolsets: MOS_MRI
7044
    Generate an error if required tools are not found.
7045
    Previously this condition would generate a warning.
7046
 
7047
  * BuildPkgArchive and LinkPkgArchive directives
7048
    Ensure that packages are only included once. The previous check
7049
    was half-hearted and could allow multiple packages of the same
7050
    version to be included. This could result in badly formed
7051
    makefiles and strange error messages.
7052
 
7053
Internal Changes
7054
  * Started to factor out internal packages and place them into a common
7055
    directory. This will allow common error handling thoughout the suite
7056
    of utilities.
7057
 
7058
    Modified all utilities to utilize the common error reporting
7059
    functions.
7060
 
7061
------------------------------------------------------------------------
7062
Version: JATS_2.44.0                                Released: 18-Nov-05
7063
------------------------------------------------------------------------
7064
Major changes:
7065
  * Generated makefiles
7066
    Modified the windows shell to remove the use of the EXTENDED_LINE
7067
    cache. This did not work. Modified the extend.lst file to ensure
7068
    that sed did not process its arguments.
7069
 
7070
    This has been done to address a problem seen within test scripts
7071
    within unit tests that use wildcard expansion. The windows shell was
7072
    incorrectly processing:
7073
        sed '-es~.*WIN32~~'
7074
    The '.*' construct was being seen as a wildcard and the shell was
7075
    then putting the argument into a command file - it was totally
7076
    confused.
7077
 
7078
    NOTE: Attempted to remove use of EXTENDED_LINE, but this caused a
7079
    breakage with the DOS based gcc compiler( ie:H8S and others).
7080
    The construct
7081
        -D__SOURCE__=\"name\"
7082
    was corrupted somewhere. If the command is put in a command file,
7083
    then it works.
7084
 
7085
  * MakeAnt directive
7086
    Added option: --GeneratedFile=PathOfFile
7087
 
7088
    This option has the following effects
7089
        1) Marks the file a source file. It is then known to JATS and
7090
           can be used installed and manipulated.
7091
 
7092
        2) Schedules the processing of the ANT build to be done
7093
           early - in the generated files phase.
7094
 
7095
    Intended use. The creation of packages with a JNI. The Java
7096
    component needs to generate a header file early.
7097
 
7098
 
7099
Minor changes:
7100
  * JATS post-installation script
7101
    Flag deployment tools and libraries as executable.
7102
 
7103
  * Detection of extension type is case insensitive for non-unix
7104
    systems. Thus *.h and *.H files will considered header files in
7105
    windows.
7106
 
7107
  * Build.pl rewrite tool
7108
    Handle all variants of BuildName
7109
 
7110
  * Jats wrapper script
7111
    Generate an error if the JATS configuration variables are not usable
7112
        1) Contain spaces
7113
        2) Start with a // - Remote drives must be mapped
7114
 
7115
  * Toolset
7116
    Added a 'LINUX' platform.
7117
 
7118
  * JAVA toolset
7119
    Ensure the that build file passed via MakeAnt contains the following
7120
    directive:
7121
 
7122
        includeAntRuntime="off"'
7123
 
7124
    This MUST be used to ensure that ANT's classpath is not passed to
7125
    the java compiler thus ensuring that the compiler does not use ANT's
7126
    version of any JAR files that have not been specified by the user.
7127
 
7128
  * GCC Toolset
7129
    Use -Map name to create map files as needed for GCC under Debian
7130
 
7131
  * Makefile generation
7132
    When packages are used by name to resolve package location JATS
7133
    has been modified to use the package name specified by the user.
7134
    Previously JATS would use the package name found within the
7135
    descpkg file. In cases where the descpkg file was badly formed the
7136
    package could not be used.
7137
 
7138
  * Unit Tests
7139
    The following environment variables are set:
7140
 
7141
        GBE_TYPE    - The type of build. Debug or production. This
7142
                      will be set to either a 'P' or 'D'
7143
 
7144
        GBE_HOST    - The host machine we are running on.
7145
                      This will be set to 'WIN' or Unix'
7146
 
7147
    These variable should assist in the production of test scripts.
7148
 
7149
  * New makefile.pl directive: SetValue
7150
 
7151
 
7152
------------------------------------------------------------------------
7153
Version: JATS_2.43.0                                Released: 01-Nov-05
7154
------------------------------------------------------------------------
7155
Major changes:
7156
  * New Platform : "MCR" using the Mitsubishi m16c compiler.
7157
 
7158
    Special features of this toolset.
7159
    1) A .THX source file will be converted to an obtect file
7160
       This allows processing of fonts within a THX file to be
7161
       incorporated within the target image.
7162
 
7163
    2) Prog directive extensions:
7164
       --Set=Name=Value
7165
                The 'Name' is set to 'Value' at link time.
7166
                This allows the location of program segments to be set
7167
 
7168
       --Ref=name
7169
                The name of a Release file. If provided, it will be used
7170
                to provide information that will be placed within the
7171
                THX header. The version number will be ignored. It
7172
                will be taken from the build version number.
7173
 
7174
Minor changes:
7175
  * MOS Toolset
7176
    Create the VisionClick files when the THX file is created.
7177
    Previously the files were created when the THX was installed or
7178
    packaged.
7179
 
7180
  * Src directive
7181
    No generates a warning if no source files are located within the
7182
    directive. This is normally the result of a missing platform
7183
    specifier.
7184
 
7185
  * WIN32 runtime support
7186
    Added the following 'Unix' style utilities to assist in testing.
7187
        1) od       - dump files in octal and other formats
7188
        2) cmp      - compare two files byte by byte
7189
 
7190
Internal:
7191
    Added an extension to allow the target toolset to handle the "Prog"
7192
    dependancy generation if required. This allow complex program
7193
    generation mechanisms to be handled by the toolset.
7194
 
7195
------------------------------------------------------------------------
7196
Version: JATS_2.42.0                                Released: 19-Oct-05
7197
------------------------------------------------------------------------
7198
Major changes:
7199
    * BuildAlias directive
7200
      Added options.
7201
        --Define        - Does not create implicit platforms
7202
        --Target        - Redeclares the alais as the list of all
7203
                          platforms that are based on a given target or
7204
                          targets.
7205
      Eg:
7206
        BuildAlias      ( 'LMOS,--Target', 'LMOS_WIN32', 'LMOS_linux_armv4' );
7207
        BuildProduct    ( 'GAK',    'LMOS', 'MOS68K', 'MOSCF' );
7208
        BuildProduct    ( 'PCP',    'LMOS', 'MOS68K' );
7209
 
7210
      Will export an alias of LMOS that can be used within makefile.pl's
7211
      that will be the list of all platforms that have a target of
7212
      'LMOS_WIN32' or 'LMOS_linux_armv4'.
7213
 
7214
      Note the dual use of LMOS within the example. This is intentional.
7215
      The LMOS alias is used within the BuildProduct to simplify the
7216
      specification of all the LMOS targets.
7217
 
7218
 
7219
Minor changes:
7220
  * Label utility
7221
    Will generate a warning message if it labels more than one
7222
    build.pl file
7223
 
7224
  * Package directives. PackageFile.
7225
    Corrected a problem with wildcard expansion in which a --FilterIn
7226
    needed to be specified in order for the --FilterOut to operate.
7227
    Now all files in the tree are considered 'in' unless modified by the
7228
    --FilterIn option.
7229
 
7230
  * jats release (cbuilder) utility
7231
    Correct use of the -prodOnly and -debugOnly flags.
7232
    The full name was not accepted; -debug and -prod was.
7233
 
7234
  * Location of descpkg file
7235
    All makefile.pl's now know where the package descpkg file was
7236
    created. This simplifies the process og packaging this file as it
7237
    can be done within any makefile.pl.
7238
 
7239
------------------------------------------------------------------------
7240
Version: JATS_2.41.0                                Released: 27-Sep-05
7241
------------------------------------------------------------------------
7242
Major changes:
7243
  * RunTest directive
7244
    Extended the options and operation of RunTest
7245
    Additional options
7246
      --CopyIn=file
7247
        This will copy the specified file into the BIN directory before
7248
        the test is run. The file will be marked as executable. This
7249
        allows scripts and configuration files to be transferred into
7250
        the test area.
7251
 
7252
    Additional operations
7253
    The arguments passed to the script/program allow a number of
7254
    transformations, similar to GenerateFiles. Transforms
7255
      --File(xxxx[,flags])          - xxxx is a known file
7256
      --Local(xxxx[,flags])         - xxxx is a file that has been Installed
7257
      --PackageBase(xxxx[,flags])   - xxxx is a Package
7258
    Allows flags:
7259
      --dir         - directory part of the pathname
7260
      --file        - file part of the pathname
7261
      --abspath     - as an absolute path
7262
      --absdrive    - as an absolute path with drive letter (Windows)
7263
 
7264
    Files and directories are prerequisites of the test. Their
7265
    existence is tested.
7266
 
7267
  * Packaging Directives
7268
    Added a --Derived option to support the packaging of derived targets
7269
    such as LMOS.
7270
 
7271
        PackageHdr ('*', 'file1.h', '--Derived=LMOS');
7272
 
7273
    Will place file1.h into .../include/LMOS_WIN32
7274
 
7275
        PackageHdr ('*', 'file1.h', '--Derived=LMOS,sys');
7276
 
7277
    Will place file1.h into .../include/LMOS_WIN32/sys
7278
 
7279
  * JAVA 1.4 and 1.5
7280
    Added support to the JATS JAVA platform to allow the user to specify
7281
    the version of Java to be used to build a package.
7282
 
7283
        BuildPlatforms  ( 'JAVA,--Version=1.5' );
7284
 
7285
    The default will use the default machine version of JAVA.
7286
    This may not be sutable for all packages.
7287
 
7288
    Non-default versions of JAVA require that an environment variable be
7289
    set to the root of the JDK directory. These are:
7290
 
7291
      JAVA_HOME_1_4
7292
      JAVA_HOME_1_5
7293
 
7294
Minor changes:
7295
  * Script directive
7296
    Scripts may be copied into the BIN directory for use by a test.
7297
    These scripts are now always marked as executable.
7298
 
7299
  * JATS environment
7300
    Ensure that all programs run under JATS in Windows have an uppercase
7301
    COMSPEC envvar. Windows appears to define a mixed case one. Fixed in
7302
    the JATS wrapper script.
7303
 
7304
  * Label utility
7305
    Added -[no]checkout to control the labeling of checked out files.
7306
    There are three modes of operation:
7307
        1) -nocheckout      Checked out files are not labeled
7308
        2) -checkout        Only checked out files are labeled
7309
        3) Neither          All files are labeled.
7310
 
7311
 
7312
------------------------------------------------------------------------
7313
Version: JATS_2.40.0                                Released: 15-Sep-05
7314
------------------------------------------------------------------------
7315
Major changes:
7316
 
7317
Minor changes:
7318
  * label utility
7319
    Added -smartlabel option to unlock and lock the label - if it was locked.
7320
    This options retains the locked state of a label.
7321
 
7322
  * AVR_IAR toolset
7323
    Extended the 'Prog' directive to allow a Program Loader to be
7324
    added to a program as it is created. The option is:
7325
      --ProgLoader=name
7326
 
7327
  * Package directives. PackageFile
7328
    Added support for packaging of directory trees.
7329
    Options to do this are:
7330
        --TreeDir=name
7331
        --FilterOut=regexp
7332
        --FilterIn=regexp
7333
        --StripDir
7334
 
7335
    Only a single directory can be specified.
7336
    Multiple filters are allowed.
7337
    The directories must be within the current directory. It is not
7338
    possible to search outside the subdirectory tree below the makefile.
7339
 
7340
    The filters allow elements within the directory to be selected.
7341
    The filters are regular expressions. Examples:
7342
 
7343
      '--FilterIn=\.h$'         - Select all files ending with .h
7344
      '--FilterOut=MyHeader.h'  - Except this one
7345
 
7346
    The --StripDir option will remove the TreeDir directory from the
7347
    files. This allows the top level directory to be stripped off.
7348
 
7349
 
7350
------------------------------------------------------------------------
7351
Version: JATS_2.39.0                                Released: 14-Sep-05
7352
------------------------------------------------------------------------
7353
Major changes:
7354
    * Make commands
7355
      Consolidated the parsing of the OPTIONS arguments.
7356
 
7357
      The filter and nofilter options are globally applied to all tools
7358
      sets. ie: jats make debug OPTIONS=nofilter
7359
 
7360
    * Label utility
7361
      Generate a warning when attempting to label a symbolic link.
7362
      Links are very hard to maintain in a reproducible manner.
7363
 
7364
Minor changes:
7365
    * Toolsets
7366
      Replaced the use of c:\WINDOWS and c:\Program Files with suitable
7367
      variables and overrides.
7368
 
7369
      The make_init target is always run.
7370
      This facility had been lost. The target was being used to provide
7371
      compiler sanity testing, but had was not being reliably run.
7372
 
7373
    * Deployment
7374
      Suppress testing of compiler existence when used in conjunction
7375
      with deployment operations.
7376
 
7377
    * Release utility
7378
      Add options to build only the debug or the production versions.
7379
      The default is to build both. Note: User option may be further
7380
      restricted by options within the build.
7381
 
7382
    * PackageLib, InstallLib and MergeLib directives in makefile.pl
7383
      The use of @LIBS and @MLIBS in unix systems was causing a
7384
      problem as these variables already had a 'lib' prepended to the
7385
      list of libraries. These directives would add another 'lib' to the
7386
      list of libraries under unix causing a mismatch.
7387
 
7388
      Corrected by stripping liblib from the names within these
7389
      directives.
7390
 
7391
    * MakeProject directive
7392
      If the project build fails the log file was not being displayed
7393
      because 'make' stops when a command fails.
7394
 
7395
      The MakeProject operations have been modified to ensure that the
7396
      log file is always displayed. The exit code of the build command
7397
      is preserved.
7398
 
7399
    * Auto build utility jats-rewrite.pl
7400
      Modified to support the rewrite of Java 'using' and 'project'
7401
      statements.
7402
 
7403
    * Mugfile generation
7404
      Added a --ThxDir=xxxx option to allow the THX and load files to
7405
      be placed in the target package.
7406
 
7407
 
7408
------------------------------------------------------------------------
7409
Version: JATS_2.38.0                                Released: 01-Sep-05
7410
------------------------------------------------------------------------
7411
Major changes:
7412
    * BuildVersion directive
7413
      The 'defs' mode has been extended to create a file with a build
7414
      number as well as a patch number.
7415
 
7416
      The patch number is decoded into a patch number and a build
7417
      number.
7418
 
7419
Minor changes:
7420
    * AddFlags directives
7421
      Added a --NoWarn option that will suppress the warning of
7422
      duplicate flags being added.
7423
 
7424
    * GBE_CORE environment variable (Windows)
7425
      Ensure that GBE_CORE has a driver letter. This allows use of JATS
7426
      loaded into the same dynamic view as the user code.
7427
 
7428
    * Mug File Generation
7429
      Added support to allow load files to include other load files.
7430
 
7431
   * 'cbuild' or 'release' command
7432
     Added a -latestroot=xxxx option. This is a work around for the
7433
     problem where the root level directory in the VOB has not been
7434
     labeled. After using this switch add the label to the root
7435
     directory.
7436
 
7437
     The need to use this this switch indicates that the view is NOT
7438
     reproducible.
7439
 
7440
------------------------------------------------------------------------
7441
Version: JATS_2.37.0                                Released: 22-Aug-05
7442
------------------------------------------------------------------------
7443
Major changes:
7444
    * jats.bat and jats.sh
7445
      Changes to include GBE_DPKG and GBE_DPKG_CACHE.
7446
      Most importantly GBE_DPKG must be a single directory. It is no
7447
      longer a list of directories.
7448
 
7449
      Removal of the setup of Microsoft Visual Studio 6. This is now
7450
      done within the toolset.
7451
 
7452
      *** Update your jats.bat to follow the format in this release
7453
 
7454
    * JATS environment variables
7455
      Redefined variable
7456
        GBE_DPKG        - Now the MASTER dpkg_archive
7457
                          Previously was a list that included the
7458
                          dpkg_archive cache.
7459
 
7460
      New variable
7461
        GBE_DPKG_CACHE  - Optional directory for a local cache of
7462
                          the main dpkg_archive.
7463
 
7464
 
7465
Minor changes:
7466
    * Utility: gen_packagelist
7467
      Enhanced (thanks Ross) to allow PATH information for various
7468
      target platforms to be extracted.
7469
 
7470
      Better support for Product families. This is only an issue
7471
      for WIN32 derived families due to the generation of a list of
7472
      libraries. The list now observes Product hierarchy.
7473
 
7474
    * Utility: release (cbuilder)
7475
      Added -noruntests option too suppress the running of unit tests
7476
      Units tests will still be run by default.
7477
 
7478
      Tighten the config specification used to build the sandbox. It has
7479
      no LATEST rules. All directories and files MUST be labeled.
7480
 
7481
    * Utility: jats_rewrite
7482
      Support ANT based XML files
7483
 
7484
    * Utility: create_dpkg
7485
      Support ANT flavor Manifest dependancy files and pkg directory
7486
      structure.
7487
 
7488
    * makefile.pl's
7489
      GenerateFiles directive. Added a --Prog specifier to allow tools
7490
      to be generated within the same script. Example:
7491
 
7492
            Prog('*', 'Myprog', @OBJS );
7493
            GenerateFiles ('*', "--Prog=MyProg",
7494
                                '--Prereq(infile)',
7495
                                '--GeneratedCommon(outfile)' );
7496
 
7497
      RunTest directive. Added a --Auto option to flags tests that can
7498
      be run within the Build Systems Auto Build environment. These
7499
      tests will be run with the 'run_unit_tests' target. All tests will
7500
      be run with the 'run_tests' targets. Only tests that confirm to
5710 dpurdie 7501
      the VIX "Unit Test Automation" guidelines should be marked as
227 dpurdie 7502
      -- Auto.
7503
 
7504
    * Added a new make target: run_unit_tests
7505
      This will be used by the build tool to run non-interactive
7506
      unit tests within an automated framework.
7507
 
7508
    * Make run_test and run_unit_test operation
7509
      The search path for DLL's or Shared Libraries is extended to
7510
      include all Shared Libraries in the build package list as well
7511
      as the local and interface directory. This allows tests to
7512
      locate required Shared Libraries at runtime.
7513
 
7514
    * WIN32 targets built using Visual Studio 6
7515
      The path to the compiler is setup within JATS. It is no longer
7516
      imported from the users environment as the environment is
7517
      indeterminate when multiple versions of Visual Studio are
7518
      installed on the machine.
7519
 
7520
    * WINCE Targets
7521
      The name of the SDK is case sensitive.
7522
      The POCKET PC 2003 was incorrect
7523
 
7524
 
7525
 
7526
------------------------------------------------------------------------
7527
Version: JATS_2.36.0                                Released: 03-Aug-05
7528
------------------------------------------------------------------------
7529
Major changes:
7530
    * WIN32 platforms
7531
      When building Microsoft project files the PATH environment
7532
      variable is extended to include the DLL path of imported packages
7533
      and installed packages.
7534
 
7535
    * Building DLL or EXE with the --NoPDB option will disable the
7536
      generation of debug information so that the  linker does not
7537
      create CV style debug information in the target.
7538
 
7539
    * UNIX Platforms (SOLARIS and LINUX)
7540
      Modification to allow BuildProduct and BuildPkgArchive to
7541
      interwork. Previously BuildPkgArchive packages were placed into
7542
      the 'interface/lib/SOLARIS' subdirectory and this was not being
7543
      searched when looking for libraries.
7544
 
7545
Minor changes:
7546
    * GenerateFiles directive
7547
      New sub-options to filename generation commands
7548
        --abspath       - provide the named file with an absolute path
7549
        --absdrive      - provide the named file with an absolute path
7550
                          and drive letter
7551
 
7552
    * Src directive
7553
      Modified the --FromPackage' option to allow searching of the root
7554
      directory of a package.
7555
 
7556
            Src('*', 'etc/data.ini', '--FromPackage' );
7557
 
7558
      Also prevent warnings on duplicate files if the package is
7559
      imported with a BuildPkgArchive directive. The file was being
7560
      found in the package and the interface directory.
7561
 
7562
    * jats_rewrite utility
7563
      Process depend.xml files for auto builder
7564
 
7565
 
7566
------------------------------------------------------------------------
7567
Version: JATS_2.35.0                                Released: 28-Jul-05
7568
------------------------------------------------------------------------
7569
Major changes:
7570
    * SunWorks production builds
7571
      Corrected the flag used to select the level of compiler
7572
      optimisation. The current flag generates an error of:
7573
            cc: Warning: option -2 passed to ld
7574
      The flag has been changed from -O2 to -xO2 inline with the
7575
      compiler documentation.
7576
 
7577
    * MOS Toolset
7578
      Implement a workaround for a bug in VisionClick's convert program
7579
      in which the tool would not generate a valid .bdx file.
7580
 
7581
      The solution was to create the .bdx and .ab file in two steps.
7582
 
7583
Minor changes:
7584
    * Correct the case of 4 toolset files. The files were created under
7585
      windows, which has a habit of capitalizing filenames.
7586
      This should not affect current users.
7587
 
7588
    * Mugfile generation
7589
      Extended the --Package option to allow subdirectories to be
7590
      specified.
7591
        "--Package=MyPackage,--Subdir=thx/moscf,thx"  
7592
 
7593
------------------------------------------------------------------------
7594
Version: JATS_2.34.0                                Released: 22-Jul-05 
7595
------------------------------------------------------------------------
7596
Major changes:
7597
    MOS Toolset
7598
    Modified the optimizations options used to generate 'Production'
7599
    code. A problem with -Ob optimization has been identified.
7600
 
7601
Minor changes:
7602
    * Jats wrapper script
7603
      Windows: Ensure that cmd.exe is in the users PATH. Without cmd.exe
7604
      scripts will not work properly as the PERL 'system' command assumes
7605
      that cmd.exe is in the users PATH.
7606
 
7607
    * LinkPkgArchive and BuildPkgArchive
7608
      Processing soft links. Generate a warnings if a package soft
7609
      link and a real package are found in the same directory. The link
7610
      may be suspect.
7611
 
7612
    * GenerateFiles directive
7613
      Added a --PackageBase(xxx) argument that will be replaced with
7614
      the pathname to the specified package.  
7615
 
7616
------------------------------------------------------------------------
7617
Version: JATS_2.33.0                                Released: 18-Jul-05
7618
------------------------------------------------------------------------
7619
Major changes:
7620
    * Added a JAVA platform to better support the processing of ANT
7621
      build.xml files.
7622
 
7623
Minor changes:
7624
    * WIN32 toolset.
7625
      Delete V7 specific temp files when compiling with V7 compiler
7626
 
7627
    * MakeAnt
7628
      Pass an absolute path to the 'interface' directory to allow the
7629
      build.xml file to be a directory other than the current directory
7630
 
7631
      Allow the ANT_HOME path to contain spaces: c:\Program Files\Ant
7632
 
7633
    * gen_winrc - A utility to generate Windows RC files with version
7634
      information. Allow 3 or 4 fields in the version number. If only
7635
      3 fields are provided, then the fourth field is set to 0.
7636
 
7637
    * MakeAnt directive
7638
      Now supports --Debug and --Prod options to limit the building of
7639
      ANT files. The MakeAnt directive is only going to work in
7640
      conjunction with the JAVA target
7641
 
7642
      Recommended usage:
7643
      MakeAnt('JAVA',"build.xml","--Jar=java.build/test.jar",'--Prod');
7644
 
7645
Internal Changes
7646
      The MakeAnt directive is now treated like a MakeProject directive.
7647
 
7648
 
7649
------------------------------------------------------------------------
7650
Version: JATS_2.32.0                                Released: 13-Jul-05
7651
------------------------------------------------------------------------
7652
Major changes:
7653
    * Initial release of WINCE and WIN32 V7 based project builds
7654
      The DSW, VCW and SLN files can be built via JATS and selected
7655
      files packaged into the release.
7656
 
7657
      Refer to the 'MakeProject' directive in
7658
            MASS-00166 JATS Reference Manual
7659
            http://auperaws396/mass/Wiki.jsp?
7660
                                page=UsingJATSToBuildMicrosoftProjects
7661
 
7662
    * Added support for Visual Studio 2003.
7663
      The recommended platform is:
7664
        BuildProduct    ( 'VS2003', 'WIN32,--Version=MS.NET2003' );
7665
 
7666
    * Initial release of support for building Ant files.
7667
      JATS can build small Java sub-components using Ant. This is not
7668
      a replacement for JANTS it is intended for mixed C++ and Java
7669
      components.
7670
 
7671
      Refer to the 'MakeAnt' directive in
7672
            MASS-00166 JATS Reference Manual
7673
            http://auperaws396/mass/Wiki.jsp?
7674
                                page=UsingJATSToBuildSmallJavaComponents
7675
 
7676
Minor changes:
7677
    * Support for Windows DLLs
7678
      When building a WIN32 target the file interface/set_WIN32.bat is
7679
      created. This file extends the Windows PATH to allow DLLs used
7680
      by the package to be accessed.
7681
 
7682
      The file may be "called" from a wrapper batch file to start the
7683
      application or visual studio.
7684
 
7685
    * The descpkg file created by JATS contains a JATS version number
7686
      and the JATS Core path.
7687
 
7688
    * AddIncDir, AddSrcDir and AddLibDir directives
7689
      Now generate an error if there is only one argument to the
7690
      directive or if no directories where specified.
7691
 
7692
    * MOS Toolset
7693
      Add support for the TPT device
7694
      Correct error message for unsupported devices.
7695
 
7696
    * Correct problem with in creating absolute path names to allow
7697
      DOS driver letters to be handled correctly.
7698
 
7699
    * Added --ExcludeLib(xxx,yyy) processing to allow specified
7700
      libraries to be excluded from a list of libraries processed by
7701
      when creating libraries, shared libraries and programs.
7702
 
7703
      Used in conjunction with --Using(aaaa) to correct errors.
7704
 
7705
Internal Changes
7706
    * JATS release process validates the JATS version number contained
7707
      in jats.pl
7708
 
7709
------------------------------------------------------------------------
7710
Version: JATS_2.31.0                                Released: 28-Jun-05
7711
------------------------------------------------------------------------
7712
Major changes:
7713
    * JATS wrapper script
7714
      Allow multiple alternative build files: auto.pl and build_test.pl
7715
 
7716
    * Initial support for the building of WINCE based projects
7717
 
7718
    * Formal release of the toosl to generate Mug Files
7719
 
7720
Minor changes:
7721
    * Deployment support
7722
      Allow a --PatchNum to be specified in the BuildName
7723
      This is then used to invoke a deploypatch.pl file
7724
 
7725
    * 'build'
7726
      Added --ForceBuildPkg switch to the 'jats build' command to
7727
      force LinkPkgArchive directives to be interpreted as
7728
      BuildPkgArchive. This option is useful for the creation of
7729
      sandboxes for use within IDEs as the package files are placed
7730
      in a known directory structure within the sandbox.
7731
 
7732
    * WINCE and WIN32 Toolset
7733
      Options for Program and Shared Library construction
7734
            --Entry=xxxx            - Alternate entry point
7735
            --NoAddLibs             - Do not add default libraries to
7736
                                      the link phase.
7737
 
7738
    * BuildPkgArchive
7739
      Handle symlink directories at the top level of the package tree
7740
      Previously these were ignored.
7741
      Minor code cleanup
7742
 
7743
    * "cbuild" or "release" utility
7744
      Add a "-path=xxxx" option to provide sanity testing of the Release
7745
      Manager "Source Path" field.
7746
 
7747
    * SOLARIS targets
7748
      Modified the TARGET name generated with building a Product Family
7749
      based on SOLARIS. It is treated in the same manner as a Platform
7750
      of SOLARIS and creates a targets of SOLARIS_sparc
7751
 
7752
    * MugFile generation
7753
      Allows a 'load.cmd' file to be used to list the THX files to be
7754
      included in the final package.
7755
 
7756
    * Corrected a problem with the processing of platform selection
7757
      arguments used within all directives within a makefile.pl.
7758
      Multiple platforms should be specified as:
7759
            Src( 'PLAT1,PLAT2,PLAT3', .... );
7760
      with only a comma between the platforms: No whitespace
7761
      If whitespace did exist then the makefile.pl would not do what
7762
      was expected - and it would not warn the user. The simplest
7763
      solution was to allow whitespace either side of the comma.        
7764
 
7765
    * GenerateFiles directive within makefile.pl
7766
      Allow 3 different bracket styles for the arguments to allow for
7767
      embedded  brackets. Now allow
7768
            --Option=(some_text)
7769
            --Option=[some_text]
7770
            --Option={some_text}
7771
 
7772
Internal Changes
7773
    * Derive the names of the package and install directories from a
7774
      single data structure rather then being hardcoded throughout the
7775
      code.
7776
 
7777
------------------------------------------------------------------------
7778
Version: JATS_2.30.0                                Released: 01-Jun-05
7779
------------------------------------------------------------------------
7780
Major changes:
7781
    * JATS wrapper script
7782
      Changed the command line parsing. Now use GetOpts.
7783
 
7784
      Modified "all" command It no longer performs an "install"
7785
      The "install" process is not needed. the build places a shortcut
7786
      to the package into the local_dpkg_archive. This can be used by
7787
      other components.
7788
 
7789
      Removed "bmake" command. The "all" command is the now that same.
7790
 
7791
    * JATS
7792
      Created a class to write JATS configuration files.
7793
      Changes to the code to use this new class.
7794
 
7795
    * Build operations
7796
      Perform one level of package version checking. Generate warnings
7797
      if required packages are built against different versions of
7798
      packages.
7799
 
7800
    * Make operations
7801
      Added a new target - "deploy". This interfaces to the deployment
7802
      scripts. This is still a work interfaces progress.
7803
 
7804
Minor changes:
7805
    * Added environment variables to assist in the running of the
7806
      deployment builds.
7807
        PERL5LIB        - Extended based on GBE_CORE
7808
        DEPLOYLIB_DIR   - Calculate based on GBE_CORE
7809
 
7810
      Extended the "jats vars" display
7811
 
7812
    * build.pl
7813
        Corrected BuildAlias() operation. Defined options are correctly
7814
        processed. Allows
7815
            BuildAlias('WIN', 'WIN32,--OnlyProduction');
7816
        to define a platform called WIN32 that only builds for
7817
        production.
7818
 
7819
    * MOS toolset
7820
      Added a '--Acon' options to SharedLib to allow the creation of
7821
      Acon modules. These required special linking.
7822
 
7823
    * create_dpkg utility
7824
      Adds a files to the published package to indicate which type of
7825
      machine the package was published from. This will be used in a
7826
      multi-machine build environment to assist in determining the
7827
      progress of the build.
7828
 
7829
    * New utility - jats_save_build.pl
7830
      This is specific to the auto build system. It will be used to
7831
      capture the modified build files back into the version control
7832
      system.
7833
 
7834
------------------------------------------------------------------------
7835
Version: JATS_2.29.0                                Released: 25-May-05
7836
------------------------------------------------------------------------
7837
Major changes:
7838
    * WIN32 and WINCE toolsets
7839
      Modified the way that PDB files are created.
7840
      The files are now created using absolute pathnames when compiling
7841
      The name of the PDB files embedded in created DLLs is now correct.
7842
      The PDB files created when compiling objects for DLLs are now not
7843
      named after the DLLs - this was causing the linker toolsets crash.
7844
 
7845
    * WCEX86A500 target
7846
      Corrected problem creating DLLs.
7847
 
7848
    * MOS Toolsets
7849
      Modified the mechanism by which absolute filenames are passed to
7850
      the compiler.
7851
 
7852
    * RunTest directive
7853
      This directive will ensure that the named test is either a script
7854
      or a TestProg. If the test to be run is a TestProg then a
7855
      suitable suffix will be added to the named test.
7856
 
7857
Minor changes:
7858
    * JATS BUILD
7859
      Generate an error if the setting of GBE_BUILDFILTER or
7860
      GBE_PLATFORM prevents any targets being made at all. This should
7861
      highlight bad settings.
7862
 
7863
    * Publish the JATS toolsets extension pathnames to simplify the
7864
      access to extensions.
7865
 
7866
------------------------------------------------------------------------
7867
Version: JATS_2.28.0                                Released: 18-May-05
7868
------------------------------------------------------------------------
7869
Major changes:
7870
    * WIN32 and WINCE toolsets
7871
      Enable dependancy file generation of C++ files
7872
 
7873
    * label utility ( SOLARIS )
7874
      Fix bug with the escaping of '(' and ')' in cleartool commands
7875
      under unix.
7876
 
7877
Minor changes:
7878
    * label utility
7879
      Added options to:
7880
        o Delete a label
7881
        o Prevent recursion while labeling
7882
        o Control labeling of files missing from a static view
7883
 
7884
    * WIN32 and WINCE toolsets
7885
      Correct problem with the packaging of PDB files. Packaging of the
7886
      PDB files can be controlled with the -Extras= options to the
7887
      Package directives.
7888
 
7889
    * Added GBE_UNIX to the JATS_2 controlled environment. Set by
7890
      jats.pl to be used by utilities to determine the underlying
7891
      system.
7892
 
7893
------------------------------------------------------------------------
7894
Version: JATS_2.27.0                                Released: 10-May-05
7895
------------------------------------------------------------------------
7896
Major changes:
7897
    * MOS Toolset
7898
      The generation of multiple THX's in the one makefile.pl now works
7899
      There was a subtle "closure" problem in the toolset.
7900
 
7901
    * WIN32 Toolset
7902
      Added CompileOption of AddLibs (default) and NoAddLibs
7903
      toolset suppress the addition of thread libraries toolset the link
7904
      list.
7905
 
7906
    * Put a version number in the "interface" information toolset
7907
      allow JATS to generate an error when the "interface" changes.
7908
 
7909
      This version is manually maintained and prone to error.
7910
 
7911
    * GenerateFiles directive one Unix systems was incorrectly
7912
      invoking "sh.exe" instead of "sh"
7913
 
7914
 
7915
Minor changes:
7916
    * SOLARIS_SPARC platform (GCC toolset)
7917
      The process of creating a Shared Libraries creates a soft link
7918
      to the the "GBEBIN" directory. This directory was not listed as
7919
      a prerequisite and was not being created. This problem has been
7920
      corrected.
7921
 
7922
    * JATS will detect an "auto.pl" file and use it as an alternate
7923
      build.pl file. Previously this file was named build.use.pl.
7924
 
7925
    * Correct problem when .PDB files are installed from a merged
7926
      library created from libraries that have been 'installed'
7927
      JATS would create a circular dependancy.
7928
 
7929
------------------------------------------------------------------------
7930
Version: JATS_2.26.0                                Released: 03-May-05
7931
------------------------------------------------------------------------
7932
Major changes:
7933
    * WIN32 Toolset
7934
      Correct a problem linking in required / correct libraries for
7935
      use with multithreaded modes.
7936
 
7937
    * Complete the support for Global build options of --OnlyDebug and
7938
      --OnlyProd.
7939
 
7940
      These options can now be provided in the "Platform" directive
7941
      within the makefile.pl.
7942
 
7943
Minor changes:
7944
    * Platform directive within makefile.pl
7945
      These use of the "*" platform specifier has been modified such
7946
      that options provided within the directive will be added to all
7947
      platforms.
7948
 
7949
      eg:   Platform ('*', '--OnlyProduction' );
7950
 
7951
------------------------------------------------------------------------
7952
Version: JATS_2.25.0                                Released: 29-Apr-05
7953
------------------------------------------------------------------------
7954
Major changes:
7955
    * Correct problem in handling the SOLARIS_SPARC platform.
7956
      The SOLARIS platform is a bit of a kludge for backward
7957
      compatibility. JATS was not differentiating between SOLARIS and
7958
      SOLARIS_SPARC correctly.
7959
 
7960
    * Preliminary Support
7961
      Global build options of --OnlyDebug and --OnlyProd, which are
7962
      mutually exclusive. These may between specified in the build.pl
7963
      file as build arguments in any of the three standard mechanism.
7964
 
7965
        BuildPlatforms ( 'SOLARIS', '--OnlyDebug' );
7966
        BuildProduct   ( 'GAK', 'MOS68K,--OnlyProduction' );
7967
        BuildArgument  ( 'WIN', '--OnlyProduction' );
7968
 
7969
      These options limit processing to either Production or Debug
7970
      building. The default build will build both.
7971
 
7972
Minor changes:
7973
    * Extended the search path that JATS will use attempting to locate
7974
      a build.pl file. JATS will now look in ., build and build/jats
7975
      directories in the current directory and 3 directories up.
7976
 
7977
    * WCEX86A420 toolset
7978
      Added suitable libflags entry. Prevents the warning:
7979
        warning: undefined variable `WCE_LIBFLAGS'
7980
 
7981
 
7982
------------------------------------------------------------------------
7983
Version: JATS_2.24.0                                Released: 21-Apr-05
7984
------------------------------------------------------------------------
7985
Major changes:
7986
    * PackageLib and PackageProg directives now have a --Extra=xxx[,xxx]
7987
      option. Where xxx can be one or more of: none stub map lint debug
7988
      or all.
7989
 
7990
      This option may be used to limit the files that are packaged with
7991
      the library or program.
7992
 
7993
      Eg: PackageLib ('MOS', 'MyThx', '--Extra=none' );
7994
 
7995
      Will only package the .thx file. It will not package the stub
7996
      library or any debug files.
7997
 
7998
    * GenerateFiles
7999
      All processed arguments now support two options.
8000
 
8001
          ie: --Prerequisite(xxxx,--dir)
8002
              directory in which the prereq file is found
8003
 
8004
          ie: --Prerequisite(xxxx,--file)
8005
              The filename of the prereq file
8006
 
8007
    * LinkPkgArchive and BuildPkgArchive will cause the build to fail if
8008
      the required package is not available. A "--package" option, to
8009
      the build command, will prevent this behaviour.
8010
 
8011
 
8012
Minor changes:
8013
    * create_dpkg utility
8014
      Touch descpkg files when packages are merged. This will allow
8015
      utilities that use the timestamp of this file to determine that
8016
      the package has been altered.
8017
 
8018
------------------------------------------------------------------------
8019
Version: JATS_2.23.0                                Released: 14-Apr-05
8020
------------------------------------------------------------------------
8021
Major changes:
8022
    * New toolset: WCEX86A420
8023
      This is a WINCE target
8024
      This uses the ADVANTEC_X86_CE42 SDK
8025
 
8026
    * New toolset
8027
      mpt for the mpt500 platfomr
8028
 
8029
    * Modified toolset
8030
      THYRON - updates from An An Tran
8031
 
8032
    * Modified toolset
8033
      MRI68K. Now supports the Microtec 5.1 68k compiler
8034
 
8035
Minor changes:
8036
    * "cbuild" or "release" command now has a -merge option to allow
8037
      builds from different machines to be merged into dpkg_archive.
8038
 
8039
      The default operation is to replace the package indpkg_archive.
8040
 
8041
    * Simplify the use of GBE_BUILDFILTER
8042
      GBE_BUILDFILTER should be used to limit the creation of makefiles
8043
      to those that are supported by the underlying hardware.
8044
 
8045
      The change allows the construct
8046
        GBE_BUILDFILTER=SOLARIS --TARGET=SOLARIS
8047
      to be replaced by the simpler
8048
        GBE_BUILDFILTER=SOLARIS
8049
 
8050
      The default operation is to allow or disallow all TARGETS of the
8051
      specified name.    
8052
 
8053
 
8054
------------------------------------------------------------------------
8055
Version: JATS_2.22.0                                Released: 13-Apr-05
8056
------------------------------------------------------------------------
8057
Major changes:
8058
    * Dependancy generator
8059
      Extend the number of header files that can be included
8060
      to allow for 4096 included files.
8061
 
8062
------------------------------------------------------------------------
8063
Version: JATS_2.21.0                                Released: 12-Apr-05
8064
------------------------------------------------------------------------
8065
Major changes:
8066
    * Dependancy generator
8067
      Extend the number of header files that can be included
8068
 
8069
------------------------------------------------------------------------
8070
Version: JATS_2.20.0                                Released: 12-Apr-05
8071
------------------------------------------------------------------------
8072
Major changes:
8073
    * The "package.pl" file.
8074
      Setting $Pbase to "." is now supported and will result in the
8075
      package name being taken from the build name
8076
 
8077
      It is an error to set Pbase to a value other than "." or the
8078
      package Build Name.
8079
 
8080
Minor changes:
8081
    * create_dpkg utility
8082
      The -m ( merge) option will not replace a file if it already exists
8083
 
8084
------------------------------------------------------------------------
8085
Version: JATS_2.19.0                                Released: 08-Apr-05
8086
------------------------------------------------------------------------
8087
Major changes:
8088
 
8089
Minor changes:
8090
    * Dependancy generator
8091
      Correct two common situations
8092
        1) // Style comments. The following line was ignored
8093
        2) Allow preprocessor directives to be indents. This is not
8094
           ansi, but is often done.
8095
 
8096
    * GCC toolset
8097
      Corrected operation of the C++ compiler. The object file was not
8098
      being created in the correct place.
8099
 
8100
    * jats "label"
8101
      The -auto -clone options allow a label to be created if its not
8102
      present. Previously this would label all files in the VOB.
8103
 
8104
 
8105
------------------------------------------------------------------------
8106
Version: JATS_2.18.0                                Released: 06-Apr-05
8107
------------------------------------------------------------------------
8108
Major changes:
8109
 
8110
Minor changes:
8111
    * BuildPkgArchive. The transfer of the "pkg" subdirectory has been
8112
      modified. Directories of the form pkg/pkg.$(GBE_MACHTYPE) will
8113
      be transferred to the "pkg" directory.
8114
 
8115
      If there are no directores of the form "pkg.xxxxx" then the entire
8116
      pkg directory will be transferred.
8117
 
8118
    * Transfer to dpkg_acrhive
8119
      Corrected a problem in which a file with the same name as the
8120
      package was not being transferred.
8121
 
8122
------------------------------------------------------------------------
8123
Version: JATS_2.17.0                                Released: 06-Apr-05
8124
------------------------------------------------------------------------
8125
Major changes:
8126
    * Support for solaris_i386
8127
      The JATS toolset has been modified to provide the required
8128
      binaries for this target.
8129
 
8130
      The platform SOLARIS_I386 has been created to build on this target
8131
      with the GCC compiler.
8132
 
8133
      The JATS startup shell has been modified to allow specfic values
8134
      to be imported from the environment. Under Unix such values may
8135
      need to be specified in the /etc/profile file.
8136
 
8137
Minor changes:
8138
    * The InstallHdr, InstallLib, InstallJar and InstallProd directives
8139
      will now generate a warning if a "local" directory has not been specified
8140
      with a "BuildInterface" directive in the build.pl file.
8141
 
8142
    * cbuild ( release) utility
8143
      Fxied a problem locating VOBs under Solaris
8144
 
8145
------------------------------------------------------------------------
8146
Version: JATS_2.16.0                                Released: 04-Apr-05
8147
------------------------------------------------------------------------
8148
Major changes:
8149
    * The InstallHdr, InstallLib, InstallJar and InstallProd directives
8150
      will generate an error if a "local" directory has not been specified
8151
      with a "BuildInterface" directive in the build.pl file.
8152
 
8153
      The "local" directory should be specified to JATS so that it can
8154
      remove the directory tree with the "clobber" command.
8155
 
8156
    * jats_rewrite.pl utility
8157
      Allow BuildName and LinkPkgArchive directives to contains comments
8158
      with either " or ' characters.
8159
 
8160
    * BuildSubDir - in build.pl
8161
      It is now an error if the specified subdirectory does not exist
8162
      and  does not contain the file "makefile.pl".
8163
 
8164
    * SubDir - in makefile.pl
8165
      It is now an error if the specified subdirectory does not exist
8166
      and  does not contain the file "makefile.pl".
8167
 
8168
    * Jats wrapper
8169
      Added a "-locate" option to force JATS to locate the build.pl file
8170
      and then change to the containing directory before execution
8171
      further commands.
8172
 
8173
Minor changes:
8174
    * WinCe and Win32 toolsets
8175
      Corrected a problem in the generation of .dep files used in the
8176
      creation of Shared Libraries. There was a miss-match between the
8177
      name of the .dep file and its content.
8178
 
8179
------------------------------------------------------------------------
8180
Version: JATS_2.15.0                                Released: 22-Mar-05
8181
------------------------------------------------------------------------
8182
Major changes:
8183
    * WIN32 and WinCE Toolset. New CompileOptions
8184
        NoPDB   - Disable the generation of PDBs
8185
        PDB     - Enable the generation of PDBs (default).
8186
 
8187
      These options operation affect all components within the
8188
      makefile.pl. If the directive is used within the common makefile.pl
8189
      then they will affect all components within the build.
8190
 
8191
      Note: It is not possible to create a merged library in which some
8192
            of the component libraries have PDB's and some do not.
8193
 
8194
Minor changes:
8195
 
8196
------------------------------------------------------------------------
8197
Version: JATS_2.14.0                                Released: 18-Mar-05
8198
------------------------------------------------------------------------
8199
Major changes:
8200
    * The MergeLibrary directive, under WIN32 and WinCe, will publish the
8201
      PDB files associated with the library files being merged.
8202
 
8203
Minor changes:
8204
    * gen_winrc tool can add an icon to a program.
8205
      The utility supports -icon=filename.ico
8206
 
8207
    * The JATS wrapper script command "prod" to build and package the
8208
      production parts. This is similar to the "dev" command.
8209
 
8210
------------------------------------------------------------------------
8211
Version: JATS_2.13.0                                Released: 18-Mar-05
8212
------------------------------------------------------------------------
8213
Major changes:
8214
    * Modified the order in which the makefiles passes operate. Merged
8215
      the make_shlib and the install_shlib into one phase. The
8216
      implication of this is that Shared Libraries that are created can
8217
      "installed" so that other shared libraries can link against them.
8218
      The order in which the makefile.pl's are processed is important as
8219
      this is the order in which the libraries will be created and
8220
      installed.
8221
 
8222
      This solution does not handle mutual shared libraries: two shared
8223
      libraries that depend on each other.
8224
 
8225
      This is an issue only in Solaris and Linux systems that do not
8226
      generate separate stub libraries to link against.
8227
 
8228
Minor changes:
8229
    * WIN32 and WinCE Toolsets
8230
      Building up resources. The RC compiler can now locate resource files
8231
      in the "local" and "interface" directory.
8232
 
8233
    * The version.c, version.h and descpkg files will be created in the
8234
      first directory named with a BuildDir directive, unless a
8235
      "src" directory is encountered. This mimics the operation
8236
      of the older JATS, without the need for a "src" directory.
8237
 
8238
------------------------------------------------------------------------
8239
Version: JATS_2.12.0                                Released: 18-Mar-05
8240
------------------------------------------------------------------------
8241
Major changes:
8242
 
8243
Minor changes:
8244
    * Added a --Depend=xxx[,yyy]+ option to the Src directive
8245
      Not needed for C and C++ files, but may be used in conjunction
8246
      with assembler files to indicate that the file includes another
8247
      file.
8248
 
8249
    * Fixed problem with the local_dpkg_archive consistency test when
8250
      a soft link is used to redirect to the package.
8251
 
8252
    * Win32 and WinCE toolsets
8253
      Added a compiler option to enable Run Time Type Information.
8254
            CompileOptions ('WIN32', 'RTTI' );
8255
 
8256
      Add an option to Shared Library creation to allow the generation of
8257
      a Resource Only DLL. Option is "--ResourceOnly"
8258
 
8259
      Add an option to allow Resources to be built into Static Libraries
8260
      in the same manner at Shared Libraries.
8261
 
8262
    * WinCE toolsets
8263
      Mutual DLL support corrected. Library path is used to resolve
8264
      compiler specific libraries.
8265
 
8266
    * SOLARIS toolset
8267
      Prevent the compiler displaying its command line. This is in line
8268
      with the other tools sets. The commands can be seen with
8269
      OPTIONS=args and this may be set in the users environment.
8270
 
8271
      Modified the cleanup process to delete the links to shared
8272
      libraries. Only files, and not links to files, where being
8273
      cleaned up.
8274
 
8275
    * Microtec tools set (MOS)
8276
      Dependancy generation can display commands with OPTIONS=args
8277
 
8278
    * jats_rewriter.pl
8279
      Allow BuildName and LinkPkgArchive directives to contains arguments
8280
      with either " or ' characters.
8281
 
8282
 
8283
------------------------------------------------------------------------
8284
Version: JATS_2.11.0                                Released: 15-Mar-05
8285
------------------------------------------------------------------------
8286
Major changes:
8287
    * BuildPkgArchive operation
8288
      The entire "include" directory is copied into the interface area
8289
      The installer was trying to be too smart and only copy platform
8290
      specific files,but was missing out many needed subdirectories
8291
 
8292
      Reduce the warnings generated. These were an artifact of the process
8293
      of picking up all the strange variations of the directory structures.
8294
 
8295
    * Cleaned up the handling of object files that were generated by the
8296
      user.
8297
 
8298
    * MOS Microtec Toolset
8299
      Always present an absolute filename to the compiler
8300
      Display a shortened filename to allow the user to track progress
8301
 
8302
      This will remove error messages about the path being too long
8303
      for the   -Gf option.
8304
 
8305
Minor changes:
8306
    * SOLARIS Toolset
8307
      Remove duplicate -KPIC flags on the command line
8308
 
8309
    * Win32 and WinCE Toolset
8310
      Source files are either compiled by the C compiler as C files or
8311
      the C++ compiler as C++ files. The option to allow the compiler to
8312
      figure out what sort of file it is has been removed.
8313
 
8314
------------------------------------------------------------------------
8315
Version: JATS_2.10.0                                Released: 11-Mar-05
8316
------------------------------------------------------------------------
8317
Major changes:
8318
    * Extended BuildName to accept the form
8319
            BuildName ('package_name', 'nn.nn.nn.xxx' );
8320
 
8321
    * MOS68K and MOSCF toolset.
8322
      Extended the --board option to allow the user to define code and
8323
      data addresses for the board.
8324
 
8325
            BuildProduct( 'TP5', 'MOSCF','--board=01234H,05678H' );
8326
 
8327
      Will set the code,data address for the debugable image
8328
 
8329
    * Extended the PackageXxxxx options
8330
      1) Allow --Platform=xxx,yyy
8331
         Where xxx is a directory prefix and yyy is suffix to the
8332
         "platform" name.  Only useful within the context of the
8333
         PackageFile
8334
 
8335
      2) The operation of --Platform=xxx when used by the PackageFile
8336
         directive now treats the xxx directory as a prefix to the
8337
         platform name. Other Package directives still treat it as a
8338
         suffix. In practice this is the logical use.
8339
 
8340
    * Allow InstallLib and PackageLib to install a file that has been
8341
      discovered with a "Src" directive. This allows generated files
8342
      to be installed and packaged.
8343
 
8344
Minor changes:
8345
 
8346
    * cache_dpkg utility
8347
      If a package is found in the local_dpkg_archive then the cache
8348
      entry will be deleted and the master archive will not be accessed.
8349
 
8350
    * label utility
8351
      New option -auto to create and label
8352
 
8353
    * Build WIN32 and WinCe Mutual DLLs with all the object files
8354
      This allows the generated import library to contain C++ names
8355
 
8356
    * The BuildDirTree directive now supports an empty first argument
8357
      This allows a NULL tree.dir file, while still creating the root
8358
      directory. ie:
8359
 
8360
            BuildDirTree    ( '', 'pkg' );
8361
 
8362
    * Fixed DEVIM 00019520
8363
      The problem was that /bin/pwd could return a different path to
8364
      the Cwd:getpwd() function. Solution: Use one mechanism throughout.
8365
 
8366
 
8367
------------------------------------------------------------------------
8368
Version: JATS_2.9.0                                 Released: 28-Feb-05
8369
------------------------------------------------------------------------
8370
Major changes:
8371
    * First release for Back Office and Front Office use.
8372
 
8373
    * Added the jats tool  jats_rewrite.pl to rewrite build.pl files.
8374
      To be used by the nightly build process.
8375
 
8376
    * Work around a problem in the Microtec 68K compiler.
8377
      The compiler uses temp files. If the temp file name that the
8378
      compiler uses already exists, then the compiler will not delete
8379
      the file. Instead it appends information to the existing file.
8380
 
8381
      The workaround is to create the temp files within the build's
8382
      interface directory and to remove all temp files before each
8383
      compilation.
8384
 
8385
      This bug does not affect the Mictotec CF compiler.
8386
 
8387
Minor changes:
8388
    * The "jats clobber" command will remove version definition file, if
8389
      one is being produced.
8390
 
8391
    * Using JATS within a Visual Studio project. The "rebuild all"
8392
      option now translates to the JATS unbuild command to do a better
8393
      job of cleaning the workspace.
8394
 
8395
    * Added GetPackageRoot() directive to support the packaging of MOS
8396
 
8397
    * Generate error message for misuse of the SubDir directive
8398
 
8399
    * Modified BuildName to allow an '-' in the name.
8400
      This provides backward compatibility with existing packages.
8401
 
8402
------------------------------------------------------------------------
8403
Version: JATS_2.8.0                                 Released: 17-Feb-05
8404
------------------------------------------------------------------------
8405
Major changes:
8406
    * Added some new WINCE based targets. These require WINCE SDKs to be
8407
      installed in order for the compilers to work.
8408
 
8409
    * New PLATFORMS are WCEIT3000, WCEPA961 and WCEPCM7220
8410
 
8411
    * All invocations of xmake specify the name of the makefile
8412
      This allow GNUMakefiles and the Jats makefiles to exist in the
8413
      same directory
8414
 
8415
    * Overcome a limitation of the Microtec compiler in which the flag
8416
      _DEBUG is defined enev in production builds - contrary to the
8417
      documenattion.
8418
 
8419
Minor changes:
8420
    * Process of descpkg files allows for both Unix and DOS line endings
8421
      Under Unix JATS would report that the package names don't match
8422
 
8423
    * Corrected a problem with BuildPkgArchive in which file names with
8424
      spaces could not be soft linked. Only affects Unix systems.
8425
 
8426
    * Added a -rename to the "jats label" utility.
8427
      Ensure that the user specified label exists in the VOB
8428
 
8429
    * Correct problem with "make clean" that resulted in a verbose display
8430
      when the verbose option had not been selected
8431
 
8432
    * Correct a problem with "make unbuild". Changes in the build files
8433
      would prevent the execution of the command. This command should
8434
      be exempt from this test.
8435
 
8436
    * Correct a problem with "make clean" in the WIN32 and WINCE
8437
      platforms where the .exp files were not deleted.
8438
 
8439
    * The "JATS clobber" command now invokes "make clobber" and "build
8440
      clobber". The result is as clean a clean as it can be.
8441
 
8442
      Note: Jats "clean" does not remove a lot of files. These can be
8443
      removed with "unbuild" and "unpackage". This is what "clobber"
8444
      does.
8445
 
8446
    * The operation of "build clobber" has been cleaned up. It will
8447
      not try to invoke make if the makefiles have already been removed.
8448
 
8449
 
8450
------------------------------------------------------------------------
8451
Version: JATS_2.7.0                                 Released: 09-Feb-05
8452
------------------------------------------------------------------------
8453
Major changes:
8454
    * First release with support for the DAFBR compiler
8455
 
8456
    * Extended MergeLibrary. Added per-file options of:
8457
        --Interface         - Pull lib from Interface directory
8458
        --Local             - Pull lib from Local directory (default)
8459
        --SubDir=pathname   - Pull lib from a subdirectory
8460
                              Note: xxxx,pathname still works
8461
 
8462
    * Added "jats label" to provide a number of useful labeling
8463
      operations.
8464
 
8465
    * Added extensive help to JATS. JATS -man.
8466
 
8467
    * Added this manual ChangeLog file
8468
 
8469
Minor changes
8470
    * Added an 'ebin' command to jats to allow the JATS binary tools to
8471
      be run in a controlled environment from the command line.
8472
 
8473
    * Prune the list of library paths passed through to the various
8474
      toolsets. If a directory does not have any files in it then the
8475
      directory is not added to the library path.
8476
 
8477
      Thus if a library is located in xxxx/lib/WIN32 then JATS will
8478
      not add the xxxx/lib to the path.
8479
 
8480
    * cbuilder will now look in all VOBs for the user specified label.
8481
      The program has a list of "known" labels which it will search
8482
      first in an attempt to speed up the process.
8483
 
8484
    * The AddFlags directive will issue a warning if the flags does not
8485
      begin with a -D or a -U. The user should not be using compiler
8486
      specific flags.
8487
 
8488
    * The use of linker flags will issue a warning.
8489
 
8490
    * Process the common makefile.pl after the toolset has been
8491
      determined. This allows the toolset to extend the CompileOptions
8492
      such they are available to the common makefile.pl.
8493
 
8494
    * Added the WIN32 CompileOptions "jats_v1" to force JATS to specify
8495
      a number of compile time definitions used by earlier versions of
8496
      JATS.
8497
 
8498
    * Fixed bug in the --Debug option to the PackageProg directives that
8499
      caused both the production and debug versions to be packaged.
8500
 
8501
    * The gen_msproject utility now creates simpler names for the MS
8502
      projects that it creates. The name no longer contains the full
8503
      pathname, thus making them shorter and readable.
8504
 
8505
    * The ShowDlls utility now handles absolute and relative paths to
8506
      the initial DLL or EXE.
8507
 
8508
    * Correct problem in which the use of Generate/Rule directives may
8509
      fail since prerequisite subdirectories were not being created
8510
      since the "generate" phase was not being run.
8511
 
8512
      Added messages to prompt the user to remove Generate, Generated
8513
      and Rule directives. Use the GenerateFiles directive
8514
 
8515
    * JATS.BAT file will exclude LINUX builds by default.
8516
 
8517
    * The make NODEPEND=1 processing now does not recurse at all.
8518
      Previously each subdirectory was visited - only to do nothing.
8519
 
8520
    * Correct a problem in creating stub libraries for MOS targets if
8521
      the stub library object was not listed with the SharedLib's
8522
      objects.
8523
 
8524
    * Correct a problem with the MS Studio support. The invoked make
8525
      command is XXX_all_debug. There was a problem with this command in
8526
      that it did not do any dependancy checking and would not always
8527
      build defendants.