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.21 by root, Mon Jan 2 15:11:05 2006 UTC vs.
Revision 1.31 by root, Tue Jan 17 16:22:41 2006 UTC

1FREQUENTLY ASKED QUESTIONS 1FREQUENTLY ASKED QUESTIONS
2 The new selection selects pieces that are too big, how can I select
3 single words?
4 Yes. For example, if you want to select alphanumeric words, you can
5 use the following resource:
6
7 URxvt.selection.pattern-0: ([[:word:]]+)
8
9 If you click more than twice, the selection will be extended more
10 and more.
11
12 To get a selection that is very similar to the old code, try this
13 pattern:
14
15 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+)
16
17 Please also note that the *LeftClick Shift-LeftClik* combination
18 also selects words like the old code.
19
20 I don't like the new selection/popups/hotkeys/perl, how do I
21 change/disable it?
22 You can disable the perl extension completely by setting the
23 perl-ext-common resource to the empty string, which also keeps
24 rxvt-unicode from initialising perl, saving memory.
25
26 If you only want to disable specific features, you first have to
27 identify which perl extension is responsible. For this, read the
28 section PREPACKAGED EXTENSIONS in the rxvtperl(3) manpage. For
29 example, to disable the selection-popup and option-popup, specify
30 this perl-ext-common resource:
31
32 URxvt.perl-ext-common: default,-selection-popup,-option-popup
33
34 This will keep the default extensions, but disable the two popup
35 extensions. Some extensions can also be configured, for example,
36 scrollback search mode is triggered by M-s. You can move it to any
37 other combination either by setting the searchable-scrollback
38 resource:
39
40 URxvt.searchable-scrollback: CM-s
41
2 Isn't rxvt supposed to be small? Don't all those features bloat? 42 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 43 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 44 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 45 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) 46 always being compiled in), but it actually uses less memory (RSS)
… …
35 75
36 Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), 76 Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k),
37 this still fares rather well. And compared to some monsters like 77 this still fares rather well. And compared to some monsters like
38 gnome-terminal (21152k + extra 4204k in separate processes) or 78 gnome-terminal (21152k + extra 4204k in separate processes) or
39 konsole (22200k + extra 43180k in daemons that stay around after 79 konsole (22200k + extra 43180k in daemons that stay around after
40 exit, plus half aminute of startup time, including the hundreds of 80 exit, plus half a minute of startup time, including the hundreds of
41 warnings it spits out), it fares extremely well *g*. 81 warnings it spits out), it fares extremely well *g*.
42 82
43 Why C++, isn't that unportable/bloated/uncool? 83 Why C++, isn't that unportable/bloated/uncool?
44 Is this a question? :) It comes up very often. The simple answer is: 84 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 85 I had to write it, and C++ allowed me to write and maintain it in a
… …
100 140
101 For other problems that also affect the Debian package, you can and 141 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 142 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 143 also a bug in the Debian version and it serves as a reminder for
104 other users that might encounter the same issue. 144 other users that might encounter the same issue.
145
146 I am maintaining rxvt-unicode for distribution/OS XXX, any
147 recommendation?
148 You should build one binary with the default options. configure now
149 enables most useful options, and the trend goes to making them
150 runtime-switchable, too, so there is usually no drawback to enbaling
151 them, except higher disk and possibly memory usage. The perl
152 interpreter should be enabled, as important functionality (menus,
153 selection, likely more in the future) depends on it.
154
155 You should not overwrite the "perl-ext-common" snd "perl-ext"
156 resources system-wide (except maybe with "defaults"). This will
157 result in useful behaviour. If your distribution aims at low memory,
158 add an empty "perl-ext-common" resource to the app-defaults file.
159 This will keep the perl interpreter disabled until the user enables
160 it.
161
162 If you can/want build more binaries, I recommend building a minimal
163 one with "--disable-everything" (very useful) and a maximal one with
164 "--enable-everything" (less useful, it will be very big due to a lot
165 of encodings built-in that increase download times and are rarely
166 used).
167
168 I need to make it setuid/setgid to support utmp/ptys on my OS, is this
169 safe?
170 It should be, starting with release 7.1. You are encouraged to
171 properly install urxvt with privileges necessary for your OS now.
172
173 When rxvt-unicode detects that it runs setuid or setgid, it will
174 fork into a helper process for privileged operations (pty handling
175 on some systems, utmp/wtmp/lastlog handling on others) and drop
176 privileges immediately. This is much safer than most other terminals
177 that keep privileges while running (but is more relevant to urxvt,
178 as it contains things as perl interpreters, which might be "helpful"
179 to attackers).
180
181 This forking is done as the very first within main(), which is very
182 early and reduces possible bugs to initialisation code run before
183 main(), or things like the dynamic loader of your system, which
184 should result in very little risk.
105 185
106 When I log-in to another system it tells me about missing terminfo data? 186 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 187 The terminal description used by rxvt-unicode is not as widely
108 available as that for xterm, or even rxvt (for which the same 188 available as that for xterm, or even rxvt (for which the same
109 problem often arises). 189 problem often arises).
… …
497 577
498 My input method wants <some encoding> but I want UTF-8, what can I do? 578 My input method wants <some encoding> but I want UTF-8, what can I do?
499 You can specify separate locales for the input method and the rest 579 You can specify separate locales for the input method and the rest
500 of the terminal, using the resource "imlocale": 580 of the terminal, using the resource "imlocale":
501 581
502 URxvt*imlocale: ja_JP.EUC-JP 582 URxvt.imlocale: ja_JP.EUC-JP
503 583
504 Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and 584 Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and
505 still use your input method. Please note, however, that you will not 585 still use your input method. Please note, however, that you will not
506 be able to input characters outside "EUC-JP" in a normal way then, 586 be able to input characters outside "EUC-JP" in a normal way then,
507 as your input method limits you. 587 as your input method limits you.
… …
550 Mouse cut/paste suddenly no longer works. 630 Mouse cut/paste suddenly no longer works.
551 Make sure that mouse reporting is actually turned off since killing 631 Make sure that mouse reporting is actually turned off since killing
552 some editors prematurely may leave the mouse in mouse report mode. 632 some editors prematurely may leave the mouse in mouse report mode.
553 I've heard that tcsh may use mouse reporting unless it otherwise 633 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 634 specified. A quick check is to see if cut/paste works when the Alt
555 or Shift keys are depressed. See rxvt(7) 635 or Shift keys are depressed.
556 636
557 What's with this bold/blink stuff? 637 What's with this bold/blink stuff?
558 If no bold colour is set via "colorBD:", bold will invert text using 638 If no bold colour is set via "colorBD:", bold will invert text using
559 the standard foreground colour. 639 the standard foreground colour.
560 640
… …
646 726
647 # use Backspace = ^? 727 # use Backspace = ^?
648 $ stty erase ^? 728 $ stty erase ^?
649 $ rxvt 729 $ rxvt
650 730
651 Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in rxvt(7). 731 Toggle with "ESC [ 36 h" / "ESC [ 36 l".
652 732
653 For an existing rxvt-unicode: 733 For an existing rxvt-unicode:
654 734
655 # use Backspace = ^H 735 # use Backspace = ^H
656 $ stty erase ^H 736 $ stty erase ^H

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines