CONTENTS

  Title Page

  Copyright Page

  About This Guide

  1      Introduction to Porting

  1.1     Name Changes

  1.2     Toolkit

  1.3     Motif Window Manager

  1.4     User Interface Language

  1.5     User Interface Style

  1.6     Interoperability

  2      Converting Your XUI Files

  2.1     Before Converting Your Files

  2.2     Running the Filters

  2.3     Interpreting Output from the Filters

  3      After Converting Your Files

  3.1     Reviewing Conversion Output
    3.1.1      Creating a Listing of Differences
    3.1.2      Resolving Messages from Porting Filters
    3.1.3      Reviewing the File for Readability
    3.1.4      Making Additional Name Changes
    3.1.5      Reviewing High-Level Conversions
    3.1.6      Checking Return Values
    3.1.7      Checking Compound String Usage
    3.1.8      Checking UIL Files

  3.2     Reviewing Motif Toolkit Components and Making Changes
    3.2.1      Include Header Files
    3.2.2      Motif Widgets
    3.2.3      Digital Extended Motif Widgets
    3.2.4      Custom Widgets (Widget Programmers Only)
    3.2.5      Callback Records
    3.2.6      Callback Structures
    3.2.7      Compound String Usage
    3.2.8      Resolution Independence
    3.2.9      Scroll Bars
    3.2.10     Widget Layout

  3.3     Reviewing Intrinsics Features and Making Changes
    3.3.1      Specifying Application Context
    3.3.2      Reviewing X11 Release 4 Changes
    3.3.3      Before Compiling Your Application

  3.4     Compiling and Linking the Application

  3.5     Testing the Application

  3.6     Making Changes Required by the Motif Window Manager
    3.6.1      Checking MWM-Client Interaction
    3.6.2      Checking Keyboard Focus
    3.6.3      Checking Key and Mouse Bindings

  3.7     Making Changes Required by the OSF/Motif Style Guide
    3.7.1      Adding Menu Mnemonics
    3.7.2      Adding Keyboard Accelerators
    3.7.3      Adding Keyboard Traversal
    3.7.4      Checking Context-Sensitive Pop-up Menus

  4      Giving Information to Application Users

  4.1     Updating the Documentation

  A   Summary of XUI and OSF/Motif Differences

  A.1     Component Names
    A.1.1      Widget Classes
    A.1.2      Function Names
    A.1.3      Resource Names
    A.1.4      Enumeration Literal Names
    A.1.5      Callback Reason Names
    A.1.6      Compound Strings
    A.1.7      Fontlist Names
    A.1.8      Clipboard Names
    A.1.9      Resource Manager Names

  A.2     Terminology

  A.3     Windows and Window Managers

  A.4     Menus and Menu Items
    A.4.1      Window Menu
    A.4.2      Menu Bar and Standard Menus
    A.4.3      File Menu
    A.4.4      Edit Menu
    A.4.5      Help Menu

  A.5     Standard Message Boxes

  A.6     Mouse Buttons Behavior

  B   Porting Filter Summary

  C   Intrinsics Routine Summary

  FIGURES

  3-1        Direct Referencing of Callbacks

  TABLES

  3-1        Additional Name Changes Required for Conversion

  3-2        Compound String Resources Not to Be Freed