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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.73 by root, Thu Dec 15 18:14:08 2005 UTC vs.
Revision 1.89 by root, Sun Jan 8 08:43:11 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 I<font-styles>: Bold/Italic font styles imply high intensity
+foreground/background (default). See resource B<intensityStyles> for
+details.
 =item B<-name> I<name>
 Specify the application name under which resources are to be obtained,
 rather than the default executable file name. Name should not contain
 =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
 given on the command line. If this option is used, it must be the last
 on the command-line. If there is no B<-e> option then the default is to
 run the program specified by the B<SHELL> environment variable or,
 failing that, I<sh(1)>.
+Please note that you must specify a program with arguments. If you want to
+run shell commands, you have to specify the shell, like this:
+  @@RXVT_NAME@@ -e sh -c "shell commands"
 =item B<-title> I<text>
 Window title (B<-T> still respected); the default title is the basename
 of the program specified after the B<-e> option, if any, otherwise the
 application name; resource B<title>.
 =item B<-ssr>|B<+ssr>
 Turn on/off secondary screen scroll (default enabled); resource
 B<secondaryScroll>.
+=item B<-hold>|B<+hold>
+Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
+will not immediately destroy its window when the program executed within
+it exits. Instead, it will wait till it is being killed or closed by the
+user; resource B<hold>.
 =item B<-keysym.>I<sym> I<string>
 Remap a key symbol. See resource B<keysym>.
    $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;
    close $pty;
    # 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)
 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
 not possible, replacement fonts of the desired shape will be tried.
 If set, but empty, then this specific style is disabled and the normal
 text font will being used for the given style.
+=item B<intensityStyles:> I<boolean>
+When font styles are not enabled, or this option is enabled (B<True>,
+option B<-is>, the default), bold and italic font styles imply high
+intensity foreground/backround colours. Disabling this option (B<False>,
+option B<+is>) disables this behaviour, the high intensity colours are not
+reachable.
 =item B<selectstyle:> I<mode>
 Set mouse selection style to B<old> which is 2.20, B<oldword> which is
 xterm style with 2.20 old word selection, or anything else which gives
 xterm style selection.
 =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
 Turn on/off secondary screen scroll (default enabled). If the this
 option is enabled, scrolls on the secondary screen will change the
 scrollback buffer and switching to/from the secondary screen will
 instead scroll the screen up.
+=item B<hold>: I<bool>
+Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
+will not immediately destroy its window when the program executed within
+it exits. Instead, it will wait till it is being killed or closed by the
+user.
 =item B<keysym.>I<sym>: I<string>
 Compile I<frills>: Associate I<string> with keysym I<sym>. The
 intervening resource name B<keysym.> cannot be omitted.
 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
 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
+it. 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>.
+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.
 =back
 =head1 THE SCROLLBAR
 Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window
 to select a word; Left triple-click to select the entire logical line
 (which can span multiple screen lines), unless modified by resource
 B<tripleclickwords>.
 Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys)
-(Compile: I<frills>) will create a rectangular selection instead of a normal
+(Compile: I<frills>) will create a rectangular selection instead of a
-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.
 =item B<Insertion>:
 Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in
 an B<@@RXVT_NAME@@> window causes the current text selection to be

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents): Revision 1.73 by root, Thu Dec 15 18:14:08 2005 UTC vs. Revision 1.89 by root, Sun Jan 8 08:43:11 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.73 by root, Thu Dec 15 18:14:08 2005 UTC vs.
Revision 1.89 by root, Sun Jan 8 08:43:11 2006 UTC