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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.75 by root, Tue Dec 27 01:50:00 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
    $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
 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
 definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined
 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
+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

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents): Revision 1.75 by root, Tue Dec 27 01:50:00 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.75 by root, Tue Dec 27 01:50:00 2005 UTC vs.
Revision 1.89 by root, Sun Jan 8 08:43:11 2006 UTC