[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.80 by root, Mon Jan 2 21:26:05 2006 UTC

 =item B<-fbi> I<fontlist>
 Compile font-styles: The bold italic font list to use when bold 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
+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
 `.' or `*' characters. Also sets the icon and title name.
 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>.
    close $pty;
    # now communicate with rxvt
    my $slave = $pty->slave;
    while (<$slave>) { print $slave "got <$_>\n" }
+=item B<-pe> I<string>
+Colon-separated list of perl extension scripts to use in this terminal instance. See resource B<perl-ext>.
 =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<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 rxvtperl(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>: I<string>
+Colon-separated list 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; option B<-pe>.
+=item B<perl-eval>: I<string>
+Perl code to be evaluated when all extensions have been registered. See the
+rxvtperl(3) manpage.
+=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/>.
+See the rxvtperl(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.80 by root, Mon Jan 2 21:26:05 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.80 by root, Mon Jan 2 21:26:05 2006 UTC