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.22 by root, Wed Jul 13 03:08:57 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
65 65
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
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.
70 74
71 "bash"'s readline does not work correctly under rxvt. 75 "bash"'s readline does not work correctly under rxvt.
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
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
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 rxvtd in a race-free way?
527 Despite it's name, rxvtd is not a real daemon, but more like a 557 Try "rxvtd -f -o", which tells rxvtd to open the display, create the
528 server that answers rxvtc's requests, so it doesn't background 558 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
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
1665 --enable-font-styles 1691 --enable-font-styles
1666 Add support for bold, *italic* and *bold italic* font styles. The 1692 Add support for bold, *italic* and *bold italic* font styles. The
1667 fonts can be set manually or automatically. 1693 fonts can be set manually or automatically.
1668 1694
1669 --with-codesets=NAME,... 1695 --with-codesets=NAME,...
1670 Compile in support for additional codeset (encoding) groups (eu, vn 1696 Compile in support for additional codeset (encoding) groups ("eu",
1671 are always compiled in, which includes most 8-bit character sets). 1697 "vn" are always compiled in, which includes most 8-bit character
1672 These codeset tables are currently only used for driving X11 core 1698 sets). These codeset tables are used for driving X11 core fonts,
1673 fonts, they are not required for Xft fonts. Compiling them in will 1699 they are not required for Xft fonts, although having them compiled
1674 make your binary bigger (together about 700kB), but it doesn't 1700 in lets rxvt-unicode choose replacement fonts more intelligently.
1675 increase memory usage unless you use an X11 font requiring one of 1701 Compiling them in will make your binary bigger (all of together cost
1676 these encodings. 1702 about 700kB), but it doesn't increase memory usage unless you use a
1703 font requiring one of these encodings.
1677 1704
1678 all all available codeset groups 1705 all all available codeset groups
1679 zh common chinese encodings 1706 zh common chinese encodings
1680 zh_ext rarely used but very big chinese encodigs 1707 zh_ext rarely used but very big chinese encodigs
1681 jp common japanese encodings 1708 jp common japanese encodings
1822 1849
1823 A non-exhaustive list of features enabled by "--enable-frills" 1850 A non-exhaustive list of features enabled by "--enable-frills"
1824 (possibly in combination with other switches) is: 1851 (possibly in combination with other switches) is:
1825 1852
1826 MWM-hints 1853 MWM-hints
1854 EWMH-hints (pid, utf8 names) and protocols (ping)
1827 seperate underline colour 1855 seperate underline colour
1828 settable border widths and borderless switch 1856 settable border widths and borderless switch
1829 settable extra linespacing 1857 settable extra linespacing
1830 extra window properties (e.g. UTF-8 window names and PID)
1831 iso-14755-2 and -3, and visual feedback 1858 iso-14755-2 and -3, and visual feedback
1832 backindex and forwardindex escape sequence 1859 backindex and forwardindex escape sequence
1833 window op and locale change escape sequences 1860 window op and some xterm/OSC escape sequences
1834 tripleclickwords 1861 tripleclickwords
1835 settable insecure mode 1862 settable insecure mode
1836 keysym remapping support 1863 keysym remapping support
1864 cursor blinking and underline cursor
1865 -embed and -pty-fd options
1837 1866
1838 --enable-iso14755 1867 --enable-iso14755
1839 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). 1868 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt).
1840 Basic support (section 5.1) is enabled by "--enable-frills", while 1869 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. 1870 support for 5.2, 5.3 and 5.4 is enabled with this switch.
1871 --enable-smart-resize 1900 --enable-smart-resize
1872 Add smart growth/shrink behaviour when changing font size via from 1901 Add smart growth/shrink behaviour when changing font size via from
1873 hot keys. This should keep in a fixed position the rxvt corner which 1902 hot keys. This should keep in a fixed position the rxvt corner which
1874 is closest to a corner of the screen. 1903 is closest to a corner of the screen.
1875 1904
1876 --enable-cursor-blink
1877 Add support for a blinking cursor.
1878
1879 --enable-pointer-blank 1905 --enable-pointer-blank
1880 Add support to have the pointer disappear when typing or inactive. 1906 Add support to have the pointer disappear when typing or inactive.
1881 1907
1882 --with-name=NAME 1908 --with-name=NAME
1883 Set the basename for the installed binaries (default: "urxvt", 1909 Set the basename for the installed binaries (default: "urxvt",

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines