XView Developer's Notes
  Search only this book
Download this book in PDF

Preface

XView Developer's Notes provides XView developer information not present in the O'Reilly XView documentation set. This manual contains three parts:
  • Motif interoperability and O'Reilly Supplements and Corrections (Part I, chapters 1 and 2)
  • Internationalizing XView applications (Part II, chapters 3 through 6 and appendices A through C)
  • Release Information (appendix D)
Part I discusses interoperability issues between the current XView release and Motif. It also contains corrections and supplements to the O'Reilly programmer (Third Edition) and reference documentation for XView Version 3. Part II enhances, and builds upon, XView internationalization information present in the O'Reilly documentation set and in other SunSoft manuals. Part III contains information specific to this release, such as new features.

Who Should Use This Book

This manual is intended for XView application developers, who are proficient in the C programming language and in XView programming.
Refer to the following O'Reilly and Associates manuals for help with the XView toolkit:
  • XView Programming Manual, Third Edition, for XView Version 3.2 (Volume 7) by Dan Heller
  • XView Reference Manual for XView Version 3.2 (Companion to Volume 7)
  • Xlib Programming Manual for Version 11 (Volume 1) by Adrian Nye
  • Xlib Reference Manual for Version 11 (Volume 2)
You can order these books through Sun Express or buy them at your local bookstore.
This manual assumes that you have access to the Developer's Guide to Internationalization.

Before You Read This Book

Read Appendix D, "XView Release Notes," for important information about this release.
Check the following manuals for any corrections or updates to information in this manual:

Internationalizing Applications

Before you start, be sure to prepare properly:
  • Read the Developer's Guide to Internationalization.
  • For Asian locales, install the applicable Asian language environment:

    · KLE for Korean

    · JFP for Japanese

    · HLE for traditional Chinese

    · CLE for simplified Chinese

Refer to the Internationalization chapter in the XView Programming Manual for information about attributes and functions that work well with English and western European languages. Part II of this manual describes new and modified attributes and functions that let your applications work in Asian locales as well.

Meta and Help Key Alternatives

If your keyboard does not have a Meta key, use the Control-Alt key sequence (pressed simultaneously) to perform the same functionality as Meta. If you do not want Control-Alt to serve as the Meta function, add the OpenWindows.CtrlAltMetaKey resource to your .Xdefaults file and set it to False.
The F1 function key serves as the Help key, if your keyboard does not have a Help key.

Typographical Conventions

Attributes, procedures, macros, and anything resembling C code are all set in Courier, using the following C conventions:
  • Procedures are lowercase and are followed by parentheses, as in:
xv_get()

  • Macros are all uppercase and are followed by parentheses, as in the following example, except where they are lowercase in source code:

    OPENWIN_EACH_VIEW()

  • Attributes are all uppercase but are not followed by parentheses, as in:

    CANVAS_MIN_PAINT_HEIGHT

Representations of anything that might appear on your screen are set in Courier. In addition, code examples are set in boxes to set them off from the surrounding text.

Further Documentation

American National Standard for Information Systems - Programming Language C, ANSI X3.159-1989, Published by American National Standard Institute.
OPEN LOOK GUI Functional Specification, International Extension, Unix International, Internationalization Working Group.
IEEE Standard Portable Operating System Interface for Computer Environments, POSIX 1003.1, IEEE Std 1003.1, Published by The Institute of Electrical and Electronics Engineering, Inc. ISBN 1-55937-003-3.
Xlib - C Language X Interface MIT X Consortium Standard X Version 11, Release 5.
X Window System C Library and Protocol Reference, Release 5 Version, Robert W. Scheifler & James Getty, 1992, Digital Press
X Programmers Supplement for Release 5, David Flanagan, 1991, O'Reilly and Associates
Japanese Input User's Guide, SunSoft
JFP User's Guide, SunSoft
JFP Programmer's Guide, SunSoft
Asian Solaris 2.4 User's Guide, SunSoft