--- rxvt-unicode/doc/rxvt.7.man.in 2006/01/31 21:10:44 1.69 +++ rxvt-unicode/doc/rxvt.7.man.in 2006/02/02 18:04:45 1.72 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 7" -.TH rxvt 7 "2006-01-31" "7.5" "RXVT-UNICODE" +.TH rxvt 7 "2006-02-02" "7.5" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -217,6 +217,26 @@ Try \f(CW\*(C`@@URXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@URXVT_NAME@@d to open the display, create the listening socket and then fork. .PP +\fIHow can I start @@URXVT_NAME@@d automatically when I run URXVT_NAME@@c?\fR +.IX Subsection "How can I start @@URXVT_NAME@@d automatically when I run URXVT_NAME@@c?" +.PP +If you want to start @@URXVT_NAME@@d automatically whenever you run +@@URXVT_NAME@@c and the daemon isn't running yet, use this script: +.PP +.Vb 6 +\& #!/bin/sh +\& @@URXVT_NAME@@c "$@" +\& if [ $? -eq 2 ]; then +\& @@URXVT_NAME@@d -q -o -f +\& @@URXVT_NAME@@c "$@" +\& fi +.Ve +.PP +This tries to create a new terminal, and if fails with exit status 2, +meaning it couldn't connect to the daemon, it will start the daemon and +re-run the command. Subsequent invocations of the script will re-use the +existing daemon. +.PP \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 @@ -1120,6 +1140,35 @@ for some locales where character width differs between program\- and rxvt\-unicode\-locales. .PP +\fII have problems getting my input method working.\fR +.IX Subsection "I have problems getting my input method working." +.PP +Try a search engine, as this is slightly different for every input method server. +.PP +Here is a checklist: +.IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS\s0." 4 +.IX Item "- Make sure your locale and the imLocale are supported on your OS." +Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS\s0. +.IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM\s0." 4 +.IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM." +For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use +\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent. +.IP "\- Make sure your \s-1XIM\s0 server is actually running." 4 +.IX Item "- Make sure your XIM server is actually running." +.PD 0 +.ie n .IP "\- Make sure the ""XMODIFIERS""\fR environment variable is set correctly when \fIstarting rxvt\-unicode." 4 +.el .IP "\- Make sure the \f(CWXMODIFIERS\fR environment variable is set correctly when \fIstarting\fR rxvt\-unicode." 4 +.IX Item "- Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode." +.PD +When you want to use e.g. \fBkinput2\fR, it must be set to +\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. Youc an see what input +method servers are running with this command: +.Sp +.Vb 1 +\& xprop -root XIM_SERVERS +.Ve +.IP "*" 4 +.PP \fIMy input method wants but I want \s-1UTF\-8\s0, what can I do?\fR .IX Subsection "My input method wants but I want UTF-8, what can I do?" .PP @@ -1131,9 +1180,9 @@ .Ve .PP Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still -use your input method. Please note, however, that you will not be able to -input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input -method limits you. +use your input method. Please note, however, that, depending on your Xlib +version, you may not be able to input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a +normal way then, as your input method limits you. .PP \fIRxvt-unicode crashes when the X Input Method changes or exits.\fR .IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits." @@ -2423,7 +2472,7 @@ .IP "\-\-enable\-dmalloc (default: off)" 4 .IX Item "--enable-dmalloc (default: off)" Use Gray Watson's malloc \- which is good for debugging See -http://www.letters.com/dmalloc/ for details If you use either this or the + for details If you use either this or the next option, you may need to edit src/Makefile after compiling to point \&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. .Sp