--- rxvt-unicode/doc/rxvt.1.txt 2006/01/02 21:41:51 1.32 +++ rxvt-unicode/doc/rxvt.1.txt 2006/01/11 02:13:55 1.41 @@ -6,7 +6,7 @@ rxvt [options] [-e command [ args ]] DESCRIPTION - rxvt-unicode, version 6.2, is a colour vt102 terminal emulator intended + rxvt-unicode, version 6.3, is a colour vt102 terminal emulator intended as an *xterm*(1) replacement for users who do not require features such as Tektronix 4014 emulation and toolkit-style configurability. As a result, rxvt-unicode uses much less swap space -- a significant @@ -165,20 +165,20 @@ FAQ section of rxvt(7). -fb *fontlist* - Compile font-styles: The bold font list to use when bold characters - are to be printed. See resource boldFont for details. + Compile *font-styles*: The bold font list to use when bold + characters are to be printed. See resource boldFont for details. -fi *fontlist* - Compile font-styles: The italic font list to use when bold + Compile *font-styles*: The italic font list to use when *italic* characters are to be printed. See resource italicFont for details. -fbi *fontlist* - Compile font-styles: The bold italic font list to use when bold - characters are to be printed. See resource boldItalicFont for - details. + Compile *font-styles*: The bold italic font list to use when *bold + italic* characters are to be printed. See resource boldItalicFont + for details. -is|+is - Compile font-styles: Bold/Italic font styles imply high intensity + Compile *font-styles*: Bold/Italic font styles imply high intensity foreground/background (default). See resource intensityStyles for details. @@ -254,6 +254,12 @@ if honoured by the WM, the rxvt-unicode window will not have window decorations; resource borderLess. + -sbg + Compile *frills*: Disable the usage of the built-in block + graphics/line drawing characters and just rely on what the specified + fonts provide. Use this if you have a good font and want to use its + block graphic glyphs; resource skipBuiltinGlyphs. + -lsp *number* Compile *frills*: Lines (pixel height) to insert between each row of the display. Useful to work around font rendering problems; resource @@ -367,7 +373,7 @@ system "rxvt -embed $xid &"; }); - -pty-fd *fileno* + -pty-fd *file descriptor* Tells rxvt NOT to execute any commands or create a new pty/tty pair but instead use the given filehandle as the tty master. This is useful if you want to drive rxvt as a generic terminal emulator @@ -377,6 +383,9 @@ and will not tinker with pty/tty permissions - you have to do that yourself if you want that. + As an extremely special case, specifying -1 will completely suppress + pty/tty operations. + Here is a example in perl that illustrates how this option can be used (a longer example is in doc/pty-fd): @@ -393,8 +402,8 @@ while (<$slave>) { print $slave "got <$_>\n" } -pe *string* - Colon-separated list of perl extension scripts to use in this - terminal instance. See resource perl-ext. + Comma-separated list of perl extension scripts to use (or not to + use) in this terminal instance. See resource perl-ext for details. RESOURCES (available also as long-options) Note: `rxvt --help' gives a list of all resources (long options) @@ -713,6 +722,12 @@ the WM, the rxvt-unicode window will not have window decorations; option -bl. + skipBuiltinGlyphs: *boolean* + Compile *frills*: Disable the usage of the built-in block + graphics/line drawing characters and just rely on what the specified + fonts provide. Use this if you have a good font and want to use its + block graphic glyphs; option -sbg. + termName: *termname* Specifies the terminal type name to be set in the TERM environment variable; option -tn. @@ -926,24 +941,53 @@ URxvt.keysym.M-C-3: command:\033[8;25;80t URxvt.keysym.M-C-4: command:\033[8;48;110t + perl-ext-common: *string* perl-ext: *string* - Colon-separated list of perl extension scripts to use in this - terminal instance. Each extension is looked up in the library - directories, loaded if necessary, and bound to the current terminal - instance; option -pe. + Comma-separated list(s) of perl extension scripts (default: + "default") to use in this terminal instance; option -pe. + + Extension names can be prefixed with a "-" sign to prohibit using + them. This can be useful to selectively disable some extensions + loaded by default, or specified via the "perl-ext-common" resource. + For example, "default,-selection" will use all the default extension + except "selection". + + Extension names can also be followed by an argument in angle + brackets (e.g. "searchable-scrollback", which binds the hotkey + for searchable scorllback to Alt/Meta-s). Mentioning the same + extension multiple times with different arguments will pass multiple + arguments to the extension. + + Each extension is looked up in the library directories, loaded if + necessary, and bound to the current terminal instance. + + If both of these resources are the empty string, then the perl + interpreter will not be initialized. The idea behind two options is + that perl-ext-common will be used for extensions that should be + available to all instances, while perl-ext is used for specific + instances. perl-eval: *string* Perl code to be evaluated when all extensions have been registered. - See the rxvtperl(3) manpage. + See the rxvtperl(3) manpage. Due to security reasons, this resource + will be ignored when running setuid/setgid. perl-lib: *path* Colon-separated list of additional directories that hold extension scripts. When looking for extensions specified by the "perl" resource, rxvt will first look in these directories and then in - /opt/rxvt/lib/urxvt/perl/. + /opt/rxvt/lib/urxvt/perl/. Due to security reasons, this resource + will be ignored when running setuid/setgid. See the rxvtperl(3) manpage. + urlLauncher: *string* + Specifies the program to be started with a URL argument. Used by the + "selection-popup" and "mark-urls" perl extensions. + + transient-for: *windowid* + Sets the WM_TRANSIENT_FOR property to the given window iw. + THE SCROLLBAR Lines of text that scroll off the top of the rxvt window (resource: saveLines) and can be scrolled back using the scrollbar or by