Dear SCO Customer, The enclosed Support Level Supplement (SLS) lng311b provides COFF versions of the Motif 1.1.2 and the MIT X11R4 libraries. This SLS corrects many problems found in Motif 1.0 (provided in SCO Open Desktop Development System Release 1.0 and Xsight Development System Release 2.2) including several memory leaks. This SLS is designed to install on the following platforms: SCO Open Desktop Personal System Release 1.1 with: SCO Open Desktop Development System Release 1.0. (Both the TCP/IP Runtime and Development System components must be installed) SCO UNIX System V/386 Release 3.2 Operating System Version 2.0 with: SCO UNIX System V/386 Release 3.2 Development System SCO Xsight Development System Release 2.2 SCO TCP/IP Runtime System Release 1.1 SCO TCP/IP Development System Release 1.1 Because only COFF libraries are provided, SLS lng311b will not install on the SCO XENIX System V Operating System. Installation: SLS lng311b does not contain some files found on the existing SCO Open Desktop Development System Release 1.0, ODT-VIEW. For this reason, do not remove the existing development system prior to installing this SLS. SLS lng311b will overwrite several files provided with the SCO Open Desktop Development System Release 1.0 (libX11.a, libXt.a, libXm.a, include files and online manual pages). Therefore, if it becomes necessary to re-install the SCO Open Desktop Development System Release 1.0, be sure to remove SLS lng311b with custom first. To install SLS lng311b, take the following steps: (1) Log in as root. (2) To enter the custom program, type: custom (3) Select "Install". (4) Select "A New Product". (5) Select "Entire Product". (6) Follow the directions for inserting the requested disks or volumes. NOTE: If your system has less than 8 megabytes of free space in your root partition, custom will give you a message stating that you don't have enough disk space for the product. Unless you are very low (less than 2 megs free) on disk space, you can safely ignore this message, as SLS lng311b consists mostly of replacements for files that you already installed in the original X Development System and will increase disk usage only minimally. However, if your disk space is this low, you will quickly run out of space if you make a lot of the example programs. (7) Press any key to continue. (8) Select "Quit". (9) Select "y" to exit custom. The installation procedure is now complete. Documentation: Documentation on Motif 1.1.2 and X11R4 routines are provided through the online manual pages included with this SLS. Also available through the online manual pages are change descriptions for Xlib from X11R3 to X11R4, X Toolkit Intrinsics, from R3 to R4, as well as a change description for Motif from 1.0 to 1.1. To access these documents, issue the following commands: man XS CHANGES man Xt CHANGES man Xm CHANGES To print out these documents, issue the following commands: lp /usr/man/cat.XS/CHANGES.XS lp /usr/man/cat.Xt/CHANGES.Xt lp /usr/man/cat.Xm/CHANGES.Xm Libraries: This SLS does not include shared library versions of the Motif 1.1.2 and X11R4 libraries. These will be provided in the next release of SCO Open Desktop. This SLS does not include OMF versions of the Motif 1.1.2 and X11R4 libraries. Compiling: You must add the Programmers Workbench library "-lPW" to the end of your link line when compiling programs that use -lXt or -lXm. -lPW will correctly resolve the routine alloca(S). If -lPW is missing from the link line, the routine alloca(S), and possibly other routines, will be left as unresolved externals within /usr/lib/libXt.a and /usr/lib/libXm.a. If you are using imake to generate your makefiles, -lPW is provided in the sco.cf file and is included automatically. Examples: Included with SLS lng311b is a new examples directory, /usr/lib/X11/examples. To compile these programs, copy this directory to your home directory and type "make". For example: copy -r /usr/lib/X11/examples $HOME/examples cd $HOME/examples make The makefile and imakefile will only build the examples supplied on the SLS disks. The previously installed examples in /usr/lib/X11/xsample will need to be ported from X11R3/Motif 1.0 to X11R4/Motif 1.1 before they can be compiled with the libraries and header files supplied on this SLS. Refer to the online manual pages and the change description documentation mentioned above if you want to port these examples. Note that some of the xsample examples may successfully compile after adding the library -lPW to the end of the link line. However, many will dump core when they are run. Several of the examples found in /usr/lib/X11/examples will display warnings during compilation. These warnings can be safely ignored. The examples will function correctly. Several of the examples found in /usr/lib/X11/examples may issue errors when they fail to load new colors into the default colormap table if it is already full. The default colormap can hold only 16 colors. You may want to modify the colors used by these examples. The example /usr/lib/X11/examples/periodic will display only half of the pixmap images found in boxes 14 and 15 due to a problem in the SCO R3 X server. This also occurs in the example /usr/lib/X11/examples/mre where only half of the pixmap images appear in the top left column of the window. Note: X programs developed using Motif 1.1.2 and X11R4 libraries will work properly on both the R3 and R4 X servers. However, extensions available on an R4 X server will not be available to X programs connecting to an R3 X server. For example, the shape extension, which allows round windows, is not available on the R3 X server. The X11R4 libraries expect to find a keyboard support file in the directory /usr/lib/X11. This file 'XKeysymDB' is provided with SLS lng311b. If you are developing applications that will be run on systems that do not have this SLS installed, it will be necessary to provide the file /usr/lib/X11/XKeysymDB. This file is required to insure correct functionality of the Motif widgets' keyboard translations. This SLS is known to correct memory leaks in the functions XmList(Xm), XmLabel(Xm), XmStringCreateLtoR(Xm) and XmStringGetNextSegment(Xm). If you have any questions, please call our SCO Customer Services Department at (800) 347-4381. SCO Customer Service is available Monday through Friday, 6:00 A.M. to 5:00 P.M., Pacific Time. We appreciate your business. SCO Support Services