Starting OpenWindows

This section describes the steps required to set up the Traditional Chinese environment and to start Traditional Chinese Solaris operation.

Setting .cshrc for the Required Environment

Each user's environment variables and ~/.cshrc (in other words, $HOME/.cshrc) file command lines must be set as described in this section to use Traditional Chinese text. You must make sure the following three .cshrc file features (and consequently the users' C shells) are set correctly before any user starts up the Traditional Chinese OpenWindows environment.

The following three conditions are prerequisites to using Traditional Chinese:

• OPENWINHOME shell variable set to the path to /usr/openwin

• LANG shell-environment language-locale variable set for Traditional Chinese

• TTY mode set appropriately for Traditional Chinese character codes

To set these features, make sure each user's .cshrc file includes the following lines:

setenv LANG zh_TW
setenv OPENWINHOME /usr/openwin

set path=( /usr/SUNWale/bin $OPENWINHOME/bin $path )

...

if ($?USER != 0 && $?prompt != 0) then
   /bin/stty cs8 -istrip defeucw
endif

Only /bin/stty can set the required features. Do not use /usr/ucb/stty, as it does not set all required features.

Also, make sure each .cshrc file puts $OPENWINHOME/bin in the user's path before any other OpenWindows file. One way to ensure this is to put the following line in after other path assignments:

set path=(/usr/SUNWale/bin $OPENWINHOME/bin $path) 

htt Input Server and openwin-init Files

The htt input server must be running before any application that uses Traditional Chinese input can run. It is started at OpenWindows startup from each user's home directory .openwin-init file. This file must contain the line:

toolwait $OPENWINHOME/bin/htt

This line must be ahead of the lines that start Traditional Chinese Solaris applications because they depend on the htt input server for Traditional Chinese operation. If .openwin-init is missing from the home directory, htt is started from the $OPENWINHOME/lib/locale/zh_TW/openwin-init file distributed with this Traditional Chinese Solaris operating environment. The htt(1) man page explains more about the operation of htt.

Setting the .OWdefaults File

The .OWdefaults file in the user's home directory specifies the language used for several Solaris features: display language, numbers, time/date, messages, and other basic Traditional Chinese OpenWindows properties. Some other entries in .OWdefaults affect the behavior and appearance of the user's OpenWindows user interface.

Each user's .OWdefaults file should contain the following five lines before running the Traditional Chinese OpenWindows environment. So add these five lines at the end of users' existing .OWdefaults files. (Refer to the "Using Localization on the Workspace Properties Worksheet" section in Traditional Chinese Solaris User's Guide.)

OpenWindows.BasicLocale:     zh_TW
OpenWindows.DisplayLang:     zh_TW
OpenWindows.InputLang:       zh_TW
OpenWindows.TimeFormat:      zh_TW
OpenWindows.NumericFormat:   zh_TW

These fields can be set to zh_TW, for Traditional Chinese, or C, for English/ASCII operation. These five Traditional Chinese OpenWindows variables have the following properties:

These five fields can be added to an .OWdefaults file by using the localization category (Locale) in the Workspace Properties worksheet as described in the "Using Localization on the Workspace Properties Worksheet" section in Traditional Chinese Solaris User's Guide.

.xinitrc File

If you want to maintain your own .xinitrc, update it according to $OPENWINHOME/lib/Xinitrc.

Applications Defaults Files

Two directories for applications defaults are part of the Traditional Chinese OpenWindows environment. One is for system-wide defaults, and one is specific to locale features:

• The $OPENWINHOME/lib/app-defaults/C directory stores system wide application defaults. These values are for the C locale.

• The $OPENWINHOME/lib/locale/zh_TW/app-defaults directory stores application defaults that are specific to the zh_TW locale.

• The $OPENWINHOME/lib/locale/zh_TW/app-defaults/Htt file has all htt resource default values that depend on the zh_TW locale.

• The $OPENWINHOME/lib/locale/zh_TW/app-defaults/Olwm file lists all olwm window manager resources default values that depend on the zh_TW locale. Such resource file names have the locale name suffixed to the resource name, for example ButtonFont.zh_TW. When a resource named with the locale suffix is lacking, the resource named without the suffix is used.