--- rxvt-unicode/doc/rxvt.7.man.in 2006/01/31 20:57:29 1.63 +++ rxvt-unicode/doc/rxvt.7.man.in 2006/01/31 21:10:44 1.69 @@ -155,8 +155,8 @@ .PP The newest version of this document is also available on the World Wide Web at . -.SH "FREQUENTLY ASKED QUESTIONS" -.IX Header "FREQUENTLY ASKED QUESTIONS" +.SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" +.IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" .Sh "Meta, Features & Commandline Issues" .IX Subsection "Meta, Features & Commandline Issues" \fIMy question isn't answered here, can I ask a human?\fR @@ -220,10 +220,10 @@ \fIHow do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR .IX Subsection "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc." .PP -rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", so you can -check and see if that is set. Note that several programs, \s-1JED\s0, slrn, -Midnight Commander automatically check this variable to decide whether or -not to use color. +The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", +so you can check and see if that is set. Note that several programs, \s-1JED\s0, +slrn, Midnight Commander automatically check this variable to decide +whether or not to use color. .PP \fIHow do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?\fR .IX Subsection "How do I set the correct, full IP address for the DISPLAY variable?" @@ -277,7 +277,7 @@ \& 188985 9048 66616 18222 1788 urxvt --disable-everything .Ve .PP -When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which _is_ unfair, as this involves xft +When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft and full locale/XIM support which are quite bloaty inside libX11 and my libc), the two diverge, but not unreasnobaly so. .PP @@ -403,31 +403,6 @@ 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 @@ -573,8 +548,7 @@ \& URxvt.color15: #FFFFFF .Ve .PP -And here is a more complete set of non-standard colors described (not by -me) as \*(L"pretty girly\*(R". +And here is a more complete set of non-standard colors. .PP .Vb 18 \& URxvt.cursorColor: #dc74d1 @@ -597,6 +571,8 @@ \& URxvt.color15: #e1dddd .Ve .PP +They have been described (not by me) as \*(L"pretty girly\*(R". +.PP \fIWhy do some characters look so much different than others?\fR .IX Subsection "Why do some characters look so much different than others?" .PP @@ -632,6 +608,31 @@ 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 @@ -914,7 +915,7 @@ .Ve .PP If you don't plan to use \fBrxvt\fR (quite common...) you could also replace -the rxvt terminfo file with the rxvt-unicode one. +the rxvt terminfo file with the rxvt-unicode one and use \f(CW\*(C`TERM=rxvt\*(C'\fR. .PP \fI\f(CI\*(C`tic\*(C'\fI outputs some error when compiling the terminfo entry.\fR .IX Subsection "tic outputs some error when compiling the terminfo entry." @@ -1266,16 +1267,14 @@ At the time of this writing, cygwin didn't seem to support any multi-byte encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited to 8\-bit encodings. -.SH "RXVT TECHNICAL REFERENCE" -.IX Header "RXVT TECHNICAL REFERENCE" -.SH "DESCRIPTION" -.IX Header "DESCRIPTION" +.SH "RXVT-UNICODE TECHNICAL REFERENCE" +.IX Header "RXVT-UNICODE TECHNICAL REFERENCE" 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" @@ -1298,8 +1297,8 @@ .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" @@ -1347,8 +1346,8 @@ .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" @@ -1451,8 +1450,8 @@ .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 @" @@ -1725,8 +1724,8 @@ .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" @@ -2003,8 +2002,8 @@ .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" @@ -2046,9 +2045,6 @@ 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 @@ -2128,7 +2124,7 @@ 4 Shift 8 Meta 16 Control -32 Double Click (Rxvt extension) +32 Double Click (rxvt extension) .TE Col = \fB\f(CB\*(C` \- SPACE\*(C'\fB\fR