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

Comparing rxvt-unicode/README.FAQ (file contents):
Revision 1.58 by root, Tue Mar 16 00:54:46 2010 UTC vs.
Revision 1.61 by root, Fri Oct 15 21:38:31 2010 UTC

69 This tries to create a new terminal, and if fails with exit status 2, 69 This tries to create a new terminal, and if fails with exit status 2,
70 meaning it couldn't connect to the daemon, it will start the daemon and 70 meaning it couldn't connect to the daemon, it will start the daemon and
71 re-run the command. Subsequent invocations of the script will re-use the 71 re-run the command. Subsequent invocations of the script will re-use the
72 existing daemon. 72 existing daemon.
73 73
74 How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc. 74 How do I distinguish whether I'm running rxvt-unicode or a regular
75xterm? I need this to decide about setting colours etc.
75 The original rxvt and rxvt-unicode always export the variable 76 The original rxvt and rxvt-unicode always export the variable
76 "COLORTERM", so you can check and see if that is set. Note that several 77 "COLORTERM", so you can check and see if that is set. Note that several
77 programs, JED, slrn, Midnight Commander automatically check this 78 programs, JED, slrn, Midnight Commander automatically check this
78 variable to decide whether or not to use color. 79 variable to decide whether or not to use colour.
79 80
80 How do I set the correct, full IP address for the DISPLAY variable? 81 How do I set the correct, full IP address for the DISPLAY variable?
81 If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled 82 If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
82 insecure mode then it is possible to use the following shell script 83 insecure mode then it is possible to use the following shell script
83 snippets to correctly set the display. If your version of rxvt-unicode 84 snippets to correctly set the display. If your version of rxvt-unicode
180 No large bloated libraries (of course, none were linked in statically), 181 No large bloated libraries (of course, none were linked in statically),
181 except maybe libX11 :) 182 except maybe libX11 :)
182 183
183 Rendering, Font & Look and Feel Issues 184 Rendering, Font & Look and Feel Issues
184 I can't get transparency working, what am I doing wrong? 185 I can't get transparency working, what am I doing wrong?
185 First of all, please address all transparency related issues to Sasha 186 First of all, transparency isn't officially supported in rxvt-unicode,
186 Vasko at sasha@aftercode.net and do not bug the author about it. Also, 187 so you are mostly on your own. Do not bug the author about it (but you
187 if you can't get it working consider it a rite of passage: ... and you 188 may bug everybody else). Also, if you can't get it working consider it a
188 failed. 189 rite of passage: ... and you failed.
189 190
190 Here are four ways to get transparency. Do read the manpage and option 191 Here are four ways to get transparency. Do read the manpage and option
191 descriptions for the programs mentioned and rxvt-unicode. Really, do it! 192 descriptions for the programs mentioned and rxvt-unicode. Really, do it!
192 193
193 1. Use transparent mode: 194 1. Use transparent mode:
203 your picture with gimp or any other tool: 204 your picture with gimp or any other tool:
204 205
205 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg 206 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
206 urxvt -pixmap "background.jpg;:root" 207 urxvt -pixmap "background.jpg;:root"
207 208
208 That works. If you think it doesn't, you lack AfterImage support, or you 209 That works. If you think it doesn't, you lack libAfterImage or
209 are unable to read. 210 GDK-PixBuf support, or you are unable to read.
210 211
211 3. Use an ARGB visual: 212 3. Use an ARGB visual:
212 213
213 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 214 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
214 215
312 For the standard background colour, blinking will actually make the text 313 For the standard background colour, blinking will actually make the text
313 blink when compiled with "--enable-text-blink". Without 314 blink when compiled with "--enable-text-blink". Without
314 "--enable-text-blink", the blink attribute will be ignored. 315 "--enable-text-blink", the blink attribute will be ignored.
315 316
316 On ANSI colours, bold/blink attributes are used to set high-intensity 317 On ANSI colours, bold/blink attributes are used to set high-intensity
317 foreground/background colors. 318 foreground/background colours.
318 319
319 color0-7 are the low-intensity colors. 320 color0-7 are the low-intensity colours.
320 321
321 color8-15 are the corresponding high-intensity colors. 322 color8-15 are the corresponding high-intensity colours.
322 323
323 I don't like the screen colors. How do I change them? 324 I don't like the screen colours. How do I change them?
324 You can change the screen colors at run-time using ~/.Xdefaults 325 You can change the screen colours at run-time using ~/.Xdefaults
325 resources (or as long-options). 326 resources (or as long-options).
326 327
327 Here are values that are supposed to resemble a VGA screen, including 328 Here are values that are supposed to resemble a VGA screen, including
328 the murky brown that passes for low-intensity yellow: 329 the murky brown that passes for low-intensity yellow:
329 330
343 URxvt.color12: #0000FF 344 URxvt.color12: #0000FF
344 URxvt.color13: #FF00FF 345 URxvt.color13: #FF00FF
345 URxvt.color14: #00FFFF 346 URxvt.color14: #00FFFF
346 URxvt.color15: #FFFFFF 347 URxvt.color15: #FFFFFF
347 348
348 And here is a more complete set of non-standard colors. 349 And here is a more complete set of non-standard colours.
349 350
350 URxvt.cursorColor: #dc74d1 351 URxvt.cursorColor: #dc74d1
351 URxvt.pointerColor: #dc74d1 352 URxvt.pointerColor: #dc74d1
352 URxvt.background: #0e0e0e 353 URxvt.background: #0e0e0e
353 URxvt.foreground: #4ad5e1 354 URxvt.foreground: #4ad5e1
525 526
526 Historically, either value is correct, but rxvt-unicode adopts the 527 Historically, either value is correct, but rxvt-unicode adopts the
527 debian policy of using "^?" when unsure, because it's the one and only 528 debian policy of using "^?" when unsure, because it's the one and only
528 correct choice :). 529 correct choice :).
529 530
530 Rxvt-unicode tries to inherit the current stty settings and uses the 531 It is possible to toggle between "^H" and "^?" with the DECBKM private
531 value of `erase' to guess the value for backspace. If rxvt-unicode 532 mode:
532 wasn't started from a terminal (say, from a menu or by remote shell),
533 then the system value of `erase', which corresponds to CERASE in
534 <termios.h>, will be used (which may not be the same as your stty
535 setting).
536
537 For starting a new rxvt-unicode:
538 533
539 # use Backspace = ^H 534 # use Backspace = ^H
540 $ stty erase ^H 535 $ stty erase ^H
541 $ urxvt 536 $ echo -n "^[[?67h"
542 537
543 # use Backspace = ^? 538 # use Backspace = ^?
544 $ stty erase ^? 539 $ stty erase ^?
545 $ urxvt
546
547 Toggle with "ESC [ 36 h" / "ESC [ 36 l".
548
549 For an existing rxvt-unicode:
550
551 # use Backspace = ^H
552 $ stty erase ^H
553 $ echo -n "^[[36h"
554
555 # use Backspace = ^?
556 $ stty erase ^?
557 $ echo -n "^[[36l" 540 $ echo -n "^[[?67l"
558 541
559 This helps satisfy some of the Backspace discrepancies that occur, but 542 This helps satisfy some of the Backspace discrepancies that occur, but
560 if you use Backspace = "^H", make sure that the termcap/terminfo value 543 if you use Backspace = "^H", make sure that the termcap/terminfo value
561 properly reflects that. 544 properly reflects that.
562 545
754 keeping a very small window. If somebody pastes something complicated 737 keeping a very small window. If somebody pastes something complicated
755 (e.g. japanese), I temporarily switch to a larger font. 738 (e.g. japanese), I temporarily switch to a larger font.
756 739
757 The above is all in my ".Xdefaults" (I don't use ".Xresources" nor 740 The above is all in my ".Xdefaults" (I don't use ".Xresources" nor
758 "xrdb"). I also have some resources in a separate ".Xdefaults-hostname" 741 "xrdb"). I also have some resources in a separate ".Xdefaults-hostname"
759 file for different hosts, for example, on ym main desktop, I use: 742 file for different hosts, for example, on my main desktop, I use:
760 743
761 URxvt.keysym.C-M-q: command:\033[3;5;5t 744 URxvt.keysym.C-M-q: command:\033[3;5;5t
762 URxvt.keysym.C-M-y: command:\033[3;5;606t 745 URxvt.keysym.C-M-y: command:\033[3;5;606t
763 URxvt.keysym.C-M-e: command:\033[3;1605;5t 746 URxvt.keysym.C-M-e: command:\033[3;1605;5t
764 URxvt.keysym.C-M-c: command:\033[3;1605;606t 747 URxvt.keysym.C-M-c: command:\033[3;1605;606t
1120 The solution is to upgrade your system or switch to a better one. A 1103 The solution is to upgrade your system or switch to a better one. A
1121 possibly working workaround is to use a wcwidth implementation like 1104 possibly working workaround is to use a wcwidth implementation like
1122 1105
1123 http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c 1106 http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
1124 1107
1125 I want 256 colors
1126 Are you sure you need 256 colors? 88 colors should be enough for most
1127 purposes. If you really need more, there is an unsupported patch for it
1128 in the doc directory, but please do not ask for it to be applied.
1129

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines