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

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.29 by root, Wed Dec 29 19:17:18 2004 UTC vs.
Revision 1.34 by root, Thu Feb 3 10:24:10 2005 UTC

… …
66 :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\ 66 :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\
67 :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\ 67 :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\
68 :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ 68 :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
69 :vs=\E[?25h: 69 :vs=\E[?25h:
70 70
71=item How can I configure rxvt-unicode so that it looks similar to the original rxvt? 71=item Why does C<ls> no longer have coloured output?
72 72
73Felix von Leitner says that these two lines, in your F<.Xdefaults>, will make rxvt-unicode 73The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to
74behave similar to the original rxvt: 74decide wether a terminal has colour, but uses it's own configuration
75file. Needless to say, C<rxvt-unicode> is not in it's default file (among
76with most other terminals supporting colour). Either add:
75 77
76 URxvt.font: -misc-fixed-medium-r-semicondensed--13-120-75-75-c-60-iso8859-1 78 TERM rxvt-unicode
77 URxvt.boldFont: -misc-fixed-bold-r-semicondensed--13-120-75-75-c-60-iso8859-1 79
80to C</etc/DIR_COLORS> or simply add:
81
82 alias ls='ls --color=auto'
83
84to your C<.profile> or C<.bashrc>.
85
86=item Why doesn't vim/emacs etc. use the 88 colour mode?
87
88=item Why doesn't vim/emacs etc. make use of italic?
89
90=item Why are the secondary screen-related options not working properly?
91
92Make sure you are using C<TERM=rxvt-unicode>. Some pre-packaged
93distributions (most notably Debian GNU/Linux) break rxvt-unicode
94by setting C<TERM> to C<rxvt>, which doesn't have these extra
95features. Unfortunately, some of these (most notably, again, Debian
96GNU/Linux) furthermore fail to even install the C<rxvt-unicode> terminfo
97file, so you will need to install it on your own (See the question B<When
98I log-in to another system it tells me about missing terminfo data?> on
99how to do this).
78 100
79=item Rxvt-unicode does not seem to understand the selected encoding? 101=item Rxvt-unicode does not seem to understand the selected encoding?
80 102
81=item Unicode does not seem to work? 103=item Unicode does not seem to work?
82 104
… …
170however: Xft fonts often draw glyphs larger than their acclaimed bounding 192however: Xft fonts often draw glyphs larger than their acclaimed bounding
171box, and rxvt-unicode has no way of detecting this (the correct way is to 193box, and rxvt-unicode has no way of detecting this (the correct way is to
172ask for the character bounding box, which unfortunately is wrong in these 194ask for the character bounding box, which unfortunately is wrong in these
173cases). 195cases).
174 196
175It's not clear (to me at least), wether this is a bug in Xft, freetype, or 197It's not clear (to me at least), wether this is a bug in Xft, freetype,
176the respective font. If you encounter this problem there is no way to work 198or the respective font. If you encounter this problem you might try using
177around this except by using a different font. 199the C<-lsp> option to give the font more height. If that doesn't work, you
200might be forced to use a different font.
178 201
179All of this is not a problem when using X11 core fonts, as their bounding 202All of this is not a problem when using X11 core fonts, as their bounding
180box data is correct. 203box data is correct.
181 204
182=item My Compose (Multi_key) key is no longer working. 205=item My Compose (Multi_key) key is no longer working.
… …
499 522
500=item I don't like the key-bindings. How do I change them? 523=item I don't like the key-bindings. How do I change them?
501 524
502There are some compile-time selections available via configure. Unless 525There are some compile-time selections available via configure. Unless
503you have run "configure" with the C<--disable-resources> option you can 526you have run "configure" with the C<--disable-resources> option you can
504use the `keysym' resource to alter the keystrings associated with keysym 527use the `keysym' resource to alter the keystrings associated with keysyms.
5050xFF00 - 0xFFFF (function, cursor keys, etc).
506 528
507Here's an example for a tn3270 session started using `@@RXVT_NAME@@ -name tn3270' 529Here's an example for a URxvt session started using `@@RXVT_NAME@@ -name URxvt'
508 530
509 !# ----- special uses ------: 531 URxvt.keysym.Home: \033[1~
510 ! tn3270 login, remap function and arrow keys. 532 URxvt.keysym.End: \033[4~
511 tn3270*font: *clean-bold-*-*--15-* 533 URxvt.keysym.C-apostrophe: \033<C-'>
534 URxvt.keysym.C-slash: \033<C-/>
535 URxvt.keysym.C-semicolon: \033<C-;>
536 URxvt.keysym.C-grave: \033<C-`>
537 URxvt.keysym.C-comma: \033<C-,>
538 URxvt.keysym.C-period: \033<C-.>
539 URxvt.keysym.C-0x60: \033<C-`>
540 URxvt.keysym.C-Tab: \033<C-Tab>
541 URxvt.keysym.C-Return: \033<C-Return>
542 URxvt.keysym.S-Return: \033<S-Return>
543 URxvt.keysym.S-space: \033<S-Space>
544 URxvt.keysym.M-Up: \033<M-Up>
545 URxvt.keysym.M-Down: \033<M-Down>
546 URxvt.keysym.M-Left: \033<M-Left>
547 URxvt.keysym.M-Right: \033<M-Right>
548 URxvt.keysym.M-C-0: list \033<M-C- 0123456789 >
549 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >
550 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
512 551
513 ! keysym - used by rxvt only 552See some more examples in the documentation for the B<keysym> resource.
514 ! Delete - ^D
515 tn3270*keysym.0xFFFF: \004
516
517 ! Home - ^A
518 tn3270*keysym.0xFF50: \001
519 ! Left - ^B
520 tn3270*keysym.0xFF51: \002
521 ! Up - ^P
522 tn3270*keysym.0xFF52: \020
523 ! Right - ^F
524 tn3270*keysym.0xFF53: \006
525 ! Down - ^N
526 tn3270*keysym.0xFF54: \016
527 ! End - ^E
528 tn3270*keysym.0xFF57: \005
529
530 ! F1 - F12
531 tn3270*keysym.0xFFBE: \e1
532 tn3270*keysym.0xFFBF: \e2
533 tn3270*keysym.0xFFC0: \e3
534 tn3270*keysym.0xFFC1: \e4
535 tn3270*keysym.0xFFC2: \e5
536 tn3270*keysym.0xFFC3: \e6
537 tn3270*keysym.0xFFC4: \e7
538 tn3270*keysym.0xFFC5: \e8
539 tn3270*keysym.0xFFC6: \e9
540 tn3270*keysym.0xFFC7: \e0
541 tn3270*keysym.0xFFC8: \e-
542 tn3270*keysym.0xFFC9: \e=
543
544 ! map Prior/Next to F7/F8
545 tn3270*keysym.0xFF55: \e7
546 tn3270*keysym.0xFF56: \e8
547 553
548=item I'm using keyboard model XXX that has extra Prior/Next/Insert keys. 554=item I'm using keyboard model XXX that has extra Prior/Next/Insert keys.
549How do I make use of them? For example, the Sun Keyboard type 4 555How do I make use of them? For example, the Sun Keyboard type 4
550has the following mappings that rxvt-unicode doesn't recognize. 556has the following mappings that rxvt-unicode doesn't recognize.
551 557
… …
554 F27 == Home 560 F27 == Home
555 F29 == Prior 561 F29 == Prior
556 F33 == End 562 F33 == End
557 F35 == Next 563 F35 == Next
558 564
559Rather than have rxvt-unicode try to accommodate all the various possible keyboard 565Rather than have rxvt-unicode try to accommodate all the various possible
560mappings, it is better to use `xmodmap' to remap the keys as required for 566keyboard mappings, it is better to use `xmodmap' to remap the keys as
561your particular machine. 567required for your particular machine.
562 568
563=item How do I distinguish if I'm running rxvt-unicode or a regular xterm? 569=item How do I distinguish if I'm running rxvt-unicode or a regular xterm?
564I need this to decide about setting colors etc. 570I need this to decide about setting colors etc.
565 571
566rxvt and rxvt-unicode always export the variable "COLORTERM", so you can 572rxvt and rxvt-unicode always export the variable "COLORTERM", so you can
… …
1057 1063
1058=item B<< C<ESC [ s> >> 1064=item B<< C<ESC [ s> >>
1059 1065
1060Save Cursor (SC) 1066Save Cursor (SC)
1061 1067
1068=item B<< C<ESC [ Ps;Pt t> >>
1069
1070Window Operations
1071
1072=begin table
1073
1074 B<< C<Ps = 1> >> Deiconify (map) window
1075 B<< C<Ps = 2> >> Iconify window
1076 B<< C<Ps = 3> >> B<< C<ESC [ 3 ; X ; Y t> >> Move window to (X|Y)
1077 B<< C<Ps = 4> >> B<< C<ESC [ 4 ; H ; W t> >> Resize to WxH pixels
1078 B<< C<Ps = 5> >> Raise window
1079 B<< C<Ps = 6> >> Lower window
1080 B<< C<Ps = 7> >> Refresh screen once
1081 B<< C<Ps = 8> >> B<< C<ESC [ 8 ; R ; C t> >> Resize to R rows and C columns
1082 B<< C<Ps = 11> >> Report window state (responds with C<Ps = 1> or C<Ps = 2>
1083 B<< C<Ps = 13> >> Report window position (responds with C<Ps = 3>)
1084 B<< C<Ps = 14> >> Report window pixel size (responds with C<Ps = 4>)
1085 B<< C<Ps = 18> >> Report window text size (responds with C<Ps = 7>)
1086 B<< C<Ps = 19> >> Currently the same as C<Ps = 18>, but responds with C<Ps = 9>
1087 B<< C<Ps = 20> >> Reports icon label (B<< C<ESC ] L NAME \234> >>)
1088 B<< C<Ps = 21> >> Reports window title (B<< C<ESC ] l NAME \234> >>)
1089 B<< C<Ps = 24..> >> Set window height to C<Ps> rows
1090
1091=end table
1092
1093=item B<< C<ESC [ u> >>
1094
1095Restore Cursor
1096
1062=item B<< C<ESC [ Ps x> >> 1097=item B<< C<ESC [ Ps x> >>
1063 1098
1064Request Terminal Parameters (DECREQTPARM) 1099Request Terminal Parameters (DECREQTPARM)
1065
1066=item B<< C<ESC [ u> >>
1067
1068Restore Cursor
1069 1100
1070=back 1101=back
1071 1102
1072X<PrivateModes> 1103X<PrivateModes>
1073 1104
… …
2249 2280
2250Add support for many small features that are not essential but nice to 2281Add support for many small features that are not essential but nice to
2251have. Normally you want this, but for very small binaries you may want to 2282have. Normally you want this, but for very small binaries you may want to
2252disable this. 2283disable this.
2253 2284
2285A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2286in combination with other switches) is:
2287
2288 MWM-hints
2289 seperate underline colour
2290 settable border widths and borderless switch
2291 settable extra linespacing
2292 extra window properties (e.g. UTF-8 window names and PID)
2293 iso-14755-2 and -3, and visual feedback
2294 backindex and forwardindex escape sequence
2295 window op and locale change escape sequences
2296 tripleclickwords
2297 settable insecure mode
2298
2254=item --enable-iso14755 2299=item --enable-iso14755
2255 2300
2256Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2301Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2257F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2302F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by
2258C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with 2303C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with
2259this switch. 2304this switch.
2260 2305
2261=item --enable-linespace
2262
2263Add support to provide user specified line spacing between text rows.
2264
2265=item --enable-keepscrolling 2306=item --enable-keepscrolling
2266 2307
2267Add support for continual scrolling of the display when you hold 2308Add support for continual scrolling of the display when you hold
2268the mouse button down on a scrollbar arrow. 2309the mouse button down on a scrollbar arrow.
2269 2310
… …
2310 2351
2311Add support to have the pointer disappear when typing or inactive. 2352Add support to have the pointer disappear when typing or inactive.
2312 2353
2313=item --with-name=NAME 2354=item --with-name=NAME
2314 2355
2315Set the basename for the installed binaries (default: urxvt, resulting in 2356Set the basename for the installed binaries (default: C<urxvt>, resulting
2316urxvt, urxvtd etc.). Specify --with-name=rxvt to replace rxvt. 2357in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with
2358C<rxvt>.
2317 2359
2318=item --with-term=NAME 2360=item --with-term=NAME
2319 2361
2320Change the environmental variable for the terminal to NAME (default 2362Change the environmental variable for the terminal to NAME (default
2321"rxvt") 2363C<rxvt-unicode>)
2322 2364
2323=item --with-terminfo=PATH 2365=item --with-terminfo=PATH
2324 2366
2325Change the environmental variable for the path to the terminfo tree to 2367Change the environmental variable for the path to the terminfo tree to
2326PATH. 2368PATH.

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines