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.23 by root, Tue Jan 10 04:26:54 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 + ... + rxvt-unicode itself to
133 all be secure. Also, rxvt-unicode disables some options when it
134 detects that it runs setuid or setgid, which is not nice.
135
136 Elevated privileges are only required for utmp and pty operations on
137 some systems (for example, GNU/Linux doesn't need any extra
138 privileges for ptys, but some need it for utmp support). If
139 rxvt-unicode doesn't support the library/setuid helper that your OS
140 needs I'll be happy to assist you in implementing support for it.
141
142 So, while setuid/setgid operation is supported and not a problem on
143 your typical single-user-no-other-logins unix desktop, always
144 remember that its an awful lot of code, most of which isn't checked
145 for security issues regularly.
146
106 When I log-in to another system it tells me about missing terminfo data? 147 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 148 The terminal description used by rxvt-unicode is not as widely
108 available as that for xterm, or even rxvt (for which the same 149 available as that for xterm, or even rxvt (for which the same
109 problem often arises). 150 problem often arises).
110 151
134 175
135 "tic" outputs some error when compiling the terminfo entry. 176 "tic" outputs some error when compiling the terminfo entry.
136 Most likely it's the empty definition for "enacs=". Just replace it 177 Most likely it's the empty definition for "enacs=". Just replace it
137 by "enacs=\E[0@" and try again. 178 by "enacs=\E[0@" and try again.
138 179
139 "bash"'s readline does not work correctly under urxvt. 180 "bash"'s readline does not work correctly under rxvt.
140 I need a termcap file entry. 181 I need a termcap file entry.
141 One reason you might want this is that some distributions or 182 One reason you might want this is that some distributions or
142 operating systems still compile some programs using the 183 operating systems still compile some programs using the
143 long-obsoleted termcap library (Fedora Core's bash is one example) 184 long-obsoleted termcap library (Fedora Core's bash is one example)
144 and rely on a termcap entry for "rxvt-unicode". 185 and rely on a termcap entry for "rxvt-unicode".
255 indeed look correct. 296 indeed look correct.
256 297
257 In that case, select a font of your taste and add it to the font 298 In that case, select a font of your taste and add it to the font
258 list, e.g.: 299 list, e.g.:
259 300
260 urxvt -fn basefont,font2,font3... 301 rxvt -fn basefont,font2,font3...
261 302
262 When rxvt-unicode sees a character, it will first look at the base 303 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 304 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 305 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 306 up this search and use less resources within rxvt-unicode and the
550 Mouse cut/paste suddenly no longer works. 591 Mouse cut/paste suddenly no longer works.
551 Make sure that mouse reporting is actually turned off since killing 592 Make sure that mouse reporting is actually turned off since killing
552 some editors prematurely may leave the mouse in mouse report mode. 593 some editors prematurely may leave the mouse in mouse report mode.
553 I've heard that tcsh may use mouse reporting unless it otherwise 594 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 595 specified. A quick check is to see if cut/paste works when the Alt
555 or Shift keys are depressed. See urxvt(7) 596 or Shift keys are depressed. See rxvt(7)
556 597
557 What's with this bold/blink stuff? 598 What's with this bold/blink stuff?
558 If no bold colour is set via "colorBD:", bold will invert text using 599 If no bold colour is set via "colorBD:", bold will invert text using
559 the standard foreground colour. 600 the standard foreground colour.
560 601
615 URxvt.color6: #73f7ff 656 URxvt.color6: #73f7ff
616 URxvt.color14: #73f7ff 657 URxvt.color14: #73f7ff
617 URxvt.color7: #e1dddd 658 URxvt.color7: #e1dddd
618 URxvt.color15: #e1dddd 659 URxvt.color15: #e1dddd
619 660
620 How can I start urxvtd in a race-free way? 661 How can I start rxvtd in a race-free way?
621 Try "urxvtd -f -o", which tells urxvtd to open the display, create 662 Try "rxvtd -f -o", which tells rxvtd to open the display, create the
622 the listening socket and then fork. 663 listening socket and then fork.
623 664
624 What's with the strange Backspace/Delete key behaviour? 665 What's with the strange Backspace/Delete key behaviour?
625 Assuming that the physical Backspace key corresponds to the 666 Assuming that the physical Backspace key corresponds to the
626 BackSpace keysym (not likely for Linux ... see the following 667 BackSpace keysym (not likely for Linux ... see the following
627 question) there are two standard values that can be used for 668 question) there are two standard values that can be used for
640 681
641 For starting a new rxvt-unicode: 682 For starting a new rxvt-unicode:
642 683
643 # use Backspace = ^H 684 # use Backspace = ^H
644 $ stty erase ^H 685 $ stty erase ^H
645 $ urxvt 686 $ rxvt
646 687
647 # use Backspace = ^? 688 # use Backspace = ^?
648 $ stty erase ^? 689 $ stty erase ^?
649 $ urxvt 690 $ rxvt
650 691
651 Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in urxvt(7). 692 Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in rxvt(7).
652 693
653 For an existing rxvt-unicode: 694 For an existing rxvt-unicode:
654 695
655 # use Backspace = ^H 696 # use Backspace = ^H
656 $ stty erase ^H 697 $ stty erase ^H
682 There are some compile-time selections available via configure. 723 There are some compile-time selections available via configure.
683 Unless you have run "configure" with the "--disable-resources" 724 Unless you have run "configure" with the "--disable-resources"
684 option you can use the `keysym' resource to alter the keystrings 725 option you can use the `keysym' resource to alter the keystrings
685 associated with keysyms. 726 associated with keysyms.
686 727
687 Here's an example for a URxvt session started using "urxvt -name 728 Here's an example for a URxvt session started using "rxvt -name
688 URxvt" 729 URxvt"
689 730
690 URxvt.keysym.Home: \033[1~ 731 URxvt.keysym.Home: \033[1~
691 URxvt.keysym.End: \033[4~ 732 URxvt.keysym.End: \033[4~
692 URxvt.keysym.C-apostrophe: \033<C-'> 733 URxvt.keysym.C-apostrophe: \033<C-'>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines