--- rxvt-unicode/doc/rxvt.7.man.in 2006/01/11 05:29:40 1.39 +++ rxvt-unicode/doc/rxvt.7.man.in 2006/01/12 05:37:34 1.42 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 7" -.TH rxvt 7 "2006-01-11" "6.3" "RXVT-UNICODE" +.TH rxvt 7 "2006-01-12" "7.0" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -158,6 +158,30 @@ . .SH "FREQUENTLY ASKED QUESTIONS" .IX Header "FREQUENTLY ASKED QUESTIONS" +.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 @@ -290,17 +314,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 @@ -2491,15 +2515,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