Jon Trulson f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
..
BUGREPORT f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
CLOSEDBUGS f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
OPENBUGS f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
README-2.1.10 f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
README-2.1.20 f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
README-2.1.30 f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
README-2.1.30.snapshot f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
ReleaseNotes.ps f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
ReleaseNotes.sgm f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago
copyright.old f5a8836bff historical: mv some old files that we want to preserve out of the top level 12 years ago

README-2.1.10


**********************************************************************
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.