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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.144 by sasha, Thu Nov 15 18:40:10 2007 UTC vs.
Revision 1.152 by root, Wed Dec 12 19:56:37 2007 UTC

 =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
 Unlike the original rxvt, B<rxvt-unicode> stores all text in Unicode
 internally. That means it can store and display most scripts in the
 like mongolian or scripts requiring extremely complex combining rules,
 like tibetan or devanagari. Don't expect pretty output when using these
 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.
 If you are looking for a terminal that supports more exotic scripts, let
 me recommend C<mlterm>, which is a very user friendly, lean and clean
 Turn on/off skip scrolling (allow multiple screens per refresh); resource B<skipScroll>.
 =item B<-tr>|B<+tr>
-Turn on/off illusion of a transparent window background. Obsolete form of it is
+Turn on/off illusion of a transparent window background; resource B<transparent>.
-B<-ip> and it should not be used anymore; resource B<transparent>.
-I<Please note that old resource name of B<inheritPixmap> is obsolete and should be
+B<-ip> is still accepted as an obsolete alias but will be removed in
-changed to B<transparent>. Backwards compatibility support for B<inheritPixmap> will
+future versions.
-be phased out in future versions of rxvt!>
 I<Please address all transparency related issues to Sasha Vasko at
 sasha@aftercode.net. Read the FAQ (man 7 @@RXVT_NAME@@)!>
 =item B<-fade> I<number>
 =item B<-tcw>
 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
+in-use. Instead of selecting a full line it will extend the selection to
-end of the logical line only. resource B<tripleclickwords>.
+the end of the logical line only. resource B<tripleclickwords>.
 =item B<-insecure>
 Enable "insecure" mode, which currently enables most of the escape
 sequences that echo strings. See the resource B<insecure> for more
 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<-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>.
 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.
+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>):
    use IO::Pty;
 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)
+=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
 starts. @@RXVT_NAME@@ will consult the following files/resources in order,
 with later settings overwriting earlier ones:
   1. system-wide app-defaults file, either locale-dependent OR global
   2. app-defaults file in $XAPPLRESDIR
   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
 common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be easily
 configured, while the class name B<URxvt> allows resources unique to
 B<False>: specify that everything is to be displayed, even
 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
+Turn on/off illusion of a transparent window background.
-artificial transparency. B<False>: do not inherit the parent windows'
-pixmap.
-I<Please note that transparency of any kind if completely unsupported by
+B<inheritPixmap> is still accepted as an obsolete alias but will be removed in
-the author. Don't bug him with installation questions!>
+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>
 Fade the text by the given percentage when focus is lost; option B<-fade>.
 The colour of the border around the text area and between the scrollbar
 and the text.
 =item B<backgroundPixmap:> I<file[;geom[:op1][:op2][...]]>
-Use the specified image file for the background and also optionally
+Use the specified image file for the background and also
-specify its scaling with a geometry string B<WxH+X+Y>,
+optionally specify its scaling with a geometry string B<WxH+X+Y>,
-in which B<"W" / "H"> specify the horizontal/vertical scale (percent),
+(default C<0x0+50+50>) in which B<"W" / "H"> specify the
-and B<"X" / "Y"> locate the image centre (percent).
+horizontal/vertical scale (percent), and B<"X" / "Y"> locate the image
-A scale of 0 displays the image with tiling. A scale of 1 displays the
+centre (percent).  A scale of 0 displays the image with tiling. A scale
-image without any scaling. A scale of 2 to 9 specifies an integer
+of 1 displays the image without any scaling. A scale of 2 to 9 specifies
-number of images in that direction. No image will be magnified beyond
+an integer number of images in that direction. No image will be magnified
-10 times its original size. The maximum permitted scale is 1000.
+beyond 10 times its original size. The maximum permitted scale is 1000.
 Additional operations can be specified after colon B<:op1:op2...>.
 Supported operations are:
-  B<"tile"> - force background image to be tiled and not scaled. Equivalent to 0x0,
+  tile        force background image to be tiled and not scaled. Equivalent to 0x0,
-  B<"propscale"> - will scale image keeping proportions,
+  propscale   will scale image keeping proportions,
-  B<"auto"> - will scale image to match window size. Equivalent to 100x100;
+  auto        will scale image to match window size. Equivalent to 100x100;
-  B<"hscale"> - will scale image horizontally to the window size;
+  hscale      will scale image horizontally to the window size;
-  B<"vscale"> - will scale image vertically to the window size;
+  vscale      will scale image vertically to the window size;
-  B<"scale"> - will scale image to match window size;
+  scale       will scale image to match window size;
-  B<"root"> - will tile image as if it was a root window background, auto-adjusting
+  root        will tile image as if it was a root window background, auto-adjusting
-    whenever terminal window moves.
+              whenever terminal window moves.
-If used in conjunction with B<-tr> option - specified pixmap will be
+If used in conjunction with B<-tr> option, the specified pixmap will be
 blended over transparency image using either alpha-blending, or any
 other blending type, specified with B<-blt "type"> option.
-[default 0x0+50+50]
 =item B<path:> I<path>
 Specify the colon-delimited search path for finding background image files.
 will be created). In this mode, characters outside ISO-8859-1 can be used.
 When the selection extension is not used, only ISO-8859-1 characters can
 be used. If not specified, the built-in default is used:
-B<< BACKSLASH `"'&()*,;<=>?@[]{|} >>
+B<< BACKSLASH `"'&()*,;<=>?@[]^{|} >>
 =item B<preeditType:> I<style>
 B<OverTheSpot>, B<OffTheSpot>, B<Root>; option B<-pt>.

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents): Revision 1.144 by sasha, Thu Nov 15 18:40:10 2007 UTC vs. Revision 1.152 by root, Wed Dec 12 19:56:37 2007 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.144 by sasha, Thu Nov 15 18:40:10 2007 UTC vs.
Revision 1.152 by root, Wed Dec 12 19:56:37 2007 UTC