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.67 by root, Tue Jan 31 21:04:56 2006 UTC vs.
Revision 1.70 by root, Thu Feb 2 00:31:47 2006 UTC

… …
127.\} 127.\}
128.rm #[ #] #H #V #F C 128.rm #[ #] #H #V #F C
129.\" ======================================================================== 129.\" ========================================================================
130.\" 130.\"
131.IX Title "rxvt 7" 131.IX Title "rxvt 7"
132.TH rxvt 7 "2006-01-31" "7.5" "RXVT-UNICODE" 132.TH rxvt 7 "2006-02-02" "7.5" "RXVT-UNICODE"
133.SH "NAME" 133.SH "NAME"
134RXVT REFERENCE \- FAQ, command sequences and other background information 134RXVT REFERENCE \- FAQ, command sequences and other background information
135.SH "SYNOPSIS" 135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS" 136.IX Header "SYNOPSIS"
137.Vb 2 137.Vb 2
… …
214\fIHow can I start @@URXVT_NAME@@d in a race-free way?\fR 214\fIHow can I start @@URXVT_NAME@@d in a race-free way?\fR
215.IX Subsection "How can I start @@URXVT_NAME@@d in a race-free way?" 215.IX Subsection "How can I start @@URXVT_NAME@@d in a race-free way?"
216.PP 216.PP
217Try \f(CW\*(C`@@URXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@URXVT_NAME@@d to open the 217Try \f(CW\*(C`@@URXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@URXVT_NAME@@d to open the
218display, create the listening socket and then fork. 218display, create the listening socket and then fork.
219.PP
220\fIHow can I start @@URXVT_NAME@@d automatically when I run URXVT_NAME@@c?\fR
221.IX Subsection "How can I start @@URXVT_NAME@@d automatically when I run URXVT_NAME@@c?"
222.PP
223If you want to start @@URXVT_NAME@@d automatically whenever you run
224@@URXVT_NAME@@c and the daemon isn't running yet, use this script:
225.PP
226.Vb 6
227\& #!/bin/sh
228\& @@URXVT_NAME@@c "$@"
229\& if [ $? -eq 2 ]; then
230\& @@URXVT_NAME@@d -q -o -f
231\& @@URXVT_NAME@@c "$@"
232\& fi
233.Ve
234.PP
235This tries to create a new terminal, and if fails with exit status 2,
236meaning it couldn't connect to the daemon, it will start the daemon and
237re-run the command. Subsequent invocations of the script will re-use the
238existing daemon.
219.PP 239.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 240\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." 241.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 242.PP
223The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", 243The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R",
… …
400.Ve 420.Ve
401.PP 421.PP
402Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR 422Then 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 423by other values to change the degree of opacity. If it doesn't work and
404your server crashes, you got to keep the pieces. 424your 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 425.PP
431\fIWhy does rxvt-unicode sometimes leave pixel droppings?\fR 426\fIWhy does rxvt-unicode sometimes leave pixel droppings?\fR
432.IX Subsection "Why does rxvt-unicode sometimes leave pixel droppings?" 427.IX Subsection "Why does rxvt-unicode sometimes leave pixel droppings?"
433.PP 428.PP
434Most fonts were not designed for terminal use, which means that character 429Most fonts were not designed for terminal use, which means that character
… …
594\& URxvt.color14: #73f7ff 589\& URxvt.color14: #73f7ff
595\& URxvt.color7: #e1dddd 590\& URxvt.color7: #e1dddd
596\& URxvt.color15: #e1dddd 591\& URxvt.color15: #e1dddd
597.Ve 592.Ve
598.PP 593.PP
599(They were described (not by me) as \*(L"pretty girly\*(R"). 594They have been described (not by me) as \*(L"pretty girly\*(R".
595.PP
596\fIWhy do some characters look so much different than others?\fR
597.IX Subsection "Why do some characters look so much different than others?"
598.PP
599See next entry.
600.PP 600.PP
601\fIHow does rxvt-unicode choose fonts?\fR 601\fIHow does rxvt-unicode choose fonts?\fR
602.IX Subsection "How does rxvt-unicode choose fonts?" 602.IX Subsection "How does rxvt-unicode choose fonts?"
603.PP 603.PP
604Most fonts do not contain the full range of Unicode, which is 604Most fonts do not contain the full range of Unicode, which is
… …
626search and use less resources within rxvt-unicode and the X\-server. 626search and use less resources within rxvt-unicode and the X\-server.
627.PP 627.PP
628The only limitation is that none of the fonts may be larger than the base 628The only limitation is that none of the fonts may be larger than the base
629font, as the base font defines the terminal character cell size, which 629font, as the base font defines the terminal character cell size, which
630must be the same due to the way terminals work. 630must be the same due to the way terminals work.
631.PP
632\fIWhy do some chinese characters look so different than others?\fR
633.IX Subsection "Why do some chinese characters look so different than others?"
634.PP
635This is because there is a difference between script and language \*(--
636rxvt-unicode does not know which language the text that is output is,
637as it only knows the unicode character codes. If rxvt-unicode first
638sees a japanese/chinese character, it might choose a japanese font for
639display. Subsequent japanese characters will use that font. Now, many
640chinese characters aren't represented in japanese fonts, so when the first
641non-japanese character comes up, rxvt-unicode will look for a chinese font
642\&\*(-- unfortunately at this point, it will still use the japanese font for
643chinese characters that are also in the japanese font.
644.PP
645The workaround is easy: just tag a chinese font at the end of your font
646list (see the previous question). The key is to view the font list as
647a preference list: If you expect more japanese, list a japanese font
648first. If you expect more chinese, put a chinese font first.
649.PP
650In the future it might be possible to switch language preferences at
651runtime (the internal data structure has no problem with using different
652fonts for the same character at the same time, but no interface for this
653has been designed yet).
654.PP
655Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document).
631.Sh "Keyboard, Mouse & User Interaction" 656.Sh "Keyboard, Mouse & User Interaction"
632.IX Subsection "Keyboard, Mouse & User Interaction" 657.IX Subsection "Keyboard, Mouse & User Interaction"
633\fIThe new selection selects pieces that are too big, how can I select single words?\fR 658\fIThe new selection selects pieces that are too big, how can I select single words?\fR
634.IX Subsection "The new selection selects pieces that are too big, how can I select single words?" 659.IX Subsection "The new selection selects pieces that are too big, how can I select single words?"
635.PP 660.PP
… …
1262At the time of this writing, cygwin didn't seem to support any multi-byte 1287At the time of this writing, cygwin didn't seem to support any multi-byte
1263encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited 1288encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited
1264to 8\-bit encodings. 1289to 8\-bit encodings.
1265.SH "RXVT-UNICODE TECHNICAL REFERENCE" 1290.SH "RXVT-UNICODE TECHNICAL REFERENCE"
1266.IX Header "RXVT-UNICODE TECHNICAL REFERENCE" 1291.IX Header "RXVT-UNICODE TECHNICAL REFERENCE"
1267.SH "DESCRIPTION"
1268.IX Header "DESCRIPTION"
1269The rest of this document describes various technical aspects of 1292The rest of this document describes various technical aspects of
1270\&\fBrxvt-unicode\fR. First the description of supported command sequences, 1293\&\fBrxvt-unicode\fR. First the description of supported command sequences,
1271followed by pixmap support and last by a description of all features 1294followed by pixmap support and last by a description of all features
1272selectable at \f(CW\*(C`configure\*(C'\fR time. 1295selectable at \f(CW\*(C`configure\*(C'\fR time.
1273.SH "Definitions" 1296.Sh "Definitions"
1274.IX Header "Definitions" 1297.IX Subsection "Definitions"
1275.ie n .IP "\fB\fB""c""\fB\fR" 4 1298.ie n .IP "\fB\fB""c""\fB\fR" 4
1276.el .IP "\fB\f(CBc\fB\fR" 4 1299.el .IP "\fB\f(CBc\fB\fR" 4
1277.IX Item "c" 1300.IX Item "c"
1278The literal character c. 1301The literal character c.
1279.ie n .IP "\fB\fB""C""\fB\fR" 4 1302.ie n .IP "\fB\fB""C""\fB\fR" 4
… …
1292parameters, separated by \f(CW\*(C`;\*(C'\fR character(s). 1315parameters, separated by \f(CW\*(C`;\*(C'\fR character(s).
1293.ie n .IP "\fB\fB""Pt""\fB\fR" 4 1316.ie n .IP "\fB\fB""Pt""\fB\fR" 4
1294.el .IP "\fB\f(CBPt\fB\fR" 4 1317.el .IP "\fB\f(CBPt\fB\fR" 4
1295.IX Item "Pt" 1318.IX Item "Pt"
1296A text parameter composed of printable characters. 1319A text parameter composed of printable characters.
1297.SH "Values" 1320.Sh "Values"
1298.IX Header "Values" 1321.IX Subsection "Values"
1299.ie n .IP "\fB\fB""ENQ""\fB\fR" 4 1322.ie n .IP "\fB\fB""ENQ""\fB\fR" 4
1300.el .IP "\fB\f(CBENQ\fB\fR" 4 1323.el .IP "\fB\f(CBENQ\fB\fR" 4
1301.IX Item "ENQ" 1324.IX Item "ENQ"
1302Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0) 1325Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0)
1303request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR. 1326request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR.
… …
1341Switch to Standard Character Set 1364Switch to Standard Character Set
1342.ie n .IP "\fB\fB""SPC""\fB\fR" 4 1365.ie n .IP "\fB\fB""SPC""\fB\fR" 4
1343.el .IP "\fB\f(CBSPC\fB\fR" 4 1366.el .IP "\fB\f(CBSPC\fB\fR" 4
1344.IX Item "SPC" 1367.IX Item "SPC"
1345Space Character 1368Space Character
1346.SH "Escape Sequences" 1369.Sh "Escape Sequences"
1347.IX Header "Escape Sequences" 1370.IX Subsection "Escape Sequences"
1348.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4 1371.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4
1349.el .IP "\fB\f(CBESC # 8\fB\fR" 4 1372.el .IP "\fB\f(CBESC # 8\fB\fR" 4
1350.IX Item "ESC # 8" 1373.IX Item "ESC # 8"
1351\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0) 1374\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)
1352.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4 1375.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4
… …
1445.TE 1468.TE
1446 1469
1447.PP 1470.PP
1448 1471
1449.IX Xref "CSI" 1472.IX Xref "CSI"
1450.SH "CSI (Command Sequence Introducer) Sequences" 1473.Sh "\s-1CSI\s0 (Command Sequence Introducer) Sequences"
1451.IX Header "CSI (Command Sequence Introducer) Sequences" 1474.IX Subsection "CSI (Command Sequence Introducer) Sequences"
1452.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4 1475.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4
1453.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4 1476.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4
1454.IX Item "ESC [ Ps @" 1477.IX Item "ESC [ Ps @"
1455Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0) 1478Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)
1456.IX Xref "ESCOBPsA" 1479.IX Xref "ESCOBPsA"
… …
1719.IX Item "ESC [ Ps x" 1742.IX Item "ESC [ Ps x"
1720Request Terminal Parameters (\s-1DECREQTPARM\s0) 1743Request Terminal Parameters (\s-1DECREQTPARM\s0)
1721.PP 1744.PP
1722 1745
1723.IX Xref "PrivateModes" 1746.IX Xref "PrivateModes"
1724.SH "DEC Private Modes" 1747.Sh "\s-1DEC\s0 Private Modes"
1725.IX Header "DEC Private Modes" 1748.IX Subsection "DEC Private Modes"
1726.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4 1749.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4
1727.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4 1750.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4
1728.IX Item "ESC [ ? Pm h" 1751.IX Item "ESC [ ? Pm h"
1729\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0) 1752\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)
1730.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4 1753.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4
… …
1997.RE 2020.RE
1998.PD 2021.PD
1999.PP 2022.PP
2000 2023
2001.IX Xref "XTerm" 2024.IX Xref "XTerm"
2002.SH "XTerm Operating System Commands" 2025.Sh "XTerm Operating System Commands"
2003.IX Header "XTerm Operating System Commands" 2026.IX Subsection "XTerm Operating System Commands"
2004.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4 2027.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4
2005.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 2028.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4
2006.IX Item "ESC ] Ps;Pt ST" 2029.IX Item "ESC ] Ps;Pt ST"
2007Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b, 2030Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,
20080x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any 20310x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any
… …
2040Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 2063Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2041Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 2064Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2042Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). 2065Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
2043.TE 2066.TE
2044 2067
2045.PP
2046
2047.IX Xref "XPM"
2048.SH "XPM" 2068.SH "XPM"
2049.IX Header "XPM" 2069.IX Header "XPM"
2050For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value 2070For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value
2051of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a 2071of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a
2052sequence of scaling/positioning commands separated by semi\-colons. The 2072sequence of scaling/positioning commands separated by semi\-colons. The

Diff Legend

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