DECwindows Motif Version 1.2-5 for OpenVMS Release Notes

DECwindows Motif
Version 1.2-5 for OpenVMS
Release Notes


December 1998

This manual describes new features, software problems, corrections, restrictions, and documentation changes that pertain to DECwindows Motif Version 1.2-5 for OpenVMS Alpha and OpenVMS VAX.

Revision/Update Information: This manual supersedes the DECwindows Motif Version 1.2-4 for OpenVMS Release Notes.

Operating System: OpenVMS Alpha Version 6.2
VMS Version 5.5-2

Software Version: DECwindows Motif Version 1.2-5 for OpenVMS Alpha
DECwindows Motif Version 1.2-5 for OpenVMS VAX



Compaq Computer Corporation
Houston, Texas


December 1998

Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.

Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor.

Compaq conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community.

© Compaq Computer Corporation 1998. All rights reserved.

The following are trademarks of Compaq Computer Corporation: Alpha, Compaq, DECdirect, DECwindows, DIGITAL, OpenVMS, VAX, VAX DOCUMENT, VAXcluster, VMS, and the Compaq logo.

The following are third-party trademarks:

Adobe, Adobe Illustrator, Display POSTSCRIPT, and POSTSCRIPT are registered trademarks of Adobe Systems Incorporated.

Motif, OSF, OSF/1, OSF/Motif, and Open Software Foundation are registered trademarks of the Open Software Foundation, Inc.

Mosaic and NCSA Mosaic are trademarks of the University of Illinois.

POSIX is a registered trademark of the IEEE.

X Window System is a trademark of the Massachusetts Institute of Technology.

All other trademarks and registered trademarks are the property of their respective holders.

ZK6537

Contents Index


Preface

The DECwindows Motif Version 1.2-5 for OpenVMS product incorporates the Common Desktop Environment (CDE) Motif 1.0 Toolkit (OSF/Motif Release 1.2.5) and is based on Release 5 of the X Window System Intrinsics. As with DECwindows Motif Version 1.2 and Version 1.2-4 for OpenVMS, DECwindows Motif Version 1.2-5 for OpenVMS continues to provide run-time support for the XUI user interface and Toolkit. Application development is supported for the CDE Motif 1.0 Toolkit.

On Alpha systems, the New Desktop is derived from the Common Desktop Environment (CDE). The user interface that was provided in previous versions of DECwindows Motif is now referred to as the DECwindows desktop. The system manager can install either the New Desktop or the DECwindows desktop, or both. In addition, the user can select which desktop is started during the DECwindows startup procedure.

In this manual, DECwindows XUI (X User Interface) refers to the DECwindows product prior to DECwindows Motif Version 1.0.

These release notes describe new features, software problems, corrections, restrictions, and documentation changes that pertain specifically to DECwindows Motif Version 1.2-5 for OpenVMS software. They also describe software problems, corrections, restrictions, and documentation changes from previous DECwindows Motif releases that have not been updated in the existing documentation for those products. Margin notes indicate the first version of the DECwindows Motif product to which each release note applies.

Intended Audience

This manual contains information for system managers, users and programmers who use the DECwindows Motif software.

Document Structure

This manual contains the following information:

Related Documents

For additional information on the Open Systems Software Group (OSSG) products and services, access the following OpenVMS World Wide Web address:


http://www.openvms.digital.com 

Reader's Comments

Compaq welcomes your comments on this manual.

Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:
Internet openvmsdoc@zko.mts.dec.com
Fax 603 884-0120, Attention: OSSG Documentation, ZKO3-4/U08
Mail Compaq Computer Corporation
OSSG Documentation Group, ZKO3-4/U08
110 Spit Brook Rd.
Nashua, NH 03062-2698

How To Order Additional Documentation

Use the following World Wide Web address to order additional documentation:


http://www.openvms.digital.com:81/ 

If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825).

Conventions

In this manual, any reference to OpenVMS is synonymous with Compaq OpenVMS.

VMScluster systems are now referred to as OpenVMS Cluster systems. Unless otherwise specified, references to OpenVMS Clusters or clusters in this document are synonymous with VMSclusters.

In this manual, every use of DECwindows and DECwindows Motif refers to DECwindows Motif for OpenVMS software.

The following conventions are also used in this manual:
Ctrl/ x A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.
[Return] In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.)

In the HTML version of this document, this convention appears as brackets, rather than a box.

... Horizontal ellipsis points in examples indicate one of the following possibilities:
  • Additional optional arguments in a statement have been omitted.
  • The preceding item or items can be repeated one or more times.
  • Additional parameters, values, or other information can be entered.
.
.
.
Vertical ellipsis points indicate the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.
( ) In command format descriptions, parentheses indicate that you must enclose the choices in parentheses if you choose more than one.
[ ] In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.)
[|] In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options.
{ } In command format descriptions, braces indicate required elements; you must choose one of the options listed.
text style This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason.

In the HTML version of this document, this convention appears as italic tex.

italic text Italic text emphasizes important information and indicates complete titles of manuals and variables. Variables include information that varies in system messages (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type).
UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
Monospace type

Monospace type indicates code examples and interactive screen displays.

In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example.

- A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.
numbers All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.


Chapter 1
General User Release Notes

This chapter contains information about DECwindows Motif for general users.

1.1 General User Release Notes Specific to the New Desktop (Alpha Only)

This section contains release notes for DECwindows Motif Version 1.2-5 for OpenVMS and the New Desktop.

1.1.1 dximageview TIF Error Messages

V1.2--4

When using dximageview to view TIF formatted files from the CDE$SYSTEM_DEFAULTS:[APPCONFIG.HELP.C.GRAPHICS] directory, the following warning messages are displayed:


TIFFOpen: Warning, unknown field with tag 34209 (0x85a1) ignored. 
TIFFOpen: XResolution: Rational with zero denominator (num = 200). 

Note this error only occurs with the TIF files in CDE$SYSTEM_DEFAULTS:[APPCONFIG.HELP.C.GRAPHICS]; it is only a warning. The file is still displayed correctly by the image viewer.

1.1.2 Text Editor Supports Standalone Mode Only

V1.2--4

The reference page for Text Editor describes a client/server implementation of the Text Editor. This release of the Text Editor supports the -"standAlone" option only and is not built as a client/server application.

1.1.3 Text Editor Does Not Support Spell Checking

V1.2--4

The Text Editor application, which is part of the New Desktop, is described in Chapter 10 of the Common Desktop Environment: User's Guide. The spell-checking function described in the section "To Correct Misspelled Words" is not implemented in this version of the Text Editor.

1.1.4 Tab Size Within the Text Editor Is Not 8 Characters Wide

V1.2--4

The Text Widget upon which the New Desktop Text Editor is based does not set the size of a tab to exactly the width of 8 characters; it is usually slightly larger. When displaying text with a combination of spaces and tabs, text may not appear vertically aligned.

1.1.5 Some File Names Appear in UNIX Format

V1.2--4

In the Application Manager Find dialog box and in error messages reported by the Help Viewer, file names are displayed in UNIX format rather than in standard OpenVMS format. For example, SYS$SYSROOT:[SYSMGR]LOGIN.COM appears as /sys$sysroot/sysmgr/login.com.

1.1.6 DECwindows Interface for the TPU Editor Does Not Save Itself

V1.2--4

Users will experience a 1-minute delay for each DECwindows Text Processing utility window displayed when exiting the session or when saving a home session.

The DECwindows interface for TPU (EVE editor) requires notification if its state needs to be saved, but it does not respond to that notification sent by Session Manager. The New Desktop Session Manager waits 1 minute for a response before continuing, resulting in the delay.

1.1.7 Front Panel Clock

V1.2--4

The New Desktop Front Panel Clock is an animated icon that displays the current system time using an analog display. The icon has no other function and does not support single-click or double-click operations.

1.1.8 Using MB3 on Front Panel Icons

V1.2--4

The New Desktop Front Panel supports mouse button 3 (MB3) operations. When the cursor is placed over a Front Panel icon and you press MB3, a subpanel, or menu, appears. The menu items are as follows:

1.1.9 Selecting Screens on Application Launch

V1.2--5

A new feature allows you to graphically select the screen on which a new application is displayed when launched from either the Front Panel, the File Manager, or the Application Manager. By default, the new application appears on the current screen (that is, the screen containing the mouse pointer). The new feature allows you to drop an application icon from the File Manager or Application Manager onto one of the numbered screen controls of the Set Default Screen window. This starts the application on the selected screen without changing the current screen.

The Set Default Screen window is activated as before by selecting the "Set Default Screen" application in the Application Manager's Desktop Tools folder. You can start a separate instance of the Set Default Screen window on each screen. The highlighting of the default screen is synchronized across all instances of the Set Default Screen window.

1.1.10 Detached Processes

V1.2--4

When you start an application (from the Front Panel or dtfile), a new detached process is created with a process name constructed from the user name, $CDE, and a three-digit numeric identifier.

For example, user SMITH starts an application whose process name is SMITH$CDE001. The next assigned process name would be SMITH$CDE002, unless SMITH$CDE001 has already terminated and is available for reuse.

1.1.11 ToolTalk Actions Not Supported

V1.2--4

Creation of ToolTalk Action definitions in the Action Definition files (*.dt) as described in the Common Desktop Environment: Advanced User's and System Administrator's Guide is not supported in this release. Although some ToolTalk actions exist in the Action Definition files installed with this product, modification of these actions is not supported and could cause some New Desktop functions to fail.

1.1.12 Session Manager Save/Restore Limitations

V1.2--4

The Session Manager supplied with the New Desktop supports the WM_SAVE_YOURSELF protocol for the following DECwindows applications: Bookreader, DECterm, and Calendar. Applications that have been written to take advantage of this protocol can:

The New Desktop applications support save/restore, but many existing DECwindows Motif applications have not been modified to support the WM_SAVE_YOURSELF protocol.

The impact of this difference between existing and new applications can be seen during a logout/login sequence as follows:

An example of an existing DECwindows Motif application that supports save/restore is DECwindows Mail.

1.1.13 Limitations of dtfile (New Desktop--Alpha Only)

V1.2--4

The dtfile application has the following limitations:

1.1.14 Login and Pause Screen Text Fields

V1.2--4

The following sections provide information about the Login Screen and Pause Screen text fields.

1.1.14.1 Control Characters Not Recognized When Entering Username

The New Desktop does not support entering control characters in the login Username text field. If entered, these characters are discarded. This differs from the DECwindows login Username text field which supports such key sequences as:

The New Desktop does support Ctrl/U, which when typed while entering a password at login or when unpausing the screen, erases any characters entered up to that point.

1.1.14.2 Return Key Used to Move Between Login Text Fields

V1.2--4

Because the Username text field and Password text field are different dialog boxes in the New Desktop, press the Return key to move the cursor from the Username text field to the Password text field. The Tab key does not move the cursor to the next text field; rather, this action highlights the OK button.

1.1.14.3 First Character Discarded When Entering Pause Screen Password

V1.2--4

If the workstation is paused and the Password dialog box is not displayed, the first character typed is ignored. This differs from the DECwindows pause screen, which always accepts any characters typed.

When using the New Desktop, use a nontyping key, such as Shift, or move the mouse to redisplay the Pause dialog box before entering your password. If you are unsure of what you have already typed, you can use Ctrl/U to erase the Password text field.

1.1.14.4 Text On The Welcome Screen May Not Appear

V1.2--4

If the 100-dpi fonts are not included in the X server's font path, the welcome text is not displayed on the blue welcome screen that appears immediately after logging in. This may also occur if you are displaying your session on a remote X server.

1.1.15 Use SET DISPLAY/CREATE Within DECterm Windows

V1.2--4

From a privileged account, if you use the SET DISPLAY command from within a DECterm window without the /CREATE qualifier, it changes the display used for any application created from that point forward. It also redefines the display on which the login box appears after logging out.

Always use the /CREATE qualifier when setting the display from a DECterm if you have not set the display already.

1.1.16 Viewing Reference Pages

V1.2--4

This release of DECwindows contains a new collection of help files for the New Desktop called reference pages (also known as man pages). Reference pages are divided into sections and, on OpenVMS, the file extension indicates the section. Sections distributed with the release include the following:
Section Purpose Extension
1 Applications filename.1
3 Libraries/programming filename.3
4 Programming filename.4
5 Include file formats filename.5

A version of dthelpview has been set up with the appropriate action definition for manpage viewing. The process logical MANPATH has been defined to point to the CDE$SYSTEM_DEFAULTS:[MAN] directory that contains all of the reference page files.

You can use either of the following methods to start dthelpview and display reference pages:

Method 1

To start dthelpview from DECterm and view a reference page called dtaction.1:

  1. At the DCL level or in a LOGIN.COM file, define dthelpview as a foreign command by entering the following:


    $ dthelpview :== - 
    _"$ sys$sysdevice:[sys0.syscommon.cde$defaults.system.bin]dthelpview.exe" 
    

  2. At the DCL level, enter:


    $ dthelpview -"manPage" dtaction.1
    

Method 2

To start dthelpview from Application Manager and view the reference page called dtaction.1:

  1. Start Application Manager.
  2. Double click on the Man Page Viewer icon located in the Desktop Apps application group. A dialog box appears.
  3. Enter the reference page to be viewed and click on OK.


Next Contents Index