Preface

Solaris Common Desktop Environment: Motif Transition Guide addresses:

• Issues of concern to Sun Motif developers

• How to run existing OPEN LOOK and Motif applications on the OpenWindows^TM 3.6 and Solaris Common Desktop Environment (CDE) desktops

• Porting OPEN LOOK and Motif applications to the Solaris CDE environment

This manual assumes you are familiar with OPEN LOOK or Motif programming. Use it in conjunction with Motif and OPEN LOOK manuals to enable your application to run on the latest Sun desktops.

---

Note -

This book generically uses the terminology Solaris Motif for the Motif toolkit that is included with either the Solaris CDE unbundled software or the Solaris software.

---

Who Should Use This Book

Read Solaris Common Desktop Environment: Motif Transition Guide if you are:

• A Motif programmer interested in developing Solaris Motif applications for the OpenWindows 3.6 or Solaris CDE desktop

• An OPEN LOOK or Motif programmer, and you want your existing applications to run on the OpenWindows 3.6 or Solaris CDE desktop with little or no code modification

• Interested in porting your OPEN LOOK or Motif application to the Solaris CDE desktop

This manual assumes that you are proficient in OPEN LOOK (XView^TM or OLIT) or Motif application development on UNIX® platforms. If you are an OPEN LOOK developer, it assumes you are familiar with Motif, as well.

Before You Read This Book

If you are considering porting your application to the Solaris CDE desktop, and you are not familiar with CDE, you should first read:

• Common Desktop Environment: Programmer's Overview

  Common Desktop Environment: Programmer's Overview provides a high level view of the CDE development environment components. It also includes an architectural overview of the entire CDE system, including both the run-time (end user) and development environments.

• Solaris Common Desktop Environment: User's Guide

  Solaris Common Desktop Environment: User's Guide provides an in-depth description of the CDE run-time environment.

See Appendix C, Recommended Reading for a listing of all the CDE documentation.

How This Book Is Organized

This manual consists of these chapters and appendixes:

Chapter 1, Moving to Motif and CDE provides a roadmap to using this manual, depending on what types of tasks you want to perform on your application.

Chapter 2, Motif Environment contains information for developers writing Solaris Motif applications for either the OpenWindows or CDE environment.

Chapter 3, Solaris Motif Toolkits describes the Solaris Motif toolkit and identifies the non-standard parts of the Solaris 2.3 (IXI) Motif toolkit.

Chapter 4, Development Environment Transition Issues compares and contrasts the OpenWindows and CDE development environments.

Chapter 5, Toolkit Transition Issues discusses transitioning your application from an OPEN LOOK graphical user interface (GUI) to Solaris Motif.

Chapter 6, Porting Issues and Ideas provides information to consider for porting your OPEN LOOK application to CDE.

Chapter 7, Porting Example: OPEN LOOK to Solaris Motif presents a simple porting example.

Appendix A, User Interaction Changes describes the user interaction changes from the OPEN LOOK to the CDE user model.

Appendix B, Internationalization and CDE describes the things you must do differently from the OpenWindows environment to internationalize an application for the CDE desktop.

Appendix C, Recommended Reading lists books and articles on issues related to OPEN LOOK, Motif, and CDE application development.

Related Books

For a list of the CDE documentation and reading material of interest to OPEN LOOK and Motif developers, see Appendix C, Recommended Reading.

Ordering Sun Documents

Fatbrain.com, an Internet professional bookstore, stocks select product documentation from Sun Microsystems, Inc.

For a list of documents and how to order them, visit the Sun Documentation Center on Fatbrain.com at http://www1.fatbrain.com/documentation/sun.

Accessing Sun Documentation Online

The docs.sun.com^SM Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://docs.sun.com.

What Typographic Conventions Mean

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories; on-screen computer output	Edit your .login file. Use ls -a to list all files. machine_name% you have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	machine_name% su Password:
AaBbCc123	Command-line placeholder: replace with a real name or value	To delete a file, type rm filename.
AaBbCc123	Book titles, new words, or terms, or words to be emphasized.	Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P-2 Shell Prompts

Shell	Prompt
C shell prompt	machine_name%
C shell superuser prompt	machine_name#
Bourne shell and Korn shell prompt	$
Bourne shell and Korn shell superuser prompt	#