set _NET_WM_USER_TIME on the window
[dana/urxvt.git] / README.FAQ
index 8022106..1c257ce 100644 (file)
@@ -5,6 +5,17 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
     "#rxvt-unicode" has some rxvt-unicode enthusiasts that might be
     interested in learning about new and exciting problems (but not FAQs :).
 
+   I use Gentoo, and I have a problem...
+    There are three big problems with Gentoo Linux: first of all, most if
+    not all Gentoo systems are completely broken (missing or mismatched
+    header files, broken compiler etc. are just the tip of the iceberg);
+    secondly, the Gentoo maintainer thinks it is a good idea to add broken
+    patches to the code; and lastly, it should be called Gentoo GNU/Linux.
+
+    For these reasons, it is impossible to support rxvt-unicode on Gentoo.
+    Problems appearing on Gentoo systems will usually simply be ignored
+    unless they can be reproduced on non-Gentoo systems.
+
    Does it support tabs, can I have a tabbed rxvt-unicode?
     Beginning with version 7.3, there is a perl extension that implements a
     simple tabbed terminal. It is installed by default, so any of these
@@ -489,6 +500,10 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
     In this case either do not specify a preeditStyle or specify more than
     one pre-edit style, such as OverTheSpot,Root,None.
 
+    If it still doesn't work, then maybe your input method doesn't support
+    compose sequences - to fall back to the built-in one, make sure you
+    don't specify an input method via "-im" or "XMODIFIERS".
+
    I cannot type "Ctrl-Shift-2" to get an ASCII NUL character due to ISO 14755
     Either try "Ctrl-2" alone (it often is mapped to ASCII NUL even on
     international keyboards) or simply use ISO 14755 support to your
@@ -637,7 +652,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
 
     The selection stuff mainly makes the selection perl-error-message aware
     and tells it to convert perl error messages into vi-commands to load the
-    relevant file and go tohe error line number.
+    relevant file and go to the error line number.
 
        URxvt.scrollstyle:      plain
        URxvt.secondaryScroll:  true
@@ -720,7 +735,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
     bold and normal fonts.
 
     Please note that I used the "urxvt" instance name and not the "URxvt"
-    class name. Thats because I use different configs for different
+    class name. That is because I use different configs for different
     purposes, for example, my IRC window is started with "-name IRC", and
     uses these defaults:
 
@@ -734,7 +749,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
        IRC*keysym.M-C-1:       command:\033]710;suxuseuro\007\033]711;suxuseuro\007
        IRC*keysym.M-C-2:       command:\033]710;9x15bold\007\033]711;9x15bold\007
 
-    "Alt-Shift-1" and "Alt-Shift-2" switch between two different font sizes.
+    "Alt-Ctrl-1" and "Alt-Ctrl-2" switch between two different font sizes.
     "suxuseuro" allows me to keep an eye (and actually read) stuff while
     keeping a very small window. If somebody pastes something complicated
     (e.g. japanese), I temporarily switch to a larger font.
@@ -780,14 +795,14 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
     arises).
 
     The correct solution for this problem is to install the terminfo, this
-    can be done like this (with ncurses' infocmp and works as user and
-    admin):
+    can be done by simply installing rxvt-unicode on the remote system as
+    well (in case you have a nice package manager ready), or you can install
+    the terminfo database manually like this (with ncurses infocmp. works as
+    user and root):
 
        REMOTE=remotesystem.domain
        infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
 
-    ... or by installing rxvt-unicode normally on the remote system,
-
     One some systems you might need to set $TERMINFO to the full path of
     $HOME/.terminfo for this to work.
 
@@ -806,6 +821,11 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
     If you don't plan to use rxvt (quite common...) you could also replace
     the rxvt terminfo file with the rxvt-unicode one and use "TERM=rxvt".
 
+   nano fails with "Error opening terminal: rxvt-unicode"
+    This exceptionally confusing and useless error message is printed by
+    nano when it can't find the terminfo database. Nothing is wrong with
+    your terminal, read the previous answer for a solution.
+
    "tic" outputs some error when compiling the terminfo entry.
     Most likely it's the empty definition for "enacs=". Just replace it by
     "enacs=\E[0@" and try again.
@@ -1020,7 +1040,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
     should be enabled, as important functionality (menus, selection, likely
     more in the future) depends on it.
 
-    You should not overwrite the "perl-ext-common" snd "perl-ext" resources
+    You should not overwrite the "perl-ext-common" and "perl-ext" resources
     system-wide (except maybe with "defaults"). This will result in useful
     behaviour. If your distribution aims at low memory, add an empty
     "perl-ext-common" resource to the app-defaults file. This will keep the
@@ -1102,3 +1122,8 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
 
     http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
 
+   I want 256 colors
+    Are you sure you need 256 colors? 88 colors should be enough for most
+    purposes. If you really need more, there is an unsupported patch for it
+    in the doc directory, but please do not ask for it to be applied.
+