--- rxvt-unicode/README.FAQ 2007/02/17 20:36:35 1.46 +++ rxvt-unicode/README.FAQ 2008/01/25 18:42:22 1.54 @@ -92,8 +92,8 @@ How do I compile the manual pages on my own? You need to have a recent version of perl installed as /usr/bin/perl, - one that comes with pod2man, pod2text and pod2html. Then go to the doc - subdirectory and enter "make alldoc". + one that comes with pod2man, pod2text and pod2xhtml (from Pod::Xhtml). + Then go to the doc subdirectory and enter "make alldoc". Isn't rxvt-unicode supposed to be small? Don't all those features bloat? I often get asked about this, and I think, no, they didn't cause extra @@ -162,27 +162,27 @@ libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) - libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) - libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) - /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) + libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) + libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) + /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) No large bloated libraries (of course, none were linked in statically), except maybe libX11 :) Rendering, Font & Look and Feel Issues I can't get transparency working, what am I doing wrong? - 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. + 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. Here are four ways to get transparency. Do read the manpage and option descriptions for the programs mentioned and rxvt-unicode. Really, do it! - 1. Use inheritPixmap: + 1. Use transparent mode: Esetroot wallpaper.jpg - urxvt -ip -tint red -sh 40 + urxvt -tr -tint red -sh 40 That works. If you think it doesn't, you lack transparency and tinting support, or you are unable to read. @@ -191,11 +191,11 @@ to use effects other than tinting and shading: Just shade/tint/whatever your picture with gimp or any other tool: - convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm - urxvt -pixmap background.xpm -pe automove-background + convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg + urxvt -pixmap "background.jpg;:root" - That works. If you think it doesn't, you lack XPM and Perl support, or - you are unable to read. + That works. If you think it doesn't, you lack AfterImage support, or you + are unable to read. 3. Use an ARGB visual: @@ -299,8 +299,8 @@ standard foreground colour. For the standard background colour, blinking will actually make the text - blink when compiled with "--enable-blinking". with standard colours. - Without "--enable-blinking", the blink attribute will be ignored. + blink when compiled with "--enable-text-blink". Without + "--enable-text-blink", the blink attribute will be ignored. On ANSI colours, bold/blink attributes are used to set high-intensity foreground/background colors. @@ -411,6 +411,12 @@ Until then, you might get away with switching fonts at runtime (see "Can I switch the fonts at runtime?" later in this document). + How can I make mplayer display video correctly? + We are working on it, in the meantime, as a workaround, use something + like: + + urxvt -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...' + Keyboard, Mouse & User Interaction The new selection selects pieces that are too big, how can I select single words? If you want to select e.g. alphanumeric words, you can use the following @@ -426,7 +432,7 @@ URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) - Please also note that the *LeftClick Shift-LeftClik* combination also + Please also note that the *LeftClick Shift-LeftClick* combination also selects words like the old code. I don't like the new selection/popups/hotkeys/perl, how do I change/disable it? @@ -503,7 +509,7 @@ two standard values that can be used for Backspace: "^H" and "^?". Historically, either value is correct, but rxvt-unicode adopts the - debian policy of using "^?" when unsure, because it's the one only only + debian policy of using "^?" when unsure, because it's the one and only correct choice :). Rxvt-unicode tries to inherit the current stty settings and uses the @@ -987,7 +993,7 @@ xprop -root XIM_SERVERS - * + My input method wants but I want UTF-8, what can I do? You can specify separate locales for the input method and the rest of @@ -1061,13 +1067,6 @@ main(), or things like the dynamic loader of your system, which should result in very little risk. - 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) - I am on FreeBSD and rxvt-unicode does not seem to work at all. Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in your compile environment, or an implementation that implements it, @@ -1099,10 +1098,6 @@ 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 @@ -1115,3 +1110,15 @@ multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are likely limited to 8-bit encodings. + Character widths are not correct. + urxvt uses the system wcwidth function to know the information about the + width of characters, so on systems with incorrect locale data you will + likely get bad results. Two notorious examples are Solaris 9, where + single-width characters like U+2514 are reported as double-width, and + Darwin 8, where combining chars are reported having width 1. + + The solution is to upgrade your system or switch to a better one. A + possibly working workaround is to use a wcwidth implementation like + + http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c +