[ViewVC] Diff of: cvs/rxvt-unicode/doc/rxvt.1.txt

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.30 by root, Mon Jan 2 19:36:07 2006 UTC vs.
Revision 1.41 by root, Wed Jan 11 02:13:55 2006 UTC

 SYNOPSIS
     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
     advantage on a machine serving many X sessions.
         See also the question "How does rxvt-unicode choose fonts?" in the
         FAQ section of rxvt(7).
     -fb *fontlist*
-        Compile font-styles: The bold font list to use when bold characters
+        Compile *font-styles*: The bold font list to use when bold
-        are to be printed. See resource boldFont for details.
+        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
+        Compile *font-styles*: The bold italic font list to use when *bold
-        characters are to be printed. See resource boldItalicFont for
+        italic* characters are to be printed. See resource boldItalicFont
-        details.
+        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.
     -name *name*
         Specify the application name under which resources are to be
         externalBorder.
     -bl Compile *frills*: Set MWM hints to request a borderless window, i.e.
         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
         linespace.
            $rxvt->signal_connect_after (realize => sub {
               my $xid = $_[0]->window->get_xid;
               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
         without having to run a program within it.
         If this switch is given, rxvt will not create any utmp/wtmp entries
         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):
            use IO::Pty;
            use Fcntl;
            # now communicate with rxvt
            my $slave = $pty->slave;
            while (<$slave>) { print $slave "got <$_>\n" }
-    -perl *string*
+    -pe *string*
-        Used by perl extension. See resource perl.
+        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)
     compiled into your version.
     borderLess: *boolean*
         Set MWM hints to request a borderless window, i.e. if honoured by
         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.
     linespace: *number*
         the following means "change the current locale to "zh_CN.GBK" when
         Control-Meta-c is being pressed":
           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
         being defined. That means that defining a key map for "a" will
         automatically provide definitions for "Meta-a", "Shift-a" and so on,
         info):
           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: *string*
+    perl-ext: *string*
-        Used by perl extension and is free for any use, as it is not
+        Comma-separated list(s) of perl extension scripts (default:
-        interpreted by rxvt-unicode itself; option perl.
+        "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<M-s>", 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 loaded. See
+        Perl code to be evaluated when all extensions have been registered.
-        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*
-        Additional directory that holds extension scripts that are loaded
+        Colon-separated list of additional directories that hold extension
-        and enabled for this terminal instance, in addition to scripts
+        scripts. When looking for extensions specified by the "perl"
-        stored in /opt/rxvt/lib/urxvt/perl-ext/, which are global to all
+        resource, rxvt will first look in these directories and then in
-        terminal instances.
+        /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
     keystrokes. The normal rxvt scrollbar has arrows and its behaviour is

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents): Revision 1.30 by root, Mon Jan 2 19:36:07 2006 UTC vs. Revision 1.41 by root, Wed Jan 11 02:13:55 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.30 by root, Mon Jan 2 19:36:07 2006 UTC vs.
Revision 1.41 by root, Wed Jan 11 02:13:55 2006 UTC