********************************************************************** NOTE: CDE/MOTIF IS LICENSED SOFTWARE. SOURCE AND OBJECT CODE IS NOT TO BE DISTRIBUTED TO THIRD PARTIES EXCEPT AS PROVIDED BY THE TERMS OF YOUR LICENSE AGREEMENT. PASSIVE DISTRIBUTION TO UNIDENTIFIED PARTIES, SUCH AS MAKING FILES AVAILABLE FOR UNRESTRICTED ELECTRONIC FILE TRANSFER, IS STRICTLY PROHIBITED BY THE LICENSE. THESE RESTRICTIONS APPLY TO ANY PARTY TO WHOM THE SOFTWARE HAS BEEN DISTRIBUTED. ********************************************************************** THE PURPOSE OF THIS RELEASE This is the first maintenance release for CDE and Motif 2.1. It was designed to resolve as many defects as possible from the project's defect database, with a concentration for CDE on dtmail problems. This maintenance release resolves 523 problem reports against CDE and Motif 2.1. The Open Group encourages the reporting of all bugs found in CDE and Motif regardless of the platform or hardware configuration in which the bug is found. However, The Open Group will commit to accept (and repair according to priority) only those bugs that can be replicated on the current reference configurations. DOWNLOAD INSTRUCTIIONS This section describes how to unload the release archives available at this ftp site, including information about how much disk space is required. The CDE/Motif 2.1.10 release is provided as compressed tar archives. README-2.1.10 - this file cde.tar.Z - a compressed tar file of the CDE 2.1.10 source code cde-test.tar.Z - a compressed tar file of the CDE 2.1.10 tests cde-test-misc.tar.Z - a compressed tar file of test results for CDE/Motif 2.1.10 motif.tar.Z - a compressed tar file of the MOTIF 2.1.10 source code motif-test-misc.tar.Z - a compressed tar file of test results for Motif 2.1.10 27 Mb motif-test-misc The CDE/Motif 2.1.10 release is in the form of a sparse tree; that is, it contains only files that have been modified in either CDE or Motif since the 2.1 release. If you are a CDE licensee you will receive files for both CDE and Motif. If you are a Motif-only licensee you will receive files just for Motif. To download the archives from the ftp site you will need approximately 18.5 megabytes (for CDE licensees) or 9.3 megabytes (for Motif-only licensees) of disk space to hold just the compressed archives. Once the archives have been downloaded they should be first uncompressed and then untarred (see instructions below). The uncompressed archives require approximately 91 (CDE) or 37 (Motif-only) megabytes. After untarring the archives, you will need an additional 96 (CDE) or 52 (Motif-only) megabytes of space to hold the unloaded directories. Once the tar operation has completed you may wish to remove the tar archive files (*tar). MOTIF-only CDE/Motif Mb Mb Files -- -- ----- (9.3 18.5 compressed archives ) 37 91 archives after uncompress 52 96 untarred archives 89 187 Total After ftp-ing the files to your machine, you should first uncompress the compressed (*.Z) files with the command: uncompress .Z Once the tar archives have been uncompressed, you can untar each with the command: tar xvf .tar This command will preserve the .tar file while unloading its contents into your current working directory. If you wish to list a table of contents of the tar file before actually unloading it you can do so with the command: tar tvf .tar INSTALLING THIS RELEASE This release is made up of a "sparse tree" of files that have changed since release 2.1. The new versions of the files should replace the corresponding CDE or Motif 2.1 versions of the files in your source tree. After the release is unloaded, you can use, for example, cp -R command to copy the sources from the current directory into your source tree. This release creates several new files. If you are using a symbolic link tree, you will need to create new links for them. Please see the Release Notes from 2.1 for instructions on building a full release tree. IMPORTANT CHANGES IN THIS RELEASE The majority of changes in this release are for general defect repair in the code and tests. Additionally, some focused work was performed in the following areas described below: X11R6.4 and XtMalloc Dtmail maintenance Japanese Translations Defect Repair This patch release resolves 523 problem reports against CDE and Motif 2.1. Each of these defects were resolved in one of three ways: fixed (problem was recreated and repaired), duplicate (problem was already reported and recorded in defect database), or cancelled (problem could not be recreated in current code base). The breakdown by component and resolution type is: FIXED: Total 326 CDE Code: 160 Motif Code: 91 Doc: 2 Test: 18 Test: 55 ------------- -------------- Total: 217 Total: 109 DUPLICATE: Total 51 CDE Code: 30 Motif Code: 10 Doc: 4 Test: 1 Test: 6 ------------- -------------- Total: 40 Total: 11 CANCEL: Total 146 CDE Code: 45 Motif Code: 49 Test: 36 Test: 14 Doc: 2 ------------- -------------- Total: 81 Total: 65 For more information on the bugs resolved, see the file CLOSEDBUGS in this release. X11R6.4 and XtMalloc The Open Group is comitted to a unified desktop technology (X, Motif and CDE). Therefore we built and tested CDE and Motif 2.1.10 against a pre-release version of X11R6.4. Once the final release of X11R6.4 is ready we will build and test with it. We do not expect to find any problems running with the production version but will provide any fixes if necessary. One important change that went into the X11R6.4 release was to fix the behavior of XtMalloc. The specification clearly state that XtMalloc should behave like the underlying malloc when passed a size of 0 (zero). The old XtMalloc would allocate space, even if it was passed a size of 0. In X11R6.4 XtMalloc no longer has this behavior. On some platforms this can cause failures with faulty code that depends on that behavior. We have found such calls in both the CDE and Motif code through our test cycle and by visual inspection and have repaired them along the way. There is the potential for additional problems of this form - developers should be alert to this possibility. If developers want the old behavior of XtMalloc then they should define both MALLOC_0_RETURNS_NULL and XTMALLOC_BC in their site.def file. Dtmail maintenance In addition to intensive efforts to fix outstanding defects throughout CDE and Motif, we paid special attention to problems in the CDE 2.1.10 Mailer. These problems include the following: - Support for X11R6 Session Management Protocol - Unified mailbox menus - Support for mail aliases - Support for mail retrieval from standard mail servers Support for X11R6 Session Management Protocol The CDE 2.1.10 Mailer now supports the basic elements of the X11R6 Session Management Protocol including responding to interactive and non-interactive SaveYourself requests as well as Die requests. For non-interactive SaveYourself requests, the Mailer simply saves the size and location of all the mailbox and compose windows. Deleted messages in mailboxes are retained. For interactive SaveYourself requests, the Mailer may display dialogs asking the user to verify that deleted messages should be expunged or that the contents of compose windows should be deleted. Unified file selection menus The CDE 2.1.10 Mailer now provides a consistent set of menus and file selection boxes for all operations involving mailboxes. These operations include Mailbox->Open, Message->CopyTo, and Move. Previously, each of these commands had its own file selection box. Changes made in one FSB were not reflected in any of the others. In addition, the Mailbox->Open command did not provide users with the menu of predefined mailboxes as in the Message->CopyTo, and Move commands. In the CDE 2.1.10 Mailer the operation of all three commands has been made completely consistent from the user's perspective. Similar fixes were made for all operations involving files including Message->SaveAsText and Attachments->SaveAs. Support for mail aliases Popup menus containing the user's predefined aliases were added to the address fields (To:, Cc:, and Bcc:) in the message composer dialogs. The user can now add an addressee to one of these fields simply by selecting from the menu of aliases. Support for mail retrieval from standard mail servers The CDE 2.1.10 Mailer has been fixed to support retrieving mail from standard mail servers. Supported Mail Server protocols include POP2, POP3, APOP, and IMAP. However, to date, only the POP3 has been well tested at The Open Group. Japanese Translations Deliverables of the CDE 2.1 project included translations of all documentation. The Japanese translations were not received in time for the 2.1 release but were delivered at the beginning of this year. They were made available electronically at that time to licensees and have also been included in this 2.1.10 release. This includes Japanese manual pages and books. BUG LISTS In the release archive there are two files, OPENBUGS and CLOSEDBUGS, which contain, respectively, the list of all bugs from any version of CDE or Motif not yet closed, and all bugs from CDE or Motif fixed in this patch release. BUILDING MOTIF FOR YOUR SYSTEM This release requires no changes in the build process. Please refer to the Release Notes for more information. REFERENCE PLATFORMS The Open Group has used a number of platforms during the development of the 2.1.10 release. However, the following reference platforms are the only ones where the complete test cycle was run. Test results appear below. CDE and Motif: HP9000/7xx running HP-UX 10.20 Digital Alpha 3000 running Digital Unix 4.0 Motif-only: Sun SPARCstation running Solaris 2.4 using the SC 4.0 C compiler and SC 4.1 C++ compilers TEST RESULTS SUMMARY Since this is a general availability release, it has undergone the full quality assurance cycle at The Open Group. The test cycle includes running the following test suites: MVS - Motif Validation Suite QATS - Motif Quality Assurance Test Suite CDE Regression Tests CDE Performance Tests Memory Tests The results of these test runs can be found in the release archive under cde-test-misc/reports/cde2.1.10.