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.15 by root, Wed Jul 13 02:53:54 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
448 it gets worse, as rxvt-unicode then uses 8 bytes per screen cell. 533 it gets worse, as rxvt-unicode then uses 8 bytes per screen cell.
449 534
450 Can I speed up Xft rendering somehow? 535 Can I speed up Xft rendering somehow?
451 Yes, the most obvious way to speed it up is to avoid Xft entirely, 536 Yes, the most obvious way to speed it up is to avoid Xft entirely,
452 as it is simply slow. If you still want Xft fonts you might try to 537 as it is simply slow. If you still want Xft fonts you might try to
453 disable antialiasing (by appending ":antialiasing=false"), which 538 disable antialiasing (by appending ":antialias=false"), which saves
454 saves lots of memory and also speeds up rendering considerably. 539 lots of memory and also speeds up rendering considerably.
455 540
456 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? 541 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
457 Rxvt-unicode will use whatever you specify as a font. If it needs to 542 Rxvt-unicode will use whatever you specify as a font. If it needs to
458 fall back to it's default font search list it will prefer X11 core 543 fall back to it's default font search list it will prefer X11 core
459 fonts, because they are small and fast, and then use Xft fonts. It 544 fonts, because they are small and fast, and then use Xft fonts. It
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 Despite it's name, rxvtd is not a real daemon, but more like a 621 Try "urxvtd -f -o", which tells urxvtd to open the display, create
537 server that answers rxvtc's requests, so it doesn't background 622 the listening socket and then fork.
538 itself.
539
540 To ensure rxvtd is listening on it's socket, you can use the
541 following method to wait for the startup message before continuing:
542
543 { rxvtd & } | read
544 623
545 What's with the strange Backspace/Delete key behaviour? 624 What's with the strange Backspace/Delete key behaviour?
546 Assuming that the physical Backspace key corresponds to the 625 Assuming that the physical Backspace key corresponds to the
547 BackSpace keysym (not likely for Linux ... see the following 626 BackSpace keysym (not likely for Linux ... see the following
548 question) there are two standard values that can be used for 627 question) there are two standard values that can be used for
561 640
562 For starting a new rxvt-unicode: 641 For starting a new rxvt-unicode:
563 642
564 # use Backspace = ^H 643 # use Backspace = ^H
565 $ stty erase ^H 644 $ stty erase ^H
566 $ rxvt 645 $ urxvt
567 646
568 # use Backspace = ^? 647 # use Backspace = ^?
569 $ stty erase ^? 648 $ stty erase ^?
570 $ rxvt 649 $ urxvt
571 650
572 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).
573 652
574 For an existing rxvt-unicode: 653 For an existing rxvt-unicode:
575 654
576 # use Backspace = ^H 655 # use Backspace = ^H
577 $ stty erase ^H 656 $ stty erase ^H
603 There are some compile-time selections available via configure. 682 There are some compile-time selections available via configure.
604 Unless you have run "configure" with the "--disable-resources" 683 Unless you have run "configure" with the "--disable-resources"
605 option you can use the `keysym' resource to alter the keystrings 684 option you can use the `keysym' resource to alter the keystrings
606 associated with keysyms. 685 associated with keysyms.
607 686
608 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
609 URxvt" 688 URxvt"
610 689
611 URxvt.keysym.Home: \033[1~ 690 URxvt.keysym.Home: \033[1~
612 URxvt.keysym.End: \033[4~ 691 URxvt.keysym.End: \033[4~
613 URxvt.keysym.C-apostrophe: \033<C-'> 692 URxvt.keysym.C-apostrophe: \033<C-'>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines