ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.txt
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents):
Revision 1.15 by root, Thu Feb 17 12:00:33 2005 UTC vs.
Revision 1.25 by root, Tue Nov 8 17:35:28 2005 UTC

… …
23 How do I know which rxvt-unicode version I'm using? 23 How do I know which rxvt-unicode version I'm using?
24 The version number is displayed with the usage (-h). Also the escape 24 The version number is displayed with the usage (-h). Also the escape
25 sequence "ESC [ 8 n" sets the window title to the version number. 25 sequence "ESC [ 8 n" sets the window title to the version number.
26 26
27 I am using Debian GNU/Linux and have a problem... 27 I am using Debian GNU/Linux and have a problem...
28 The Debian GNU/Linux package of rxvt-unicode contains large patches 28 The Debian GNU/Linux package of rxvt-unicode in sarge contains large
29 that considerably change the behaviour of rxvt-unicode. Before 29 patches that considerably change the behaviour of rxvt-unicode.
30 reporting a bug to the original rxvt-unicode author please download 30 Before reporting a bug to the original rxvt-unicode author please
31 and install the genuine version 31 download and install the genuine version
32 (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce the 32 (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce the
33 problem. If you cannot, chances are that the problems are specific 33 problem. If you cannot, chances are that the problems are specific
34 to Debian GNU/Linux, in which case it should be reported via the 34 to Debian GNU/Linux, in which case it should be reported via the
35 Debian Bug Tracking System (use "reportbug" to report the bug). 35 Debian Bug Tracking System (use "reportbug" to report the bug).
36 36
… …
66 URxvt.termName: rxvt 66 URxvt.termName: rxvt
67 67
68 If you don't plan to use rxvt (quite common...) you could also 68 If you don't plan to use rxvt (quite common...) you could also
69 replace the rxvt terminfo file with the rxvt-unicode one. 69 replace the rxvt terminfo file with the rxvt-unicode one.
70 70
71 "tic" outputs some error when compiling the terminfo entry.
72 Most likely it's the empty definition for "enacs=". Just replace it
73 by "enacs=\E[0@" and try again.
74
71 "bash"'s readline does not work correctly under rxvt. 75 "bash"'s readline does not work correctly under urxvt.
72 I need a termcap file entry. 76 I need a termcap file entry.
73 One reason you might want this is that some distributions or 77 One reason you might want this is that some distributions or
74 operating systems still compile some programs using the 78 operating systems still compile some programs using the
75 long-obsoleted termcap library (Fedora Core's bash is one example) 79 long-obsoleted termcap library (Fedora Core's bash is one example)
76 and rely on a termcap entry for "rxvt-unicode". 80 and rely on a termcap entry for "rxvt-unicode".
… …
187 indeed look correct. 191 indeed look correct.
188 192
189 In that case, select a font of your taste and add it to the font 193 In that case, select a font of your taste and add it to the font
190 list, e.g.: 194 list, e.g.:
191 195
192 rxvt -fn basefont,font2,font3... 196 urxvt -fn basefont,font2,font3...
193 197
194 When rxvt-unicode sees a character, it will first look at the base 198 When rxvt-unicode sees a character, it will first look at the base
195 font. If the base font does not contain the character, it will go to 199 font. If the base font does not contain the character, it will go to
196 the next font, and so on. Specifying your own fonts will also speed 200 the next font, and so on. Specifying your own fonts will also speed
197 up this search and use less resources within rxvt-unicode and the 201 up this search and use less resources within rxvt-unicode and the
… …
247 that doesn't work, you might be forced to use a different font. 251 that doesn't work, you might be forced to use a different font.
248 252
249 All of this is not a problem when using X11 core fonts, as their 253 All of this is not a problem when using X11 core fonts, as their
250 bounding box data is correct. 254 bounding box data is correct.
251 255
256 On Solaris 9, many line-drawing characters are too wide.
257 Seems to be a known bug, read
258 <http://nixdoc.net/files/forum/about34198.html>. Some people use the
259 following ugly workaround to get non-double-wide-characters working:
260
261 #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
262
252 My Compose (Multi_key) key is no longer working. 263 My Compose (Multi_key) key is no longer working.
253 The most common causes for this are that either your locale is not 264 The most common causes for this are that either your locale is not
254 set correctly, or you specified a preeditStyle that is not supported 265 set correctly, or you specified a preeditStyle that is not supported
255 by your input method. For example, if you specified OverTheSpot and 266 by your input method. For example, if you specified OverTheSpot and
256 your input method (e.g. the default input method handling Compose 267 your input method (e.g. the default input method handling Compose
… …
300 As you might have guessed, FreeBSD does neither define this symobl 311 As you might have guessed, FreeBSD does neither define this symobl
301 nor does it support it. Instead, it uses it's own internal 312 nor does it support it. Instead, it uses it's own internal
302 representation of wchar_t. This is, of course, completely fine with 313 representation of wchar_t. This is, of course, completely fine with
303 respect to standards. 314 respect to standards.
304 315
316 However, that means rxvt-unicode only works in "POSIX", "ISO-8859-1"
317 and "UTF-8" locales under FreeBSD (which all use Unicode as wchar_t.
318
305 However, "__STDC_ISO_10646__" is the only sane way to support 319 "__STDC_ISO_10646__" is the only sane way to support multi-language
306 multi-language apps in an OS, as using a locale-dependent (and 320 apps in an OS, as using a locale-dependent (and non-standardized)
307 non-standardized) representation of wchar_t makes it impossible to 321 representation of wchar_t makes it impossible to convert between
308 convert between wchar_t (as used by X11 and your applications) and 322 wchar_t (as used by X11 and your applications) and any other
309 any other encoding without implementing OS-specific-wrappers for 323 encoding without implementing OS-specific-wrappers for each and
310 each and every locale. There simply are no APIs to convert wchar_t 324 every locale. There simply are no APIs to convert wchar_t into
311 into anything except the current locale encoding. 325 anything except the current locale encoding.
312 326
313 Some applications (such as the formidable mlterm) work around this 327 Some applications (such as the formidable mlterm) work around this
314 by carrying their own replacement functions for character set 328 by carrying their own replacement functions for character set
315 handling with them, and either implementing OS-dependent hacks or 329 handling with them, and either implementing OS-dependent hacks or
316 doing multiple conversions (which is slow and unreliable in case the 330 doing multiple conversions (which is slow and unreliable in case the
… …
318 emulator). 332 emulator).
319 333
320 The rxvt-unicode author insists that the right way to fix this is in 334 The rxvt-unicode author insists that the right way to fix this is in
321 the system libraries once and for all, instead of forcing every app 335 the system libraries once and for all, instead of forcing every app
322 to carry complete replacements for them :) 336 to carry complete replacements for them :)
337
338 I use Solaris 9 and it doesn't compile/work/etc.
339 Try the diff in doc/solaris9.patch as a base. It fixes the worst
340 problems with "wcwidth" and a compile problem.
341
342 How can I use rxvt-unicode under cygwin?
343 rxvt-unicode should compile and run out of the box on cygwin, using
344 the X11 libraries that come with cygwin. libW11 emulation is no
345 longer supported (and makes no sense, either, as it only supported a
346 single font). I recommend starting the X-server in "-multiwindow" or
347 "-rootless" mode instead, which will result in similar look&feel as
348 the old libW11 emulation.
349
350 At the time of this writing, cygwin didn't seem to support any
351 multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are
352 likely limited to 8-bit encodings.
323 353
324 How does rxvt-unicode determine the encoding to use? 354 How does rxvt-unicode determine the encoding to use?
325 Is there an option to switch encodings? 355 Is there an option to switch encodings?
326 Unlike some other terminals, rxvt-unicode has no encoding switch, 356 Unlike some other terminals, rxvt-unicode has no encoding switch,
327 and no specific "utf-8" mode, such as xterm. In fact, it doesn't 357 and no specific "utf-8" mode, such as xterm. In fact, it doesn't
… …
439 it gets worse, as rxvt-unicode then uses 8 bytes per screen cell. 469 it gets worse, as rxvt-unicode then uses 8 bytes per screen cell.
440 470
441 Can I speed up Xft rendering somehow? 471 Can I speed up Xft rendering somehow?
442 Yes, the most obvious way to speed it up is to avoid Xft entirely, 472 Yes, the most obvious way to speed it up is to avoid Xft entirely,
443 as it is simply slow. If you still want Xft fonts you might try to 473 as it is simply slow. If you still want Xft fonts you might try to
444 disable antialiasing (by appending ":antialiasing=false"), which 474 disable antialiasing (by appending ":antialias=false"), which saves
445 saves lots of memory and also speeds up rendering considerably. 475 lots of memory and also speeds up rendering considerably.
446 476
447 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? 477 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
448 Rxvt-unicode will use whatever you specify as a font. If it needs to 478 Rxvt-unicode will use whatever you specify as a font. If it needs to
449 fall back to it's default font search list it will prefer X11 core 479 fall back to it's default font search list it will prefer X11 core
450 fonts, because they are small and fast, and then use Xft fonts. It 480 fonts, because they are small and fast, and then use Xft fonts. It
… …
456 Mouse cut/paste suddenly no longer works. 486 Mouse cut/paste suddenly no longer works.
457 Make sure that mouse reporting is actually turned off since killing 487 Make sure that mouse reporting is actually turned off since killing
458 some editors prematurely may leave the mouse in mouse report mode. 488 some editors prematurely may leave the mouse in mouse report mode.
459 I've heard that tcsh may use mouse reporting unless it otherwise 489 I've heard that tcsh may use mouse reporting unless it otherwise
460 specified. A quick check is to see if cut/paste works when the Alt 490 specified. A quick check is to see if cut/paste works when the Alt
461 or Shift keys are depressed. See rxvt(7) 491 or Shift keys are depressed. See urxvt(7)
462 492
463 What's with this bold/blink stuff? 493 What's with this bold/blink stuff?
464 If no bold colour is set via "colorBD:", bold will invert text using 494 If no bold colour is set via "colorBD:", bold will invert text using
465 the standard foreground colour. 495 the standard foreground colour.
466 496
… …
521 URxvt.color6: #73f7ff 551 URxvt.color6: #73f7ff
522 URxvt.color14: #73f7ff 552 URxvt.color14: #73f7ff
523 URxvt.color7: #e1dddd 553 URxvt.color7: #e1dddd
524 URxvt.color15: #e1dddd 554 URxvt.color15: #e1dddd
525 555
526 How can I start rxvtd in a race-free way? 556 How can I start urxvtd in a race-free way?
527 Despite it's name, rxvtd is not a real daemon, but more like a 557 Try "urxvtd -f -o", which tells urxvtd to open the display, create
528 server that answers rxvtc's requests, so it doesn't background 558 the listening socket and then fork.
529 itself.
530
531 To ensure rxvtd is listening on it's socket, you can use the
532 following method to wait for the startup message before continuing:
533
534 { rxvtd & } | read
535 559
536 What's with the strange Backspace/Delete key behaviour? 560 What's with the strange Backspace/Delete key behaviour?
537 Assuming that the physical Backspace key corresponds to the 561 Assuming that the physical Backspace key corresponds to the
538 BackSpace keysym (not likely for Linux ... see the following 562 BackSpace keysym (not likely for Linux ... see the following
539 question) there are two standard values that can be used for 563 question) there are two standard values that can be used for
… …
552 576
553 For starting a new rxvt-unicode: 577 For starting a new rxvt-unicode:
554 578
555 # use Backspace = ^H 579 # use Backspace = ^H
556 $ stty erase ^H 580 $ stty erase ^H
557 $ rxvt 581 $ urxvt
558 582
559 # use Backspace = ^? 583 # use Backspace = ^?
560 $ stty erase ^? 584 $ stty erase ^?
561 $ rxvt 585 $ urxvt
562 586
563 Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in rxvt(7). 587 Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in urxvt(7).
564 588
565 For an existing rxvt-unicode: 589 For an existing rxvt-unicode:
566 590
567 # use Backspace = ^H 591 # use Backspace = ^H
568 $ stty erase ^H 592 $ stty erase ^H
… …
594 There are some compile-time selections available via configure. 618 There are some compile-time selections available via configure.
595 Unless you have run "configure" with the "--disable-resources" 619 Unless you have run "configure" with the "--disable-resources"
596 option you can use the `keysym' resource to alter the keystrings 620 option you can use the `keysym' resource to alter the keystrings
597 associated with keysyms. 621 associated with keysyms.
598 622
599 Here's an example for a URxvt session started using "rxvt -name 623 Here's an example for a URxvt session started using "urxvt -name
600 URxvt" 624 URxvt"
601 625
602 URxvt.keysym.Home: \033[1~ 626 URxvt.keysym.Home: \033[1~
603 URxvt.keysym.End: \033[4~ 627 URxvt.keysym.End: \033[4~
604 URxvt.keysym.C-apostrophe: \033<C-'> 628 URxvt.keysym.C-apostrophe: \033<C-'>
… …
1156 Ps = 13 Change colour of mouse foreground to Pt 1180 Ps = 13 Change colour of mouse foreground to Pt
1157 Ps = 17 Change colour of highlight characters to Pt 1181 Ps = 17 Change colour of highlight characters to Pt
1158 Ps = 18 Change colour of bold characters to Pt 1182 Ps = 18 Change colour of bold characters to Pt
1159 Ps = 19 Change colour of underlined characters to Pt 1183 Ps = 19 Change colour of underlined characters to Pt
1160 Ps = 20 Change default background to Pt 1184 Ps = 20 Change default background to Pt
1161 Ps = 39 Change default foreground colour to Pt rxvt compile-time option 1185 Ps = 39 Change default foreground colour to Pt.
1162 Ps = 46 Change Log File to Pt unimplemented 1186 Ps = 46 Change Log File to Pt unimplemented
1163 Ps = 49 Change default background colour to Pt rxvt compile-time option 1187 Ps = 49 Change default background colour to Pt.
1164 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 1188 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
1165 Ps = 55 Log all scrollback buffer and all of screen to Pt 1189 Ps = 55 Log all scrollback buffer and all of screen to Pt
1166 Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (rxvt extension) 1190 Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
1167 Ps = 703 Menubar command Pt rxvt compile-time option (rxvt-unicode extension) 1191 Ps = 703 Menubar command Pt (Compile menubar).
1168 Ps = 704 Change colour of italic characters to Pt 1192 Ps = 704 Change colour of italic characters to Pt
1169 Ps = 705 Change background pixmap tint colour to Pt 1193 Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
1170 Ps = 710 Set normal fontset to Pt. Same as Ps = 50. 1194 Ps = 710 Set normal fontset to Pt. Same as Ps = 50.
1171 Ps = 711 Set bold fontset to Pt. Similar to Ps = 50. 1195 Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
1172 Ps = 712 Set italic fontset to Pt. Similar to Ps = 50. 1196 Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1173 Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50. 1197 Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1198 Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1199 Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1174 1200
1175 1201
1176 1202
1177menuBar 1203menuBar
1178 The exact syntax used is *almost* solidified. In the menus, DON'T try to 1204 The exact syntax used is *almost* solidified. In the menus, DON'T try to
… …
1643 XK_KP_8 8 ESC O x 1669 XK_KP_8 8 ESC O x
1644 XK_KP_9 9 ESC O y 1670 XK_KP_9 9 ESC O y
1645 1671
1646CONFIGURE OPTIONS 1672CONFIGURE OPTIONS
1647 General hint: if you get compile errors, then likely your configuration 1673 General hint: if you get compile errors, then likely your configuration
1648 hasn't been tested well. Either try with --enable-everything or use the 1674 hasn't been tested well. Either try with "--enable-everything" or use
1649 ./reconf script as a base for experiments. ./reconf is used by myself, 1675 the ./reconf script as a base for experiments. ./reconf is used by
1650 so it should generally be a working config. Of course, you should always 1676 myself, so it should generally be a working config. Of course, you
1651 report when a combination doesn't work, so it can be fixed. Marc Lehmann 1677 should always report when a combination doesn't work, so it can be
1652 <rxvt@schmorp.de>. 1678 fixed. Marc Lehmann <rxvt@schmorp.de>.
1679
1680 All
1653 1681
1654 --enable-everything 1682 --enable-everything
1655 Add support for all non-multichoice options listed in "./configure 1683 Add (or remove) support for all non-multichoice options listed in
1656 --help". Note that unlike other enable options this is order 1684 "./configure --help".
1657 dependant. You can specify this and then disable options which this
1658 enables by *following* this with the appropriate commands.
1659 1685
1660 --enable-xft 1686 You can specify this and then disable options you do not like by
1687 *following* this with the appropriate "--disable-..." arguments, or
1688 you can start with a minimal configuration by specifying
1689 "--disable-everything" and than adding just the "--enable-..."
1690 arguments you want.
1691
1692 --enable-xft (default: enabled)
1661 Add support for Xft (anti-aliases, among others) fonts. Xft fonts 1693 Add support for Xft (anti-aliases, among others) fonts. Xft fonts
1662 are slower and require lots of memory, but as long as you don't use 1694 are slower and require lots of memory, but as long as you don't use
1663 them, you don't pay for them. 1695 them, you don't pay for them.
1664 1696
1665 --enable-font-styles 1697 --enable-font-styles (default: on)
1666 Add support for bold, *italic* and *bold italic* font styles. The 1698 Add support for bold, *italic* and *bold italic* font styles. The
1667 fonts can be set manually or automatically. 1699 fonts can be set manually or automatically.
1668 1700
1669 --with-codesets=NAME,... 1701 --with-codesets=NAME,... (default: all)
1670 Compile in support for additional codeset (encoding) groups (eu, vn 1702 Compile in support for additional codeset (encoding) groups ("eu",
1671 are always compiled in, which includes most 8-bit character sets). 1703 "vn" are always compiled in, which includes most 8-bit character
1672 These codeset tables are currently only used for driving X11 core 1704 sets). These codeset tables are used for driving X11 core fonts,
1673 fonts, they are not required for Xft fonts. Compiling them in will 1705 they are not required for Xft fonts, although having them compiled
1674 make your binary bigger (together about 700kB), but it doesn't 1706 in lets rxvt-unicode choose replacement fonts more intelligently.
1675 increase memory usage unless you use an X11 font requiring one of 1707 Compiling them in will make your binary bigger (all of together cost
1676 these encodings. 1708 about 700kB), but it doesn't increase memory usage unless you use a
1709 font requiring one of these encodings.
1677 1710
1678 all all available codeset groups 1711 all all available codeset groups
1679 zh common chinese encodings 1712 zh common chinese encodings
1680 zh_ext rarely used but very big chinese encodigs 1713 zh_ext rarely used but very big chinese encodigs
1681 jp common japanese encodings 1714 jp common japanese encodings
1682 jp_ext rarely used but big japanese encodings 1715 jp_ext rarely used but big japanese encodings
1683 kr korean encodings 1716 kr korean encodings
1684 1717
1685 --enable-xim 1718 --enable-xim (default: on)
1686 Add support for XIM (X Input Method) protocol. This allows using 1719 Add support for XIM (X Input Method) protocol. This allows using
1687 alternative input methods (e.g. kinput2) and will also correctly set 1720 alternative input methods (e.g. kinput2) and will also correctly set
1688 up the input for people using dead keys or compose keys. 1721 up the input for people using dead keys or compose keys.
1689 1722
1690 --enable-unicode3 1723 --enable-unicode3 (default: off)
1691 Enable direct support for displaying unicode codepoints above 65535 1724 Enable direct support for displaying unicode codepoints above 65535
1692 (the basic multilingual page). This increases storage requirements 1725 (the basic multilingual page). This increases storage requirements
1693 per character from 2 to 4 bytes. X11 fonts do not yet support these 1726 per character from 2 to 4 bytes. X11 fonts do not yet support these
1694 extra characters, but Xft does. 1727 extra characters, but Xft does.
1695 1728
… …
1697 even without this flag, but the number of such characters is limited 1730 even without this flag, but the number of such characters is limited
1698 to a view thousand (shared with combining characters, see next 1731 to a view thousand (shared with combining characters, see next
1699 switch), and right now rxvt-unicode cannot display them 1732 switch), and right now rxvt-unicode cannot display them
1700 (input/output and cut&paste still work, though). 1733 (input/output and cut&paste still work, though).
1701 1734
1702 --enable-combining 1735 --enable-combining (default: on)
1703 Enable automatic composition of combining characters into composite 1736 Enable automatic composition of combining characters into composite
1704 characters. This is required for proper viewing of text where 1737 characters. This is required for proper viewing of text where
1705 accents are encoded as seperate unicode characters. This is done by 1738 accents are encoded as seperate unicode characters. This is done by
1706 using precomposited characters when available or creating new 1739 using precomposited characters when available or creating new
1707 pseudo-characters when no precomposed form exists. 1740 pseudo-characters when no precomposed form exists.
… …
1716 1749
1717 The combining table also contains entries for arabic presentation 1750 The combining table also contains entries for arabic presentation
1718 forms, but these are not currently used. Bug me if you want these to 1751 forms, but these are not currently used. Bug me if you want these to
1719 be used (and tell me how these are to be used...). 1752 be used (and tell me how these are to be used...).
1720 1753
1721 --enable-fallback(=CLASS) 1754 --enable-fallback(=CLASS) (default: Rxvt)
1722 When reading resource settings, also read settings for class CLASS 1755 When reading resource settings, also read settings for class CLASS.
1723 (default: Rxvt). To disable resource fallback use 1756 To disable resource fallback use --disable-fallback.
1724 --disable-fallback.
1725 1757
1726 --with-res-name=NAME 1758 --with-res-name=NAME (default: urxvt)
1727 Use the given name (default: urxvt) as default application name when 1759 Use the given name as default application name when reading
1728 reading resources. Specify --with-res-name=rxvt to replace rxvt. 1760 resources. Specify --with-res-name=rxvt to replace rxvt.
1729 1761
1730 --with-res-class=CLASS 1762 --with-res-class=CLASS /default: URxvt)
1731 Use the given class (default: URxvt) as default application class 1763 Use the given class as default application class when reading
1732 when reading resources. Specify --with-res-class=Rxvt to replace 1764 resources. Specify --with-res-class=Rxvt to replace rxvt.
1733 rxvt.
1734 1765
1735 --enable-utmp 1766 --enable-utmp (default: on)
1736 Write user and tty to utmp file (used by programs like w) at start 1767 Write user and tty to utmp file (used by programs like w) at start
1737 of rxvt execution and delete information when rxvt exits. 1768 of rxvt execution and delete information when rxvt exits.
1738 1769
1739 --enable-wtmp 1770 --enable-wtmp (default: on)
1740 Write user and tty to wtmp file (used by programs like last) at 1771 Write user and tty to wtmp file (used by programs like last) at
1741 start of rxvt execution and write logout when rxvt exits. This 1772 start of rxvt execution and write logout when rxvt exits. This
1742 option requires --enable-utmp to also be specified. 1773 option requires --enable-utmp to also be specified.
1743 1774
1744 --enable-lastlog 1775 --enable-lastlog (default: on)
1745 Write user and tty to lastlog file (used by programs like lastlogin) 1776 Write user and tty to lastlog file (used by programs like lastlogin)
1746 at start of rxvt execution. This option requires --enable-utmp to 1777 at start of rxvt execution. This option requires --enable-utmp to
1747 also be specified. 1778 also be specified.
1748 1779
1749 --enable-xpm-background 1780 --enable-xpm-background (default: off)
1750 Add support for XPM background pixmaps. 1781 Add support for XPM background pixmaps.
1751 1782
1752 --enable-transparency 1783 --enable-transparency (default: off)
1753 Add support for inheriting parent backgrounds thus giving a fake 1784 Add support for inheriting parent backgrounds thus giving a fake
1754 transparency to the term. 1785 transparency to the term.
1755 1786
1756 --enable-fading 1787 --enable-fading (default: on)
1757 Add support for fading the text when focus is lost. 1788 Add support for fading the text when focus is lost (requires
1789 "--enable-transparency").
1758 1790
1759 --enable-tinting 1791 --enable-tinting (default: on)
1760 Add support for tinting of transparent backgrounds. 1792 Add support for tinting of transparent backgrounds (requires
1793 "--enable-transparency").
1761 1794
1762 --enable-menubar 1795 --enable-menubar (default: off)
1763 Add support for our menu bar system (this interacts badly with 1796 Add support for our menu bar system (this interacts badly with
1764 dynamic locale switching currently). 1797 dynamic locale switching currently).
1765 1798
1766 --enable-rxvt-scroll 1799 --enable-rxvt-scroll (default: on)
1767 Add support for the original rxvt scrollbar. 1800 Add support for the original rxvt scrollbar.
1768 1801
1769 --enable-next-scroll 1802 --enable-next-scroll (default: on)
1770 Add support for a NeXT-like scrollbar. 1803 Add support for a NeXT-like scrollbar.
1771 1804
1772 --enable-xterm-scroll 1805 --enable-xterm-scroll (default: on)
1773 Add support for an Xterm-like scrollbar. 1806 Add support for an Xterm-like scrollbar.
1774 1807
1775 --enable-plain-scroll 1808 --enable-plain-scroll (default: on)
1776 Add support for a very unobtrusive, plain-looking scrollbar that is 1809 Add support for a very unobtrusive, plain-looking scrollbar that is
1777 the favourite of the rxvt-unicode author, having used it for many 1810 the favourite of the rxvt-unicode author, having used it for many
1778 years. 1811 years.
1779 1812
1780 --enable-half-shadow 1813 --enable-half-shadow (default: off)
1781 Make shadows on the scrollbar only half the normal width & height. 1814 Make shadows on the scrollbar only half the normal width & height.
1782 only applicable to rxvt scrollbars. 1815 only applicable to rxvt scrollbars.
1783 1816
1784 --enable-ttygid 1817 --enable-ttygid (default: off)
1785 Change tty device setting to group "tty" - only use this if your 1818 Change tty device setting to group "tty" - only use this if your
1786 system uses this type of security. 1819 system uses this type of security.
1787 1820
1788 --disable-backspace-key 1821 --disable-backspace-key
1789 Disable any handling of the backspace key by us - let the X server 1822 Removes any handling of the backspace key by us - let the X server
1790 do it. 1823 do it.
1791 1824
1792 --disable-delete-key 1825 --disable-delete-key
1793 Disable any handling of the delete key by us - let the X server do 1826 Removes any handling of the delete key by us - let the X server do
1794 it. 1827 it.
1795 1828
1796 --disable-resources 1829 --disable-resources
1797 Remove all resources checking. 1830 Removes any support for resource checking.
1798 1831
1799 --enable-xgetdefault 1832 --enable-xgetdefault
1800 Make resources checking via XGetDefault() instead of our small 1833 Make resources checking via XGetDefault() instead of our small
1801 version which only checks ~/.Xdefaults, or if that doesn't exist 1834 version which only checks ~/.Xdefaults, or if that doesn't exist
1802 then ~/.Xresources. 1835 then ~/.Xresources.
1803 1836
1804 Please note that nowadays, things like XIM will automatically pull 1837 Please note that nowadays, things like XIM will automatically pull
1805 in and use the full X resource manager, so the overhead of using it 1838 in and use the full X resource manager, so the overhead of using it
1806 might be very small, if nonexistant. 1839 might be very small, if nonexistant.
1807 1840
1808 --enable-strings 1841 --enable-strings (default: off)
1809 Add support for our possibly faster memset() function and other 1842 Add support for our possibly faster memset() function and other
1810 various routines, overriding your system's versions which may have 1843 various routines, overriding your system's versions which may have
1811 been hand-crafted in assembly or may require extra libraries to link 1844 been hand-crafted in assembly or may require extra libraries to link
1812 in. (this breaks ANSI-C rules and has problems on many GNU/Linux 1845 in. (this breaks ANSI-C rules and has problems on many GNU/Linux
1813 systems). 1846 systems).
1814 1847
1815 --disable-swapscreen 1848 --disable-swapscreen
1816 Remove support for swap screen. 1849 Remove support for secondary/swap screen.
1817 1850
1818 --enable-frills 1851 --enable-frills (default: on)
1819 Add support for many small features that are not essential but nice 1852 Add support for many small features that are not essential but nice
1820 to have. Normally you want this, but for very small binaries you may 1853 to have. Normally you want this, but for very small binaries you may
1821 want to disable this. 1854 want to disable this.
1822 1855
1823 A non-exhaustive list of features enabled by "--enable-frills" 1856 A non-exhaustive list of features enabled by "--enable-frills"
1824 (possibly in combination with other switches) is: 1857 (possibly in combination with other switches) is:
1825 1858
1826 MWM-hints 1859 MWM-hints
1860 EWMH-hints (pid, utf8 names) and protocols (ping)
1827 seperate underline colour 1861 seperate underline colour
1828 settable border widths and borderless switch 1862 settable border widths and borderless switch
1829 settable extra linespacing 1863 settable extra linespacing
1830 extra window properties (e.g. UTF-8 window names and PID)
1831 iso-14755-2 and -3, and visual feedback 1864 iso-14755-2 and -3, and visual feedback
1832 backindex and forwardindex escape sequence 1865 backindex and forwardindex escape sequence
1833 window op and locale change escape sequences 1866 window op and some xterm/OSC escape sequences
1834 tripleclickwords 1867 tripleclickwords
1835 settable insecure mode 1868 settable insecure mode
1836 keysym remapping support 1869 keysym remapping support
1870 cursor blinking and underline cursor
1871 -embed and -pty-fd options
1837 1872
1838 --enable-iso14755 1873 --enable-iso14755 (default: on)
1839 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). 1874 Enable extended ISO 14755 support (see urxvt(1), or doc/rxvt.1.txt).
1840 Basic support (section 5.1) is enabled by "--enable-frills", while 1875 Basic support (section 5.1) is enabled by "--enable-frills", while
1841 support for 5.2, 5.3 and 5.4 is enabled with this switch. 1876 support for 5.2, 5.3 and 5.4 is enabled with this switch.
1842 1877
1843 --enable-keepscrolling 1878 --enable-keepscrolling (default: on)
1844 Add support for continual scrolling of the display when you hold the 1879 Add support for continual scrolling of the display when you hold the
1845 mouse button down on a scrollbar arrow. 1880 mouse button down on a scrollbar arrow.
1846 1881
1847 --enable-mousewheel 1882 --enable-mousewheel (default: on)
1848 Add support for scrolling via mouse wheel or buttons 4 & 5. 1883 Add support for scrolling via mouse wheel or buttons 4 & 5.
1849 1884
1850 --enable-slipwheeling 1885 --enable-slipwheeling (default: on)
1851 Add support for continual scrolling (using the mouse wheel as an 1886 Add support for continual scrolling (using the mouse wheel as an
1852 accelerator) while the control key is held down. This option 1887 accelerator) while the control key is held down. This option
1853 requires --enable-mousewheel to also be specified. 1888 requires --enable-mousewheel to also be specified.
1854 1889
1855 --disable-new-selection 1890 --disable-new-selection
1856 Remove support for mouse selection style like that of xterm. 1891 Remove support for mouse selection style like that of xterm.
1857 1892
1858 --enable-dmalloc 1893 --enable-dmalloc (default: off)
1859 Use Gray Watson's malloc - which is good for debugging See 1894 Use Gray Watson's malloc - which is good for debugging See
1860 http://www.letters.com/dmalloc/ for details If you use either this 1895 http://www.letters.com/dmalloc/ for details If you use either this
1861 or the next option, you may need to edit src/Makefile after 1896 or the next option, you may need to edit src/Makefile after
1862 compiling to point DINCLUDE and DLIB to the right places. 1897 compiling to point DINCLUDE and DLIB to the right places.
1863 1898
1864 You can only use either this option and the following (should you 1899 You can only use either this option and the following (should you
1865 use either) . 1900 use either) .
1866 1901
1867 --enable-dlmalloc 1902 --enable-dlmalloc (default: off)
1868 Use Doug Lea's malloc - which is good for a production version See 1903 Use Doug Lea's malloc - which is good for a production version See
1869 <http://g.oswego.edu/dl/html/malloc.html> for details. 1904 <http://g.oswego.edu/dl/html/malloc.html> for details.
1870 1905
1871 --enable-smart-resize 1906 --enable-smart-resize (default: on)
1872 Add smart growth/shrink behaviour when changing font size via from 1907 Add smart growth/shrink behaviour when changing font size via hot
1873 hot keys. This should keep in a fixed position the rxvt corner which 1908 keys. This should keep in a fixed position the urxvt corner which is
1874 is closest to a corner of the screen. 1909 closest to a corner of the screen.
1875 1910
1876 --enable-cursor-blink
1877 Add support for a blinking cursor.
1878
1879 --enable-pointer-blank 1911 --enable-pointer-blank (default: on)
1880 Add support to have the pointer disappear when typing or inactive. 1912 Add support to have the pointer disappear when typing or inactive.
1881 1913
1882 --with-name=NAME 1914 --with-name=NAME (default: urxvt)
1883 Set the basename for the installed binaries (default: "urxvt", 1915 Set the basename for the installed binaries, resulting in "urxvt",
1884 resulting in "urxvt", "urxvtd" etc.). Specify "--with-name=rxvt" to 1916 "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt".
1885 replace with "rxvt".
1886 1917
1887 --with-term=NAME 1918 --with-term=NAME (default: rxvt-unicode)
1888 Change the environmental variable for the terminal to NAME (default 1919 Change the environmental variable for the terminal to NAME.
1889 "rxvt-unicode")
1890 1920
1891 --with-terminfo=PATH 1921 --with-terminfo=PATH
1892 Change the environmental variable for the path to the terminfo tree 1922 Change the environmental variable for the path to the terminfo tree
1893 to PATH. 1923 to PATH.
1894 1924

Diff Legend

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