-------------------------------------------------------


                             Open Motif 2.3.0 Beta

                              Release Notes

                             The Open Group
                                   and
                     Integrated Computer Solutions


This document provides Release notes for the Beta Release of Open Motif 2.3.0.
This contains information on what is new in Open Motif 2.3.0. Please see the
COPYRIGHT.MOTIF file included with this release.


THIS IS A BETA RELEASE
This is a Beta release of Open Motif 2.3. It is not intended for any production
use. Developers are urged to test existing applications against this release and
report any bugs they may find. Developers are also urged to try out the new
features including:

 * Client-side anti-aliased font support via XFT
 * UTF-8 and UTF8_STRING atom support
 * Ability to show text and pixmaps in Label, LabelGadget, and all
   derived widgets
 * Support of PNG and JPEG image formats in the same way as XPM is supported


Introduction

This document and accompanying text files contain important
information. Please read them carefully before starting the build and
installation procedures.

There are two ways to build Open Motif from source code: (Imake and AutoTools)

If you are using Imake please read INSTALL.imake for notes on how
to build and install this product using Imake. This method is depricated
due to lack of support. Users wishing to apply/test and patch the Imake system
should join the development mailing list; all contributions are welcome. 

Please see the file INSTALL.configure on how to build and install
this product using the autoconf tools. This method is now fully supported
and is the recommended build method.



1 What is Open Motif 2.3

Open Motif is the freely available source code distribution for the Motif
user interface component toolkit.  Open Motif is built on top
of the standard X Toolkit(Xt) and X11 libraries.

1.1 Overview of Open Motif

Open Motif 2.3 is an updated version of 2.2.  Any applications
built against a previous 2.X release of Open Motif will be binary
compatible with this release.  This is a source code release.
Pre-compiled versions are available for download at the MotifZone:

http://www.openmotif.org

After downloading this source distribution, it will need to be unpacked
and compiled.  The distribution contains the following items:

     libXm source code and include files
     Open Motif reference documentation (man pages)
     Utility libraries
     Demo programs


2 What is new in Open Motif 2.3

OpenMotif 2.3 has the following feature improvements:
 * Client-side anti-aliased fonts support via XFT
 * UTF-8 and UTF8_STRING atom support
 * Ability to show text and pixmaps in Label, LabelGadget and all
   derived widgets
 * Support of PNG and JPEG image formats in the same way as XPM is supported
 * 26 bugs fixes

The following bugs were fixed:

  2.3.0 Beta 2 January 2006 (This release) 

 * Fixed vulnerabilities in the libXpm code [CAN-2004-0914 (multiple vulnerabilities) 
   and CAN-2005-0605 (buffer overflow)] 
 * Got rid of the obsolete tmpnam() call in imake 
 * Fixed bug #1315 (Division by zero in List widget) 
 * Fixed bug #1314 (Buffer overflow in MrmItop.c on 64-bit systems) 
 * Fixed bug #1313 (getsubres.c has fallback resources defined that aren't
   terminated with NULL.) 
 * Fixed bug #1304 (Buffer overflow in MrmOpenHierarchy...()) 
 * Fixed bug #1297 (Insensitive XmPIXMAP XmPushButtons are stippled with the
   wrong color) 
 * Fixed bug #1294 (XmFileSelectionBox's XmNdirSpec resource misbehaves when
   pathMode is PATH_MODE_RELATIVE) 
 * Fixed bug #1294 (XmFileSelectionBox's XmNdirSpec resource misbehaves when
   pathMode is PATH_MODE_RELATIVE) 

  2.3.0 Beta 1 November 2005 

 * #1121 (TabBox translation error) - removed locking of he clipboard from
          XmClipboardRetrieveStart()
 * #1283 (TabBox translation error)
 * #1249 (XmCombo crashes program when resized)
 * #1286 (XmDataField error with XmALIGNMENT_END)
 * #1211 (Crash on setting XmNlabelPixmap in a ToggleButtonGadget)
 * #1264 (Crash in PutDSToStream due to bug in _XmResizeHashTable)
 * #1276 (Changing AddMode in XmList selects/deselects items without callback)
 * #1196 (Free memory read in XmIm.c/draw_separator())
 * #1193 (MWM crashes when restarting by a session manager)
 * #1202 (mwm crashes when duplicating a window menu containing f.circle_up)
 * #1186 (Invalid replacing XmList selected items)
 * #1214 (Cannot set a string to XmTextField with XtSetValues when
          XmNmodifyVerifyCallback is set)
 * #1279 (XmTextGetSelectionPosition returns incorrect values after deleting
          selection)
 * #1269 (popup menus fail on Tarantella/VNC)
 * #1262 (Entering Esc key before pulldown menu realized crashes)
 * #1268 (XmCvtXmStringToCT improperly handles empty string)
 * Added DataField.h and TabBox.h to XmAll.h
 * Added synthetic resolution independent conversion of width/height
          resources to ExtendedList for MultiList
 * Added wide character string value of search string to
          ExtendedListCallbackStruct
 * Made DropDown using XmGrabShell instead of TopLevelShell
 * #1260 (option menu changes screen's focus to 'None')
 * #1258 (XmDataField: data out-of-bounds bug in df_FindPixelLength)
 * #1257 (XmTextField: "Character xxx not supported in font" errors, bug
          in multibyte code)
 * #1256 (Problem with XmNsingleSelectionCallback in XmExt18List widget)
 * Fixed incorrect XmRenderTableToProp() behavior appeared in RendToProp test
 * Fixed incorrect XmClipboardCopyByName() behavior appeared in CutPaste2 test

3 Build Systems

Open Motif 2.3 was built and tested on the following systems:

- Linux 2.4 (Redhat Enterprise 2.1)
- Linux 2.6 (Redhat Enterprise 3.0)
- Linux 2.6 (SuSe 9.1)
- Linux 2.4 (Redhat Fedora Core 2)

In all cases the compiler originally provided with the OS was used.

3.1 OS Support

The following platforms are supported operating systems:

- Linux 2.4 (Redhat Enterprise 2.1)
- Linux 2.6 (Redhat Enterprise 3.0)
- Linux 2.6 (SuSe 9.1)
- Linux 2.4 (Redhat Fedora Core 2)

4 Filing Bug Reports

If you find a reproducible bug in any of the Open Motif libraries
or code, or an error in the documentation, please reference the
BUGREPORT file and/or submit a bug report online at the Open Motif
Development zone:

http://bugs.openmotif.org

The listing for the status of submitted bugs is maintained there.

5 Documentation

For postscript and pdf documentation (users guides and reference
manuals), see URL:

http://www.opengroup.org/openmotif/docs/

6 Compatibility Notice

OpenMotif 2.3 is binary compatible with OpenMotif 2.2.x. Applications
built against OpenMotif 2.2 should work with OpenMotif 2.3 without
having to recompile it.

OpenMotif 2.3 is not binary compatible with OpenMotif 2.1.30.
Applications built against OpenMotif 2.1.30 will need to be recompiled
with the OpenMotif 2.2+ header files.

7 Change Log
2.3.0 July 2005
This release.

2.2.4 October 2004

a. Fixed vulnerabilities in libXpm code [CVE numbers CAN-2004-0687 (integer
overflows) and CAN-2004-0688 (stack overflows)].
b. Fixed compilation under SUSE 9.1.
c. Fixed building procedure under FreeBSD.
d. Fixed building procedure in order to make it usable with new versions of
autoconfig.


2.2.3 August 2002

a. uil support for the new widgets was finished along with demonstrations in 
the periodic demo.

b. Several bugs were fixed. 

c. Automake building is supported in an object directory. 


2.2.1 January 29, 2002

a. The Test directory that contained the automated tests was 
mentioned in the Release Notes but absent from source distribution. 
The reference in the Release Notes was removed. The Tests are still
available from the CVS tree.

b. Due to an oversight, imake support was not included in 
distribution. It was added back in this update.

c. If an older version of Open Motif was installed, the Autoconf
build would pick up the older #include files and fail. The
Autoconf configuration files were updated to use the proper
#include files.

d. Formating errors in doc/man/man3/Makefile.am were corrected.

e. The directory demos/unsupported/motifshell contained no source 
code but was mentioned in configure.in. The proper source code was
placed in this directory.

f. ToolTip.c and SlideC.c were included in config.h twice. The
extra reference was removed.

g. The demos for the new widgets were originally placed in the
directory demos/programs/newwidgets. To maintain consistency,
they were moved to demos/programs.

h. The Releases Notes specified the incorrect resource names for
enabling tooltips and specifying the string. These typos were
corrected. 

i. Compatibility note for user developed widgets was added to
Release Notes.

2.2.0 January 28, 2002
Initial Release

