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

Comparing rxvt-unicode/README.FAQ (file contents):
Revision 1.19 by root, Sat Dec 17 20:55:45 2005 UTC vs.
Revision 1.20 by root, Sat Dec 24 12:55:17 2005 UTC

1FREQUENTLY ASKED QUESTIONS 1FREQUENTLY ASKED QUESTIONS
2 Isn't rxvt supposed to be small? Don't all those features bloat?
3 I often get asked about this, and I think, no, they didn't cause
4 extra bloat. If you compare a minimal rxvt and a minimal urxvt, you
5 can see that the urxvt binary is larger (due to some encoding tables
6 always being compiled in), but it actually uses less memory (RSS)
7 after startup. Even with "--disable-everything", this comparison is
8 a bit unfair, as many features unique to urxvt (locale, encoding
9 conversion, iso14755 etc.) are already in use in this mode.
10
11 text data bss drs rss filename
12 98398 1664 24 15695 1824 rxvt --disable-everything
13 188985 9048 66616 18222 1788 urxvt --disable-everything
14
15 When you "--enable-everything" (which _is_ unfair, as this involves
16 xft and full locale/XIM support which are quite bloaty inside libX11
17 and my libc), the two diverge, but not unreasnobaly so.
18
19 text data bss drs rss filename
20 163431 2152 24 20123 2060 rxvt --enable-everything
21 1035683 49680 66648 29096 3680 urxvt --enable-everything
22
23 The very large size of the text section is explained by the
24 east-asian encoding tables, which, if unused, take up disk space but
25 nothing else and can be compiled out unless you rely on X11 core
26 fonts that use those encodings. The BSS size comes from the 64k
27 emergency buffer that my c++ compiler allocates (but of course
28 doesn't use unless you are out of memory). Also, using an xft font
29 instead of a core font immediately adds a few megabytes of RSS. Xft
30 indeed is responsible for a lot of RSS even when not used.
31
32 Of course, due to every character using two or four bytes instead of
33 one, a large scrollback buffer will ultimately make rxvt-unicode use
34 more memory.
35
36 Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k),
37 this still fares rather well. And compared to some monsters like
38 gnome-terminal (21152k + extra 4204k in separate processes) or
39 konsole (22200k + extra 43180k in daemons that stay around after
40 exit, plus half aminute of startup time, including the hundreds of
41 warnings it spits out), it fares extremely well *g*.
42
43 Why C++, isn't that unportable/bloated/uncool?
44 Is this a question? :) It comes up very often. The simple answer is:
45 I had to write it, and C++ allowed me to write and maintain it in a
46 fraction of the time and effort (which is a scarce resource for me).
47 Put even shorter: It simply wouldn't exist without C++.
48
49 My personal stance on this is that C++ is less portable than C, but
50 in the case of rxvt-unicode this hardly matters, as its portability
51 limits are defined by things like X11, pseudo terminals, locale
52 support and unix domain sockets, which are all less portable than
53 C++ itself.
54
55 Regarding the bloat, see the above question: It's easy to write
56 programs in C that use gobs of memory, an certainly possible to
57 write programs in C++ that don't. C++ also often comes with large
58 libraries, but this is not necessarily the case with GCC. Here is
59 what rxvt links against on my system with a minimal config:
60
61 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
62 libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000)
63 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000)
64 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
65
66 And here is rxvt-unicode:
67
68 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
69 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
70 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)
71 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)
72 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
73
74 No large bloated libraries (of course, none were linked in
75 statically), except maybe libX11 :)
76
77 Does it support tabs, can I have a tabbed rxvt-unicode?
78 rxvt-unicode does not directly support tabs. It will work fine with
79 tabbing functionality of many window managers or similar tabbing
80 programs, and its embedding-features allow it to be embedded into
81 other programs, as witnessed by doc/rxvt-tabbed or the upcoming
82 "Gtk2::URxvt" perl module, which features a tabbed urxvt (murxvt)
83 terminal as an example embedding application.
84
2 How do I know which rxvt-unicode version I'm using? 85 How do I know which rxvt-unicode version I'm using?
3 The version number is displayed with the usage (-h). Also the escape 86 The version number is displayed with the usage (-h). Also the escape
4 sequence "ESC [ 8 n" sets the window title to the version number. 87 sequence "ESC [ 8 n" sets the window title to the version number.
88 When using the urxvtc client, the version displayed is that of the
89 daemon.
5 90
6 I am using Debian GNU/Linux and have a problem... 91 I am using Debian GNU/Linux and have a problem...
7 The Debian GNU/Linux package of rxvt-unicode in sarge contains large 92 The Debian GNU/Linux package of rxvt-unicode in sarge contains large
8 patches that considerably change the behaviour of rxvt-unicode. 93 patches that considerably change the behaviour of rxvt-unicode.
9 Before reporting a bug to the original rxvt-unicode author please 94 Before reporting a bug to the original rxvt-unicode author please
49 134
50 "tic" outputs some error when compiling the terminfo entry. 135 "tic" outputs some error when compiling the terminfo entry.
51 Most likely it's the empty definition for "enacs=". Just replace it 136 Most likely it's the empty definition for "enacs=". Just replace it
52 by "enacs=\E[0@" and try again. 137 by "enacs=\E[0@" and try again.
53 138
54 "bash"'s readline does not work correctly under rxvt. 139 "bash"'s readline does not work correctly under urxvt.
55 I need a termcap file entry. 140 I need a termcap file entry.
56 One reason you might want this is that some distributions or 141 One reason you might want this is that some distributions or
57 operating systems still compile some programs using the 142 operating systems still compile some programs using the
58 long-obsoleted termcap library (Fedora Core's bash is one example) 143 long-obsoleted termcap library (Fedora Core's bash is one example)
59 and rely on a termcap entry for "rxvt-unicode". 144 and rely on a termcap entry for "rxvt-unicode".
170 indeed look correct. 255 indeed look correct.
171 256
172 In that case, select a font of your taste and add it to the font 257 In that case, select a font of your taste and add it to the font
173 list, e.g.: 258 list, e.g.:
174 259
175 rxvt -fn basefont,font2,font3... 260 urxvt -fn basefont,font2,font3...
176 261
177 When rxvt-unicode sees a character, it will first look at the base 262 When rxvt-unicode sees a character, it will first look at the base
178 font. If the base font does not contain the character, it will go to 263 font. If the base font does not contain the character, it will go to
179 the next font, and so on. Specifying your own fonts will also speed 264 the next font, and so on. Specifying your own fonts will also speed
180 up this search and use less resources within rxvt-unicode and the 265 up this search and use less resources within rxvt-unicode and the
465 Mouse cut/paste suddenly no longer works. 550 Mouse cut/paste suddenly no longer works.
466 Make sure that mouse reporting is actually turned off since killing 551 Make sure that mouse reporting is actually turned off since killing
467 some editors prematurely may leave the mouse in mouse report mode. 552 some editors prematurely may leave the mouse in mouse report mode.
468 I've heard that tcsh may use mouse reporting unless it otherwise 553 I've heard that tcsh may use mouse reporting unless it otherwise
469 specified. A quick check is to see if cut/paste works when the Alt 554 specified. A quick check is to see if cut/paste works when the Alt
470 or Shift keys are depressed. See rxvt(7) 555 or Shift keys are depressed. See urxvt(7)
471 556
472 What's with this bold/blink stuff? 557 What's with this bold/blink stuff?
473 If no bold colour is set via "colorBD:", bold will invert text using 558 If no bold colour is set via "colorBD:", bold will invert text using
474 the standard foreground colour. 559 the standard foreground colour.
475 560
530 URxvt.color6: #73f7ff 615 URxvt.color6: #73f7ff
531 URxvt.color14: #73f7ff 616 URxvt.color14: #73f7ff
532 URxvt.color7: #e1dddd 617 URxvt.color7: #e1dddd
533 URxvt.color15: #e1dddd 618 URxvt.color15: #e1dddd
534 619
535 How can I start rxvtd in a race-free way? 620 How can I start urxvtd in a race-free way?
536 Try "rxvtd -f -o", which tells rxvtd to open the display, create the 621 Try "urxvtd -f -o", which tells urxvtd to open the display, create
537 listening socket and then fork. 622 the listening socket and then fork.
538 623
539 What's with the strange Backspace/Delete key behaviour? 624 What's with the strange Backspace/Delete key behaviour?
540 Assuming that the physical Backspace key corresponds to the 625 Assuming that the physical Backspace key corresponds to the
541 BackSpace keysym (not likely for Linux ... see the following 626 BackSpace keysym (not likely for Linux ... see the following
542 question) there are two standard values that can be used for 627 question) there are two standard values that can be used for
555 640
556 For starting a new rxvt-unicode: 641 For starting a new rxvt-unicode:
557 642
558 # use Backspace = ^H 643 # use Backspace = ^H
559 $ stty erase ^H 644 $ stty erase ^H
560 $ rxvt 645 $ urxvt
561 646
562 # use Backspace = ^? 647 # use Backspace = ^?
563 $ stty erase ^? 648 $ stty erase ^?
564 $ rxvt 649 $ urxvt
565 650
566 Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in rxvt(7). 651 Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in urxvt(7).
567 652
568 For an existing rxvt-unicode: 653 For an existing rxvt-unicode:
569 654
570 # use Backspace = ^H 655 # use Backspace = ^H
571 $ stty erase ^H 656 $ stty erase ^H
597 There are some compile-time selections available via configure. 682 There are some compile-time selections available via configure.
598 Unless you have run "configure" with the "--disable-resources" 683 Unless you have run "configure" with the "--disable-resources"
599 option you can use the `keysym' resource to alter the keystrings 684 option you can use the `keysym' resource to alter the keystrings
600 associated with keysyms. 685 associated with keysyms.
601 686
602 Here's an example for a URxvt session started using "rxvt -name 687 Here's an example for a URxvt session started using "urxvt -name
603 URxvt" 688 URxvt"
604 689
605 URxvt.keysym.Home: \033[1~ 690 URxvt.keysym.Home: \033[1~
606 URxvt.keysym.End: \033[4~ 691 URxvt.keysym.End: \033[4~
607 URxvt.keysym.C-apostrophe: \033<C-'> 692 URxvt.keysym.C-apostrophe: \033<C-'>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines