--- rxvt-unicode/doc/rxvt.7.pod 2009/05/30 08:53:48 1.177 +++ rxvt-unicode/doc/rxvt.7.pod 2014/11/24 21:46:04 1.234 @@ -107,12 +107,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 +131,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 +201,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 +227,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 +242,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 +253,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 +368,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 +400,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 @@ -539,9 +544,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 +556,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 +580,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 +596,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 +632,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 +696,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 +778,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 +799,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 @@ -868,7 +848,10 @@ infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" One some systems you might need to set C<$TERMINFO> to the full path of -F<$HOME/.terminfo> for this to work. +F<$HOME/.terminfo> for this to work. Debian systems have a broken tic +which will not be able to overwrite the existing rxvt-unicode terminfo +entry - you might have to manually delete all traces of F +from F. If you cannot or do not want to do this, then you can simply set C or even C, and live with the small number of @@ -1076,8 +1059,6 @@ xprop -root XIM_SERVERS -=item - =back =head3 My input method wants but I want UTF-8, what can I do? @@ -1112,10 +1093,10 @@ 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). +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 @@ -1131,7 +1112,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 +1198,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 +1211,7 @@ =item B<< C >> -The literal character c. +The literal character c (potentially a multi-byte character). =item B<< C >> @@ -1305,7 +1280,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 +1306,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 >> @@ -1469,8 +1444,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 @@ -1612,33 +1587,33 @@ =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 >> 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 +1630,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 +1727,7 @@ =end table -=item B<< C >> (ANSI/VT52 mode) +=item B<< C >> (DECANM) =begin table @@ -1745,57 +1736,57 @@ =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 @@ -1808,7 +1799,16 @@ =end table -=item B<< C >> +=item B<< C >> + +=begin table + + B<< C >> Blinking cursor + B<< C >> Steady cursor + +=end table + +=item B<< C >> (DECTCEM) =begin table @@ -1879,20 +1879,20 @@ 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 @@ -1933,6 +1933,20 @@ =end table +=item B<< C >> (X11 XTerm) (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 +1965,46 @@ =end table +=item B<< C >> (B) (Compile frills) + +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?). + +=begin table + + B<< C >> Enable new mouse coordinate reporting. + B<< C >> Use old-style C encoding. + +=end table + =item B<< C >> (B) =begin table @@ -2023,10 +2077,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 +2107,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 +2159,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 +2184,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 +2234,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 +2267,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 +2277,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 +2288,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 +2334,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 +2349,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 +2382,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 +2444,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 +2458,14 @@ hold on exit (-hold) compile in built-in block graphics skip builtin block graphics (-sbg) - separate highlightcolor support (-hc) + separate highlight colour (-highlightColor, -highlightTextColor) + 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 +2527,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)