--- rxvt-unicode/doc/rxvt.7.man.in 2006/01/09 01:54:43 1.37 +++ rxvt-unicode/doc/rxvt.7.man.in 2006/01/12 23:16:31 1.44 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 7" -.TH rxvt 7 "2006-01-09" "6.3" "RXVT-UNICODE" +.TH rxvt 7 "2006-01-13" "7.0" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -158,6 +158,50 @@ . .SH "FREQUENTLY ASKED QUESTIONS" .IX Header "FREQUENTLY ASKED QUESTIONS" +.IP "The new selection selects pieces that are too big, how can I select single words?" 4 +.IX Item "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: +.Sp +.Vb 1 +\& URxvt.selection.pattern-0: ([[:word:]]+) +.Ve +.Sp +If you click more than twice, the selection will be extended +more and more. +.Sp +To get a selection that is very similar to the old code, try this pattern: +.Sp +.Vb 1 +\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) +.Ve +.Sp +Please also note that the \fILeftClick Shift-LeftClik\fR combination also +selects words like the old code. +.IP "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?" 4 +.IX Item "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 +\&\fBperl-ext-common\fR resource to the empty string, which also keeps +rxvt-unicode from initialising perl, saving memory. +.Sp +If you only want to disable specific features, you first have to +identify which perl extension is responsible. For this, read the section +\&\fB\s-1PREPACKAGED\s0 \s-1EXTENSIONS\s0\fR in the @@RXVT_NAME@@\fIperl\fR\|(3) manpage. For +example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify +this \fBperl-ext-common\fR resource: +.Sp +.Vb 1 +\& URxvt.perl-ext-common: default,-selection-popup,-option-popup +.Ve +.Sp +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 \fBM\-s\fR. You can move it to any +other combination either by setting the \fBsearchable-scrollback\fR resource: +.Sp +.Vb 1 +\& URxvt.searchable-scrollback: CM-s +.Ve .IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4 .IX Item "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 @@ -200,7 +244,7 @@ Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), 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 +43180k in daemons that stay around after exit, plus half a minute of startup time, including the hundreds of warnings it spits out), it fares extremely well *g*. .IP "Why \*(C+, isn't that unportable/bloated/uncool?" 4 @@ -290,17 +334,17 @@ encodings built-in that increase download times and are rarely used). .IP "I need to make it setuid/setgid to support utmp/ptys on my \s-1OS\s0, is this safe?" 4 .IX Item "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 + ... + rxvt-unicode itself to all be +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. +runs setuid or setgid, which is not nice. Besides, with the embedded perl +interpreter the possibility for security problems easily multiplies. .Sp 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). If rxvt-unicode doesn't support -the library/setuid helper that your \s-1OS\s0 needs I'll be happy to assist you -in implementing support for it. +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. .Sp So, while setuid/setgid operation is supported and not a problem on your typical single-user-no-other-logins unix desktop, always remember that @@ -1776,8 +1820,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 @@ -1788,6 +1832,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). @@ -2489,15 +2535,6 @@ .IP "\-\-disable\-resources" 4 .IX Item "--disable-resources" Removes any support for resource checking. -.IP "\-\-enable\-xgetdefault" 4 -.IX Item "--enable-xgetdefault" -Make resources checking via \fIXGetDefault()\fR instead of our small -version which only checks ~/.Xdefaults, or if that doesn't exist then -~/.Xresources. -.Sp -Please note that nowadays, things like \s-1XIM\s0 will automatically pull in and -use the full X resource manager, so the overhead of using it might be very -small, if nonexistant. .IP "\-\-enable\-strings (default: off)" 4 .IX Item "--enable-strings (default: off)" Add support for our possibly faster \fImemset()\fR function and other