cde/README-2.1.30.snapshot

   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 snapshot release prior to the third and final
  16         maintenance release for CDE and Motif 2.1.  It was designed to
  17         resolve as many defects as possible from the project's defect
  18         database.  This maintenance release resolves 243 problem reports
  19         against CDE and Motif 2.1.20.
  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.30 snapshot release is provided as a compressed
  35         tar archives consisting of a sparce tree (i.e. only those files
  36         which have been added or which have been modified since 2.1.20).
  37
  38
  39         README-2.1.30.snapshot - this file
  40
  41         cde.tar.Z             - a compressed tar file of the
  42                                 CDE 2.1.30 snapshot source code
  43
  44         cde-test.tar.Z        - a compressed tar file of the
  45                                 CDE 2.1.30 snapshot tests
  46
  47         cde-test-misc.tar.Z   - a compressed tar file of
  48                                 test results for CDE/Motif
  49                                 2.1.30 snapshot
  50
  51         motif.tar.Z           - a compressed tar file of the
  52                                 MOTIF 2.1.30 snapshot source code
  53
  54         motif-test-misc.tar.Z - a compressed tar file of
  55                                 test results for Motif 2.1.30
  56                                 snapshot
  57
  58
  59         The CDE/Motif 2.1.30 snapshot release is in the form of a sparse tree;
  60         that is, it contains only files that have been added or modified in
  61         either CDE or Motif since the 2.1.20 release.  If you are a CDE
  62         licensee you will receive files for both CDE and Motif.  If you are
  63         a Motif-only licensee you will receive files just for Motif.
  64
  65         After ftp-ing the files to your machine, you should first uncompress
  66         the compressed (*.Z) files with the command:
  67
  68                 uncompress <filename>.Z
  69
  70         Once the tar archives have been uncompressed, you can untar each
  71         with the command:
  72
  73                 tar xvf <filename>.tar
  74
  75         This command will preserve the .tar file while unloading its contents
  76         into your current working directory.  If you wish to list a table of
  77         contents of the tar file before actually unloading it you can do so
  78         with the command:
  79
  80                 tar tvf <filename>.tar
  81
  82
  83 INSTALLING THIS RELEASE
  84
  85         This release is made up of a "sparse tree" of files that have been
  86         added or changed since release 2.1.20. The new versions of the files
  87         should replace the corresponding CDE or Motif 2.1.20 versions of the
  88         files in your source tree.
  89
  90
  91         After the release is unloaded, you can use, for example, cp -R command
  92         to copy the sources from the current directory into your source tree.
  93         This release creates several new files.  If you are using a symbolic
  94         link tree, you will need to create new links for them.
  95
  96         Please see the Release Notes from 2.1 for instructions on building
  97         a full release tree.
  98
  99
 100 IMPORTANT CHANGES IN THIS RELEASE
 101
 102 Defect Repair
 103
 104         This patch release resolves 243 problem reports against CDE and
 105         Motif 2.1.20.  Each of these defects were resolved in one of three
 106         ways: fixed (problem was recreated and repaired), duplicate
 107         (problem was already reported and recorded in defect database),
 108         or cancelled (problem could not be recreated in current code
 109         base).  The breakdown by component and resolution type is:
 110
 111         FIXED:          Total  174
 112
 113         CDE Code:  40           Motif Code:  51
 114         CDE Doc:    1           Motif Doc:    0
 115         CDE Test:  43           Motif Test:  39
 116         --------------          ---------------
 117         Total:     84           Total:       90
 118
 119         DUPLICATE:      Total   25
 120
 121         CDE Code:   2           Motif Code:   4
 122         CDE Doc:    0           Motif Doc:    0
 123         CDE Test:   0           Motif Test:  19
 124         --------------          ---------------
 125         Total:      2           Total:       23
 126
 127         CANCEL:         Total   44
 128
 129         CDE Code:  13           Motif Code:  19
 130         CDE Doc:    0           Motif Doc:    0
 131         CDE Test:   2           Motif Test:  10
 132         --------------          ---------------
 133         Total:     15           Total:       29
 134
 135         TOTAL:          Total  243
 136
 137         CDE Code:  55           Motif Code:  74
 138         CDE Doc:    1           Motif Doc:    0
 139         CDE Test:  45           Motif Test:  68
 140         --------------          ---------------
 141         Total:    101           Total:      142
 142
 143
 144         For more information on the bugs resolved, see the file
 145         CLOSEDBUGS in this release.
 146
 147 Test Improvements
 148
 149         A significant number of CDE and Motif test defects were resolved
 150         for the CDE/Motif 2.1.30 snapshot release.  For the most part, these
 151         represent an ongoing effort to establish a clean baseline in
 152         Motif and reduce the overhead of false negatives in CDE.
 153
 154 BUG LISTS
 155
 156         In the release archive there are two files, OPENBUGS and
 157         CLOSEDBUGS, which contain, respectively, the list of all bugs
 158         from any version of CDE or Motif not yet closed, and all bugs
 159         from CDE or Motif fixed in this patch release.
 160
 161
 162 BUILDING MOTIF FOR YOUR SYSTEM
 163
 164         Since X11 is NOT being delivered as part of this release, there
 165         are some minor changes in the build process for Motif with respect
 166         to the build process described in the 2.1 Release Notes.
 167
 168         Replace step 2 under the Building Motif subsection of Section 3:
 169
 170           2.  If you are building with imports (the default setup in site.def),
 171               construct the necessary links as follows:
 172
 173               % cd $CDEBUILDDIR/motif
 174               % mkdir -p imports/x11
 175               % cd imports/x11
 176               % ln -s <X11_bin_directory> bin
 177               % ln -s <X11_includes_directory> includes
 178               % ln -s <X11_libs_directory> libs
 179
 180
 181 REFERENCE PLATFORMS
 182
 183         The Open Group has used a number of platforms during the
 184         development of the CDE/Motif 2.1.30 snapshot release.  However,
 185         the following reference platforms are the only ones where the
 186         snapshot test cycle was run.  Test results appear below.
 187
 188
 189    CDE and Motif:
 190         HP9000/7xx running HP-UX 10.20
 191         Sun SPARCstation running Solaris 2.4
 192                 using the SC 4.0 C compiler and SC 4.1 C++ compilers
 193
 194
 195    Changes to X11R6.4:
 196
 197         Both the 2.1.20 and the 2.1.30 snapshot releases of CDE and Motif
 198         have been built and tested upon a base of X11R6.4 patchlevel 3.
 199         During the development of 2.1.20, a significant defect in the I18N
 200         code of X was discovered.  The symptom is that when XMODIFIERS is
 201         not set, there is a possibility of memory corruption.   It is
 202         recommended that the following patch be applied if it has not
 203         already been done:
 204
 205         *** imInt.c@@/main/5       Sat May 30 21:04:36 1998
 206         --- xc/lib/X11/imInt.c       Mon Aug 24 16:17:25 1998
 207         ***************
 208         *** 1,4 ****
 209         ! /* $TOG: README-2.1.30.snapshot /main/1 1999/06/29 12:30:31 devobj $ */
 210           /******************************************************************
 211
 212                      Copyright 1992, 1993, 1994 by FUJITSU LIMITED
 213         --- 1,4 ----
 214         ! /* $TOG: README-2.1.30.snapshot /main/1 1999/06/29 12:30:31 devobj $ */
 215           /******************************************************************
 216
 217                      Copyright 1992, 1993, 1994 by FUJITSU LIMITED
 218         ***************
 219         *** 166,174 ****
 220           _XimMakeImName(lcd)
 221               XLCd         lcd;
 222           {
 223         !     char* begin;
 224         !     char* end;
 225         !     char* ret;
 226               int       i = 0;
 227               char* ximmodifier = XIMMODIFIER;
 228
 229         --- 166,174 ----
 230           _XimMakeImName(lcd)
 231               XLCd         lcd;
 232           {
 233         !     char* begin = NULL;
 234         !     char* end = NULL;
 235         !     char* ret = NULL;
 236               int       i = 0;
 237               char* ximmodifier = XIMMODIFIER;
 238
 239         ***************
 240         *** 182,189 ****
 241               }
 242               ret = Xmalloc(end - begin + 2);
 243               if (ret != NULL) {
 244         !       (void)strncpy(ret, begin, end - begin + 1);
 245         !       ret[end - begin + 1] = '\0';
 246               }
 247               return ret;
 248           }
 249         --- 182,192 ----
 250               }
 251               ret = Xmalloc(end - begin + 2);
 252               if (ret != NULL) {
 253         !       if (begin != NULL && end != NULL) {
 254         !           (void)strncpy(ret, begin, end - begin + 1);
 255         !           ret[end - begin + 1] = '\0';
 256         !         }
 257         !       else *ret = '\0';
 258               }
 259               return ret;
 260           }
 261
 262
 263 TEST RESULTS SUMMARY
 264
 265         Since this is a snapshot release, only those components which were
 266         modified have undergone quality assurance testing.  The cycle for
 267         the 2.1.30 snapshot includes running the following test suites:
 268
 269                 QATS - Motif Quality Assurance Test Suite
 270
 271                 Automated regressions tests in the following directories:
 272
 273                     Toolkit/Buttons
 274                     Toolkit/ComboBox
 275                     Toolkit/Container
 276                     Toolkit/Converters
 277                     Toolkit/Form
 278                     Toolkit/IconVC
 279                     Toolkit/List
 280                     Toolkit/Manager
 281                     Toolkit/Menus
 282                     Toolkit/Message
 283                     Toolkit/Notebook
 284                     Toolkit/PanedWin
 285                     Toolkit/Primitive
 286                     Toolkit/ResInd
 287                     Toolkit/Scrollbar
 288                     Toolkit/Select
 289                     Toolkit/Shells
 290                     Toolkit/SpinBox
 291                     Toolkit/Text
 292                     Toolkit/Traversal
 293                     Toolkit/Windows
 294                     XmString
 295                     uil/EnumVal
 296                     uil/ForRef
 297                     uil/ResInd
 298                     uil/Syntax
 299                     uil/widgets
 300
 301                 Manual regression tests in the following directories:
 302
 303                     Toolkit/Manual
 304                     uil/Manual/callUil
 305                     uil/Manual/dataStructs
 306                     uil/Manual/validator
 307                     uil/Manual/Callback
 308                     uil/Manual/NL
 309
 310
 311                 CDE Regression Tests for the following components:
 312
 313                     DefConfig
 314                     DevEnv
 315                     DtHelp
 316                     DtSvc
 317                     dragdrop
 318                     dtcm
 319                     dthelp
 320                     dtlogin
 321                     dtmail
 322                     dtsession
 323                     dtwm
 324
 325         The results of these test runs can be found in the release
 326         archive under cde-test-misc/reports/cde-2.1.30/.../2.1.30C2.