--- rxvt-unicode/doc/rxvt.1.txt 2006/01/02 19:36:07 1.30 +++ rxvt-unicode/doc/rxvt.1.txt 2006/01/04 21:37:55 1.36 @@ -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 @@ -392,8 +398,9 @@ my $slave = $pty->slave; while (<$slave>) { print $slave "got <$_>\n" } - -perl *string* - Used by perl extension. See resource perl. + -pe *string* + Colon-separated list of perl extension scripts to use in this + terminal instance. See resource perl-ext. RESOURCES (available also as long-options) Note: `rxvt --help' gives a list of all resources (long options) @@ -712,6 +719,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. @@ -886,6 +899,13 @@ URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 + If *string* takes the form "perl:STRING", then the specified STRING + is passed to the "on_keyboard_command" perl handler. See the + rxvtperl(3) manpage. For example, the selection extension (activated + via "rxvt -pe selection") listens for "selection:rot13" events: + + URxvt.keysym.M-C-c: perl:selection:rot13 + Due the the large number of modifier combinations, a defined key mapping will match if at *at least* the specified identifiers are being set, and no other key mappings with those and more bits are @@ -918,19 +938,26 @@ URxvt.keysym.M-C-3: command:\033[8;25;80t URxvt.keysym.M-C-4: command:\033[8;48;110t - perl: *string* - Used by perl extension and is free for any use, as it is not - interpreted by rxvt-unicode itself; option perl. + perl-ext-common: *string* + perl-ext: *string* + Colon-separated list(s) 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. If this resource is empty or missing, 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; option -pe. perl-eval: *string* - Perl code to be evaluated when all extensions have been loaded. See - the rxvtperl(3) manpage. + Perl code to be evaluated when all extensions have been registered. + See the rxvtperl(3) manpage. perl-lib: *path* - Additional directory that holds extension scripts that are loaded - and enabled for this terminal instance, in addition to scripts - stored in /opt/rxvt/lib/urxvt/perl-ext/, which are global to all - terminal instances. + 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/. See the rxvtperl(3) manpage.