--- rxvt-unicode/doc/rxvt.1.pod	2005/02/11 18:14:07	1.53
+++ rxvt-unicode/doc/rxvt.1.pod	2006/01/03 18:11:34	1.82
@@ -107,21 +107,31 @@
 
 Turn on/off jump scrolling; resource B<jumpScroll>.
 
-=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<inheritPixmap>.
 
 =item B<-fade> I<number>
 
-Fade the text by the given percentage when focus is lost. resource B<fading>.
+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<fading>.
+
+=item B<-fadecolor> I<colour>
+
+Fade to this colour when fading is used (see B<-fade>). The default colour
+is black. resource B<fadeColor>.
 
 =item B<-tint> I<colour>
 
 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<tintColor>. 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<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,
@@ -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<scrollBar_floating>.
 
 =item B<-ptab>|B<+ptab>
@@ -305,6 +321,11 @@
 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
@@ -370,15 +391,73 @@
 Turn on/off secondary screen scroll (default enabled); resource
 B<secondaryScroll>.
 
-=item B<-keysym.>I<sym>: I<string>
+=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>.
 
-=item B<-xrm> I<resourcestring>
+=item B<-embed> I<windowid>
+
+Tells @@RXVT_NAME@@ to embed it's windows into an already-existing window,
+which enables applications to easily embed a terminal.
+
+Right now, @@RXVT_NAME@@ will first unmap/map the specified window, so it
+shouldn't be a top-level window. @@RXVT_NAME@@ will also reconfigure it
+quite a bit, so don't expect it to keep some specific state. It's best to
+create an extra subwindow for @@RXVT_NAME@@ and leave it alone.
+
+The window will not be destroyed when @@RXVT_NAME@@ exits.
+
+It might be useful to know that @@RXVT_NAME@@ will not close file
+descriptors passed to it (except for stdin/out/err, of course), so you
+can use file descriptors to communicate with the programs within the
+terminal. This works regardless of wether the C<-embed> option was used or
+not.
+
+Here is a short Gtk2-perl snippet that illustrates how this option can be
+used (a longer example is in F<doc/embed>):
+
+   my $rxvt = new Gtk2::Socket;
+   $rxvt->signal_connect_after (realize => sub {
+      my $xid = $_[0]->window->get_xid;
+      system "@@RXVT_NAME@@ -embed $xid &";
+   });
+
+=item B<-pty-fd> I<fileno>
+
+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.
+
+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;
+
+   my $pty = new IO::Pty;
+   fcntl $pty, F_SETFD, 0; # clear close-on-exec
+   system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&";
+   close $pty;
+
+   # now communicate with rxvt
+   my $slave = $pty->slave;
+   while (<$slave>) { print $slave "got <$_>\n" }
+
+=item B<-pe> I<string>
 
-No effect on rxvt-unicode. Simply passes through an argument to be made
-available in the instance's argument list. Appears in I<WM_COMMAND> in
-some window managers.
+Colon-separated list of perl extension scripts to use in this terminal instance. See resource B<perl-ext>.
 
 =back
 
@@ -503,11 +582,17 @@
 
 =item B<fading:> I<number>
 
-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<fadeColor:> I<colour>
+
+Fade to this colour, when fading is used (see B<fading:>). The default
+colour is black; option B<-fadecolor>.
 
 =item B<tintColor:> I<colour>
 
-Tint the transparent background pixmap with the given colour.
+Tint the transparent background pixmap with the given colour; option
+B<-tint>.
 
 =item B<shading:> I<number>
 
@@ -521,7 +606,7 @@
 =item B<troughColor:> I<colour>
 
 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<borderColor:> I<colour>
 
@@ -558,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<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>.
@@ -614,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<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
@@ -623,7 +716,7 @@
 =item B<scrollstyle:> I<mode>
 
 Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
-the author's favourite..
+the author's favourite.
 
 =item B<title:> I<string>
 
@@ -665,6 +758,15 @@
 B<Print> to initiate a screen dump to the printer and B<Ctrl-Print> or
 B<Shift-Print> 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<Print>.
+
 =item B<scrollBar:> I<boolean>
 
 B<True>: enable the scrollbar [default]; option B<-sb>. B<False>:
@@ -694,8 +796,8 @@
 =item B<scrollWithBuffer:> I<boolean>
 
 B<True>: scroll with scrollback buffer when tty receives new lines (and
-B<scrollTtyOutput> is False); option B<+sw>. B<False>: do not scroll
-with scrollback buffer when tty recieves new lines; option B<-sw>.
+B<scrollTtyOutput> is False); option B<-sw>. B<False>: do not scroll
+with scrollback buffer when tty recieves new lines; option B<+sw>.
 
 =item B<scrollTtyKeypress:> I<boolean>
 
@@ -770,7 +872,8 @@
 
 =item B<pointerBlankDelay:> I<number>
 
-Specifies number of seconds before blanking the pointer [default 2].
+Specifies number of seconds before blanking the pointer [default 2]. Use a
+large number (e.g. C<987654321>) to effectively disable the timeout.
 
 =item B<backspacekey:> I<string>
 
@@ -805,7 +908,7 @@
 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>
 
@@ -820,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<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
 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<modifier:> I<modifier>
 
@@ -858,6 +963,13 @@
 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
@@ -912,6 +1024,32 @@
 
   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
+mappings themselves.
+
+Unfortunately, this will override built-in key mappings. For example
+if you overwrite the C<Insert> key you will disable @@RXVT_NAME@@'s
+C<Shift-Insert> mapping. To re-enable that, you can poke "holes" into the
+user-defined keymap using the C<builtin:> replacement:
+
+  URxvt.keysym.Insert: <my insert key sequence>
+  URxvt.keysym.S-Insert: builtin:
+
+The first line defines a mapping for C<Insert> and I<any> combination
+of modifiers. The second line re-establishes the default mapping for
+C<Shift-Insert>.
+
 The following example will map Control-Meta-1 and Control-Meta-2 to
 the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited
 font-switching at runtime:
@@ -925,6 +1063,28 @@
   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. If this resource
+is empty or missing, then the perl interpreter will not be initialized;
+option B<-pe>.
+
+=item B<perl-eval>: I<string>
+
+Perl code to be evaluated when all extensions have been registered. See the
+@@RXVT_NAME@@perl(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 @@RXVT_NAME@@perl(3) manpage.
+
 =back
 
 =head1 THE SCROLLBAR
@@ -968,8 +1128,10 @@
 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
-one.
+(Compile: I<frills>) 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<Insertion>:
 
@@ -987,7 +1149,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.
 
@@ -1136,8 +1298,8 @@
 C<default> to indicate that the default-colour escape sequence is to be
 used), C<bg> is the colour code used as default background colour (or the
 string C<default>), and C<xpm> is the string C<default> if @@RXVT_NAME@@
-was compiled with XPM support. Libraries like C<slang> can (and do) use
-this information to optimize screen output.
+was compiled with XPM support. Libraries like C<ncurses> and C<slang> can
+(and do) use this information to optimize screen output.
 
 =item B<WINDOWID>
 
@@ -1173,7 +1335,7 @@
 The unix domain socket path used by @@RXVT_NAME@@c(1) and
 @@RXVT_NAME@@d(1).
 
-Default C<< $HOME/.rxvt-unicode-<nodename >>.
+Default F<<< $HOME/.rxvt-unicode-I<< <nodename >> >>>.
 
 =item B<HOME>
 
@@ -1204,15 +1366,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
 
@@ -1220,9 +1374,9 @@
 
 =item Project Coordinator
 
-@@RXVT_MAINT@@ L<@@RXVT_MAINTEMAIL@@>
+Marc A. Lehmann L<< <rxvt-unicode@schmorp.de> >>
 
-L<@@RXVT_WEBPAGE@@>
+L<http://software.schmorp.de/#rxvt-unicode>
 
 =back
 
@@ -1257,7 +1411,7 @@
 Rewrote screen display and text selection routines. Project Coordinator
 (changes.txt 2.4.6 - rxvt-unicode)
 
-=item Marc Alexander Lehmann L<< <rxvt@schmorp.de> >>
+=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >>
 
 Forked rxvt-unicode, rewrote most of the display code and internal
 character handling to store text in unicode, improve xterm