--- rxvt-unicode/doc/rxvt.7.txt 2006/01/04 21:50:12 1.33 +++ rxvt-unicode/doc/rxvt.7.txt 2006/01/12 23:11:23 1.41 @@ -20,6 +20,43 @@ . FREQUENTLY ASKED QUESTIONS + The new selection selects pieces that are too big/too small, can I + change this? + Yes. For example, if you want to select smaller pieces ("words") you + can use the following resource: + + URxvt.selection.pattern-0: ([[:word:]]+) + + If you click more than twice, the selection will be extended more + and more. + + To get a selection that is very similar to the old code, try this + pattern: + + URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) + + I don't like the new selection/popups/hotkeys/perl, how do I + change/disable it? + You can disable the perl extension completely by setting the + perl-ext-common resource to the empty string, which also keeps + rxvt-unicode from initialising perl, saving memory. + + If you only want to disable specific features, you first have to + identify which perl extension is responsible. For this, read the + section PREPACKAGED EXTENSIONS in the rxvtperl(3) manpage. For + example, to disable the selection-popup and option-popup, specify + this perl-ext-common resource: + + URxvt.perl-ext-common: default,-selection-popup,-option-popup + + This will keep the default extensions, but disable the two popup + extensions. Some extensions can also be configured, for example, + scrollback search mode is triggered by M-s. You can move it to any + other combination either by setting the searchable-scrollback + resource: + + URxvt.searchable-scrollback: CM-s + Isn't rxvt supposed to be small? Don't all those features bloat? I often get asked about this, and I think, no, they didn't cause extra bloat. If you compare a minimal rxvt and a minimal urxvt, you @@ -58,7 +95,7 @@ this still fares rather well. And compared to some monsters like gnome-terminal (21152k + extra 4204k in separate processes) or konsole (22200k + extra 43180k in daemons that stay around after - exit, plus half aminute of startup time, including the hundreds of + exit, plus half a minute of startup time, including the hundreds of warnings it spits out), it fares extremely well *g*. Why C++, isn't that unportable/bloated/uncool? @@ -124,6 +161,49 @@ also a bug in the Debian version and it serves as a reminder for other users that might encounter the same issue. + I am maintaining rxvt-unicode for distribution/OS XXX, any + recommendation? + You should build one binary with the default options. configure now + enables most useful options, and the trend goes to making them + runtime-switchable, too, so there is usually no drawback to enbaling + them, except higher disk and possibly memory usage. The perl + interpreter should be enabled, as important functionality (menus, + selection, likely more in the future) depends on it. + + You should not overwrite the "perl-ext-common" snd "perl-ext" + resources system-wide (except maybe with "defaults"). This will + result in useful behaviour. If your distribution aims at low memory, + add an empty "perl-ext-common" resource to the app-defaults file. + This will keep the perl interpreter disabled until the user enables + it. + + If you can/want build more binaries, I recommend building a minimal + one with "--disable-everything" (very useful) and a maximal one with + "--enable-everything" (less useful, it will be very big due to a lot + of encodings built-in that increase download times and are rarely + used). + + I need to make it setuid/setgid to support utmp/ptys on my OS, is this + safe? + Likely not. While I honestly try to make it secure, and am probably + not bad at it, I think it is simply unreasonable to expect all of + freetype + fontconfig + xft + xlib + perl + ... + rxvt-unicode + itself to all be secure. Also, rxvt-unicode disables some options + when it detects that it runs setuid or setgid, which is not nice. + Besides, with the embedded perl interpreter the possibility for + security problems easily multiplies. + + Elevated privileges are only required for utmp and pty operations on + some systems (for example, GNU/Linux doesn't need any extra + privileges for ptys, but some need it for utmp support). It is + planned to mvoe this into a forked handler process, but this is not + yet done. + + So, while setuid/setgid operation is supported and not a problem on + your typical single-user-no-other-logins unix desktop, always + remember that its an awful lot of code, most of which isn't checked + for security issues regularly. + When I log-in to another system it tells me about missing terminfo data? The terminal description used by rxvt-unicode is not as widely available as that for xterm, or even rxvt (for which the same @@ -1268,8 +1348,8 @@ Ps = 12 Change colour of text cursor foreground to Pt Ps = 13 Change colour of mouse foreground to Pt Ps = 17 Change colour of highlight characters to Pt - Ps = 18 Change colour of bold characters to Pt - Ps = 19 Change colour of underlined characters to Pt + Ps = 18 Change colour of bold characters to Pt [deprecated, see 706] + Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707] Ps = 20 Change default background to Pt Ps = 39 Change default foreground colour to Pt. Ps = 46 Change Log File to Pt unimplemented @@ -1280,6 +1360,8 @@ Ps = 703 Menubar command Pt (Compile menubar). Ps = 704 Change colour of italic characters to Pt Ps = 705 Change background pixmap tint colour to Pt (Compile transparency). + Ps = 706 Change colour of bold characters to Pt + Ps = 707 Change colour of underlined characters to Pt Ps = 710 Set normal fontset to Pt. Same as Ps = 50. Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles). Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles). @@ -1867,10 +1949,10 @@ at start of rxvt execution. This option requires --enable-utmp to also be specified. - --enable-xpm-background (default: off) + --enable-xpm-background (default: on) Add support for XPM background pixmaps. - --enable-transparency (default: off) + --enable-transparency (default: on) Add support for inheriting parent backgrounds thus giving a fake transparency to the term. @@ -1882,9 +1964,10 @@ Add support for tinting of transparent backgrounds (requires "--enable-transparency"). - --enable-menubar (default: off) + --enable-menubar (default: off) [DEPRECATED] Add support for our menu bar system (this interacts badly with - dynamic locale switching currently). + dynamic locale switching currently). This option is DEPRECATED and + will be removed in the future. --enable-rxvt-scroll (default: on) Add support for the original rxvt scrollbar. @@ -1919,15 +2002,6 @@ --disable-resources Removes any support for resource checking. - --enable-xgetdefault - Make resources checking via XGetDefault() instead of our small - version which only checks ~/.Xdefaults, or if that doesn't exist - then ~/.Xresources. - - Please note that nowadays, things like XIM will automatically pull - in and use the full X resource manager, so the overhead of using it - might be very small, if nonexistant. - --enable-strings (default: off) Add support for our possibly faster memset() function and other various routines, overriding your system's versions which may have