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.97 by root, Mon Jan 16 15:07:27 2006 UTC vs.
Revision 1.109 by root, Sun Jan 29 22:27:04 2006 UTC

93 93
94Attempt to open a window on the named X display (B<-d> still 94Attempt to open a window on the named X display (B<-d> still
95respected). In the absence of this option, the display specified by the 95respected). In the absence of this option, the display specified by the
96B<DISPLAY> environment variable is used. 96B<DISPLAY> environment variable is used.
97 97
98=item B<-depth> I<bitdepth>
99
100Compile I<xft>: Attempt to find a visual with the given bit depth;
101resource B<depth>.
102
98=item B<-geometry> I<geom> 103=item B<-geometry> I<geom>
99 104
100Window geometry (B<-g> still respected); resource B<geometry>. 105Window geometry (B<-g> still respected); resource B<geometry>.
101 106
102=item B<-rv>|B<+rv> 107=item B<-rv>|B<+rv>
296=item B<-bl> 301=item B<-bl>
297 302
298Compile I<frills>: Set MWM hints to request a borderless window, i.e. 303Compile I<frills>: Set MWM hints to request a borderless window, i.e.
299if honoured by the WM, the rxvt-unicode window will not have window 304if honoured by the WM, the rxvt-unicode window will not have window
300decorations; resource B<borderLess>. 305decorations; resource B<borderLess>.
306
307=item B<-override-redirect>
308
309Compile I<frills>: Sets override-redirect on the window; resource
310B<override-redirect>.
301 311
302=item B<-sbg> 312=item B<-sbg>
303 313
304Compile I<frills>: Disable the usage of the built-in block graphics/line 314Compile I<frills>: Disable the usage of the built-in block graphics/line
305drawing characters and just rely on what the specified fonts provide. Use 315drawing characters and just rely on what the specified fonts provide. Use
500check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl 510check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
501extensions not documented here): 511extensions not documented here):
502 512
503=over 4 513=over 4
504 514
515=item B<depth:> I<bitdepth>
516
517Compile I<xft>: Attempt to find a visual with the given bit depth;
518option B<-depth>.
519
505=item B<geometry:> I<geom> 520=item B<geometry:> I<geom>
506 521
507Create the window with the specified X window geometry [default 80x24]; 522Create the window with the specified X window geometry [default 80x24];
508option B<-geometry>. 523option B<-geometry>.
509 524
891pressed. If unset it will send the sequence traditionally associated 906pressed. If unset it will send the sequence traditionally associated
892with the B<Execute> key. 907with the B<Execute> key.
893 908
894=item B<cutchars:> I<string> 909=item B<cutchars:> I<string>
895 910
896The characters used as delimiters for double-click word selection. The 911The characters used as delimiters for double-click word selection
897built-in default: 912(whitespace delimiting is added automatically if resource is given).
913
914When the selection extension is in use (the default if compiled in, see
915the @@RXVT_NAME@@perl(3) manpage), a suitable regex using these characters
916will be created (if the resource exists, otherwise, no regex will be
917created). In this mode, characters outside ISO-8859-1 can be used.
918
919When the selection extension is not used, only ISO-8859-1 characters can
920be used. If not specified, the built-in default is used:
898 921
899B<< BACKSLASH `"'&()*,;<=>?@[]{|} >> 922B<< BACKSLASH `"'&()*,;<=>?@[]{|} >>
900 923
901=item B<preeditType:> I<style> 924=item B<preeditType:> I<style>
902 925
952 975
953Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E) 976Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
954character is passed through. It may contain escape values as described 977character is passed through. It may contain escape values as described
955in the entry on B<keysym> following. 978in the entry on B<keysym> following.
956 979
957=item B<secondaryScreen:> I<bool> 980=item B<secondaryScreen:> I<boolean>
958 981
959Turn on/off secondary screen (default enabled). 982Turn on/off secondary screen (default enabled).
960 983
961=item B<secondaryScroll:> I<bool> 984=item B<secondaryScroll:> I<boolean>
962 985
963Turn on/off secondary screen scroll (default enabled). If the this 986Turn on/off secondary screen scroll (default enabled). If the this
964option is enabled, scrolls on the secondary screen will change the 987option is enabled, scrolls on the secondary screen will change the
965scrollback buffer and switching to/from the secondary screen will 988scrollback buffer and switching to/from the secondary screen will
966instead scroll the screen up. 989instead scroll the screen up.
967 990
968=item B<hold>: I<bool> 991=item B<hold>: I<boolean>
969 992
970Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ 993Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
971will not immediately destroy its window when the program executed within 994will not immediately destroy its window when the program executed within
972it exits. Instead, it will wait till it is being killed or closed by the 995it exits. Instead, it will wait till it is being killed or closed by the
973user. 996user.
1128Specifies the program to be started with a URL argument. Used by the 1151Specifies the program to be started with a URL argument. Used by the
1129C<selection-popup> and C<mark-urls> perl extensions. 1152C<selection-popup> and C<mark-urls> perl extensions.
1130 1153
1131=item B<transient-for>: I<windowid> 1154=item B<transient-for>: I<windowid>
1132 1155
1133Sets the WM_TRANSIENT_FOR property to the given window iw. 1156Compile I<frills>: Sets the WM_TRANSIENT_FOR property to the given window id.
1157
1158=item B<override-redirect>: I<boolean>
1159
1160Compile I<frills>: Sets override-redirect for the terminal window, making
1161it almost invisible to window managers; option B<-override-redirect>.
1134 1162
1135=back 1163=back
1136 1164
1137=head1 THE SCROLLBAR 1165=head1 THE SCROLLBAR
1138 1166
1180selection, and trailing whitespace is visually underlined and removed from 1208selection, and trailing whitespace is visually underlined and removed from
1181the selection. 1209the selection.
1182 1210
1183=item B<Insertion>: 1211=item B<Insertion>:
1184 1212
1185Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in 1213Pressing and releasing the Middle mouse button in an B<@@RXVT_NAME@@>
1186an B<@@RXVT_NAME@@> window causes the current text selection to be 1214window causes the value of the PRIMARY selection (or CLIPBOARD with the
1187inserted as if it had been typed on the keyboard. 1215Meta modifier) to be inserted as if it had been typed on the keyboard.
1216
1217Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be
1218inserted too.
1188 1219
1189=back 1220=back
1190 1221
1191=head1 CHANGING FONTS 1222=head1 CHANGING FONTS
1192 1223
1279=head1 COLORS AND GRAPHICS 1310=head1 COLORS AND GRAPHICS
1280 1311
1281In addition to the default foreground and background colours, 1312In addition to the default foreground and background colours,
1282B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus 1313B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus
1283high-intensity bold/blink versions of the same). Here is a list of the 1314high-intensity bold/blink versions of the same). Here is a list of the
1284colours with their B<rgb.txt> names. 1315colours with their names.
1285 1316
1286=begin table 1317=begin table
1287 1318
1288 B<color0> (black) = Black 1319 B<color0> (black) = Black
1289 B<color1> (red) = Red3 1320 B<color1> (red) = Red3
1309It is also possible to specify the colour values of B<foreground>, 1340It is also possible to specify the colour values of B<foreground>,
1310B<background>, B<cursorColor>, B<cursorColor2>, B<colorBD>, B<colorUL> as 1341B<background>, B<cursorColor>, B<cursorColor2>, B<colorBD>, B<colorUL> as
1311a number 0-15, as a convenient shorthand to reference the colour name of 1342a number 0-15, as a convenient shorthand to reference the colour name of
1312color0-color15. 1343color0-color15.
1313 1344
1345If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1346their act together, rxvt-unicode will support C<rgba:rrrr/gggg/bbbb/aaaa>
1347(recommended, but B<MUST> have 4 digits/component), C<#ARGB>, C<#AARRGGBB>
1348and C<#AAAARRRRGGGGBBBB> colour specifications, in addition to the ones
1349provided by X, where the additional A component specifies alpha (opacity)
1350values (0 is completely transparent and the maximum is opaque). You
1351probably need to specify B<"-depth 32">, too, and have the luck that your
1352X-server uses ARGB pixel layout, as X is far from just supporting ARGB
1353visuals out of the box, and rxvt-unicode just fudges around.
1354
1314Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by 1355Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by
1315always swapping the foreground/background colours. This is in contrast to 1356always swapping the foreground/background colours. This is in contrast to
1316I<xterm>(1) where the colours are only swapped if they have not otherwise 1357I<xterm>(1) where the colours are only swapped if they have not otherwise
1317been specified. For example, 1358been specified. For example,
1318 1359
1370 1411
1371=item B<SHELL> 1412=item B<SHELL>
1372 1413
1373The shell to be used for command execution, defaults to C</bin/sh>. 1414The shell to be used for command execution, defaults to C</bin/sh>.
1374 1415
1375=item B<RXVTPATH>
1376
1377The path where @@RXVT_NAME@@ looks for support files such as menu and xpm
1378files.
1379
1380=item B<PATH>
1381
1382Used in the same way as C<RXVTPATH>.
1383
1384=item B<RXVT_SOCKET> 1416=item B<RXVT_SOCKET>
1385 1417
1386The unix domain socket path used by @@RXVT_NAME@@c(1) and 1418The unix domain socket path used by @@RXVT_NAME@@c(1) and
1387@@RXVT_NAME@@d(1). 1419@@RXVT_NAME@@d(1).
1388 1420
1457 1489
1458Project Coordinator (changes.txt 2.21a to 2.4.5) 1490Project Coordinator (changes.txt 2.21a to 2.4.5)
1459 1491
1460=item Geoff Wing L<< <gcw@pobox.com> >> 1492=item Geoff Wing L<< <gcw@pobox.com> >>
1461 1493
1462Rewrote screen display and text selection routines. Project Coordinator 1494Rewrote screen display and text selection routines.
1495
1463(changes.txt 2.4.6 - rxvt-unicode) 1496Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)
1464 1497
1465=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >> 1498=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >>
1466 1499
1467Forked rxvt-unicode, rewrote most of the display code and internal 1500Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1468character handling to store text in unicode, improve xterm 1501extension, random hacks, numerous bugfixes and extensions.
1469compatibility and apply numerous other bugfixes and extensions.
1470 1502
1471Project Coordinator (Changes 1.0 -) 1503Project Coordinator (Changes 1.0 -)
1472 1504
1505=item Emanuele Giaquinta L<< <e.giaquinta@glauco.it> >>
1506
1507Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing.
1508
1473=back 1509=back
1474 1510

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines