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.20 by root, Sat Dec 24 12:55:17 2005 UTC vs.
Revision 1.24 by root, Wed Jan 11 19:55:33 2006 UTC

35 35
36 Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), 36 Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k),
37 this still fares rather well. And compared to some monsters like 37 this still fares rather well. And compared to some monsters like
38 gnome-terminal (21152k + extra 4204k in separate processes) or 38 gnome-terminal (21152k + extra 4204k in separate processes) or
39 konsole (22200k + extra 43180k in daemons that stay around after 39 konsole (22200k + extra 43180k in daemons that stay around after
40 exit, plus half aminute of startup time, including the hundreds of 40 exit, plus half a minute of startup time, including the hundreds of
41 warnings it spits out), it fares extremely well *g*. 41 warnings it spits out), it fares extremely well *g*.
42 42
43 Why C++, isn't that unportable/bloated/uncool? 43 Why C++, isn't that unportable/bloated/uncool?
44 Is this a question? :) It comes up very often. The simple answer is: 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 45 I had to write it, and C++ allowed me to write and maintain it in a
83 terminal as an example embedding application. 83 terminal as an example embedding application.
84 84
85 How do I know which rxvt-unicode version I'm using? 85 How do I know which rxvt-unicode version I'm using?
86 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
87 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 88 When using the rxvtc client, the version displayed is that of the
89 daemon. 89 daemon.
90 90
91 I am using Debian GNU/Linux and have a problem... 91 I am using Debian GNU/Linux and have a problem...
92 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
93 patches that considerably change the behaviour of rxvt-unicode. 93 patches that considerably change the behaviour of rxvt-unicode.
101 For other problems that also affect the Debian package, you can and 101 For other problems that also affect the Debian package, you can and
102 probably should use the Debian BTS, too, because, after all, it's 102 probably should use the Debian BTS, too, because, after all, it's
103 also a bug in the Debian version and it serves as a reminder for 103 also a bug in the Debian version and it serves as a reminder for
104 other users that might encounter the same issue. 104 other users that might encounter the same issue.
105 105
106 I am maintaining rxvt-unicode for distribution/OS XXX, any
107 recommendation?
108 You should build one binary with the default options. configure now
109 enables most useful options, and the trend goes to making them
110 runtime-switchable, too, so there is usually no drawback to enbaling
111 them, except higher disk and possibly memory usage. The perl
112 interpreter should be enabled, as important functionality (menus,
113 selection, likely more in the future) depends on it.
114
115 You should not overwrite the "perl-ext-common" snd "perl-ext"
116 resources system-wide (except maybe with "defaults"). This will
117 result in useful behaviour. If your distribution aims at low memory,
118 add an empty "perl-ext-common" resource to the app-defaults file.
119 This will keep the perl interpreter disabled until the user enables
120 it.
121
122 If you can/want build more binaries, I recommend building a minimal
123 one with "--disable-everything" (very useful) and a maximal one with
124 "--enable-everything" (less useful, it will be very big due to a lot
125 of encodings built-in that increase download times and are rarely
126 used).
127
128 I need to make it setuid/setgid to support utmp/ptys on my OS, is this
129 safe?
130 Likely not. While I honestly try to make it secure, and am probably
131 not bad at it, I think it is simply unreasonable to expect all of
132 freetype + fontconfig + xft + xlib + perl + ... + rxvt-unicode
133 itself to all be secure. Also, rxvt-unicode disables some options
134 when it detects that it runs setuid or setgid, which is not nice.
135 Besides, with the embedded perl interpreter the possibility for
136 security problems easily multiplies.
137
138 Elevated privileges are only required for utmp and pty operations on
139 some systems (for example, GNU/Linux doesn't need any extra
140 privileges for ptys, but some need it for utmp support). It is
141 planned to mvoe this into a forked handler process, but this is not
142 yet done.
143
144 So, while setuid/setgid operation is supported and not a problem on
145 your typical single-user-no-other-logins unix desktop, always
146 remember that its an awful lot of code, most of which isn't checked
147 for security issues regularly.
148
106 When I log-in to another system it tells me about missing terminfo data? 149 When I log-in to another system it tells me about missing terminfo data?
107 The terminal description used by rxvt-unicode is not as widely 150 The terminal description used by rxvt-unicode is not as widely
108 available as that for xterm, or even rxvt (for which the same 151 available as that for xterm, or even rxvt (for which the same
109 problem often arises). 152 problem often arises).
110 153
134 177
135 "tic" outputs some error when compiling the terminfo entry. 178 "tic" outputs some error when compiling the terminfo entry.
136 Most likely it's the empty definition for "enacs=". Just replace it 179 Most likely it's the empty definition for "enacs=". Just replace it
137 by "enacs=\E[0@" and try again. 180 by "enacs=\E[0@" and try again.
138 181
139 "bash"'s readline does not work correctly under urxvt. 182 "bash"'s readline does not work correctly under rxvt.
140 I need a termcap file entry. 183 I need a termcap file entry.
141 One reason you might want this is that some distributions or 184 One reason you might want this is that some distributions or
142 operating systems still compile some programs using the 185 operating systems still compile some programs using the
143 long-obsoleted termcap library (Fedora Core's bash is one example) 186 long-obsoleted termcap library (Fedora Core's bash is one example)
144 and rely on a termcap entry for "rxvt-unicode". 187 and rely on a termcap entry for "rxvt-unicode".
255 indeed look correct. 298 indeed look correct.
256 299
257 In that case, select a font of your taste and add it to the font 300 In that case, select a font of your taste and add it to the font
258 list, e.g.: 301 list, e.g.:
259 302
260 urxvt -fn basefont,font2,font3... 303 rxvt -fn basefont,font2,font3...
261 304
262 When rxvt-unicode sees a character, it will first look at the base 305 When rxvt-unicode sees a character, it will first look at the base
263 font. If the base font does not contain the character, it will go to 306 font. If the base font does not contain the character, it will go to
264 the next font, and so on. Specifying your own fonts will also speed 307 the next font, and so on. Specifying your own fonts will also speed
265 up this search and use less resources within rxvt-unicode and the 308 up this search and use less resources within rxvt-unicode and the
550 Mouse cut/paste suddenly no longer works. 593 Mouse cut/paste suddenly no longer works.
551 Make sure that mouse reporting is actually turned off since killing 594 Make sure that mouse reporting is actually turned off since killing
552 some editors prematurely may leave the mouse in mouse report mode. 595 some editors prematurely may leave the mouse in mouse report mode.
553 I've heard that tcsh may use mouse reporting unless it otherwise 596 I've heard that tcsh may use mouse reporting unless it otherwise
554 specified. A quick check is to see if cut/paste works when the Alt 597 specified. A quick check is to see if cut/paste works when the Alt
555 or Shift keys are depressed. See urxvt(7) 598 or Shift keys are depressed. See rxvt(7)
556 599
557 What's with this bold/blink stuff? 600 What's with this bold/blink stuff?
558 If no bold colour is set via "colorBD:", bold will invert text using 601 If no bold colour is set via "colorBD:", bold will invert text using
559 the standard foreground colour. 602 the standard foreground colour.
560 603
615 URxvt.color6: #73f7ff 658 URxvt.color6: #73f7ff
616 URxvt.color14: #73f7ff 659 URxvt.color14: #73f7ff
617 URxvt.color7: #e1dddd 660 URxvt.color7: #e1dddd
618 URxvt.color15: #e1dddd 661 URxvt.color15: #e1dddd
619 662
620 How can I start urxvtd in a race-free way? 663 How can I start rxvtd in a race-free way?
621 Try "urxvtd -f -o", which tells urxvtd to open the display, create 664 Try "rxvtd -f -o", which tells rxvtd to open the display, create the
622 the listening socket and then fork. 665 listening socket and then fork.
623 666
624 What's with the strange Backspace/Delete key behaviour? 667 What's with the strange Backspace/Delete key behaviour?
625 Assuming that the physical Backspace key corresponds to the 668 Assuming that the physical Backspace key corresponds to the
626 BackSpace keysym (not likely for Linux ... see the following 669 BackSpace keysym (not likely for Linux ... see the following
627 question) there are two standard values that can be used for 670 question) there are two standard values that can be used for
640 683
641 For starting a new rxvt-unicode: 684 For starting a new rxvt-unicode:
642 685
643 # use Backspace = ^H 686 # use Backspace = ^H
644 $ stty erase ^H 687 $ stty erase ^H
645 $ urxvt 688 $ rxvt
646 689
647 # use Backspace = ^? 690 # use Backspace = ^?
648 $ stty erase ^? 691 $ stty erase ^?
649 $ urxvt 692 $ rxvt
650 693
651 Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in urxvt(7). 694 Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in rxvt(7).
652 695
653 For an existing rxvt-unicode: 696 For an existing rxvt-unicode:
654 697
655 # use Backspace = ^H 698 # use Backspace = ^H
656 $ stty erase ^H 699 $ stty erase ^H
682 There are some compile-time selections available via configure. 725 There are some compile-time selections available via configure.
683 Unless you have run "configure" with the "--disable-resources" 726 Unless you have run "configure" with the "--disable-resources"
684 option you can use the `keysym' resource to alter the keystrings 727 option you can use the `keysym' resource to alter the keystrings
685 associated with keysyms. 728 associated with keysyms.
686 729
687 Here's an example for a URxvt session started using "urxvt -name 730 Here's an example for a URxvt session started using "rxvt -name
688 URxvt" 731 URxvt"
689 732
690 URxvt.keysym.Home: \033[1~ 733 URxvt.keysym.Home: \033[1~
691 URxvt.keysym.End: \033[4~ 734 URxvt.keysym.End: \033[4~
692 URxvt.keysym.C-apostrophe: \033<C-'> 735 URxvt.keysym.C-apostrophe: \033<C-'>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines