--- rxvt-unicode/doc/rxvt.1.pod 2005/04/22 02:09:39 1.63 +++ rxvt-unicode/doc/rxvt.1.pod 2006/01/02 21:41:51 1.81 @@ -107,21 +107,31 @@ Turn on/off jump scrolling; resource B. -=item B<-ip>|B<+ip> +=item B<-ip>|B<+ip> | B<-tr>|B<+tr> Turn on/off inheriting parent window's pixmap. Alternative form is B<-tr>; resource B. =item B<-fade> I -Fade the text by the given percentage when focus is lost. resource B. +Fade the text by the given percentage when focus is lost. Small values +fade a little only, 100 completely replaces all colours by the fade +colour; resource B. + +=item B<-fadecolor> I + +Fade to this colour when fading is used (see B<-fade>). The default colour +is black. resource B. =item B<-tint> I Tint the transparent background pixmap with the given colour when -transparency is enabled with B<-tr> or B<-ip>. See also the B<-sh> -option that can be used to brighten or darken the image in addition to -tinting it. +transparency is enabled with B<-tr> or B<-ip>. This only works for +non-tiled backgrounds, currently. See also the B<-sh> option that can be +used to brighten or darken the image in addition to tinting it; resource +I. Example: + + @@RXVT_NAME@@ -tr -tint blue -sh 40 =item B<-sh> @@ -194,6 +204,12 @@ Compile font-styles: The bold italic font list to use when bold characters are to be printed. See resource B for details. +=item B<-is>|B<+is> + +Compile font-styles: Bold/Italic font styles imply high intensity +foreground/background (default). See resource B for +details. + =item B<-name> I Specify the application name under which resources are to be obtained, @@ -240,7 +256,7 @@ =item B<-st>|B<+st> -Display normal (non XTerm/NeXT) scrollbar without/with a trough; +Display rxvt (non XTerm/NeXT) scrollbar without/with a trough; resource B. =item B<-ptab>|B<+ptab> @@ -305,6 +321,11 @@ run the program specified by the B environment variable or, failing that, I. +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 Window title (B<-T> still respected); the default title is the basename @@ -370,6 +391,13 @@ Turn on/off secondary screen scroll (default enabled); resource B. +=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. + =item B<-keysym.>I I Remap a key symbol. See resource B. @@ -427,6 +455,10 @@ my $slave = $pty->slave; while (<$slave>) { print $slave "got <$_>\n" } +=item B<-pe> I + +Colon-separated list of perl extension scripts to use in this terminal instance. See resource B. + =back =head1 RESOURCES (available also as long-options) @@ -550,11 +582,17 @@ =item B I -Fade the text by the given percentage when focus is lost. +Fade the text by the given percentage when focus is lost; option B<-fade>. + +=item B I + +Fade to this colour, when fading is used (see B). The default +colour is black; option B<-fadecolor>. =item B I -Tint the transparent background pixmap with the given colour. +Tint the transparent background pixmap with the given colour; option +B<-tint>. =item B I @@ -568,7 +606,7 @@ =item B I Use the specified colour for the scrollbar's trough area [default -#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. +#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar. =item B I @@ -605,7 +643,7 @@ 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 or a Xft font (Compile I), prefixed with C. @@ -661,6 +699,14 @@ If set, but empty, then this specific style is disabled and the normal text font will being used for the given style. +=item B I + +When font styles are not enabled, or this option is enabled (B, +option B<-is>, the default), bold and italic font styles imply high +intensity foreground/backround colours. Disabling this option (B, +option B<+is>) disables this behaviour, the high intensity colours are not +reachable. + =item B I Set mouse selection style to B which is 2.20, B which is @@ -670,7 +716,7 @@ =item B I Set scrollbar style to B, B, B or B. B is -the author's favourite.. +the author's favourite. =item B I @@ -712,6 +758,15 @@ B to initiate a screen dump to the printer and B or B to include the scrollback as well. +The string will be interpreted as if typed into the shell as-is. + +Example: + + URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) + +This creates a new file in your home directory with the screen contents +everytime you hit C. + =item B I B: enable the scrollbar [default]; option B<-sb>. B: @@ -853,7 +908,7 @@ The locale to use for opening the IM. You can use an C of e.g. C for normal text processing but C 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 I @@ -868,20 +923,22 @@ 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 I 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, whether -throuh a mail client displaying mail bodies unfiltered or though -write(1). Therefore, these sequences are disabled by default. (Note -that other terminals, including xterm, have these sequences -enabled by default). You can enable them by setting this boolean -resource or specifying B<-insecure> as an option. At the moment, this -enabled display-answer, locale, findfont, icon label and window title -requests as well as dynamic menubar dispatch. +through a mail client displaying mail bodies unfiltered or through +write(1) or any other means. Therefore, these sequences are disabled by +default. (Note that many other terminals, including xterm, have these +sequences enabled by default, which doesn't make it safer, though). + +You can enable them by setting this boolean resource or specifying +B<-insecure> as an option. At the moment, this enables display-answer, +locale, findfont, icon label and window title requests as well as dynamic +menubar dispatch. =item B I @@ -906,6 +963,13 @@ scrollback buffer and switching to/from the secondary screen will instead scroll the screen up. +=item B: I + +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 BI: I Compile I: Associate I with keysym I. The @@ -960,6 +1024,13 @@ URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 +If I takes the form C, then the specified B +is passed to the C perl handler. See the @@RXVT_NAME@@perl(3) +manpage. For example, the F extension (activated via +C<@@RXVT_NAME@@ -pe selection>) listens for C 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 the specified identifiers are being set, and no other key mappings with those and more bits are being defined. That @@ -992,6 +1063,26 @@ URxvt.keysym.M-C-3: command:\033[8;25;80t URxvt.keysym.M-C-4: command:\033[8;48;110t +=item B: I + +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: I + +Perl code to be evaluated when all extensions have been registered. See the +@@RXVT_NAME@@perl(3) manpage. + +=item B: I + +Colon-separated list of additional directories that hold extension +scripts. When looking for extensions specified by the C resource, +@@RXVT_NAME@@ will first look in these directories and then in +F<@@RXVT_LIBDIR@@/urxvt/perl/>. + +See the @@RXVT_NAME@@perl(3) manpage. + =back =head1 THE SCROLLBAR @@ -1035,8 +1126,10 @@ B. Starting a selection while pressing the B key (or B keys) -(Compile: I) will create a rectangular selection instead of a normal -one. +(Compile: I) will create a rectangular selection instead of a +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: @@ -1054,7 +1147,7 @@ You can, however, switch fonts at runtime using escape sequences (and therefore using the menubar), e.g.: - printf '\e]701;%s\007' "9x15bold,xft:Kochi Gothic" + printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic" rxvt-unicode will automatically re-apply these fonts to the output so far. @@ -1240,7 +1333,7 @@ The unix domain socket path used by @@RXVT_NAME@@c(1) and @@RXVT_NAME@@d(1). -Default C<< $HOME/.rxvt-unicode->. +Default F<<< $HOME/.rxvt-unicode-I<< > >>>. =item B @@ -1271,15 +1364,7 @@ =head1 SEE ALSO -@@RXVT_NAME@@(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) - -=head1 BUGS - -Check the BUGS file for an up-to-date list. - -Cursor change support is not yet implemented. - -Click-and-drag doesn't work with X11 mouse report overriding. +@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) =head1 CURRENT PROJECT COORDINATOR