[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.257 by root, Mon Nov 22 17:01:05 2021 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
…		…
406	Change the meaning of triple-click selection with the left mouse	406	Change the meaning of triple-click selection with the left mouse
407	button. Only effective when the original (non-perl) selection code is	407	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	408	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>.	409	the end of the logical line only. resource B<tripleclickwords>.
410		410
		411	=item B<-dpb>\|B<+dpb>
		412
		413	Compile frills: Disable (or enable) emitting bracketed paste mode
		414	sequences (default enabled). Bracketed paste mode allows programs
		415	to detect when something is pasted. Since more and more programs
		416	abuse this, these sequences can be disabled. The command sequences to
		417	enable and query paste mode will still work, but the actual bracket
		418	sequences will no longer be emitted. You can also toggle this from the
		419	ctrl-middle-mouse-button menu; resource B<disablePasteBrackets>.
		420
411	=item B<-insecure>	421	=item B<-insecure>
412		422
413	Enable "insecure" mode, which currently enables most of the escape	423	Enable "insecure" mode, which currently enables most of the escape
414	sequences that echo strings. See the resource B<insecure> for more	424	sequences that echo strings. See the resource B<insecure> for more
415	info.	425	info.
…		…
427		437
428	=item B<-ssr>\|B<+ssr>	438	=item B<-ssr>\|B<+ssr>
429		439
430	Turn on/off secondary screen scroll (default enabled); resource	440	Turn on/off secondary screen scroll (default enabled); resource
431	B<secondaryScroll>.	441	B<secondaryScroll>.
		442
		443	=item B<-rm> I<mode>
		444
		445	Compile I<frills>: Sets long line rewrapping behaviour on window resizes
		446	to one of B<auto> (the default), B<always> or B<never>. The latter two
		447	modes do the obvious, B<auto> rewraps (acts like B<always>) if scrollback
		448	is non-empty, and wings lines (acts like B<never>) otherwise; resource
		449	B<rewrapMode>.
432		450
433	=item B<-hold>\|B<+hold>	451	=item B<-hold>\|B<+hold>
434		452
435	Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@	453	Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
436	will not immediately destroy its window when the program executed within	454	will not immediately destroy its window when the program executed within
…		…
514	close $pty;	532	close $pty;
515		533
516	# now communicate with rxvt	534	# now communicate with rxvt
517	my $slave = $pty->slave;	535	my $slave = $pty->slave;
518	while (<$slave>) { print $slave "got <$_>\n" }	536	while (<$slave>) { print $slave "got <$_>\n" }
		537
		538	Note that, despite what the name might imply, the file descriptor does not
		539	need to be a pty, it can be a bi-directional pipe as well (e.g. a unix
		540	domain or tcp socket). While tty operations cannot be done in this case,
		541	B<@@RXVT_NAME@@> can still be remote controlled with it:
		542
		543	use Socket;
		544	use Fcntl;
		545
		546	socketpair my $URXVT, my $slave, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC;
		547	fcntl $slave, Fcntl::F_SETFD, 0;
		548	system "exec @@RXVT_NAME\|\| -pty-fd " . (fileno $slave) . " &";
		549	close $slave;
		550
		551	syswrite $URXVT, "Type a secret password: ";
		552	my $secret = do { local $/ = "\r"; <$URXVT> };
		553	print "Not so secret anymore: $secret\n";
519		554
520	=item B<-pe> I<string>	555	=item B<-pe> I<string>
521		556
522	Comma-separated list of perl extension scripts to use (or not to use) in	557	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.	558	this terminal instance. See resource B<perl-ext> for details.
…		…
551	be used. Command-line arguments can be used to override resource	586	be used. Command-line arguments can be used to override resource
552	settings. The following resources are supported (you might want to	587	settings. The following resources are supported (you might want to
553	check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl	588	check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
554	extensions not documented here):	589	extensions not documented here):
555		590
556	=over 4	591	=over
557		592
558	=item B<depth:> I<bitdepth>	593	=item B<depth:> I<bitdepth>
559		594
560	Compile I<xft>: Attempt to find a visual with the given bit depth;	595	Compile I<xft>: Attempt to find a visual with the given bit depth;
561	option B<-depth>.	596	option B<-depth>.
…		…
1013		1048
1014	Change the meaning of triple-click selection with the left mouse	1049	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	1050	button. Instead of selecting a full line it will extend the selection to
1016	the end of the logical line only; option B<-tcw>.	1051	the end of the logical line only; option B<-tcw>.
1017		1052
		1053	=item B<disablePasteBrackets:> I<boolean>
		1054
		1055	Prevent emission of paste bracket sequences; option B<-dpb>.
		1056
1018	=item B<insecure:> I<boolean>	1057	=item B<insecure:> I<boolean>
1019		1058
1020	Enables "insecure" mode. Rxvt-unicode offers some escape sequences that	1059	Enable "insecure" mode. Rxvt-unicode offers some escape sequences that
1021	echo arbitrary strings like the icon name or the locale. This could be	1060	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	1061	abused if somebody gets 8-bit-clean access to your display, whether
1023	through a mail client displaying mail bodies unfiltered or through	1062	through a mail client displaying mail bodies unfiltered or through
1024	write(1) or any other means. Therefore, these sequences are disabled by	1063	write(1) or any other means. Therefore, these sequences are disabled by
1025	default. (Note that many other terminals, including xterm, have these	1064	default. (Note that many other terminals, including xterm, have these
…		…
1043		1082
1044	=item B<secondaryScreen:> I<boolean>	1083	=item B<secondaryScreen:> I<boolean>
1045		1084
1046	Turn on/off secondary screen (default enabled).	1085	Turn on/off secondary screen (default enabled).
1047		1086
		1087	=item B<rewrapMode:> I<mode>
		1088
		1089	Sets long line rewrap behaviour on window resize to one of B<auto>
		1090	(default), B<always> or B<never>.
		1091
1048	=item B<secondaryScroll:> I<boolean>	1092	=item B<secondaryScroll:> I<boolean>
1049		1093
1050	Turn on/off secondary screen scroll (default enabled). If this	1094	Turn on/off secondary screen scroll (default enabled). If this
1051	option is enabled, scrolls on the secondary screen will change the	1095	option is enabled, scrolls on the secondary screen will change the
1052	scrollback buffer and, when secondaryScreen is off, switching	1096	scrollback buffer and, when secondaryScreen is off, switching
…		…
1079		1123
1080	The key combination that triggers the action, I<sym>, has the following format:	1124	The key combination that triggers the action, I<sym>, has the following format:
1081		1125
1082	(modifiers-)key	1126	(modifiers-)key
1083		1127
1084	Where I<modifiers> can be any combination of B<ISOLevel3>, B<AppKeypad>,	1128	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>,	1129	abbreviated modifier names:
1086	B<Mod3>, B<Mod4>, B<Mod5>, and the abbreviated B<I>, B<K>, B<C>, B<N>,	1130
1087	B<S>, B<M>, B<A>, B<L>, B<1>, B<2>, B<3>, B<4>, B<5>.	1131	=begin table
		1132
		1133	B<ISOLevel3> B<I>
		1134	B<AppKeypad> B<K>
		1135	B<Control> B<C>
		1136	B<NumLock> B<N>
		1137	B<Shift> B<S>
		1138	B<Meta> B<M> I<or> B<A>
		1139	B<Lock> B<L>
		1140	B<Mod1> B<1>
		1141	B<Mod2> B<2>
		1142	B<Mod3> B<3>
		1143	B<Mod4> B<4>
		1144	B<Mod5> B<5>
		1145
		1146	=end table
1088		1147
1089	The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to	1148	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	1149	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	1150	keys are being mapped. B<AppKeypad> is a synthetic modifier mapped to the
1092	current application keymap mode state.	1151	current application keymap mode state.
…		…
1115	prefixed with C<string:>).	1174	prefixed with C<string:>).
1116		1175
1117	The following action prefixes are known - extensions can provide	1176	The following action prefixes are known - extensions can provide
1118	additional prefixes:	1177	additional prefixes:
1119		1178
1120	=over 4	1179	=over
1121		1180
1122	=item string:STRING	1181	=item string:STRING
1123		1182
1124	If the I<action> starts with C<string:> (or otherwise contains no colons),	1183	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	1184	then the remaining C<STRING> will be passed to the program running in the
…		…
1245	=item B<perl-ext>: I<string>	1304	=item B<perl-ext>: I<string>
1246		1305
1247	Comma-separated list(s) of perl extension scripts (default: C<default>) to	1306	Comma-separated list(s) of perl extension scripts (default: C<default>) to
1248	use in this terminal instance; option B<-pe>.	1307	use in this terminal instance; option B<-pe>.
1249		1308
1250	Extension names can be prefixed with a C<-> sign to prohibit using	1309	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	1310	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	1311	disable some extensions loaded by default, or specified via the
1253	example, C<default,-selection> will use all the default extensions except	1312	C<perl-ext-common> resource. For example, C<default,-selection> will use
1254	C<selection>.	1313	all the default extensions except C<selection>.
		1314
		1315	To prohibit autoloading of extensions, you can prefix them with C</>,
		1316	which will make urxvt refuse to automatically load them (this can be
		1317	overriden, however, by specifying the extension name again without a
		1318	prefix, though). This does not prohibit extensions themselves loading
		1319	other extensions. For example, C<default,/background> will keep the
		1320	C<background> extension from being loaded when a background OSC sequence
		1321	is received.
1255		1322
1256	The default set includes the C<selection>, C<option-popup>,	1323	The default set includes the C<selection>, C<option-popup>,
1257	C<selection-popup>, C<readline> and C<searchable-scrollback>	1324	C<selection-popup>, C<readline>, C<searchable-scrollback> and
1258	extensions, and extensions which are mentioned in B<keysym> resources.	1325	C<confirm-paste> extensions, as well as any extensions which are mentioned
		1326	in B<keysym> resources.
1259		1327
1260	Any extension such that a corresponding resource is given on the	1328	Any extension such that a corresponding resource is given on the
1261	command line is automatically appended to B<perl-ext>.	1329	command line is automatically appended to B<perl-ext>.
1262		1330
1263	Each extension is looked up in the library directories, loaded if	1331	Each extension is looked up in the library directories, loaded if
…		…
1353	=head1 THE SELECTION: SELECTING AND PASTING TEXT	1421	=head1 THE SELECTION: SELECTING AND PASTING TEXT
1354		1422
1355	The behaviour of text selection and insertion/pasting mechanism is similar	1423	The behaviour of text selection and insertion/pasting mechanism is similar
1356	to I<xterm>(1).	1424	to I<xterm>(1).
1357		1425
1358	=over 4	1426	=over
1359		1427
1360	=item B<Selecting>:	1428	=item B<Selecting>:
1361		1429
1362	Left click at the beginning of the region, drag to the end of the region	1430	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	1431	and release; Right click to extend the marked region; Left double-click
…		…
1410	and character codes using the keyboard. It consists of 4 parts. The	1478	and character codes using the keyboard. It consists of 4 parts. The
1411	first part is available if rxvt-unicode has been compiled with	1479	first part is available if rxvt-unicode has been compiled with
1412	C<--enable-frills>, the rest is available when rxvt-unicode was compiled	1480	C<--enable-frills>, the rest is available when rxvt-unicode was compiled
1413	with C<--enable-iso14755>.	1481	with C<--enable-iso14755>.
1414		1482
1415	=over 4	1483	=over
1416		1484
1417	=item * 5.1: Basic method	1485	=item * 5.1: Basic method
1418		1486
1419	This allows you to enter unicode characters using their hexcode.	1487	This allows you to enter unicode characters using their hexcode.
1420		1488
…		…
1600		1668
1601	=head1 ENVIRONMENT	1669	=head1 ENVIRONMENT
1602		1670
1603	B<@@RXVT_NAME@@> sets and/or uses the following environment variables:	1671	B<@@RXVT_NAME@@> sets and/or uses the following environment variables:
1604		1672
1605	=over 4	1673	=over
1606		1674
1607	=item B<TERM>	1675	=item B<TERM>
1608		1676
1609	Normally set to C<rxvt-unicode>, unless overwritten at configure time, via	1677	Normally set to C<rxvt-unicode>, unless overwritten at configure time, via
1610	resources or on the command line.	1678	resources or on the command line.
…		…
1681		1749
1682	=back	1750	=back
1683		1751
1684	=head1 FILES	1752	=head1 FILES
1685		1753
1686	=over 4	1754	=over
1687		1755
1688	=item B</usr/lib/X11/rgb.txt>	1756	=item B</usr/lib/X11/rgb.txt>
1689		1757
1690	Colour names.	1758	Colour names.
1691		1759
…		…
1696	@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@-extensions(1),	1764	@@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)	1765	@@RXVT_NAME@@perl(3), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
1698		1766
1699	=head1 CURRENT PROJECT COORDINATOR	1767	=head1 CURRENT PROJECT COORDINATOR
1700		1768
1701	=over 4	1769	=over
1702		1770
1703	=item Project Coordinator	1771	=item Project Coordinator
1704		1772
1705	Marc A. Lehmann <rxvt-unicode@schmorp.de>.	1773	Marc A. Lehmann <rxvt-unicode@schmorp.de>.
1706		1774
…		…
1708		1776
1709	=back	1777	=back
1710		1778
1711	=head1 AUTHORS	1779	=head1 AUTHORS
1712		1780
1713	=over 4	1781	=over
1714		1782
1715	=item John Bovey	1783	=item John Bovey
1716		1784
1717	University of Kent, 1992, wrote the original Xvt.	1785	University of Kent, 1992, wrote the original Xvt.
1718		1786

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.257 by root, Mon Nov 22 17:01:05 2021 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.257 by root, Mon Nov 22 17:01:05 2021 UTC