


XWNMO(1)            UNIX Programmer's Manual             XWNMO(1)



NNAAMMEE
     xwnmo - Input Manager of the X Window System Version 11

SSYYNNOOPPSSIISS
     xxwwnnmmoo [-_o_p_t_i_o_n ...]

DDEESSCCRRIIPPTTIIOONN
     The _x_w_n_m_o is a input manager for Input Method of X Window
     System.  It is based on [_X _W_i_n_d_o_w _S_y_s_t_e_m, _V_e_r_s_i_o_n _1_1 _I_n_p_u_t
     _M_e_t_h_o_d _S_p_e_c_i_f_i_c_a_t_i_o_n_s].  It provides a multi-language input
     environment for multiple clients in the X Window System Ver-
     sion 11. Clients can connect to it by using XIM library.

     _x_w_n_m_o supports multi-screen environment. _x_w_n_m_o creates one
     window for _R_o_o_t-_m_o_d_e on each screen.

     The conversion engine _x_w_n_m_o use is the internationalized
     Wnn. It selects conversion server in accordance with
     language of clients.  How many languages _x_w_n_m_o supports
     depend on the configuration file (_x_i_m_c_o_n_f). Please refer the
     manual of _x_i_m_c_o_n_f.

     _X_w_n_m_o supports the following inputstyles:
             ( XIMPreeditArea | XIMStatusArea )
             ( XIMPreeditPosition | XIMStatusArea )
             ( XIMPreeditNothing | XIMStatusNothing )
             ( XIMPreeditCallbacks | XIMStatusArea )
             ( XIMPreeditArea | XIMStatusCallbacks )
             ( XIMPreeditPosition | XIMStatusCallbacks )
             ( XIMPreeditCallbacks | XIMStatusCallbacks )

     If you attempt to connect _x_w_n_m_o by using XIM library, You
     must set modifiers __X_W_N_M_O.

     Concretely,
             XSetLocaleModifiers("@im=_XWNMO");
             or
             set environment XXMMOODDIIFFIIEERRSS=@im=_XWNMO and XSetLo-
             caleModifiers("");.

     For feather information about XIM library, please see the
     chapter 13 of Xdoc or [_X _W_i_n_d_o_w _S_y_s_t_e_m, _V_e_r_s_i_o_n _1_1 _I_n_p_u_t
     _M_e_t_h_o_d _S_p_e_c_i_f_i_c_a_t_i_o_n_s].

XXMMLL
     According to _I_n_p_u_t _M_e_t_h_o_d _S_p_e_c_i_f_i_c_a_t_i_o_n_s, the locale which
     input method use is only one and static locale. Thence _x_w_n_m_o
     provides only one languange environment which depends on the
     current locale of _X_O_p_e_n_I_M(). And you could not change this
     environment.  But if libX11.a was compiled with XXMMLL define,
     clients can use multi locale environment. In other words,
     you can change current languange environment on the fly by
     changing current locale. The way to use its environment is
     the following:

     CCrreeaattiinngg eennvviirroonnmmeenntt
             Call _X_m_l_O_p_e_n_I_M() instead of XOpenIM() ,set
             XXNNCCuurrrreennttLLaanngguuaaggee argument of XIC and call
             _X_C_r_e_a_t_e_I_C(). So _x_w_n_m_o attempts to create as many
             language environment as possible and set current
             environment to the locale set XNCurrentLanguage. If
             you don't set XNCurrentLanguage current environment
             is the first environment _x_w_n_m_o created.  A syntax of
             XNCurrentLanguage follows.
             current_language = <language>'_'<territory>

     CChhaannggiinngg eennvviirroonnmmeenntt
             If you want to change current languange environment,
             set XXNNCCuurrrreennttLLaanngguuaaggee argument and call _X_S_e_t_-
             _I_C_V_a_l_u_e_s().

     _X_w_n_m_o accept that XXMMLL clients and NNOONN__XXMMLL clients connect
     _x_w_n_m_o at the same time.

CCHHAANNGGIINNGG LLOOCCAALLEE
     _X_w_n_m_o has two interfaces for changing current languange
     environment.  One is _c_h_a_n_g_e__l_o_c_a_l_e__c_t function. This func-
     tion is good only when current locale is _w_r__W_R._c_t. You can
     write it in _u_u_m_k_e_y-_f_i_l_e.  A syntax of change_locale_ct fol-
     lows.

     change_locale_ct <key>  [ <key> ... ]

     Other is _c_h_a_n_g_e__l_o_c_a_l_e function. You can write it in
     _u_u_m_k_e_y-_f_i_l_e.  A syntax of change_locale follows.

     change_locale <key>  [ <key> ... ]

     This function is good only when you set XXNNCChhaannggeeLLooccaalleeCCBB
     argument. The value of this argument is a pointer of call-
     back function.  This function will be call by input method
     when you change current languange environment of _x_w_n_m_o. A
     interface of this function follows.

     void ChangeLocaleCB(char *locale)

XXJJpp
     _X_w_n_m_o is able to support XJp protocol. If You compile _x_w_n_m_o
     with XXJJPP define, it supports "Communication Kit" part of XJp
     protocol.  And if You compile _x_w_n_m_o with XXJJPP and XXJJPP__DDIIRREECCTT
     define, it supports "Direct Interface" part of XJp protocol.

SSEEPP
     _X_w_n_m_o is able to support SEP(SpotLocation Extended Proto-
     col).  If You compile _x_w_n_m_o with SSPPOOTT define, it supports
     SEP.  And please use __X_i_p_C_h_a_n_g_e_S_p_o_t() function. it's inter-
     face follows.

     int __XXiippCChhaannggeeSSppoott(_i_c, _s_p_o_t__x, _s_p_o_t__y)
         XIC ic;
         short spot_x, spot_y;

     ic:       Specifies the input context.
     spot_x, spot_y:     Specifies the coordinates of the
     ``spot''.

OOPPTTIIOONNSS
     _X_w_n_m_o accepts the following options:

     --DD _s_e_r_v_e_r-_n_a_m_e
             This option specifies the machine name of conversion
             server.  If this isn't set, first _J_S_E_R_V_E_R environ-
             ment is referred. And if it isn't set, _x_w_n_m_o
             attempts to connect "_j_s_e_r_v_e_r" machine.  And if it's
             connect failed, _x_w_n_m_o attempts to connect local
             machine.

     --nn _u_s_e_r-_n_a_m_e
             This option specifies the user name which is used as
             env-name of Wnn.  If this isn't set, first _W_N_N_U_S_E_R
             environment is referred. And if it isn't set, the
             user name of process is referred.

     --llcc _l_a_n_g_u_a_g_e-_n_a_m_e
             This option specifies the _l_a_n_g_u_a_g_e _n_a_m_e which is
             referred as the language environment of _R_o_o_t-_m_o_d_e.
             If this isn't set, first _L_A_N_G environment is
             referred. And if it isn't set, the default is _j_a__J_P.
             A syntax of language-name follows.
             language = <language>'_'<territory>

     --kk _u_u_m_k_e_y-_f_i_l_e-_n_a_m_e
             This option specifies the path name of _u_u_m_k_e_y-_f_i_l_e.
             For feather information about _u_u_m_k_e_y-_f_i_l_e, please
             see Wnn manual.

     --rr _r_o_m_k_a_n-_f_i_l_e-_n_a_m_e
             This option specifies the directory name of _r_o_m_k_a_n-
             _f_i_l_e. For feather information about _r_o_m_k_a_n-_f_i_l_e,
             please see Wnn manual.

     --XX _c_o_n_v_e_r_t-_k_e_y-_f_i_l_e-_n_a_m_e
             This option specifies the path name of _c_o_n_v_e_r_t-_k_e_y-
             _f_i_l_e. The _c_o_n_v_e_r_t-_k_e_y-_f_i_l_e contains the relation
             between keys of X and keys of Wnn. The default is
             "/usr/local/lib/wnn/cvt_xim_tbl".  For feather
             information about _c_o_n_v_e_r_t-_k_e_y-_f_i_l_e, please see the
             manual of _c_v_t__x_i_m__t_b_l.

     --FF _c_o_n_v_e_r_t-_f_u_n_c_t_i_o_n-_f_i_l_e-_n_a_m_e
             This option specifies the path name of _c_o_n_v_e_r_t-
             _f_u_n_c_t_i_o_n-_f_i_l_e. The _c_o_n_v_e_r_t-_f_u_n_c_t_i_o_n-_f_i_l_e contains
             the relation between function keys of X and keys of
             Wnn. This file is only for older version _x_w_n_m_o.
             Please use _c_v_t__x_i_m__t_b_l as much as possible.  For
             feather information about _c_o_n_v_e_r_t-_f_u_n_c_t_i_o_n-_f_i_l_e,
             please see the manual of _c_v_t__f_u_n__t_b_l.

     --MM _c_o_n_v_e_r_t-_m_e_t_a-_f_i_l_e-_n_a_m_e
             This option specifies the path name of _c_o_n_v_e_r_t-
             _m_e_t_a-_f_i_l_e. The _c_o_n_v_e_r_t-_m_e_t_a-_f_i_l_e contains the rela-
             tion between meta keys of X and keys of Wnn. This
             file is only for older version _x_w_n_m_o.  Please use
             _c_v_t__x_i_m__t_b_l as much as possible.  For feather infor-
             mation about _c_o_n_v_e_r_t-_m_e_t_a-_f_i_l_e, please see the
             manual of _c_v_t__m_e_t_a__t_b_l.

     --ddiissppllaayy _d_i_s_p_l_a_y
             This option specifies the X server to connect; see
             _X(_1).

     --hheellpp   This causes _x_w_n_m_o to print out a verbose message
             describing its options.

     --jjuu _x_j_t_u_i_l-_n_a_m_e
             This option specifies the path name of _x_j_u_t_i_l which
             is _t_h_e _d_i_c_t_i_o_n_a_r_y _u_t_i_l_i_t_y _m_a_n_a_g_e_r.  The default is
             "/usr/bin/X11/xjutil".

     --EEMM     This causes that the menu for exit is available when
             a mouse pointer is pushed on _R_o_o_t-_m_o_d_e window.  The
             default is available.

     ++EEMM

     This causes that the menu for exit is disable.  Please use
     killxwnmo for exit.  The following options affects windows
     for _R_o_o_t-_m_o_d_e on all screens.

     --ffss _f_o_n_t-_n_a_m_e-_l_i_s_t
             This option specifies the list of font name. The
             fontset of _R_o_o_t-_m_o_d_e window is created from this
             list. The default is depend on the locale.  A syntax
             of this list follows.
             font-name-list = <fontname>{','fontname}

     --ggeeoommeettrryy _g_e_o_m_e_t_r_y
             This option specifies the preferred size and posi-
             tion of _R_o_o_t-_m_o_d_e window.  see _X(_1)

     --ffgg _c_o_l_o_r
             This option specifies the color to use for display-
             ing text of _R_o_o_t-_m_o_d_e window. The default is
             ``black.''

     --bbgg _c_o_l_o_r
             This option specifies the color to use for the back-
             ground of _R_o_o_t-_m_o_d_e window.  The default is
             ``white.''

     --bbdd _c_o_l_o_r
             This option specifies the color to use for the
             border of _R_o_o_t-_m_o_d_e window.  The default is
             ``black.''

     --bbww _n_u_m_b_e_r
             This option specifies the width in pixels of the
             border surrounding _R_o_o_t-_m_o_d_e window.

     --iiccoonniicc This option indicates that _x_w_n_m_o should ask the win-
             dow manager to start it as an icon rather than as
             the normal window.  If the -RV option is specified
             or "rootVisible" resource is specified as ``True'',
             this option becomes void.

     ##_g_e_o_m   This option specifies the preferred position of the
             icon window.  It is shorthand for specifying the
             ``*_i_c_o_n_G_e_o_m_e_t_r_y'' resource.

     --hh      This causes _x_w_n_m_o to wake up in conversion _o_f_f mode.

     --HH      This causes _x_w_n_m_o to wake up in conversion _o_n mode.
             The default is off mode.

     --RRVV     This causes _x_w_n_m_o to unmap _R_o_o_t-_m_o_d_e window when
             henkan modeis off or no client uses _R_o_o_t-_m_o_d_e.  This
             option make -iconic option void and set "iconic"
             resource as ``False''.

RREESSOOUURRCCEESS
     _X_w_n_m_o accepts the following resource names and classes:

     sseerrvveerrNNaammee ((class SSeerrvveerrNNaammee))
             This option specifies the machine name of conversion
             server.  If this isn't set, first _J_S_E_R_V_E_R environ-
             ment is referred. And if it isn't set, _x_w_n_m_o
             attempts to connect "_j_s_e_r_v_e_r" machine.  And if it's
             connect failed, _x_w_n_m_o attempts to connect local
             machine.

     uusseerrNNaammee ((class UUsseerrNNaammee))
             Specifies the user name which is used as env-name of
             Wnn.  If this isn't set, first _W_N_N_U_S_E_R environment
             is referred. And if it isn't set, the user name of
             process is referred.

     xxiimmrrccNNaammee ((class XXiimmrrccNNaammee))
             Specifies the path name of _x_i_m_r_c-_f_i_l_e which is a
             start up file of _x_w_n_m_o.  If this isn't set or there
             is not it, first $_H_O_M_E/._x_i_m_r_c is referred.  And if
             it doesn't exist, the default is
             "/usr/local/lib/wnn/ximrc".  For feather information
             about _x_i_m_r_c-_f_i_l_e, please see the manual of _x_i_m_r_c-
             _f_i_l_e.

     ccvvttxxiimmNNaammee ((class CCvvttxxiimmNNaammee))
             Specifies the path name _c_o_n_v_e_r_t-_k_e_y-_f_i_l_e. The
             _c_o_n_v_e_r_t-_k_e_y-_f_i_l_e contains the relation between func-
             tion keys of X and keys of Wnn. The default is
             "/usr/local/lib/wnn/cvt_xim_tbl".  For feather
             information about _c_o_n_v_e_r_t-_k_e_y-_f_i_l_e, please see the
             manual of cvt_xim_tbl.

     ccvvttffuunnNNaammee ((class CCvvttffuunnNNaammee))
             Specifies the path name _c_o_n_v_e_r_t-_f_u_n_c_t_i_o_n-_f_i_l_e. The
             _c_o_n_v_e_r_t-_f_u_n_c_t_i_o_n-_f_i_l_e contains the relation between
             function keys of X and keys of Wnn. This file is
             only for older version _x_w_n_m_o.  Please use
             _c_v_t__x_i_m__t_b_l as much as possible.  For feather infor-
             mation about _c_o_n_v_e_r_t-_f_u_n_c_t_i_o_n-_f_i_l_e, please see the
             manual of cvt_fun_tbl.

     ccvvttmmeettaaNNaammee ((class CCvvttmmeettaaNNaammee))
             Specifies the path name of _c_o_n_v_e_r_t-_m_e_t_a-_f_i_l_e. The
             _c_o_n_v_e_r_t-_m_e_t_a-_f_i_l_e contains the relation between meta
             keys of X and keys of Wnn. This file is only for
             older version _x_w_n_m_o.  Please use _c_v_t__x_i_m__t_b_l as much
             as possible.  For feather information about
             _c_o_n_v_e_r_t-_m_e_t_a-_f_i_l_e, please see the manual of
             cvt_meta_tbl.

     xxjjuuttiillNNaammee ((class XXjjuuttiillNNaammee))
             Specifies the path name of _x_j_u_t_i_l which is _t_h_e _d_i_c_-
             _t_i_o_n_a_r_y _u_t_i_l_i_t_y _m_a_n_a_g_e_r.  The default is
             "/usr/bin/X11/xjutil".

     llaannggNNaammee ((class LLaannggNNaammee))
             Specifies the _l_o_c_a_l_e _n_a_m_e which is referred as the
             language environment of _R_o_o_t-_m_o_d_e. If this isn't
             set, first _L_A_N_G environment is referred. And if it
             isn't set, the default is _j_a__J_P.  A syntax of
             language-name follows.
             language = <language>'_'<territory>

     eexxiittMMeennuu ((class EExxiittMMeennuu))
             Indicates that the menu for exit is available when a
             mouse pointer is pushed on _R_o_o_t-_m_o_d_e window.  The
             default is ``True''.

     The following options can be specified for the window for
     _R_o_o_t-_m_o_d_e on each screen separately. the sub-name and sub-
     class of each screen are ssccrreeeennNN and SSccrreeeennNN. Then NN are
     specified the number of screen.

     ffoorreeggrroouunndd ((class FFoorreeggrroouunndd))
             Specifies the color to use for displaying text of
             _R_o_o_t-_m_o_d_e window.  The default is ``black''.

     bbaacckkggrroouunndd ((class BBaacckkggrroouunndd))
             Specifies the color to use for the background of
             _R_o_o_t-_m_o_d_e window.  The default is ``white''.

     bboorrddeerrCCoolloorr ((class BBoorrddeerrCCoolloorr))
             Specifies the color to use for the border of _R_o_o_t-
             _m_o_d_e window.  The default is ``black''.

     iiccoonniicc ((class IIccoonniicc))
             Indicates that _x_w_n_m_o should ask the window manager
             to start it as an icon rather than as the normal
             window.  If the -RV option is specified or "root-
             Visible" resource is specified as ``True'', this
             resource is specified as ``False''.  The default is
             ``False''.

     ggeeoommeettrryy ((class GGeeoommeettrryy))
             Specifies the preferred size and position of _R_o_o_t-
             _m_o_d_e window.

     iiccoonnGGeeoommeettrryy ((class IIccoonnGGeeoommeettrryy))
             Specifies the preferred position of the icon window.

     bboorrddeerrWWiiddtthh ((class BBoorrddeerrWWiiddtthh))
             Specifies the width in pixels of the border sur-
             rounding _R_o_o_t-_m_o_d_e window.

     ffoonnttSSeett ((class FFoonnttSSeett))
             Specifies the list of font name. The fontset of
             _R_o_o_t-_m_o_d_e window is created from this list. The
             default is depend on the locale.  A syntax of this
             list follows.
             font-name-list = <fontname>{','fontname}

     rroooottVViissiibbllee ((class RRoooottVViissiibbllee))
             Indicates that _x_w_n_m_o should unmap _R_o_o_t-_m_o_d_e window
             when henkan mode is off or no client uses _R_o_o_t-_m_o_d_e.
             The default is ``False''.  This resource make
             -iconic option void and set "iconic" resource as
             ``False''.

SSEEEE AALLSSOO
     killxwnmo(1X), ximrc(4X), cvt_xim_tbl(4X), cvt_fun_tbl(4X),
     cvt_meta_tbl(4X)
     _W_n_n _M_a_n_u_a_l (in the Wnn source directory)

CCOOPPYYRRIIGGHHTT
     Copyright 1992, 1992 by OMRON Corporation
     Copyright 1992, 1992 by Massachusetts Institute of Technol-
     ogy

AAUUTTHHOORR
     Seiji Kuwari (OMRON Corporation)



Printed 12/1/92             Release 5                           6






































































