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
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.
<li><a href="#how_does_rxvtunicode_determine_the_encoding_to_use">How does rxvt-unicode determine the encoding to use?</a></li>
<li><a href="#is_there_an_option_to_switch_encodings">Is there an option to switch encodings?</a></li>
<li><a href="#can_i_switch_locales_at_runtime">Can I switch locales at runtime?</a></li>
+ <li><a href="#i_have_problems_getting_my_input_method_working_">I have problems getting my input method working.</a></li>
<li><a href="#my_input_method_wants__some_encoding__but_i_want_utf8__what_can_i_do">My input method wants <some encoding> but I want UTF-8, what can I do?</a></li>
<li><a href="#rxvtunicode_crashes_when_the_x_input_method_changes_or_exits_">Rxvt-unicode crashes when the X Input Method changes or exits.</a></li>
</ul>
rxvt-unicode-locales.</p>
<p>
</p>
+<h3><a name="i_have_problems_getting_my_input_method_working_">I have problems getting my input method working.</a></h3>
+<p>Try a search engine, as this is slightly different for every input method server.</p>
+<p>Here is a checklist:</p>
+<dl>
+<dt><strong><a name="item__2d_make_sure_your_locale_and_the_imlocale_are_sup">- Make sure your locale <em>and</em> the imLocale are supported on your OS.</a></strong><br />
+</dt>
+<dd>
+Try <code>locale -a</code> or check the documentation for your OS.
+</dd>
+<p></p>
+<dt><strong><a name="item__2d_make_sure_your_locale_or_imlocale_matches_a_lo">- Make sure your locale or imLocale matches a locale supported by your XIM.</a></strong><br />
+</dt>
+<dd>
+For example, <strong>kinput2</strong> does not support UTF-8 locales, you should use
+<code>ja_JP.EUC-JP</code> or equivalent.
+</dd>
+<p></p>
+<dt><strong><a name="item__2d_make_sure_your_xim_server_is_actually_running_">- Make sure your XIM server is actually running.</a></strong><br />
+</dt>
+<dt><strong><a name="item__2d_make_sure_the_xmodifiers_environment_variable_">- Make sure the <code>XMODIFIERS</code> environment variable is set correctly when <em>starting</em> rxvt-unicode.</a></strong><br />
+</dt>
+<dd>
+When you want to use e.g. <strong>kinput2</strong>, it must be set to
+<code>@im=kinput2</code>. For <strong>scim</strong>, use <code>@im=SCIM</code>. Youc an see what input
+method servers are running with this command:
+</dd>
+<dd>
+<pre>
+ xprop -root XIM_SERVERS</pre>
+</dd>
+<p></p>
+<dt></dt>
+</dl>
+<p>
+</p>
<h3><a name="my_input_method_wants__some_encoding__but_i_want_utf8__what_can_i_do">My input method wants <some encoding> but I want UTF-8, what can I do?</a></h3>
<p>You can specify separate locales for the input method and the rest of the
terminal, using the resource <code>imlocale</code>:</p>
<pre>
URxvt.imlocale: ja_JP.EUC-JP</pre>
<p>Now you can start your terminal with <code>LC_CTYPE=ja_JP.UTF-8</code> and still
-use your input method. Please note, however, that you will not be able to
-input characters outside <code>EUC-JP</code> in a normal way then, as your input
-method limits you.</p>
+use your input method. Please note, however, that, depending on your Xlib
+version, you may not be able to input characters outside <code>EUC-JP</code> in a
+normal way then, as your input method limits you.</p>
<p>
</p>
<h3><a name="rxvtunicode_crashes_when_the_x_input_method_changes_or_exits_">Rxvt-unicode crashes when the X Input Method changes or exits.</a></h3>
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 <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR
.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
.PP
.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."
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<and> the imLocale are supported on your OS.
+
+Try C<locale -a> or check the documentation for your OS.
+
+=item - Make sure your locale or imLocale matches a locale supported by your XIM.
+
+For example, B<kinput2> does not support UTF-8 locales, you should use
+C<ja_JP.EUC-JP> or equivalent.
+
+=item - Make sure your XIM server is actually running.
+
+=item - Make sure the C<XMODIFIERS> environment variable is set correctly when I<starting> rxvt-unicode.
+
+When you want to use e.g. B<kinput2>, it must be set to
+C<@im=kinput2>. For B<scim>, 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 <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
URxvt.imlocale: ja_JP.EUC-JP
Now you can start your terminal with C<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 C<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 C<EUC-JP> in a
+normal way then, as your input method limits you.
=head3 Rxvt-unicode crashes when the X Input Method changes or exits.
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 <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.
Unfortunately, this is unavoidable, as the XIM protocol is racy by
projects / dana / urxvt.git / commitdiff