ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.pod
(Generate patch)

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.254 by root, Sat Jul 24 09:48:43 2021 UTC

84far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1 84far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1
85Orange'. 85Orange'.
86 86
87The following options are available: 87The 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
93Print out a message describing available options. 93Print out a message describing available options.
94 94
406Change the meaning of triple-click selection with the left mouse 406Change the meaning of triple-click selection with the left mouse
407button. Only effective when the original (non-perl) selection code is 407button. Only effective when the original (non-perl) selection code is
408in-use. Instead of selecting a full line it will extend the selection to 408in-use. Instead of selecting a full line it will extend the selection to
409the end of the logical line only. resource B<tripleclickwords>. 409the end of the logical line only. resource B<tripleclickwords>.
410 410
411=item B<-dpb>|B<+dpb>
412
413Compile frills: Disable (or enable) emitting bracketed paste mode
414sequences (default enabled). Bracketed paste mode allows programs
415to detect when something is pasted. Since more and more programs
416abuse this, these sequences can be disabled. The command sequences to
417enable and query paste mode will still work, but the actual bracket
418sequences will no longer be emitted. You can also toggle this from the
419ctrl-middle-mouse-button menu; resource B<disablePasteBrackets>.
420
411=item B<-insecure> 421=item B<-insecure>
412 422
413Enable "insecure" mode, which currently enables most of the escape 423Enable "insecure" mode, which currently enables most of the escape
414sequences that echo strings. See the resource B<insecure> for more 424sequences that echo strings. See the resource B<insecure> for more
415info. 425info.
427 437
428=item B<-ssr>|B<+ssr> 438=item B<-ssr>|B<+ssr>
429 439
430Turn on/off secondary screen scroll (default enabled); resource 440Turn on/off secondary screen scroll (default enabled); resource
431B<secondaryScroll>. 441B<secondaryScroll>.
442
443=item B<-rm> I<mode>
444
445Compile I<frills>: Sets long line rewrapping behaviour on window resizes
446to one of B<auto> (the default), B<always> or B<never>. The latter two
447modes do the obvious, B<auto> rewraps (acts like B<always>) if scrollback
448is non-empty, and wings lines (acts like B<never>) otherwise; resource
449B<rewrapMode>.
432 450
433=item B<-hold>|B<+hold> 451=item B<-hold>|B<+hold>
434 452
435Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ 453Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
436will not immediately destroy its window when the program executed within 454will not immediately destroy its window when the program executed within
551be used. Command-line arguments can be used to override resource 569be used. Command-line arguments can be used to override resource
552settings. The following resources are supported (you might want to 570settings. The following resources are supported (you might want to
553check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl 571check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
554extensions not documented here): 572extensions not documented here):
555 573
556=over 4 574=over
557 575
558=item B<depth:> I<bitdepth> 576=item B<depth:> I<bitdepth>
559 577
560Compile I<xft>: Attempt to find a visual with the given bit depth; 578Compile I<xft>: Attempt to find a visual with the given bit depth;
561option B<-depth>. 579option B<-depth>.
1013 1031
1014Change the meaning of triple-click selection with the left mouse 1032Change the meaning of triple-click selection with the left mouse
1015button. Instead of selecting a full line it will extend the selection to 1033button. Instead of selecting a full line it will extend the selection to
1016the end of the logical line only; option B<-tcw>. 1034the end of the logical line only; option B<-tcw>.
1017 1035
1036=item B<disablePasteBrackets:> I<boolean>
1037
1038Prevent emission of paste bracket sequences; option B<-dpb>.
1039
1018=item B<insecure:> I<boolean> 1040=item B<insecure:> I<boolean>
1019 1041
1020Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 1042Enable "insecure" mode. Rxvt-unicode offers some escape sequences that
1021echo arbitrary strings like the icon name or the locale. This could be 1043echo arbitrary strings like the icon name or the locale. This could be
1022abused if somebody gets 8-bit-clean access to your display, whether 1044abused if somebody gets 8-bit-clean access to your display, whether
1023through a mail client displaying mail bodies unfiltered or through 1045through a mail client displaying mail bodies unfiltered or through
1024write(1) or any other means. Therefore, these sequences are disabled by 1046write(1) or any other means. Therefore, these sequences are disabled by
1025default. (Note that many other terminals, including xterm, have these 1047default. (Note that many other terminals, including xterm, have these
1043 1065
1044=item B<secondaryScreen:> I<boolean> 1066=item B<secondaryScreen:> I<boolean>
1045 1067
1046Turn on/off secondary screen (default enabled). 1068Turn on/off secondary screen (default enabled).
1047 1069
1070=item B<rewrapMode:> I<mode>
1071
1072Sets long line rewrap behaviour on window resize to one of B<auto>
1073(default), B<always> or B<never>.
1074
1048=item B<secondaryScroll:> I<boolean> 1075=item B<secondaryScroll:> I<boolean>
1049 1076
1050Turn on/off secondary screen scroll (default enabled). If this 1077Turn on/off secondary screen scroll (default enabled). If this
1051option is enabled, scrolls on the secondary screen will change the 1078option is enabled, scrolls on the secondary screen will change the
1052scrollback buffer and, when secondaryScreen is off, switching 1079scrollback buffer and, when secondaryScreen is off, switching
1079 1106
1080The key combination that triggers the action, I<sym>, has the following format: 1107The key combination that triggers the action, I<sym>, has the following format:
1081 1108
1082 (modifiers-)key 1109 (modifiers-)key
1083 1110
1084Where I<modifiers> can be any combination of B<ISOLevel3>, B<AppKeypad>, 1111Where I<modifiers> can be any combination of the following full or
1085B<Control>, B<NumLock>, B<Shift>, B<Meta>, B<Lock>, B<Mod1>, B<Mod2>, 1112abbreviated modifier names:
1086B<Mod3>, B<Mod4>, B<Mod5>, and the abbreviated B<I>, B<K>, B<C>, B<N>, 1113
1087B<S>, B<M>, B<A>, B<L>, B<1>, B<2>, B<3>, B<4>, B<5>. 1114=begin table
1115
1116 B<ISOLevel3> B<I>
1117 B<AppKeypad> B<K>
1118 B<Control> B<C>
1119 B<NumLock> B<N>
1120 B<Shift> B<S>
1121 B<Meta> B<M> I<or> B<A>
1122 B<Lock> B<L>
1123 B<Mod1> B<1>
1124 B<Mod2> B<2>
1125 B<Mod3> B<3>
1126 B<Mod4> B<4>
1127 B<Mod5> B<5>
1128
1129=end table
1088 1130
1089The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to 1131The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to
1090whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr 1132whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr
1091keys are being mapped. B<AppKeypad> is a synthetic modifier mapped to the 1133keys are being mapped. B<AppKeypad> is a synthetic modifier mapped to the
1092current application keymap mode state. 1134current application keymap mode state.
1115prefixed with C<string:>). 1157prefixed with C<string:>).
1116 1158
1117The following action prefixes are known - extensions can provide 1159The following action prefixes are known - extensions can provide
1118additional prefixes: 1160additional prefixes:
1119 1161
1120=over 4 1162=over
1121 1163
1122=item string:STRING 1164=item string:STRING
1123 1165
1124If the I<action> starts with C<string:> (or otherwise contains no colons), 1166If the I<action> starts with C<string:> (or otherwise contains no colons),
1125then the remaining C<STRING> will be passed to the program running in the 1167then the remaining C<STRING> will be passed to the program running in the
1353=head1 THE SELECTION: SELECTING AND PASTING TEXT 1395=head1 THE SELECTION: SELECTING AND PASTING TEXT
1354 1396
1355The behaviour of text selection and insertion/pasting mechanism is similar 1397The behaviour of text selection and insertion/pasting mechanism is similar
1356to I<xterm>(1). 1398to I<xterm>(1).
1357 1399
1358=over 4 1400=over
1359 1401
1360=item B<Selecting>: 1402=item B<Selecting>:
1361 1403
1362Left click at the beginning of the region, drag to the end of the region 1404Left click at the beginning of the region, drag to the end of the region
1363and release; Right click to extend the marked region; Left double-click 1405and release; Right click to extend the marked region; Left double-click
1410and character codes using the keyboard. It consists of 4 parts. The 1452and character codes using the keyboard. It consists of 4 parts. The
1411first part is available if rxvt-unicode has been compiled with 1453first part is available if rxvt-unicode has been compiled with
1412C<--enable-frills>, the rest is available when rxvt-unicode was compiled 1454C<--enable-frills>, the rest is available when rxvt-unicode was compiled
1413with C<--enable-iso14755>. 1455with C<--enable-iso14755>.
1414 1456
1415=over 4 1457=over
1416 1458
1417=item * 5.1: Basic method 1459=item * 5.1: Basic method
1418 1460
1419This allows you to enter unicode characters using their hexcode. 1461This allows you to enter unicode characters using their hexcode.
1420 1462
1600 1642
1601=head1 ENVIRONMENT 1643=head1 ENVIRONMENT
1602 1644
1603B<@@RXVT_NAME@@> sets and/or uses the following environment variables: 1645B<@@RXVT_NAME@@> sets and/or uses the following environment variables:
1604 1646
1605=over 4 1647=over
1606 1648
1607=item B<TERM> 1649=item B<TERM>
1608 1650
1609Normally set to C<rxvt-unicode>, unless overwritten at configure time, via 1651Normally set to C<rxvt-unicode>, unless overwritten at configure time, via
1610resources or on the command line. 1652resources or on the command line.
1681 1723
1682=back 1724=back
1683 1725
1684=head1 FILES 1726=head1 FILES
1685 1727
1686=over 4 1728=over
1687 1729
1688=item B</usr/lib/X11/rgb.txt> 1730=item B</usr/lib/X11/rgb.txt>
1689 1731
1690Colour names. 1732Colour names.
1691 1733
1696@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@-extensions(1), 1738@@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) 1739@@RXVT_NAME@@perl(3), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
1698 1740
1699=head1 CURRENT PROJECT COORDINATOR 1741=head1 CURRENT PROJECT COORDINATOR
1700 1742
1701=over 4 1743=over
1702 1744
1703=item Project Coordinator 1745=item Project Coordinator
1704 1746
1705Marc A. Lehmann <rxvt-unicode@schmorp.de>. 1747Marc A. Lehmann <rxvt-unicode@schmorp.de>.
1706 1748
1708 1750
1709=back 1751=back
1710 1752
1711=head1 AUTHORS 1753=head1 AUTHORS
1712 1754
1713=over 4 1755=over
1714 1756
1715=item John Bovey 1757=item John Bovey
1716 1758
1717University of Kent, 1992, wrote the original Xvt. 1759University of Kent, 1992, wrote the original Xvt.
1718 1760

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines