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.69 by root, Tue Jan 31 21:10:44 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",
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
2421.IX Item "--disable-new-selection" 2470.IX Item "--disable-new-selection"
2422Remove support for mouse selection style like that of xterm. 2471Remove support for mouse selection style like that of xterm.
2423.IP "\-\-enable\-dmalloc (default: off)" 4 2472.IP "\-\-enable\-dmalloc (default: off)" 4
2424.IX Item "--enable-dmalloc (default: off)" 2473.IX Item "--enable-dmalloc (default: off)"
2425Use Gray Watson's malloc \- which is good for debugging See 2474Use Gray Watson's malloc \- which is good for debugging See
2426http://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
2427next 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
2428\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. 2477\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.
2429.Sp 2478.Sp
2430You can only use either this option and the following (should 2479You can only use either this option and the following (should
2431you use either) . 2480you use either) .

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines