--- rxvt-unicode/doc/rxvt.7.txt 2005/02/14 10:44:50 1.13 +++ rxvt-unicode/doc/rxvt.7.txt 2005/07/13 02:53:54 1.21 @@ -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,12 +68,16 @@ 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 operating systems still compile some programs using the - long-obsoleted termcap (Fedora Core's bash is one example) and rely - on a termcap entry for "rxvt-unicode". + long-obsoleted termcap library (Fedora Core's bash is one example) + and rely on a termcap entry for "rxvt-unicode". You could use rxvt's termcap entry with resonable results in many cases. You can also create a termcap entry by using terminfo's @@ -85,22 +89,23 @@ rxvt-unicode|rxvt-unicode terminal (X Window System):\ :am:bw:eo:km:mi:ms:xn:xo:\ - :co#80:it#8:li#24:\ + :co#80:it#8:li#24:lm#0:\ :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ - :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=^O:al=\E[L:\ - :as=^N:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:cm=\E[%i%d;%dH:\ - :cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:dl=\E[M:do=^J:\ - :ec=\E[%dX:ei=\E[4l:ho=\E[H:i1=\E[?47l\E=\E[?1l:ic=\E[@:\ - :im=\E[4h:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ - :k0=\E[21~:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:\ - :k5=\E[15~:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:\ - :kD=\E[3~:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:\ - :ke=\E[?1l\E>:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:\ - :ku=\EOA:le=^H:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:\ - :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\ - :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\ - :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ + :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\ + :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\ + :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\ + :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\ + :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\ + :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ + :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\ + :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\ + :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\ + :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\ + :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\ + :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\ + :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\ + :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ :vs=\E[?25h: Why does "ls" no longer have coloured output? @@ -248,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 @@ -301,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 @@ -320,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, @@ -1157,19 +1188,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). @@ -1666,13 +1699,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 @@ -1823,16 +1857,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). @@ -1872,9 +1908,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.