From: root Date: Thu, 2 Feb 2006 15:22:19 +0000 (+0000) Subject: *** empty log message *** X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=ebcb29bfa26a49cb7368d60b8226e44bdbae9adb;p=dana%2Furxvt.git *** empty log message *** --- diff --git a/Changes b/Changes index ebcbc28b..3d6679e4 100644 --- a/Changes +++ b/Changes @@ -2,7 +2,6 @@ rxvt-unicode changelog <= google-friendly title TODO: event mechanism that replaces on_keyboard_command with something more scalable. TODO: overlays collide with the way the out-of-focus cursor is being drawn -TODO: simplify selection_request and make it callable from perl. TODO: split perl documentation and urxvt.pm into separate files TODO: harmonize --disable-options into position-dependent options. TODO: "slow" rendering mode for bidi and scripts @@ -13,8 +12,6 @@ WISH: anyevent mouse notification / manage MotionMask better. WISH: http://www120.pair.com/mccarthy/nextstep/intro.htmld/Workspace.html is the correct nextstep look. DUMB: support tex fonts -TODO: xim "how to" faq entry - - changed interpretation of [alpha] colour prefix. - +option now really sets the option to default, instead of using the resource value. diff --git a/doc/rxvt.7.html b/doc/rxvt.7.html index d623e3f8..f32365e2 100644 --- a/doc/rxvt.7.html +++ b/doc/rxvt.7.html @@ -90,6 +90,7 @@
  • How does rxvt-unicode determine the encoding to use?
  • Is there an option to switch encodings?
  • Can I switch locales at runtime?
    • +
  • I have problems getting my input method working.
  • My input method wants <some encoding> but I want UTF-8, what can I do?
  • Rxvt-unicode crashes when the X Input Method changes or exits.
    • @@ -933,15 +934,50 @@ for some locales where character width differs between program- and rxvt-unicode-locales.

    +

    I have problems getting my input method working.

    +

    Try a search engine, as this is slightly different for every input method server.

    +

    Here is a checklist:

    +
    +
    - Make sure your locale and the imLocale are supported on your OS.
    +
    +
    +Try locale -a or check the documentation for your OS. +
    +

    +
    - Make sure your locale or imLocale matches a locale supported by your XIM.
    +
    +
    +For example, kinput2 does not support UTF-8 locales, you should use +ja_JP.EUC-JP or equivalent. +
    +

    +
    - Make sure your XIM server is actually running.
    +
    +
    - Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode.
    +
    +
    +When you want to use e.g. kinput2, it must be set to +@im=kinput2. For scim, use @im=SCIM. Youc an see what input +method servers are running with this command: +
    +
    +
    +   xprop -root XIM_SERVERS
    +
    +

    +
    +
    +

    +

    My input method wants <some encoding> but I want UTF-8, what can I do?

    You can specify separate locales for the input method and the rest of the terminal, using the resource imlocale:

        URxvt.imlocale: ja_JP.EUC-JP

    Now you can start your terminal with LC_CTYPE=ja_JP.UTF-8 and still -use your input method. Please note, however, that you will not be able to -input characters outside EUC-JP in a normal way then, as your input -method limits you.

    +use your input method. Please note, however, that, depending on your Xlib +version, you may not be able to input characters outside EUC-JP in a +normal way then, as your input method limits you.

    Rxvt-unicode crashes when the X Input Method changes or exits.

    diff --git a/doc/rxvt.7.man.in b/doc/rxvt.7.man.in index 6ff1e0d4..81981200 100644 --- a/doc/rxvt.7.man.in +++ b/doc/rxvt.7.man.in @@ -1140,6 +1140,35 @@ You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fin for some locales where character width differs between program\- and rxvt\-unicode\-locales. .PP +\fII have problems getting my input method working.\fR +.IX Subsection "I have problems getting my input method working." +.PP +Try a search engine, as this is slightly different for every input method server. +.PP +Here is a checklist: +.IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS\s0." 4 +.IX Item "- Make sure your locale and the imLocale are supported on your OS." +Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS\s0. +.IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM\s0." 4 +.IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM." +For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use +\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent. +.IP "\- Make sure your \s-1XIM\s0 server is actually running." 4 +.IX Item "- Make sure your XIM server is actually running." +.PD 0 +.ie n .IP "\- Make sure the ""XMODIFIERS""\fR environment variable is set correctly when \fIstarting rxvt\-unicode." 4 +.el .IP "\- Make sure the \f(CWXMODIFIERS\fR environment variable is set correctly when \fIstarting\fR rxvt\-unicode." 4 +.IX Item "- Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode." +.PD +When you want to use e.g. \fBkinput2\fR, it must be set to +\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. Youc an see what input +method servers are running with this command: +.Sp +.Vb 1 +\& xprop -root XIM_SERVERS +.Ve +.IP "*" 4 +.PP \fIMy input method wants but I want \s-1UTF\-8\s0, what can I do?\fR .IX Subsection "My input method wants but I want UTF-8, what can I do?" .PP @@ -1151,9 +1180,9 @@ terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: .Ve .PP Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still -use your input method. Please note, however, that you will not be able to -input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input -method limits you. +use your input method. Please note, however, that, depending on your Xlib +version, you may not be able to input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a +normal way then, as your input method limits you. .PP \fIRxvt-unicode crashes when the X Input Method changes or exits.\fR .IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits." diff --git a/doc/rxvt.7.pod b/doc/rxvt.7.pod index 3a7e9664..848d95fa 100644 --- a/doc/rxvt.7.pod +++ b/doc/rxvt.7.pod @@ -885,6 +885,37 @@ You can also use xterm's C program, which usually works fine, except for some locales where character width differs between program- and rxvt-unicode-locales. +=head3 I have problems getting my input method working. + +Try a search engine, as this is slightly different for every input method server. + +Here is a checklist: + +=over 4 + +=item - Make sure your locale I the imLocale are supported on your OS. + +Try C or check the documentation for your OS. + +=item - Make sure your locale or imLocale matches a locale supported by your XIM. + +For example, B does not support UTF-8 locales, you should use +C or equivalent. + +=item - Make sure your XIM server is actually running. + +=item - Make sure the C environment variable is set correctly when I rxvt-unicode. + +When you want to use e.g. B, it must be set to +C<@im=kinput2>. For B, use C<@im=SCIM>. Youc an see what input +method servers are running with this command: + + xprop -root XIM_SERVERS + +=item + +=back + =head3 My input method wants but I want UTF-8, what can I do? You can specify separate locales for the input method and the rest of the @@ -893,9 +924,9 @@ terminal, using the resource C: URxvt.imlocale: ja_JP.EUC-JP Now you can start your terminal with C and still -use your input method. Please note, however, that you will not be able to -input characters outside C in a normal way then, as your input -method limits you. +use your input method. Please note, however, that, depending on your Xlib +version, you may not be able to input characters outside C in a +normal way then, as your input method limits you. =head3 Rxvt-unicode crashes when the X Input Method changes or exits. diff --git a/doc/rxvt.7.txt b/doc/rxvt.7.txt index f6736453..14fe9d12 100644 --- a/doc/rxvt.7.txt +++ b/doc/rxvt.7.txt @@ -827,6 +827,31 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS except for some locales where character width differs between program- and rxvt-unicode-locales. + I have problems getting my input method working. + Try a search engine, as this is slightly different for every input + method server. + + Here is a checklist: + + - Make sure your locale *and* the imLocale are supported on your OS. + Try "locale -a" or check the documentation for your OS. + + - Make sure your locale or imLocale matches a locale supported by your + XIM. + For example, kinput2 does not support UTF-8 locales, you should use + "ja_JP.EUC-JP" or equivalent. + + - Make sure your XIM server is actually running. + - Make sure the "XMODIFIERS" environment variable is set correctly when + *starting* rxvt-unicode. + When you want to use e.g. kinput2, it must be set to "@im=kinput2". + For scim, use "@im=SCIM". Youc an see what input method servers are + running with this command: + + xprop -root XIM_SERVERS + + * + My input method wants but I want UTF-8, what can I do? You can specify separate locales for the input method and the rest of the terminal, using the resource "imlocale": @@ -834,9 +859,9 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS URxvt.imlocale: ja_JP.EUC-JP Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and still - use your input method. Please note, however, that you will not be able - to input characters outside "EUC-JP" in a normal way then, as your input - method limits you. + use your input method. Please note, however, that, depending on your + Xlib version, you may not be able to input characters outside "EUC-JP" + in a normal way then, as your input method limits you. Rxvt-unicode crashes when the X Input Method changes or exits. Unfortunately, this is unavoidable, as the XIM protocol is racy by