--- rxvt-unicode/doc/rxvt.1.html 2006/01/02 21:41:51 1.32
+++ rxvt-unicode/doc/rxvt.1.html 2006/01/29 22:38:43 1.55
@@ -48,7 +48,7 @@
-rxvt-unicode, version 6.2, is a colour vt102 terminal
+
rxvt-unicode, version 7.4, is a colour vt102 terminal
emulator intended as an xterm(1) replacement for users who do not
require features such as Tektronix 4014 emulation and toolkit-style
configurability. As a result, rxvt-unicode uses much less swap space --
@@ -133,6 +133,13 @@
DISPLAY environment variable is used.
+-depth bitdepth
+
+
+Compile xft: Attempt to find a visual with the given bit depth;
+resource depth.
+
+
-geometry geom
@@ -157,6 +164,10 @@
Turn on/off inheriting parent window's pixmap. Alternative form is
-tr; resource inheritPixmap.
+
+Please note that transparency of any kind if completely unsupported by
+the author. Don't bug him with installation questions!
+
-fade number
@@ -170,7 +181,7 @@
Fade to this colour when fading is used (see -fade). The default colour
-is black. resource fadeColor.
+is opaque black. resource fadeColor.
-tint colour
@@ -245,7 +256,7 @@
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 font for more details.
@@ -268,28 +279,29 @@
-fb fontlist
-Compile font-styles: The bold font list to use when bold characters are to
-be printed. See resource boldFont for details.
+Compile font-styles: The bold font list to use when bold characters
+are to be printed. See resource boldFont for details.
-fi fontlist
-Compile font-styles: The italic font list to use when bold characters are to
-be printed. See resource italicFont for details.
+Compile font-styles: The italic font list to use when italic
+characters are to be printed. See resource italicFont for details.
-fbi fontlist
-Compile font-styles: The bold italic font list to use when bold characters are to
-be printed. See resource boldItalicFont for details.
+Compile font-styles: The bold italic font list to use when bold
+italic > characters are to be printed. See resource boldItalicFont
+for details.
-is|+is
-Compile font-styles: Bold/Italic font styles imply high intensity
+Compile font-styles: Bold/Italic font styles imply high intensity
foreground/background (default). See resource intensityStyles for
details.
@@ -416,6 +428,22 @@
decorations; resource borderLess.
+-override-redirect
+
+
+Compile frills: Sets override-redirect on the window; resource
+override-redirect.
+
+
+-sbg
+
+
+Compile frills: Disable the usage of the built-in block graphics/line
+drawing characters and just rely on what the specified fonts provide. Use
+this if you have a good font and want to use its block graphic glyphs;
+resource skipBuiltinGlyphs.
+
+
-lsp number
@@ -592,7 +620,7 @@
});
--pty-fd fileno
+-pty-fd file descriptor
Tells rxvt NOT to execute any commands or create a new pty/tty
@@ -606,6 +634,10 @@
yourself if you want that.
+As an extremely special case, specifying -1 will completely suppress
+pty/tty operations.
+
+
Here is a example in perl that illustrates how this option can be used (a
longer example is in doc/pty-fd):
@@ -631,7 +663,8 @@
-pe string
-Colon-separated list of perl extension scripts to use in this terminal instance. See resource perl-ext.
+Comma-separated list of perl extension scripts to use (or not to use) in
+this terminal instance. See resource perl-ext for details.
@@ -640,35 +673,34 @@
Note: `rxvt --help' gives a list of all resources (long
options) compiled into your version.
-There are two different methods that rxvt can use to get the
-Xresource data: using the X libraries (Xrm*-functions) or internal
-Xresources reader (~/.Xdefaults). For the first method (ie.
-rxvt -h lists XGetDefaults), you can set and change the
-resources using X11 tools like xrdb. Many distribution do also load
-settings from the ~/.Xresources file when X starts. rxvt
-will consult the following files/resources in order, with later settings
-overwriting earlier ones:
+You can set and change the resources using X11 tools like xrdb. Many
+distribution do also load settings from the ~/.Xresources file when X
+starts. rxvt 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>
-If compiled with internal Xresources support (i.e. rxvt -h
-lists .Xdefaults) then rxvt accepts application defaults
-set in XAPPLOADDIR/URxvt (compile-time defined: usually
-/usr/lib/X11/app-defaults/URxvt) and resources set in
-~/.Xdefaults, or ~/.Xresources if ~/.Xdefaults does not exist.
-Note that when reading X resources, rxvt recognizes two
-class names: XTerm and URxvt. The class name Rxvt allows
-resources common to both rxvt and the original rxvt to be
-easily configured, while the class name URxvt allows resources
-unique to rxvt, notably colours and key-handling, to be
-shared between different rxvt configurations. If no
-resources are specified, suitable defaults will be used. Command-line
-arguments can be used to override resource settings. The following
-resources are allowed:
+Note that when reading X resources, rxvt recognizes two class
+names: Rxvt and URxvt. The class name Rxvt allows resources
+common to both rxvt and the original rxvt to be easily
+configured, while the class name URxvt allows resources unique to
+rxvt, to be shared between different rxvt
+configurations. If no resources are specified, suitable defaults will
+be used. Command-line arguments can be used to override resource
+settings. The following resources are supported (you might want to
+check the rxvtperl(3) manpage for additional settings by perl
+extensions not documented here):
+- depth: bitdepth
+
+-
+Compile xft: Attempt to find a visual with the given bit depth;
+option -depth.
+
+
- geometry: geom
-
@@ -778,6 +810,10 @@
artificial transparency. False: do not inherit the parent windows'
pixmap.
+-
+
Please note that transparency of any kind if completely unsupported by
+the author. Don't bug him with installation questions!
+
- fading: number
@@ -840,30 +876,20 @@
scale is 1000. [default 0x0+50+50]
-- menu: 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.
-
-
- path: path
-
-Specify the colon-delimited search path for finding files (XPM and
-menus), in addition to the paths specified by the RXVTPATH and
-PATH environment variables.
+Specify the colon-delimited search path for finding XPM files.
- font: 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 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 -fn.
+Select the fonts to be used. This is a comma separated list of font names
+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; option -fn.
-
Each font can either be a standard X11 core font (XLFD) name, with
@@ -880,7 +906,7 @@
-
- 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, \
@@ -1020,7 +1046,7 @@
-
- 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
@@ -1108,6 +1134,15 @@
WM, the rxvt-unicode window will not have window decorations; option -bl.
+- skipBuiltinGlyphs: boolean
+
+-
+Compile frills: Disable the usage of the built-in block graphics/line
+drawing characters and just rely on what the specified fonts provide. Use
+this if you have a good font and want to use its block graphic glyphs;
+option -sbg.
+
+
- termName: termname
-
@@ -1197,8 +1232,18 @@
- cutchars: string
-
-The characters used as delimiters for double-click word selection. The
-built-in default:
+The characters used as delimiters for double-click word selection
+(whitespace delimiting is added automatically if resource is given).
+
+-
+
When the selection extension is in use (the default if compiled in, see
+the rxvtperl(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:
-
BACKSLASH ```'&()*,;<=?@[]{|} >>
@@ -1258,8 +1303,7 @@
-
You can enable them by setting this boolean resource or specifying
-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.
+locale, findfont, icon label and window title requests.
- modifier: modifier
@@ -1278,13 +1322,13 @@
in the entry on keysym following.
-- secondaryScreen: bool
+- secondaryScreen: boolean
-
Turn on/off secondary screen (default enabled).
-- secondaryScroll: bool
+- secondaryScroll: boolean
-
Turn on/off secondary screen scroll (default enabled). If the this
@@ -1293,7 +1337,7 @@
instead scroll the screen up.
-- hold: bool
+- hold: boolean
-
Turn on/off hold window after exit support. If enabled, rxvt
@@ -1336,10 +1380,10 @@
can start or end with whitespace.
-
-
Please note that you need to double the \ when using
---enable-xgetdefault, as X itself does it's own de-escaping (you can
-use \033 instead of \e (and so on), which will work with both Xt and
-rxvt's own processing).
+Please note that you need to double the \ in resource files, as
+Xlib itself does it's own de-escaping (you can use \033 instead of
+\e (and so on), which will work with both Xt and rxvt's own
+processing).
-
You can define a range of keysyms in one shot by providing a string
@@ -1426,19 +1470,45 @@
URxvt.keysym.M-C-4: command:\033[8;48;110t
+- perl-ext-common: string
+
- perl-ext: 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; option -pe.
+Comma-separated
list(s) of perl extension scripts (default: default) to
+use in this terminal instance; option -pe.
+
+-
+
Extension names can be prefixed with a - sign to prohibit using
+them. This can be useful to selectively disable some extensions loaded
+by default, or specified via the perl-ext-common resource. For
+example, default,-selection will use all the default extension except
+selection.
+
+-
+
Extension names can also be followed by an argument in angle brackets
+(e.g. searchable-scrollback<M-s>, which binds the hotkey for
+searchable scorllback to Alt/Meta-s). Mentioning the same extension
+multiple times with different arguments will pass multiple arguments to
+the extension.
+
+-
+
Each extension is looked up in the library directories, loaded if
+necessary, and bound to the current terminal instance.
+
+-
+
If both of these resources are the empty string, then the perl
+interpreter will not be initialized. The idea behind two options is that
+perl-ext-common will be used for extensions that should be available to
+all instances, while perl-ext is used for specific instances.
- perl-eval: string
-
-Perl code to be evaluated when all extensions have been registered. See the
-
rxvtperl(3) manpage.
+Perl code to be evaluated when all extensions have been registered. See
+the rxvtperl(3) manpage. Due to security reasons, this resource
+will be ignored when running setuid/setgid.
- perl-lib: path
@@ -1447,11 +1517,53 @@
Colon-separated list of additional directories that hold extension
scripts. When looking for extensions specified by the perl resource,
rxvt will first look in these directories and then in
-/opt/rxvt/lib/urxvt/perl/.
+/opt/rxvt/lib/urxvt/perl/. Due to security reasons, this resource
+will be ignored when running setuid/setgid.
-
See the rxvtperl(3) manpage.
+
+- selection.pattern-idx >: perl-regex
+
+-
+Additional selection patterns, see the
rxvtperl(3) manpage for
+details.
+
+
+- selection-autotransform.idx >: perl-transform
+
+-
+Selection auto-transform patterns, see the
rxvtperl(3) manpage
+for details.
+
+
+- searchable-scrollback: keysym
+
+-
+Sets the hotkey that starts the incremental scrollback buffer search
+(default:
M-s).
+
+
+- urlLauncher: string
+
+-
+Specifies the program to be started with a URL argument. Used by the
+
selection-popup and mark-urls perl extensions.
+
+
+- transient-for: windowid
+
+-
+Compile frills: Sets the WM_TRANSIENT_FOR property to the given window id.
+
+
+- override-redirect: boolean
+
+-
+Compile frills: Sets override-redirect for the terminal window, making
+it almost invisible to window managers; option -override-redirect.
+
@@ -1505,9 +1617,13 @@
Insertion:
-Pressing and releasing the Middle mouse button (or Shift-Insert) in
-an rxvt window causes the current text selection to be
-inserted as if it had been typed on the keyboard.
+Pressing and releasing the Middle mouse button in an rxvt
+window causes the value of the PRIMARY selection (or CLIPBOARD with the
+Meta modifier) to be inserted as if it had been typed on the keyboard.
+
+
+Pressing Shift-Insert causes the value of the PRIMARY selection to be
+inserted too.
@@ -1516,10 +1632,13 @@
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
-therefore using the menubar), e.g.:
+You can, however, switch fonts at runtime using escape sequences, 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.
@@ -1593,7 +1712,7 @@
In addition to the default foreground and background colours,
rxvt 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 rgb.txt names.
+colours with their names.
| color0 | (black) | = Black |
| color1 | (red) | = Red3 |
@@ -1617,6 +1736,17 @@
background, cursorColor, cursorColor2, colorBD, 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 rgba:rrrr/gggg/bbbb/aaaa
+(recommended, but MUST have 4 digits/component), #ARGB, #AARRGGBB
+and #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 ``-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.
+Please note that transparency of any kind if completely unsupported by
+the author. Don't bug him with installation questions!
Note that -rv (``reverseVideo: True'') simulates reverse video by
always swapping the foreground/background colours. This is in contrast to
xterm(1) where the colours are only swapped if they have not otherwise
@@ -1690,19 +1820,6 @@
The shell to be used for command execution, defaults to /bin/sh.
-RXVTPATH
-
-
-The path where rxvt looks for support files such as menu and xpm
-files.
-
-
-PATH
-
-
-Used in the same way as RXVTPATH.
-
-
RXVT_SOCKET
@@ -1805,20 +1922,30 @@
Geoff Wing >
-Rewrote screen display and text selection routines. Project Coordinator
-(changes.txt 2.4.6 - rxvt-unicode)
+Rewrote screen display and text selection routines.
+
+
+
+
+
+Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)
Marc Alexander Lehmann >
-Forked rxvt-unicode, rewrote most of the display code and internal
-character handling to store text in unicode, improve xterm
-compatibility and apply numerous other bugfixes and extensions.
+Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
+extension, random hacks, numerous bugfixes and extensions.
Project Coordinator (Changes 1.0 -)
+
+Emanuele Giaquinta >
+
+
+Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
+