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.56 by root, Tue Nov 4 23:00:43 2008 UTC vs.
Revision 1.59 by sf-exg, Sat Jul 24 14:20:48 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
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
497 support this (for instance because it is not visual), then rxvt-unicode 498 support this (for instance because it is not visual), then rxvt-unicode
498 will continue without an input method. 499 will continue without an input method.
499 500
500 In this case either do not specify a preeditStyle or specify more than 501 In this case either do not specify a preeditStyle or specify more than
501 one pre-edit style, such as OverTheSpot,Root,None. 502 one pre-edit style, such as OverTheSpot,Root,None.
503
504 If it still doesn't work, then maybe your input method doesn't support
505 compose sequences - to fall back to the built-in one, make sure you
506 don't specify an input method via "-im" or "XMODIFIERS".
502 507
503 I cannot type "Ctrl-Shift-2" to get an ASCII NUL character due to ISO 14755 508 I cannot type "Ctrl-Shift-2" to get an ASCII NUL character due to ISO 14755
504 Either try "Ctrl-2" alone (it often is mapped to ASCII NUL even on 509 Either try "Ctrl-2" alone (it often is mapped to ASCII NUL even on
505 international keyboards) or simply use ISO 14755 support to your 510 international keyboards) or simply use ISO 14755 support to your
506 advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for 511 advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for
646 develop for myself mostly, so I actually use most of the extensions I 651 develop for myself mostly, so I actually use most of the extensions I
647 write. 652 write.
648 653
649 The selection stuff mainly makes the selection perl-error-message aware 654 The selection stuff mainly makes the selection perl-error-message aware
650 and tells it to convert perl error messages into vi-commands to load the 655 and tells it to convert perl error messages into vi-commands to load the
651 relevant file and go tot he error line number. 656 relevant file and go to the error line number.
652 657
653 URxvt.scrollstyle: plain 658 URxvt.scrollstyle: plain
654 URxvt.secondaryScroll: true 659 URxvt.secondaryScroll: true
655 660
656 As the documentation says: plain is the preferred scrollbar for the 661 As the documentation says: plain is the preferred scrollbar for the
729 my purposes, it works, and gives a different look, as my normal 734 my purposes, it works, and gives a different look, as my normal
730 (Non-bold) font is already bold, and I want to see a difference between 735 (Non-bold) font is already bold, and I want to see a difference between
731 bold and normal fonts. 736 bold and normal fonts.
732 737
733 Please note that I used the "urxvt" instance name and not the "URxvt" 738 Please note that I used the "urxvt" instance name and not the "URxvt"
734 class name. Thats because I use different configs for different 739 class name. That is because I use different configs for different
735 purposes, for example, my IRC window is started with "-name IRC", and 740 purposes, for example, my IRC window is started with "-name IRC", and
736 uses these defaults: 741 uses these defaults:
737 742
738 IRC*title: IRC 743 IRC*title: IRC
739 IRC*geometry: 87x12+535+542 744 IRC*geometry: 87x12+535+542
743 IRC*boldFont: suxuseuro 748 IRC*boldFont: suxuseuro
744 IRC*colorBD: white 749 IRC*colorBD: white
745 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007 750 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
746 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007 751 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
747 752
748 "Alt-Shift-1" and "Alt-Shift-2" switch between two different font sizes. 753 "Alt-Ctrl-1" and "Alt-Ctrl-2" switch between two different font sizes.
749 "suxuseuro" allows me to keep an eye (and actually read) stuff while 754 "suxuseuro" allows me to keep an eye (and actually read) stuff while
750 keeping a very small window. If somebody pastes something complicated 755 keeping a very small window. If somebody pastes something complicated
751 (e.g. japanese), I temporarily switch to a larger font. 756 (e.g. japanese), I temporarily switch to a larger font.
752 757
753 The above is all in my ".Xdefaults" (I don't use ".Xresources" nor 758 The above is all in my ".Xdefaults" (I don't use ".Xresources" nor
789 The terminal description used by rxvt-unicode is not as widely available 794 The terminal description used by rxvt-unicode is not as widely available
790 as that for xterm, or even rxvt (for which the same problem often 795 as that for xterm, or even rxvt (for which the same problem often
791 arises). 796 arises).
792 797
793 The correct solution for this problem is to install the terminfo, this 798 The correct solution for this problem is to install the terminfo, this
794 can be done like this (with ncurses' infocmp and works as user and 799 can be done by simply installing rxvt-unicode on the remote system as
795 admin): 800 well (in case you have a nice package manager ready), or you can install
801 the terminfo database manually like this (with ncurses infocmp. works as
802 user and root):
796 803
797 REMOTE=remotesystem.domain 804 REMOTE=remotesystem.domain
798 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" 805 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
799
800 ... or by installing rxvt-unicode normally on the remote system,
801 806
802 One some systems you might need to set $TERMINFO to the full path of 807 One some systems you might need to set $TERMINFO to the full path of
803 $HOME/.terminfo for this to work. 808 $HOME/.terminfo for this to work.
804 809
805 If you cannot or do not want to do this, then you can simply set 810 If you cannot or do not want to do this, then you can simply set
814 819
815 URxvt.termName: rxvt 820 URxvt.termName: rxvt
816 821
817 If you don't plan to use rxvt (quite common...) you could also replace 822 If you don't plan to use rxvt (quite common...) you could also replace
818 the rxvt terminfo file with the rxvt-unicode one and use "TERM=rxvt". 823 the rxvt terminfo file with the rxvt-unicode one and use "TERM=rxvt".
824
825 nano fails with "Error opening terminal: rxvt-unicode"
826 This exceptionally confusing and useless error message is printed by
827 nano when it can't find the terminfo database. Nothing is wrong with
828 your terminal, read the previous answer for a solution.
819 829
820 "tic" outputs some error when compiling the terminfo entry. 830 "tic" outputs some error when compiling the terminfo entry.
821 Most likely it's the empty definition for "enacs=". Just replace it by 831 Most likely it's the empty definition for "enacs=". Just replace it by
822 "enacs=\E[0@" and try again. 832 "enacs=\E[0@" and try again.
823 833
1029 runtime-switchable, too, so there is usually no drawback to enabling 1039 runtime-switchable, too, so there is usually no drawback to enabling
1030 them, except higher disk and possibly memory usage. The perl interpreter 1040 them, except higher disk and possibly memory usage. The perl interpreter
1031 should be enabled, as important functionality (menus, selection, likely 1041 should be enabled, as important functionality (menus, selection, likely
1032 more in the future) depends on it. 1042 more in the future) depends on it.
1033 1043
1034 You should not overwrite the "perl-ext-common" snd "perl-ext" resources 1044 You should not overwrite the "perl-ext-common" and "perl-ext" resources
1035 system-wide (except maybe with "defaults"). This will result in useful 1045 system-wide (except maybe with "defaults"). This will result in useful
1036 behaviour. If your distribution aims at low memory, add an empty 1046 behaviour. If your distribution aims at low memory, add an empty
1037 "perl-ext-common" resource to the app-defaults file. This will keep the 1047 "perl-ext-common" resource to the app-defaults file. This will keep the
1038 perl interpreter disabled until the user enables it. 1048 perl interpreter disabled until the user enables it.
1039 1049

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines