From: root Date: Tue, 31 Jan 2006 21:06:26 +0000 (+0000) Subject: *** empty log message *** X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=2714e1f0a4c075264253f6d77e6bc66345ec053a;p=dana%2Furxvt.git *** empty log message *** --- diff --git a/doc/rxvt.7.html b/doc/rxvt.7.html index 7dec87d2..2e073ed1 100644 --- a/doc/rxvt.7.html +++ b/doc/rxvt.7.html @@ -47,7 +47,7 @@
  • Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
  • What's with this bold/blink stuff?
  • I don't like the screen colors. How do I change them?
  • -
  • How does rxvt-unicode choose fonts?
  • +
  • Why do some characters look so much different than others?
  • Keyboard, Mouse & User Interaction
  • @@ -503,10 +503,16 @@ including the murky brown that passes for low-intensity yellow:

    URxvt.color14: #73f7ff URxvt.color7: #e1dddd URxvt.color15: #e1dddd -

    (They were described (not by me) as ``pretty girly'').

    +

    They have been described (not by me) as ``pretty girly''.

    -

    How does rxvt-unicode choose fonts?

    +

    Why do some characters look so much different than others?

    +
    +
    +See next entry.
    +
    +
    +=head3 How does rxvt-unicode choose fonts?
     
     Most fonts do not contain the full range of Unicode, which is
    @@ -2422,6 +2428,8 @@ Use the X Window System (pretty much default, eh?).
     
     
    Look for the XPM includes in DIR. + +

    --with-xpm-library=DIR
    diff --git a/doc/rxvt.7.man.in b/doc/rxvt.7.man.in index b54146df..b3668ff9 100644 --- a/doc/rxvt.7.man.in +++ b/doc/rxvt.7.man.in @@ -403,31 +403,6 @@ Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR by other values to change the degree of opacity. If it doesn't work and your server crashes, you got to keep the pieces. .PP -\fIWhy do some chinese characters look so different than others?\fR -.IX Subsection "Why do some chinese characters look so different than others?" -.PP -This is because there is a difference between script and language \*(-- -rxvt-unicode does not know which language the text that is output is, -as it only knows the unicode character codes. If rxvt-unicode first -sees a japanese/chinese character, it might choose a japanese font for -display. Subsequent japanese characters will use that font. Now, many -chinese characters aren't represented in japanese fonts, so when the first -non-japanese character comes up, rxvt-unicode will look for a chinese font -\&\*(-- unfortunately at this point, it will still use the japanese font for -chinese characters that are also in the japanese font. -.PP -The workaround is easy: just tag a chinese font at the end of your font -list (see the previous question). The key is to view the font list as -a preference list: If you expect more japanese, list a japanese font -first. If you expect more chinese, put a chinese font first. -.PP -In the future it might be possible to switch language preferences at -runtime (the internal data structure has no problem with using different -fonts for the same character at the same time, but no interface for this -has been designed yet). -.PP -Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document). -.PP \fIWhy does rxvt-unicode sometimes leave pixel droppings?\fR .IX Subsection "Why does rxvt-unicode sometimes leave pixel droppings?" .PP @@ -633,6 +608,31 @@ search and use less resources within rxvt-unicode and the X\-server. The only limitation is that none of the fonts may be larger than the base font, as the base font defines the terminal character cell size, which must be the same due to the way terminals work. +.PP +\fIWhy do some chinese characters look so different than others?\fR +.IX Subsection "Why do some chinese characters look so different than others?" +.PP +This is because there is a difference between script and language \*(-- +rxvt-unicode does not know which language the text that is output is, +as it only knows the unicode character codes. If rxvt-unicode first +sees a japanese/chinese character, it might choose a japanese font for +display. Subsequent japanese characters will use that font. Now, many +chinese characters aren't represented in japanese fonts, so when the first +non-japanese character comes up, rxvt-unicode will look for a chinese font +\&\*(-- unfortunately at this point, it will still use the japanese font for +chinese characters that are also in the japanese font. +.PP +The workaround is easy: just tag a chinese font at the end of your font +list (see the previous question). The key is to view the font list as +a preference list: If you expect more japanese, list a japanese font +first. If you expect more chinese, put a chinese font first. +.PP +In the future it might be possible to switch language preferences at +runtime (the internal data structure has no problem with using different +fonts for the same character at the same time, but no interface for this +has been designed yet). +.PP +Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document). .Sh "Keyboard, Mouse & User Interaction" .IX Subsection "Keyboard, Mouse & User Interaction" \fIThe new selection selects pieces that are too big, how can I select single words?\fR @@ -1269,14 +1269,12 @@ encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likel to 8\-bit encodings. .SH "RXVT-UNICODE TECHNICAL REFERENCE" .IX Header "RXVT-UNICODE TECHNICAL REFERENCE" -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" The rest of this document describes various technical aspects of \&\fBrxvt-unicode\fR. First the description of supported command sequences, followed by pixmap support and last by a description of all features selectable at \f(CW\*(C`configure\*(C'\fR time. -.SH "Definitions" -.IX Header "Definitions" +.Sh "Definitions" +.IX Subsection "Definitions" .ie n .IP "\fB\fB""c""\fB\fR" 4 .el .IP "\fB\f(CBc\fB\fR" 4 .IX Item "c" @@ -1299,8 +1297,8 @@ parameters, separated by \f(CW\*(C`;\*(C'\fR character(s). .el .IP "\fB\f(CBPt\fB\fR" 4 .IX Item "Pt" A text parameter composed of printable characters. -.SH "Values" -.IX Header "Values" +.Sh "Values" +.IX Subsection "Values" .ie n .IP "\fB\fB""ENQ""\fB\fR" 4 .el .IP "\fB\f(CBENQ\fB\fR" 4 .IX Item "ENQ" @@ -1348,8 +1346,8 @@ Switch to Standard Character Set .el .IP "\fB\f(CBSPC\fB\fR" 4 .IX Item "SPC" Space Character -.SH "Escape Sequences" -.IX Header "Escape Sequences" +.Sh "Escape Sequences" +.IX Subsection "Escape Sequences" .ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4 .el .IP "\fB\f(CBESC # 8\fB\fR" 4 .IX Item "ESC # 8" @@ -1452,8 +1450,8 @@ C = K German character set unimplemented .PP .IX Xref "CSI" -.SH "CSI (Command Sequence Introducer) Sequences" -.IX Header "CSI (Command Sequence Introducer) Sequences" +.Sh "\s-1CSI\s0 (Command Sequence Introducer) Sequences" +.IX Subsection "CSI (Command Sequence Introducer) Sequences" .ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4 .el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4 .IX Item "ESC [ Ps @" @@ -1726,8 +1724,8 @@ Request Terminal Parameters (\s-1DECREQTPARM\s0) .PP .IX Xref "PrivateModes" -.SH "DEC Private Modes" -.IX Header "DEC Private Modes" +.Sh "\s-1DEC\s0 Private Modes" +.IX Subsection "DEC Private Modes" .ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4 .el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4 .IX Item "ESC [ ? Pm h" @@ -2004,8 +2002,8 @@ l Use Normal Screen Buffer .PP .IX Xref "XTerm" -.SH "XTerm Operating System Commands" -.IX Header "XTerm Operating System Commands" +.Sh "XTerm Operating System Commands" +.IX Subsection "XTerm Operating System Commands" .ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4 .el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 .IX Item "ESC ] Ps;Pt ST" @@ -2047,9 +2045,6 @@ Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). .TE -.PP - -.IX Xref "XPM" .SH "XPM" .IX Header "XPM" For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value diff --git a/doc/rxvt.7.pod b/doc/rxvt.7.pod index 62244094..5c902195 100644 --- a/doc/rxvt.7.pod +++ b/doc/rxvt.7.pod @@ -239,31 +239,6 @@ Then click on a window you want to make transparent. Replace C<0xc0000000> by other values to change the degree of opacity. If it doesn't work and your server crashes, you got to keep the pieces. -=head3 Why do some chinese characters look so different than others? - -This is because there is a difference between script and language -- -rxvt-unicode does not know which language the text that is output is, -as it only knows the unicode character codes. If rxvt-unicode first -sees a japanese/chinese character, it might choose a japanese font for -display. Subsequent japanese characters will use that font. Now, many -chinese characters aren't represented in japanese fonts, so when the first -non-japanese character comes up, rxvt-unicode will look for a chinese font --- unfortunately at this point, it will still use the japanese font for -chinese characters that are also in the japanese font. - -The workaround is easy: just tag a chinese font at the end of your font -list (see the previous question). The key is to view the font list as -a preference list: If you expect more japanese, list a japanese font -first. If you expect more chinese, put a chinese font first. - -In the future it might be possible to switch language preferences at -runtime (the internal data structure has no problem with using different -fonts for the same character at the same time, but no interface for this -has been designed yet). - -Until then, you might get away with switching fonts at runtime (see L later in this document). - =head3 Why does rxvt-unicode sometimes leave pixel droppings? Most fonts were not designed for terminal use, which means that character @@ -411,40 +386,64 @@ And here is a more complete set of non-standard colors. URxvt.color7: #e1dddd URxvt.color15: #e1dddd -(They were described (not by me) as "pretty girly"). +They have been described (not by me) as "pretty girly". =head3 Why do some characters look so much different than others? - + See next entry. - + =head3 How does rxvt-unicode choose fonts? - + Most fonts do not contain the full range of Unicode, which is fine. Chances are that the font you (or the admin/package maintainer of your system/os) have specified does not cover all the characters you want to display. - + B makes a best-effort try at finding a replacement font. Often the result is fine, but sometimes the chosen font looks bad/ugly/wrong. Some fonts have totally strange characters that don't resemble the correct glyph at all, and rxvt-unicode lacks the artificial intelligence to detect that a specific glyph is wrong: it has to believe the font that the characters it claims to contain indeed look correct. - + In that case, select a font of your taste and add it to the font list, e.g.: - + @@URXVT_NAME@@ -fn basefont,font2,font3... - + When rxvt-unicode sees a character, it will first look at the base font. If the base font does not contain the character, it will go to the next font, and so on. Specifying your own fonts will also speed up this search and use less resources within rxvt-unicode and the X-server. - + The only limitation is that none of the fonts may be larger than the base font, as the base font defines the terminal character cell size, which must be the same due to the way terminals work. +=head3 Why do some chinese characters look so different than others? + +This is because there is a difference between script and language -- +rxvt-unicode does not know which language the text that is output is, +as it only knows the unicode character codes. If rxvt-unicode first +sees a japanese/chinese character, it might choose a japanese font for +display. Subsequent japanese characters will use that font. Now, many +chinese characters aren't represented in japanese fonts, so when the first +non-japanese character comes up, rxvt-unicode will look for a chinese font +-- unfortunately at this point, it will still use the japanese font for +chinese characters that are also in the japanese font. + +The workaround is easy: just tag a chinese font at the end of your font +list (see the previous question). The key is to view the font list as +a preference list: If you expect more japanese, list a japanese font +first. If you expect more chinese, put a chinese font first. + +In the future it might be possible to switch language preferences at +runtime (the internal data structure has no problem with using different +fonts for the same character at the same time, but no interface for this +has been designed yet). + +Until then, you might get away with switching fonts at runtime (see L later in this document). =head2 Keyboard, Mouse & User Interaction @@ -1008,14 +1007,12 @@ to 8-bit encodings. =head1 RXVT-UNICODE TECHNICAL REFERENCE -=head1 DESCRIPTION - The rest of this document describes various technical aspects of B. First the description of supported command sequences, followed by pixmap support and last by a description of all features selectable at C time. -=head1 Definitions +=head2 Definitions =over 4 @@ -1043,7 +1040,7 @@ A text parameter composed of printable characters. =back -=head1 Values +=head2 Values =over 4 @@ -1096,7 +1093,7 @@ Space Character =back -=head1 Escape Sequences +=head2 Escape Sequences =over 4 @@ -1204,7 +1201,7 @@ Where B<< C >> is one of: X -=head1 CSI (Command Sequence Introducer) Sequences +=head2 CSI (Command Sequence Introducer) Sequences =over 4 @@ -1484,7 +1481,7 @@ Request Terminal Parameters (DECREQTPARM) X -=head1 DEC Private Modes +=head2 DEC Private Modes =over 4 @@ -1758,7 +1755,7 @@ X X -=head1 XTerm Operating System Commands +=head2 XTerm Operating System Commands =over 4 @@ -1806,8 +1803,6 @@ B can be escaped by prefixing it with SYN (0x16, ^V). =back -X - =head1 XPM For the XPM XTerm escape sequence B<< C >> then value diff --git a/doc/rxvt.7.txt b/doc/rxvt.7.txt index 49d64530..955a363c 100644 --- a/doc/rxvt.7.txt +++ b/doc/rxvt.7.txt @@ -221,30 +221,6 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS by other values to change the degree of opacity. If it doesn't work and your server crashes, you got to keep the pieces. - Why do some chinese characters look so different than others? - This is because there is a difference between script and language -- - rxvt-unicode does not know which language the text that is output is, as - it only knows the unicode character codes. If rxvt-unicode first sees a - japanese/chinese character, it might choose a japanese font for display. - Subsequent japanese characters will use that font. Now, many chinese - characters aren't represented in japanese fonts, so when the first - non-japanese character comes up, rxvt-unicode will look for a chinese - font -- unfortunately at this point, it will still use the japanese font - for chinese characters that are also in the japanese font. - - The workaround is easy: just tag a chinese font at the end of your font - list (see the previous question). The key is to view the font list as a - preference list: If you expect more japanese, list a japanese font - first. If you expect more chinese, put a chinese font first. - - In the future it might be possible to switch language preferences at - runtime (the internal data structure has no problem with using different - fonts for the same character at the same time, but no interface for this - has been designed yet). - - Until then, you might get away with switching fonts at runtime (see "Can - I switch the fonts at runtime?" later in this document). - Why does rxvt-unicode sometimes leave pixel droppings? Most fonts were not designed for terminal use, which means that character size varies a lot. A font that is otherwise fine for terminal @@ -384,7 +360,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS URxvt.color7: #e1dddd URxvt.color15: #e1dddd - (They were described (not by me) as "pretty girly"). + They have been described (not by me) as "pretty girly". Why do some characters look so much different than others? See next entry. @@ -406,7 +382,7 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS e.g.: urxvt -fn basefont,font2,font3... - + When rxvt-unicode sees a character, it will first look at the base font. If the base font does not contain the character, it will go to the next font, and so on. Specifying your own fonts will also speed up this @@ -416,6 +392,30 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS base font, as the base font defines the terminal character cell size, which must be the same due to the way terminals work. + Why do some chinese characters look so different than others? + This is because there is a difference between script and language -- + rxvt-unicode does not know which language the text that is output is, as + it only knows the unicode character codes. If rxvt-unicode first sees a + japanese/chinese character, it might choose a japanese font for display. + Subsequent japanese characters will use that font. Now, many chinese + characters aren't represented in japanese fonts, so when the first + non-japanese character comes up, rxvt-unicode will look for a chinese + font -- unfortunately at this point, it will still use the japanese font + for chinese characters that are also in the japanese font. + + The workaround is easy: just tag a chinese font at the end of your font + list (see the previous question). The key is to view the font list as a + preference list: If you expect more japanese, list a japanese font + first. If you expect more chinese, put a chinese font first. + + In the future it might be possible to switch language preferences at + runtime (the internal data structure has no problem with using different + fonts for the same character at the same time, but no interface for this + has been designed yet). + + Until then, you might get away with switching fonts at runtime (see "Can + I switch the fonts at runtime?" later in this document). + Keyboard, Mouse & User Interaction The new selection selects pieces that are too big, how can I select single words? If you want to select e.g. alphanumeric words, you can use the following @@ -938,13 +938,12 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS likely limited to 8-bit encodings. RXVT-UNICODE TECHNICAL REFERENCE -DESCRIPTION The rest of this document describes various technical aspects of rxvt-unicode. First the description of supported command sequences, followed by pixmap support and last by a description of all features selectable at "configure" time. -Definitions + Definitions "c" The literal character c. "C" A single (required) character. @@ -960,7 +959,7 @@ Definitions "Pt" A text parameter composed of printable characters. -Values + Values "ENQ" Enquiry (Ctrl-E) = Send Device Attributes (DA) request attributes from terminal. See "ESC [ Ps c". @@ -997,7 +996,7 @@ Values "SPC" Space Character -Escape Sequences + Escape Sequences "ESC # 8" DEC Screen Alignment Test (DECALN) @@ -1077,7 +1076,7 @@ Escape Sequences -CSI (Command Sequence Introducer) Sequences + CSI (Command Sequence Introducer) Sequences "ESC [ Ps @" Insert "Ps" (Blank) Character(s) [default: 1] (ICH) @@ -1269,7 +1268,7 @@ CSI (Command Sequence Introducer) Sequences -DEC Private Modes + DEC Private Modes "ESC [ ? Pm h" DEC Private Mode Set (DECSET) @@ -1397,7 +1396,7 @@ DEC Private Modes -XTerm Operating System Commands + XTerm Operating System Commands "ESC ] Ps;Pt ST" Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b, 0x5c), backwards compatible terminator BEL (0x07) is also @@ -1436,8 +1435,6 @@ XTerm Operating System Commands Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). - - XPM For the XPM XTerm escape sequence "ESC ] 20 ; Pt ST" then value of "Pt" can be the name of the background pixmap followed by a sequence of