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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.76 by root, Sat Dec 31 16:06:48 2005 UTC vs.
Revision 1.94 by root, Thu Jan 12 05:37:34 2006 UTC

 See also the question "How does rxvt-unicode choose fonts?" in the FAQ
 section of @@RXVT_NAME@@(7).
 =item B<-fb> I<fontlist>
-Compile font-styles: The bold font list to use when bold characters are to
+Compile I<font-styles>: The bold font list to use when B<bold> characters
-be printed. See resource B<boldFont> for details.
+are to be printed. See resource B<boldFont> for details.
 =item B<-fi> I<fontlist>
-Compile font-styles: The italic font list to use when bold characters are to
+Compile I<font-styles>: The italic font list to use when I<italic>
-be printed. See resource B<italicFont> for details.
+characters are to be printed. See resource B<italicFont> for details.
 =item B<-fbi> I<fontlist>
-Compile font-styles: The bold italic font list to use when bold characters are to
+Compile I<font-styles>: The bold italic font list to use when B<< I<bold
-be printed. See resource B<boldItalicFont> for details.
+italic> >> characters are to be printed. See resource B<boldItalicFont>
+for details.
 =item B<-is>|B<+is>
-Compile font-styles: Bold/Italic font styles imply high intensity
+Compile I<font-styles>: Bold/Italic font styles imply high intensity
 foreground/background (default). See resource B<intensityStyles> for
 details.
 =item B<-name> I<name>
 =item B<-bl>
 Compile I<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 B<borderLess>.
+=item B<-sbg>
+Compile I<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 B<skipBuiltinGlyphs>.
 =item B<-lsp> I<number>
 Compile I<frills>: Lines (pixel height) to insert between each row of
 the display. Useful to work around font rendering problems; resource
    $rxvt->signal_connect_after (realize => sub {
       my $xid = $_[0]->window->get_xid;
       system "@@RXVT_NAME@@ -embed $xid &";
    });
-=item B<-pty-fd> I<fileno>
+=item B<-pty-fd> I<file descriptor>
 Tells @@RXVT_NAME@@ 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_NAME@@ as a generic terminal emulator
 without having to run a program within it.
 If this switch is given, @@RXVT_NAME@@ 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 C<-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 F<doc/pty-fd>):
    use IO::Pty;
    use Fcntl;
    # now communicate with rxvt
    my $slave = $pty->slave;
    while (<$slave>) { print $slave "got <$_>\n" }
+=item B<-pe> I<string>
+Comma-separated list of perl extension scripts to use (or not to use) in
+this terminal instance. See resource B<perl-ext> for details.
 =back
 =head1 RESOURCES (available also as long-options)
 Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long
 options) compiled into your version.
-There are two different methods that @@RXVT_NAME@@ can use to get the
+You can set and change the resources using X11 tools like B<xrdb>. Many
-Xresource data: using the X libraries (Xrm*-functions) or internal
+distribution do also load settings from the B<~/.Xresources> file when X
-Xresources reader (B<~/.Xdefaults>). For the first method (ie.
+starts. @@RXVT_NAME@@ will consult the following files/resources in order,
-B<@@RXVT_NAME@@ -h> lists B<XGetDefaults>), you can set and change the
+with later settings overwriting earlier ones:
-resources using X11 tools like B<xrdb>. Many distribution do also load
-settings from the B<~/.Xresources> file when X starts. @@RXVT_NAME@@
-will consult the following files/resources in order, with 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. B<@@RXVT_NAME@@ -h>
-lists B<.Xdefaults>) then B<@@RXVT_NAME@@> accepts application defaults
-set in XAPPLOADDIR/URxvt (compile-time defined: usually
-B</usr/lib/X11/app-defaults/URxvt>) and resources set in
-B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist.
-Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two
+Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two class
-class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows
+names: B<Rxvt> and B<URxvt>. The class name B<Rxvt> allows resources
-resources common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be
+common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be easily
-easily configured, while the class name B<URxvt> allows resources
+configured, while the class name B<URxvt> allows resources unique to
-unique to B<@@RXVT_NAME@@>, notably colours and key-handling, to be
+B<@@RXVT_NAME@@>, to be shared between different B<@@RXVT_NAME@@>
-shared between different B<@@RXVT_NAME@@> configurations. If no
+configurations. If no resources are specified, suitable defaults will
-resources are specified, suitable defaults will be used. Command-line
+be used. Command-line arguments can be used to override resource
-arguments can be used to override resource settings. The following
+settings. The following resources are supported (you might want to
-resources are allowed:
+check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
+extensions not documented here):
 =over 4
 =item B<geometry:> I<geom>
 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 B<-fn>.
+appended to it; option B<-fn>.
 Each font can either be a standard X11 core font (XLFD) name, with
 optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>.
 In addition, each font can be prefixed with additional hints and
 =item B<borderLess:> I<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 B<-bl>.
+=item B<skipBuiltinGlyphs:> I<boolean>
+Compile I<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 B<-sbg>.
 =item B<termName:> I<termname>
 Specifies the terminal type name to be set in the B<TERM> environment
 variable; option B<-tn>.
 =item B<imLocale:> I<name>
 The locale to use for opening the IM. You can use an C<LC_CTYPE> of e.g.
 C<de_DE.UTF-8> for normal text processing but C<ja_JP.EUC-JP> for the
 input extension to be able to input japanese characters while staying in
-another locale. option B<-imlocale>.
+another locale; option B<-imlocale>.
 =item B<imFont:> I<fontset>
 Specify the font-set used for XIM styles C<OverTheSpot> or
 C<OffTheSpot>. It must be a standard X font set (XLFD patterns separated
 =item B<tripleclickwords:> I<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 B<-tcw>.
+the end of the logical line only; option B<-tcw>.
 =item B<insecure:> I<boolean>
 Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
 echo arbitrary strings like the icon name or the locale. This could be
 C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab,
 C<\000>: octal number) or verbatim control characters (C<^?>: delete,
 C<^@>: null, C<^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 C<\> when using
+Please note that you need to double the C<\> in resource files, as
-C<--enable-xgetdefault>, as X itself does it's own de-escaping (you can
+Xlib itself does it's own de-escaping (you can use C<\033> instead of
-use C<\033> instead of C<\e> (and so on), which will work with both Xt and
+C<\e> (and so on), which will work with both Xt and @@RXVT_NAME@@'s own
-@@RXVT_NAME@@'s own processing).
+processing).
 You can define a range of keysyms in one shot by providing a I<string>
 with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/'
 should be a character not used by the strings.
 is interpreted and executed as @@RXVT_NAME@@'s control sequence. For
 example the following means "change the current locale to C<zh_CN.GBK>
 when Control-Meta-c is being pressed":
   URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
+If I<string> takes the form C<perl:STRING>, then the specified B<STRING>
+is passed to the C<on_keyboard_command> perl handler. See the @@RXVT_NAME@@perl(3)
+manpage. For example, the F<selection> extension (activated via
+C<@@RXVT_NAME@@ -pe selection>) listens for C<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 I<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 C<a> will automatically provide
 Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more
 info):
   URxvt.keysym.M-C-3: command:\033[8;25;80t
   URxvt.keysym.M-C-4: command:\033[8;48;110t
+=item B<perl-ext-common>: I<string>
+=item B<perl-ext>: I<string>
+Comma-separated list(s) of perl extension scripts (default: C<default>) to
+use in this terminal instance; option B<-pe>.
+Extension names can be prefixed with a C<-> sign to prohibit using
+them. This can be useful to selectively disable some extensions loaded
+by default, or specified via the C<perl-ext-common> resource. For
+example, C<default,-selection> will use all the default extension except
+C<selection>.
+Extension names can also be followed by an argument in angle brackets
+(e.g.  C<< 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
+B<perl-ext-common> will be used for extensions that should be available to
+all instances, while B<perl-ext> is used for specific instances.
+=item B<perl-eval>: I<string>
+Perl code to be evaluated when all extensions have been registered. See
+the @@RXVT_NAME@@perl(3) manpage. Due to security reasons, this resource
+will be ignored when running setuid/setgid.
+=item B<perl-lib>: I<path>
+Colon-separated list of additional directories that hold extension
+scripts. When looking for extensions specified by the C<perl> resource,
+@@RXVT_NAME@@ will first look in these directories and then in
+F<@@RXVT_LIBDIR@@/urxvt/perl/>. Due to security reasons, this resource
+will be ignored when running setuid/setgid.
+See the @@RXVT_NAME@@perl(3) manpage.
+=item B<searchable-scrollback:> I<keysym>
+Sets the hotkey that starts the incremental scrollback buffer search
+(default: C<M-s>).
+=item B<urlLauncher>: I<string>
+Specifies the program to be started with a URL argument. Used by the
+C<selection-popup> and C<mark-urls> perl extensions.
+=item B<transient-for>: I<windowid>
+Sets the WM_TRANSIENT_FOR property to the given window iw.
 =back
 =head1 THE SCROLLBAR

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents): Revision 1.76 by root, Sat Dec 31 16:06:48 2005 UTC vs. Revision 1.94 by root, Thu Jan 12 05:37:34 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.76 by root, Sat Dec 31 16:06:48 2005 UTC vs.
Revision 1.94 by root, Thu Jan 12 05:37:34 2006 UTC