- 1 - 1. Introduction This release contains software and documentation for the Silicon Graphics, Inc.r, IRIX IM Execution-Only Environment product, version 1.2.4, for use on IRISr workstations. This version of the IRIX IM software is Silicon Graphics' port of the OSF/Motif version 1.2.4 General Availability Release. This product contains the Motif window manager (mwm), together with associated configuration files and manual pages. Note: Packaged with this software is a separate sheet that contains the Software License Agreement. This software is provided to you solely under the terms and conditions of the Software License Agreement. Please take a few moments to review the Agreement. This document contains the following chapters: 1. Introduction 2. Installation Information 3. Changes and Additions 1.1 Release_Identification_Information Following is the release identification information for motif_eoe: Software Option Product IRIX IM Execution- Only Environment Version 1.2.4 System Software Requirements IRIX 5.0 or later 1.2 Online_Release_Notes After you install the online documentation for a product (the relnotes subsystem), you can view the release notes on your screen. You can also view the release notes directly from the CD, without installing them; see the pamphlet in the CD case for instructions. If you have a graphics system, select ``Release Notes'' from the Help toolchest. This displays the grelnotes(1) graphical browser for the online release notes. - 2 - Refer to the grelnotes(1) man page for information on options to this command. If you do not have a graphics system, you can use the relnotes command. Refer to the relnotes(1) man page for accessing the online release notes. 1.3 Product_Support Silicon Graphics, Inc., provides a comprehensive product support maintenance program for its products. If you are in North America and would like support for your Silicon Graphics-supported products, contact the Technical Assistance Center at 1-800-800-4SGI. If you are outside North America, contact the Silicon Graphics subsidiary or authorized distributor in your country. - 1 - 2. Installation_Information This chapter lists supplemental information to the IRIS Software Installation Guide. The information listed here is product-specific; use it with the Installation Guide to install this product. 2.1 motif_eoe_Subsystems The motif_eoe product includes these subsystems: motif_eoe.man.eoe Preformatted reference manual pages. This subsystem is intended to be installed on machines that do not have the nroff text formatting program. There is no need to install this subsystem if you install motif_eoe.man.eoemansrc. motif_eoe.man.eoemansrc Source for the reference manual pages. This subsystem is intended to be installed on machines that do have the nroff text formatting program. This subsystem displays better looking manual pages (especially the tables) and displays them faster than the preformatted manual pages. There is no need to install this subsystem if you install motif_eoe.man.eoe. motif_eoe.man.relnotes Online release notes. motif_eoe.sw.eoe Motif shared libraries and mwm configuration files. motif_eoe.sw.mwm mwm, the Motif Window Manager motif_eoe.sw.uil uil, the user interface language compiler. 2.2 Installation_Method All of the subsystems for the Motif Execution-Only Environment can be installed using IRIX. You do not need to use the miniroot. Refer to the IRIS Software Installation Guide for complete installation instructions. - 2 - 2.3 motif_eoe_Subsystem_Disk_Space_Requirements This section lists the subsystems of the motif_eoe software, along with their sizes and whether they are installed by default. If you are installing this option for the first time, the subsystems marked ``default'' are installed if you use the ``go'' menu item. To install a different set of subsystems, use the ``install,'' ``remove,'' ``keep,'' and ``step'' commands in inst to customize the list of subsystems to be installed, before you select the ``go'' menu item. Note: The listed subsystem sizes are approximate. Refer to the IRIS Software Installation Guide for information on finding exact sizes. Subsystem Name Subsystem Size (512-byte blocks) motif_eoe.man.eoe (default) 287 motif_eoe.man.eoemansrc 295 motif_eoe.man.relnotes (default) 28 motif_eoe.sw.eoe (default) 12165 motif_eoe.sw.mwm 709 motif_eoe.sw.uil 621 2.4 Prerequisites Your workstation must be running IRIX 5.0 or later to use 1.2.4 IRIX/Motif. Use of imake requires either IRIX 5.3 or IRIX 6.0. This is because the imake configuration files are compatible with X11R6, which appears for the first time in those releases. 2.5 Compatibility o A static shared library, binary identical to that provided with 4D-4.0.5, is included with IRIX 5. That means old Motif binary applications can run unchanged. Such applications get neither the bug fixes nor the new features that are provided with the new library. o Applications must be linked with the libraries from this release to get the new features and bug fixes. - 3 - 2.6 Configuration_Files o All configuration files are the OSF/Motif 1.2.4 configuration files. o /usr/lib/X11/system.mwmrc controls the system-wide mwm settings. You can control your own settings by copying this file to your own home directory and renaming it .mwmrc. If you do that, your settings replace the system settings when you run mwm. o /usr/lib/X11/app-defaults/Mwm contains the system-wide application resource default values for mwm. You can override any particular values you wish by setting the corresponding resource wherever you store your private resource settings. - 1 - 3. Changes_and_Additions The version of IRIX IM provided with IRIX 4.0.5 was ported from OSF/Motif 1.1.4. The version of IRIX IM provided with IRIX 5.2 is based on OSF/Motif 1.2.4. This section summarizes new functionality and enhancements since the IRIX 4 release. Refer to the Programmer's Reference Manual for more detailed information. o This release is derived from OSF/Motif 1.2.4, and has those features. It also has SGI bug fixes and extensions. o This release is based on X11R5, and has those features. o Internationalization, based on the capabilities of X11R5, including the locale concept, is provided. o Drag and Drop is now provided. o libXm is now compatible with editres. Motif applications linked with this release automatically get that ability. o Tear-off menus are supported. With TearOff Menus, you can retain menus on the display for subsequent selections. Each tearable menupane has a tear-off button. When the mouse drag button is pressed on the tear-off button, the pane tears off and can be dragged; the pane can be placed by releasing the mouse drag button. The window manager surrounds the tear-off menupane with a menu button and a title. Shifting focus to a torn-off menu's windowpane follows standard window manager policy. o Visual sensitivity has been added. Visual indicators are provided that tell you whether a component can respond to your input. Labels and buttons have had this behavior in previous releases. In Release 1.2, the behavior is extended to the XmList, XmText, XmTextField, XmScrollBar, and XmArrowButton widgets. 3.1 Visual_Changes o Several pixels have changed in the 3-D beveled look. o Color generation routines include minor changes. o A location cursor surrounding all items in a List is added whenever a List widget has the focus and the - 2 - current keyboard item is not visible. o There are minor layout differences due to bug fixes in geometry management. o A title widget can be specified in a Frame widget. New constraint resources XmNchildType, XmNchildHorizontalAlignment, XmNchildHorizontalSpacing, and XmNchildVerticalAlignment have been added for specifying the position and alignment of the title in the Frame. o A new resource, XmNaudibleWarning, has been added to the VendorShell widget to specify whether an audible cue should accompany a warning message. Text widgets determine the value for this resource from the value of XmNaudibleWarning. o You can specify default background color and thresholds for shadow calculation on a per-screen basis with three new resources on the XmScreen widget: XmNlightThreshold, XmNdarkThreshold, and XmNforegroundThreshold. o You can traverse via the keyboard to some widgets that did not support traversal in previous releases. For example, inside a tab group, you can now use the arrow keys to traverse to all control descendants that are not contained within a nested tab group and are eligible to receive focus, even if the controls are not direct children of the tab group. o The left, right, up, and down traversal arrows navigate within a menupane. The up and down arrows wrap between columns, and the right and left arrows post the previous or next menupane when in the rightmost and leftmost column of the menupane, respectively. o To comply with the Style Guide, the default binding for osfMenu has changed fromF4 to Shift F10. o There is a new client, xmbind. It sets up the virtual bindings for use by Motif applications. This is already done at mwm startup, so xmbind is only required if mwm is not used, or to change the virtual bindings without restarting mwm. Note: /usr/lib/X11/system.motifbind is no longer present. Instead, there is a directory of bindings, /usr/lib/Xm/bindings/fP. - 3 - 3.2 Changes_for_CUA_and_Windows_Compliance In IRIX IM 1.2, pressing or osfActivate (usually bound to the keypad key) no longer activates a button that is outside a menu. For example, it no longer pops up an OptionMenu or activates a ToggleButton in a dialog box. If there is a default button associated with an XmBulletinBoard, pressing (except in a multi-line XmText), + , or osfActivate while focus is in the XmBulletinBoard activates the default button. 3.3 mwm_Enhancements The following changes have been incorporated into the Motif Window Manager (mwm): o An internationalized .mwmrc file o Internationalized dialog messages o Built-in default root menu o Support for the continuation character (``\'') in the .mwmrc file o Search XBMLANGPATH for bitmap files o Support for pop-down and replay event behavior in mwm menus o Widget names used by mwm exposed in documentation o Support scrolled window traversal to scrolled-off children in icon box o and key modifiers treated as different modifiers o Support for the SHAPE non-rectangular window extension The window manager includes these new or enhanced resources: feedbackGeometry Sets the position of the move/resize feedback window. The default is the center of the screen. frameBorderWidth Now defaults based on the size and resolution of the screen. - 4 - iconPlacement Now takes the additional value tight for automatic icon placement with no gaps between icons. maximumClientSize Now takes vertical or horizontal as values. moveOpaque Controls whether an image of the window, or just an outline, is moved. resizeBorderWidth Now defaults depending on the size and resolution of the screen. usePPosition Takes values of on, off, or nonzero to control whether program-specified positions are used. The window manager includes these new and enhanced functions: f.lower Includes a within argument to move the window within the application stacking order, but retains the parent window below the children rule. Also, includes a freeFamily argument to move the window absolutely without regard to its local family stack. Both modifiers move the window within the local family stack, but do not move the family stack. f.minimize This function is now allowed from an icon in an iconbox. f.raise Includes a within argument to move the window within the application stacking order, but retains the parent window below the children rule. Also, includes a freeFamily argument to move the window absolutely without regard to its local family stack. Both modifiers move the window within the local family stack, but do not move the family stack. f.raise_lower Includes a within argument to move the window within the application stacking order, but retains the parent window below the children rule. Also, includes a freeFamily argument to move the window absolutely without regard to its local family stack. Both modifiers move the window within the local family stack, - 5 - but do not move the family stack. f.restore Restores a window to its previous state. Double-clicking on a root icon is bound to this function rather than to f.normalize. f.restore_and_raise Restores a window to its previous state and raises it to the top of the window stack. Double-clicking on an icon in an iconbox is bound to this function rather than to f.normalize. f.screen Traverses to the screen specified by arg. Legal values are next, prev, last, or a specific screen number. There is one new mwm action: Behaves similarly to the f.next_key, except that the window is always raised regardless of the value of focusAutoRaise. 3.4 UIL_Changes The following changes have been made to UIL: o A new command flag, -s, which enables the use of setlocale and the creation of localized Compound Strings o New UIL syntax to support font sets and font tables o New UIL syntax to support wide character strings o Support for widget references as callback tags o New UIL syntax to specify resources of automatically created children o Syntax changes to WML to allow for the definition of automatically created children of composite widgets o Ability to read binary databases (WMD files) containing WML information with the -wmd file option