--- rxvt-unicode/doc/rxvt.7.pod 2009/05/30 08:53:48 1.177 +++ rxvt-unicode/doc/rxvt.7.pod 2016/06/22 07:31:49 1.244 @@ -37,11 +37,10 @@ =head3 I use Gentoo, and I have a problem... -There are three big problems with Gentoo Linux: first of all, most if not -all Gentoo systems are completely broken (missing or mismatched header -files, broken compiler etc. are just the tip of the iceberg); secondly, -the Gentoo maintainer thinks it is a good idea to add broken patches to -the code; and lastly, it should be called Gentoo GNU/Linux. +There are two big problems with Gentoo Linux: first, most if not all +Gentoo systems are completely broken (missing or mismatched header +files, broken compiler etc. are just the tip of the iceberg); +secondly, it should be called Gentoo GNU/Linux. For these reasons, it is impossible to support rxvt-unicode on Gentoo. Problems appearing on Gentoo systems will usually simply be @@ -107,12 +106,13 @@ re-run the command. Subsequent invocations of the script will re-use the existing daemon. -=head3 How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc. +=head3 How do I distinguish whether I'm running rxvt-unicode or a regular +xterm? I need this to decide about setting colours etc. The original rxvt and rxvt-unicode always export the variable "COLORTERM", so you can check and see if that is set. Note that several programs, JED, slrn, Midnight Commander automatically check this variable to decide -whether or not to use color. +whether or not to use colour. =head3 How do I set the correct, full IP address for the DISPLAY variable? @@ -130,12 +130,12 @@ [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know if [ ${TERM:-foo} = xterm ]; then stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not - echo -n '^[Z' + printf "\eZ" read term_id stty icanon echo if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then - echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string - read DISPLAY # set it in our local shell + printf '\e[7n' # query the rxvt we are in for the DISPLAY string + read DISPLAY # set it in our local shell fi fi @@ -200,7 +200,7 @@ domain sockets, which are all less portable than C++ itself. Regarding the bloat, see the above question: It's easy to write programs -in C that use gobs of memory, an certainly possible to write programs in +in C that use gobs of memory, and certainly possible to write programs in C++ that don't. C++ also often comes with large libraries, but this is not necessarily the case with GCC. Here is what rxvt links against on my system with a minimal config: @@ -226,9 +226,10 @@ =head3 I can't get transparency working, what am I doing wrong? -First of all, please address all transparency related issues to Sasha Vasko at -sasha@aftercode.net and do not bug the author about it. Also, if you can't -get it working consider it a rite of passage: ... and you failed. +First of all, transparency isn't officially supported in rxvt-unicode, so +you are mostly on your own. Do not bug the author about it (but you may +bug everybody else). Also, if you can't get it working consider it a rite +of passage: ... and you failed. Here are four ways to get transparency. B read the manpage and option descriptions for the programs mentioned and rxvt-unicode. Really, do it! @@ -240,6 +241,9 @@ That works. If you think it doesn't, you lack transparency and tinting support, or you are unable to read. +This method requires that the background-setting program sets the +_XROOTPMAP_ID or ESETROOT_PMAP_ID property. Compatible programs +are Esetroot, hsetroot and feh. 2. Use a simple pixmap and emulate pseudo-transparency. This enables you to use effects other than tinting and shading: Just shade/tint/whatever @@ -248,7 +252,7 @@ convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg @@URXVT_NAME@@ -pixmap "background.jpg;:root" -That works. If you think it doesn't, you lack AfterImage support, or you +That works. If you think it doesn't, you lack GDK-PixBuf support, or you are unable to read. 3. Use an ARGB visual: @@ -363,15 +367,15 @@ C<--enable-text-blink>, the blink attribute will be ignored. On ANSI colours, bold/blink attributes are used to set high-intensity -foreground/background colors. +foreground/background colours. -color0-7 are the low-intensity colors. +color0-7 are the low-intensity colours. -color8-15 are the corresponding high-intensity colors. +color8-15 are the corresponding high-intensity colours. -=head3 I don't like the screen colors. How do I change them? +=head3 I don't like the screen colours. How do I change them? -You can change the screen colors at run-time using F<~/.Xdefaults> +You can change the screen colours at run-time using F<~/.Xdefaults> resources (or as long-options). Here are values that are supposed to resemble a VGA screen, @@ -395,7 +399,7 @@ URxvt.color14: #00FFFF URxvt.color15: #FFFFFF -And here is a more complete set of non-standard colors. +And here is a more complete set of non-standard colours. URxvt.cursorColor: #dc74d1 URxvt.pointerColor: #dc74d1 @@ -481,6 +485,25 @@ @@URXVT_NAME@@ -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...' +=head3 Why is the cursor now blinking in emacs/vi/...? + +This is likely caused by your editor/program's use of the C +terminfo capability. Emacs uses it by default, as well as some versions of +vi and possibly other programs. + +In emacs, you can switch that off by adding this to your C<.emacs> file: + + (setq visible-cursor nil) + +For other programs, if they do not have an option, your have to remove the +C capability from the terminfo description. + +When @@URXVT_NAME@@ first added the blinking cursor option, it didn't +add a C capability, which served no purpose before. Version 9.21 +introduced C (and the ability to control blinking independent of +cursor shape) for compatibility with other terminals, which traditionally +use a blinking cursor for C. This also reflects the intent of +programs such as emacs, who expect C to enable a blinking cursor. =head2 Keyboard, Mouse & User Interaction @@ -518,9 +541,12 @@ 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 B. You can move it to any -other combination either by setting the B resource: +other combination by adding a B resource that binds the desired +combination to the C action of C and another +one that binds B to the C action: - URxvt.searchable-scrollback: CM-s + URxvt.keysym.CM-s: searchable-scrollback:start + URxvt.keysym.M-s: builtin: =head3 The cursor moves when selecting text in the current input line, how do I switch this off? @@ -539,9 +565,9 @@ URxvt.perl-ext-common: default,-readline -=head3 My numerical keypad acts weird and generates differing output? +=head3 My numeric keypad acts weird and generates differing output? -Some Debian GNUL/Linux users seem to have this problem, although no +Some Debian GNU/Linux users seem to have this problem, although no specific details were reported so far. It is possible that this is caused by the wrong C setting, although the details of whether and how this can happen are unknown, as C should offer a compatible @@ -551,15 +577,19 @@ =head3 My Compose (Multi_key) key is no longer working. The most common causes for this are that either your locale is not set -correctly, or you specified a B that is not supported by +correctly, or you specified a B that is not supported by your input method. For example, if you specified B and your input method (e.g. the default input method handling Compose keys) does not support this (for instance because it is not visual), then rxvt-unicode will continue without an input method. -In this case either do not specify a B or specify more than +In this case either do not specify a B or specify more than one pre-edit style, such as B. +If it still doesn't work, then maybe your input method doesn't support +compose sequences - to fall back to the built-in one, make sure you don't +specify an input method via C<-im> or C. + =head3 I cannot type C to get an ASCII NUL character due to ISO 14755 Either try C alone (it often is mapped to ASCII NUL even on @@ -571,10 +601,10 @@ =head3 Mouse cut/paste suddenly no longer works. Make sure that mouse reporting is actually turned off since killing -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 +some editors prematurely may leave it active. I've +heard that tcsh may use mouse reporting unless it is otherwise specified. A quick check is to see if cut/paste works when the Alt or Shift keys are -depressed. +pressed. =head3 What's with the strange Backspace/Delete key behaviour? @@ -587,33 +617,16 @@ policy of using C<^?> when unsure, because it's the one and only correct choice :). -Rxvt-unicode tries to inherit the current stty settings and uses the value -of `erase' to guess the value for backspace. If rxvt-unicode wasn't -started from a terminal (say, from a menu or by remote shell), then the -system value of `erase', which corresponds to CERASE in , will -be used (which may not be the same as your stty setting). - -For starting a new rxvt-unicode: - - # use Backspace = ^H - $ stty erase ^H - $ @@URXVT_NAME@@ - - # use Backspace = ^? - $ stty erase ^? - $ @@URXVT_NAME@@ - -Toggle with C / C. - -For an existing rxvt-unicode: +It is possible to toggle between C<^H> and C<^?> with the DECBKM +private mode: # use Backspace = ^H $ stty erase ^H - $ echo -n "^[[36h" + $ printf "\e[?67h" # use Backspace = ^? $ stty erase ^? - $ echo -n "^[[36l" + $ printf "\e[?67l" This helps satisfy some of the Backspace discrepancies that occur, but if you use Backspace = C<^H>, make sure that the termcap/terminfo value @@ -640,26 +653,14 @@ Here's an example for a URxvt session started using C<@@URXVT_NAME@@ -name URxvt> - URxvt.keysym.Home: \033[1~ - URxvt.keysym.End: \033[4~ - URxvt.keysym.C-apostrophe: \033 - URxvt.keysym.C-slash: \033 - URxvt.keysym.C-semicolon: \033 - URxvt.keysym.C-grave: \033 - URxvt.keysym.C-comma: \033 - URxvt.keysym.C-period: \033 - URxvt.keysym.C-0x60: \033 - URxvt.keysym.C-Tab: \033 - URxvt.keysym.C-Return: \033 - URxvt.keysym.S-Return: \033 - URxvt.keysym.S-space: \033 - URxvt.keysym.M-Up: \033 - URxvt.keysym.M-Down: \033 - URxvt.keysym.M-Left: \033 - URxvt.keysym.M-Right: \033 - URxvt.keysym.M-C-0: list \033 - URxvt.keysym.M-C-a: list \033 - URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007 + URxvt.keysym.Prior: \033[5~ + URxvt.keysym.Next: \033[6~ + URxvt.keysym.Home: \033[7~ + URxvt.keysym.End: \033[8~ + URxvt.keysym.Up: \033[A + URxvt.keysym.Down: \033[B + URxvt.keysym.Right: \033[C + URxvt.keysym.Left: \033[D See some more examples in the documentation for the B resource. @@ -716,7 +717,7 @@ The selection stuff mainly makes the selection perl-error-message aware and tells it to convert perl error messages into vi-commands to load the -relevant file and go tot he error line number. +relevant file and go to the error line number. URxvt.scrollstyle: plain URxvt.secondaryScroll: true @@ -798,7 +799,7 @@ normal fonts. Please note that I used the C instance name and not the C -class name. Thats because I use different configs for different purposes, +class name. That is because I use different configs for different purposes, for example, my IRC window is started with C<-name IRC>, and uses these defaults: @@ -819,7 +820,7 @@ The above is all in my C<.Xdefaults> (I don't use C<.Xresources> nor C). I also have some resources in a separate C<.Xdefaults-hostname> -file for different hosts, for example, on ym main desktop, I use: +file for different hosts, for example, on my main desktop, I use: URxvt.keysym.C-M-q: command:\033[3;5;5t URxvt.keysym.C-M-y: command:\033[3;5;606t @@ -904,7 +905,7 @@ One reason you might want this is that some distributions or operating systems still compile some programs using the long-obsoleted termcap -library (Fedora Core's bash is one example) and rely on a termcap entry +library (Fedora's bash is one example) and rely on a termcap entry for C. You could use rxvt's termcap entry with reasonable results in many cases. @@ -942,12 +943,11 @@ =head3 Why are the secondary screen-related options not working properly? Make sure you are using C. Some pre-packaged -distributions (most notably Debian GNU/Linux) break rxvt-unicode -by setting C to C, which doesn't have these extra -features. Unfortunately, some of these (most notably, again, Debian -GNU/Linux) furthermore fail to even install the C terminfo -file, so you will need to install it on your own (See the question B on +distributions break rxvt-unicode by setting C to C, which +doesn't have these extra features. Unfortunately, some of these +furthermore fail to even install the C terminfo file, so +you will need to install it on your own (See the question B on how to do this). @@ -1076,8 +1076,6 @@ xprop -root XIM_SERVERS -=item - =back =head3 My input method wants but I want UTF-8, what can I do? @@ -1106,22 +1104,6 @@ =head2 Operating Systems / Package Maintaining -=head3 I am using Debian GNU/Linux and have a problem... - -The Debian GNU/Linux package of rxvt-unicode in sarge contains large -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 (L) 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 C to report the bug). - -For other problems that also affect the Debian package, you can and -probably should use the Debian BTS, too, because, after all, it's also a -bug in the Debian version and it serves as a reminder for other users that -might encounter the same issue. - =head3 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation? You should build one binary with the default options. F @@ -1131,7 +1113,7 @@ be enabled, as important functionality (menus, selection, likely more in the future) depends on it. -You should not overwrite the C snd C resources +You should not overwrite the C and C resources system-wide (except maybe with C). This will result in useful behaviour. If your distribution aims at low memory, add an empty C resource to the app-defaults file. This will keep the @@ -1217,12 +1199,6 @@ http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c -=head3 I want 256 colors - -Are you sure you need 256 colors? 88 colors should be enough for most -purposes. If you really need more, there is an unsupported patch for -it in the doc directory, but please do not ask for it to be applied. - =head1 RXVT-UNICODE TECHNICAL REFERENCE The rest of this document describes various technical aspects of @@ -1236,7 +1212,7 @@ =item B<< C >> -The literal character c. +The literal character c (potentially a multi-byte character). =item B<< C >> @@ -1305,7 +1281,7 @@ Shift In (Ctrl-O), invokes the G0 character set (the default). Switch to Standard Character Set -=item B<< C >> +=item B<< C >> Space Character @@ -1331,13 +1307,13 @@ Application Keypad (SMKX). See also next sequence. -=item B<<< C<< ESC >> >>> +=item B<<< C<< ESC > >> >>> Normal Keypad (RMKX) -B If the numeric keypad is activated, eg, B has been -pressed, numbers or control functions are generated by the numeric keypad -(see Key Codes). +B numbers or control functions are generated by the numeric +keypad in normal or application mode, respectively (see Key Codes). + =item B<< C >> @@ -1405,13 +1381,13 @@ =begin table - C = C<0> DEC Special Character and Line Drawing Set - C = C United Kingdom (UK) - C = C United States (USASCII) + C = C<0> DEC Special Character and Line Drawing Set + C = C United Kingdom (UK) + C = C United States (USASCII) C = C<< < >> Multinational character set I - C = C<5> Finnish character set I - C = C Finnish character set I - C = C German character set I + C = C<5> Finnish character set I + C = C Finnish character set I + C = C German character set I =end table @@ -1469,8 +1445,8 @@ =begin table - B<< C >> Clear Below (default) - B<< C >> Clear Above + B<< C >> Clear Right and Below (default) + B<< C >> Clear Left and Above B<< C >> Clear All =end table @@ -1485,7 +1461,7 @@ B<< C >> Clear to Left B<< C >> Clear All B<< C >> Like Ps = 0, but is ignored when wrapped - (@@RXVT_NAME@@ extension) + (@@RXVT_NAME@@ extension) =end table @@ -1612,33 +1588,35 @@ =begin table - B<< C >> Normal (default) - B<< C >> On / Off Bold (bright fg) - B<< C >> On / Off Italic - B<< C >> On / Off Underline - B<< C >> On / Off Slow Blink (bright bg) - B<< C >> On / Off Rapid Blink (bright bg) - B<< C >> On / Off Inverse - B<< C >> On / Off Invisible (NYI) - B<< C >> fg/bg Black - B<< C >> fg/bg Red - B<< C >> fg/bg Green - B<< C >> fg/bg Yellow - B<< C >> fg/bg Blue - B<< C >> fg/bg Magenta - B<< C >> fg/bg Cyan - B<< C >> set fg/bg to color #m (ISO 8613-6) - B<< C >> fg/bg White - B<< C >> fg/bg Default - B<< C >> fg/bg Bright Black - B<< C >> fg/bg Bright Red - B<< C >> fg/bg Bright Green - B<< C >> fg/bg Bright Yellow - B<< C >> fg/bg Bright Blue - B<< C >> fg/bg Bright Magenta - B<< C >> fg/bg Bright Cyan - B<< C >> fg/bg Bright White - B<< C >> fg/bg Bright Default + B<< C >> Normal (default) + B<< C >> On / Off Bold (bright fg) + B<< C >> On / Off Italic + B<< C >> On / Off Underline + B<< C >> On / Off Slow Blink (bright bg) + B<< C >> On / Off Rapid Blink (bright bg) + B<< C >> On / Off Inverse + B<< C >> On / Off Invisible (NYI) + B<< C >> fg/bg Black + B<< C >> fg/bg Red + B<< C >> fg/bg Green + B<< C >> fg/bg Yellow + B<< C >> fg/bg Blue + B<< C >> fg/bg Magenta + B<< C >> fg/bg Cyan + B<< C >> fg/bg White + B<< C >> set fg/bg to colour #m (ISO 8613-6) + B<< C >> set fg to 24-bit colour #RGB (ISO 8613-3) + B<< C >> set bg to 24-bit colour #RGB (ISO 8613-3) + B<< C >> fg/bg Default + B<< C >> fg/bg Bright Black + B<< C >> fg/bg Bright Red + B<< C >> fg/bg Bright Green + B<< C >> fg/bg Bright Yellow + B<< C >> fg/bg Bright Blue + B<< C >> fg/bg Bright Magenta + B<< C >> fg/bg Bright Cyan + B<< C >> fg/bg Bright White + B<< C >> fg/bg Bright Default =end table @@ -1655,6 +1633,22 @@ =end table +=item B<< C >> + +Set Cursor Style (DECSCUSR) + +=begin table + + B<< C >> Blink Block + B<< C >> Blink Block + B<< C >> Steady Block + B<< C >> Blink Underline + B<< C >> Steady Underline + B<< C >> Blink Bar (XTerm) + B<< C >> Steady Bar (XTerm) + +=end table + =item B<< C >> Set Scrolling Region [top;bottom] @@ -1736,7 +1730,7 @@ =end table -=item B<< C >> (ANSI/VT52 mode) +=item B<< C >> (DECANM) =begin table @@ -1745,61 +1739,61 @@ =end table -=item B<< C >> +=item B<< C >> (DECCOLM) =begin table - B<< C >> 132 Column Mode (DECCOLM) - B<< C >> 80 Column Mode (DECCOLM) + B<< C >> 132 Column Mode + B<< C >> 80 Column Mode =end table -=item B<< C >> +=item B<< C >> (DECSCLM) =begin table - B<< C >> Smooth (Slow) Scroll (DECSCLM) - B<< C >> Jump (Fast) Scroll (DECSCLM) + B<< C >> Smooth (Slow) Scroll + B<< C >> Jump (Fast) Scroll =end table -=item B<< C >> +=item B<< C >> (DECSCNM) =begin table - B<< C >> Reverse Video (DECSCNM) - B<< C >> Normal Video (DECSCNM) + B<< C >> Reverse Video + B<< C >> Normal Video =end table -=item B<< C >> +=item B<< C >> (DECOM) =begin table - B<< C >> Origin Mode (DECOM) - B<< C >> Normal Cursor Mode (DECOM) + B<< C >> Origin Mode + B<< C >> Normal Cursor Mode =end table -=item B<< C >> +=item B<< C >> (DECAWM) =begin table - B<< C >> Wraparound Mode (DECAWM) - B<< C >> No Wraparound Mode (DECAWM) + B<< C >> Wraparound Mode + B<< C >> No Wraparound Mode =end table -=item B<< C >> I +=item B<< C >> (DECARM) I =begin table - B<< C >> Auto-repeat Keys (DECARM) - B<< C >> No Auto-repeat Keys (DECARM) + B<< C >> Auto-repeat Keys + B<< C >> No Auto-repeat Keys =end table -=item B<< C >> X10 XTerm +=item B<< C >> (X10 XTerm mouse protocol) =begin table @@ -1808,7 +1802,16 @@ =end table -=item B<< C >> +=item B<< C >> (AT&T 610, XTerm) + +=begin table + + B<< C >> Blinking cursor (cvvis) + B<< C >> Steady cursor (cnorm) + +=end table + +=item B<< C >> (DECTCEM) =begin table @@ -1817,7 +1820,7 @@ =end table -=item B<< C >> +=item B<< C >> (B) =begin table @@ -1879,25 +1882,25 @@ X -=item B<< C >> +=item B<< C >> (DECNKM) =begin table - B<< C >> Application Keypad (DECPAM) == C - B<< C >> Normal Keypad (DECPNM) == C<< ESC > >> + B<< C >> Application Keypad (DECKPAM/DECPAM) == C + B<< C >> Normal Keypad (DECKPNM/DECPNM) == C<< ESC > >> =end table -=item B<< C >> +=item B<< C >> (DECBKM) =begin table - B<< C >> Backspace key sends B<< C (DECBKM) >> + B<< C >> Backspace key sends B<< C >> B<< C >> Backspace key sends B<< C >> =end table -=item B<< C >> (X11 XTerm) +=item B<< C >> (X11 XTerm mouse protocol) =begin table @@ -1915,7 +1918,7 @@ =end table -=item B<< C >> (X11 XTerm) +=item B<< C >> (X11 XTerm cell motion mouse tracking) =begin table @@ -1924,7 +1927,7 @@ =end table -=item B<< C >> (X11 XTerm) +=item B<< C >> (X11 XTerm all motion mouse tracking) =begin table @@ -1933,6 +1936,29 @@ =end table +=item B<< C >> (X11 XTerm focus in/focus out events) + +=begin table + + B<< C >> Send Mouse focus in/focus out events. + B<< C >> Don't send focus events. + +=end table + +=item B<< C >> (X11 XTerm UTF-8 mouse mode) (Compile frills) + +Try to avoid this mode, it doesn't work sensibly in non-UTF-8 locales. Use +mode C<1015> instead. + +Unlike XTerm, coordinates larger than 2015 will work fine. + +=begin table + + B<< C >> Enable mouse coordinates in locale-specific encoding. + B<< C >> Enable mouse coordinates as binary octets. + +=end table + =item B<< C >> (B) =begin table @@ -1951,6 +1977,46 @@ =end table +=item B<< C >> (B) (Compile frills) + +=begin table + + B<< C >> Enable urxvt mouse coordinate reporting. + B<< C >> Use old-style C encoding. + +=end table + +Changes all mouse reporting codes to use decimal parameters instead of +octets or characters. + +This mode should be enabled I actually enabling mouse reporting, +for semi-obvious reasons. + +The sequences received for various modes are as follows: + + ESC [ M o o o !1005, !1015 (three octets) + ESC [ M c c c 1005, !1015 (three characters) + ESC [ Pm M 1015 (three or more numeric parameters) + +The first three parameters are C, C and C. Code is the numeric +code as for the other modes (but encoded as a decimal number, including +the additional offset of 32, so you have to subtract 32 first), C and +C are the coordinates (1|1 is the upper left corner, just as with +cursor positioning). + +Example: Shift-Button-1 press at top row, column 80. + + ESC [ 37 ; 80 ; 1 M + +One can use this feature by simply enabling it and then looking for +parameters to the C reply - if there are any, this mode is +active, otherwise one of the old reporting styles is used. + +Other (to be implemented) reply sequences will use a similar encoding. + +In the future, more parameters might get added (pixel coordinates for +example - anybody out there who needs this?). + =item B<< C >> (B) =begin table @@ -1960,7 +2026,7 @@ =end table -=item B<< C >> +=item B<< C >> (X11 XTerm alternate screen buffer) =begin table @@ -1969,7 +2035,7 @@ =end table -=item B<< C >> +=item B<< C >> (X11 XTerm alternate DECSC) =begin table @@ -1978,7 +2044,7 @@ =end table -=item B<< C >> +=item B<< C >> (X11 XTerm 1047 + 1048) =begin table @@ -1987,7 +2053,7 @@ =end table -=item B<< C >> +=item B<< C >> (X11 XTerm bracketed paste mode) =begin table @@ -2023,10 +2089,9 @@ B<< C >> Change colour of text background to B<< C >> B<< C >> Change colour of text cursor foreground to B<< C >> B<< C >> Change colour of mouse foreground to B<< C >> - B<< C >> Change colour of highlight characters to B<< C >> - B<< C >> Change colour of bold characters to B<< C >> [deprecated, see 706] - B<< C >> Change colour of underlined characters to B<< C >> [deprecated, see 707] - B<< C >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage). + B<< C >> Change background colour of highlight characters to B<< C >> + B<< C >> Change foreground colour of highlight characters to B<< C >> + B<< C >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile pixbuf). B<< C >> Change default foreground colour to B<< C >>. [deprecated, use 10] B<< C >> Change Log File to B<< C >> I B<< C >> Change default background colour to B<< C >>. [deprecated, use 11] @@ -2054,66 +2119,21 @@ =head1 BACKGROUND IMAGE For the BACKGROUND IMAGE XTerm escape sequence B<< C >> the value -of B<< C >> can be the name of the background image file followed by a -sequence of scaling/positioning commands separated by semi-colons. The -scaling/positioning commands are as follows: - -=over 4 - -=item query scale/position - -B - -=item change scale and position - -B - -B (== B) - -B (same as B) - -B (same as B) - -B (same as B) - -B (same as B) - -=item change position (absolute) - -B<=+X+Y> - -B<=+X> (same as B<=+X+Y>) - -=item change position (relative) - -B<+X+Y> - -B<+X> (same as B<+X+Y>) - -=item rescale (relative) - -B -> B - -B<0xH> -> B - -=back - -For example: +of B<< C >> can be one of the following commands: =over 4 -=item B<\E]20;funky.jpg\a> +=item B<< C >> -load B as a tiled image +display scale and position in the title -=item B<\E]20;mona.jpg;100\a> +=item B<< C<;WxH+X+Y> >> -load B with a scaling of 100% +change scale and/or position -=item B<\E]20;;200;?\a> +=item B<< C >> -rescale the current pixmap to 200% and display the image geometry in -the title +change background image =back @@ -2151,14 +2171,16 @@ =over 4 -=item State = B<< C<< ( - SPACE) & 60 >> >> +=item State = B<< C<< ( - SPACE) & ~3 >> >> =begin table 4 Shift 8 Meta 16 Control - 32 Double Click I<(rxvt extension)> + 32 Motion Notify + 32 Double Click I<(rxvt extension)>, disabled by default + 64 Button1 is actually Button4, Button2 is actually Button5 etc. =end table @@ -2174,17 +2196,17 @@ Note: B + B-B generates B-B -For the keypad, use B to temporarily override Application-Keypad -setting use B to toggle Application-Keypad setting if -B is off, toggle Application-Keypad setting. Also note that -values of B, B, B may have been compiled differently on -your system. +For the keypad, use B to temporarily toggle Application Keypad +mode and use B to override Application Keypad mode, i.e. if +B is on the keypad is in normal mode. Also note that the +values of B, B may have been compiled differently +on your system. =begin table B B B B Tab ^I ESC [ Z ^I ESC [ Z - BackSpace ^H ^? ^? ^? + BackSpace ^? ^? ^H ^H Find ESC [ 1 ~ ESC [ 1 $ ESC [ 1 ^ ESC [ 1 @ Insert ESC [ 2 ~ I ESC [ 2 ^ ESC [ 2 @ Execute ESC [ 3 ~ ESC [ 3 $ ESC [ 3 ^ ESC [ 3 @ @@ -2224,22 +2246,22 @@ KP_F2 ESC O Q ESC O Q KP_F3 ESC O R ESC O R KP_F4 ESC O S ESC O S - XK_KP_Multiply * ESC O j - XK_KP_Add + ESC O k - XK_KP_Separator , ESC O l - XK_KP_Subtract - ESC O m - XK_KP_Decimal . ESC O n - XK_KP_Divide / ESC O o - XK_KP_0 0 ESC O p - XK_KP_1 1 ESC O q - XK_KP_2 2 ESC O r - XK_KP_3 3 ESC O s - XK_KP_4 4 ESC O t - XK_KP_5 5 ESC O u - XK_KP_6 6 ESC O v - XK_KP_7 7 ESC O w - XK_KP_8 8 ESC O x - XK_KP_9 9 ESC O y + KP_Multiply * ESC O j + KP_Add + ESC O k + KP_Separator , ESC O l + KP_Subtract - ESC O m + KP_Decimal . ESC O n + KP_Divide / ESC O o + KP_0 0 ESC O p + KP_1 1 ESC O q + KP_2 2 ESC O r + KP_3 3 ESC O s + KP_4 4 ESC O t + KP_5 5 ESC O u + KP_6 6 ESC O v + KP_7 7 ESC O w + KP_8 8 ESC O x + KP_9 9 ESC O y =end table @@ -2257,8 +2279,9 @@ =item --enable-everything -Add (or remove) support for all non-multichoice options listed in "./configure ---help". +Add (or remove) support for all non-multichoice options listed +in C<./configure --help>, except for C<--enable-assert> and +C<--enable-256-color>. You can specify this and then disable options you do not like by I this with the appropriate C<--disable-...> arguments, @@ -2266,9 +2289,9 @@ C<--disable-everything> and than adding just the C<--enable-...> arguments you want. -=item --enable-xft (default: enabled) +=item --enable-xft (default: on) -Add support for Xft (anti-aliases, among others) fonts. Xft fonts are +Add support for Xft (anti-aliased, among others) fonts. Xft fonts are slower and require lots of memory, but as long as you don't use them, you don't pay for them. @@ -2277,7 +2300,7 @@ Add support for B, I and B<< I >> font styles. The fonts can be set manually or automatically. -=item --with-codesets=NAME,... (default: all) +=item --with-codesets=CS,... (default: all) Compile in support for additional codeset (encoding) groups (C, C are always compiled in, which includes most 8-bit character sets). These @@ -2323,8 +2346,8 @@ Enable automatic composition of combining characters into composite characters. This is required for proper viewing of text -where accents are encoded as seperate unicode characters. This is -done by using precomposited characters when available or creating +where accents are encoded as separate unicode characters. This is +done by using precomposed characters when available or creating new pseudo-characters when no precomposed form exists. Without --enable-unicode3, the number of additional precomposed @@ -2338,7 +2361,7 @@ but these are not currently used. Bug me if you want these to be used (and tell me how these are to be used...). -=item --enable-fallback(=CLASS) (default: Rxvt) +=item --enable-fallback[=CLASS] (default: Rxvt) When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. @@ -2371,24 +2394,22 @@ F) at start of rxvt execution. This option requires --enable-utmp to also be specified. -=item --enable-afterimage (default: on) +=item --enable-pixbuf (default: on) + +Add support for GDK-PixBuf to be used for background images. +It adds support for many file formats including JPG, PNG, +TIFF, GIF, XPM, BMP, ICO and TGA. -Add support for libAfterImage to be used for transparency and background -images. It adds support for many file formats including JPG, PNG, -SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep image XML -(L). - -This option also adds such eye candy as blending an image over the root -background, as well as dynamic scaling and bluring of background images. - -Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might -increase by a few megabytes even if no extra features are used (mostly due -to third-party libraries used by libAI). Memory footprint may somewhat be -lowered if libAfterImage is configured without support for SVG. +=item --enable-startup-notification (default: on) + +Add support for freedesktop startup notifications. This allows window managers +to display some kind of progress indicator during startup. =item --enable-transparency (default: on) -Add support for backgrounds, creating illusion of transparency in the term. +Add support for using the root pixmap as background to simulate transparency. +Note that this feature depends on libXrender and on the availability +of the RENDER extension in the X server. =item --enable-fading (default: on) @@ -2435,10 +2456,10 @@ MWM-hints EWMH-hints (pid, utf8 names) and protocols (ping) urgency hint - seperate underline colour (-underlineColor) + separate underline colour (-underlineColor) settable border widths and borderless switch (-w, -b, -bl) visual depth selection (-depth) - settable extra linespacing /-lsp) + settable extra linespacing (-lsp) iso-14755 5.1 (basic) support tripleclickwords (-tcw) settable insecure mode (-insecure) @@ -2449,12 +2470,15 @@ hold on exit (-hold) compile in built-in block graphics skip builtin block graphics (-sbg) - separate highlightcolor support (-hc) + separate highlight colour (-highlightColor, -highlightTextColor) + focus reporting mode (1004). + extended mouse reporting modes (1005 and 1015). + visual selection via -visual and -depth. It also enables some non-essential features otherwise disabled, such as: some round-trip time optimisations - nearest color allocation on pseudocolor screens + nearest colour allocation on pseudocolor screens UTF8_STRING support for selection sgr modes 90..97 and 100..107 backindex and forwardindex escape sequences @@ -2516,9 +2540,23 @@ C<-pe "" --perl-ext-common "">, so it should be safe to enable from a resource standpoint. -=item --with-afterimage-config=DIR +=item --enable-assert (default: off) + +Enables the assertions in the code, normally disabled. This switch is only +useful when developing rxvt-unicode. + +=item --enable-256-color (default: off) + +Force use of so-called 256 colour mode, to work around buggy applications +that do not support termcap/terminfo, or simply improve support for +applications hardcoding the xterm 256 colour table. + +This switch breaks termcap/terminfo compatibility to C, +and consequently sets C to C by default +(F contains termcap/terminfo definitions for both). -Look for the libAfterImage config script in DIR. +It also results in higher memory usage and can slow down @@RXVT_NAME@@ +dramatically when more than six fonts are in use by a terminal instance. =item --with-name=NAME (default: urxvt)