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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.94 by root, Thu Jan 12 05:37:34 2006 UTC vs.
Revision 1.108 by root, Sun Jan 29 21:45:47 2006 UTC

 Attempt to open a window on the named X display (B<-d> still
 respected). In the absence of this option, the display specified by the
 B<DISPLAY> environment variable is used.
+=item B<-depth> I<bitdepth>
+Compile I<frills>: Attempt to find a visual with the given bit depth;
+resource B<depth>.
 =item B<-geometry> I<geom>
 Window geometry (B<-g> still respected); resource B<geometry>.
 =item B<-rv>|B<+rv>
 resource B<borderColor>.
 =item B<-fn> I<fontlist>
 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
+that are checked in order when trying to find glyphs for characters. The
 first font defines the cell size for characters; other fonts might be
 smaller, but not (in general) larger. A (hopefully) reasonable default
 font list is always appended to it. See resource B<font> for more details.
 In short, to specify an X11 core font, just specify it's name or prefix it
 =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<-override-redirect>
+Compile I<frills>: Sets override-redirect on the window; resource
+B<override-redirect>.
 =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
 check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
 extensions not documented here):
 =over 4
+=item B<depth:> I<bitdepth>
+Compile I<frills>: Attempt to find a visual with the given bit depth;
+option B<-depth>.
 =item B<geometry:> I<geom>
 Create the window with the specified X window geometry [default 80x24];
 option B<-geometry>.
 of 1 displays the image without any scaling. A scale of 2 to 9
 specifies an integer number of images in that direction. No image will
 be magnified beyond 10 times its original size. The maximum permitted
 scale is 1000. [default 0x0+50+50]
-=item B<menu:> I<file[;tag]>
-Read in the specified menu file (note the `.menu' extension is
-optional) and also optionally specify a starting tag to find. See the
-reference documentation for details on the syntax for the menuBar.
 =item B<path:> I<path>
-Specify the colon-delimited search path for finding files (XPM and
+Specify the colon-delimited search path for finding XPM files.
-menus), in addition to the paths specified by the B<RXVTPATH> and
-B<PATH> environment variables.
 =item B<font:> I<fontlist>
-Select the fonts to be used. This is a comma separated list of font
+Select the fonts to be used. This is a comma separated list of font names
-names that are used in turn when trying to display Unicode characters.
+that are checked in order when trying to find glyphs for characters. The
-The first font defines the cell size for characters; other fonts might
+first font defines the cell size for characters; other fonts might be
-be smaller, but not larger. A reasonable default font list is always
+smaller, but not (in general) larger. A (hopefully) reasonable default
-appended to it; option B<-fn>.
+font list is always 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
 hint currently is C<codeset=codeset-name>, and this is only used for Xft
 fonts.
 For example, this font resource
-   URxvt*font: 9x15bold,\
+   URxvt.font: 9x15bold,\
                -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
                -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
                [codeset=JISX0208]xft:Kochi Gothic:antialias=false, \
                xft:Code2000:antialias=false
 The string will be interpreted as if typed into the shell as-is.
 Example:
-   URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
+   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>
 pressed. If unset it will send the sequence traditionally associated
 with the B<Execute> key.
 =item B<cutchars:> I<string>
-The characters used as delimiters for double-click word selection. The
+The characters used as delimiters for double-click word selection
-built-in default:
+(whitespace delimiting is added automatically if resource is given).
+When the selection extension is in use (the default if compiled in, see
+the @@RXVT_NAME@@perl(3) manpage), a suitable regex using these characters
+will be created (if the resource exists, otherwise, no regex 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 `"'&()*,;<=>?@[]{|} >>
 =item B<preeditType:> I<style>
 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
+locale, findfont, icon label and window title requests.
-menubar dispatch.
 =item B<modifier:> I<modifier>
 Set the key to be interpreted as the Meta key to: B<alt>, B<meta>,
 B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option
 Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
 character is passed through. It may contain escape values as described
 in the entry on B<keysym> following.
-=item B<secondaryScreen:> I<bool>
+=item B<secondaryScreen:> I<boolean>
 Turn on/off secondary screen (default enabled).
-=item B<secondaryScroll:> I<bool>
+=item B<secondaryScroll:> I<boolean>
 Turn on/off secondary screen scroll (default enabled). If the this
 option is enabled, scrolls on the secondary screen will change the
 scrollback buffer and switching to/from the secondary screen will
 instead scroll the screen up.
-=item B<hold>: I<bool>
+=item B<hold>: I<boolean>
 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.
 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.
+=item B<< selection.pattern-I<idx> >>: I<perl-regex>
+Additional selection patterns, see the @@RXVT_NAME@@perl(3) manpage for
+details.
+=item B<< selection-autotransform.I<idx> >>: I<perl-transform>
+Selection auto-transform patterns, see the @@RXVT_NAME@@perl(3) manpage
+for details.
 =item B<searchable-scrollback:> I<keysym>
 Sets the hotkey that starts the incremental scrollback buffer search
 (default: C<M-s>).
 Specifies the program to be started with a URL argument. Used by the
 C<selection-popup> and C<mark-urls> perl extensions.
 =item B<transient-for>: I<windowid>
-Sets the WM_TRANSIENT_FOR property to the given window iw.
+Compile I<frills>: Sets the WM_TRANSIENT_FOR property to the given window id.
+=item B<override-redirect>: I<boolean>
+Compile I<frills>: Sets override-redirect for the terminal window, making
+it almost invisible to window managers; option B<-override-redirect>.
 =back
 =head1 THE SCROLLBAR
 selection, and trailing whitespace is visually underlined and removed from
 the selection.
 =item B<Insertion>:
-Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in
+Pressing and releasing the Middle mouse button in an B<@@RXVT_NAME@@>
-an B<@@RXVT_NAME@@> window causes the current text selection to be
+window causes the value of the PRIMARY selection (or CLIPBOARD with the
-inserted as if it had been typed on the keyboard.
+Meta modifier) to be inserted as if it had been typed on the keyboard.
+Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be
+inserted too.
 =back
 =head1 CHANGING FONTS
 Changing fonts (or font sizes, respectively) via the keypad is not yet
 supported in rxvt-unicode. Bug me if you need this.
-You can, however, switch fonts at runtime using escape sequences (and
+You can, however, switch fonts at runtime using escape sequences, e.g.:
-therefore using the menubar), e.g.:
    printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"
+You can use keyboard shortcuts, too:
+   URxvt.keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
+   URxvt.keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
 rxvt-unicode will automatically re-apply these fonts to the output so far.
 =head1 ISO 14755 SUPPORT
 =head1 COLORS AND GRAPHICS
 In addition to the default foreground and background colours,
 B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus
 high-intensity bold/blink versions of the same). Here is a list of the
-colours with their B<rgb.txt> names.
+colours with their names.
 =begin table
 	B<color0>	(black)	= Black
 	B<color1>	(red)	= Red3
 It is also possible to specify the colour values of B<foreground>,
 B<background>, B<cursorColor>, B<cursorColor2>, B<colorBD>, B<colorUL> as
 a number 0-15, as a convenient shorthand to reference the colour name of
 color0-color15.
+If Xft support has been compiled in and as long as Xft/Xrender/X don't get
+their act together, rxvt-unicode will support C<rgba:rrrr/gggg/bbbb/aaaa>
+(recommended, but B<MUST> have 4 digits/component), C<#ARGB>, C<#AARRGGBB>
+and C<#AAAARRRRGGGGBBBB> colour specifications, in addition to the ones
+provided by X, where the additional A component specifies alpha (opacity)
+values (0 is completely transparent and the maximum is opaque). You
+probably need to specify B<"-depth 32">, too, and have the luck that your
+X-server uses ARGB pixel layout, as X is far from just supporting ARGB
+visuals out of the box, and rxvt-unicode just fudges around.
 Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by
 always swapping the foreground/background colours. This is in contrast to
 I<xterm>(1) where the colours are only swapped if they have not otherwise
 been specified. For example,
 =item B<SHELL>
 The shell to be used for command execution, defaults to C</bin/sh>.
-=item B<RXVTPATH>
-The path where @@RXVT_NAME@@ looks for support files such as menu and xpm
-files.
-=item B<PATH>
-Used in the same way as C<RXVTPATH>.
 =item B<RXVT_SOCKET>
 The unix domain socket path used by @@RXVT_NAME@@c(1) and
 @@RXVT_NAME@@d(1).
 Project Coordinator (changes.txt 2.21a to 2.4.5)
 =item Geoff Wing L<< <gcw@pobox.com> >>
-Rewrote screen display and text selection routines. Project Coordinator
+Rewrote screen display and text selection routines.
-(changes.txt 2.4.6 - rxvt-unicode)
+Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)
 =item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >>
-Forked rxvt-unicode, rewrote most of the display code and internal
+Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
-character handling to store text in unicode, improve xterm
+extension, random hacks, numerous bugfixes and extensions.
-compatibility and apply numerous other bugfixes and extensions.
 Project Coordinator (Changes 1.0 -)
+=item Emanuele Giaquinta L<< <e.giaquinta@glauco.it> >>
+Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
 =back

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents): Revision 1.94 by root, Thu Jan 12 05:37:34 2006 UTC vs. Revision 1.108 by root, Sun Jan 29 21:45:47 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.94 by root, Thu Jan 12 05:37:34 2006 UTC vs.
Revision 1.108 by root, Sun Jan 29 21:45:47 2006 UTC