channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be
interested in learning about new and exciting problems (but not FAQs :).
+=head3 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.
+
=head3 Does it support tabs, can I have a tabbed rxvt-unicode?
Beginning with version 7.3, there is a perl extension that implements a
In this case either do not specify a B<preeditStyle> or specify more than
one pre-edit style, such as B<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 C<-im> or C<XMODIFIERS>.
+
=head3 I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755
Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on
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 tot he error line number.
+relevant file and go to the error line number.
URxvt.scrollstyle: plain
URxvt.secondaryScroll: true
normal fonts.
Please note that I used the C<urxvt> instance name and not the C<URxvt>
-class name. Thats because I use different configs for different purposes,
+class name. That is because I use different configs for different purposes,
for example, my IRC window is started with C<-name IRC>, and uses these
defaults:
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
-C<Alt-Shift-1> and C<Alt-Shift-2> switch between two different font
+C<Alt-Ctrl-1> and C<Alt-Ctrl-2> switch between two different font
sizes. C<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.
as that for xterm, or even rxvt (for which the same problem often 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):
+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 C<$TERMINFO> to the full path of
F<$HOME/.terminfo> for this to work.
If you don't plan to use B<rxvt> (quite common...) you could also replace
the rxvt terminfo file with the rxvt-unicode one and use C<TERM=rxvt>.
+=head3 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.
+
=head3 C<tic> outputs some error when compiling the terminfo entry.
Most likely it's the empty definition for C<enacs=>. Just replace it by
infocmp -C rxvt-unicode
-Or you could use this termcap entry, generated by the command above:
-
- rxvt-unicode|rxvt-unicode terminal (X Window System):\
- :am:bw:eo:km:mi:ms:xn:xo:\
- :co#80:it#8:li#24:lm#0:\
- :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
- :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
- :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
- :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
- :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
- :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
- :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
- :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
- :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
- :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
- :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
- :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
- :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
- :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
- :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
- :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
- :vs=\E[?25h:
+Or you could use the termcap entry in doc/etc/rxvt-unicode.termcap,
+generated by the command above.
=head3 Why does C<ls> no longer have coloured output?
be enabled, as important functionality (menus, selection, likely more in
the future) depends on it.
-You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources
+You should not overwrite the C<perl-ext-common> and C<perl-ext> resources
system-wide (except maybe with C<defaults>). This will result in useful
behaviour. If your distribution aims at low memory, add an empty
C<perl-ext-common> resource to the app-defaults file. This will keep the
B<wchar_t>. This is, of course, completely fine with respect to standards.
However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and
-C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>.
+C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>).
C<__STDC_ISO_10646__> is the only sane way to support multi-language
apps in an OS, as using a locale-dependent (and non-standardized)
Application Keypad (SMKX). See also next sequence.
-=item B<<< C<< ESC >> >>>
+=item B<<< C<< ESC > >> >>>
Normal Keypad (RMKX)
B<< C<Ps = 0> >> Clear to Right (default)
B<< C<Ps = 1> >> Clear to Left
B<< C<Ps = 2> >> Clear All
+ B<< C<Ps = 3> >> Like Ps = 0, but is ignored when wrapped
+ (@@RXVT_NAME@@ extension)
=end table
B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency).
B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >>
+ B<< C<Ps = 708> >> Change colour of the border to B<< C<Pt> >>
B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>.
B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
=item --enable-everything
-Add (or remove) support for all non-multichoice options listed in "./configure
---help".
+Add (or remove) support for all non-multichoice options listed in
+C<./configure --help>, except for C<--enable-assert>.
You can specify this and then disable options you do not like by
I<following> this with the appropriate C<--disable-...> arguments,
C<--disable-everything> and than adding just the C<--enable-...> arguments
you want.
+=item --enable-256-color (default: off)
+
+Add support for 256 colors.
+
=item --enable-xft (default: enabled)
Add support for Xft (anti-aliases, among others) fonts. Xft fonts are
Enable automatic composition of combining characters into
composite characters. This is required for proper viewing of text
-where accents are encoded as seperate unicode characters. This is
+where accents are encoded as separate unicode characters. This is
done by using precomposited characters when available or creating
new pseudo-characters when no precomposed form exists.
MWM-hints
EWMH-hints (pid, utf8 names) and protocols (ping)
urgency hint
- seperate underline colour (-underlineColor)
+ separate underline colour (-underlineColor)
settable border widths and borderless switch (-w, -b, -bl)
visual depth selection (-depth)
settable extra linespacing /-lsp)
tripleclickwords (-tcw)
settable insecure mode (-insecure)
keysym remapping support
- cursor blinking and underline cursor (-cb, -uc)
+ cursor blinking and underline cursor (-bc, -uc)
XEmbed support (-embed)
user-pty (-pty-fd)
hold on exit (-hold)
=item --enable-iso14755 (default: on)
-Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
-F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by
-C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with
-this switch.
+Enable extended ISO 14755 support (see @@RXVT_NAME@@(1)).
+Basic support (section 5.1) is enabled by C<--enable-frills>, while
+support for 5.2, 5.3 and 5.4 is enabled with this switch.
=item --enable-keepscrolling (default: on)
=item --enable-perl (default: on)
Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
-manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the
-files in F<src/perl/> for the extensions that are installed by
-default. The perl interpreter that is used can be specified via the
-C<PERL> environment variable when running configure. Even when compiled
-in, perl will I<not> be initialised when all extensions have been disabled
+manpage for more info on this feature, or the files in F<src/perl/>
+for the extensions that are installed by default.
+The perl interpreter that is used can be specified via the C<PERL>
+environment variable when running configure. Even when compiled in,
+perl will I<not> be initialised when all extensions have been disabled
C<-pe "" --perl-ext-common "">, so it should be safe to enable from a
resource standpoint.
+=item --enable-assert (default: off)
+
+Enables the assertions in the code, normally disabled. This switch is only
+useful when developing rxvt-unicode.
+
=item --with-afterimage-config=DIR
Look for the libAfterImage config script in DIR.