ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.pod
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.143 by ayin, Thu Aug 2 00:09:54 2007 UTC vs.
Revision 1.217 by sf-exg, Wed Dec 14 12:28:26 2011 UTC

17 17
18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting 18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
19all escape sequences, and other background information. 19all escape sequences, and other background information.
20 20
21The newest version of this document is also available on the World Wide Web at 21The newest version of this document is also available on the World Wide Web at
22L<http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html>. 22L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod>.
23
24The main manual page for @@RXVT_NAME@@ itself is available at
25L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod>.
23 26
24=head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 27=head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
25 28
26 29
27=head2 Meta, Features & Commandline Issues 30=head2 Meta, Features & Commandline Issues
29=head3 My question isn't answered here, can I ask a human? 32=head3 My question isn't answered here, can I ask a human?
30 33
31Before sending me mail, you could go to IRC: C<irc.freenode.net>, 34Before sending me mail, you could go to IRC: C<irc.freenode.net>,
32channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be 35channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be
33interested in learning about new and exciting problems (but not FAQs :). 36interested in learning about new and exciting problems (but not FAQs :).
37
38=head3 I use Gentoo, and I have a problem...
39
40There are three big problems with Gentoo Linux: first of all, most if not
41all Gentoo systems are completely broken (missing or mismatched header
42files, broken compiler etc. are just the tip of the iceberg); secondly,
43the Gentoo maintainer thinks it is a good idea to add broken patches to
44the code; and lastly, it should be called Gentoo GNU/Linux.
45
46For these reasons, it is impossible to support rxvt-unicode on
47Gentoo. Problems appearing on Gentoo systems will usually simply be
48ignored unless they can be reproduced on non-Gentoo systems.
34 49
35=head3 Does it support tabs, can I have a tabbed rxvt-unicode? 50=head3 Does it support tabs, can I have a tabbed rxvt-unicode?
36 51
37Beginning with version 7.3, there is a perl extension that implements a 52Beginning with version 7.3, there is a perl extension that implements a
38simple tabbed terminal. It is installed by default, so any of these should 53simple tabbed terminal. It is installed by default, so any of these should
90This tries to create a new terminal, and if fails with exit status 2, 105This tries to create a new terminal, and if fails with exit status 2,
91meaning it couldn't connect to the daemon, it will start the daemon and 106meaning it couldn't connect to the daemon, it will start the daemon and
92re-run the command. Subsequent invocations of the script will re-use the 107re-run the command. Subsequent invocations of the script will re-use the
93existing daemon. 108existing daemon.
94 109
95=head3 How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc. 110=head3 How do I distinguish whether I'm running rxvt-unicode or a regular
111xterm? I need this to decide about setting colours etc.
96 112
97The original rxvt and rxvt-unicode always export the variable "COLORTERM", 113The original rxvt and rxvt-unicode always export the variable "COLORTERM",
98so you can check and see if that is set. Note that several programs, JED, 114so you can check and see if that is set. Note that several programs, JED,
99slrn, Midnight Commander automatically check this variable to decide 115slrn, Midnight Commander automatically check this variable to decide
100whether or not to use color. 116whether or not to use colour.
101 117
102=head3 How do I set the correct, full IP address for the DISPLAY variable? 118=head3 How do I set the correct, full IP address for the DISPLAY variable?
103 119
104If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled 120If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
105insecure mode then it is possible to use the following shell script 121insecure mode then it is possible to use the following shell script
183the case of rxvt-unicode this hardly matters, as its portability limits 199the case of rxvt-unicode this hardly matters, as its portability limits
184are defined by things like X11, pseudo terminals, locale support and unix 200are defined by things like X11, pseudo terminals, locale support and unix
185domain sockets, which are all less portable than C++ itself. 201domain sockets, which are all less portable than C++ itself.
186 202
187Regarding the bloat, see the above question: It's easy to write programs 203Regarding the bloat, see the above question: It's easy to write programs
188in C that use gobs of memory, an certainly possible to write programs in 204in C that use gobs of memory, and certainly possible to write programs in
189C++ that don't. C++ also often comes with large libraries, but this is 205C++ that don't. C++ also often comes with large libraries, but this is
190not necessarily the case with GCC. Here is what rxvt links against on my 206not necessarily the case with GCC. Here is what rxvt links against on my
191system with a minimal config: 207system with a minimal config:
192 208
193 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 209 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
197 213
198And here is rxvt-unicode: 214And here is rxvt-unicode:
199 215
200 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 216 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
201 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) 217 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
202 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) 218 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)
203 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) 219 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)
204 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 220 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
205 221
206No large bloated libraries (of course, none were linked in statically), 222No large bloated libraries (of course, none were linked in statically),
207except maybe libX11 :) 223except maybe libX11 :)
208 224
209 225
217of passage: ... and you failed. 233of passage: ... and you failed.
218 234
219Here are four ways to get transparency. B<Do> read the manpage and option 235Here are four ways to get transparency. B<Do> read the manpage and option
220descriptions for the programs mentioned and rxvt-unicode. Really, do it! 236descriptions for the programs mentioned and rxvt-unicode. Really, do it!
221 237
2221. Use inheritPixmap: 2381. Use transparent mode:
223 239
224 Esetroot wallpaper.jpg 240 Esetroot wallpaper.jpg
225 @@URXVT_NAME@@ -ip -tint red -sh 40 241 @@URXVT_NAME@@ -tr -tint red -sh 40
226 242
227That works. If you think it doesn't, you lack transparency and tinting 243That works. If you think it doesn't, you lack transparency and tinting
228support, or you are unable to read. 244support, or you are unable to read.
245This method requires that the background-setting program sets the
246_XROOTPMAP_ID or ESETROOT_PMAP_ID property. Compatible programs
247are Esetroot, hsetroot and feh.
229 248
2302. Use a simple pixmap and emulate pseudo-transparency. This enables you 2492. Use a simple pixmap and emulate pseudo-transparency. This enables you
231to use effects other than tinting and shading: Just shade/tint/whatever 250to use effects other than tinting and shading: Just shade/tint/whatever
232your picture with gimp or any other tool: 251your picture with gimp or any other tool:
233 252
234 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 253 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
235 @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background 254 @@URXVT_NAME@@ -pixmap "background.jpg;:root"
236 255
237That works. If you think it doesn't, you lack XPM and Perl support, or you 256That works. If you think it doesn't, you lack libAfterImage or GDK-PixBuf support, or you
238are unable to read. 257are unable to read.
239 258
2403. Use an ARGB visual: 2593. Use an ARGB visual:
241 260
242 @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 261 @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
342=head3 What's with this bold/blink stuff? 361=head3 What's with this bold/blink stuff?
343 362
344If no bold colour is set via C<colorBD:>, bold will invert text using the 363If no bold colour is set via C<colorBD:>, bold will invert text using the
345standard foreground colour. 364standard foreground colour.
346 365
347For the standard background colour, blinking will actually make the 366For the standard background colour, blinking will actually make
348text blink when compiled with C<--enable-blinking>. with standard 367the text blink when compiled with C<--enable-text-blink>. Without
349colours. Without C<--enable-blinking>, the blink attribute will be 368C<--enable-text-blink>, the blink attribute will be ignored.
350ignored.
351 369
352On ANSI colours, bold/blink attributes are used to set high-intensity 370On ANSI colours, bold/blink attributes are used to set high-intensity
353foreground/background colors. 371foreground/background colours.
354 372
355color0-7 are the low-intensity colors. 373color0-7 are the low-intensity colours.
356 374
357color8-15 are the corresponding high-intensity colors. 375color8-15 are the corresponding high-intensity colours.
358 376
359=head3 I don't like the screen colors. How do I change them? 377=head3 I don't like the screen colours. How do I change them?
360 378
361You can change the screen colors at run-time using F<~/.Xdefaults> 379You can change the screen colours at run-time using F<~/.Xdefaults>
362resources (or as long-options). 380resources (or as long-options).
363 381
364Here are values that are supposed to resemble a VGA screen, 382Here are values that are supposed to resemble a VGA screen,
365including the murky brown that passes for low-intensity yellow: 383including the murky brown that passes for low-intensity yellow:
366 384
380 URxvt.color12: #0000FF 398 URxvt.color12: #0000FF
381 URxvt.color13: #FF00FF 399 URxvt.color13: #FF00FF
382 URxvt.color14: #00FFFF 400 URxvt.color14: #00FFFF
383 URxvt.color15: #FFFFFF 401 URxvt.color15: #FFFFFF
384 402
385And here is a more complete set of non-standard colors. 403And here is a more complete set of non-standard colours.
386 404
387 URxvt.cursorColor: #dc74d1 405 URxvt.cursorColor: #dc74d1
388 URxvt.pointerColor: #dc74d1 406 URxvt.pointerColor: #dc74d1
389 URxvt.background: #0e0e0e 407 URxvt.background: #0e0e0e
390 URxvt.foreground: #4ad5e1 408 URxvt.foreground: #4ad5e1
460has been designed yet). 478has been designed yet).
461 479
462Until then, you might get away with switching fonts at runtime (see L<Can 480Until then, you might get away with switching fonts at runtime (see L<Can
463I switch the fonts at runtime?> later in this document). 481I switch the fonts at runtime?> later in this document).
464 482
483=head3 How can I make mplayer display video correctly?
484
485We are working on it, in the meantime, as a workaround, use something like:
486
487 @@URXVT_NAME@@ -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
488
489
465=head2 Keyboard, Mouse & User Interaction 490=head2 Keyboard, Mouse & User Interaction
466 491
467=head3 The new selection selects pieces that are too big, how can I select single words? 492=head3 The new selection selects pieces that are too big, how can I select single words?
468 493
469If you want to select e.g. alphanumeric words, you can use the following 494If you want to select e.g. alphanumeric words, you can use the following
476 501
477To get a selection that is very similar to the old code, try this pattern: 502To get a selection that is very similar to the old code, try this pattern:
478 503
479 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) 504 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+)
480 505
481Please also note that the I<LeftClick Shift-LeftClik> combination also 506Please also note that the I<LeftClick Shift-LeftClick> combination also
482selects words like the old code. 507selects words like the old code.
483 508
484=head3 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it? 509=head3 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?
485 510
486You can disable the perl extension completely by setting the 511You can disable the perl extension completely by setting the
538rxvt-unicode will continue without an input method. 563rxvt-unicode will continue without an input method.
539 564
540In this case either do not specify a B<preeditStyle> or specify more than 565In this case either do not specify a B<preeditStyle> or specify more than
541one pre-edit style, such as B<OverTheSpot,Root,None>. 566one pre-edit style, such as B<OverTheSpot,Root,None>.
542 567
568If it still doesn't work, then maybe your input method doesn't support
569compose sequences - to fall back to the built-in one, make sure you don't
570specify an input method via C<-im> or C<XMODIFIERS>.
571
543=head3 I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755 572=head3 I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755
544 573
545Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on 574Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on
546international keyboards) or simply use ISO 14755 support to your 575international keyboards) or simply use ISO 14755 support to your
547advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for other 576advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for other
549character and so on. 578character and so on.
550 579
551=head3 Mouse cut/paste suddenly no longer works. 580=head3 Mouse cut/paste suddenly no longer works.
552 581
553Make sure that mouse reporting is actually turned off since killing 582Make sure that mouse reporting is actually turned off since killing
554some editors prematurely may leave the mouse in mouse report mode. I've 583some editors prematurely may leave it active. I've
555heard that tcsh may use mouse reporting unless it otherwise specified. A 584heard that tcsh may use mouse reporting unless it is otherwise specified. A
556quick check is to see if cut/paste works when the Alt or Shift keys are 585quick check is to see if cut/paste works when the Alt or Shift keys are
557depressed. 586pressed.
558 587
559=head3 What's with the strange Backspace/Delete key behaviour? 588=head3 What's with the strange Backspace/Delete key behaviour?
560 589
561Assuming that the physical Backspace key corresponds to the 590Assuming that the physical Backspace key corresponds to the
562Backspace keysym (not likely for Linux ... see the following 591Backspace keysym (not likely for Linux ... see the following
565 594
566Historically, either value is correct, but rxvt-unicode adopts the debian 595Historically, either value is correct, but rxvt-unicode adopts the debian
567policy of using C<^?> when unsure, because it's the one and only correct 596policy of using C<^?> when unsure, because it's the one and only correct
568choice :). 597choice :).
569 598
570Rxvt-unicode tries to inherit the current stty settings and uses the value 599It is possible to toggle between C<^H> and C<^?> with the DECBKM
571of `erase' to guess the value for backspace. If rxvt-unicode wasn't 600private mode:
572started from a terminal (say, from a menu or by remote shell), then the
573system value of `erase', which corresponds to CERASE in <termios.h>, will
574be used (which may not be the same as your stty setting).
575
576For starting a new rxvt-unicode:
577 601
578 # use Backspace = ^H 602 # use Backspace = ^H
579 $ stty erase ^H 603 $ stty erase ^H
580 $ @@URXVT_NAME@@ 604 $ echo -n "^[[?67h"
581 605
582 # use Backspace = ^? 606 # use Backspace = ^?
583 $ stty erase ^? 607 $ stty erase ^?
584 $ @@URXVT_NAME@@
585
586Toggle with C<ESC [ 36 h> / C<ESC [ 36 l>.
587
588For an existing rxvt-unicode:
589
590 # use Backspace = ^H
591 $ stty erase ^H
592 $ echo -n "^[[36h"
593
594 # use Backspace = ^?
595 $ stty erase ^?
596 $ echo -n "^[[36l" 608 $ echo -n "^[[?67l"
597 609
598This helps satisfy some of the Backspace discrepancies that occur, but 610This helps satisfy some of the Backspace discrepancies that occur, but
599if you use Backspace = C<^H>, make sure that the termcap/terminfo value 611if you use Backspace = C<^H>, make sure that the termcap/terminfo value
600properly reflects that. 612properly reflects that.
601 613
604key has been assigned an escape sequence to match the vt100 for Execute 616key has been assigned an escape sequence to match the vt100 for Execute
605(C<ESC [ 3 ~>) and is in the supplied termcap/terminfo. 617(C<ESC [ 3 ~>) and is in the supplied termcap/terminfo.
606 618
607Some other Backspace problems: 619Some other Backspace problems:
608 620
609some editors use termcap/terminfo, 621some editors use termcap/terminfo,
610some editors (vim I'm told) expect Backspace = ^H, 622some editors (vim I'm told) expect Backspace = ^H,
611GNU Emacs (and Emacs-like editors) use ^H for help. 623GNU Emacs (and Emacs-like editors) use ^H for help.
612 624
613Perhaps someday this will all be resolved in a consistent manner. 625Perhaps someday this will all be resolved in a consistent manner.
614 626
618you have run "configure" with the C<--disable-resources> option you can 630you have run "configure" with the C<--disable-resources> option you can
619use the `keysym' resource to alter the keystrings associated with keysyms. 631use the `keysym' resource to alter the keystrings associated with keysyms.
620 632
621Here's an example for a URxvt session started using C<@@URXVT_NAME@@ -name URxvt> 633Here's an example for a URxvt session started using C<@@URXVT_NAME@@ -name URxvt>
622 634
635 URxvt.keysym.Prior: \033[5~
636 URxvt.keysym.Next: \033[6~
623 URxvt.keysym.Home: \033[1~ 637 URxvt.keysym.Home: \033[7~
624 URxvt.keysym.End: \033[4~ 638 URxvt.keysym.End: \033[8~
625 URxvt.keysym.C-apostrophe: \033<C-'>
626 URxvt.keysym.C-slash: \033<C-/>
627 URxvt.keysym.C-semicolon: \033<C-;>
628 URxvt.keysym.C-grave: \033<C-`>
629 URxvt.keysym.C-comma: \033<C-,>
630 URxvt.keysym.C-period: \033<C-.>
631 URxvt.keysym.C-0x60: \033<C-`>
632 URxvt.keysym.C-Tab: \033<C-Tab>
633 URxvt.keysym.C-Return: \033<C-Return>
634 URxvt.keysym.S-Return: \033<S-Return>
635 URxvt.keysym.S-space: \033<S-Space>
636 URxvt.keysym.M-Up: \033<M-Up> 639 URxvt.keysym.Up: \033[A
637 URxvt.keysym.M-Down: \033<M-Down> 640 URxvt.keysym.Down: \033[B
641 URxvt.keysym.Right: \033[C
638 URxvt.keysym.M-Left: \033<M-Left> 642 URxvt.keysym.Left: \033[D
639 URxvt.keysym.M-Right: \033<M-Right>
640 URxvt.keysym.M-C-0: list \033<M-C- 0123456789 >
641 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >
642 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
643 643
644See some more examples in the documentation for the B<keysym> resource. 644See some more examples in the documentation for the B<keysym> resource.
645 645
646=head3 I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map 646=head3 I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map
647 647
655Rather than have rxvt-unicode try to accommodate all the various possible 655Rather than have rxvt-unicode try to accommodate all the various possible
656keyboard mappings, it is better to use `xmodmap' to remap the keys as 656keyboard mappings, it is better to use `xmodmap' to remap the keys as
657required for your particular machine. 657required for your particular machine.
658 658
659 659
660
661=head2 Terminal Configuration 660=head2 Terminal Configuration
662 661
663=head3 Can I see a typical configuration? 662=head3 Can I see a typical configuration?
664 663
665The default configuration tries to be xterm-like, which I don't like that 664The default configuration tries to be xterm-like, which I don't like that
695develop for myself mostly, so I actually use most of the extensions I 694develop for myself mostly, so I actually use most of the extensions I
696write. 695write.
697 696
698The selection stuff mainly makes the selection perl-error-message aware 697The selection stuff mainly makes the selection perl-error-message aware
699and tells it to convert perl error messages into vi-commands to load the 698and tells it to convert perl error messages into vi-commands to load the
700relevant file and go tot he error line number. 699relevant file and go to the error line number.
701 700
702 URxvt.scrollstyle: plain 701 URxvt.scrollstyle: plain
703 URxvt.secondaryScroll: true 702 URxvt.secondaryScroll: true
704 703
705As the documentation says: plain is the preferred scrollbar for the 704As the documentation says: plain is the preferred scrollbar for the
777purposes, it works, and gives a different look, as my normal (Non-bold) 776purposes, it works, and gives a different look, as my normal (Non-bold)
778font is already bold, and I want to see a difference between bold and 777font is already bold, and I want to see a difference between bold and
779normal fonts. 778normal fonts.
780 779
781Please note that I used the C<urxvt> instance name and not the C<URxvt> 780Please note that I used the C<urxvt> instance name and not the C<URxvt>
782class name. Thats because I use different configs for different purposes, 781class name. That is because I use different configs for different purposes,
783for example, my IRC window is started with C<-name IRC>, and uses these 782for example, my IRC window is started with C<-name IRC>, and uses these
784defaults: 783defaults:
785 784
786 IRC*title: IRC 785 IRC*title: IRC
787 IRC*geometry: 87x12+535+542 786 IRC*geometry: 87x12+535+542
791 IRC*boldFont: suxuseuro 790 IRC*boldFont: suxuseuro
792 IRC*colorBD: white 791 IRC*colorBD: white
793 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007 792 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
794 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007 793 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
795 794
796C<Alt-Shift-1> and C<Alt-Shift-2> switch between two different font 795C<Alt-Ctrl-1> and C<Alt-Ctrl-2> switch between two different font
797sizes. C<suxuseuro> allows me to keep an eye (and actually read) 796sizes. C<suxuseuro> allows me to keep an eye (and actually read)
798stuff while keeping a very small window. If somebody pastes something 797stuff while keeping a very small window. If somebody pastes something
799complicated (e.g. japanese), I temporarily switch to a larger font. 798complicated (e.g. japanese), I temporarily switch to a larger font.
800 799
801The above is all in my C<.Xdefaults> (I don't use C<.Xresources> nor 800The above is all in my C<.Xdefaults> (I don't use C<.Xresources> nor
802C<xrdb>). I also have some resources in a separate C<.Xdefaults-hostname> 801C<xrdb>). I also have some resources in a separate C<.Xdefaults-hostname>
803file for different hosts, for example, on ym main desktop, I use: 802file for different hosts, for example, on my main desktop, I use:
804 803
805 URxvt.keysym.C-M-q: command:\033[3;5;5t 804 URxvt.keysym.C-M-q: command:\033[3;5;5t
806 URxvt.keysym.C-M-y: command:\033[3;5;606t 805 URxvt.keysym.C-M-y: command:\033[3;5;606t
807 URxvt.keysym.C-M-e: command:\033[3;1605;5t 806 URxvt.keysym.C-M-e: command:\033[3;1605;5t
808 URxvt.keysym.C-M-c: command:\033[3;1605;606t 807 URxvt.keysym.C-M-c: command:\033[3;1605;606t
838 837
839The terminal description used by rxvt-unicode is not as widely available 838The terminal description used by rxvt-unicode is not as widely available
840as that for xterm, or even rxvt (for which the same problem often arises). 839as that for xterm, or even rxvt (for which the same problem often arises).
841 840
842The correct solution for this problem is to install the terminfo, this can 841The correct solution for this problem is to install the terminfo, this can
843be done like this (with ncurses' infocmp and works as user and admin): 842be done by simply installing rxvt-unicode on the remote system as well
843(in case you have a nice package manager ready), or you can install the
844terminfo database manually like this (with ncurses infocmp. works as
845user and root):
844 846
845 REMOTE=remotesystem.domain 847 REMOTE=remotesystem.domain
846 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" 848 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
847
848... or by installing rxvt-unicode normally on the remote system,
849 849
850One some systems you might need to set C<$TERMINFO> to the full path of 850One some systems you might need to set C<$TERMINFO> to the full path of
851F<$HOME/.terminfo> for this to work. 851F<$HOME/.terminfo> for this to work.
852 852
853If you cannot or do not want to do this, then you can simply set 853If you cannot or do not want to do this, then you can simply set
863 URxvt.termName: rxvt 863 URxvt.termName: rxvt
864 864
865If you don't plan to use B<rxvt> (quite common...) you could also replace 865If you don't plan to use B<rxvt> (quite common...) you could also replace
866the rxvt terminfo file with the rxvt-unicode one and use C<TERM=rxvt>. 866the rxvt terminfo file with the rxvt-unicode one and use C<TERM=rxvt>.
867 867
868=head3 nano fails with "Error opening terminal: rxvt-unicode"
869
870This exceptionally confusing and useless error message is printed by nano
871when it can't find the terminfo database. Nothing is wrong with your
872terminal, read the previous answer for a solution.
873
868=head3 C<tic> outputs some error when compiling the terminfo entry. 874=head3 C<tic> outputs some error when compiling the terminfo entry.
869 875
870Most likely it's the empty definition for C<enacs=>. Just replace it by 876Most likely it's the empty definition for C<enacs=>. Just replace it by
871C<enacs=\E[0@> and try again. 877C<enacs=\E[0@> and try again.
872 878
885You can also create a termcap entry by using terminfo's infocmp program 891You can also create a termcap entry by using terminfo's infocmp program
886like this: 892like this:
887 893
888 infocmp -C rxvt-unicode 894 infocmp -C rxvt-unicode
889 895
890Or you could use this termcap entry, generated by the command above: 896Or you could use the termcap entry in doc/etc/rxvt-unicode.termcap,
891 897generated by the command above.
892 rxvt-unicode|rxvt-unicode terminal (X Window System):\
893 :am:bw:eo:km:mi:ms:xn:xo:\
894 :co#80:it#8:li#24:lm#0:\
895 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
896 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
897 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
898 :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
899 :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
900 :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
901 :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
902 :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
903 :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
904 :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
905 :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
906 :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
907 :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
908 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
909 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
910 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
911 :vs=\E[?25h:
912 898
913=head3 Why does C<ls> no longer have coloured output? 899=head3 Why does C<ls> no longer have coloured output?
914 900
915The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to 901The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to
916decide whether a terminal has colour, but uses its own configuration 902decide whether a terminal has colour, but uses its own configuration
1068C<@im=kinput2>. For B<scim>, use C<@im=SCIM>. You can see what input 1054C<@im=kinput2>. For B<scim>, use C<@im=SCIM>. You can see what input
1069method servers are running with this command: 1055method servers are running with this command:
1070 1056
1071 xprop -root XIM_SERVERS 1057 xprop -root XIM_SERVERS
1072 1058
1073=item 1059=item
1074 1060
1075=back 1061=back
1076 1062
1077=head3 My input method wants <some encoding> but I want UTF-8, what can I do? 1063=head3 My input method wants <some encoding> but I want UTF-8, what can I do?
1078 1064
1104 1090
1105The Debian GNU/Linux package of rxvt-unicode in sarge contains large 1091The Debian GNU/Linux package of rxvt-unicode in sarge contains large
1106patches that considerably change the behaviour of rxvt-unicode (but 1092patches that considerably change the behaviour of rxvt-unicode (but
1107unfortunately this notice has been removed). Before reporting a bug to 1093unfortunately this notice has been removed). Before reporting a bug to
1108the original rxvt-unicode author please download and install the genuine 1094the original rxvt-unicode author please download and install the genuine
1109version (L<http://software.schmorp.de#rxvt-unicode>) and try to reproduce 1095version (L<http://software.schmorp.de/pkg/rxvt-unicode.html>) and try to
1110the problem. If you cannot, chances are that the problems are specific to 1096reproduce the problem. If you cannot, chances are that the problems are
1111Debian GNU/Linux, in which case it should be reported via the Debian Bug 1097specific to Debian GNU/Linux, in which case it should be reported via the
1112Tracking System (use C<reportbug> to report the bug). 1098Debian Bug Tracking System (use C<reportbug> to report the bug).
1113 1099
1114For other problems that also affect the Debian package, you can and 1100For other problems that also affect the Debian package, you can and
1115probably should use the Debian BTS, too, because, after all, it's also a 1101probably should use the Debian BTS, too, because, after all, it's also a
1116bug in the Debian version and it serves as a reminder for other users that 1102bug in the Debian version and it serves as a reminder for other users that
1117might encounter the same issue. 1103might encounter the same issue.
1123runtime-switchable, too, so there is usually no drawback to enabling them, 1109runtime-switchable, too, so there is usually no drawback to enabling them,
1124except higher disk and possibly memory usage. The perl interpreter should 1110except higher disk and possibly memory usage. The perl interpreter should
1125be enabled, as important functionality (menus, selection, likely more in 1111be enabled, as important functionality (menus, selection, likely more in
1126the future) depends on it. 1112the future) depends on it.
1127 1113
1128You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources 1114You should not overwrite the C<perl-ext-common> and C<perl-ext> resources
1129system-wide (except maybe with C<defaults>). This will result in useful 1115system-wide (except maybe with C<defaults>). This will result in useful
1130behaviour. If your distribution aims at low memory, add an empty 1116behaviour. If your distribution aims at low memory, add an empty
1131C<perl-ext-common> resource to the app-defaults file. This will keep the 1117C<perl-ext-common> resource to the app-defaults file. This will keep the
1132perl interpreter disabled until the user enables it. 1118perl interpreter disabled until the user enables it.
1133 1119
1163As you might have guessed, FreeBSD does neither define this symbol nor 1149As you might have guessed, FreeBSD does neither define this symbol nor
1164does it support it. Instead, it uses its own internal representation of 1150does it support it. Instead, it uses its own internal representation of
1165B<wchar_t>. This is, of course, completely fine with respect to standards. 1151B<wchar_t>. This is, of course, completely fine with respect to standards.
1166 1152
1167However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and 1153However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and
1168C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>. 1154C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>).
1169 1155
1170C<__STDC_ISO_10646__> is the only sane way to support multi-language 1156C<__STDC_ISO_10646__> is the only sane way to support multi-language
1171apps in an OS, as using a locale-dependent (and non-standardized) 1157apps in an OS, as using a locale-dependent (and non-standardized)
1172representation of B<wchar_t> makes it impossible to convert between 1158representation of B<wchar_t> makes it impossible to convert between
1173B<wchar_t> (as used by X11 and your applications) and any other encoding 1159B<wchar_t> (as used by X11 and your applications) and any other encoding
1222 1208
1223=over 4 1209=over 4
1224 1210
1225=item B<< C<c> >> 1211=item B<< C<c> >>
1226 1212
1227The literal character c. 1213The literal character c (potentially a multi-byte character).
1228 1214
1229=item B<< C<C> >> 1215=item B<< C<C> >>
1230 1216
1231A single (required) character. 1217A single (required) character.
1232 1218
1317 1303
1318=item B<< C<ESC => >> 1304=item B<< C<ESC => >>
1319 1305
1320Application Keypad (SMKX). See also next sequence. 1306Application Keypad (SMKX). See also next sequence.
1321 1307
1322=item B<<< C<< ESC >> >>> 1308=item B<<< C<< ESC > >> >>>
1323 1309
1324Normal Keypad (RMKX) 1310Normal Keypad (RMKX)
1325 1311
1326B<Note:> If the numeric keypad is activated, eg, B<Num_Lock> has been 1312B<Note:> If the numeric keypad is activated, eg, B<Num_Lock> has been
1327pressed, numbers or control functions are generated by the numeric keypad 1313pressed, numbers or control functions are generated by the numeric keypad
1455 1441
1456Erase in Display (ED) 1442Erase in Display (ED)
1457 1443
1458=begin table 1444=begin table
1459 1445
1460 B<< C<Ps = 0> >> Clear Below (default) 1446 B<< C<Ps = 0> >> Clear Right and Below (default)
1461 B<< C<Ps = 1> >> Clear Above 1447 B<< C<Ps = 1> >> Clear Left and Above
1462 B<< C<Ps = 2> >> Clear All 1448 B<< C<Ps = 2> >> Clear All
1463 1449
1464=end table 1450=end table
1465 1451
1466=item B<< C<ESC [ Ps K> >> 1452=item B<< C<ESC [ Ps K> >>
1470=begin table 1456=begin table
1471 1457
1472 B<< C<Ps = 0> >> Clear to Right (default) 1458 B<< C<Ps = 0> >> Clear to Right (default)
1473 B<< C<Ps = 1> >> Clear to Left 1459 B<< C<Ps = 1> >> Clear to Left
1474 B<< C<Ps = 2> >> Clear All 1460 B<< C<Ps = 2> >> Clear All
1461 B<< C<Ps = 3> >> Like Ps = 0, but is ignored when wrapped
1462 (@@RXVT_NAME@@ extension)
1475 1463
1476=end table 1464=end table
1477 1465
1478=item B<< C<ESC [ Ps L> >> 1466=item B<< C<ESC [ Ps L> >>
1479 1467
1611 B<< C<Ps = 32 / 42> >> fg/bg Green 1599 B<< C<Ps = 32 / 42> >> fg/bg Green
1612 B<< C<Ps = 33 / 43> >> fg/bg Yellow 1600 B<< C<Ps = 33 / 43> >> fg/bg Yellow
1613 B<< C<Ps = 34 / 44> >> fg/bg Blue 1601 B<< C<Ps = 34 / 44> >> fg/bg Blue
1614 B<< C<Ps = 35 / 45> >> fg/bg Magenta 1602 B<< C<Ps = 35 / 45> >> fg/bg Magenta
1615 B<< C<Ps = 36 / 46> >> fg/bg Cyan 1603 B<< C<Ps = 36 / 46> >> fg/bg Cyan
1616 B<< C<Ps = 38;5 / 48;5> >> set fg/bg to color #m (ISO 8613-6) 1604 B<< C<Ps = 38;5 / 48;5> >> set fg/bg to colour #m (ISO 8613-6)
1617 B<< C<Ps = 37 / 47> >> fg/bg White 1605 B<< C<Ps = 37 / 47> >> fg/bg White
1618 B<< C<Ps = 39 / 49> >> fg/bg Default 1606 B<< C<Ps = 39 / 49> >> fg/bg Default
1619 B<< C<Ps = 90 / 100> >> fg/bg Bright Black 1607 B<< C<Ps = 90 / 100> >> fg/bg Bright Black
1620 B<< C<Ps = 91 / 101> >> fg/bg Bright Red 1608 B<< C<Ps = 91 / 101> >> fg/bg Bright Red
1621 B<< C<Ps = 92 / 102> >> fg/bg Bright Green 1609 B<< C<Ps = 92 / 102> >> fg/bg Bright Green
1805 1793
1806=item B<< C<Pm = 30> >> 1794=item B<< C<Pm = 30> >>
1807 1795
1808=begin table 1796=begin table
1809 1797
1810 B<< C<h> >> scrollBar visisble 1798 B<< C<h> >> scrollBar visible
1811 B<< C<l> >> scrollBar invisisble 1799 B<< C<l> >> scrollBar invisible
1812 1800
1813=end table 1801=end table
1814 1802
1815=item B<< C<Pm = 35> >> (B<rxvt>) 1803=item B<< C<Pm = 35> >> (B<rxvt>)
1816 1804
1867 1855
1868=item B<< C<Pm = 66> >> 1856=item B<< C<Pm = 66> >>
1869 1857
1870=begin table 1858=begin table
1871 1859
1872 B<< C<h> >> Application Keypad (DECPAM) == C<ESC => 1860 B<< C<h> >> Application Keypad (DECKPAM/DECPAM) == C<ESC =>
1873 B<< C<l> >> Normal Keypad (DECPNM) == C<< ESC > >> 1861 B<< C<l> >> Normal Keypad (DECKPNM/DECPNM) == C<< ESC > >>
1874 1862
1875=end table 1863=end table
1876 1864
1877=item B<< C<Pm = 67> >> 1865=item B<< C<Pm = 67> >>
1878 1866
1899 B<< C<h> >> Use Hilite Mouse Tracking. 1887 B<< C<h> >> Use Hilite Mouse Tracking.
1900 B<< C<l> >> No mouse reporting. 1888 B<< C<l> >> No mouse reporting.
1901 1889
1902=end table 1890=end table
1903 1891
1892=item B<< C<Pm = 1002> >> (X11 XTerm)
1893
1894=begin table
1895
1896 B<< C<h> >> Send Mouse X & Y on button press and release, and motion with a button pressed.
1897 B<< C<l> >> No mouse reporting.
1898
1899=end table
1900
1901=item B<< C<Pm = 1003> >> (X11 XTerm)
1902
1903=begin table
1904
1905 B<< C<h> >> Send Mouse X & Y on button press and release, and motion.
1906 B<< C<l> >> No mouse reporting.
1907
1908=end table
1909
1910=item B<< C<Pm = 1005> >> (X11 XTerm) (Compile frills)
1911
1912Try to avoid this mode, it doesn't work sensibly in non-UTF-8 locales. Use
1913mode C<1015> instead.
1914
1915Unlike XTerm, coordinates larger than 2015) will work fine.
1916
1917=begin table
1918
1919 B<< C<h> >> Enable mouse coordinates in locale-specific encoding.
1920 B<< C<l> >> Enable mouse coordinates as binary octets.
1921
1922=end table
1923
1904=item B<< C<Pm = 1010> >> (B<rxvt>) 1924=item B<< C<Pm = 1010> >> (B<rxvt>)
1905 1925
1906=begin table 1926=begin table
1907 1927
1908 B<< C<h> >> Don't scroll to bottom on TTY output 1928 B<< C<h> >> Don't scroll to bottom on TTY output
1917 B<< C<h> >> Scroll to bottom when a key is pressed 1937 B<< C<h> >> Scroll to bottom when a key is pressed
1918 B<< C<l> >> Don't scroll to bottom when a key is pressed 1938 B<< C<l> >> Don't scroll to bottom when a key is pressed
1919 1939
1920=end table 1940=end table
1921 1941
1942=item B<< C<Pm = 1015> >> (B<rxvt-unicode>) (Compile frills)
1943
1944Changes all mouse reporting codes to use decimal parameters instead of
1945octets or characters.
1946
1947This mode should be enabled I<before> actually enabling mouse reporting,
1948for semi-obvious reasons.
1949
1950The sequences received for various modes are as follows:
1951
1952 ESC [ M o o o !1005, !1015 (three octets)
1953 ESC [ M c c c 1005, !1015 (three characters)
1954 ESC [ Pm M 1015 (three or more numeric parameters)
1955
1956The first three parameters are C<code>, C<x> and C<y>. Code is the numeric
1957code as for the other modes (but encoded as a decimal number, including
1958the additional offset of 32, so you have to subtract 32 first), C<x> and
1959C<y> are the coordinates (1|1 is the upper left corner, just as with
1960cursor positioning).
1961
1962Example: Shift-Button-1 press at top row, column 80.
1963
1964 ESC [ 37 ; 80 ; 1 M
1965
1966One can use this feature by simply enabling it and then looking for
1967parameters to the C<ESC [ M> reply - if there are any, this mode is
1968active, otherwise one of the old reporting styles is used.
1969
1970Other (to be implemented) reply sequences will use a similar encoding.
1971
1972In the future, more parameters might get added (pixel coordinates for
1973example - anybody out there who needs this?).
1974
1975=begin table
1976
1977 B<< C<h> >> Enable new mouse coordinate reporting.
1978 B<< C<l> >> Use old-style C<CSI M C C C> encoding.
1979
1980=end table
1981
1922=item B<< C<Pm = 1021> >> (B<rxvt>) 1982=item B<< C<Pm = 1021> >> (B<rxvt>)
1923 1983
1924=begin table 1984=begin table
1925 1985
1926 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>) 1986 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>)
1950 2010
1951=begin table 2011=begin table
1952 2012
1953 B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it 2013 B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
1954 B<< C<l> >> Use Normal Screen Buffer 2014 B<< C<l> >> Use Normal Screen Buffer
2015
2016=end table
2017
2018=item B<< C<Pm = 2004> >>
2019
2020=begin table
2021
2022 B<< C<h> >> Enable bracketed paste mode - prepend / append to the pasted text the control sequences C<ESC [ 200 ~> / C<ESC [ 201 ~>
2023 B<< C<l> >> Disable bracketed paste mode
1955 2024
1956=end table 2025=end table
1957 2026
1958=back 2027=back
1959 2028
1976 B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >> 2045 B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >>
1977 B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >> 2046 B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >>
1978 B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >> 2047 B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >>
1979 B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it. If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property. 2048 B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it. If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property.
1980 B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an index to a colour and B<name> is the name of a colour. Each pair causes the B<number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white 2049 B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an index to a colour and B<name> is the name of a colour. Each pair causes the B<number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white
1981 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<(NB: may change in future)> 2050 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >>
1982 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> B<(NB: may change in future)> 2051 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >>
1983 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> 2052 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >>
1984 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> 2053 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >>
1985 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> 2054 B<< C<Ps = 17> >> Change background colour of highlight characters to B<< C<Pt> >>
1986 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706] 2055 B<< C<Ps = 19> >> Change foreground colour of highlight characters to B<< C<Pt> >>
1987 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707]
1988 B<< C<Ps = 20> >> Change background pixmap parameters (see section XPM) (Compile XPM). 2056 B<< C<Ps = 20> >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile afterimage or pixbuf).
1989 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. 2057 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10]
1990 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> 2058 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
1991 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. 2059 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11]
1992 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> 2060 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >>
1993 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> 2061 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> [disabled]
1994 B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills). 2062 B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills).
1995 B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>. 2063 B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>.
1996 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> 2064 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >>
1997 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). 2065 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency).
1998 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> 2066 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
1999 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >> 2067 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >>
2068 B<< C<Ps = 708> >> Change colour of the border to B<< C<Pt> >>
2000 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. 2069 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>.
2001 B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 2070 B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
2002 B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 2071 B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
2003 B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 2072 B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
2004 B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). 2073 B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
2007 2076
2008=end table 2077=end table
2009 2078
2010=back 2079=back
2011 2080
2012=head1 XPM 2081=head1 BACKGROUND IMAGE
2013 2082
2014For the XPM XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value 2083For the BACKGROUND IMAGE XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> the value
2015of B<< C<Pt> >> can be the name of the background pixmap followed by a 2084of B<< C<Pt> >> can be one of the following commands:
2016sequence of scaling/positioning commands separated by semi-colons. The
2017scaling/positioning commands are as follows:
2018 2085
2019=over 4 2086=over 4
2020 2087
2021=item query scale/position 2088=item B<< C<?> >>
2022 2089
2023B<?> 2090display scale and position in the title
2024 2091
2092=item B<< C<;WxH+X+Y> >>
2093
2025=item change scale and position 2094change scale and/or position
2026 2095
2027B<WxH+X+Y> 2096=item B<< C<FILE;WxH+X+Y> >>
2028 2097
2029B<WxH+X> (== B<WxH+X+X>) 2098change background image
2030
2031B<WxH> (same as B<WxH+50+50>)
2032
2033B<W+X+Y> (same as B<WxW+X+Y>)
2034
2035B<W+X> (same as B<WxW+X+X>)
2036
2037B<W> (same as B<WxW+50+50>)
2038
2039=item change position (absolute)
2040
2041B<=+X+Y>
2042
2043B<=+X> (same as B<=+X+Y>)
2044
2045=item change position (relative)
2046
2047B<+X+Y>
2048
2049B<+X> (same as B<+X+Y>)
2050
2051=item rescale (relative)
2052
2053B<Wx0> -> B<W *= (W/100)>
2054
2055B<0xH> -> B<H *= (H/100)>
2056 2099
2057=back 2100=back
2058 2101
2059For example:
2060
2061=over 4
2062
2063=item B<\E]20;funky\a>
2064
2065load B<funky.xpm> as a tiled image
2066
2067=item B<\E]20;mona;100\a>
2068
2069load B<mona.xpm> with a scaling of 100%
2070
2071=item B<\E]20;;200;?\a>
2072
2073rescale the current pixmap to 200% and display the image geometry in
2074the title
2075
2076=back
2077X<Mouse> 2102X<Mouse>
2078 2103
2079=head1 Mouse Reporting 2104=head1 Mouse Reporting
2080 2105
2081=over 4 2106=over 4
2106The upper bits of B<< C<< <b> >> >> indicate the modifiers when the 2131The upper bits of B<< C<< <b> >> >> indicate the modifiers when the
2107button was pressed and are added together (X11 mouse report only): 2132button was pressed and are added together (X11 mouse report only):
2108 2133
2109=over 4 2134=over 4
2110 2135
2111=item State = B<< C<< (<b> - SPACE) & 60 >> >> 2136=item State = B<< C<< (<b> - SPACE) & ~3 >> >>
2112 2137
2113=begin table 2138=begin table
2114 2139
2115 4 Shift 2140 4 Shift
2116 8 Meta 2141 8 Meta
2117 16 Control 2142 16 Control
2143 32 Motion Notify
2118 32 Double Click I<(rxvt extension)> 2144 32 Double Click I<(rxvt extension)>, disabled by default
2145 64 Button1 is actually Button4, Button2 is actually Button5 etc.
2119 2146
2120=end table 2147=end table
2121 2148
2122Col = B<< C<< <x> - SPACE >> >> 2149Col = B<< C<< <x> - SPACE >> >>
2123 2150
2124Row = B<< C<< <y> - SPACE >> >> 2151Row = B<< C<< <y> - SPACE >> >>
2125 2152
2126=back 2153=back
2154
2155=head1 Key Codes
2156
2127X<KeyCodes> 2157X<KeyCodes>
2128
2129=head1 Key Codes
2130 2158
2131Note: B<Shift> + B<F1>-B<F10> generates B<F11>-B<F20> 2159Note: B<Shift> + B<F1>-B<F10> generates B<F11>-B<F20>
2132 2160
2133For the keypad, use B<Shift> to temporarily override Application-Keypad 2161For the keypad, use B<Shift> to temporarily override Application-Keypad
2134setting use B<Num_Lock> to toggle Application-Keypad setting if 2162setting use B<Num_Lock> to toggle Application-Keypad setting if
2135B<Num_Lock> is off, toggle Application-Keypad setting. Also note that 2163B<Num_Lock> is off, toggle Application-Keypad setting. Also note that
2136values of B<Home>, B<End>, B<Delete> may have been compiled differently on 2164values of B<BackSpace>, B<Delete> may have been compiled differently on
2137your system. 2165your system.
2138 2166
2139=begin table 2167=begin table
2140 2168
2141 B<Normal> B<Shift> B<Control> B<Ctrl+Shift> 2169 B<Normal> B<Shift> B<Control> B<Ctrl+Shift>
2201 2229
2202=head1 CONFIGURE OPTIONS 2230=head1 CONFIGURE OPTIONS
2203 2231
2204General hint: if you get compile errors, then likely your configuration 2232General hint: if you get compile errors, then likely your configuration
2205hasn't been tested well. Either try with C<--enable-everything> or use 2233hasn't been tested well. Either try with C<--enable-everything> or use
2206the default configuration (i.e. C<--enable-xxx> or C<--disable-xxx>). Of 2234the default configuration (i.e. no C<--enable-xxx> or C<--disable-xxx>
2207course, you should always report when a combination doesn't work, so it 2235switches). Of course, you should always report when a combination doesn't
2208can be fixed. Marc Lehmann <rxvt@schmorp.de>. 2236work, so it can be fixed. Marc Lehmann <rxvt@schmorp.de>.
2209 2237
2210All 2238All
2211 2239
2212=over 4 2240=over 4
2213 2241
2214=item --enable-everything 2242=item --enable-everything
2215 2243
2216Add (or remove) support for all non-multichoice options listed in "./configure 2244Add (or remove) support for all non-multichoice options listed
2217--help". 2245in C<./configure --help>, except for C<--enable-assert> and
2246C<--enable-256-color>.
2218 2247
2219You can specify this and then disable options you do not like by 2248You can specify this and then disable options you do not like by
2220I<following> this with the appropriate C<--disable-...> arguments, 2249I<following> this with the appropriate C<--disable-...> arguments,
2221or you can start with a minimal configuration by specifying 2250or you can start with a minimal configuration by specifying
2222C<--disable-everything> and than adding just the C<--enable-...> arguments 2251C<--disable-everything> and than adding just the C<--enable-...> arguments
2223you want. 2252you want.
2224 2253
2225=item --enable-xft (default: enabled) 2254=item --enable-xft (default: on)
2226 2255
2227Add support for Xft (anti-aliases, among others) fonts. Xft fonts are 2256Add support for Xft (anti-aliased, among others) fonts. Xft fonts are
2228slower and require lots of memory, but as long as you don't use them, you 2257slower and require lots of memory, but as long as you don't use them, you
2229don't pay for them. 2258don't pay for them.
2230 2259
2231=item --enable-font-styles (default: on) 2260=item --enable-font-styles (default: on)
2232 2261
2233Add support for B<bold>, I<italic> and B<< I<bold italic> >> font 2262Add support for B<bold>, I<italic> and B<< I<bold italic> >> font
2234styles. The fonts can be set manually or automatically. 2263styles. The fonts can be set manually or automatically.
2235 2264
2236=item --with-codesets=NAME,... (default: all) 2265=item --with-codesets=CS,... (default: all)
2237 2266
2238Compile in support for additional codeset (encoding) groups (C<eu>, C<vn> 2267Compile in support for additional codeset (encoding) groups (C<eu>, C<vn>
2239are always compiled in, which includes most 8-bit character sets). These 2268are always compiled in, which includes most 8-bit character sets). These
2240codeset tables are used for driving X11 core fonts, they are not required 2269codeset tables are used for driving X11 core fonts, they are not required
2241for Xft fonts, although having them compiled in lets rxvt-unicode choose 2270for Xft fonts, although having them compiled in lets rxvt-unicode choose
2277 2306
2278=item --enable-combining (default: on) 2307=item --enable-combining (default: on)
2279 2308
2280Enable automatic composition of combining characters into 2309Enable automatic composition of combining characters into
2281composite characters. This is required for proper viewing of text 2310composite characters. This is required for proper viewing of text
2282where accents are encoded as seperate unicode characters. This is 2311where accents are encoded as separate unicode characters. This is
2283done by using precomposited characters when available or creating 2312done by using precomposed characters when available or creating
2284new pseudo-characters when no precomposed form exists. 2313new pseudo-characters when no precomposed form exists.
2285 2314
2286Without --enable-unicode3, the number of additional precomposed 2315Without --enable-unicode3, the number of additional precomposed
2287characters is somewhat limited (the 6400 private use characters will be 2316characters is somewhat limited (the 6400 private use characters will be
2288(ab-)used). With --enable-unicode3, no practical limit exists. 2317(ab-)used). With --enable-unicode3, no practical limit exists.
2292 2321
2293The combining table also contains entries for arabic presentation forms, 2322The combining table also contains entries for arabic presentation forms,
2294but these are not currently used. Bug me if you want these to be used (and 2323but these are not currently used. Bug me if you want these to be used (and
2295tell me how these are to be used...). 2324tell me how these are to be used...).
2296 2325
2297=item --enable-fallback(=CLASS) (default: Rxvt) 2326=item --enable-fallback[=CLASS] (default: Rxvt)
2298 2327
2299When reading resource settings, also read settings for class CLASS. To 2328When reading resource settings, also read settings for class CLASS. To
2300disable resource fallback use --disable-fallback. 2329disable resource fallback use --disable-fallback.
2301 2330
2302=item --with-res-name=NAME (default: urxvt) 2331=item --with-res-name=NAME (default: urxvt)
2303 2332
2304Use the given name as default application name when 2333Use the given name as default application name when
2305reading resources. Specify --with-res-name=rxvt to replace rxvt. 2334reading resources. Specify --with-res-name=rxvt to replace rxvt.
2306 2335
2307=item --with-res-class=CLASS /default: URxvt) 2336=item --with-res-class=CLASS (default: URxvt)
2308 2337
2309Use the given class as default application class 2338Use the given class as default application class
2310when reading resources. Specify --with-res-class=Rxvt to replace 2339when reading resources. Specify --with-res-class=Rxvt to replace
2311rxvt. 2340rxvt.
2312 2341
2325 2354
2326Write user and tty to lastlog file (used by programs like 2355Write user and tty to lastlog file (used by programs like
2327F<lastlogin>) at start of rxvt execution. This option requires 2356F<lastlogin>) at start of rxvt execution. This option requires
2328--enable-utmp to also be specified. 2357--enable-utmp to also be specified.
2329 2358
2330=item --enable-afterimage (default: on) 2359=item --enable-afterimage (default: off)
2331 2360
2332Add support for libAfterImage to be used for transparency and background 2361Add support for libAfterImage to be used for background
2333images. It adds support for many file formats including JPG, PNG, 2362images. It adds support for many file formats including JPG, PNG,
2334SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep image XML 2363SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep image XML
2335(L<http://www.afterstep.org/visualdoc.php?show=asimagexml>). 2364(L<http://www.afterstep.org/visualdoc.php?show=asimagexml>).
2336
2337This option also adds such eye candy as blending an image over the root
2338background, as well as dynamic scaling and bluring of background images.
2339 2365
2340Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might 2366Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might
2341increase by a few megabytes even if no extra features are used (mostly due 2367increase by a few megabytes even if no extra features are used (mostly due
2342to third-party libraries used by libAI). Memory footprint may somewhat be 2368to third-party libraries used by libAI). Memory footprint may somewhat be
2343lowered if libAfterImage is configured without support for SVG. 2369lowered if libAfterImage is configured without support for SVG.
2344 2370
2371=item --enable-pixbuf (default: on)
2372
2373Add support for GDK-PixBuf to be used for background images.
2374It adds support for many file formats including JPG, PNG,
2375TIFF, GIF, XPM, BMP, ICO and TGA.
2376
2377=item --enable-startup-notification (default: on)
2378
2379Add support for freedesktop startup notifications. This allows window managers
2380to display some kind of progress indicator during startup.
2381
2345=item --enable-transparency (default: on) 2382=item --enable-transparency (default: on)
2346 2383
2347Add support for inheriting parent backgrounds thus giving a fake 2384Add support for using the root pixmap as background to simulate transparency.
2348transparency to the term. 2385Note that blur and blend effects depend on libAfterImage or on
2386libXrender and on the availability of the RENDER extension in the X
2387server.
2349 2388
2350=item --enable-fading (default: on) 2389=item --enable-fading (default: on)
2351 2390
2352Add support for fading the text when focus is lost. 2391Add support for fading the text when focus is lost.
2353 2392
2354=item --enable-tinting (default: on)
2355
2356Add support for tinting of transparent backgrounds (requires C<--enable-transparency>).
2357
2358=item --enable-rxvt-scroll (default: on) 2393=item --enable-rxvt-scroll (default: on)
2359 2394
2360Add support for the original rxvt scrollbar. 2395Add support for the original rxvt scrollbar.
2361 2396
2362=item --enable-next-scroll (default: on) 2397=item --enable-next-scroll (default: on)
2364Add support for a NeXT-like scrollbar. 2399Add support for a NeXT-like scrollbar.
2365 2400
2366=item --enable-xterm-scroll (default: on) 2401=item --enable-xterm-scroll (default: on)
2367 2402
2368Add support for an Xterm-like scrollbar. 2403Add support for an Xterm-like scrollbar.
2369
2370=item --enable-plain-scroll (default: on)
2371
2372Add support for a very unobtrusive, plain-looking scrollbar that
2373is the favourite of the rxvt-unicode author, having used it for
2374many years.
2375
2376=item --enable-ttygid (default: off)
2377
2378Change tty device setting to group "tty" - only use this if
2379your system uses this type of security.
2380 2404
2381=item --disable-backspace-key 2405=item --disable-backspace-key
2382 2406
2383Removes any handling of the backspace key by us - let the X server do it. 2407Removes any handling of the backspace key by us - let the X server do it.
2384 2408
2405in combination with other switches) is: 2429in combination with other switches) is:
2406 2430
2407 MWM-hints 2431 MWM-hints
2408 EWMH-hints (pid, utf8 names) and protocols (ping) 2432 EWMH-hints (pid, utf8 names) and protocols (ping)
2409 urgency hint 2433 urgency hint
2410 seperate underline colour (-underlineColor) 2434 separate underline colour (-underlineColor)
2411 settable border widths and borderless switch (-w, -b, -bl) 2435 settable border widths and borderless switch (-w, -b, -bl)
2412 visual depth selection (-depth) 2436 visual depth selection (-depth)
2413 settable extra linespacing /-lsp) 2437 settable extra linespacing (-lsp)
2414 iso-14755 5.1 (basic) support 2438 iso-14755 5.1 (basic) support
2415 tripleclickwords (-tcw) 2439 tripleclickwords (-tcw)
2416 settable insecure mode (-insecure) 2440 settable insecure mode (-insecure)
2417 keysym remapping support 2441 keysym remapping support
2418 cursor blinking and underline cursor (-cb, -uc) 2442 cursor blinking and underline cursor (-bc, -uc)
2419 XEmbed support (-embed) 2443 XEmbed support (-embed)
2420 user-pty (-pty-fd) 2444 user-pty (-pty-fd)
2421 hold on exit (-hold) 2445 hold on exit (-hold)
2446 compile in built-in block graphics
2422 skip builtin block graphics (-sbg) 2447 skip builtin block graphics (-sbg)
2423 separate highlightcolor support (-hc) 2448 separate highlight colour (-highlightColor, -highlightTextColor)
2449 extended mouse reporting modes (1005 and 1015).
2424 2450
2425It also enables some non-essential features otherwise disabled, such as: 2451It also enables some non-essential features otherwise disabled, such as:
2426 2452
2427 some round-trip time optimisations 2453 some round-trip time optimisations
2428 nearest color allocation on pseudocolor screens 2454 nearest colour allocation on pseudocolor screens
2429 UTF8_STRING support for selection 2455 UTF8_STRING support for selection
2430 sgr modes 90..97 and 100..107 2456 sgr modes 90..97 and 100..107
2431 backindex and forwardindex escape sequences 2457 backindex and forwardindex escape sequences
2432 view change/zero scrollback escape sequences 2458 view change/zero scrollback escape sequences
2433 locale switching escape sequence 2459 locale switching escape sequence
2436 trailing space removal for selections 2462 trailing space removal for selections
2437 verbose X error handling 2463 verbose X error handling
2438 2464
2439=item --enable-iso14755 (default: on) 2465=item --enable-iso14755 (default: on)
2440 2466
2441Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2467Enable extended ISO 14755 support (see @@RXVT_NAME@@(1)).
2442F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2468Basic support (section 5.1) is enabled by C<--enable-frills>, while
2443C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with 2469support for 5.2, 5.3 and 5.4 is enabled with this switch.
2444this switch.
2445 2470
2446=item --enable-keepscrolling (default: on) 2471=item --enable-keepscrolling (default: on)
2447 2472
2448Add support for continual scrolling of the display when you hold 2473Add support for continual scrolling of the display when you hold
2449the mouse button down on a scrollbar arrow. 2474the mouse button down on a scrollbar arrow.
2467 2492
2468Add smart growth/shrink behaviour when resizing. 2493Add smart growth/shrink behaviour when resizing.
2469This should keep the window corner which is closest to a corner of 2494This should keep the window corner which is closest to a corner of
2470the screen in a fixed position. 2495the screen in a fixed position.
2471 2496
2497=item --enable-text-blink (default: on)
2498
2499Add support for blinking text.
2500
2472=item --enable-pointer-blank (default: on) 2501=item --enable-pointer-blank (default: on)
2473 2502
2474Add support to have the pointer disappear when typing or inactive. 2503Add support to have the pointer disappear when typing or inactive.
2475 2504
2476=item --enable-perl (default: on) 2505=item --enable-perl (default: on)
2477 2506
2478Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> 2507Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2479manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the 2508manpage for more info on this feature, or the files in F<src/perl/>
2480files in F<src/perl-ext/> for the extensions that are installed by 2509for the extensions that are installed by default.
2481default. The perl interpreter that is used can be specified via the 2510The perl interpreter that is used can be specified via the C<PERL>
2482C<PERL> environment variable when running configure. Even when compiled 2511environment variable when running configure. Even when compiled in,
2483in, perl will I<not> be initialised when all extensions have been disabled 2512perl will I<not> be initialised when all extensions have been disabled
2484C<-pe "" --perl-ext-common "">, so it should be safe to enable from a 2513C<-pe "" --perl-ext-common "">, so it should be safe to enable from a
2485resource standpoint. 2514resource standpoint.
2515
2516=item --enable-assert (default: off)
2517
2518Enables the assertions in the code, normally disabled. This switch is only
2519useful when developing rxvt-unicode.
2520
2521=item --enable-256-color (default: off)
2522
2523Force use of so-called 256 colour mode, to work around buggy applications
2524that do not support termcap/terminfo, or simply improve support for
2525applications hardcoding the xterm 256 colour table.
2526
2527This switch breaks termcap/terminfo compatibility to C<TERM=rxvt-unicode>,
2528and consequently sets C<TERM> to C<rxvt-unicode-256color> by default
2529(F<doc/etc/> contains termcap/terminfo definitions for both).
2530
2531It also results in higher memory usage and can slow down @@RXVT_NAME@@
2532dramatically when more than six fonts are in use by a terminal instance.
2486 2533
2487=item --with-afterimage-config=DIR 2534=item --with-afterimage-config=DIR
2488 2535
2489Look for the libAfterImage config script in DIR. 2536Look for the libAfterImage config script in DIR.
2490 2537

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines