--- rxvt-unicode/doc/rxvt.7.txt 2006/01/04 21:50:12 1.33 +++ rxvt-unicode/doc/rxvt.7.txt 2006/01/13 12:40:46 1.43 @@ -20,6 +20,46 @@ . FREQUENTLY ASKED QUESTIONS + The new selection selects pieces that are too big, how can I select + single words? + Yes. For example, if you want to select alphanumeric 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: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) + + Please also note that the *LeftClick Shift-LeftClik* combination + also selects words like the old code. + + 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 urxvtperl(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 +98,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? @@ -106,7 +146,7 @@ How do I know which rxvt-unicode version I'm using? The version number is displayed with the usage (-h). Also the escape sequence "ESC [ 8 n" sets the window title to the version number. - When using the rxvtc client, the version displayed is that of the + When using the urxvtc client, the version displayed is that of the daemon. I am using Debian GNU/Linux and have a problem... @@ -124,6 +164,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 @@ -157,7 +240,7 @@ Most likely it's the empty definition for "enacs=". Just replace it by "enacs=\E[0@" and try again. - "bash"'s readline does not work correctly under rxvt. + "bash"'s readline does not work correctly under urxvt. I need a termcap file entry. One reason you might want this is that some distributions or operating systems still compile some programs using the @@ -278,7 +361,7 @@ In that case, select a font of your taste and add it to the font list, e.g.: - rxvt -fn basefont,font2,font3... + urxvt -fn basefont,font2,font3... When rxvt-unicode sees a character, it will first look at the base font. If the base font does not contain the character, it will go to @@ -573,7 +656,7 @@ some editors prematurely may leave the mouse in mouse report mode. I've heard that tcsh may use mouse reporting unless it otherwise specified. A quick check is to see if cut/paste works when the Alt - or Shift keys are depressed. See rxvt(7) + or Shift keys are depressed. What's with this bold/blink stuff? If no bold colour is set via "colorBD:", bold will invert text using @@ -638,9 +721,9 @@ URxvt.color7: #e1dddd URxvt.color15: #e1dddd - How can I start rxvtd in a race-free way? - Try "rxvtd -f -o", which tells rxvtd to open the display, create the - listening socket and then fork. + How can I start urxvtd in a race-free way? + Try "urxvtd -f -o", which tells urxvtd to open the display, create + the listening socket and then fork. What's with the strange Backspace/Delete key behaviour? Assuming that the physical Backspace key corresponds to the @@ -663,13 +746,13 @@ # use Backspace = ^H $ stty erase ^H - $ rxvt + $ urxvt # use Backspace = ^? $ stty erase ^? - $ rxvt + $ urxvt - Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in rxvt(7). + Toggle with "ESC [ 36 h" / "ESC [ 36 l". For an existing rxvt-unicode: @@ -705,7 +788,7 @@ option you can use the `keysym' resource to alter the keystrings associated with keysyms. - Here's an example for a URxvt session started using "rxvt -name + Here's an example for a URxvt session started using "urxvt -name URxvt" URxvt.keysym.Home: \033[1~ @@ -1268,8 +1351,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 +1363,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 +1952,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 +1967,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 +2005,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 @@ -1965,7 +2042,7 @@ sgr modes 90..97 and 100..107 --enable-iso14755 (default: on) - Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). + Enable extended ISO 14755 support (see urxvt(1), or doc/rxvt.1.txt). Basic support (section 5.1) is enabled by "--enable-frills", while support for 5.2, 5.3 and 5.4 is enabled with this switch. @@ -2006,7 +2083,7 @@ Add support to have the pointer disappear when typing or inactive. --enable-perl (default: off) - Enable an embedded perl interpreter. See the rxvtperl(3) manpage + Enable an embedded perl interpreter. See the urxvtperl(3) manpage (doc/rxvtperl.txt) for more info on this feature, or the files in src/perl-ext/ for the extensions that are installed by default. The perl interpreter that is used can be specified via the "PERL"