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.25 by root, Mon Sep 6 06:20:40 2004 UTC vs.
Revision 1.33 by root, Sun Jan 16 18:48:04 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.
… …
188does not support this (for instance because it is not visual), then 211does not support this (for instance because it is not visual), then
189rxvt-unicode will continue without an input method. 212rxvt-unicode will continue without an input method.
190 213
191In this case either do not specify a B<preeditStyle> or specify more than 214In this case either do not specify a B<preeditStyle> or specify more than
192one pre-edit style, such as B<OverTheSpot,Root,None>. 215one pre-edit style, such as B<OverTheSpot,Root,None>.
216
217=item I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755
218
219Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on
220international keyboards) or simply use ISO 14755 support to your
221advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for other
222codes, too, such as C<Ctrl-Shift-1-d> to type the default telnet escape
223character and so on.
193 224
194=item How can I keep rxvt-unicode from using reverse video so much? 225=item How can I keep rxvt-unicode from using reverse video so much?
195 226
196First of all, make sure you are running with the right terminfo 227First of all, make sure you are running with the right terminfo
197(C<urxvt>), which will get rid of most of these effects. Then make sure 228(C<urxvt>), which will get rid of most of these effects. Then make sure
… …
391resources (or as long-options). 422resources (or as long-options).
392 423
393Here are values that are supposed to resemble a VGA screen, 424Here are values that are supposed to resemble a VGA screen,
394including the murky brown that passes for low-intensity yellow: 425including the murky brown that passes for low-intensity yellow:
395 426
396 Rxvt*color0: #000000 427 URxvt*color0: #000000
397 Rxvt*color1: #A80000 428 URxvt*color1: #A80000
398 Rxvt*color2: #00A800 429 URxvt*color2: #00A800
399 Rxvt*color3: #A8A800 430 URxvt*color3: #A8A800
400 Rxvt*color4: #0000A8 431 URxvt*color4: #0000A8
401 Rxvt*color5: #A800A8 432 URxvt*color5: #A800A8
402 Rxvt*color6: #00A8A8 433 URxvt*color6: #00A8A8
403 Rxvt*color7: #A8A8A8 434 URxvt*color7: #A8A8A8
404 435
405 Rxvt*color8: #000054 436 URxvt*color8: #000054
406 Rxvt*color9: #FF0054 437 URxvt*color9: #FF0054
407 Rxvt*color10: #00FF54 438 URxvt*color10: #00FF54
408 Rxvt*color11: #FFFF54 439 URxvt*color11: #FFFF54
409 Rxvt*color12: #0000FF 440 URxvt*color12: #0000FF
410 Rxvt*color13: #FF00FF 441 URxvt*color13: #FF00FF
411 Rxvt*color14: #00FFFF 442 URxvt*color14: #00FFFF
412 Rxvt*color15: #FFFFFF 443 URxvt*color15: #FFFFFF
444
445And here is a more complete set of non-standard colors described as
446"pretty girly":
447
448 URxvt.cursorColor: #dc74d1
449 URxvt.pointerColor: #dc74d1
450 URxvt.background: #0e0e0e
451 URxvt.foreground: #4ad5e1
452 URxvt.color0: #000000
453 URxvt.color8: #8b8f93
454 URxvt.color1: #dc74d1
455 URxvt.color9: #dc74d1
456 URxvt.color2: #0eb8c7
457 URxvt.color10: #0eb8c7
458 URxvt.color3: #dfe37e
459 URxvt.color11: #dfe37e
460 URxvt.color5: #9e88f0
461 URxvt.color13: #9e88f0
462 URxvt.color6: #73f7ff
463 URxvt.color14: #73f7ff
464 URxvt.color7: #e1dddd
465 URxvt.color15: #e1dddd
413 466
414=item What's with the strange Backspace/Delete key behaviour? 467=item What's with the strange Backspace/Delete key behaviour?
415 468
416Assuming that the physical Backspace key corresponds to the 469Assuming that the physical Backspace key corresponds to the
417BackSpace keysym (not likely for Linux ... see the following 470BackSpace keysym (not likely for Linux ... see the following
… …
469 522
470=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?
471 524
472There are some compile-time selections available via configure. Unless 525There are some compile-time selections available via configure. Unless
473you have run "configure" with the C<--disable-resources> option you can 526you have run "configure" with the C<--disable-resources> option you can
474use the `keysym' resource to alter the keystrings associated with keysym 527use the `keysym' resource to alter the keystrings associated with keysyms.
4750xFF00 - 0xFFFF (function, cursor keys, etc).
476 528
477Here'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'
478 530
479 !# ----- special uses ------: 531 URxvt*keysym.Home: \e[1~
480 ! tn3270 login, remap function and arrow keys. 532 URxvt*keysym.End: \e[4~
481 tn3270*font: *clean-bold-*-*--15-* 533 URxvt*keysym.C-apostrophe: \e<C-'>
482 534 URxvt*keysym.C-slash: \e<C-/>
483 ! keysym - used by rxvt only 535 URxvt*keysym.C-semicolon: \e<C-;>
484 ! Delete - ^D 536 URxvt*keysym.C-grave: \e<C-`>
485 tn3270*keysym.0xFFFF: \004 537 URxvt*keysym.C-comma: \e<C-,>
486 538 URxvt*keysym.C-period: \e<C-.>
487 ! Home - ^A 539 URxvt*keysym.C-0x60: \e<C-`>
488 tn3270*keysym.0xFF50: \001 540 URxvt*keysym.C-Tab: \e<C-Tab>
489 ! Left - ^B 541 URxvt*keysym.C-Return: \e<C-Return>
490 tn3270*keysym.0xFF51: \002 542 URxvt*keysym.S-Return: \e<S-Return>
491 ! Up - ^P 543 URxvt*keysym.S-space: \e<S-Space>
492 tn3270*keysym.0xFF52: \020 544 URxvt*keysym.M-Up: \e<M-Up>
493 ! Right - ^F 545 URxvt*keysym.M-Down: \e<M-Down>
494 tn3270*keysym.0xFF53: \006 546 URxvt*keysym.M-Left: \e<M-Left>
495 ! Down - ^N 547 URxvt*keysym.M-Right: \e<M-Right>
496 tn3270*keysym.0xFF54: \016 548 URxvt*keysym.M-C-0: list.0123456789.\e<M-C-.>
497 ! End - ^E 549 URxvt*keysym.M-C-a: list.abcdefghijklmnopqrstuvwxyz.\033<M-C-.>
498 tn3270*keysym.0xFF57: \005 550 URxvt*keysym.F12: proto:\033]701;zh_CN.GBK\007
499
500 ! F1 - F12
501 tn3270*keysym.0xFFBE: \e1
502 tn3270*keysym.0xFFBF: \e2
503 tn3270*keysym.0xFFC0: \e3
504 tn3270*keysym.0xFFC1: \e4
505 tn3270*keysym.0xFFC2: \e5
506 tn3270*keysym.0xFFC3: \e6
507 tn3270*keysym.0xFFC4: \e7
508 tn3270*keysym.0xFFC5: \e8
509 tn3270*keysym.0xFFC6: \e9
510 tn3270*keysym.0xFFC7: \e0
511 tn3270*keysym.0xFFC8: \e-
512 tn3270*keysym.0xFFC9: \e=
513
514 ! map Prior/Next to F7/F8
515 tn3270*keysym.0xFF55: \e7
516 tn3270*keysym.0xFF56: \e8
517 551
518=item I'm using keyboard model XXX that has extra Prior/Next/Insert keys. 552=item I'm using keyboard model XXX that has extra Prior/Next/Insert keys.
519How do I make use of them? For example, the Sun Keyboard type 4 553How do I make use of them? For example, the Sun Keyboard type 4
520has the following mappings that rxvt-unicode doesn't recognize. 554has the following mappings that rxvt-unicode doesn't recognize.
521 555
… …
566=item How do I compile the manual pages for myself? 600=item How do I compile the manual pages for myself?
567 601
568You need to have a recent version of perl installed as F</usr/bin/perl>, 602You need to have a recent version of perl installed as F</usr/bin/perl>,
569one that comes with F<pod2man>, F<pod2text> and F<pod2html>. Then go to 603one that comes with F<pod2man>, F<pod2text> and F<pod2html>. Then go to
570the doc subdirectory and enter C<make alldoc>. 604the doc subdirectory and enter C<make alldoc>.
605
606=item My question isn't answered here, can I ask a human?
607
608Before sending me mail, you could go to IRC: C<irc.freenode.net>,
609channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be
610interested in learning about new and exciting problems (but not FAQs :).
571 611
572=back 612=back
573 613
574=head1 SYNOPSIS 614=head1 SYNOPSIS
575 615
… …
2048you use an X11 font requiring one of these encodings. 2088you use an X11 font requiring one of these encodings.
2049 2089
2050=begin table 2090=begin table
2051 2091
2052 all all available codeset groups 2092 all all available codeset groups
2053 cn common chinese encodings 2093 zh common chinese encodings
2054 cn_ext rarely used but very big chinese encodigs 2094 zh_ext rarely used but very big chinese encodigs
2055 jp common japanese encodings 2095 jp common japanese encodings
2056 jp_ext rarely used but big japanese encodings 2096 jp_ext rarely used but big japanese encodings
2057 kr korean encodings 2097 kr korean encodings
2058 2098
2059=end table 2099=end table
… …
2213 2253
2214Add support for many small features that are not essential but nice to 2254Add support for many small features that are not essential but nice to
2215have. Normally you want this, but for very small binaries you may want to 2255have. Normally you want this, but for very small binaries you may want to
2216disable this. 2256disable this.
2217 2257
2258A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2259in combination with other switches) is:
2260
2261 MWM-hints
2262 seperate underline colour
2263 settable border widths and borderless switch
2264 settable extra linespacing
2265 extra window properties (e.g. UTF-8 window names and PID)
2266 iso-14755-2 and -3, and visual feedback
2267 backindex and forwardindex escape sequence
2268 window op and locale change escape sequences
2269 tripleclickwords
2270 settable insecure mode
2271
2218=item --enable-iso14755 2272=item --enable-iso14755
2219 2273
2220Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2274Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2221F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2275F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by
2222C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with 2276C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with
2223this switch. 2277this switch.
2224 2278
2225=item --enable-linespace
2226
2227Add support to provide user specified line spacing between text rows.
2228
2229=item --enable-keepscrolling 2279=item --enable-keepscrolling
2230 2280
2231Add support for continual scrolling of the display when you hold 2281Add support for continual scrolling of the display when you hold
2232the mouse button down on a scrollbar arrow. 2282the mouse button down on a scrollbar arrow.
2233 2283
… …
2274 2324
2275Add support to have the pointer disappear when typing or inactive. 2325Add support to have the pointer disappear when typing or inactive.
2276 2326
2277=item --with-name=NAME 2327=item --with-name=NAME
2278 2328
2279Set the basename for the installed binaries (default: urxvt, resulting in 2329Set the basename for the installed binaries (default: C<urxvt>, resulting
2280urxvt, urxvtd etc.). Specify --with-name=rxvt to replace rxvt. 2330in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with
2331C<rxvt>.
2281 2332
2282=item --with-term=NAME 2333=item --with-term=NAME
2283 2334
2284Change the environmental variable for the terminal to NAME (default 2335Change the environmental variable for the terminal to NAME (default
2285"rxvt") 2336C<rxvt-unicode>)
2286 2337
2287=item --with-terminfo=PATH 2338=item --with-terminfo=PATH
2288 2339
2289Change the environmental variable for the path to the terminfo tree to 2340Change the environmental variable for the path to the terminfo tree to
2290PATH. 2341PATH.

Diff Legend

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