CONTENTS

  Title Page

  Copyright Page

  Preface

  1      DECwindows Motif Version 1.2-3 for OpenVMS New Features
    1.1 OSF/Motif Release 1.2.3 Toolkit
    1.2 POLYCENTER Software Installation Utility Integration
    1.3 DECterm Features
      1.3.1      Scrolling Through the Keyboard
      1.3.2      Reporting the DECterm Window Size
      1.3.3      Resizing the Terminal
      1.3.4      Timeout for Displaying the Copyright Notice
      1.3.5      Cross-Hair and Rubberband-Line Cursor Support
    1.4 DECwindows Mail Enhancements
    1.5 DECnet/OSI Full Names Support
    1.6 Internationalization Enhancements
      1.6.1      Using the CDA Viewer to View Asian-Language Text
        1.6.1.1      Specifying an Options File
        1.6.1.2      Defining Logical Names
      1.6.2      Converting Files That Contain Asian-Language Characters
    1.7 NCSA Mosaic Browser
      1.7.1      Starting Mosaic Software
      1.7.2      Creating a Home Page
      1.7.3      Configuring Mosaic to Process Multimedia Files
      1.7.4      Customizing the Mosaic Browser
      1.7.5      Restrictions for Using Mosaic from Behind a Firewall
        1.7.5.1      ProxyGateway Resource
        1.7.5.2      NoProxy Resource
    1.8 Console Window Application
    1.9 Using Shareable Linkages to Install Images
    1.10 Window Manager Overlay Support

  2      General User Release Notes
    2.1 Notes Specific to DECwindows Motif Version 1.2-3 for OpenVMS Software
    2.2 Using Drag and Drop
    2.3 Using Tear-Off Menus
    2.4 Access Control Not Explicitly Enabled by Default
    2.5 Toolkit Warning in the Work in Progress Dialog Box
    2.6 DECwindows Motif Application Notes
      2.6.1      Bookreader
        2.6.1.1      Draft-Quality Printing
      2.6.2      Including Comment Characters in the DECW$BOOKSHELF File
      2.6.3      Calendar
        2.6.3.1      Data-File Format
        2.6.3.2      Additional Problems and Restrictions
      2.6.4      Cardfiler
      2.6.5      CDA Run-Time Services
        2.6.5.1      CDA Dynamic Font Support
        2.6.5.2      CDA WRITE$FONTS Logical Name
        2.6.5.3      CDA Documents
        2.6.5.4      CDA PostScript Documents
      2.6.6      CDA-Additional Applications
        2.6.6.1      Pack and Unpack Applications
        2.6.6.2      Pack Application
        2.6.6.3      Unpack Application
        2.6.6.4      Pack and Unpack Error Messages
      2.6.7      CDA-Hints, Restrictions, and Known Problems
        2.6.7.1      Display PostScript with the CDA Viewer
        2.6.7.2      Message for CDA Viewer
        2.6.7.3      CDA Paper Size Button Renamed
        2.6.7.4      CDA Watch Progress Restriction
        2.6.7.5      CDA Viewer Supports DECfonts Version 1.2
        2.6.7.6      CDA Viewer-Viewing PostScript Files with Errors
      2.6.8      Clock-DECsound Capability
      2.6.9      DECsound Application
        2.6.9.1      DECsound Prerequisites
        2.6.9.2      DECsound Problems
        2.6.9.3      Escape Sequences
      2.6.10     DECterm-Restrictions and Problems
        2.6.10.1     Changing the Auto Repeat Setting
        2.6.10.2     Positioning DECterm
        2.6.10.3     User Font Selection
        2.6.10.4     Local Echo
        2.6.10.5     Answerback Message
        2.6.10.6     Seven-Bit Printer Support
        2.6.10.7     VT330 and VT340 Terminal Emulation
        2.6.10.8     CREATE/TERMINAL/DETACHED/PROCESS
        2.6.10.9     Printing to an Attached Printer
        2.6.10.10    DECterm Graphics
        2.6.10.11    Initializing DECterm
        2.6.10.12    DECterm Resource Usage
        2.6.10.13    Diagnostic Crash File and Messages
        2.6.10.14    Monitor Screen Width Determines Default Font Size
        2.6.10.15    ReGIS Locator Report
      2.6.11     DECW$CDPLAYER
      2.6.12     LinkWorks
        2.6.12.1     Removing Support for LinkWorks Manager (DEClinks)
      2.6.13     DECwindows Mail
        2.6.13.1     Responses to Keyboard Actions
        2.6.13.2     Using the Color Customizer with DECwindows Mail
        2.6.13.3     DECwindows Mail-Known Problems
      2.6.14     DECwindows Motif Window Manager
        2.6.14.1     Using the Color Customizer with DECwindows Motif Window Manager
        2.6.14.2     Configuration File
        2.6.14.3     DECwindows XUI Applications
        2.6.14.4     Restarting Motif Window Manager
      2.6.15     Motif Window Manager-Known Problems
        2.6.15.1     Accelerators for Icon in Icon Box
        2.6.15.2     Application Started as Icon
        2.6.15.3     Customizing Color-Related Resources for Monochrome Monitors
        2.6.15.4     Customizing Colors on 4-Plane Displays
        2.6.15.5     Customizing Icon Placement in Icon Box
        2.6.15.6     DECwindows XUI Modal Dialog Boxes
        2.6.15.7     Customizing the Icon Box
        2.6.15.8     Moving the Icon Box Off Screen
        2.6.15.9     Truncating the Icon Title
        2.6.15.10    Invoking Motif Window Manager Help
        2.6.15.11    Multihead Systems-Customizing Colors
        2.6.15.12    Multiline Icon Title Not Centered
        2.6.15.13    Truncated Icon Title in Vertical Icon Box
      2.6.16     Notepad
        2.6.16.1     Notepad Is Linked with the OSF/Motif Release 1.1.3 Toolkit
      2.6.17     Paint
        2.6.17.1     Private Colormaps
        2.6.17.2     Enhancing the Performance of Some Paint Operations
      2.6.18     Print Screen
        2.6.18.1     Large Default Icon
      2.6.19     Session Manager and FileView
        2.6.19.1     Removing Support for LinkWorks Manager and LinkWorks
        2.6.19.2     Invoking DECchart from the Session Manager Applications Menu
        2.6.19.3     Eastern European Languages Now Available
        2.6.19.4     Security Options
        2.6.19.5     Using the Color Customizer with Session Manager
        2.6.19.6     Input Focus Change When Starting Private Logo
        2.6.19.7     Session Manager Process-Stopping
        2.6.19.8     Public Profiles for Layered Products
    2.7 Window Dump to Print File (xpr) Utility
    2.8 Keyboard Enhancements for Disabled Users
      2.8.1      Sticky Keys
      2.8.2      Mouse Keys
      2.8.3      Toggle Keys
      2.8.4      Repeat Keys
      2.8.5      Slow Keys
      2.8.6      Bounce Keys
      2.8.7      Time Out
    2.9 Printing from Applications
    2.10 Unsupported Translations by the Motif XmText Widget

  3      System Manager Release Notes
    3.1 Notes Specific to DECwindows Motif Version 1.2-3 for OpenVMS Software
    3.2 Required Reboot on OpenVMS Alpha Version 6.2 Systems
    3.3 DECwindows Motif Login Screen-Known Color Problem
    3.4 Color Customizer Example Program
      3.4.1      Supported Displays
      3.4.2      Supported Applications
      3.4.3      Building the Color Customizer on OpenVMS Systems
      3.4.4      Running the Color Customizer
      3.4.5      Modifying the DECW$LOGIN.COM File
      3.4.6      Command Interface Summary
      3.4.7      Changing the Mapping Between Color Resources and Color Cells
      3.4.8      DECterm Windows Not Affected
      3.4.9      Changing the Default Value of the Automatic Shadowing Toggle Button
      3.4.10     Using the Customizer on Multihead Systems
      3.4.11     Using the XSETROOT_CUST.EXE Demonstration Program
    3.5 Define DECW$UTILS Global Symbol When Moving DECW$EXAMPLES Global Symbol
    3.6 FileView Creates Detached Processes by Default
    3.7 Customizing the Login Screen
      3.7.1      Customizing the Digital Logo and Login Screen Colors
      3.7.2      Changing Positions of the Start Session and Set Password Dialog Boxes
      3.7.3      Disabling a Node Name Display in the Start Session Dialog Box
    3.8 Customized Login Logos
    3.9 Version Checking Command Files
    3.10 Implications of the Message, ``System Menu Bar: Pseudo Mouse Not Available''
    3.11 DECterm System Management Issues
      3.11.1     DECterm Logical Names
      3.11.2     Automatic Window Positioning
      3.11.3     Hold Screen Response Time
      3.11.4     Using the Debugger
      3.11.5     Virtual Terminal Support

  4      Programmer Release Notes
    4.1 Programming Release Notes Specific to DECwindows Motif Version 1.2-3 for OpenVMS Software
    4.2 DECwindows Motif for OpenVMS Toolkit Versions
    4.3 Run-Time and Programming Environments
    4.4 OSF/Motif Toolkit Compatibility
      4.4.1      _Xm Routines
      4.4.2      OSF/Motif Release 1.2.2 and X11 Release 5 Shareable Libraries
    4.5 Language Bindings
      4.5.1      OSF/Motif Release 1.1.3 Ada Bindings
    4.6 OSF/Motif Release 1.1.3 Programming Support and XUI
    4.7 Adding POSIX for OpenVMS Support to DECwindows Transports
      4.7.1      POSIX fork( ) Routine
      4.7.2      SYS$POSIX_FORK_CONTROL System Service
    4.8 Translated Image Support
      4.8.1      Running Translated Images on OpenVMS Systems
      4.8.2      DECwindows Motif Toolkit Functionality
    4.9 Cross-Development Tools
    4.10 Compiling Applications Written in C
    4.11 Compiling Applications Written in Fortran
    4.12 CDA Application
      4.12.1     CDA-Implementing the Drag-and-Drop Feature
      4.12.2     CDA Run-Time Services Features
        4.12.2.1     Version Number
        4.12.2.2     Changes to the Programming Interface for CDA
        4.12.2.3     Changes to External Reference Processing
        4.12.2.4     Message for Style Guide Fallback
        4.12.2.5     Using Logical Names with CONVERT Commands
        4.12.2.6     Restructuring Shareable Images
    4.13 DECterm Programming
      4.13.1     Page-Movement Escape Sequences
      4.13.2     DECCRA Sequence
      4.13.3     DECLFKC Sequence
      4.13.4     ReGIS Input Cursors
    4.14 DECwindows OSF/Motif Toolkit
      4.14.1     Compilation Error When Including Both CURSES.H and XMP.H Files
      4.14.2     Motif Text Widget Translations
      4.14.3     Upward Compatibility
        4.14.3.1     Restrictions on Mixing Motif and XUI Widgets
      4.14.4     Compile-Time Incompatibilities in Motif Header Files
    4.15 OSF/Motif Example Programs
      4.15.1     Cut and Paste Example Program
      4.15.2     DNDDemo Example Program
      4.15.3     Dogs Example Program
        4.15.3.1     Dog Widget
        4.15.3.2     Square Widget
      4.15.4     Helloint Example Program
      4.15.5     Hellomotif Example Program
      4.15.6     Motifanim Example Program
      4.15.7     Motifgif and Pict Viewing Programs
      4.15.8     Motifshell Example Program
      4.15.9     Periodic Example Program
      4.15.10    Textedit Example Program
        4.15.10.1    Additional Translations
      4.15.11    View Example Program
      4.15.12    Xmpiano Example Program
      4.15.13    Motif Sample Programs
      4.15.14    Xmtravel Example Program
      4.15.15    Resource Files for Example Programs
      4.15.16    UID Files for Example Programs
    4.16 DECwindows Extensions to Motif
      4.16.1     DXmCSText Input Method Support
      4.16.2     SVN-Horizontal Live Scrolling Not Supported
      4.16.3     SVN Horizontal Separator Line
      4.16.4     DXmFormSpaceButtonsEqually Restriction
    4.17 Display Server Extensions
      4.17.1     Display PostScript (DPS) Server Extension-Color Cells
      4.17.2     X Image Extension
      4.17.3     Client Side Extension Library
      4.17.4     Shared Memory Extension Support
        4.17.4.1     How to Use Shared Memory Extension
        4.17.4.2     Using Shared Memory XImages
        4.17.4.3     Using Shared Memory Pixmaps
      4.17.5     Using Extension Include Files
    4.18 Xlib Issues
      4.18.1     xlibint.h Is Now a Public Header File
      4.18.2     Command Procedure Builds .PEN Files
      4.18.3     Parameter/Protocol Datasize Mismatches
      4.18.4     XSelectAsyncEvent and XSelectAsyncInput Routines
      4.18.5     Xlib Internationalization
        4.18.5.1     Vendor Pluggable Layer
        4.18.5.2     Digital Internationalization Xlib Implementation
        4.18.5.3     Locale in OpenVMS Systems

  5      Documentation Release Notes
    5.1 Documentation Release Notes Specific to the DECwindows Motif Version 1.2-3 for OpenVMS Product
    5.2 DECwindows Motif Version 1.2-3 for OpenVMS Documentation
    5.3 DECwindows Motif Version 1.2-3 for OpenVMS Documentation Corrections
      5.3.1 DECwindows Motif for OpenVMS Applications Guide
        5.3.1.1      Enhancing Information About the Finish Printing Option
      5.3.2 Using DECwindows Motif for OpenVMS
        5.3.2.1      Using the Drag-and-Drop Feature
        5.3.2.2      Tear-Off Menus
        5.3.2.3      Adding Target Screen Options to Application Menu Items
        5.3.2.4      Changing the Startup Environment
        5.3.2.5      Enhancing Startup Performance
        5.3.2.6      Enhancing Hold-Screen Response Time
      5.3.3 Managing DECwindows Motif for OpenVMS Systems
        5.3.3.1      Global Symbols
        5.3.3.2      Security Options
        5.3.3.3      Displaying a Customized Logo
        5.3.3.4      Enabling and Disabling Access Control
      5.3.4 DECwindows Motif for OpenVMS Guide to Non-C Bindings
        5.3.4.1      GET_CHAR_STRUCT Function
      5.3.5 VMS DECwindows Guide to Xlib (Release 4) Programming:  VAX Binding
      5.3.6 DECwindows Extensions to Motif
        5.3.6.1      DXmNlayoutDirection Resource Constants
      5.3.7 DECwindows Motif Guide to Application Programming
        5.3.7.1      UIL Source Code for the OpenVMS DECburger Application
        5.3.7.2      Help Widget Implementation Code
        5.3.7.3      Help Widget Implementation-Callbacks
        5.3.7.4      Using UIL to Create the Help Widget
      5.3.8 Overview of DECwindows Motif for OpenVMS Documentation
    5.4 OSF/Motif List of Known Problems

  A OSF/Motif Release 1.2 Release Notes
    A.1 Performance Improvements
    A.2 Backward Compatibility
      A.2.1      Visual and Behavioral Compatibility
    A.3 Changes and New Features for OSF/Motif Release 1.2
      A.3.1      General Toolkit Changes
        A.3.1.1      Include File Changes
      A.3.2      Change in XT Translations
      A.3.3      ANSI C Compliance
      A.3.4      Display and Screen Specific Data
      A.3.5      Drag and Drop
      A.3.6      Tear-Off Menus
      A.3.7      Insensitive Visuals
      A.3.8      Other Visual Changes
      A.3.9      Titles for Frames
      A.3.10    Audible Warning
      A.3.11    Color Enhancements
      A.3.12    Baseline Alignment
      A.3.13    Expanded Traversal Set
      A.3.14    Two-Dimensional Menu Traversal
      A.3.15    Input Focus
      A.3.16    Traversal Access Functions
      A.3.17    Virtual Keys
      A.3.18    Resource Management
      A.3.19    Changes for CUA and Windows Compliance
    A.4 Changes and Enhancements to Specific Widgets
      A.4.1      XmClipboard
      A.4.2      XmCommand
      A.4.3      XmList
      A.4.4      XmMessageBox
      A.4.5      XmRowColumn and Menus
      A.4.6      XmScrollBar
      A.4.7      XmScrolledWindow
      A.4.8      XmSelectionBox, XmFileSelectionBox
      A.4.9      XmText
      A.4.10    XmTextField
      A.4.11    XmToggleButton, XmToggleButtonGadget
    A.5 Motif Window Manager Enhancements
      A.5.1      Changes to MWM
      A.5.2      New and Enhanced MWM Resources
      A.5.3      New and Enhanced MWM Functions
      A.5.4      New MWM Action
    A.6 Changes to the User Interface Language