[ViewVC] Diff of: cvs/rxvt-unicode/doc/rxvt.1.pod

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.1 by root, Thu Aug 12 20:42:12 2004 UTC vs.
Revision 1.5 by root, Sat Aug 14 03:00:32 2004 UTC

…		…
2		2
3	rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)	3	rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)
4		4
5	=head1 SYNOPSIS	5	=head1 SYNOPSIS
6		6
7	B<@@RXVTNAME@@> [options] [-e command [ args ]]	7	B<@@RXVT_NAME@@> [options] [-e command [ args ]]
8		8
9	=head1 DESCRIPTION	9	=head1 DESCRIPTION
10		10
11	B<rxvt-unicode>, version B<@@RXVTVERSION@@>, is a colour vt102 terminal	11	B<rxvt-unicode>, version B<@@RXVT_VERSION@@>, is a colour vt102 terminal
12	emulator intended as an I<xterm>(1) replacement for users who do not	12	emulator intended as an I<xterm>(1) replacement for users who do not
13	require features such as Tektronix 4014 emulation and toolkit-style	13	require features such as Tektronix 4014 emulation and toolkit-style
14	configurability. As a result, B<rxvt-unicode> uses much less swap space --	14	configurability. As a result, B<rxvt-unicode> uses much less swap space --
15	a significant advantage on a machine serving many X sessions.	15	a significant advantage on a machine serving many X sessions.
16		16
		17	=head1 RXVT-UNICODE VS. RXVT
		18
		19	Unlike the original rxvt, B<rxvt-unicode> stores all text in Unicode
		20	internally. That means it can store and display most scripts in the
		21	world. Being a terminal emulator, however, some things are very difficult,
		22	especially cursive scripts such as arabic, vertically written scripts
		23	like mongolian or scripts requiring extremely complex combining rules,
		24	like tibetan or devenagari. Don't expect pretty output when using these
		25	scripts. Most other scripts, latin, cyrillic, kanji, thai etc. should work
		26	fine, though. A somewhat difficult case are left-to-right scripts, such
		27	as hebrew: B<rxvt-unicode> adopts the view that bidirectional algorithms
		28	belong into the application, not the terminal emulator (too many things --
		29	such as cursor-movement -- break othwerwise).
		30
		31	Another design rationale was the use of multiple fonts to display
		32	characters: The idea of a single unicode font which many other programs
		33	force onto it's users never made sense to me: You should be able to choose
		34	any font for any script.
		35
		36	Apart from that, rxvt-unicode is also much better internationalised than
		37	it's predecessor, supports things such as XFT and ISO 14755 that are handy
		38	in i18n-environments, is faster, and has a lot less bugs than the original
		39	rxvt. This all in addition to dozens of other small improvements.
		40
		41	It is still faithfully following the original rxvt idea of being lean
		42	and nice on resources: for example, you can still configure rxvt-unicode
		43	without most of it's features to get a lean binary. It also comes with
		44	a client/daemon pair that lets you open any number of terminal windows
		45	from within a single process, which makes startup time very fast and
		46	drastically reduces memory usage. See @@RXVT_NAME@@d(1) (daemon) and
		47	@@RXVT_NAME@@c(1) (client).
		48
		49	It also makes technical information about escape sequences (which have
		50	been extended) easier accessible: see @@RXVT_NAME@@(7) for technical
		51	reference documentation (escape sequences etc.) and the FAQ section at the
		52	end of this document.
		53
17	=head1 OPTIONS	54	=head1 OPTIONS
18		55
19	The B<@@RXVTNAME@@> options (mostly a subset of I<xterm>'s) are listed	56	The B<@@RXVT_NAME@@> options (mostly a subset of I<xterm>'s) are listed
20	below. In keeping with the smaller-is-better philosophy, options may be	57	below. In keeping with the smaller-is-better philosophy, options may be
21	eliminated or default values chosen at compile-time, so options and	58	eliminated or default values chosen at compile-time, so options and
22	defaults listed may not accurately reflect the version installed on	59	defaults listed may not accurately reflect the version installed on
23	your system. `rxvt -h' gives a list of major compile-time options on	60	your system. `@@RXVT_NAME@@ -h' gives a list of major compile-time options on
24	the I<Options> line. Option descriptions may be prefixed with which	61	the I<Options> line. Option descriptions may be prefixed with which
25	compile option each is dependent upon. e.g. `Compile I<XIM>:' requires	62	compile option each is dependent upon. e.g. `Compile I<XIM>:' requires
26	I<XIM> on the I<Options> line. Note: `rxvt -help' gives a list of all	63	I<XIM> on the I<Options> line. Note: `@@RXVT_NAME@@ -help' gives a list of all
27	command-line options compiled into your version.	64	command-line options compiled into your version.
28		65
29	Note that B<@@RXVTNAME@@> permits the resource name to be used as a	66	Note that B<@@RXVT_NAME@@> permits the resource name to be used as a
30	long-option (--/++ option) so the potential command-line options are	67	long-option (--/++ option) so the potential command-line options are
31	far greater than those listed. For example: `rxvt --loginShell --color1	68	far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1
32	Orange'.	69	Orange'.
33		70
34	The following options are available:	71	The following options are available:
35		72
36	=over 4	73	=over 4
…		…
117	names that are used in turn when trying to display Unicode characters.	154	names that are used in turn when trying to display Unicode characters.
118	The first font defines the cell size for characters; other fonts might	155	The first font defines the cell size for characters; other fonts might
119	be smaller, but not larger. A reasonable default font list is always	156	be smaller, but not larger. A reasonable default font list is always
120	appended to it. resource B<font>.	157	appended to it. resource B<font>.
121		158
		159	See also the question "How does rxvt-unicode choose fonts?" in the FAQ
		160	section.
		161
122	=item B<-rb>\|B<+rb>	162	=item B<-rb>\|B<+rb>
123		163
124	Enable "real bold" support. When this option is on, bold text will be	164	Enable "real bold" support. When this option is on, bold text will be
125	displayed using the first available bold font in the font list. Bold	165	displayed using the first available bold font in the font list. Bold
126	fonts should thus be specified in the font list after their	166	fonts should thus be specified in the font list after their
…		…
202	B<externalBorder>.	242	B<externalBorder>.
203		243
204	=item B<-bl>	244	=item B<-bl>
205		245
206	Compile I<frills>: Set MWM hints to request a borderless window, i.e.	246	Compile I<frills>: Set MWM hints to request a borderless window, i.e.
207	if honoured by the WM, the rxvt window will not have window	247	if honoured by the WM, the rxvt-unicode window will not have window
208	decorations; resource B<borderLess>.	248	decorations; resource B<borderLess>.
209		249
210	=item B<-lsp> I<number>	250	=item B<-lsp> I<number>
211		251
212	Compile I<linespace>: Lines (pixel height) to insert between each row	252	Compile I<linespace>: Lines (pixel height) to insert between each row
…		…
219	I<termcap(5)> database and should have I<li#> and I<co#> entries;	259	I<termcap(5)> database and should have I<li#> and I<co#> entries;
220	resource B<termName>.	260	resource B<termName>.
221		261
222	=item B<-e> I<command [arguments]>	262	=item B<-e> I<command [arguments]>
223		263
224	Run the command with its command-line arguments in the B<@@RXVTNAME@@>	264	Run the command with its command-line arguments in the B<@@RXVT_NAME@@>
225	window; also sets the window title and icon name to be the basename of	265	window; also sets the window title and icon name to be the basename of
226	the program being executed if neither I<-title> (I<-T>) nor I<-n> are	266	the program being executed if neither I<-title> (I<-T>) nor I<-n> are
227	given on the command line. If this option is used, it must be the last	267	given on the command line. If this option is used, it must be the last
228	on the command-line. If there is no B<-e> option then the default is to	268	on the command-line. If there is no B<-e> option then the default is to
229	run the program specified by the B<SHELL> environment variable or,	269	run the program specified by the B<SHELL> environment variable or,
…		…
283	Turn on/off secondary screen scroll (default enabled); resource	323	Turn on/off secondary screen scroll (default enabled); resource
284	B<secondaryScroll>.	324	B<secondaryScroll>.
285		325
286	=item B<-xrm> I<resourcestring>	326	=item B<-xrm> I<resourcestring>
287		327
288	No effect on rxvt. Simply passes through an argument to be made	328	No effect on rxvt-unicode. Simply passes through an argument to be made
289	available in the instance's argument list. Appears in I<WM_COMMAND> in	329	available in the instance's argument list. Appears in I<WM_COMMAND> in
290	some window managers.	330	some window managers.
291		331
292	=back	332	=back
293		333
294	=head1 RESOURCES (available also as long-options)	334	=head1 RESOURCES (available also as long-options)
295		335
296	Note: `@@RXVTNAME@@ --help' gives a list of all resources (long	336	Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long
297	options) compiled into your version.	337	options) compiled into your version.
298		338
299	There are two different methods that @@RXVTNAME@@ can use to get the	339	There are two different methods that @@RXVT_NAME@@ can use to get the
300	Xresource data: using the X libraries (Xrm*-functions) or internal	340	Xresource data: using the X libraries (Xrm*-functions) or internal
301	Xresources reader (B<~/.Xdefaults>). For the first method (ie.	341	Xresources reader (B<~/.Xdefaults>). For the first method (ie.
302	B<@@RXVTNAME@@ -h> lists B<XGetDefaults>), you can set and change the	342	B<@@RXVT_NAME@@ -h> lists B<XGetDefaults>), you can set and change the
303	resources using X11 tools like B<xset>. Many distribution do also load	343	resources using X11 tools like B<xset>. Many distribution do also load
304	settings from the B<~/.Xresources> file when X starts.	344	settings from the B<~/.Xresources> file when X starts.
305		345
306	If compiled with internal Xresources support (i.e. B<@@RXVTNAME@@ -h>	346	If compiled with internal Xresources support (i.e. B<@@RXVT_NAME@@ -h>
307	lists B<.Xdefaults>) then B<@@RXVTNAME@@> accepts application defaults	347	lists B<.Xdefaults>) then B<@@RXVT_NAME@@> accepts application defaults
308	set in XAPPLOADDIR/URxvt (compile-time defined: usually	348	set in XAPPLOADDIR/URxvt (compile-time defined: usually
309	B</usr/lib/X11/app-defaults/URxvt>) and resources set in	349	B</usr/lib/X11/app-defaults/URxvt>) and resources set in
310	B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist.	350	B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist.
311	Note that when reading X resources, B<@@RXVTNAME@@> recognizes two	351	Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two
312	class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows	352	class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows
313	resources common to both B<@@RXVTNAME@@> and the original I<rxvt> to be	353	resources common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be
314	easily configured, while the class name B<URxvt> allows resources	354	easily configured, while the class name B<URxvt> allows resources
315	unique to B<@@RXVTNAME@@>, notably colours and key-handling, to be	355	unique to B<@@RXVT_NAME@@>, notably colours and key-handling, to be
316	shared between different B<@@RXVTNAME@@> configurations. If no	356	shared between different B<@@RXVT_NAME@@> configurations. If no
317	resources are specified, suitable defaults will be used. Command-line	357	resources are specified, suitable defaults will be used. Command-line
318	arguments can be used to override resource settings. The following	358	arguments can be used to override resource settings. The following
319	resources are allowed:	359	resources are allowed:
320		360
321	=over 4	361	=over 4
…		…
462	xterm style with 2.20 old word selection, or anything else which gives	502	xterm style with 2.20 old word selection, or anything else which gives
463	xterm style selection.	503	xterm style selection.
464		504
465	=item B<scrollstyle:> I<mode>	505	=item B<scrollstyle:> I<mode>
466		506
467	Set scrollbar style to B<@@RXVTNAME@@>, B<rxvt>, B<plain>, B<next> or	507	Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
468	B<xterm>	508	the author's favourite..
469		509
470	=item B<title:> I<string>	510	=item B<title:> I<string>
471		511
472	Set window title string, the default title is the command-line	512	Set window title string, the default title is the command-line
473	specified after the B<-e> option, if any, otherwise the application	513	specified after the B<-e> option, if any, otherwise the application
…		…
527	Align the B<top>, B<bottom> or B<centre> [default] of the scrollbar	567	Align the B<top>, B<bottom> or B<centre> [default] of the scrollbar
528	thumb with the pointer on middle button press/drag.	568	thumb with the pointer on middle button press/drag.
529		569
530	=item B<scrollTtyOutput:> I<boolean>	570	=item B<scrollTtyOutput:> I<boolean>
531		571
532	B<True>: scroll to bottom when tty receives output; option B<+si>.	572	B<True>: scroll to bottom when tty receives output; option B<-si>.
533	B<False>: do not scroll to bottom when tty receives output; option	573	B<False>: do not scroll to bottom when tty receives output; option
534	B<-si>.	574	B<+si>.
535		575
536	=item B<scrollWithBuffer:> I<boolean>	576	=item B<scrollWithBuffer:> I<boolean>
537		577
538	B<True>: scroll with scrollback buffer when tty recieves new lines (and	578	B<True>: scroll with scrollback buffer when tty recieves new lines (and
539	B<scrollTtyOutput> is False); option B<+sw>. B<False>: do not scroll	579	B<scrollTtyOutput> is False); option B<+sw>. B<False>: do not scroll
540	with scrollback buffer when tty recieves new lines; option B<-sw>.	580	with scrollback buffer when tty recieves new lines; option B<-sw>.
541		581
542	=item B<scrollTtyKeypress:> I<boolean>	582	=item B<scrollTtyKeypress:> I<boolean>
543		583
544	B<True>: scroll to bottom when a non-special key is pressed. Special	584	B<True>: scroll to bottom when a non-special key is pressed. Special keys
545	keys are those which are intercepted by rxvt for special handling and	585	are those which are intercepted by rxvt-unicode for special handling and
546	are not passed onto the shell; option B<-sk>. B<False>: do not scroll	586	are not passed onto the shell; option B<-sk>. B<False>: do not scroll to
547	to bottom when a non-special key is pressed; option B<+sk>.	587	bottom when a non-special key is pressed; option B<+sk>.
548		588
549	=item B<smallfont_key:> I<keysym>	589	=item B<smallfont_key:> I<keysym>
550		590
551	If enabled, use B<@@HOTKEY@@->I<keysym> to toggle to a smaller font	591	If enabled, use B<@@HOTKEY@@->I<keysym> to toggle to a smaller font
552	[default B<@@HOTKEY@@-@@SMALLFONT@@>]	592	[default B<@@HOTKEY@@-@@SMALLFONT@@>]
…		…
572	option B<-w>, B<-bw>, B<-borderwidth>.	612	option B<-w>, B<-bw>, B<-borderwidth>.
573		613
574	=item B<borderLess:> I<boolean>	614	=item B<borderLess:> I<boolean>
575		615
576	Set MWM hints to request a borderless window, i.e. if honoured by the	616	Set MWM hints to request a borderless window, i.e. if honoured by the
577	WM, the rxvt window will not have window decorations; option B<-bl>.	617	WM, the rxvt-unicode window will not have window decorations; option B<-bl>.
578		618
579	=item B<termName:> I<termname>	619	=item B<termName:> I<termname>
580		620
581	Specifies the terminal type name to be set in the B<TERM> environment	621	Specifies the terminal type name to be set in the B<TERM> environment
582	variable; option B<-tn>.	622	variable; option B<-tn>.
…		…
673	B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option	713	B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option
674	B<-mod>.	714	B<-mod>.
675		715
676	=item B<answerbackString:> I<string>	716	=item B<answerbackString:> I<string>
677		717
678	Specify the reply rxvt sends to the shell when an ENQ (control-E)	718	Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
679	character is passed through. It may contain escape values as described	719	character is passed through. It may contain escape values as described
680	in the entry on B<keysym> following.	720	in the entry on B<keysym> following.
681		721
682	=item B<secondaryScreen:> I<bool>	722	=item B<secondaryScreen:> I<bool>
683		723
…		…
703		743
704	=back	744	=back
705		745
706	=head1 THE SCROLLBAR	746	=head1 THE SCROLLBAR
707		747
708	Lines of text that scroll off the top of the B<@@RXVTNAME@@> window	748	Lines of text that scroll off the top of the B<@@RXVT_NAME@@> window
709	(resource: B<saveLines>) and can be scrolled back using the scrollbar	749	(resource: B<saveLines>) and can be scrolled back using the scrollbar
710	or by keystrokes. The normal B<@@RXVTNAME@@> scrollbar has arrows and	750	or by keystrokes. The normal B<@@RXVT_NAME@@> scrollbar has arrows and
711	its behaviour is fairly intuitive. The B<xterm-scrollbar> is without	751	its behaviour is fairly intuitive. The B<xterm-scrollbar> is without
712	arrows and its behaviour mimics that of I<xterm>	752	arrows and its behaviour mimics that of I<xterm>
713		753
714	Scroll down with B<Button1> (B<xterm-scrollbar>) or B<Shift-Next>.	754	Scroll down with B<Button1> (B<xterm-scrollbar>) or B<Shift-Next>.
715	Scroll up with B<Button3> (B<xterm-scrollbar>) or B<Shift-Prior>.	755	Scroll up with B<Button3> (B<xterm-scrollbar>) or B<Shift-Prior>.
…		…
743	line.	783	line.
744		784
745	=item B<Insertion>:	785	=item B<Insertion>:
746		786
747	Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in	787	Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in
748	an B<@@RXVTNAME@@> window causes the current text selection to be	788	an B<@@RXVT_NAME@@> window causes the current text selection to be
749	inserted as if it had been typed on the keyboard.	789	inserted as if it had been typed on the keyboard.
750		790
751	=back	791	=back
752		792
753	=head1 CHANGING FONTS	793	=head1 CHANGING FONTS
…		…
757	B<Shift-KP_Subtract>. Or, alternatively (if enabled) with	797	B<Shift-KP_Subtract>. Or, alternatively (if enabled) with
758	B<@@HOTKEY@@-@@BIGFONT@@> and B<@@HOTKEY@@-@@SMALLFONT@@>, where the	798	B<@@HOTKEY@@-@@BIGFONT@@> and B<@@HOTKEY@@-@@SMALLFONT@@>, where the
759	actual key can be selected using resources	799	actual key can be selected using resources
760	B<smallfont_key>/B<bigfont_key>.	800	B<smallfont_key>/B<bigfont_key>.
761		801
		802	=head1 ISO 14755 SUPPORT
		803
		804	Partial ISO 14755-support is implemented. that means that pressing
		805
		806	Section 5.1: Control and Shift together enters unicode input
		807	mode. Entering hex digits composes a Unicode character, pressing space or
		808	releasing the modifiers commits the keycode and every other key cancels
		809	the current input character.
		810
		811	Section 5.2: Pressing and immediately releasing Control and Shift together
		812	enters keycap entry mode for the next key: pressing a function key (tab,
		813	return etc..) will enter the unicode character corresponding to the given
		814	key.
		815
762	=head1 LOGIN STAMP	816	=head1 LOGIN STAMP
763		817
764	B<@@RXVTNAME@@> tries to write an entry into the I<utmp>(5) file so	818	B<@@RXVT_NAME@@> tries to write an entry into the I<utmp>(5) file so
765	that it can be seen via the I<who(1)> command, and can accept messages.	819	that it can be seen via the I<who(1)> command, and can accept messages.
766	To allow this feature, B<@@RXVTNAME@@> must be installed setuid root on	820	To allow this feature, B<@@RXVT_NAME@@> must be installed setuid root on
767	some systems.	821	some systems.
768		822
769	=head1 COLORS AND GRAPHICS	823	=head1 COLORS AND GRAPHICS
770		824
771	In addition to the default foreground and background colours,	825	In addition to the default foreground and background colours,
772	B<@@RXVTNAME@@> can display up to 16 colours (8 ANSI colours plus	826	B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus
773	high-intensity bold/blink versions of the same). Here is a list of the	827	high-intensity bold/blink versions of the same). Here is a list of the
774	colours with their B<rgb.txt> names.	828	colours with their B<rgb.txt> names.
775		829
776	=begin table	830	=begin table
777		831
…		…
806	I<xterm>(1) where the colours are only swapped if they have not otherwise	860	I<xterm>(1) where the colours are only swapped if they have not otherwise
807	been specified. For example,	861	been specified. For example,
808		862
809	=over 4	863	=over 4
810		864
811	=item B<rxvt -fg Black -bg White -rv>	865	=item B<@@RXVT_NAME@@ -fg Black -bg White -rv>
812		866
813	would yield White on Black, while on I<xterm>(1) it would yield Black	867	would yield White on Black, while on I<xterm>(1) it would yield Black
814	on White.	868	on White.
815		869
816	=back	870	=back
817		871
		872	=head1 FREQUENTLY ASKED QUESTIONS (FAQ)
		873
		874	=over 4
		875
		876	=item How do I know which rxvt-unicode version I'm using?
		877
		878	The version number is displayed with the usage (-h). For rxvt-unicode
		879	version 2.14 and later, the escape sequence C<ESC[8n> sets the window
		880	title to the version number.
		881
		882	=item Why do the characters look ugly?
		883
		884	=item How does rxvt-unicode choose fonts?
		885
		886	Most fonts do not contain the full range of Unicode, which is
		887	fine. Chances are that the font you (or the admin/package maintainer of
		888	your system/os) have specified does not cover all the characters you want
		889	to display.
		890
		891	B<rxvt-unicode> makes a best-effort try at finding a replacement
		892	font. Often the result is fine, but sometimes the chosen font looks
		893	bad. In that case, select a font of your taste and add it to the font
		894	list, e.g.:
		895
		896	@@RXVT_NAME@@ -fn basefont,font2,font3...
		897
		898	When rxvt-unicode sees a character, it will first look at the base
		899	font. If the base font does not contain the character, it will go to the
		900	next font, and so on.
		901
		902	The only limitation is that all the fonts must not be larger than the base
		903	font, as the base font defines the principial cell size, which must be the
		904	same due to the way terminals work.
		905
		906	=item Why do some chinese characters look so different than others?
		907
		908	This is because there is a difference between script and language --
		909	rxvt-unicode does not know which language the text that is output
		910	is, as it only knows the unicode character codes. If rxvt-unicode
		911	first sees a japanese character, it might choose a japanese font for
		912	it. Subseqzuent japanese characters will take that font. Now, many chinese
		913	characters aren't represented in japanese fonts, so when the first
		914	non-japanese character comes up, rxvt-unicode will look for a chinese font
		915	-- unfortunately at this point, it will still use the japanese font for
		916	japanese characters that are also chinese.
		917
		918	The workaround is easy: just tag a chinese font at the end of your font
		919	list (see the previous question). The key is to view the font list as
		920	a preference list: If you expect more japanese, list a japanese font
		921	first. If you expect more chinese, put a chinese font first.
		922
		923	In the future it might be possible to switch preferences at runtime (the
		924	internal data structure has no problem with using different fonts for
		925	the same character at the same time, but no interface for this has been
		926	designed yet).
		927
		928	=item Mouse cut/paste suddenly no longer works.
		929
		930	Make sure that mouse reporting is actually turned off since killing
		931	some editors prematurely may leave the mouse in mouse report mode. I've
		932	heard that tcsh may use mouse reporting unless it otherwise specified. A
		933	quick check is to see if cut/paste works when the Alt or Shift keys are
		934	depressed. See @@RXVT_NAME@@(7)
		935
		936	=item What's with this bold/blink stuff?
		937
		938	If no bold colour is set via C<colorBD:>, bold will invert text using the
		939	standard foreground colour.
		940
		941	For the standard background colour, blinking will actually make the
		942	text blink when compiled with C<--enable-blinking>. with standard
		943	colours. Without C<--enable-blinking>, the blink attribute will be
		944	ignored.
		945
		946	On ANSI colours, bold/blink attributes are used to set high-intensity
		947	foreground/background colors.
		948
		949	color0-7 are the low-intensity colors.
		950
		951	color8-15 are the corresponding high-intensity colors.
		952
		953	=item I don't like the screen colors. How do I change them?
		954
		955	You can change the screen colors at run-time using F<~/.Xdefaults>
		956	resources (or as long-options).
		957
		958	Here are values that are supposed to resemble a VGA screen,
		959	including the murky brown that passes for low-intensity yellow:
		960
		961	Rxvt*color0: #000000
		962	Rxvt*color1: #A80000
		963	Rxvt*color2: #00A800
		964	Rxvt*color3: #A8A800
		965	Rxvt*color4: #0000A8
		966	Rxvt*color5: #A800A8
		967	Rxvt*color6: #00A8A8
		968	Rxvt*color7: #A8A8A8
		969
		970	Rxvt*color8: #000054
		971	Rxvt*color9: #FF0054
		972	Rxvt*color10: #00FF54
		973	Rxvt*color11: #FFFF54
		974	Rxvt*color12: #0000FF
		975	Rxvt*color13: #FF00FF
		976	Rxvt*color14: #00FFFF
		977	Rxvt*color15: #FFFFFF
		978
		979	=item What's with the strange Backspace/Delete key behaviour?
		980
		981	Assuming that the physical Backspace key corresponds to the
		982	BackSpace keysym (not likely for Linux ... see the following
		983	question) there are two standard values that can be used for
		984	Backspace: C<^H> and C<^?>.
		985
		986	Historically, either value is correct, but rxvt-unicode adopts the debian
		987	policy of using C<^?> when unsure, because it's the one only only correct
		988	choice :).
		989
		990	Rxvt-unicode tries to inherit the current stty settings and uses the value
		991	of `erase' to guess the value for backspace. If rxvt-unicode wasn't
		992	started from a terminal (say, from a menu or by remote shell), then the
		993	system value of `erase', which corresponds to CERASE in <termios.h>, will
		994	be used (which may not be the same as your stty setting).
		995
		996	For starting a new rxvt-unicode:
		997
		998	# use Backspace = ^H
		999	$ stty erase ^H
		1000	$ @@RXVT_NAME@@
		1001
		1002	# use Backspace = ^?
		1003	$ stty erase ^?
		1004	$ @@RXVT_NAME@@
		1005
		1006	Toggle with "ESC[36h" / "ESC[36l" as documented in @@RXVT_NAME@@(7).
		1007
		1008	For an existing rxvt-unicode:
		1009
		1010	# use Backspace = ^H
		1011	$ stty erase ^H
		1012	$ echo -n "^[[36h"
		1013
		1014	# use Backspace = ^?
		1015	$ stty erase ^?
		1016	$ echo -n "^[[36l"
		1017
		1018	This helps satisfy some of the Backspace discrepancies that occur, but
		1019	if you use Backspace = C<^H>, make sure that the termcap/terminfo value
		1020	properly reflects that.
		1021
		1022	The Delete key is a another casualty of the ill-defined Backspace problem.
		1023	To avoid confusion between the Backspace and Delete keys, the Delete
		1024	key has been assigned an escape sequence to match the vt100 for Execute
		1025	(ESC[3~) and is in the supplied termcap/terminfo.
		1026
		1027	Some other Backspace problems:
		1028
		1029	some editors use termcap/terminfo,
		1030	some editors (vim I'm told) expect Backspace = ^H,
		1031	GNU Emacs (and Emacs-like editors) use ^H for help.
		1032
		1033	Perhaps someday this will all be resolved in a consistent manner.
		1034
		1035	=item I don't like the key-bindings. How do I change them?
		1036
		1037	There are some compile-time selections available via configure. Unless
		1038	you have run "configure" with the C<--disable-resources> option you can
		1039	use the `keysym' resource to alter the keystrings associated with keysym
		1040	0xFF00 - 0xFFFF (function, cursor keys, etc).
		1041
		1042	Here's an example for a tn3270 session started using `@@RXVT_NAME@@ -name tn3270'
		1043
		1044	!# ----- special uses ------:
		1045	! tn3270 login, remap function and arrow keys.
		1046	tn3270font: clean-bold----15-*
		1047
		1048	! keysym - used by rxvt only
		1049	! Delete - ^D
		1050	tn3270*keysym.0xFFFF: \004
		1051
		1052	! Home - ^A
		1053	tn3270*keysym.0xFF50: \001
		1054	! Left - ^B
		1055	tn3270*keysym.0xFF51: \002
		1056	! Up - ^P
		1057	tn3270*keysym.0xFF52: \020
		1058	! Right - ^F
		1059	tn3270*keysym.0xFF53: \006
		1060	! Down - ^N
		1061	tn3270*keysym.0xFF54: \016
		1062	! End - ^E
		1063	tn3270*keysym.0xFF57: \005
		1064
		1065	! F1 - F12
		1066	tn3270*keysym.0xFFBE: \e1
		1067	tn3270*keysym.0xFFBF: \e2
		1068	tn3270*keysym.0xFFC0: \e3
		1069	tn3270*keysym.0xFFC1: \e4
		1070	tn3270*keysym.0xFFC2: \e5
		1071	tn3270*keysym.0xFFC3: \e6
		1072	tn3270*keysym.0xFFC4: \e7
		1073	tn3270*keysym.0xFFC5: \e8
		1074	tn3270*keysym.0xFFC6: \e9
		1075	tn3270*keysym.0xFFC7: \e0
		1076	tn3270*keysym.0xFFC8: \e-
		1077	tn3270*keysym.0xFFC9: \e=
		1078
		1079	! map Prior/Next to F7/F8
		1080	tn3270*keysym.0xFF55: \e7
		1081	tn3270*keysym.0xFF56: \e8
		1082
		1083	=item I'm using keyboard model XXX that has extra Prior/Next/Insert keys.
		1084	How do I make use of them? For example, the Sun Keyboard type 4
		1085	has the following mappings that rxvt-unicode doesn't recognize.
		1086
		1087	KP_Insert == Insert
		1088	F22 == Print
		1089	F27 == Home
		1090	F29 == Prior
		1091	F33 == End
		1092	F35 == Next
		1093
		1094	Rather than have rxvt-unicode try to accomodate all the various possible keyboard
		1095	mappings, it is better to use `xmodmap' to remap the keys as required for
		1096	your particular machine.
		1097
		1098	=item How do I distinguish if I'm running rxvt-unicode or a regular xterm?
		1099	I need this to decide about setting colors etc.
		1100
		1101	rxvt and rxvt-unicode always export the variable "COLORTERM", so you can
		1102	check and see if that is set. Note that several programs, JED, slrn,
		1103	Midnight Commander automatically check this variable to decide whether or
		1104	not to use color.
		1105
		1106	=item How do I set the correct, full IP address for the DISPLAY variable?
		1107
		1108	If you've compiled rxvt-unicode with DISPLAY_IS_IP and ahve enabled
		1109	insecure mode then it is possible to use the following shell script
		1110	snippets to correctly set the display. If your version of rxvt-unicode
		1111	wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then
		1112	the COLORTERM variable can be used to distinguish rxvt-unicode from a
		1113	regular xterm.
		1114
		1115	Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script
		1116	snippets:
		1117
		1118	# Bourne/Korn/POSIX family of shells:
		1119	[ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
		1120	if [ ${TERM:-foo} = xterm ]; then
		1121	stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
		1122	echo -n '^[Z'
		1123	read term_id
		1124	stty icanon echo
		1125	if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
		1126	echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
		1127	read DISPLAY # set it in our local shell
		1128	fi
		1129	fi
		1130
		1131	=item How do I compile the manual pages for myself?
		1132
		1133	You need to have a recent version of perl installed as F</usr/bin/perl>,
		1134	one that comes with F<pod2man>, F<pod2text> and F<pod2html>. Then go to
		1135	the doc subdirectory and enter C<make alldoc>.
		1136
		1137	=back
		1138
818	=head1 ENVIRONMENT	1139	=head1 ENVIRONMENT
819		1140
820	B<@@RXVTNAME@@> sets the environment variables B<TERM>, B<COLORTERM>	1141	B<@@RXVT_NAME@@> sets the environment variables B<TERM>, B<COLORTERM>
821	and B<COLORFGBG>. The environment variable B<WINDOWID> is set to the X	1142	and B<COLORFGBG>. The environment variable B<WINDOWID> is set to the X
822	window id number of the B<@@RXVTNAME@@> window and it also uses and	1143	window id number of the B<@@RXVT_NAME@@> window and it also uses and
823	sets the environment variable B<DISPLAY> to specify which display	1144	sets the environment variable B<DISPLAY> to specify which display
824	terminal to use. B<@@RXVTNAME@@> uses the environment variables	1145	terminal to use. B<@@RXVT_NAME@@> uses the environment variables
825	B<RXVTPATH> and B<PATH> to find XPM files.	1146	B<RXVTPATH> and B<PATH> to find XPM files.
826		1147
827	=head1 FILES	1148	=head1 FILES
828		1149
829	=over 4	1150	=over 4
…		…
836		1157
837	Color names.	1158	Color names.
838		1159
839	=back	1160	=back
840		1161
841	=head1 SEEALSO	1162	=head1 SEE ALSO
842		1163
843	I<xterm>(1), I<sh>(1), I<resize>(1), I<X>(1), I<pty>(4), I<tty>(4), I<utmp>(5)	1164	@@RXVT_NAME@@(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
844
845	See rxvtRef.html rxvtRef.txt for detailed information on recognized escape sequences and menuBar syntax, etc.
846		1165
847	=head1 BUGS	1166	=head1 BUGS
848		1167
849	Check the BUGS file for an up-to-date list.	1168	Check the BUGS file for an up-to-date list.
850		1169
851	Cursor change support is not yet implemented.	1170	Cursor change support is not yet implemented.
852		1171
853	Click-and-drag doesn't work with X11 mouse report overriding.	1172	Click-and-drag doesn't work with X11 mouse report overriding.
854		1173
855	=head1 FTP LOCATION
856
857	rxvt-+@@RXVTVERSION@@.tar.gz can be found at the following ftp sites L<@@RXVTFTPSITE@@>(@@RXVTFTPSITE@@)
858
859	=head1 CURRENT PROJECT COORDINATOR	1174	=head1 CURRENT PROJECT COORDINATOR
860		1175
861	=over 4	1176	=over 4
862		1177
863	=item Project Coordinator	1178	=item Project Coordinator
864		1179
865	@@RXVTMAINT@@ L<@@RXVTMAINTEMAIL@@>	1180	@@RXVTMAINT@@ L<@@RXVT_MAINTEMAIL@@>
866		1181
867	=item Web page maintainter	1182	=item Web page maintainter
868		1183
869	@@RXVTWEBMAINT@@ L<@@RXVTWEBMAINTEMAIL@@>	1184	@@RXVTWEBMAINT@@ L<@@RXVT_WEBMAINTEMAIL@@>
870		1185
871	L<@@RXVTWEBPAGE@@>(@@RXVTWEBPAGE@@)	1186	L<@@RXVT_WEBPAGE@@>
872		1187
873	=back	1188	=back
874		1189
875	=head1 AUTHORS	1190	=head1 AUTHORS
876		1191

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents): Revision 1.1 by root, Thu Aug 12 20:42:12 2004 UTC vs. Revision 1.5 by root, Sat Aug 14 03:00:32 2004 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.1 by root, Thu Aug 12 20:42:12 2004 UTC vs.
Revision 1.5 by root, Sat Aug 14 03:00:32 2004 UTC