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.68 by root, Tue Jan 31 21:06:26 2006 UTC vs.
Revision 1.72 by root, Thu Feb 2 18:04:45 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
… …
631search and use less resources within rxvt-unicode and the X\-server. 626search and use less resources within rxvt-unicode and the X\-server.
632.PP 627.PP
633The 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
634font, as the base font defines the terminal character cell size, which 629font, as the base font defines the terminal character cell size, which
635must 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).
636.Sh "Keyboard, Mouse & User Interaction" 656.Sh "Keyboard, Mouse & User Interaction"
637.IX Subsection "Keyboard, Mouse & User Interaction" 657.IX Subsection "Keyboard, Mouse & User Interaction"
638\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
639.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?"
640.PP 660.PP
… …
1118.PP 1138.PP
1119You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except 1139You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except
1120for some locales where character width differs between program\- and 1140for some locales where character width differs between program\- and
1121rxvt\-unicode\-locales. 1141rxvt\-unicode\-locales.
1122.PP 1142.PP
1143\fII have problems getting my input method working.\fR
1144.IX Subsection "I have problems getting my input method working."
1145.PP
1146Try a search engine, as this is slightly different for every input method server.
1147.PP
1148Here is a checklist:
1149.IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS\s0." 4
1150.IX Item "- Make sure your locale and the imLocale are supported on your OS."
1151Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS\s0.
1152.IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM\s0." 4
1153.IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM."
1154For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use
1155\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent.
1156.IP "\- Make sure your \s-1XIM\s0 server is actually running." 4
1157.IX Item "- Make sure your XIM server is actually running."
1158.PD 0
1159.ie n .IP "\- Make sure the ""XMODIFIERS""\fR environment variable is set correctly when \fIstarting rxvt\-unicode." 4
1160.el .IP "\- Make sure the \f(CWXMODIFIERS\fR environment variable is set correctly when \fIstarting\fR rxvt\-unicode." 4
1161.IX Item "- Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode."
1162.PD
1163When you want to use e.g. \fBkinput2\fR, it must be set to
1164\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. Youc an see what input
1165method servers are running with this command:
1166.Sp
1167.Vb 1
1168\& xprop -root XIM_SERVERS
1169.Ve
1170.IP "*" 4
1171.PP
1123\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR 1172\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR
1124.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?" 1173.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
1125.PP 1174.PP
1126You can specify separate locales for the input method and the rest of the 1175You can specify separate locales for the input method and the rest of the
1127terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: 1176terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
… …
1129.Vb 1 1178.Vb 1
1130\& URxvt.imlocale: ja_JP.EUC-JP 1179\& URxvt.imlocale: ja_JP.EUC-JP
1131.Ve 1180.Ve
1132.PP 1181.PP
1133Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still 1182Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still
1134use your input method. Please note, however, that you will not be able to 1183use your input method. Please note, however, that, depending on your Xlib
1135input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input 1184version, you may not be able to input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a
1136method limits you. 1185normal way then, as your input method limits you.
1137.PP 1186.PP
1138\fIRxvt-unicode crashes when the X Input Method changes or exits.\fR 1187\fIRxvt-unicode crashes when the X Input Method changes or exits.\fR
1139.IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits." 1188.IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits."
1140.PP 1189.PP
1141Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by 1190Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by
… …
1267At the time of this writing, cygwin didn't seem to support any multi-byte 1316At the time of this writing, cygwin didn't seem to support any multi-byte
1268encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited 1317encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited
1269to 8\-bit encodings. 1318to 8\-bit encodings.
1270.SH "RXVT-UNICODE TECHNICAL REFERENCE" 1319.SH "RXVT-UNICODE TECHNICAL REFERENCE"
1271.IX Header "RXVT-UNICODE TECHNICAL REFERENCE" 1320.IX Header "RXVT-UNICODE TECHNICAL REFERENCE"
1272.SH "DESCRIPTION"
1273.IX Header "DESCRIPTION"
1274The rest of this document describes various technical aspects of 1321The rest of this document describes various technical aspects of
1275\&\fBrxvt-unicode\fR. First the description of supported command sequences, 1322\&\fBrxvt-unicode\fR. First the description of supported command sequences,
1276followed by pixmap support and last by a description of all features 1323followed by pixmap support and last by a description of all features
1277selectable at \f(CW\*(C`configure\*(C'\fR time. 1324selectable at \f(CW\*(C`configure\*(C'\fR time.
1278.SH "Definitions" 1325.Sh "Definitions"
1279.IX Header "Definitions" 1326.IX Subsection "Definitions"
1280.ie n .IP "\fB\fB""c""\fB\fR" 4 1327.ie n .IP "\fB\fB""c""\fB\fR" 4
1281.el .IP "\fB\f(CBc\fB\fR" 4 1328.el .IP "\fB\f(CBc\fB\fR" 4
1282.IX Item "c" 1329.IX Item "c"
1283The literal character c. 1330The literal character c.
1284.ie n .IP "\fB\fB""C""\fB\fR" 4 1331.ie n .IP "\fB\fB""C""\fB\fR" 4
… …
1297parameters, separated by \f(CW\*(C`;\*(C'\fR character(s). 1344parameters, separated by \f(CW\*(C`;\*(C'\fR character(s).
1298.ie n .IP "\fB\fB""Pt""\fB\fR" 4 1345.ie n .IP "\fB\fB""Pt""\fB\fR" 4
1299.el .IP "\fB\f(CBPt\fB\fR" 4 1346.el .IP "\fB\f(CBPt\fB\fR" 4
1300.IX Item "Pt" 1347.IX Item "Pt"
1301A text parameter composed of printable characters. 1348A text parameter composed of printable characters.
1302.SH "Values" 1349.Sh "Values"
1303.IX Header "Values" 1350.IX Subsection "Values"
1304.ie n .IP "\fB\fB""ENQ""\fB\fR" 4 1351.ie n .IP "\fB\fB""ENQ""\fB\fR" 4
1305.el .IP "\fB\f(CBENQ\fB\fR" 4 1352.el .IP "\fB\f(CBENQ\fB\fR" 4
1306.IX Item "ENQ" 1353.IX Item "ENQ"
1307Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0) 1354Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0)
1308request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR. 1355request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR.
… …
1346Switch to Standard Character Set 1393Switch to Standard Character Set
1347.ie n .IP "\fB\fB""SPC""\fB\fR" 4 1394.ie n .IP "\fB\fB""SPC""\fB\fR" 4
1348.el .IP "\fB\f(CBSPC\fB\fR" 4 1395.el .IP "\fB\f(CBSPC\fB\fR" 4
1349.IX Item "SPC" 1396.IX Item "SPC"
1350Space Character 1397Space Character
1351.SH "Escape Sequences" 1398.Sh "Escape Sequences"
1352.IX Header "Escape Sequences" 1399.IX Subsection "Escape Sequences"
1353.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4 1400.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4
1354.el .IP "\fB\f(CBESC # 8\fB\fR" 4 1401.el .IP "\fB\f(CBESC # 8\fB\fR" 4
1355.IX Item "ESC # 8" 1402.IX Item "ESC # 8"
1356\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0) 1403\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)
1357.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4 1404.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4
… …
1450.TE 1497.TE
1451 1498
1452.PP 1499.PP
1453 1500
1454.IX Xref "CSI" 1501.IX Xref "CSI"
1455.SH "CSI (Command Sequence Introducer) Sequences" 1502.Sh "\s-1CSI\s0 (Command Sequence Introducer) Sequences"
1456.IX Header "CSI (Command Sequence Introducer) Sequences" 1503.IX Subsection "CSI (Command Sequence Introducer) Sequences"
1457.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4 1504.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4
1458.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4 1505.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4
1459.IX Item "ESC [ Ps @" 1506.IX Item "ESC [ Ps @"
1460Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0) 1507Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)
1461.IX Xref "ESCOBPsA" 1508.IX Xref "ESCOBPsA"
… …
1724.IX Item "ESC [ Ps x" 1771.IX Item "ESC [ Ps x"
1725Request Terminal Parameters (\s-1DECREQTPARM\s0) 1772Request Terminal Parameters (\s-1DECREQTPARM\s0)
1726.PP 1773.PP
1727 1774
1728.IX Xref "PrivateModes" 1775.IX Xref "PrivateModes"
1729.SH "DEC Private Modes" 1776.Sh "\s-1DEC\s0 Private Modes"
1730.IX Header "DEC Private Modes" 1777.IX Subsection "DEC Private Modes"
1731.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4 1778.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4
1732.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4 1779.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4
1733.IX Item "ESC [ ? Pm h" 1780.IX Item "ESC [ ? Pm h"
1734\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0) 1781\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)
1735.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4 1782.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4
… …
2002.RE 2049.RE
2003.PD 2050.PD
2004.PP 2051.PP
2005 2052
2006.IX Xref "XTerm" 2053.IX Xref "XTerm"
2007.SH "XTerm Operating System Commands" 2054.Sh "XTerm Operating System Commands"
2008.IX Header "XTerm Operating System Commands" 2055.IX Subsection "XTerm Operating System Commands"
2009.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4 2056.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4
2010.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 2057.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4
2011.IX Item "ESC ] Ps;Pt ST" 2058.IX Item "ESC ] Ps;Pt ST"
2012Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b, 2059Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,
20130x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any 20600x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any
… …
2045Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 2092Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2046Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 2093Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2047Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). 2094Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
2048.TE 2095.TE
2049 2096
2050.PP
2051
2052.IX Xref "XPM"
2053.SH "XPM" 2097.SH "XPM"
2054.IX Header "XPM" 2098.IX Header "XPM"
2055For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value 2099For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value
2056of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a 2100of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a
2057sequence of scaling/positioning commands separated by semi\-colons. The 2101sequence of scaling/positioning commands separated by semi\-colons. The
… …
2426.IX Item "--disable-new-selection" 2470.IX Item "--disable-new-selection"
2427Remove support for mouse selection style like that of xterm. 2471Remove support for mouse selection style like that of xterm.
2428.IP "\-\-enable\-dmalloc (default: off)" 4 2472.IP "\-\-enable\-dmalloc (default: off)" 4
2429.IX Item "--enable-dmalloc (default: off)" 2473.IX Item "--enable-dmalloc (default: off)"
2430Use Gray Watson's malloc \- which is good for debugging See 2474Use Gray Watson's malloc \- which is good for debugging See
2431http://www.letters.com/dmalloc/ for details If you use either this or the 2475<http://www.letters.com/dmalloc/> for details If you use either this or the
2432next option, you may need to edit src/Makefile after compiling to point 2476next option, you may need to edit src/Makefile after compiling to point
2433\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. 2477\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.
2434.Sp 2478.Sp
2435You can only use either this option and the following (should 2479You can only use either this option and the following (should
2436you use either) . 2480you use either) .

Diff Legend

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