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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.247 by sf-exg, Thu Jul 14 05:33:25 2016 UTC vs.
Revision 1.263 by sf-exg, Sat Jan 20 08:00:50 2024 UTC

…		…
84	far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1	84	far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1
85	Orange'.	85	Orange'.
86		86
87	The following options are available:	87	The following options are available:
88		88
89	=over 4	89	=over
90		90
91	=item B<-help>, B<--help>	91	=item B<-help>, B<--help>
92		92
93	Print out a message describing available options.	93	Print out a message describing available options.
94		94
…		…
127	Turn on/off jump scrolling (allow multiple lines per refresh); resource B<jumpScroll>.	127	Turn on/off jump scrolling (allow multiple lines per refresh); resource B<jumpScroll>.
128		128
129	=item B<-ss>\|B<+ss>	129	=item B<-ss>\|B<+ss>
130		130
131	Turn on/off skip scrolling (allow multiple screens per refresh); resource B<skipScroll>.	131	Turn on/off skip scrolling (allow multiple screens per refresh); resource B<skipScroll>.
		132
		133	=item B<-fps> I<number>
		134
		135	Compile I<frills>: Set the refresh interval (in frames per second or
		136	negative seconds); resource B<refreshRate>.
132		137
133	=item B<-fade> I<number>	138	=item B<-fade> I<number>
134		139
135	Fade the text by the given percentage when focus is lost. Small values	140	Fade the text by the given percentage when focus is lost. Small values
136	fade a little only, 100 completely replaces all colours by the fade	141	fade a little only, 100 completely replaces all colours by the fade
…		…
406	Change the meaning of triple-click selection with the left mouse	411	Change the meaning of triple-click selection with the left mouse
407	button. Only effective when the original (non-perl) selection code is	412	button. Only effective when the original (non-perl) selection code is
408	in-use. Instead of selecting a full line it will extend the selection to	413	in-use. Instead of selecting a full line it will extend the selection to
409	the end of the logical line only. resource B<tripleclickwords>.	414	the end of the logical line only. resource B<tripleclickwords>.
410		415
		416	=item B<-dpb>\|B<+dpb>
		417
		418	Compile frills: Disable (or enable) emitting bracketed paste mode
		419	sequences (default enabled). Bracketed paste mode allows programs
		420	to detect when something is pasted. Since more and more programs
		421	abuse this, these sequences can be disabled. The command sequences to
		422	enable and query paste mode will still work, but the actual bracket
		423	sequences will no longer be emitted. You can also toggle this from the
		424	ctrl-middle-mouse-button menu; resource B<disablePasteBrackets>.
		425
411	=item B<-insecure>	426	=item B<-insecure>
412		427
413	Enable "insecure" mode, which currently enables most of the escape	428	Enable "insecure" mode, which currently enables most of the escape
414	sequences that echo strings. See the resource B<insecure> for more	429	sequences that echo strings. See the resource B<insecure> for more
415	info.	430	info.
…		…
427		442
428	=item B<-ssr>\|B<+ssr>	443	=item B<-ssr>\|B<+ssr>
429		444
430	Turn on/off secondary screen scroll (default enabled); resource	445	Turn on/off secondary screen scroll (default enabled); resource
431	B<secondaryScroll>.	446	B<secondaryScroll>.
		447
		448	=item B<-rm> I<mode>
		449
		450	Compile I<frills>: Sets long line rewrapping behaviour on window resizes
		451	to one of B<auto> (the default), B<always> or B<never>. The latter two
		452	modes do the obvious, B<auto> rewraps (acts like B<always>) if scrollback
		453	is non-empty, and wings lines (acts like B<never>) otherwise; resource
		454	B<rewrapMode>.
432		455
433	=item B<-hold>\|B<+hold>	456	=item B<-hold>\|B<+hold>
434		457
435	Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@	458	Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
436	will not immediately destroy its window when the program executed within	459	will not immediately destroy its window when the program executed within
…		…
514	close $pty;	537	close $pty;
515		538
516	# now communicate with rxvt	539	# now communicate with rxvt
517	my $slave = $pty->slave;	540	my $slave = $pty->slave;
518	while (<$slave>) { print $slave "got <$_>\n" }	541	while (<$slave>) { print $slave "got <$_>\n" }
		542
		543	Note that, despite what the name might imply, the file descriptor does not
		544	need to be a pty, it can be a bi-directional pipe as well (e.g. a unix
		545	domain or tcp socket). While tty operations cannot be done in this case,
		546	B<@@RXVT_NAME@@> can still be remote controlled with it:
		547
		548	use Socket;
		549	use Fcntl;
		550
		551	socketpair my $URXVT, my $slave, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC;
		552	fcntl $slave, Fcntl::F_SETFD, 0;
		553	system "exec @@RXVT_NAME@@ -pty-fd " . (fileno $slave) . " &";
		554	close $slave;
		555
		556	syswrite $URXVT, "Type a secret password: ";
		557	my $secret = do { local $/ = "\r"; <$URXVT> };
		558	print "Not so secret anymore: $secret\n";
519		559
520	=item B<-pe> I<string>	560	=item B<-pe> I<string>
521		561
522	Comma-separated list of perl extension scripts to use (or not to use) in	562	Comma-separated list of perl extension scripts to use (or not to use) in
523	this terminal instance. See resource B<perl-ext> for details.	563	this terminal instance. See resource B<perl-ext> for details.
…		…
551	be used. Command-line arguments can be used to override resource	591	be used. Command-line arguments can be used to override resource
552	settings. The following resources are supported (you might want to	592	settings. The following resources are supported (you might want to
553	check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl	593	check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
554	extensions not documented here):	594	extensions not documented here):
555		595
556	=over 4	596	=over
557		597
558	=item B<depth:> I<bitdepth>	598	=item B<depth:> I<bitdepth>
559		599
560	Compile I<xft>: Attempt to find a visual with the given bit depth;	600	Compile I<xft>: Attempt to find a visual with the given bit depth;
561	option B<-depth>.	601	option B<-depth>.
…		…
662		702
663	B<False>: specify that everything is to be displayed, even	703	B<False>: specify that everything is to be displayed, even
664	if the refresh is too fast for the human eye to read anything (or the	704	if the refresh is too fast for the human eye to read anything (or the
665	monitor to display anything); option B<+ss>.	705	monitor to display anything); option B<+ss>.
666		706
		707	=item B<refreshRate:> I<number>
		708
		709	Compile I<frills>: When positive, sets the maximum refreshes per second
		710	(the default is C<60>). When zero or negative, sets the minimum interval
		711	between refreshes, negated. That is, positive numbers limit the number
		712	of refreshes per second to that number, similar to a fps limiter in
		713	games. A negative number gets negated and directly sets the minimum
		714	interval between refreshes, that is, C<10> and C<-0.1> both specify
		715	the same refresh interval (likewise C<50> and C<0.02>). Finally, zero
		716	makes @@RXVT_NAME@@ refresh as fast as possible. Fractional values are
		717	supported; option B<-fps>.
		718
667	=item B<fading:> I<number>	719	=item B<fading:> I<number>
668		720
669	Fade the text by the given percentage when focus is lost; option B<-fade>.	721	Fade the text by the given percentage when focus is lost; option B<-fade>.
670		722
671	=item B<fadeColor:> I<colour>	723	=item B<fadeColor:> I<colour>
…		…
851	Align the B<top>, B<bottom> or B<centre> [default] of the scrollbar	903	Align the B<top>, B<bottom> or B<centre> [default] of the scrollbar
852	thumb with the pointer on middle button press/drag.	904	thumb with the pointer on middle button press/drag.
853		905
854	=item B<scrollTtyOutput:> I<boolean>	906	=item B<scrollTtyOutput:> I<boolean>
855		907
856	B<True>: scroll to bottom when tty receives output; option B<-si>.	908	B<True>: scroll to bottom when tty receives output; option B<+si>.
857	B<False>: do not scroll to bottom when tty receives output; option	909	B<False>: do not scroll to bottom when tty receives output; option
858	B<+si>.	910	B<-si>.
859		911
860	=item B<scrollWithBuffer:> I<boolean>	912	=item B<scrollWithBuffer:> I<boolean>
861		913
862	B<True>: scroll with scrollback buffer when tty receives new lines (i.e.	914	B<True>: scroll with scrollback buffer when tty receives new lines (i.e.
863	try to show the same lines) and B<scrollTtyOutput> is False; option	915	try to show the same lines) and B<scrollTtyOutput> is False; option
…		…
1013		1065
1014	Change the meaning of triple-click selection with the left mouse	1066	Change the meaning of triple-click selection with the left mouse
1015	button. Instead of selecting a full line it will extend the selection to	1067	button. Instead of selecting a full line it will extend the selection to
1016	the end of the logical line only; option B<-tcw>.	1068	the end of the logical line only; option B<-tcw>.
1017		1069
		1070	=item B<disablePasteBrackets:> I<boolean>
		1071
		1072	Prevent emission of paste bracket sequences; option B<-dpb>.
		1073
1018	=item B<insecure:> I<boolean>	1074	=item B<insecure:> I<boolean>
1019		1075
1020	Enables "insecure" mode. Rxvt-unicode offers some escape sequences that	1076	Enable "insecure" mode. Rxvt-unicode offers some escape sequences that
1021	echo arbitrary strings like the icon name or the locale. This could be	1077	echo arbitrary strings like the icon name or the locale. This could be
1022	abused if somebody gets 8-bit-clean access to your display, whether	1078	abused if somebody gets 8-bit-clean access to your display, whether
1023	through a mail client displaying mail bodies unfiltered or through	1079	through a mail client displaying mail bodies unfiltered or through
1024	write(1) or any other means. Therefore, these sequences are disabled by	1080	write(1) or any other means. Therefore, these sequences are disabled by
1025	default. (Note that many other terminals, including xterm, have these	1081	default. (Note that many other terminals, including xterm, have these
…		…
1043		1099
1044	=item B<secondaryScreen:> I<boolean>	1100	=item B<secondaryScreen:> I<boolean>
1045		1101
1046	Turn on/off secondary screen (default enabled).	1102	Turn on/off secondary screen (default enabled).
1047		1103
		1104	=item B<rewrapMode:> I<mode>
		1105
		1106	Sets long line rewrap behaviour on window resize to one of B<auto>
		1107	(default), B<always> or B<never>.
		1108
1048	=item B<secondaryScroll:> I<boolean>	1109	=item B<secondaryScroll:> I<boolean>
1049		1110
1050	Turn on/off secondary screen scroll (default enabled). If this	1111	Turn on/off secondary screen scroll (default enabled). If this
1051	option is enabled, scrolls on the secondary screen will change the	1112	option is enabled, scrolls on the secondary screen will change the
1052	scrollback buffer and, when secondaryScreen is off, switching	1113	scrollback buffer and, when secondaryScreen is off, switching
…		…
1079		1140
1080	The key combination that triggers the action, I<sym>, has the following format:	1141	The key combination that triggers the action, I<sym>, has the following format:
1081		1142
1082	(modifiers-)key	1143	(modifiers-)key
1083		1144
1084	Where I<modifiers> can be any combination of B<ISOLevel3>, B<AppKeypad>,	1145	Where I<modifiers> can be any combination of the following full or
1085	B<Control>, B<NumLock>, B<Shift>, B<Meta>, B<Lock>, B<Mod1>, B<Mod2>,	1146	abbreviated modifier names:
1086	B<Mod3>, B<Mod4>, B<Mod5>, and the abbreviated B<I>, B<K>, B<C>, B<N>,	1147
1087	B<S>, B<M>, B<A>, B<L>, B<1>, B<2>, B<3>, B<4>, B<5>.	1148	=begin table
		1149
		1150	B<ISOLevel3> B<I>
		1151	B<AppKeypad> B<K>
		1152	B<Control> B<C>
		1153	B<NumLock> B<N>
		1154	B<Shift> B<S>
		1155	B<Meta> B<M> I<or> B<A>
		1156	B<Lock> B<L>
		1157	B<Mod1> B<1>
		1158	B<Mod2> B<2>
		1159	B<Mod3> B<3>
		1160	B<Mod4> B<4>
		1161	B<Mod5> B<5>
		1162
		1163	=end table
1088		1164
1089	The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to	1165	The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to
1090	whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr	1166	whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr
1091	keys are being mapped. B<AppKeypad> is a synthetic modifier mapped to the	1167	keys are being mapped. B<AppKeypad> is a synthetic modifier mapped to the
1092	current application keymap mode state.	1168	current application keymap mode state.
…		…
1115	prefixed with C<string:>).	1191	prefixed with C<string:>).
1116		1192
1117	The following action prefixes are known - extensions can provide	1193	The following action prefixes are known - extensions can provide
1118	additional prefixes:	1194	additional prefixes:
1119		1195
1120	=over 4	1196	=over
1121		1197
1122	=item string:STRING	1198	=item string:STRING
1123		1199
1124	If the I<action> starts with C<string:> (or otherwise contains no colons),	1200	If the I<action> starts with C<string:> (or otherwise contains no colons),
1125	then the remaining C<STRING> will be passed to the program running in the	1201	then the remaining C<STRING> will be passed to the program running in the
…		…
1245	=item B<perl-ext>: I<string>	1321	=item B<perl-ext>: I<string>
1246		1322
1247	Comma-separated list(s) of perl extension scripts (default: C<default>) to	1323	Comma-separated list(s) of perl extension scripts (default: C<default>) to
1248	use in this terminal instance; option B<-pe>.	1324	use in this terminal instance; option B<-pe>.
1249		1325
1250	Extension names can be prefixed with a C<-> sign to prohibit using	1326	Extension names can be prefixed with a C<-> sign to remove them again, in
1251	them. This can be useful to selectively disable some extensions loaded	1327	case they had been specified earlier. This can be useful to selectively
1252	by default, or specified via the C<perl-ext-common> resource. For	1328	disable some extensions loaded by default, or specified via the
1253	example, C<default,-selection> will use all the default extensions except	1329	C<perl-ext-common> resource. For example, C<default,-selection> will use
1254	C<selection>.	1330	all the default extensions except C<selection>.
		1331
		1332	To prohibit autoloading of extensions, you can prefix them with C</>,
		1333	which will make urxvt refuse to automatically load them (this can be
		1334	overridden, however, by specifying the extension name again without a
		1335	prefix, though). This does not prohibit extensions themselves loading
		1336	other extensions. For example, C<default,/background> will keep the
		1337	C<background> extension from being loaded when a background OSC sequence
		1338	is received.
1255		1339
1256	The default set includes the C<selection>, C<option-popup>,	1340	The default set includes the C<selection>, C<option-popup>,
1257	C<selection-popup>, C<readline> and C<searchable-scrollback>	1341	C<selection-popup>, C<readline>, C<searchable-scrollback> and
1258	extensions, and extensions which are mentioned in B<keysym> resources.	1342	C<confirm-paste> extensions, as well as any extensions which are mentioned
		1343	in B<keysym> resources.
1259		1344
1260	Any extension such that a corresponding resource is given on the	1345	Any extension such that a corresponding resource is given on the
1261	command line is automatically appended to B<perl-ext>.	1346	command line is automatically appended to B<perl-ext>.
1262		1347
1263	Each extension is looked up in the library directories, loaded if	1348	Each extension is looked up in the library directories, loaded if
…		…
1353	=head1 THE SELECTION: SELECTING AND PASTING TEXT	1438	=head1 THE SELECTION: SELECTING AND PASTING TEXT
1354		1439
1355	The behaviour of text selection and insertion/pasting mechanism is similar	1440	The behaviour of text selection and insertion/pasting mechanism is similar
1356	to I<xterm>(1).	1441	to I<xterm>(1).
1357		1442
1358	=over 4	1443	=over
1359		1444
1360	=item B<Selecting>:	1445	=item B<Selecting>:
1361		1446
1362	Left click at the beginning of the region, drag to the end of the region	1447	Left click at the beginning of the region, drag to the end of the region
1363	and release; Right click to extend the marked region; Left double-click	1448	and release; Right click to extend the marked region; Left double-click
…		…
1379		1464
1380	Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be	1465	Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be
1381	inserted too.	1466	inserted too.
1382		1467
1383	rxvt-unicode also provides the bindings B<Ctrl-Meta-c> and	1468	rxvt-unicode also provides the bindings B<Ctrl-Meta-c> and
1384	<Ctrl-Meta-v> to interact with the CLIPBOARD selection. The first	1469	B<Ctrl-Meta-v> to interact with the CLIPBOARD selection. The first
1385	binding causes the value of the internal selection to be copied to the	1470	binding causes the value of the internal selection to be copied to the
1386	CLIPBOARD selection, while the second binding causes the value of the	1471	CLIPBOARD selection, while the second binding causes the value of the
1387	CLIPBOARD selection to be inserted.	1472	CLIPBOARD selection to be inserted.
1388		1473
1389	=back	1474	=back
…		…
1410	and character codes using the keyboard. It consists of 4 parts. The	1495	and character codes using the keyboard. It consists of 4 parts. The
1411	first part is available if rxvt-unicode has been compiled with	1496	first part is available if rxvt-unicode has been compiled with
1412	C<--enable-frills>, the rest is available when rxvt-unicode was compiled	1497	C<--enable-frills>, the rest is available when rxvt-unicode was compiled
1413	with C<--enable-iso14755>.	1498	with C<--enable-iso14755>.
1414		1499
1415	=over 4	1500	=over
1416		1501
1417	=item * 5.1: Basic method	1502	=item * 5.1: Basic method
1418		1503
1419	This allows you to enter unicode characters using their hexcode.	1504	This allows you to enter unicode characters using their hexcode.
1420		1505
…		…
1600		1685
1601	=head1 ENVIRONMENT	1686	=head1 ENVIRONMENT
1602		1687
1603	B<@@RXVT_NAME@@> sets and/or uses the following environment variables:	1688	B<@@RXVT_NAME@@> sets and/or uses the following environment variables:
1604		1689
1605	=over 4	1690	=over
1606		1691
1607	=item B<TERM>	1692	=item B<TERM>
1608		1693
1609	Normally set to C<rxvt-unicode>, unless overwritten at configure time, via	1694	Normally set to C<rxvt-unicode>, unless overwritten at configure time, via
1610	resources or on the command line.	1695	resources or on the command line.
…		…
1681		1766
1682	=back	1767	=back
1683		1768
1684	=head1 FILES	1769	=head1 FILES
1685		1770
1686	=over 4	1771	=over
1687		1772
1688	=item B</usr/lib/X11/rgb.txt>	1773	=item B</usr/lib/X11/rgb.txt>
1689		1774
1690	Colour names.	1775	Colour names.
1691		1776
…		…
1696	@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@-extensions(1),	1781	@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@-extensions(1),
1697	@@RXVT_NAME@@perl(3), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)	1782	@@RXVT_NAME@@perl(3), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
1698		1783
1699	=head1 CURRENT PROJECT COORDINATOR	1784	=head1 CURRENT PROJECT COORDINATOR
1700		1785
1701	=over 4	1786	=over
1702		1787
1703	=item Project Coordinator	1788	=item Project Coordinator
1704		1789
1705	Marc A. Lehmann <rxvt-unicode@schmorp.de>.	1790	Marc A. Lehmann <rxvt-unicode@schmorp.de>.
1706		1791
…		…
1708		1793
1709	=back	1794	=back
1710		1795
1711	=head1 AUTHORS	1796	=head1 AUTHORS
1712		1797
1713	=over 4	1798	=over
1714		1799
1715	=item John Bovey	1800	=item John Bovey
1716		1801
1717	University of Kent, 1992, wrote the original Xvt.	1802	University of Kent, 1992, wrote the original Xvt.
1718		1803

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents): Revision 1.247 by sf-exg, Thu Jul 14 05:33:25 2016 UTC vs. Revision 1.263 by sf-exg, Sat Jan 20 08:00:50 2024 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.247 by sf-exg, Thu Jul 14 05:33:25 2016 UTC vs.
Revision 1.263 by sf-exg, Sat Jan 20 08:00:50 2024 UTC