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

Comparing rxvt-unicode/doc/rxvt.7.html (file contents):
Revision 1.66 by root, Tue Jan 31 21:06:26 2006 UTC vs.
Revision 1.67 by root, Tue Jan 31 21:10:44 2006 UTC

35 35
36 <li><a href="#rendering__font___look_and_feel_issues">Rendering, Font &amp; Look and Feel Issues</a></li> 36 <li><a href="#rendering__font___look_and_feel_issues">Rendering, Font &amp; Look and Feel Issues</a></li>
37 <ul> 37 <ul>
38 38
39 <li><a href="#i_can_t_get_transparency_working__what_am_i_doing_wrong">I can't get transparency working, what am I doing wrong?</a></li> 39 <li><a href="#i_can_t_get_transparency_working__what_am_i_doing_wrong">I can't get transparency working, what am I doing wrong?</a></li>
40 <li><a href="#why_do_some_chinese_characters_look_so_different_than_others">Why do some chinese characters look so different than others?</a></li>
41 <li><a href="#why_does_rxvtunicode_sometimes_leave_pixel_droppings">Why does rxvt-unicode sometimes leave pixel droppings?</a></li> 40 <li><a href="#why_does_rxvtunicode_sometimes_leave_pixel_droppings">Why does rxvt-unicode sometimes leave pixel droppings?</a></li>
42 <li><a href="#how_can_i_keep_rxvtunicode_from_using_reverse_video_so_much">How can I keep rxvt-unicode from using reverse video so much?</a></li> 41 <li><a href="#how_can_i_keep_rxvtunicode_from_using_reverse_video_so_much">How can I keep rxvt-unicode from using reverse video so much?</a></li>
43 <li><a href="#some_programs_assume_totally_weird_colours__red_instead_of_blue___how_can_i_fix_that">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></li> 42 <li><a href="#some_programs_assume_totally_weird_colours__red_instead_of_blue___how_can_i_fix_that">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></li>
44 <li><a href="#can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></li> 43 <li><a href="#can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></li>
45 <li><a href="#why_do_italic_characters_look_as_if_clipped">Why do italic characters look as if clipped?</a></li> 44 <li><a href="#why_do_italic_characters_look_as_if_clipped">Why do italic characters look as if clipped?</a></li>
46 <li><a href="#can_i_speed_up_xft_rendering_somehow">Can I speed up Xft rendering somehow?</a></li> 45 <li><a href="#can_i_speed_up_xft_rendering_somehow">Can I speed up Xft rendering somehow?</a></li>
47 <li><a href="#rxvtunicode_doesn_t_seem_to_antialias_its_fonts__what_is_wrong">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></li> 46 <li><a href="#rxvtunicode_doesn_t_seem_to_antialias_its_fonts__what_is_wrong">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></li>
48 <li><a href="#what_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></li> 47 <li><a href="#what_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></li>
49 <li><a href="#i_don_t_like_the_screen_colors__how_do_i_change_them">I don't like the screen colors. How do I change them?</a></li> 48 <li><a href="#i_don_t_like_the_screen_colors__how_do_i_change_them">I don't like the screen colors. How do I change them?</a></li>
50 <li><a href="#why_do_some_characters_look_so_much_different_than_others">Why do some characters look so much different than others?</a></li> 49 <li><a href="#why_do_some_characters_look_so_much_different_than_others">Why do some characters look so much different than others?</a></li>
50 <li><a href="#how_does_rxvtunicode_choose_fonts">How does rxvt-unicode choose fonts?</a></li>
51 <li><a href="#why_do_some_chinese_characters_look_so_different_than_others">Why do some chinese characters look so different than others?</a></li>
51 </ul> 52 </ul>
52 53
53 <li><a href="#keyboard__mouse___user_interaction">Keyboard, Mouse &amp; User Interaction</a></li> 54 <li><a href="#keyboard__mouse___user_interaction">Keyboard, Mouse &amp; User Interaction</a></li>
54 <ul> 55 <ul>
55 56
105 </ul> 106 </ul>
106 107
107 </ul> 108 </ul>
108 109
109 <li><a href="#rxvtunicode_technical_reference">RXVT-UNICODE TECHNICAL REFERENCE</a></li> 110 <li><a href="#rxvtunicode_technical_reference">RXVT-UNICODE TECHNICAL REFERENCE</a></li>
110 <li><a href="#description">DESCRIPTION</a></li> 111 <ul>
112
111 <li><a href="#definitions">Definitions</a></li> 113 <li><a href="#definitions">Definitions</a></li>
112 <li><a href="#values">Values</a></li> 114 <li><a href="#values">Values</a></li>
113 <li><a href="#escape_sequences">Escape Sequences</a></li> 115 <li><a href="#escape_sequences">Escape Sequences</a></li>
114 <li><a href="#csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></li> 116 <li><a href="#csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></li>
115 <li><a href="#dec_private_modes">DEC Private Modes</a></li> 117 <li><a href="#dec_private_modes">DEC Private Modes</a></li>
116 <li><a href="#xterm_operating_system_commands">XTerm Operating System Commands</a></li> 118 <li><a href="#xterm_operating_system_commands">XTerm Operating System Commands</a></li>
119 </ul>
120
117 <li><a href="#xpm">XPM</a></li> 121 <li><a href="#xpm">XPM</a></li>
118 <li><a href="#mouse_reporting">Mouse Reporting</a></li> 122 <li><a href="#mouse_reporting">Mouse Reporting</a></li>
119 <li><a href="#key_codes">Key Codes</a></li> 123 <li><a href="#key_codes">Key Codes</a></li>
120 <li><a href="#configure_options">CONFIGURE OPTIONS</a></li> 124 <li><a href="#configure_options">CONFIGURE OPTIONS</a></li>
121 <li><a href="#authors">AUTHORS</a></li> 125 <li><a href="#authors">AUTHORS</a></li>
348<p>Then click on a window you want to make transparent. Replace <code>0xc0000000</code> 352<p>Then click on a window you want to make transparent. Replace <code>0xc0000000</code>
349by other values to change the degree of opacity. If it doesn't work and 353by other values to change the degree of opacity. If it doesn't work and
350your server crashes, you got to keep the pieces.</p> 354your server crashes, you got to keep the pieces.</p>
351<p> 355<p>
352</p> 356</p>
357<h3><a name="why_does_rxvtunicode_sometimes_leave_pixel_droppings">Why does rxvt-unicode sometimes leave pixel droppings?</a></h3>
358<p>Most fonts were not designed for terminal use, which means that character
359size varies a lot. A font that is otherwise fine for terminal use might
360contain some characters that are simply too wide. Rxvt-unicode will avoid
361these characters. For characters that are just ``a bit'' too wide a special
362``careful'' rendering mode is used that redraws adjacent characters.</p>
363<p>All of this requires that fonts do not lie about character sizes,
364however: Xft fonts often draw glyphs larger than their acclaimed bounding
365box, and rxvt-unicode has no way of detecting this (the correct way is to
366ask for the character bounding box, which unfortunately is wrong in these
367cases).</p>
368<p>It's not clear (to me at least), wether this is a bug in Xft, freetype,
369or the respective font. If you encounter this problem you might try using
370the <code>-lsp</code> option to give the font more height. If that doesn't work, you
371might be forced to use a different font.</p>
372<p>All of this is not a problem when using X11 core fonts, as their bounding
373box data is correct.</p>
374<p>
375</p>
376<h3><a name="how_can_i_keep_rxvtunicode_from_using_reverse_video_so_much">How can I keep rxvt-unicode from using reverse video so much?</a></h3>
377<p>First of all, make sure you are running with the right terminal settings
378(<code>TERM=rxvt-unicode</code>), which will get rid of most of these effects. Then
379make sure you have specified colours for italic and bold, as otherwise
380rxvt-unicode might use reverse video to simulate the effect:</p>
381<pre>
382 URxvt.colorBD: white
383 URxvt.colorIT: green</pre>
384<p>
385</p>
386<h3><a name="some_programs_assume_totally_weird_colours__red_instead_of_blue___how_can_i_fix_that">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></h3>
387<p>For some unexplainable reason, some rare programs assume a very weird
388colour palette when confronted with a terminal with more than the standard
3898 colours (rxvt-unicode supports 88). The right fix is, of course, to fix
390these programs not to assume non-ISO colours without very good reasons.</p>
391<p>In the meantime, you can either edit your <code>rxvt-unicode</code> terminfo
392definition to only claim 8 colour support or use <code>TERM=rxvt</code>, which will
393fix colours but keep you from using other rxvt-unicode features.</p>
394<p>
395</p>
396<h3><a name="can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></h3>
397<p>Yes, using an escape sequence. Try something like this, which has the same
398effect as using the <code>-fn</code> switch, and takes effect immediately:</p>
399<pre>
400 printf '\e]50;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre>
401<p>This is useful if you e.g. work primarily with japanese (and prefer a
402japanese font), but you have to switch to chinese temporarily, where
403japanese fonts would only be in your way.</p>
404<p>You can think of this as a kind of manual ISO-2022 switching.</p>
405<p>
406</p>
407<h3><a name="why_do_italic_characters_look_as_if_clipped">Why do italic characters look as if clipped?</a></h3>
408<p>Many fonts have difficulties with italic characters and hinting. For
409example, the otherwise very nicely hinted font <code>xft:Bitstream Vera Sans
410Mono</code> completely fails in it's italic face. A workaround might be to
411enable freetype autohinting, i.e. like this:</p>
412<pre>
413 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
414 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true</pre>
415<p>
416</p>
417<h3><a name="can_i_speed_up_xft_rendering_somehow">Can I speed up Xft rendering somehow?</a></h3>
418<p>Yes, the most obvious way to speed it up is to avoid Xft entirely, as
419it is simply slow. If you still want Xft fonts you might try to disable
420antialiasing (by appending <code>:antialias=false</code>), which saves lots of
421memory and also speeds up rendering considerably.</p>
422<p>
423</p>
424<h3><a name="rxvtunicode_doesn_t_seem_to_antialias_its_fonts__what_is_wrong">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></h3>
425<p>Rxvt-unicode will use whatever you specify as a font. If it needs to
426fall back to it's default font search list it will prefer X11 core
427fonts, because they are small and fast, and then use Xft fonts. It has
428antialiasing disabled for most of them, because the author thinks they
429look best that way.</p>
430<p>If you want antialiasing, you have to specify the fonts manually.</p>
431<p>
432</p>
433<h3><a name="what_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></h3>
434<p>If no bold colour is set via <code>colorBD:</code>, bold will invert text using the
435standard foreground colour.</p>
436<p>For the standard background colour, blinking will actually make the
437text blink when compiled with <code>--enable-blinking</code>. with standard
438colours. Without <code>--enable-blinking</code>, the blink attribute will be
439ignored.</p>
440<p>On ANSI colours, bold/blink attributes are used to set high-intensity
441foreground/background colors.</p>
442<p>color0-7 are the low-intensity colors.</p>
443<p>color8-15 are the corresponding high-intensity colors.</p>
444<p>
445</p>
446<h3><a name="i_don_t_like_the_screen_colors__how_do_i_change_them">I don't like the screen colors. How do I change them?</a></h3>
447<p>You can change the screen colors at run-time using <em>~/.Xdefaults</em>
448resources (or as long-options).</p>
449<p>Here are values that are supposed to resemble a VGA screen,
450including the murky brown that passes for low-intensity yellow:</p>
451<pre>
452 URxvt.color0: #000000
453 URxvt.color1: #A80000
454 URxvt.color2: #00A800
455 URxvt.color3: #A8A800
456 URxvt.color4: #0000A8
457 URxvt.color5: #A800A8
458 URxvt.color6: #00A8A8
459 URxvt.color7: #A8A8A8</pre>
460<pre>
461 URxvt.color8: #000054
462 URxvt.color9: #FF0054
463 URxvt.color10: #00FF54
464 URxvt.color11: #FFFF54
465 URxvt.color12: #0000FF
466 URxvt.color13: #FF00FF
467 URxvt.color14: #00FFFF
468 URxvt.color15: #FFFFFF</pre>
469<p>And here is a more complete set of non-standard colors.</p>
470<pre>
471 URxvt.cursorColor: #dc74d1
472 URxvt.pointerColor: #dc74d1
473 URxvt.background: #0e0e0e
474 URxvt.foreground: #4ad5e1
475 URxvt.color0: #000000
476 URxvt.color8: #8b8f93
477 URxvt.color1: #dc74d1
478 URxvt.color9: #dc74d1
479 URxvt.color2: #0eb8c7
480 URxvt.color10: #0eb8c7
481 URxvt.color3: #dfe37e
482 URxvt.color11: #dfe37e
483 URxvt.color5: #9e88f0
484 URxvt.color13: #9e88f0
485 URxvt.color6: #73f7ff
486 URxvt.color14: #73f7ff
487 URxvt.color7: #e1dddd
488 URxvt.color15: #e1dddd</pre>
489<p>They have been described (not by me) as ``pretty girly''.</p>
490<p>
491</p>
492<h3><a name="why_do_some_characters_look_so_much_different_than_others">Why do some characters look so much different than others?</a></h3>
493<p>See next entry.</p>
494<p>
495</p>
496<h3><a name="how_does_rxvtunicode_choose_fonts">How does rxvt-unicode choose fonts?</a></h3>
497<p>Most fonts do not contain the full range of Unicode, which is
498fine. Chances are that the font you (or the admin/package maintainer of
499your system/os) have specified does not cover all the characters you want
500to display.</p>
501<p><strong>rxvt-unicode</strong> makes a best-effort try at finding a replacement
502font. Often the result is fine, but sometimes the chosen font looks
503bad/ugly/wrong. Some fonts have totally strange characters that don't
504resemble the correct glyph at all, and rxvt-unicode lacks the artificial
505intelligence to detect that a specific glyph is wrong: it has to believe
506the font that the characters it claims to contain indeed look correct.</p>
507<p>In that case, select a font of your taste and add it to the font list,
508e.g.:</p>
509<pre>
510 urxvt -fn basefont,font2,font3...</pre>
511<p>When rxvt-unicode sees a character, it will first look at the base
512font. If the base font does not contain the character, it will go to the
513next font, and so on. Specifying your own fonts will also speed up this
514search and use less resources within rxvt-unicode and the X-server.</p>
515<p>The only limitation is that none of the fonts may be larger than the base
516font, as the base font defines the terminal character cell size, which
517must be the same due to the way terminals work.</p>
518<p>
519</p>
353<h3><a name="why_do_some_chinese_characters_look_so_different_than_others">Why do some chinese characters look so different than others?</a></h3> 520<h3><a name="why_do_some_chinese_characters_look_so_different_than_others">Why do some chinese characters look so different than others?</a></h3>
354<p>This is because there is a difference between script and language -- 521<p>This is because there is a difference between script and language --
355rxvt-unicode does not know which language the text that is output is, 522rxvt-unicode does not know which language the text that is output is,
356as it only knows the unicode character codes. If rxvt-unicode first 523as it only knows the unicode character codes. If rxvt-unicode first
357sees a japanese/chinese character, it might choose a japanese font for 524sees a japanese/chinese character, it might choose a japanese font for
367<p>In the future it might be possible to switch language preferences at 534<p>In the future it might be possible to switch language preferences at
368runtime (the internal data structure has no problem with using different 535runtime (the internal data structure has no problem with using different
369fonts for the same character at the same time, but no interface for this 536fonts for the same character at the same time, but no interface for this
370has been designed yet).</p> 537has been designed yet).</p>
371<p>Until then, you might get away with switching fonts at runtime (see <a href="#can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a> later in this document).</p> 538<p>Until then, you might get away with switching fonts at runtime (see <a href="#can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a> later in this document).</p>
372<p>
373</p>
374<h3><a name="why_does_rxvtunicode_sometimes_leave_pixel_droppings">Why does rxvt-unicode sometimes leave pixel droppings?</a></h3>
375<p>Most fonts were not designed for terminal use, which means that character
376size varies a lot. A font that is otherwise fine for terminal use might
377contain some characters that are simply too wide. Rxvt-unicode will avoid
378these characters. For characters that are just ``a bit'' too wide a special
379``careful'' rendering mode is used that redraws adjacent characters.</p>
380<p>All of this requires that fonts do not lie about character sizes,
381however: Xft fonts often draw glyphs larger than their acclaimed bounding
382box, and rxvt-unicode has no way of detecting this (the correct way is to
383ask for the character bounding box, which unfortunately is wrong in these
384cases).</p>
385<p>It's not clear (to me at least), wether this is a bug in Xft, freetype,
386or the respective font. If you encounter this problem you might try using
387the <code>-lsp</code> option to give the font more height. If that doesn't work, you
388might be forced to use a different font.</p>
389<p>All of this is not a problem when using X11 core fonts, as their bounding
390box data is correct.</p>
391<p>
392</p>
393<h3><a name="how_can_i_keep_rxvtunicode_from_using_reverse_video_so_much">How can I keep rxvt-unicode from using reverse video so much?</a></h3>
394<p>First of all, make sure you are running with the right terminal settings
395(<code>TERM=rxvt-unicode</code>), which will get rid of most of these effects. Then
396make sure you have specified colours for italic and bold, as otherwise
397rxvt-unicode might use reverse video to simulate the effect:</p>
398<pre>
399 URxvt.colorBD: white
400 URxvt.colorIT: green</pre>
401<p>
402</p>
403<h3><a name="some_programs_assume_totally_weird_colours__red_instead_of_blue___how_can_i_fix_that">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></h3>
404<p>For some unexplainable reason, some rare programs assume a very weird
405colour palette when confronted with a terminal with more than the standard
4068 colours (rxvt-unicode supports 88). The right fix is, of course, to fix
407these programs not to assume non-ISO colours without very good reasons.</p>
408<p>In the meantime, you can either edit your <code>rxvt-unicode</code> terminfo
409definition to only claim 8 colour support or use <code>TERM=rxvt</code>, which will
410fix colours but keep you from using other rxvt-unicode features.</p>
411<p>
412</p>
413<h3><a name="can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></h3>
414<p>Yes, using an escape sequence. Try something like this, which has the same
415effect as using the <code>-fn</code> switch, and takes effect immediately:</p>
416<pre>
417 printf '\e]50;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre>
418<p>This is useful if you e.g. work primarily with japanese (and prefer a
419japanese font), but you have to switch to chinese temporarily, where
420japanese fonts would only be in your way.</p>
421<p>You can think of this as a kind of manual ISO-2022 switching.</p>
422<p>
423</p>
424<h3><a name="why_do_italic_characters_look_as_if_clipped">Why do italic characters look as if clipped?</a></h3>
425<p>Many fonts have difficulties with italic characters and hinting. For
426example, the otherwise very nicely hinted font <code>xft:Bitstream Vera Sans
427Mono</code> completely fails in it's italic face. A workaround might be to
428enable freetype autohinting, i.e. like this:</p>
429<pre>
430 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
431 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true</pre>
432<p>
433</p>
434<h3><a name="can_i_speed_up_xft_rendering_somehow">Can I speed up Xft rendering somehow?</a></h3>
435<p>Yes, the most obvious way to speed it up is to avoid Xft entirely, as
436it is simply slow. If you still want Xft fonts you might try to disable
437antialiasing (by appending <code>:antialias=false</code>), which saves lots of
438memory and also speeds up rendering considerably.</p>
439<p>
440</p>
441<h3><a name="rxvtunicode_doesn_t_seem_to_antialias_its_fonts__what_is_wrong">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></h3>
442<p>Rxvt-unicode will use whatever you specify as a font. If it needs to
443fall back to it's default font search list it will prefer X11 core
444fonts, because they are small and fast, and then use Xft fonts. It has
445antialiasing disabled for most of them, because the author thinks they
446look best that way.</p>
447<p>If you want antialiasing, you have to specify the fonts manually.</p>
448<p>
449</p>
450<h3><a name="what_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></h3>
451<p>If no bold colour is set via <code>colorBD:</code>, bold will invert text using the
452standard foreground colour.</p>
453<p>For the standard background colour, blinking will actually make the
454text blink when compiled with <code>--enable-blinking</code>. with standard
455colours. Without <code>--enable-blinking</code>, the blink attribute will be
456ignored.</p>
457<p>On ANSI colours, bold/blink attributes are used to set high-intensity
458foreground/background colors.</p>
459<p>color0-7 are the low-intensity colors.</p>
460<p>color8-15 are the corresponding high-intensity colors.</p>
461<p>
462</p>
463<h3><a name="i_don_t_like_the_screen_colors__how_do_i_change_them">I don't like the screen colors. How do I change them?</a></h3>
464<p>You can change the screen colors at run-time using <em>~/.Xdefaults</em>
465resources (or as long-options).</p>
466<p>Here are values that are supposed to resemble a VGA screen,
467including the murky brown that passes for low-intensity yellow:</p>
468<pre>
469 URxvt.color0: #000000
470 URxvt.color1: #A80000
471 URxvt.color2: #00A800
472 URxvt.color3: #A8A800
473 URxvt.color4: #0000A8
474 URxvt.color5: #A800A8
475 URxvt.color6: #00A8A8
476 URxvt.color7: #A8A8A8</pre>
477<pre>
478 URxvt.color8: #000054
479 URxvt.color9: #FF0054
480 URxvt.color10: #00FF54
481 URxvt.color11: #FFFF54
482 URxvt.color12: #0000FF
483 URxvt.color13: #FF00FF
484 URxvt.color14: #00FFFF
485 URxvt.color15: #FFFFFF</pre>
486<p>And here is a more complete set of non-standard colors.</p>
487<pre>
488 URxvt.cursorColor: #dc74d1
489 URxvt.pointerColor: #dc74d1
490 URxvt.background: #0e0e0e
491 URxvt.foreground: #4ad5e1
492 URxvt.color0: #000000
493 URxvt.color8: #8b8f93
494 URxvt.color1: #dc74d1
495 URxvt.color9: #dc74d1
496 URxvt.color2: #0eb8c7
497 URxvt.color10: #0eb8c7
498 URxvt.color3: #dfe37e
499 URxvt.color11: #dfe37e
500 URxvt.color5: #9e88f0
501 URxvt.color13: #9e88f0
502 URxvt.color6: #73f7ff
503 URxvt.color14: #73f7ff
504 URxvt.color7: #e1dddd
505 URxvt.color15: #e1dddd</pre>
506<p>They have been described (not by me) as ``pretty girly''.</p>
507<p>
508</p>
509<h3><a name="why_do_some_characters_look_so_much_different_than_others">Why do some characters look so much different than others?</a></h3>
510<pre>
511
512See next entry.</pre>
513<pre>
514
515=head3 How does rxvt-unicode choose fonts?</pre>
516<pre>
517
518Most fonts do not contain the full range of Unicode, which is
519fine. Chances are that the font you (or the admin/package maintainer of
520your system/os) have specified does not cover all the characters you want
521to display.</pre>
522<pre>
523
524B&lt;rxvt-unicode&gt; makes a best-effort try at finding a replacement
525font. Often the result is fine, but sometimes the chosen font looks
526bad/ugly/wrong. Some fonts have totally strange characters that don't
527resemble the correct glyph at all, and rxvt-unicode lacks the artificial
528intelligence to detect that a specific glyph is wrong: it has to believe
529the font that the characters it claims to contain indeed look correct.</pre>
530<pre>
531
532In that case, select a font of your taste and add it to the font list,
533e.g.:</pre>
534<pre>
535
536 urxvt -fn basefont,font2,font3...</pre>
537<pre>
538
539When rxvt-unicode sees a character, it will first look at the base
540font. If the base font does not contain the character, it will go to the
541next font, and so on. Specifying your own fonts will also speed up this
542search and use less resources within rxvt-unicode and the X-server.</pre>
543<pre>
544
545The only limitation is that none of the fonts may be larger than the base
546font, as the base font defines the terminal character cell size, which
547must be the same due to the way terminals work.</pre>
548<p> 539<p>
549</p> 540</p>
550<h2><a name="keyboard__mouse___user_interaction">Keyboard, Mouse &amp; User Interaction</a></h2> 541<h2><a name="keyboard__mouse___user_interaction">Keyboard, Mouse &amp; User Interaction</a></h2>
551<p> 542<p>
552</p> 543</p>
1049to 8-bit encodings.</p> 1040to 8-bit encodings.</p>
1050<p> 1041<p>
1051</p> 1042</p>
1052<hr /> 1043<hr />
1053<h1><a name="rxvtunicode_technical_reference">RXVT-UNICODE TECHNICAL REFERENCE</a></h1> 1044<h1><a name="rxvtunicode_technical_reference">RXVT-UNICODE TECHNICAL REFERENCE</a></h1>
1054<p>
1055</p>
1056<hr />
1057<h1><a name="description">DESCRIPTION</a></h1>
1058<p>The rest of this document describes various technical aspects of 1045<p>The rest of this document describes various technical aspects of
1059<strong>rxvt-unicode</strong>. First the description of supported command sequences, 1046<strong>rxvt-unicode</strong>. First the description of supported command sequences,
1060followed by pixmap support and last by a description of all features 1047followed by pixmap support and last by a description of all features
1061selectable at <code>configure</code> time.</p> 1048selectable at <code>configure</code> time.</p>
1062<p> 1049<p>
1063</p> 1050</p>
1064<hr />
1065<h1><a name="definitions">Definitions</a></h1> 1051<h2><a name="definitions">Definitions</a></h2>
1066<dl> 1052<dl>
1067<dt><strong><a name="item_c"><strong><code>c</code> </strong>&gt;</a></strong><br /> 1053<dt><strong><a name="item_c"><strong><code>c</code> </strong>&gt;</a></strong><br />
1068</dt> 1054</dt>
1069<dd> 1055<dd>
1070The literal character c. 1056The literal character c.
1096A text parameter composed of printable characters. 1082A text parameter composed of printable characters.
1097</dd> 1083</dd>
1098<p></p></dl> 1084<p></p></dl>
1099<p> 1085<p>
1100</p> 1086</p>
1101<hr />
1102<h1><a name="values">Values</a></h1> 1087<h2><a name="values">Values</a></h2>
1103<dl> 1088<dl>
1104<dt><strong><a name="item_enq"><strong><code>ENQ</code> </strong>&gt;</a></strong><br /> 1089<dt><strong><a name="item_enq"><strong><code>ENQ</code> </strong>&gt;</a></strong><br />
1105</dt> 1090</dt>
1106<dd> 1091<dd>
1107Enquiry (Ctrl-E) = Send Device Attributes (DA) 1092Enquiry (Ctrl-E) = Send Device Attributes (DA)
1170Space Character 1155Space Character
1171</dd> 1156</dd>
1172<p></p></dl> 1157<p></p></dl>
1173<p> 1158<p>
1174</p> 1159</p>
1175<hr />
1176<h1><a name="escape_sequences">Escape Sequences</a></h1> 1160<h2><a name="escape_sequences">Escape Sequences</a></h2>
1177<dl> 1161<dl>
1178<dt><strong><a name="item_esc__23_8"><strong><code>ESC # 8</code> </strong>&gt;</a></strong><br /> 1162<dt><strong><a name="item_esc__23_8"><strong><code>ESC # 8</code> </strong>&gt;</a></strong><br />
1179</dt> 1163</dt>
1180<dd> 1164<dd>
1181DEC Screen Alignment Test (DECALN) 1165DEC Screen Alignment Test (DECALN)
1314<tr><td>C = K </td><td>German character set unimplemented</td></tr> 1298<tr><td>C = K </td><td>German character set unimplemented</td></tr>
1315</table><p></p></dl> 1299</table><p></p></dl>
1316<p></p> 1300<p></p>
1317<p> 1301<p>
1318</p> 1302</p>
1319<hr />
1320<h1><a name="csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></h1> 1303<h2><a name="csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></h2>
1321<dl> 1304<dl>
1322<dt><strong><a name="item_esc__5b_ps__40"><strong><code>ESC [ Ps @</code> </strong>&gt;</a></strong><br /> 1305<dt><strong><a name="item_esc__5b_ps__40"><strong><code>ESC [ Ps @</code> </strong>&gt;</a></strong><br />
1323</dt> 1306</dt>
1324<dd> 1307<dd>
1325Insert <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; (Blank) <code>Character(s)</code> [default: 1] (ICH) 1308Insert <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; (Blank) <code>Character(s)</code> [default: 1] (ICH)
1621</dd> 1604</dd>
1622<p></p></dl> 1605<p></p></dl>
1623<p></p> 1606<p></p>
1624<p> 1607<p>
1625</p> 1608</p>
1626<hr />
1627<h1><a name="dec_private_modes">DEC Private Modes</a></h1> 1609<h2><a name="dec_private_modes">DEC Private Modes</a></h2>
1628<dl> 1610<dl>
1629<dt><strong><a name="item_esc__5b__3f_pm_h"><strong><code>ESC [ ? Pm h</code> </strong>&gt;</a></strong><br /> 1611<dt><strong><a name="item_esc__5b__3f_pm_h"><strong><code>ESC [ ? Pm h</code> </strong>&gt;</a></strong><br />
1630</dt> 1612</dt>
1631<dd> 1613<dd>
1632DEC Private Mode Set (DECSET) 1614DEC Private Mode Set (DECSET)
1798</table></dl> 1780</table></dl>
1799</dl> 1781</dl>
1800<p></p> 1782<p></p>
1801<p> 1783<p>
1802</p> 1784</p>
1803<hr />
1804<h1><a name="xterm_operating_system_commands">XTerm Operating System Commands</a></h1> 1785<h2><a name="xterm_operating_system_commands">XTerm Operating System Commands</a></h2>
1805<dl> 1786<dl>
1806<dt><strong><a name="item_esc__5d_ps_3bpt_st"><strong><code>ESC ] Ps;Pt ST</code> </strong>&gt;</a></strong><br /> 1787<dt><strong><a name="item_esc__5d_ps_3bpt_st"><strong><code>ESC ] Ps;Pt ST</code> </strong>&gt;</a></strong><br />
1807</dt> 1788</dt>
1808<dd> 1789<dd>
1809Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b, 1790Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b,
1841<tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr> 1822<tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1842<tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr> 1823<tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>
1843<tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr> 1824<tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>
1844<tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr> 1825<tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr>
1845</table><p></p></dl> 1826</table><p></p></dl>
1846<p></p>
1847<p> 1827<p>
1848</p> 1828</p>
1849<hr /> 1829<hr />
1850<h1><a name="xpm">XPM</a></h1> 1830<h1><a name="xpm">XPM</a></h1>
1851<p>For the XPM XTerm escape sequence <strong><code>ESC ] 20 ; Pt ST</code> </strong>&gt; then value 1831<p>For the XPM XTerm escape sequence <strong><code>ESC ] 20 ; Pt ST</code> </strong>&gt; then value
2426<p></p> 2406<p></p>
2427<dt><strong><a name="item__2d_2dwith_2dxpm_2dincludes_3ddir">--with-xpm-includes=DIR</a></strong><br /> 2407<dt><strong><a name="item__2d_2dwith_2dxpm_2dincludes_3ddir">--with-xpm-includes=DIR</a></strong><br />
2428</dt> 2408</dt>
2429<dd> 2409<dd>
2430Look for the XPM includes in DIR. 2410Look for the XPM includes in DIR.
2431
2432
2433</dd> 2411</dd>
2434<p></p> 2412<p></p>
2435<dt><strong><a name="item__2d_2dwith_2dxpm_2dlibrary_3ddir">--with-xpm-library=DIR</a></strong><br /> 2413<dt><strong><a name="item__2d_2dwith_2dxpm_2dlibrary_3ddir">--with-xpm-library=DIR</a></strong><br />
2436</dt> 2414</dt>
2437<dd> 2415<dd>
2438Look for the XPM library in DIR. 2416Look for the XPM library in DIR.
2439
2440
2441</dd> 2417</dd>
2442<p></p> 2418<p></p>
2443<dt><strong><a name="item__2d_2dwith_2dxpm">--with-xpm</a></strong><br /> 2419<dt><strong><a name="item__2d_2dwith_2dxpm">--with-xpm</a></strong><br />
2444</dt> 2420</dt>
2445<dd> 2421<dd>
2446Not needed - define via --enable-xpm-background. 2422Not needed - define via --enable-xpm-background.
2447
2448
2449</dd> 2423</dd>
2450<p></p></dl> 2424<p></p></dl>
2451<p> 2425<p>
2452</p> 2426</p>
2453<hr /> 2427<hr />
2454<h1><a name="authors">AUTHORS</a></h1> 2428<h1><a name="authors">AUTHORS</a></h1>
2455<p>Marc Lehmann &lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt; converted this document to pod and 2429<p>Marc Lehmann &lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt; converted this document to pod and
2456reworked it from the original Rxvt documentation, which was done by Geoff 2430reworked it from the original Rxvt documentation, which was done by Geoff
2457Wing &lt;<a href="mailto:gcw@pobox.com">gcw@pobox.com</a>&gt;, who in turn used the XTerm documentation and other 2431Wing &lt;<a href="mailto:gcw@pobox.com">gcw@pobox.com</a>&gt;, who in turn used the XTerm documentation and other
2458sources. 2432sources.</p>
2459
2460</p>
2461 2433
2462</body> 2434</body>
2463 2435
2464</html> 2436</html>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines