Software Product Description ___________________________________________________________________ PRODUCT: DECwindows Motif[R]/Hanyu SPD 46.94.02 for OpenVMS, Version 1.2-3 This Software Product Description describes the following two products: o DECwindows Motif/Hanyu for OpenVMS VAX Version 1.2-3 o DECwindows Motif/Hanyu for OpenVMS Alpha Version 1.2-3 DESCRIPTION DECwindows Motif/Hanyu for OpenVMS V1.2-3 is the traditional Chinese version of DECwindows Motif for OpenVMS V1.2-3. When used in conjunc- tion with OpenVMS/Hanyu, it extends the standard DECwindows Motif for OpenVMS V1.2-3 to provide internationalized windowing services for us- ing and developing internationalized DECwindows applications. It also extends the local language capabilities to support Chinese character input/output handling, to provide a Chinese language user interface, and to offer a Chinese language platform for developing Chinese DECwindows Motif applications. DECwindows Motif/Hanyu for OpenVMS V1.2-3 supports Chinese data that conforms to the CNS11643 character set standard of Taiwan with the EDPC extension area as a standard option. It also supports Big-5, DEC Hanyu & Taiwanese EUC encoding. This SPD describes only the internationalized and Chinese specific fea- tures which are extensions or additions to standard DECwindows Motif for OpenVMS. For a description of the base functionalities of DECwin- dows Motif for OpenVMS, please refer to Software Product Description (SPD 42.19.01). INTERNATIONALIZATION FEATURES Locale Switching DECwindows Motif/Hanyu for OpenVMS V1.2-3 provides a platform for developing locale-independent windowing applications. Applications developed using the technologies of X11R5 and OSF/Motif R1.2.3 toolkit can exhibit different local language behavior according to the locale setting. DECwindows Motif/Hanyu for OpenVMS V1.2-3 is based on the XPG locale model. Users can switch the language of an application by specifying the locale at startup time. This locale switching mechanism is also designed to be interoperable with other DECwindows Motif products, such as DEC OSF/1 and ULTRIX Worksystem Software. DIGITAL July 1995 DECwindows Motif[R]/Hanyu for OpenVMS, Version 1.2-3 SPD 46.94.02 DECwindows Motif/Hanyu for OpenVMS V1.2-3 supports a coexistence of different language variants on the same computing system, with the possibility of changing easily from one language to another. Language Variants Coexistence On the same system with DECwindows Motif/Hanyu for OpenVMS V1.2-3 it is possible to install the following DECwindows Motif V1.2-3 for OpenVMS language variants: o DECwindows Motif OpenVMS User Interface/Cesky V1.2-3 o DECwindows Motif OpenVMS User Interface/Magyar V1.2-3 o DECwindows Motif OpenVMS User Interface/Polski V1.2-3 o DECwindows Motif OpenVMS User Interface/Russkij V1.2-3 o DECwindows Motif OpenVMS User Interface/Slovensky V1.2-3 o DECwindows Motif/Hangul V1.2-3 for OpenVMS o DECwindows Motif/Hanzi V1.2-3 for OpenVMS o DECwindows Motif/Japanese V1.2-3 for OpenVMS o DECwindows Motif/Thai V1.2-3 for OpenVMS For more information about software prerequisites required to install these language variants, refer to the appropriate SPD, Release Notes and Installation Guide. The following DECwindows Motif V1.2-3 for OpenVMS language variants require the DECwindows Motif V1.2-3 for OpenVMS base product to be in- stalled and they CAN NOT be installed on the same system with DECwindows Motif Worldwide Support V1.2-3 for OpenVMS and DECwindows Motif/Hanyu V1.2-3: o DECwindows Motif OpenVMS User Interface/Deutsch V1.2-3 o DECwindows Motif OpenVMS User Interface/Español V1.2-3 o DECwindows Motif OpenVMS User Interface/Français V1.2-3 o DECwindows Motif OpenVMS User Interface/Italiano V1.2-3 o DECwindows Motif OpenVMS User Interface/Svenska V1.2-3 o DECwindows Motif/Hebrew V1.2-3 for OpenVMS Motif Toolkit/UIL Two Motif Toolkits are incorporated in DECwindows Motif/Hanyu for OpenVMS V1.2-3. They are based on OSF/Motif R1.2.3 and OSF/Motif R1.1.3 respectively. The default Motif toolkit is based on OSF/Motif R1.2.3. The OSF/Motif R1.1.3 toolkit is provided for backward compatibility. 2 DECwindows Motif[R]/Hanyu for OpenVMS, Version 1.2-3 SPD 46.94.02 The OSF/Motif R1.2.3 toolkit is fully integrated with X11R5 Xlib and Xt to provide internationalization functionalities such as locale-encoded string supports and input methods. Some of the X11R5 international- ization features can be invoked via the OSF/Motif R1.2.3 toolkit, such as input methods with different interaction styles. OSF/Motif V1.2.3 Toolkit The OSF/Motif V1.2.3 toolkit provides the capability of processing lo- cal languages. New features incorporated in V1.2.3 include tear-off menus, drag-and-drop supports, and internationalization. The follow- ing widgets of the Motif Toolkit library provides internationaliza- tion character input/output capabilities and local language message display: o Command Widget o FileSelectionBox Widget o Label Widget o List Widget o MessageBox Widget o SelectionBox Widget o RowColumn Widget o Scale Widget o BulletinBoard Widget o Text Widget o TextField Widget DECwindows Extensions to Motif Toolkit The DECwindows Extensions to Motif Toolkit library is enhanced for in- ternationalization with the X11R5 features. The following widgets of the DECwindows Extensions to Motif Toolkit library provide interna- tionalization character input/output capabilities and local language message display: o ColorMix widget o CSText Widget o Help Widget o Print Widget o Structured Visual Navigation (SVN) Widget 3 DECwindows Motif[R]/Hanyu for OpenVMS, Version 1.2-3 SPD 46.94.02 OSF/Motif R1.1.3 The OSF/Motif R1.1.3 toolkit are also provided for backward compat- ibility reason. All the applications compiled under previous releases of DECwindows Motif can be executed without recompiling. Programming Examples To help programmers to develop internationalization DECwindows appli- cations, several programming examples are provided: 1. Periodic - an example to illustrate Motif toolkit widgets. Local language text can be entered through XmText widget. 2. ximdemo - an example to illustrate how to do low level programming with X11R5 internationalization functions. 3. DECburger 4. HelloWorld User Environment, Out-of-the-box Applications and Examples All out-of-the-box (OOTB) applications and utilities (with the excep- tion of Notepad and DECwindows Mail which are based on OSF/Motif R1.1.3) supported by internationalized DECwindows Motif are based on OSF/Motif R1.2. Input Server Local language input methods have been implemented according to the X11R5 X Input Method specification at the Xlib layer. The input server can support applications developed on X11R4 Asian Input Method (AIM) and X11R5 X Input Method (XIM). The X11R5 XIM specification defines the following interaction styles: 1. Root window - pre-edit data is displayed in a window in the input server. 2. Off-the-spot - pre-edit data is displayed in a fixed location of the application window, usually right under the application win- dow. 3. Over-the-spot - pre-edit data is displayed in a child window of the application which is placed over the current insertion point. 4. On-the-spot - the input method directs the application through call- backs to display the pre-edit data. X Library o X Input Method o Text Drawing and Measuring Functions 4 DECwindows Motif[R]/Hanyu for OpenVMS, Version 1.2-3 SPD 46.94.02 o Inter-client communication o X Resource Database X Toolkit Intrinsics This product incorporates X11R5 X Toolkit Intrinsics (Xt). R5 Xt has been extended for internationalization to provide a new convenient rou- tine to establish locale at initialization time. The international- ization additions also define event filters as a part of the Xlib in- put method specifications. CHINESE LANGUAGE FEATURES DECwindows Motif/Hanyu for OpenVMS V1.2-3 provides the following Chinese language processing features in addition to the base and internationalization functionalities of DECwindows Motif for OpenVMS V1.2-3. DECwindows Motif/Hanyu for OpenVMS V1.2-3 provides a UDC font utility to create UDC fonts for UDC character display. Localized CDA Viewer allows users to view DDIF (Digital Document In- terchange Format) files containing Chinese text, graphics and images. Chinese Input Methods The following input methods are supported for the input of Chinese characters: o Tsang-Chi o Quick Tsang-Chi o Phonetic o Internal Code o Phrase Simplified Chinese/Traditional Chinese Conversion To allow users to interchange data between simplified Chinese and tra- ditional Chinese, DECwindows Motif/Hanyu for OpenVMS V1.2-3 provides support of simple conversion between them: o cut-and-paste of Chinese data can be handled properly according to the locale of the application window to which data is pasted o text display using X11R5 text drawing functions supports display of traditional Chinese data with simplified Chinese fonts, and vice versa o traditional Chinese can be entered through a simplified Chinese in- put server, and vice versa 5 DECwindows Motif[R]/Hanyu for OpenVMS, Version 1.2-3 SPD 46.94.02 That is, traditional Chinese can be entered using the following in- put methods: o 5-Shape o 5-Stroke o Pinyin o Quwei o Telex-Code HanyuDECterm HanyuDECterm utility is the extended version of standard DECterm to provide terminal emulation of Chinese terminals. Emulation of the fol- lowing Chinese terminal is currently supported: o VT382-D User Environment The following features in DECwindows Motif have been enhanced to ac- cept input of Chinese characters and/or display of Chinese data: o Login Extension o Session Manager o FileView o Motif Window Manager o LinkWorks Hyperinformation Services Applications The following applications in DECwindows Motif have been localized to support Chinese input and/or display: o Bookreader o Clock o Calculator o Calendar o Cardfiler o Mail Utility o Paint 6 DECwindows Motif[R]/Hanyu for OpenVMS, Version 1.2-3 SPD 46.94.02 o Puzzle o CDA Viewer o Motif Notepad DECwindows Motif Examples The following DECwindows Motif/Hanyu examples are bundled in this re- lease: o DECburger o HelloWorld o Periodic - an example to illustrate Motif toolkit widgets. Local language text can be entered through XmText widget. Obsolete Features DECwindows Motif/Hanyu for OpenVMS V1.2-3 does not include the fol- lowing features: o XUI/Hanyu Toolkit o XUI/Hanyu UIL Compiler o XUI/Hanyu Window Manager o XUI/Hanyu Server-Based Input Methods HARDWARE REQUIREMENTS Processors Supported: Please refer to Software Product Description (SPD 42.19.02). Memory Requirements: o For VAX Systems: 20 MB o For Alpha Systems: 40 MB More memory is recommended for better performance. Disk space requirements for installation and use: o For VAX Systems: 58,500 blocks o For Alpha Systems: 74,600 blocks PREREQUISITE SOFTWARE o OpenVMS/Hanyu VAX Operating System V5.5-2 or higher o OpenVMS/Hanyu Alpha Operating System V1.5 or higher 7 DECwindows Motif[R]/Hanyu for OpenVMS, Version 1.2-3 SPD 46.94.02 o DECwindows Motif Worldwide Support V1.2-3 for OpenVMS VAX o DECwindows Motif Worldwide Support V1.2-3 for OpenVMS Alpha OPTIONAL SOFTWARE For information on available optional software products, contact your local Digital office. SOFTWARE LICENSING This software is furnished under the licensing provisions of Digital's Standard Terms and Conditions of Sale. For further information on Digital's licensing terms and policies, contact your local Digital office. SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. Contact your local Digital Office for further information. DISTRIBUTION MEDIA The DECwindows Motif/Hanyu for OpenVMS V1.2-3 product (binaries and Bookreader documentation) is available exclusively on the OpenVMS (VAX or Alpha) Consolidated Software Distribution Library (CONDIST) and Companion Online Documentation Library (CONOLD) CD-ROM set. It is not distributed on any standalone layer product media such as CD-ROM, TK-50 streaming tape, or 9-track 1600-bpi magnetic tape. Due to the fact that DECwindows Motif/Hanyu for OpenVMS V1.2-3 hard- copy is not produced, you are recommended to use the hardcopy docu- mentation produced for DECwindows Motif/Hanyu for OpenVMS V1.2 product. ORDERING INFORMATION For OpenVMS Alpha Systems System Licenses: Traditional License: QL-MV43*-AA Personal License: QL-MV43*-2B Media and Documentation: Media and Associated Documents: QA-4KL8A-** Online Bookreader Documentation: QA-4KM8A-** Media, Associated Documents and Online Bookreader Documentation: QA-03XAA-** Hardcopy Documentation: QA-XA13*-GZ Software Support Services: QT-MV43*-** QT-XA13*-** 8 DECwindows Motif[R]/Hanyu for OpenVMS, Version 1.2-3 SPD 46.94.02 For OpenVMS VAX Systems Software Licenses: QL-XA13*-** Media and Documentation: Media and Associated Documents: QA-VWJ8A-** Online Bookreader Documentation: QA-VYR8A-** Media, Associated Documents and Online Bookreader Documentation: QA-YL48A-** Hardcopy Documentation: QA-XA13*-GZ Software Support Services: QT-XA13*-** * Denotes variant fields. For additional information on available li- censes, services and media, refer to the appropriate price book. The above information is valid at the time of release. Please contact your local Digital office for the most up-to-date information DECwindows Motif for OpenVMS documentation In addition to documentation supplied by DECwindows Motif/Hanyu for OpenVMS V1.2-3, you can use the common user and programming documen- tation set available on the corporate CONOLD or on hardcopy. For or- dering information see DECwindows Motif V1.2 for OpenVMS SPD (SPD 42.19.01), or DECwindows Motif V1.2-3 for OpenVMS SPD (SPD 42.19.02). SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the pur- chase of a license for the product as defined in the Software Warranty Addendum of this SPD. © 1995 Digital Equipment Corporation. All rights reserved. [R] Adobe, PostScript, and Display PostScript are registered trade- marks of Adobe Systems Incorporated. [R] Macintosh is a registered trademark of Apple Computer, Inc. [R] Motif, OSF, and OSF/Motif are registered trademarks of the Open Software Foundation, Inc. [R] Multinet is a registered trademark of TGV, Inc. [TM]X Window System is a trademark of the Massachusetts Institute of Technology. [TM]Open Software Foundation is a trademark of Open Software Foundation, Inc. 9 DECwindows Motif[R]/Hanyu for OpenVMS, Version 1.2-3 SPD 46.94.02 [TM]The DIGITAL logo, ALL-IN-1, AlphaStation, AlphaServer, Bookreader, CDA, CI, DDIF, DEC, DEC Ada, DEC Fortran, DECimage, DECmigrate, DECnet, DECsound, DECterm, DECwindows, LAT, LinkWorks, MicroVAX, OpenVMS, PATHWORKS, ReGIS, TURBOchannel, ULTRIX, VAX, VAXft, VAXserver, VAXstation, and XUI are trademarks of Digital Equipment Corporation. APPENDIX A - THIRD PARTY LICENSING Open Software Foundation, Inc., License Terms and Agreement Digital Equipment Corporation certifies that DECwindows Motif OpenVMS VAX Version 1.2-3 and DECwindows Motif OpenVMS Alpha Version 1.2-3 is OSF[R]/Motif[R] Release 1.2.3 validated as tested with the OSF/Motif Validation Test Suite Release 1.1 with no waivers. 10