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

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.27 by root, Thu Dec 22 16:44:10 2005 UTC vs.
Revision 1.42 by root, Wed Jan 11 23:08:54 2006 UTC

 SYNOPSIS
     rxvt [options] [-e command [ args ]]
 DESCRIPTION
-    rxvt-unicode, version 6.0, is a colour vt102 terminal emulator intended
+    rxvt-unicode, version 7.0, 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
+        for details.
+    -is|+is
+        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
         obtained, rather than the default executable file name. Name should
         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" }
+    -pe *string*
+        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.
-    There are two different methods that rxvt can use to get the Xresource
-    data: using the X libraries (Xrm*-functions) or internal Xresources
-    reader (~/.Xdefaults). For the first method (ie. rxvt -h lists
-    XGetDefaults), you can set and change the resources using X11 tools like
+    You can set and change the resources using X11 tools like xrdb. Many
-    xrdb. Many distribution do also load settings from the ~/.Xresources
+    distribution do also load settings from the ~/.Xresources file when X
-    file when X starts. rxvt will consult the following files/resources in
+    starts. rxvt will consult the following files/resources in order, with
-    order, with later settings overwriting earlier ones:
+    later settings overwriting earlier ones:
       1. system-wide app-defaults file, either locale-dependent OR global
       2. app-defaults file in $XAPPLRESDIR
       3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
       4. SCREEN_RESOURCES for the current screen
       5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename>
-    If compiled with internal Xresources support (i.e. rxvt -h lists
+    Note that when reading X resources, rxvt recognizes two class names:
-    .Xdefaults) then rxvt accepts application defaults set in
+    Rxvt and URxvt. The class name Rxvt allows resources common to both rxvt
-    XAPPLOADDIR/URxvt (compile-time defined: usually
+    and the original *rxvt* to be easily configured, while the class name
-    /usr/lib/X11/app-defaults/URxvt) and resources set in ~/.Xdefaults, or
+    URxvt allows resources unique to rxvt, to be shared between different
-    ~/.Xresources if ~/.Xdefaults does not exist. Note that when reading X
-    resources, rxvt recognizes two class names: XTerm and URxvt. The class
-    name Rxvt allows resources common to both rxvt and the original *rxvt*
-    to be easily configured, while the class name URxvt allows resources
-    unique to rxvt, notably colours and key-handling, to be shared between
-    different rxvt configurations. If no resources are specified, suitable
+    rxvt configurations. If no resources are specified, suitable defaults
-    defaults will be used. Command-line arguments can be used to override
+    will be used. Command-line arguments can be used to override resource
-    resource settings. The following resources are allowed:
+    settings. The following resources are supported (you might want to check
+    the rxvtperl(3) manpage for additional settings by perl extensions not
+    documented here):
     geometry: *geom*
         Create the window with the specified X window geometry [default
         80x24]; option -geometry.
     font: *fontlist*
         Select the fonts to be used. This is a comma separated list of font
         names that are used in turn when trying to display Unicode
         characters. The first font defines the cell size for characters;
         other fonts might be smaller, but not larger. A reasonable default
-        font list is always appended to it. option -fn.
+        font list is always appended to it; option -fn.
         Each font can either be a standard X11 core font (XLFD) name, with
         optional prefix "x:" or a Xft font (Compile *xft*), prefixed with
         "xft:".
         tried.
         If set, but empty, then this specific style is disabled and the
         normal text font will being used for the given style.
+    intensityStyles: *boolean*
+        When font styles are not enabled, or this option is enabled (True,
+        option -is, the default), bold and italic font styles imply high
+        intensity foreground/backround colours. Disabling this option
+        (False, option +is) disables this behaviour, the high intensity
+        colours are not reachable.
     selectstyle: *mode*
         Set mouse selection style to old which is 2.20, oldword which is
         xterm style with 2.20 old word selection, or anything else which
         gives xterm style selection.
     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*
     imLocale: *name*
         The locale to use for opening the IM. You can use an "LC_CTYPE" of
         e.g. "de_DE.UTF-8" for normal text processing but "ja_JP.EUC-JP" for
         the input extension to be able to input japanese characters while
-        staying in another locale. option -imlocale.
+        staying in another locale; option -imlocale.
     imFont: *fontset*
         Specify the font-set used for XIM styles "OverTheSpot" or
         "OffTheSpot". It must be a standard X font set (XLFD patterns
         separated by commas), i.e. it's not in the same format as the other
         to the base font. option -imfont.
     tripleclickwords: *boolean*
         Change the meaning of triple-click selection with the left mouse
         button. Instead of selecting a full line it will extend the
-        selection to the end of the logical line only. option -tcw.
+        selection to the end of the logical line only; option -tcw.
     insecure: *boolean*
         Enables "insecure" mode. Rxvt-unicode offers some escape sequences
         that echo arbitrary strings like the icon name or the locale. This
         could be abused if somebody gets 8-bit-clean access to your display,
         "\e", "\E": escape, "\n": newline, "\r": carriage return, "\t": tab,
         "\000": octal number) or verbatim control characters ("^?": delete,
         "^@": null, "^A" ...) and may be enclosed with double quotes so that
         it can start or end with whitespace.
-        Please note that you need to double the "\" when using
+        Please note that you need to double the "\" in resource files, as
-        "--enable-xgetdefault", as X itself does it's own de-escaping (you
+        Xlib itself does it's own de-escaping (you can use "\033" instead of
-        can use "\033" instead of "\e" (and so on), which will work with
+        "\e" (and so on), which will work with both Xt and rxvt's own
-        both Xt and rxvt's own processing).
+        processing).
         You can define a range of keysyms in one shot by providing a
         *string* with pattern list/PREFIX/MIDDLE/SUFFIX, where the delimeter
         `/' should be a character not used by the strings.
         is interpreted and executed as rxvt's control sequence. For example
         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
         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-ext: *string*
+        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<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 registered.
+        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/. 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
     fairly intuitive. The xterm-scrollbar is without arrows and its
         entire logical line (which can span multiple screen lines), unless
         modified by resource tripleclickwords.
         Starting a selection while pressing the Meta key (or Meta+Ctrl keys)
         (Compile: *frills*) will create a rectangular selection instead of a
-        normal one.
+        normal one. In this mode, every selected row becomes its own line in
+        the selection, and trailing whitespace is visually underlined and
+        removed from the selection.
     Insertion:
         Pressing and releasing the Middle mouse button (or Shift-Insert) in
         an rxvt window causes the current text selection to be inserted as
         if it had been typed on the keyboard.

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents): Revision 1.27 by root, Thu Dec 22 16:44:10 2005 UTC vs. Revision 1.42 by root, Wed Jan 11 23:08:54 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.txt (file contents):
Revision 1.27 by root, Thu Dec 22 16:44:10 2005 UTC vs.
Revision 1.42 by root, Wed Jan 11 23:08:54 2006 UTC