--- rxvt-unicode/doc/rxvt.1.pod	2007/11/19 09:41:09	1.146
+++ rxvt-unicode/doc/rxvt.1.pod	2007/12/12 19:57:13	1.153
@@ -14,12 +14,15 @@
 configurability. As a result, B<rxvt-unicode> uses much less swap space --
 a significant advantage on a machine serving many X sessions.
 
+This document is also available on the World-Wide-Web at
+L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod>.
+
 =head1 FREQUENTLY ASKED QUESTIONS
 
 See @@RXVT_NAME@@(7) (try C<man 7 @@RXVT_NAME@@>) for a list of
 frequently asked questions and answer to them and some common
 problems. That document is also accessible on the World-Wide-Web at
-L<http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html>.
+L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod>.
 
 =head1 RXVT-UNICODE VS. RXVT
 
@@ -32,7 +35,7 @@
 scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work
 fine, though. A somewhat difficult case are right-to-left scripts, such
 as hebrew: B<rxvt-unicode> adopts the view that bidirectional algorithms
-belong into the application, not the terminal emulator (too many things --
+belong in the application, not the terminal emulator (too many things --
 such as cursor-movement while editing -- break otherwise), but that might
 change.
 
@@ -118,12 +121,10 @@
 
 =item B<-tr>|B<+tr>
 
-Turn on/off illusion of a transparent window background. Obsolete form of it is
-B<-ip> and it should not be used anymore; resource B<transparent>.
+Turn on/off illusion of a transparent window background; resource B<transparent>.
 
-I<Please note that old resource name of B<inheritPixmap> is obsolete and should be
-changed to B<transparent>. Backwards compatibility support for B<inheritPixmap> will
-be phased out in future versions of rxvt!>
+B<-ip> is still accepted as an obsolete alias but will be removed in
+future versions.
 
 I<Please address all transparency related issues to Sasha Vasko at
 sasha@aftercode.net. Read the FAQ (man 7 @@RXVT_NAME@@)!>
@@ -419,8 +420,8 @@
 
 Change the meaning of triple-click selection with the left mouse
 button. Only effective when the original (non-perl) selection code is
-in-use. Instead of selecting a full line it will extend the selection the
-end of the logical line only. resource B<tripleclickwords>.
+in-use. Instead of selecting a full line it will extend the selection to
+the end of the logical line only. resource B<tripleclickwords>.
 
 =item B<-insecure>
 
@@ -451,6 +452,19 @@
 it exits. Instead, it will wait till it is being killed or closed by the
 user; resource B<hold>.
 
+=item B<-xrm> I<string>
+
+Works like the X Toolkit option of the same name, by adding the I<string>
+as if it were specified in a resource file. Resource values specified this
+way take precedence over all other resource specifications.
+
+Note that you need to use the I<same> syntax as in the .Xdefaults file,
+e.g. C<*.background: black>. Also note that all @@RXVT_NAME@@-specific
+options can be specified as long-options on the commandline, so use
+of B<-xrm> is mostly limited to cases where you want to specify other
+resources (e.g. for input methods) or for compatibility with other
+programs.
+
 =item B<-keysym.>I<sym> I<string>
 
 Remap a key symbol. See resource B<keysym>.
@@ -494,7 +508,8 @@
 yourself if you want that.
 
 As an extremely special case, specifying C<-1> will completely suppress
-pty/tty operations.
+pty/tty operations, which is probably only useful in conjunction with some
+perl extension that manages the terminal.
 
 Here is a example in perl that illustrates how this option can be used (a
 longer example is in F<doc/pty-fd>):
@@ -518,10 +533,11 @@
 
 =back
 
-=head1 RESOURCES (available also as long-options)
+=head1 RESOURCES
 
 Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long
-options) compiled into your version.
+options) compiled into your version. All resources are also available as
+long-options.
 
 You can set and change the resources using X11 tools like B<xrdb>. Many
 distribution do also load settings from the B<~/.Xresources> file when X
@@ -533,6 +549,7 @@
   3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults
   4. SCREEN_RESOURCES for the current screen
   5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename>
+  6. resources specified via -xrm on the commandline
 
 Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two class
 names: B<Rxvt> and B<URxvt>. The class name B<Rxvt> allows resources
@@ -644,14 +661,15 @@
 if the refresh is too fast for the human eye to read anything (or the
 monitor to display anything); option B<+ss>.
 
-=item B<inheritPixmap:> I<boolean>
+=item B<transparent:> I<boolean>
 
-B<True>: make the background inherit the parent windows' pixmap, giving
-artificial transparency. B<False>: do not inherit the parent windows'
-pixmap.
+Turn on/off illusion of a transparent window background.
 
-I<Please note that transparency of any kind if completely unsupported by
-the author. Don't bug him with installation questions!>
+B<inheritPixmap> is still accepted as an obsolete alias but will be removed in
+future versions.
+
+I<Please address all transparency related issues to Sasha Vasko at
+sasha@aftercode.net. Read the FAQ (man 7 @@RXVT_NAME@@)!>
 
 =item B<fading:> I<number>