--- rxvt-unicode/doc/rxvt.7.txt 2005/02/17 12:00:33 1.15 +++ rxvt-unicode/doc/rxvt.7.txt 2005/07/13 03:08:57 1.22 @@ -25,10 +25,10 @@ sequence "ESC [ 8 n" sets the window title to the version number. I am using Debian GNU/Linux and have a problem... - The Debian GNU/Linux package of rxvt-unicode contains large patches - that considerably change the behaviour of rxvt-unicode. Before - reporting a bug to the original rxvt-unicode author please download - and install the genuine version + The Debian GNU/Linux package of rxvt-unicode in sarge contains large + patches that considerably change the behaviour of rxvt-unicode. + Before reporting a bug to the original rxvt-unicode author please + download and install the genuine version () 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 @@ -68,6 +68,10 @@ If you don't plan to use rxvt (quite common...) you could also replace the rxvt terminfo file with the rxvt-unicode one. + "tic" outputs some error when compiling the terminfo entry. + Most likely it's the empty definition for "enacs=". Just replace it + by "enacs=\E[0@" and try again. + "bash"'s readline does not work correctly under rxvt. I need a termcap file entry. One reason you might want this is that some distributions or @@ -249,6 +253,13 @@ All of this is not a problem when using X11 core fonts, as their bounding box data is correct. + On Solaris 9, many line-drawing characters are too wide. + Seems to be a known bug, read + . Some people use the + following ugly workaround to get non-double-wide-characters working: + + #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x) + 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 preeditStyle that is not supported @@ -302,13 +313,16 @@ representation of wchar_t. This is, of course, completely fine with respect to standards. - However, "__STDC_ISO_10646__" is the only sane way to support - multi-language apps in an OS, as using a locale-dependent (and - non-standardized) representation of wchar_t makes it impossible to - convert between wchar_t (as used by X11 and your applications) and - any other encoding without implementing OS-specific-wrappers for - each and every locale. There simply are no APIs to convert wchar_t - into anything except the current locale encoding. + However, that means rxvt-unicode only works in "POSIX", "ISO-8859-1" + and "UTF-8" locales under FreeBSD (which all use Unicode as wchar_t. + + "__STDC_ISO_10646__" is the only sane way to support multi-language + apps in an OS, as using a locale-dependent (and non-standardized) + representation of wchar_t makes it impossible to convert between + wchar_t (as used by X11 and your applications) and any other + encoding without implementing OS-specific-wrappers for each and + every locale. There simply are no APIs to convert wchar_t into + anything except the current locale encoding. Some applications (such as the formidable mlterm) work around this by carrying their own replacement functions for character set @@ -321,6 +335,22 @@ the system libraries once and for all, instead of forcing every app to carry complete replacements for them :) + I use Solaris 9 and it doesn't compile/work/etc. + Try the diff in doc/solaris9.patch as a base. It fixes the worst + problems with "wcwidth" and a compile problem. + + How can I use rxvt-unicode under cygwin? + rxvt-unicode should compile and run out of the box on cygwin, using + the X11 libraries that come with cygwin. libW11 emulation is no + longer supported (and makes no sense, either, as it only supported a + single font). I recommend starting the X-server in "-multiwindow" or + "-rootless" mode instead, which will result in similar look&feel as + the old libW11 emulation. + + At the time of this writing, cygwin didn't seem to support any + multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are + likely limited to 8-bit encodings. + How does rxvt-unicode determine the encoding to use? Is there an option to switch encodings? Unlike some other terminals, rxvt-unicode has no encoding switch, @@ -524,14 +554,8 @@ URxvt.color15: #e1dddd How can I start rxvtd in a race-free way? - Despite it's name, rxvtd is not a real daemon, but more like a - server that answers rxvtc's requests, so it doesn't background - itself. - - To ensure rxvtd is listening on it's socket, you can use the - following method to wait for the startup message before continuing: - - { rxvtd & } | read + Try "rxvtd -f -o", which tells rxvtd to open the display, create the + listening socket and then fork. What's with the strange Backspace/Delete key behaviour? Assuming that the physical Backspace key corresponds to the @@ -1158,19 +1182,21 @@ Ps = 18 Change colour of bold characters to Pt Ps = 19 Change colour of underlined characters to Pt Ps = 20 Change default background to Pt - Ps = 39 Change default foreground colour to Pt rxvt compile-time option + Ps = 39 Change default foreground colour to Pt. Ps = 46 Change Log File to Pt unimplemented - Ps = 49 Change default background colour to Pt rxvt compile-time option + Ps = 49 Change default background colour to Pt. Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n Ps = 55 Log all scrollback buffer and all of screen to Pt - Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (rxvt extension) - Ps = 703 Menubar command Pt rxvt compile-time option (rxvt-unicode extension) + Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). + Ps = 703 Menubar command Pt (Compile menubar). Ps = 704 Change colour of italic characters to Pt - Ps = 705 Change background pixmap tint colour to Pt + Ps = 705 Change background pixmap tint colour to Pt (Compile transparency). Ps = 710 Set normal fontset to Pt. Same as Ps = 50. - Ps = 711 Set bold fontset to Pt. Similar to Ps = 50. - Ps = 712 Set italic fontset to Pt. Similar to Ps = 50. - Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50. + Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles). + Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles). + Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles). + Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). + Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). @@ -1667,13 +1693,14 @@ fonts can be set manually or automatically. --with-codesets=NAME,... - Compile in support for additional codeset (encoding) groups (eu, vn - are always compiled in, which includes most 8-bit character sets). - These codeset tables are currently only used for driving X11 core - fonts, they are not required for Xft fonts. Compiling them in will - make your binary bigger (together about 700kB), but it doesn't - increase memory usage unless you use an X11 font requiring one of - these encodings. + Compile in support for additional codeset (encoding) groups ("eu", + "vn" are always compiled in, which includes most 8-bit character + sets). These codeset tables are used for driving X11 core fonts, + they are not required for Xft fonts, although having them compiled + in lets rxvt-unicode choose replacement fonts more intelligently. + Compiling them in will make your binary bigger (all of together cost + about 700kB), but it doesn't increase memory usage unless you use a + font requiring one of these encodings. all all available codeset groups zh common chinese encodings @@ -1824,16 +1851,18 @@ (possibly in combination with other switches) is: MWM-hints + EWMH-hints (pid, utf8 names) and protocols (ping) seperate underline colour settable border widths and borderless switch settable extra linespacing - extra window properties (e.g. UTF-8 window names and PID) iso-14755-2 and -3, and visual feedback backindex and forwardindex escape sequence - window op and locale change escape sequences + window op and some xterm/OSC escape sequences tripleclickwords settable insecure mode keysym remapping support + cursor blinking and underline cursor + -embed and -pty-fd options --enable-iso14755 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). @@ -1873,9 +1902,6 @@ hot keys. This should keep in a fixed position the rxvt corner which is closest to a corner of the screen. - --enable-cursor-blink - Add support for a blinking cursor. - --enable-pointer-blank Add support to have the pointer disappear when typing or inactive.