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

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.64 by root, Tue Jan 31 20:58:12 2006 UTC vs.
Revision 1.69 by root, Tue Jan 31 21:10:44 2006 UTC

218display, create the listening socket and then fork. 218display, create the listening socket and then fork.
219.PP 219.PP
220\fIHow do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR 220\fIHow do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR
221.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." 221.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."
222.PP 222.PP
223rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", so you can 223The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R",
224check and see if that is set. Note that several programs, \s-1JED\s0, slrn, 224so you can check and see if that is set. Note that several programs, \s-1JED\s0,
225Midnight Commander automatically check this variable to decide whether or 225slrn, Midnight Commander automatically check this variable to decide
226not to use color. 226whether or not to use color.
227.PP 227.PP
228\fIHow do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?\fR 228\fIHow do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?\fR
229.IX Subsection "How do I set the correct, full IP address for the DISPLAY variable?" 229.IX Subsection "How do I set the correct, full IP address for the DISPLAY variable?"
230.PP 230.PP
231If you've compiled rxvt-unicode with \s-1DISPLAY_IS_IP\s0 and have enabled 231If you've compiled rxvt-unicode with \s-1DISPLAY_IS_IP\s0 and have enabled
275\& text data bss drs rss filename 275\& text data bss drs rss filename
276\& 98398 1664 24 15695 1824 rxvt --disable-everything 276\& 98398 1664 24 15695 1824 rxvt --disable-everything
277\& 188985 9048 66616 18222 1788 urxvt --disable-everything 277\& 188985 9048 66616 18222 1788 urxvt --disable-everything
278.Ve 278.Ve
279.PP 279.PP
280When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which _is_ unfair, as this involves xft 280When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft
281and full locale/XIM support which are quite bloaty inside libX11 and my 281and full locale/XIM support which are quite bloaty inside libX11 and my
282libc), the two diverge, but not unreasnobaly so. 282libc), the two diverge, but not unreasnobaly so.
283.PP 283.PP
284.Vb 3 284.Vb 3
285\& text data bss drs rss filename 285\& text data bss drs rss filename
400.Ve 400.Ve
401.PP 401.PP
402Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR 402Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR
403by other values to change the degree of opacity. If it doesn't work and 403by other values to change the degree of opacity. If it doesn't work and
404your server crashes, you got to keep the pieces. 404your server crashes, you got to keep the pieces.
405.PP
406\fIWhy do some chinese characters look so different than others?\fR
407.IX Subsection "Why do some chinese characters look so different than others?"
408.PP
409This is because there is a difference between script and language \*(--
410rxvt-unicode does not know which language the text that is output is,
411as it only knows the unicode character codes. If rxvt-unicode first
412sees a japanese/chinese character, it might choose a japanese font for
413display. Subsequent japanese characters will use that font. Now, many
414chinese characters aren't represented in japanese fonts, so when the first
415non-japanese character comes up, rxvt-unicode will look for a chinese font
416\&\*(-- unfortunately at this point, it will still use the japanese font for
417chinese characters that are also in the japanese font.
418.PP
419The workaround is easy: just tag a chinese font at the end of your font
420list (see the previous question). The key is to view the font list as
421a preference list: If you expect more japanese, list a japanese font
422first. If you expect more chinese, put a chinese font first.
423.PP
424In the future it might be possible to switch language preferences at
425runtime (the internal data structure has no problem with using different
426fonts for the same character at the same time, but no interface for this
427has been designed yet).
428.PP
429Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document).
430.PP 405.PP
431\fIWhy does rxvt-unicode sometimes leave pixel droppings?\fR 406\fIWhy does rxvt-unicode sometimes leave pixel droppings?\fR
432.IX Subsection "Why does rxvt-unicode sometimes leave pixel droppings?" 407.IX Subsection "Why does rxvt-unicode sometimes leave pixel droppings?"
433.PP 408.PP
434Most fonts were not designed for terminal use, which means that character 409Most fonts were not designed for terminal use, which means that character
571\& URxvt.color13: #FF00FF 546\& URxvt.color13: #FF00FF
572\& URxvt.color14: #00FFFF 547\& URxvt.color14: #00FFFF
573\& URxvt.color15: #FFFFFF 548\& URxvt.color15: #FFFFFF
574.Ve 549.Ve
575.PP 550.PP
576And here is a more complete set of non-standard colors described (not by 551And here is a more complete set of non-standard colors.
577me) as \*(L"pretty girly\*(R".
578.PP 552.PP
579.Vb 18 553.Vb 18
580\& URxvt.cursorColor: #dc74d1 554\& URxvt.cursorColor: #dc74d1
581\& URxvt.pointerColor: #dc74d1 555\& URxvt.pointerColor: #dc74d1
582\& URxvt.background: #0e0e0e 556\& URxvt.background: #0e0e0e
595\& URxvt.color14: #73f7ff 569\& URxvt.color14: #73f7ff
596\& URxvt.color7: #e1dddd 570\& URxvt.color7: #e1dddd
597\& URxvt.color15: #e1dddd 571\& URxvt.color15: #e1dddd
598.Ve 572.Ve
599.PP 573.PP
574They have been described (not by me) as \*(L"pretty girly\*(R".
575.PP
600\fIWhy do some characters look so much different than others?\fR 576\fIWhy do some characters look so much different than others?\fR
601.IX Subsection "Why do some characters look so much different than others?" 577.IX Subsection "Why do some characters look so much different than others?"
602.PP 578.PP
603See next entry. 579See next entry.
604.PP 580.PP
630search and use less resources within rxvt-unicode and the X\-server. 606search and use less resources within rxvt-unicode and the X\-server.
631.PP 607.PP
632The only limitation is that none of the fonts may be larger than the base 608The only limitation is that none of the fonts may be larger than the base
633font, as the base font defines the terminal character cell size, which 609font, as the base font defines the terminal character cell size, which
634must be the same due to the way terminals work. 610must be the same due to the way terminals work.
611.PP
612\fIWhy do some chinese characters look so different than others?\fR
613.IX Subsection "Why do some chinese characters look so different than others?"
614.PP
615This is because there is a difference between script and language \*(--
616rxvt-unicode does not know which language the text that is output is,
617as it only knows the unicode character codes. If rxvt-unicode first
618sees a japanese/chinese character, it might choose a japanese font for
619display. Subsequent japanese characters will use that font. Now, many
620chinese characters aren't represented in japanese fonts, so when the first
621non-japanese character comes up, rxvt-unicode will look for a chinese font
622\&\*(-- unfortunately at this point, it will still use the japanese font for
623chinese characters that are also in the japanese font.
624.PP
625The workaround is easy: just tag a chinese font at the end of your font
626list (see the previous question). The key is to view the font list as
627a preference list: If you expect more japanese, list a japanese font
628first. If you expect more chinese, put a chinese font first.
629.PP
630In the future it might be possible to switch language preferences at
631runtime (the internal data structure has no problem with using different
632fonts for the same character at the same time, but no interface for this
633has been designed yet).
634.PP
635Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document).
635.Sh "Keyboard, Mouse & User Interaction" 636.Sh "Keyboard, Mouse & User Interaction"
636.IX Subsection "Keyboard, Mouse & User Interaction" 637.IX Subsection "Keyboard, Mouse & User Interaction"
637\fIThe new selection selects pieces that are too big, how can I select single words?\fR 638\fIThe new selection selects pieces that are too big, how can I select single words?\fR
638.IX Subsection "The new selection selects pieces that are too big, how can I select single words?" 639.IX Subsection "The new selection selects pieces that are too big, how can I select single words?"
639.PP 640.PP
912.Vb 1 913.Vb 1
913\& URxvt.termName: rxvt 914\& URxvt.termName: rxvt
914.Ve 915.Ve
915.PP 916.PP
916If you don't plan to use \fBrxvt\fR (quite common...) you could also replace 917If you don't plan to use \fBrxvt\fR (quite common...) you could also replace
917the rxvt terminfo file with the rxvt-unicode one. 918the rxvt terminfo file with the rxvt-unicode one and use \f(CW\*(C`TERM=rxvt\*(C'\fR.
918.PP 919.PP
919\fI\f(CI\*(C`tic\*(C'\fI outputs some error when compiling the terminfo entry.\fR 920\fI\f(CI\*(C`tic\*(C'\fI outputs some error when compiling the terminfo entry.\fR
920.IX Subsection "tic outputs some error when compiling the terminfo entry." 921.IX Subsection "tic outputs some error when compiling the terminfo entry."
921.PP 922.PP
922Most likely it's the empty definition for \f(CW\*(C`enacs=\*(C'\fR. Just replace it by 923Most likely it's the empty definition for \f(CW\*(C`enacs=\*(C'\fR. Just replace it by
1264old libW11 emulation. 1265old libW11 emulation.
1265.PP 1266.PP
1266At the time of this writing, cygwin didn't seem to support any multi-byte 1267At the time of this writing, cygwin didn't seem to support any multi-byte
1267encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited 1268encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited
1268to 8\-bit encodings. 1269to 8\-bit encodings.
1269.SH "RXVT TECHNICAL REFERENCE" 1270.SH "RXVT-UNICODE TECHNICAL REFERENCE"
1270.IX Header "RXVT TECHNICAL REFERENCE" 1271.IX Header "RXVT-UNICODE TECHNICAL REFERENCE"
1271.SH "DESCRIPTION"
1272.IX Header "DESCRIPTION"
1273The rest of this document describes various technical aspects of 1272The rest of this document describes various technical aspects of
1274\&\fBrxvt-unicode\fR. First the description of supported command sequences, 1273\&\fBrxvt-unicode\fR. First the description of supported command sequences,
1275followed by pixmap support and last by a description of all features 1274followed by pixmap support and last by a description of all features
1276selectable at \f(CW\*(C`configure\*(C'\fR time. 1275selectable at \f(CW\*(C`configure\*(C'\fR time.
1277.SH "Definitions" 1276.Sh "Definitions"
1278.IX Header "Definitions" 1277.IX Subsection "Definitions"
1279.ie n .IP "\fB\fB""c""\fB\fR" 4 1278.ie n .IP "\fB\fB""c""\fB\fR" 4
1280.el .IP "\fB\f(CBc\fB\fR" 4 1279.el .IP "\fB\f(CBc\fB\fR" 4
1281.IX Item "c" 1280.IX Item "c"
1282The literal character c. 1281The literal character c.
1283.ie n .IP "\fB\fB""C""\fB\fR" 4 1282.ie n .IP "\fB\fB""C""\fB\fR" 4
1296parameters, separated by \f(CW\*(C`;\*(C'\fR character(s). 1295parameters, separated by \f(CW\*(C`;\*(C'\fR character(s).
1297.ie n .IP "\fB\fB""Pt""\fB\fR" 4 1296.ie n .IP "\fB\fB""Pt""\fB\fR" 4
1298.el .IP "\fB\f(CBPt\fB\fR" 4 1297.el .IP "\fB\f(CBPt\fB\fR" 4
1299.IX Item "Pt" 1298.IX Item "Pt"
1300A text parameter composed of printable characters. 1299A text parameter composed of printable characters.
1301.SH "Values" 1300.Sh "Values"
1302.IX Header "Values" 1301.IX Subsection "Values"
1303.ie n .IP "\fB\fB""ENQ""\fB\fR" 4 1302.ie n .IP "\fB\fB""ENQ""\fB\fR" 4
1304.el .IP "\fB\f(CBENQ\fB\fR" 4 1303.el .IP "\fB\f(CBENQ\fB\fR" 4
1305.IX Item "ENQ" 1304.IX Item "ENQ"
1306Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0) 1305Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0)
1307request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR. 1306request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR.
1345Switch to Standard Character Set 1344Switch to Standard Character Set
1346.ie n .IP "\fB\fB""SPC""\fB\fR" 4 1345.ie n .IP "\fB\fB""SPC""\fB\fR" 4
1347.el .IP "\fB\f(CBSPC\fB\fR" 4 1346.el .IP "\fB\f(CBSPC\fB\fR" 4
1348.IX Item "SPC" 1347.IX Item "SPC"
1349Space Character 1348Space Character
1350.SH "Escape Sequences" 1349.Sh "Escape Sequences"
1351.IX Header "Escape Sequences" 1350.IX Subsection "Escape Sequences"
1352.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4 1351.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4
1353.el .IP "\fB\f(CBESC # 8\fB\fR" 4 1352.el .IP "\fB\f(CBESC # 8\fB\fR" 4
1354.IX Item "ESC # 8" 1353.IX Item "ESC # 8"
1355\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0) 1354\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)
1356.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4 1355.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4
1449.TE 1448.TE
1450 1449
1451.PP 1450.PP
1452 1451
1453.IX Xref "CSI" 1452.IX Xref "CSI"
1454.SH "CSI (Command Sequence Introducer) Sequences" 1453.Sh "\s-1CSI\s0 (Command Sequence Introducer) Sequences"
1455.IX Header "CSI (Command Sequence Introducer) Sequences" 1454.IX Subsection "CSI (Command Sequence Introducer) Sequences"
1456.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4 1455.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4
1457.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4 1456.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4
1458.IX Item "ESC [ Ps @" 1457.IX Item "ESC [ Ps @"
1459Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0) 1458Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)
1460.IX Xref "ESCOBPsA" 1459.IX Xref "ESCOBPsA"
1723.IX Item "ESC [ Ps x" 1722.IX Item "ESC [ Ps x"
1724Request Terminal Parameters (\s-1DECREQTPARM\s0) 1723Request Terminal Parameters (\s-1DECREQTPARM\s0)
1725.PP 1724.PP
1726 1725
1727.IX Xref "PrivateModes" 1726.IX Xref "PrivateModes"
1728.SH "DEC Private Modes" 1727.Sh "\s-1DEC\s0 Private Modes"
1729.IX Header "DEC Private Modes" 1728.IX Subsection "DEC Private Modes"
1730.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4 1729.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4
1731.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4 1730.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4
1732.IX Item "ESC [ ? Pm h" 1731.IX Item "ESC [ ? Pm h"
1733\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0) 1732\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)
1734.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4 1733.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4
2001.RE 2000.RE
2002.PD 2001.PD
2003.PP 2002.PP
2004 2003
2005.IX Xref "XTerm" 2004.IX Xref "XTerm"
2006.SH "XTerm Operating System Commands" 2005.Sh "XTerm Operating System Commands"
2007.IX Header "XTerm Operating System Commands" 2006.IX Subsection "XTerm Operating System Commands"
2008.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4 2007.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4
2009.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 2008.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4
2010.IX Item "ESC ] Ps;Pt ST" 2009.IX Item "ESC ] Ps;Pt ST"
2011Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b, 2010Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,
20120x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any 20110x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any
2044Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 2043Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2045Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 2044Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2046Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). 2045Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
2047.TE 2046.TE
2048 2047
2049.PP
2050
2051.IX Xref "XPM"
2052.SH "XPM" 2048.SH "XPM"
2053.IX Header "XPM" 2049.IX Header "XPM"
2054For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value 2050For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value
2055of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a 2051of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a
2056sequence of scaling/positioning commands separated by semi\-colons. The 2052sequence of scaling/positioning commands separated by semi\-colons. The
2126.TS 2122.TS
2127l l . 2123l l .
21284 Shift 21244 Shift
21298 Meta 21258 Meta
213016 Control 212616 Control
213132 Double Click (Rxvt extension) 212732 Double Click (rxvt extension)
2132.TE 2128.TE
2133 2129
2134Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR 2130Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR
2135.Sp 2131.Sp
2136Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR 2132Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines