[ViewVC] Diff of: cvs/rxvt-unicode/doc/rxvt.7.man.in

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.66 by root, Tue Jan 31 21:04:14 2006 UTC vs.
Revision 1.75 by root, Wed Feb 22 10:42:49 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-22" "7.7" "RXVT-UNICODE"
133	.SH "NAME"	133	.SH "NAME"
134	RXVT REFERENCE \- FAQ, command sequences and other background information	134	RXVT 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
217	Try \f(CW\(C`@@URXVT_NAME@@d \-f \-o\(C'\fR, which tells @@URXVT_NAME@@d to open the	217	Try \f(CW\(C`@@URXVT_NAME@@d \-f \-o\(C'\fR, which tells @@URXVT_NAME@@d to open the
218	display, create the listening socket and then fork.	218	display, 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
		223	If 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
		235	This tries to create a new terminal, and if fails with exit status 2,
		236	meaning it couldn't connect to the daemon, it will start the daemon and
		237	re-run the command. Subsequent invocations of the script will re-use the
		238	existing 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
223	The original rxvt and rxvt-unicode always export the variable \(L"\s-1COLORTERM\s0\(R",	243	The original rxvt and rxvt-unicode always export the variable \(L"\s-1COLORTERM\s0\(R",
…		…
401	.PP	421	.PP
402	Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR	422	Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR
403	by other values to change the degree of opacity. If it doesn't work and	423	by other values to change the degree of opacity. If it doesn't work and
404	your server crashes, you got to keep the pieces.	424	your server crashes, you got to keep the pieces.
405	.PP	425	.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
409	This is because there is a difference between script and language \*(--
410	rxvt-unicode does not know which language the text that is output is,
411	as it only knows the unicode character codes. If rxvt-unicode first
412	sees a japanese/chinese character, it might choose a japanese font for
413	display. Subsequent japanese characters will use that font. Now, many
414	chinese characters aren't represented in japanese fonts, so when the first
415	non-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
417	chinese characters that are also in the japanese font.
418	.PP
419	The workaround is easy: just tag a chinese font at the end of your font
420	list (see the previous question). The key is to view the font list as
421	a preference list: If you expect more japanese, list a japanese font
422	first. If you expect more chinese, put a chinese font first.
423	.PP
424	In the future it might be possible to switch language preferences at
425	runtime (the internal data structure has no problem with using different
426	fonts for the same character at the same time, but no interface for this
427	has been designed yet).
428	.PP
429	Until 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
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
434	Most fonts were not designed for terminal use, which means that character	429	Most fonts were not designed for terminal use, which means that character
435	size varies a lot. A font that is otherwise fine for terminal use might	430	size varies a lot. A font that is otherwise fine for terminal use might
…		…
481	.PP	476	.PP
482	Yes, using an escape sequence. Try something like this, which has the same	477	Yes, using an escape sequence. Try something like this, which has the same
483	effect as using the \f(CW\(C`\-fn\(C'\fR switch, and takes effect immediately:	478	effect as using the \f(CW\(C`\-fn\(C'\fR switch, and takes effect immediately:
484	.PP	479	.PP
485	.Vb 1	480	.Vb 1
486	\& printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic"	481	\& printf '\e33]50;%s\e007' "9x15bold,xft:Kochi Gothic"
487	.Ve	482	.Ve
488	.PP	483	.PP
489	This is useful if you e.g. work primarily with japanese (and prefer a	484	This is useful if you e.g. work primarily with japanese (and prefer a
490	japanese font), but you have to switch to chinese temporarily, where	485	japanese font), but you have to switch to chinese temporarily, where
491	japanese fonts would only be in your way.	486	japanese fonts would only be in your way.
…		…
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").	594	They have been described (not by me) as \(L"pretty girly\(R".
600	.PP	595	.PP
601	\fIWhy do some characters look so much different than others?\fR	596	\fIWhy do some characters look so much different than others?\fR
602	.IX Subsection "Why do some characters look so much different than others?"	597	.IX Subsection "Why do some characters look so much different than others?"
603	.PP	598	.PP
604	See next entry.	599	See next entry.
…		…
631	search and use less resources within rxvt-unicode and the X\-server.	626	search and use less resources within rxvt-unicode and the X\-server.
632	.PP	627	.PP
633	The only limitation is that none of the fonts may be larger than the base	628	The only limitation is that none of the fonts may be larger than the base
634	font, as the base font defines the terminal character cell size, which	629	font, as the base font defines the terminal character cell size, which
635	must be the same due to the way terminals work.	630	must 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
		635	This is because there is a difference between script and language \*(--
		636	rxvt-unicode does not know which language the text that is output is,
		637	as it only knows the unicode character codes. If rxvt-unicode first
		638	sees a japanese/chinese character, it might choose a japanese font for
		639	display. Subsequent japanese characters will use that font. Now, many
		640	chinese characters aren't represented in japanese fonts, so when the first
		641	non-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
		643	chinese characters that are also in the japanese font.
		644	.PP
		645	The workaround is easy: just tag a chinese font at the end of your font
		646	list (see the previous question). The key is to view the font list as
		647	a preference list: If you expect more japanese, list a japanese font
		648	first. If you expect more chinese, put a chinese font first.
		649	.PP
		650	In the future it might be possible to switch language preferences at
		651	runtime (the internal data structure has no problem with using different
		652	fonts for the same character at the same time, but no interface for this
		653	has been designed yet).
		654	.PP
		655	Until 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
…		…
859	Rather than have rxvt-unicode try to accommodate all the various possible	879	Rather than have rxvt-unicode try to accommodate all the various possible
860	keyboard mappings, it is better to use `xmodmap' to remap the keys as	880	keyboard mappings, it is better to use `xmodmap' to remap the keys as
861	required for your particular machine.	881	required for your particular machine.
862	.Sh "Terminal Configuration"	882	.Sh "Terminal Configuration"
863	.IX Subsection "Terminal Configuration"	883	.IX Subsection "Terminal Configuration"
		884	\fICan I see a typical configuration?\fR
		885	.IX Subsection "Can I see a typical configuration?"
		886	.PP
		887	The default configuration tries to be xterm\-like, which I don't like that
		888	much, but it's least surprise to regular users.
		889	.PP
		890	As a rxvt or rxvt-unicode user, you are practically supposed to invest
		891	time into customising your terminal. To get you started, here is the
		892	author's .Xdefaults entries, with comments on what they do. It's certainly
		893	not \fItypical\fR, but what's typical...
		894	.PP
		895	.Vb 2
		896	\& URxvt.cutchars: "()*,<>[]{}\|'
		897	\& URxvt.print-pipe: cat >/tmp/xxx
		898	.Ve
		899	.PP
		900	These are just for testing stuff.
		901	.PP
		902	.Vb 2
		903	\& URxvt.imLocale: ja_JP.UTF-8
		904	\& URxvt.preeditType: OnTheSpot,None
		905	.Ve
		906	.PP
		907	This tells rxvt-unicode to use a special locale when communicating with
		908	the X Input Method, and also tells it to only use the OnTheSpot pre-edit
		909	type, which requires the \f(CW\(C`xim\-onthespot\(C'\fR perl extension but rewards me
		910	with correct-looking fonts.
		911	.PP
		912	.Vb 6
		913	\& URxvt.perl-lib: /root/lib/urxvt
		914	\& URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard
		915	\& URxvt.selection.pattern-0: ( at .*? line \e\ed+)
		916	\& URxvt.selection.pattern-1: ^(/[^:]+):\e
		917	\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
		918	\& URxvt.selection-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
		919	.Ve
		920	.PP
		921	This is my perl configuration. The first two set the perl library
		922	directory and also tells urxvt to use a large number of extensions. I
		923	develop for myself mostly, so I actually use most of the extensions I
		924	write.
		925	.PP
		926	The selection stuff mainly makes the selection perl-error-message aware
		927	and tells it to convert pelr error mssages into vi-commands to load the
		928	relevant file and go tot he error line number.
		929	.PP
		930	.Vb 2
		931	\& URxvt.scrollstyle: plain
		932	\& URxvt.secondaryScroll: true
		933	.Ve
		934	.PP
		935	As the documentation says: plain is the preferred scrollbar for the
		936	author. The \f(CW\(C`secondaryScroll\(C'\fR confgiures urxvt to scroll in full-screen
		937	apps, like screen, so lines scorlled out of screen end up in urxvt's
		938	scrollback buffer.
		939	.PP
		940	.Vb 7
		941	\& URxvt.background: #000000
		942	\& URxvt.foreground: gray90
		943	\& URxvt.color7: gray90
		944	\& URxvt.colorBD: #ffffff
		945	\& URxvt.cursorColor: #e0e080
		946	\& URxvt.throughColor: #8080f0
		947	\& URxvt.highlightColor: #f0f0f0
		948	.Ve
		949	.PP
		950	Some colours. Not sure which ones are being used or even non\-defaults, but
		951	these are in my .Xdefaults. Most notably, they set foreground/background
		952	to light gray/black, and also make sure that the colour 7 matches the
		953	default foreground colour.
		954	.PP
		955	.Vb 1
		956	\& URxvt.underlineColor: yellow
		957	.Ve
		958	.PP
		959	Another colour, makes underline lines look different. Sometimes hurts, but
		960	is mostly a nice effect.
		961	.PP
		962	.Vb 4
		963	\& URxvt.geometry: 154x36
		964	\& URxvt.loginShell: false
		965	\& URxvt.meta: ignore
		966	\& URxvt.utmpInhibit: true
		967	.Ve
		968	.PP
		969	Uh, well, should be mostly self\-explanatory. By specifying some defaults
		970	manually, I can quickly switch them for testing.
		971	.PP
		972	.Vb 1
		973	\& URxvt.saveLines: 8192
		974	.Ve
		975	.PP
		976	A large scrollback buffer is essential. Really.
		977	.PP
		978	.Vb 1
		979	\& URxvt.mapAlert: true
		980	.Ve
		981	.PP
		982	The only case I use it is for my \s-1IRC\s0 window, which I like to keep
		983	iconified till people msg me (which beeps).
		984	.PP
		985	.Vb 1
		986	\& URxvt.visualBell: true
		987	.Ve
		988	.PP
		989	The audible bell is often annoying, especially when in a crowd.
		990	.PP
		991	.Vb 1
		992	\& URxvt.insecure: true
		993	.Ve
		994	.PP
		995	Please don't hack my mutt! Ooops...
		996	.PP
		997	.Vb 1
		998	\& URxvt.pastableTabs: false
		999	.Ve
		1000	.PP
		1001	I once thought this is a great idea.
		1002	.PP
		1003	.Vb 9
		1004	\& urxvt.font: 9x15bold,\e
		1005	\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e
		1006	\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e
		1007	\& [codeset=JISX0208]xft:Kochi Gothic, \e
		1008	\& xft:Bitstream Vera Sans Mono:autohint=true, \e
		1009	\& xft:Code2000:antialias=false
		1010	\& urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
		1011	\& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
		1012	\& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
		1013	.Ve
		1014	.PP
		1015	I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
		1016	overwhelmed. A special note: the \f(CW\(C`9x15bold\(C'\fR mentioend above is actually
		1017	the version from XFree\-3.3, as XFree\-4 replaced it by a totally different
		1018	font (different glyphs for \f(CW\(C`;\(C'\fR and many other harmless characters),
		1019	while the second font is actually the \f(CW\(C`9x15bold\(C'\fR from XFree4/XOrg. The
		1020	bold version has less chars than the medium version, so I use it for rare
		1021	characters, too. Whene ditign sources with vim, I use italic for comments
		1022	and other stuff, which looks quite good with Bitstream Vera anti\-aliased.
		1023	.PP
		1024	Terminus is a quite bad font (many very wrong glyphs), but for most of my
		1025	purposes, it works, and gives a different look, as my normal (Non\-bold)
		1026	font is already bold, and I want to see a difference between bold and
		1027	normal fonts.
		1028	.PP
		1029	Please note that I used the \f(CW\(C`urxvt\(C'\fR instance name and not the \f(CW\(C`URxvt\(C'\fR
		1030	class name. Thats because I use different configs for different purposes,
		1031	for example, my \s-1IRC\s0 window is started with \f(CW\(C`\-name IRC\(C'\fR, and uses these
		1032	defaults:
		1033	.PP
		1034	.Vb 9
		1035	\& IRC*title: IRC
		1036	\& IRC*geometry: 87x12+535+542
		1037	\& IRC*saveLines: 0
		1038	\& IRC*mapAlert: true
		1039	\& IRC*font: suxuseuro
		1040	\& IRC*boldFont: suxuseuro
		1041	\& IRC*colorBD: white
		1042	\& IRC*keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
		1043	\& IRC*keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
		1044	.Ve
		1045	.PP
		1046	\&\f(CW\(C`Alt\-Shift\-1\(C'\fR and \f(CW\(C`Alt\-Shift\-2\(C'\fR switch between two different font
		1047	sizes. \f(CW\(C`suxuseuro\(C'\fR allows me to keep an eye (and actually read)
		1048	stuff while keeping a very small window. If somebody pastes something
		1049	complicated (e.g. japanese), I temporarily switch to a larger font.
		1050	.PP
		1051	The above is all in my \f(CW\(C`.Xdefaults\(C'\fR (I don't use \f(CW\(C`.Xresources\(C'\fR nor
		1052	\&\f(CW\(C`xrdb\(C'\fR). I also have some resources in a separate \f(CW\(C`.Xdefaults\-hostname\(C'\fR
		1053	file for different hosts, for example, on ym main desktop, I use:
		1054	.PP
		1055	.Vb 5
		1056	\& URxvt.keysym.C-M-q: command:\e033[3;5;5t
		1057	\& URxvt.keysym.C-M-y: command:\e033[3;5;606t
		1058	\& URxvt.keysym.C-M-e: command:\e033[3;1605;5t
		1059	\& URxvt.keysym.C-M-c: command:\e033[3;1605;606t
		1060	\& URxvt.keysym.C-M-p: perl:test
		1061	.Ve
		1062	.PP
		1063	The first for keysym definitions allow me to quickly bring some windows
		1064	in the layout I like most. Ion users might start laughing but will stop
		1065	immediately when I tell them that I use my own Fvwm2 module for much the
		1066	same effect as Ion provides, and I only very rarely use the above key
		1067	combinations :\->
		1068	.PP
864	\fIWhy doesn't rxvt-unicode read my resources?\fR	1069	\fIWhy doesn't rxvt-unicode read my resources?\fR
865	.IX Subsection "Why doesn't rxvt-unicode read my resources?"	1070	.IX Subsection "Why doesn't rxvt-unicode read my resources?"
866	.PP	1071	.PP
867	Well, why, indeed? It does, in a way very similar to other X	1072	Well, why, indeed? It does, in a way very similar to other X
868	applications. Most importantly, this means that if you or your \s-1OS\s0 loads	1073	applications. Most importantly, this means that if you or your \s-1OS\s0 loads
…		…
1031	.PP	1236	.PP
1032	The best thing is to fix your startup environment, as you will likely run	1237	The best thing is to fix your startup environment, as you will likely run
1033	into other problems. If nothing works you can try this in your .profile.	1238	into other problems. If nothing works you can try this in your .profile.
1034	.PP	1239	.PP
1035	.Vb 1	1240	.Vb 1
1036	\& printf '\ee]701;%s\e007' "$LC_CTYPE"	1241	\& printf '\e33]701;%s\e007' "$LC_CTYPE"
1037	.Ve	1242	.Ve
1038	.PP	1243	.PP
1039	If this doesn't work, then maybe you use a \f(CW\(C`LC_CTYPE\(C'\fR specification not	1244	If this doesn't work, then maybe you use a \f(CW\(C`LC_CTYPE\(C'\fR specification not
1040	supported on your systems. Some systems have a \f(CW\(C`locale\(C'\fR command which	1245	supported on your systems. Some systems have a \f(CW\(C`locale\(C'\fR command which
1041	displays this (also, \f(CW\(C`perl \-e0\(C'\fR can be used to check locale settings, as	1246	displays this (also, \f(CW\(C`perl \-e0\(C'\fR can be used to check locale settings, as
…		…
1098	.PP	1303	.PP
1099	Yes, using an escape sequence. Try something like this, which sets	1304	Yes, using an escape sequence. Try something like this, which sets
1100	rxvt\-unicode's idea of \f(CW\(C`LC_CTYPE\(C'\fR.	1305	rxvt\-unicode's idea of \f(CW\(C`LC_CTYPE\(C'\fR.
1101	.PP	1306	.PP
1102	.Vb 1	1307	.Vb 1
1103	\& printf '\ee]701;%s\e007' ja_JP.SJIS	1308	\& printf '\e33]701;%s\e007' ja_JP.SJIS
1104	.Ve	1309	.Ve
1105	.PP	1310	.PP
1106	See also the previous answer.	1311	See also the previous answer.
1107	.PP	1312	.PP
1108	Sometimes this capability is rather handy when you want to work in	1313	Sometimes this capability is rather handy when you want to work in
1109	one locale (e.g. \f(CW\(C`de_DE.UTF\-8\(C'\fR) but some programs don't support it	1314	one locale (e.g. \f(CW\(C`de_DE.UTF\-8\(C'\fR) but some programs don't support it
1110	(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\(C`xjdic\(C'\fR, which	1315	(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\(C`xjdic\(C'\fR, which
1111	first switches to a locale supported by xjdic and back later:	1316	first switches to a locale supported by xjdic and back later:
1112	.PP	1317	.PP
1113	.Vb 3	1318	.Vb 3
1114	\& printf '\ee]701;%s\e007' ja_JP.SJIS	1319	\& printf '\e33]701;%s\e007' ja_JP.SJIS
1115	\& xjdic -js	1320	\& xjdic -js
1116	\& printf '\ee]701;%s\e007' de_DE.UTF-8	1321	\& printf '\e33]701;%s\e007' de_DE.UTF-8
1117	.Ve	1322	.Ve
1118	.PP	1323	.PP
1119	You can also use xterm's \f(CW\(C`luit\(C'\fR program, which usually works fine, except	1324	You can also use xterm's \f(CW\(C`luit\(C'\fR program, which usually works fine, except
1120	for some locales where character width differs between program\- and	1325	for some locales where character width differs between program\- and
1121	rxvt\-unicode\-locales.	1326	rxvt\-unicode\-locales.
1122	.PP	1327	.PP
		1328	\fII have problems getting my input method working.\fR
		1329	.IX Subsection "I have problems getting my input method working."
		1330	.PP
		1331	Try a search engine, as this is slightly different for every input method server.
		1332	.PP
		1333	Here is a checklist:
		1334	.IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS\s0." 4
		1335	.IX Item "- Make sure your locale and the imLocale are supported on your OS."
		1336	Try \f(CW\(C`locale \-a\(C'\fR or check the documentation for your \s-1OS\s0.
		1337	.IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM\s0." 4
		1338	.IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM."
		1339	For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use
		1340	\&\f(CW\(C`ja_JP.EUC\-JP\(C'\fR or equivalent.
		1341	.IP "\- Make sure your \s-1XIM\s0 server is actually running." 4
		1342	.IX Item "- Make sure your XIM server is actually running."
		1343	.PD 0
		1344	.ie n .IP "\- Make sure the ""XMODIFIERS""\fR environment variable is set correctly when \fIstarting rxvt\-unicode." 4
		1345	.el .IP "\- Make sure the \f(CWXMODIFIERS\fR environment variable is set correctly when \fIstarting\fR rxvt\-unicode." 4
		1346	.IX Item "- Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode."
		1347	.PD
		1348	When you want to use e.g. \fBkinput2\fR, it must be set to
		1349	\&\f(CW\(C`@im=kinput2\(C'\fR. For \fBscim\fR, use \f(CW\(C`@im=SCIM\(C'\fR. Youc an see what input
		1350	method servers are running with this command:
		1351	.Sp
		1352	.Vb 1
		1353	\& xprop -root XIM_SERVERS
		1354	.Ve
		1355	.IP "*" 4
		1356	.PP
1123	\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR	1357	\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?"	1358	.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
1125	.PP	1359	.PP
1126	You can specify separate locales for the input method and the rest of the	1360	You can specify separate locales for the input method and the rest of the
1127	terminal, using the resource \f(CW\(C`imlocale\(C'\fR:	1361	terminal, using the resource \f(CW\(C`imlocale\(C'\fR:
…		…
1129	.Vb 1	1363	.Vb 1
1130	\& URxvt.imlocale: ja_JP.EUC-JP	1364	\& URxvt.imlocale: ja_JP.EUC-JP
1131	.Ve	1365	.Ve
1132	.PP	1366	.PP
1133	Now you can start your terminal with \f(CW\(C`LC_CTYPE=ja_JP.UTF\-8\(C'\fR and still	1367	Now you can start your terminal with \f(CW\(C`LC_CTYPE=ja_JP.UTF\-8\(C'\fR and still
1134	use your input method. Please note, however, that you will not be able to	1368	use your input method. Please note, however, that, depending on your Xlib
1135	input characters outside \f(CW\(C`EUC\-JP\(C'\fR in a normal way then, as your input	1369	version, you may not be able to input characters outside \f(CW\(C`EUC\-JP\(C'\fR in a
1136	method limits you.	1370	normal way then, as your input method limits you.
1137	.PP	1371	.PP
1138	\fIRxvt-unicode crashes when the X Input Method changes or exits.\fR	1372	\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."	1373	.IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits."
1140	.PP	1374	.PP
1141	Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by	1375	Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by
…		…
1267	At the time of this writing, cygwin didn't seem to support any multi-byte	1501	At the time of this writing, cygwin didn't seem to support any multi-byte
1268	encodings (you might try \f(CW\(C`LC_CTYPE=C\-UTF\-8\(C'\fR), so you are likely limited	1502	encodings (you might try \f(CW\(C`LC_CTYPE=C\-UTF\-8\(C'\fR), so you are likely limited
1269	to 8\-bit encodings.	1503	to 8\-bit encodings.
1270	.SH "RXVT-UNICODE TECHNICAL REFERENCE"	1504	.SH "RXVT-UNICODE TECHNICAL REFERENCE"
1271	.IX Header "RXVT-UNICODE TECHNICAL REFERENCE"	1505	.IX Header "RXVT-UNICODE TECHNICAL REFERENCE"
1272	.SH "DESCRIPTION"
1273	.IX Header "DESCRIPTION"
1274	The rest of this document describes various technical aspects of	1506	The rest of this document describes various technical aspects of
1275	\&\fBrxvt-unicode\fR. First the description of supported command sequences,	1507	\&\fBrxvt-unicode\fR. First the description of supported command sequences,
1276	followed by pixmap support and last by a description of all features	1508	followed by pixmap support and last by a description of all features
1277	selectable at \f(CW\(C`configure\(C'\fR time.	1509	selectable at \f(CW\(C`configure\(C'\fR time.
1278	.SH "Definitions"	1510	.Sh "Definitions"
1279	.IX Header "Definitions"	1511	.IX Subsection "Definitions"
1280	.ie n .IP "\fB\fB""c""\fB\fR" 4	1512	.ie n .IP "\fB\fB""c""\fB\fR" 4
1281	.el .IP "\fB\f(CBc\fB\fR" 4	1513	.el .IP "\fB\f(CBc\fB\fR" 4
1282	.IX Item "c"	1514	.IX Item "c"
1283	The literal character c.	1515	The literal character c.
1284	.ie n .IP "\fB\fB""C""\fB\fR" 4	1516	.ie n .IP "\fB\fB""C""\fB\fR" 4
…		…
1297	parameters, separated by \f(CW\(C`;\(C'\fR character(s).	1529	parameters, separated by \f(CW\(C`;\(C'\fR character(s).
1298	.ie n .IP "\fB\fB""Pt""\fB\fR" 4	1530	.ie n .IP "\fB\fB""Pt""\fB\fR" 4
1299	.el .IP "\fB\f(CBPt\fB\fR" 4	1531	.el .IP "\fB\f(CBPt\fB\fR" 4
1300	.IX Item "Pt"	1532	.IX Item "Pt"
1301	A text parameter composed of printable characters.	1533	A text parameter composed of printable characters.
1302	.SH "Values"	1534	.Sh "Values"
1303	.IX Header "Values"	1535	.IX Subsection "Values"
1304	.ie n .IP "\fB\fB""ENQ""\fB\fR" 4	1536	.ie n .IP "\fB\fB""ENQ""\fB\fR" 4
1305	.el .IP "\fB\f(CBENQ\fB\fR" 4	1537	.el .IP "\fB\f(CBENQ\fB\fR" 4
1306	.IX Item "ENQ"	1538	.IX Item "ENQ"
1307	Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0)	1539	Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0)
1308	request attributes from terminal. See \fB\f(CB\(C`ESC [ Ps c\(C'\fB\fR.	1540	request attributes from terminal. See \fB\f(CB\(C`ESC [ Ps c\(C'\fB\fR.
…		…
1346	Switch to Standard Character Set	1578	Switch to Standard Character Set
1347	.ie n .IP "\fB\fB""SPC""\fB\fR" 4	1579	.ie n .IP "\fB\fB""SPC""\fB\fR" 4
1348	.el .IP "\fB\f(CBSPC\fB\fR" 4	1580	.el .IP "\fB\f(CBSPC\fB\fR" 4
1349	.IX Item "SPC"	1581	.IX Item "SPC"
1350	Space Character	1582	Space Character
1351	.SH "Escape Sequences"	1583	.Sh "Escape Sequences"
1352	.IX Header "Escape Sequences"	1584	.IX Subsection "Escape Sequences"
1353	.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4	1585	.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4
1354	.el .IP "\fB\f(CBESC # 8\fB\fR" 4	1586	.el .IP "\fB\f(CBESC # 8\fB\fR" 4
1355	.IX Item "ESC # 8"	1587	.IX Item "ESC # 8"
1356	\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)	1588	\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)
1357	.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4	1589	.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4
…		…
1450	.TE	1682	.TE
1451		1683
1452	.PP	1684	.PP
1453		1685
1454	.IX Xref "CSI"	1686	.IX Xref "CSI"
1455	.SH "CSI (Command Sequence Introducer) Sequences"	1687	.Sh "\s-1CSI\s0 (Command Sequence Introducer) Sequences"
1456	.IX Header "CSI (Command Sequence Introducer) Sequences"	1688	.IX Subsection "CSI (Command Sequence Introducer) Sequences"
1457	.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4	1689	.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4
1458	.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4	1690	.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4
1459	.IX Item "ESC [ Ps @"	1691	.IX Item "ESC [ Ps @"
1460	Insert \fB\f(CB\(C`Ps\(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)	1692	Insert \fB\f(CB\(C`Ps\(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)
1461	.IX Xref "ESCOBPsA"	1693	.IX Xref "ESCOBPsA"
…		…
1724	.IX Item "ESC [ Ps x"	1956	.IX Item "ESC [ Ps x"
1725	Request Terminal Parameters (\s-1DECREQTPARM\s0)	1957	Request Terminal Parameters (\s-1DECREQTPARM\s0)
1726	.PP	1958	.PP
1727		1959
1728	.IX Xref "PrivateModes"	1960	.IX Xref "PrivateModes"
1729	.SH "DEC Private Modes"	1961	.Sh "\s-1DEC\s0 Private Modes"
1730	.IX Header "DEC Private Modes"	1962	.IX Subsection "DEC Private Modes"
1731	.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4	1963	.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4
1732	.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4	1964	.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4
1733	.IX Item "ESC [ ? Pm h"	1965	.IX Item "ESC [ ? Pm h"
1734	\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)	1966	\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)
1735	.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4	1967	.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4
…		…
2002	.RE	2234	.RE
2003	.PD	2235	.PD
2004	.PP	2236	.PP
2005		2237
2006	.IX Xref "XTerm"	2238	.IX Xref "XTerm"
2007	.SH "XTerm Operating System Commands"	2239	.Sh "XTerm Operating System Commands"
2008	.IX Header "XTerm Operating System Commands"	2240	.IX Subsection "XTerm Operating System Commands"
2009	.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4	2241	.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4
2010	.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4	2242	.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4
2011	.IX Item "ESC ] Ps;Pt ST"	2243	.IX Item "ESC ] Ps;Pt ST"
2012	Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,	2244	Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,
2013	0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any	2245	0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any
…		…
2045	Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).	2277	Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2046	Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).	2278	Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2047	Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).	2279	Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
2048	.TE	2280	.TE
2049		2281
2050	.PP
2051
2052	.IX Xref "XPM"
2053	.SH "XPM"	2282	.SH "XPM"
2054	.IX Header "XPM"	2283	.IX Header "XPM"
2055	For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\(C`ESC ] 20 ; Pt ST\(C'\fB\fR then value	2284	For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\(C`ESC ] 20 ; Pt ST\(C'\fB\fR then value
2056	of \fB\f(CB\(C`Pt\(C'\fB\fR can be the name of the background pixmap followed by a	2285	of \fB\f(CB\(C`Pt\(C'\fB\fR can be the name of the background pixmap followed by a
2057	sequence of scaling/positioning commands separated by semi\-colons. The	2286	sequence of scaling/positioning commands separated by semi\-colons. The
…		…
2426	.IX Item "--disable-new-selection"	2655	.IX Item "--disable-new-selection"
2427	Remove support for mouse selection style like that of xterm.	2656	Remove support for mouse selection style like that of xterm.
2428	.IP "\-\-enable\-dmalloc (default: off)" 4	2657	.IP "\-\-enable\-dmalloc (default: off)" 4
2429	.IX Item "--enable-dmalloc (default: off)"	2658	.IX Item "--enable-dmalloc (default: off)"
2430	Use Gray Watson's malloc \- which is good for debugging See	2659	Use Gray Watson's malloc \- which is good for debugging See
2431	http://www.letters.com/dmalloc/ for details If you use either this or the	2660	<http://www.letters.com/dmalloc/> for details If you use either this or the
2432	next option, you may need to edit src/Makefile after compiling to point	2661	next option, you may need to edit src/Makefile after compiling to point
2433	\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.	2662	\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.
2434	.Sp	2663	.Sp
2435	You can only use either this option and the following (should	2664	You can only use either this option and the following (should
2436	you use either) .	2665	you use either) .

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents): Revision 1.66 by root, Tue Jan 31 21:04:14 2006 UTC vs. Revision 1.75 by root, Wed Feb 22 10:42:49 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.66 by root, Tue Jan 31 21:04:14 2006 UTC vs.
Revision 1.75 by root, Wed Feb 22 10:42:49 2006 UTC