cde/historical/README-2.1.20

   1
   2 **********************************************************************
   3 NOTE: CDE/MOTIF IS LICENSED SOFTWARE.  SOURCE AND OBJECT CODE IS NOT
   4 TO BE DISTRIBUTED TO THIRD PARTIES EXCEPT AS PROVIDED BY THE TERMS OF
   5 YOUR LICENSE AGREEMENT.  PASSIVE DISTRIBUTION TO UNIDENTIFIED PARTIES,
   6 SUCH AS MAKING FILES AVAILABLE FOR UNRESTRICTED ELECTRONIC FILE
   7 TRANSFER, IS STRICTLY PROHIBITED BY THE LICENSE.
   8
   9 THESE RESTRICTIONS APPLY TO ANY PARTY TO WHOM THE SOFTWARE HAS BEEN
  10 DISTRIBUTED.
  11 **********************************************************************
  12
  13 THE PURPOSE OF THIS RELEASE
  14
  15         This is the second maintenance release for CDE and Motif 2.1.
  16         It was designed to resolve as many defects as possible from the
  17         project's defect database.  This maintenance release resolves 423
  18         problem reports against CDE and Motif 2.1.10.
  19
  20
  21         The Open Group encourages the reporting of all bugs found in CDE
  22         and Motif regardless of the platform or hardware configuration in
  23         which the bug is found.  However, The Open Group will commit to
  24         accept (and repair according to priority) only those bugs that can
  25         be replicated on the current reference configurations.
  26
  27
  28 DOWNLOAD INSTRUCTIIONS
  29
  30         This section describes how to unload the release archives
  31         available at this ftp site, including information about how much
  32         disk space is required.
  33
  34         The CDE/Motif 2.1.20 release is provided as compressed tar archives.
  35
  36
  37         README-2.1.20         - this file
  38
  39         cde.tar.Z             - a compressed tar file of the
  40                                 CDE 2.1.20 source code
  41
  42         cde-test.tar.Z        - a compressed tar file of the
  43                                 CDE 2.1.20 tests
  44
  45         cde-test-misc.tar.Z   - a compressed tar file of
  46                                 test results for CDE/Motif 2.1.20
  47
  48         motif.tar.Z           - a compressed tar file of the
  49                                 MOTIF 2.1.20 source code
  50
  51         motif-test-misc.tar.Z - a compressed tar file of
  52                                 test results for Motif 2.1.20
  53
  54
  55         The CDE/Motif 2.1.20 release is in the form of a sparse tree; that
  56         is, it contains only files that have been modified in either CDE or
  57         Motif since the 2.1.10 release.  If you are a CDE licensee you will
  58         receive files for both CDE and Motif.  If you are a Motif-only
  59         licensee you will receive files just for Motif.
  60
  61         After ftp-ing the files to your machine, you should first uncompress
  62         the compressed (*.Z) files with the command:
  63
  64                 uncompress <filename>.Z
  65
  66         Once the tar archives have been uncompressed, you can untar each
  67         with the command:
  68
  69                 tar xvf <filename>.tar
  70
  71         This command will preserve the .tar file while unloading its contents
  72         into your current working directory.  If you wish to list a table of
  73         contents of the tar file before actually unloading it you can do so
  74         with the command:
  75
  76                 tar tvf <filename>.tar
  77
  78
  79 INSTALLING THIS RELEASE
  80
  81         This release is made up of a "sparse tree" of files that have changed
  82         since release 2.1.10. The new versions of the files should replace the
  83         corresponding CDE or Motif 2.1.10 versions of the files in your source
  84         tree.
  85
  86
  87         After the release is unloaded, you can use, for example, cp -R command
  88         to copy the sources from the current directory into your source tree.
  89         This release creates several new files.  If you are using a symbolic
  90         link tree, you will need to create new links for them.
  91
  92         Please see the Release Notes from 2.1 for instructions on building
  93         a full release tree.
  94
  95
  96 IMPORTANT CHANGES IN THIS RELEASE
  97
  98 Defect Repair
  99
 100         This patch release resolves 423 problem reports against CDE and
 101         Motif 2.1.10.  Each of these defects were resolved in one of three
 102         ways: fixed (problem was recreated and repaired), duplicate
 103         (problem was already reported and recorded in defect database),
 104         or cancelled (problem could not be recreated in current code
 105         base).  The breakdown by component and resolution type is:
 106
 107         FIXED:  Total  298
 108
 109                 CDE Code:  193          Motif Code:  68
 110                 CDE Doc:     1          Motif Doc:    0
 111                 CDE Test:   32          Motif Test:   4
 112                 --------------          ---------------
 113                 Total:     226          Total:       72
 114
 115         DUPLICATE:      Total  42
 116
 117                 CDE Code:  19           Motif Code:  11
 118                 CDE Doc:    0           Motif Doc:    0
 119                 CDE Test:  11           Motif Test:   1
 120                 --------------          ---------------
 121                 Total:      30          Total:       12
 122
 123         CANCEL: Total  83
 124
 125                 CDE Code:  35           Motif Code:  22
 126                 CDE Doc:    0           Motif Doc:    1
 127                 CDE Test:  20           Motif Test:   5
 128                 --------------          ---------------
 129                 Total:      55          Total:       28
 130
 131
 132         For more information on the bugs resolved, see the file
 133         CLOSEDBUGS in this release.
 134
 135 Test Improvements
 136
 137         Several changes were made for CDE 2.1.20 to streamline the
 138         automated testing process.   Included are necessary fixes in
 139         order to significantly improve test performance times, as well
 140         as to eliminate test hangs.
 141
 142         Specific fixes include
 143
 144         CDExc23856  deiconify tests have logic backwards
 145
 146         This was a legacy bug in QATS that caused many tests to hang when
 147         doing an iconify/deiconify combination in order to force expose
 148         events
 149
 150         CDExc23824  DtAction tests take extremely long to complete
 151
 152         Since X events were being processed once every thirty seconds, test
 153         performance has been improved from overnight to twenty minutes
 154
 155         CDExc23843  dtpad tests need speeding up on the printing delays
 156
 157         When outputting characters to the screen dtpad was incorrectly
 158         sleeping for one half second between each one.  The performance
 159         of this suite has improved from twelve hours to five hours.
 160
 161 BUG LISTS
 162
 163         In the release archive there are two files, OPENBUGS and
 164         CLOSEDBUGS, which contain, respectively, the list of all bugs
 165         from any version of CDE or Motif not yet closed, and all bugs
 166         from CDE or Motif fixed in this patch release.
 167
 168
 169 BUILDING MOTIF FOR YOUR SYSTEM
 170
 171         Since X11 is NOT being delivered as part of this release, there
 172         are some minor changes in the build process for Motif with respect
 173         to the build process described in the 2.1 Release Notes.
 174
 175         Replace step 2 under the Building Motif subsection of Section 3:
 176
 177           2.  If you are building with imports (the default setup in site.def),
 178               construct the necessary links as follows:
 179
 180               % cd $CDEBUILDDIR/motif
 181               % mkdir -p imports/x11
 182               % cd imports/x11
 183               % ln -s <X11_bin_directory> bin
 184               % ln -s <X11_includes_directory> includes
 185               % ln -s <X11_libs_directory> libs
 186
 187
 188 REFERENCE PLATFORMS
 189
 190         The Open Group has used a number of platforms during the
 191         development of the 2.1.20 release.  However, the following
 192         reference platforms are the only ones where the complete
 193         test cycle was run.  Test results appear below.
 194
 195
 196    CDE and Motif:
 197         HP9000/7xx running HP-UX 10.20
 198         Sun SPARCstation running Solaris 2.4
 199                 using the SC 4.0 C compiler and SC 4.1 C++ compilers
 200
 201
 202    Changes to X11R6.4:
 203
 204         CDE and Motif 2.1.20 have been built and tested upon a base of
 205         X11R6.4 patchlevel 3.  During the development of 2.1.20, a
 206         significant defect in the I18N code of X was discovered.  The
 207         symptom is that when XMODIFIERS is not set, there is a possibility
 208         of memory corruption.   It is recommended that the following patch
 209         be applied:
 210
 211         *** imInt.c@@/main/5       Sat May 30 21:04:36 1998
 212         --- xc/lib/X11/imInt.c       Mon Aug 24 16:17:25 1998
 213         ***************
 214         *** 1,4 ****
 215         ! /* $TOG: imInt.c /main/5 1998/05/30 21:11:16 kaleb $ */
 216           /******************************************************************
 217
 218                      Copyright 1992, 1993, 1994 by FUJITSU LIMITED
 219         --- 1,4 ----
 220         ! /* $TOG: imInt.c /main/6 1998/08/24 16:22:12 mgreess $ */
 221           /******************************************************************
 222
 223                      Copyright 1992, 1993, 1994 by FUJITSU LIMITED
 224         ***************
 225         *** 166,174 ****
 226           _XimMakeImName(lcd)
 227               XLCd         lcd;
 228           {
 229         !     char* begin;
 230         !     char* end;
 231         !     char* ret;
 232               int       i = 0;
 233               char* ximmodifier = XIMMODIFIER;
 234
 235         --- 166,174 ----
 236           _XimMakeImName(lcd)
 237               XLCd         lcd;
 238           {
 239         !     char* begin = NULL;
 240         !     char* end = NULL;
 241         !     char* ret = NULL;
 242               int       i = 0;
 243               char* ximmodifier = XIMMODIFIER;
 244
 245         ***************
 246         *** 182,189 ****
 247               }
 248               ret = Xmalloc(end - begin + 2);
 249               if (ret != NULL) {
 250         !       (void)strncpy(ret, begin, end - begin + 1);
 251         !       ret[end - begin + 1] = '\0';
 252               }
 253               return ret;
 254           }
 255         --- 182,192 ----
 256               }
 257               ret = Xmalloc(end - begin + 2);
 258               if (ret != NULL) {
 259         !       if (begin != NULL && end != NULL) {
 260         !           (void)strncpy(ret, begin, end - begin + 1);
 261         !           ret[end - begin + 1] = '\0';
 262         !         }
 263         !       else *ret = '\0';
 264               }
 265               return ret;
 266           }
 267
 268
 269 TEST RESULTS SUMMARY
 270
 271         Since this is a general availability release, it has undergone
 272         the full quality assurance cycle. The cycle includes running the
 273         following test suites:
 274
 275                 QATS - Motif Quality Assurance Test Suite
 276                 VSM 4.1  - Motif Validation Suite
 277                 CDE Regression Tests
 278
 279         The results of these test runs can be found in the release
 280         archive under cde-test-misc/reports/cde-2.1.20.  Note that the
 281         the journal files (.prt) and other output results generated by
 282         QATS have been included for the first time.