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.57 by root, Wed Dec 30 06:14:03 2009 UTC vs.
Revision 1.60 by root, Fri Oct 15 21:30:51 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
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
650 develop for myself mostly, so I actually use most of the extensions I 633 develop for myself mostly, so I actually use most of the extensions I
651 write. 634 write.
652 635
653 The selection stuff mainly makes the selection perl-error-message aware 636 The selection stuff mainly makes the selection perl-error-message aware
654 and tells it to convert perl error messages into vi-commands to load the 637 and tells it to convert perl error messages into vi-commands to load the
655 relevant file and go tot he error line number. 638 relevant file and go to the error line number.
656 639
657 URxvt.scrollstyle: plain 640 URxvt.scrollstyle: plain
658 URxvt.secondaryScroll: true 641 URxvt.secondaryScroll: true
659 642
660 As the documentation says: plain is the preferred scrollbar for the 643 As the documentation says: plain is the preferred scrollbar for the
733 my purposes, it works, and gives a different look, as my normal 716 my purposes, it works, and gives a different look, as my normal
734 (Non-bold) font is already bold, and I want to see a difference between 717 (Non-bold) font is already bold, and I want to see a difference between
735 bold and normal fonts. 718 bold and normal fonts.
736 719
737 Please note that I used the "urxvt" instance name and not the "URxvt" 720 Please note that I used the "urxvt" instance name and not the "URxvt"
738 class name. Thats because I use different configs for different 721 class name. That is because I use different configs for different
739 purposes, for example, my IRC window is started with "-name IRC", and 722 purposes, for example, my IRC window is started with "-name IRC", and
740 uses these defaults: 723 uses these defaults:
741 724
742 IRC*title: IRC 725 IRC*title: IRC
743 IRC*geometry: 87x12+535+542 726 IRC*geometry: 87x12+535+542
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
1038 runtime-switchable, too, so there is usually no drawback to enabling 1021 runtime-switchable, too, so there is usually no drawback to enabling
1039 them, except higher disk and possibly memory usage. The perl interpreter 1022 them, except higher disk and possibly memory usage. The perl interpreter
1040 should be enabled, as important functionality (menus, selection, likely 1023 should be enabled, as important functionality (menus, selection, likely
1041 more in the future) depends on it. 1024 more in the future) depends on it.
1042 1025
1043 You should not overwrite the "perl-ext-common" snd "perl-ext" resources 1026 You should not overwrite the "perl-ext-common" and "perl-ext" resources
1044 system-wide (except maybe with "defaults"). This will result in useful 1027 system-wide (except maybe with "defaults"). This will result in useful
1045 behaviour. If your distribution aims at low memory, add an empty 1028 behaviour. If your distribution aims at low memory, add an empty
1046 "perl-ext-common" resource to the app-defaults file. This will keep the 1029 "perl-ext-common" resource to the app-defaults file. This will keep the
1047 perl interpreter disabled until the user enables it. 1030 perl interpreter disabled until the user enables it.
1048 1031
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