HP_DECwindows_Motif/Hebrew_for_OpenVMS_Alpha________ Release and Installation Information November 2003 This manual provides installation information as well as release notes. Revision This manual supersedes DECwindows /Update Motif/Hebrew V1.3 for OpenVMS, VAX Information: and Alpha Release and Installation Information. Operating HP OpenVMS Alpha Version 7.3-2 System: Software HP DECwindows Motif/Hebrew for Version: OpenVMS Alpha Version 1.3-1 Hewlett-Packard Company Palo Alto, California ________________________________________________________________ © 2003 Hewlett-Packard Development Company, L.P. Motif, OSF/1, UNIX, and the "X" device are registered trademarks and The Open Group is a trademark of The Open Group in the U.S. and other countries. Confidential computer software. Valid license from HP and/or its subsidiaries required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Neither HP or any of its subsidiaries shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. _________________________________________________________________ Contents 1 Installation 1.1 Prerequisite Software............................ 1-1 1.1.1 OpenVMS Alpha V7.3-2 .......................... 1-1 1.1.2 OpenVMS XPG4 Locale Data File kit ............. 1-1 1.1.3 DECwindows Motif for OpenVMS Alpha V1.3-1 .... 1-2 1.2 Installation of DECwindows Motif/Hebrew.......... 1-2 1.2.1 License ....................................... 1-2 1.2.2 Installation of DECwindows Motif/Hebrew ....... 1-2 1.2.3 Reboot ........................................ 1-3 2 Release Notes 2.1 New Desktop...................................... 2-1 2.2 I18N Features in DECterm......................... 2-1 2.3 Keyboard Support................................. 2-2 2.3.1 F17 and LK443 ................................. 2-3 2.4 Hebrew Input Method (HIM)........................ 2-3 2.5 Running Mozilla Browser.......................... 2-5 A Visual and Physical order iii 1 _________________________________________________________________ Installation This chapter describes how to install DECwindows Motif /Hebrew for OpenVMS Alpha V1.3-1. 1.1 Prerequisite Software Prior to install DECwindows Motif/Hebrew for OpenVMS Alpha V1.3-1, the following products must be installed: o OpenVMS Alpha V7.3-2 o OpenVMS XPG4 Locale Data File kit o DECwindows Motif for OpenVMS Alpha V1.3-1 1.1.1 OpenVMS Alpha V7.3-2 Refer to "OpenVMS Alpha Version 7.3-2 Upgrade and Installation Manual" for the installation of OpenVMS Alpha V7.3-2. 1.1.2 OpenVMS XPG4 Locale Data File kit DECwindows Motif/Hebrew for OpenVMS Alpha V1.3-1 requires Hebrew locale database. The locale database is provided by OpenVMS XPG4 Locale Data File kit. The kit is included in the Layered Products CD-ROM of OpenVMS Alpha V7.3-2. Mount the Layered Products CD-ROM. $ MOUNT/OVER=ID Where is the device name of CD-ROM drive on your system. Install XPG4 Locale Database kit. $ @SYS$UPDATE:VMSINSTAL ALPVMSI18N04_073 :[VMSI18N_ALPHA073.KIT] 1-1 Installation 1.1 Prerequisite Software During the installation, select "European and US support". Other language support is not required. * Do you want European and US support [YES]? yes * Do you want GB18030 support [YES]? no * Do you want Chinese support (not including GB18030) [YES]? no * Do you want Japanese support [YES]? no * Do you want Korean support [YES]? no * Do you want Thai support [YES]? no * Do you want Unicode support [YES]? no 1.1.3 DECwindows Motif for OpenVMS Alpha V1.3-1 Refer to "HP DECwindows Motif for OpenVMS Alpha Installation Guide" for the installation of DECwindows Motif for OpenVMS Alpha V1.3-1. 1.2 Installation of DECwindows Motif/Hebrew 1.2.1 License DECwindows Motif/Hebrew for OpenVMS Alpha V1.3-1 requires the Hebrew Motif License DW-MOTIF-UI-HEBREW as well as DW- MOTIF. Register and load those licenses before installing DECwindows Motif/Hebrew for OpenVMS Alpha V1.3-1. 1.2.2 Installation of DECwindows Motif/Hebrew DECwindows Motif/Hebrew for OpenVMS Alpha V1.3-1 consists of two kits - International Motif kit (DEC-AXPVMS-DWMOTIF_ I18N-V0103-1-1.PCSI) and Hebrew Motif kit (DEC-AXPVMS- DWMOTIF_UI_HEBREW-V0103-1-1.PCSI). They are in the same directory of CD-ROM. Mount the CD-ROM from Software Products Library. $ MOUNT /OVER=ID Where is the device name of CD-ROM drive on your system. First, install International Motif kit. $ PRODUCT INSTALL DWMOTIF_I18N /SOURCE=:[DWMA_IW_ILU0131.KIT] Then Install Hebrew Motif kit. $ PRODUCT INSTALL DWMOTIF_UI_HEBREW /SOURCE=:[DWMA_IW_ILU0131.KIT] 1-2 Installation 1.2 Installation of DECwindows Motif/Hebrew 1.2.3 Reboot After the installation, reboot the system. 1-3 2 _________________________________________________________________ Release Notes This chapter describes the release notes for DECwindows Motif/Hebrew for OpenVMS Alpha V1.3-1. 2.1 New Desktop The New Desktop provides user interfaces in different languages. The New Desktop uses the locale environment provided by the DEC C Runtime Library. *xnlLanguage property is not set by default with the New Desktop environment; thus, before running applications from DCL command , the "LANG" logical name should be defined to the relevant language: $ DEFINE LANG "iw_IL.ISO8859-8" After installing the Hebrew kit, the "LANG" logical is defined as "iw_IL.ISO8859-8" in "DECW$LOGICAL_NAMES" table. 2.2 I18N Features in DECterm In this release, the locale of the display is used to create the file name of the DECterm resource file. For example, if the locale is set to "iw_IL.ISO8859-8", then the default resource file name becomes DECW$TERMINAL_ DEFAULT_IW_IL.DAT. However, DECterm continues to use the old resource file name (if there is no new resource file) until the user selects Save Options at least once in the particular locale. The default resource file name for DECterm continues to be DECW$TERMINAL_DEFAULT.DAT if the locale: o Is "C" o Starts with "en_US" o Contains "8859-1" 2-1 Release Notes 2.2 I18N Features in DECterm If you have more than one language variant installed on you system, you have to make sure you are using the right resource file for the language you have selected. If you save the resources in one language and use them from another language, the result may be unpredictable. For example, if you modify and save the DECterm resources in the English language (stored in DECW$TERMINAL.DAT in your default directory) and then use them in the language which requires different DECterm fonts, wrong fonts will be displayed in the DECterm window. Thus , if you have an old resource file it is recommended to rename it to the new resource name. (e.g. rename DECW$TERMINAL_DEFAULT.DAT to DECW$TERMINAL_DEFAULT_IW_IL.DAT) 2.3 Keyboard Support This release provides Hebrew keymaps for LK201, LK401 and LK443 (PC and LK styles). After a Hebrew installation, the default keymap is Hebrew LK401. If you are using a different keyboard, make sure to update the session manager accordingly, using its 'Keyboard...' setup. LK461-AT and LK462-AT are supported by default LK401 keymap. In order to toggle the keyboard language (English/Hebrew), the user should press Ctrl+Hebrew on a LK401 Hebrew keyboard, Ctrl+Alt on a LK201, and Ctrl_Right on a LK443. The Keyboard Manager (KM) application is not mandatory for keyboard switching on VMS systems. It can be used mainly for keyboard language display. ________________________ Note ________________________ o KM does not support the LK443 keyboards. o The Hebrew support for DECwindows Motif/Hebrew for OpenVMS Alpha V1.3-1 includes a Hebrew Input Method which provides its own mechanism for keyboard status display. Refer to the next section for more details. ______________________________________________________ 2-2 Release Notes 2.3 Keyboard Support 2.3.1 F17 and LK443 The DXmCSText widget has a default binding for F17 and Alt/F17, for enter/leave push mode and text path toggle (respectively). In order to obtain these functionalities with LK443, the user should bind different keys to these functions, since F17 does not exist on LK443. The binding is done in the DECW$SMB_KEYBOARD.DAT resource file. The user can modify the file in DECW$SYSTEM_DEFAULTS_ IW_IL for system-wide support, or copy it over to his ownDECW$USER_DEFAULTS. In order to bind the push mode function to F7 and the text path toggle to F8 for example, the following lines should be added: *DXmCSText.translations: \ #override \n\ ~Alt ~Ctrl ~Shift ~Meta<>F8: toggle-text-path()\n\ ~Alt ~Ctrl ~Shift ~Meta<>F7: toggle-editing-path-move()\n The user has to quit the session and log in again, in order for this modification to take effect. 2.4 Hebrew Input Method (HIM) DECwindows Motif V1.3-1 is using the X11R6 capabilities. The Hebrew IM is an X11R6 implementation which allows the user to accept Hebrew input in any X11(R6) application. It also handles the keyboard group switching (English/Hebrew) per Input Context (IC), and displays the keyboard language if the input style requires status display. Keyboard switching is currently associated with the following key sequences: Ctrl+Hebrew Ctrl+Compose Ctrl+Alt Ctrl+Shift Ctrl_Right (for LK443) An application can also switch the keyboard language by calling XSetICValues with the resource XNKeyboardGroup. 2-3 Release Notes 2.4 Hebrew Input Method (HIM) This resource can have two values: HIM_PRIMARY_GROUP (meaning 'set keyboard to English') and HIM_SECONDARY_GROUP ('set keyboard to Hebrew'). The header file 'switch_kbd.h' includes these constants. It is found in DECW$INCLUDE. The default value of this resource is HIM_PRIMARY_GROUP. To change the default value of this resource to HIM_SECONDARY_ GROUP ('set keyboard to Hebrew') the user should define the environment variable HIM_HEBREW_KEYBOARD (it's value doesn't matter). HIM supports the XIMPreeditNone editing style only (i.e. no pre-edit area is needed). As for status styles, HIM currently supports the following: o XIMStatusNothing (a common status area for all clients) o XIMStatusNone (no status display) o XIMStatusArea (currently w/o dynamic area change and negotiation). ________________________ Note ________________________ 1. In order to obtain the XIMStatusNone status, the user should also define the HIM_ALLOW_STATUSNONE environment variable (its value does not matter). If XIMStatusNone is required, and the variable is not defined, XIMStatusNothing will be used. 2. If XIMStatusNone is being used and the Keyboard Manager (KM) is running, the keyboard status will be reported by HIM too, as is done for XIMStatusNothing. ______________________________________________________ In order to utilize HIM from a pure X application (non- Motif), the user should follow the guidelines on how to develop an X11R6 application (found in the X11 Release 6 manuals). 2-4 Release Notes 2.5 Running Mozilla Browser 2.5 Running Mozilla Browser As for the Input Method, default setting of Mozilla is "on- the-spot". However, Hebrew Input Method originally does not support "on-the-spot". So, prior to running Mozilla, user needs to change the Input Method mode to "none". There are three ways to change the Input Method mode as listed below. Follow one of them as appropriate. 1. Specifying options at command line When invoking Mozilla, user can change the Input Method mode by specifying options. o If user does not want to display status window, invoke Mozilla as following: $ @mozilla --xim-preedit none --xim-status none o If user wants to display status window, invoke Mozilla as following: $ @mozilla --xim-preedit none --xim-status nothing 2. modification of PREFS.JS (effective for each user) Add option entries to PREFS.JS in the subdirectory [._ MOZILLA] in user's login directory. o If user does not want to display status window, add the following two lines: user_pref("xim.preedit.input_style", "none"); user_pref("xim.status.input_style", "none"); o If user wants to display status window, add the following two lines: user_pref("xim.preedit.input_style", "none"); user_pref("xim.status.input_style", "nothing"); Then the user can invoke Mozilla without options at command line. 3. modification of ALL.JS (effective for all users) Add option entries to ALL.JS in the subdirectory [.DEFAULTS.PREF] in the directory where Mozilla is installed (ex. SYS$COMMON:[MOZILLA]). o If user does not want to display status window, add the following two lines: 2-5 Release Notes 2.5 Running Mozilla Browser pref("xim.preedit.input_style", "none"); pref("xim.status.input_style", "none"); o If user wants to display status window, add the following two lines: pref("xim.preedit.input_style", "none"); pref("xim.status.input_style", "nothing"); Then all users can invoke Mozilla without options at command line. 2-6 A _________________________________________________________________ Visual and Physical order Visual Order means that the first character to be typed is the first character to be stored in the internal buffer. This is the order for sorting information. Physical order means that the left-most character on the screen is the first character stored in the buffer. For example (Hebrew characters are represented by English characters below): A Hebrew field on screen: dcba :dleif-werbeH ----- Field title is on the right, 5 positions for data, 4 actual characters, right justified. The field buffer is as follows: Memory Visual Physical offsets Order Order ------ ------ 0000: | a | | | ------ ------ 0001: | b | | d | ------ ------ 0002: | c | | c | ------ ------ 0003: | d | | b | ------ ------ 0004: | | | a | ------ ------ Note that characters entered via the push mode will be stored in reverse order compared the order they have been typed in. A-1 Visual and Physical order Example of use of the push mode during a right-to-left editing: Empty text field widget (5-bytes length): _____ Initial insertion position: ^ Two characters entered from right to left: ba New insertion position: ^ Push mode key is pressed (cursor does not move): ^ One digit is types in: 1ba Insertion position does not change: ^ A second digit is typed in: 12ba Insertion position does not change: ^ Push mode is terminated: ^12ba The field buffer is as follows: Memory Visual Physical offsets Order Order ------ ------ 0000: | a | | | ------ ------ 0001: | b | | 1 | ------ ------ 0002: | 2 | | 2 | ------ ------ 0003: | 1 | | b | ------ ------ 0004: | | | a | ------ ------ A-2