This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting all escape sequences, and other background information.
-The newest version of this document is -also available on the World Wide Web at +
The newest version of this document is also available on the World Wide Web at http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html.
+ URxvt.selection.pattern-0: ([[:word:]]+)+
If you click more than twice, the selection will be extended +more and more.
+To get a selection that is very similar to the old code, try this pattern:
+
+ URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+)
+Please also note that the LeftClick Shift-LeftClik combination also +selects words like the old code.
+If you only want to disable specific features, you first have to
+identify which perl extension is responsible. For this, read the section
+PREPACKAGED EXTENSIONS in the rxvtperl(3) manpage. For
+example, to disable the selection-popup and option-popup, specify
+this perl-ext-common resource:
+ URxvt.perl-ext-common: default,-selection-popup,-option-popup+
This will keep the default extensions, but disable the two popup +extensions. Some extensions can also be configured, for example, +scrollback search mode is triggered by M-s. You can move it to any +other combination either by setting the searchable-scrollback resource:
++ URxvt.searchable-scrollback: CM-s+
If you have or use an $HOME/.Xresources file, chances are that +resources are loaded into your X-server. In this case, you have to +re-login after every change (or run xrdb -merge $HOME/.Xresources).
+Also consider the form resources have to use:
++ URxvt.resource: value+
If you want to use another form (there are lots of different ways of +specifying resources), make sure you understand wether and why it +works. If unsure, use the form above.
+Here are four ways to get transparency. Do read the manpage and option +descriptions for the programs mentioned and rxvt-unicode. Really, do it!
+1. Use inheritPixmap:
++ Esetroot wallpaper.jpg + rxvt -ip -tint red -sh 40+
That works. If you think it doesn't, you lack transparency and tinting +support, or you are unable to read.
+2. Use a simple pixmap and emulate pseudo-transparency. This enables you +to use effects other than tinting and shading: Just shade/tint/whatever +your picture with gimp:
++ convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm + rxvt -pixmap background.xpm -pe automove-background+
That works. If you think it doesn't, you lack XPM and Perl support, or you +are unable to read.
+3. Use an ARGB visual:
++ rxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc+
This requires XFT support, and the support of your X-server. If that +doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't +there yet, no matter what they claim. Rxvt-Unicode contains the neccessary +bugfixes and workarounds for Xft and Xlib to make it work, but that +doesn't mean that your WM has the required kludges in place.
+4. Use xcompmgr and let it do the job:
++ xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \ + -set _NET_WM_WINDOW_OPACITY 0xc0000000+
Then click on a window you want to make transparent. Replace 0xc0000000
+by other values to change the degree of opacity. If it doesn't work and
+your server crashes, you got to keep the pieces.
Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this still fares rather well. And compared to some monsters like gnome-terminal (21152k + extra 4204k in separate processes) or konsole (22200k + extra -43180k in daemons that stay around after exit, plus half aminute of +43180k in daemons that stay around after exit, plus half a minute of startup time, including the hundreds of warnings it spits out), it fares extremely well *g*.
Gtk2::URxvt perl
-module, which features a tabbed urxvt (murxvt) terminal as an example
-embedding application.
+Beginning with version 7.3, there is a perl extension that implements a
+simple tabbed terminal. It is installed by default, so any of these should
+give you tabs:
++ rxvt -pe tabbed+
+ URxvt.perl-ext-common: default,tabbed+
It will also work fine with tabbing functionality of many window managers
+or similar tabbing programs, and its embedding-features allow it to be
+embedded into other programs, as witnessed by doc/rxvt-tabbed or
+the upcoming Gtk2::URxvt perl module, which features a tabbed urxvt
+(murxvt) terminal as an example embedding application.
reportbug to report
-the bug).
+patches that considerably change the behaviour of rxvt-unicode (but
+unfortunately this notice has been removed). Before reporting a bug to
+the original rxvt-unicode author please download and install the genuine
+version (http://software.schmorp.de#rxvt-unicode) and try to reproduce
+the problem. If you cannot, chances are that the problems are specific to
+Debian GNU/Linux, in which case it should be reported via the Debian Bug
+Tracking System (use reportbug to report the bug).
For other problems that also affect the Debian package, you can and @@ -210,6 +360,52 @@ might encounter the same issue.
You should not overwrite the perl-ext-common snd perl-ext resources
+system-wide (except maybe with defaults). This will result in useful
+behaviour. If your distribution aims at low memory, add an empty
+perl-ext-common resource to the app-defaults file. This will keep the
+perl interpreter disabled until the user enables it.
If you can/want build more binaries, I recommend building a minimal
+one with --disable-everything (very useful) and a maximal one with
+--enable-everything (less useful, it will be very big due to a lot of
+encodings built-in that increase download times and are rarely used).
When rxvt-unicode detects that it runs setuid or setgid, it will fork +into a helper process for privileged operations (pty handling on some +systems, utmp/wtmp/lastlog handling on others) and drop privileges +immediately. This is much safer than most other terminals that keep +privileges while running (but is more relevant to urxvt, as it contains +things as perl interpreters, which might be ``helpful'' to attackers).
+This forking is done as the very first within main(), which is very early +and reduces possible bugs to initialisation code run before main(), or +things like the dynamic loader of your system, which should result in very +little risk.
+- URxvt*imlocale: ja_JP.EUC-JP+ URxvt.imlocale: ja_JP.EUC-JP
Now you can start your terminal with LC_CTYPE=ja_JP.UTF-8 and still
@@ -804,7 +1000,7 @@
some editors prematurely may leave the mouse in mouse report mode. I've
heard that tcsh may use mouse reporting unless it otherwise specified. A
quick check is to see if cut/paste works when the Alt or Shift keys are
-depressed. See rxvt(7)
+depressed.
Toggle with ESC [ 36 h / ESC [ 36 l as documented in rxvt(7).
Toggle with ESC [ 36 h / ESC [ 36 l.
For an existing rxvt-unicode:
@@ -1092,8 +1288,8 @@The rest of this document describes various technical aspects of
rxvt-unicode. First the description of supported command sequences,
-followed by menu and pixmap support and last by a description of all
-features selectable at configure time.
configure time.
| h | Send Mouse X & Y on button press. |
| l | No mouse reporting. |
Ps = 10 > (rxvt)| h | menuBar visible |
| l | menuBar invisible |
Ps = 25 >| Ps = 12 | Change colour of text cursor foreground to Pt |
| Ps = 13 | Change colour of mouse foreground to Pt |
| Ps = 17 | Change colour of highlight characters to Pt |
| Ps = 18 | Change colour of bold characters to Pt |
| Ps = 19 | Change colour of underlined characters to Pt |
| Ps = 20 | Change default background to Pt |
| Ps = 18 | Change colour of bold characters to Pt [deprecated, see 706] |
| Ps = 19 | Change colour of underlined characters to Pt [deprecated, see 707] |
| Ps = 20 | Change background pixmap parameters (see section XPM) (Compile XPM). |
| Ps = 39 | Change default foreground colour to Pt. |
| Ps = 46 | Change Log File to Pt unimplemented |
| Ps = 49 | Change default background colour to Pt. |
| Ps = 50 | Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n |
| Ps = 55 | Log all scrollback buffer and all of screen to Pt |
| Ps = 701 | Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). |
| Ps = 703 | Menubar command Pt (Compile menubar). |
| Ps = 702 | Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST. |
| Ps = 704 | Change colour of italic characters to Pt |
| Ps = 705 | Change background pixmap tint colour to Pt (Compile transparency). |
| Ps = 706 | Change colour of bold characters to Pt |
| Ps = 707 | Change colour of underlined characters to Pt |
| Ps = 710 | Set normal fontset to Pt. Same as Ps = 50. |
| Ps = 711 | Set bold fontset to Pt. Similar to Ps = 50 (Compile styles). |
| Ps = 712 | Set italic fontset to Pt. Similar to Ps = 50 (Compile styles). |