motif_eoe Release Notes

1 Introduction

2 Installation Information

3 Changes and Additions

 



                                  - 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 from F4 to ShiftF10.

          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