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.1 by root, Thu Aug 12 20:42:12 2004 UTC vs.
Revision 1.4 by root, Fri Aug 13 03:47:09 2004 UTC

… …
2 2
3rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system) 3rxvt-unicode (ouR XVT, unicode) - (a VT102 emulator for the X window system)
4 4
5=head1 SYNOPSIS 5=head1 SYNOPSIS
6 6
7B<@@RXVTNAME@@> [options] [-e command [ args ]] 7B<@@RXVT_NAME@@> [options] [-e command [ args ]]
8 8
9=head1 DESCRIPTION 9=head1 DESCRIPTION
10 10
11B<rxvt-unicode>, version B<@@RXVTVERSION@@>, is a colour vt102 terminal 11B<rxvt-unicode>, version B<@@RXVT_VERSION@@>, is a colour vt102 terminal
12emulator intended as an I<xterm>(1) replacement for users who do not 12emulator intended as an I<xterm>(1) replacement for users who do not
13require features such as Tektronix 4014 emulation and toolkit-style 13require features such as Tektronix 4014 emulation and toolkit-style
14configurability. As a result, B<rxvt-unicode> uses much less swap space -- 14configurability. As a result, B<rxvt-unicode> uses much less swap space --
15a significant advantage on a machine serving many X sessions. 15a significant advantage on a machine serving many X sessions.
16 16
17See also @@RXVT_NAME@@(7) for technical reference documentation (escape
18sequences etc.) and the FAQ section at the end of this document.
19
17=head1 OPTIONS 20=head1 OPTIONS
18 21
19The B<@@RXVTNAME@@> options (mostly a subset of I<xterm>'s) are listed 22The B<@@RXVT_NAME@@> options (mostly a subset of I<xterm>'s) are listed
20below. In keeping with the smaller-is-better philosophy, options may be 23below. In keeping with the smaller-is-better philosophy, options may be
21eliminated or default values chosen at compile-time, so options and 24eliminated or default values chosen at compile-time, so options and
22defaults listed may not accurately reflect the version installed on 25defaults listed may not accurately reflect the version installed on
23your system. `rxvt -h' gives a list of major compile-time options on 26your system. `@@RXVT_NAME@@ -h' gives a list of major compile-time options on
24the I<Options> line. Option descriptions may be prefixed with which 27the I<Options> line. Option descriptions may be prefixed with which
25compile option each is dependent upon. e.g. `Compile I<XIM>:' requires 28compile option each is dependent upon. e.g. `Compile I<XIM>:' requires
26I<XIM> on the I<Options> line. Note: `rxvt -help' gives a list of all 29I<XIM> on the I<Options> line. Note: `@@RXVT_NAME@@ -help' gives a list of all
27command-line options compiled into your version. 30command-line options compiled into your version.
28 31
29Note that B<@@RXVTNAME@@> permits the resource name to be used as a 32Note that B<@@RXVT_NAME@@> permits the resource name to be used as a
30long-option (--/++ option) so the potential command-line options are 33long-option (--/++ option) so the potential command-line options are
31far greater than those listed. For example: `rxvt --loginShell --color1 34far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1
32Orange'. 35Orange'.
33 36
34The following options are available: 37The following options are available:
35 38
36=over 4 39=over 4
… …
202B<externalBorder>. 205B<externalBorder>.
203 206
204=item B<-bl> 207=item B<-bl>
205 208
206Compile I<frills>: Set MWM hints to request a borderless window, i.e. 209Compile I<frills>: Set MWM hints to request a borderless window, i.e.
207if honoured by the WM, the rxvt window will not have window 210if honoured by the WM, the rxvt-unicode window will not have window
208decorations; resource B<borderLess>. 211decorations; resource B<borderLess>.
209 212
210=item B<-lsp> I<number> 213=item B<-lsp> I<number>
211 214
212Compile I<linespace>: Lines (pixel height) to insert between each row 215Compile I<linespace>: Lines (pixel height) to insert between each row
… …
219I<termcap(5)> database and should have I<li#> and I<co#> entries; 222I<termcap(5)> database and should have I<li#> and I<co#> entries;
220resource B<termName>. 223resource B<termName>.
221 224
222=item B<-e> I<command [arguments]> 225=item B<-e> I<command [arguments]>
223 226
224Run the command with its command-line arguments in the B<@@RXVTNAME@@> 227Run the command with its command-line arguments in the B<@@RXVT_NAME@@>
225window; also sets the window title and icon name to be the basename of 228window; also sets the window title and icon name to be the basename of
226the program being executed if neither I<-title> (I<-T>) nor I<-n> are 229the program being executed if neither I<-title> (I<-T>) nor I<-n> are
227given on the command line. If this option is used, it must be the last 230given on the command line. If this option is used, it must be the last
228on the command-line. If there is no B<-e> option then the default is to 231on the command-line. If there is no B<-e> option then the default is to
229run the program specified by the B<SHELL> environment variable or, 232run the program specified by the B<SHELL> environment variable or,
… …
283Turn on/off secondary screen scroll (default enabled); resource 286Turn on/off secondary screen scroll (default enabled); resource
284B<secondaryScroll>. 287B<secondaryScroll>.
285 288
286=item B<-xrm> I<resourcestring> 289=item B<-xrm> I<resourcestring>
287 290
288No effect on rxvt. Simply passes through an argument to be made 291No effect on rxvt-unicode. Simply passes through an argument to be made
289available in the instance's argument list. Appears in I<WM_COMMAND> in 292available in the instance's argument list. Appears in I<WM_COMMAND> in
290some window managers. 293some window managers.
291 294
292=back 295=back
293 296
294=head1 RESOURCES (available also as long-options) 297=head1 RESOURCES (available also as long-options)
295 298
296Note: `@@RXVTNAME@@ --help' gives a list of all resources (long 299Note: `@@RXVT_NAME@@ --help' gives a list of all resources (long
297options) compiled into your version. 300options) compiled into your version.
298 301
299There are two different methods that @@RXVTNAME@@ can use to get the 302There are two different methods that @@RXVT_NAME@@ can use to get the
300Xresource data: using the X libraries (Xrm*-functions) or internal 303Xresource data: using the X libraries (Xrm*-functions) or internal
301Xresources reader (B<~/.Xdefaults>). For the first method (ie. 304Xresources reader (B<~/.Xdefaults>). For the first method (ie.
302B<@@RXVTNAME@@ -h> lists B<XGetDefaults>), you can set and change the 305B<@@RXVT_NAME@@ -h> lists B<XGetDefaults>), you can set and change the
303resources using X11 tools like B<xset>. Many distribution do also load 306resources using X11 tools like B<xset>. Many distribution do also load
304settings from the B<~/.Xresources> file when X starts. 307settings from the B<~/.Xresources> file when X starts.
305 308
306If compiled with internal Xresources support (i.e. B<@@RXVTNAME@@ -h> 309If compiled with internal Xresources support (i.e. B<@@RXVT_NAME@@ -h>
307lists B<.Xdefaults>) then B<@@RXVTNAME@@> accepts application defaults 310lists B<.Xdefaults>) then B<@@RXVT_NAME@@> accepts application defaults
308set in XAPPLOADDIR/URxvt (compile-time defined: usually 311set in XAPPLOADDIR/URxvt (compile-time defined: usually
309B</usr/lib/X11/app-defaults/URxvt>) and resources set in 312B</usr/lib/X11/app-defaults/URxvt>) and resources set in
310B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist. 313B<~/.Xdefaults>, or B<~/.Xresources> if B<~/.Xdefaults> does not exist.
311Note that when reading X resources, B<@@RXVTNAME@@> recognizes two 314Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two
312class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows 315class names: B<XTerm> and B<URxvt>. The class name B<Rxvt> allows
313resources common to both B<@@RXVTNAME@@> and the original I<rxvt> to be 316resources common to both B<@@RXVT_NAME@@> and the original I<rxvt> to be
314easily configured, while the class name B<URxvt> allows resources 317easily configured, while the class name B<URxvt> allows resources
315unique to B<@@RXVTNAME@@>, notably colours and key-handling, to be 318unique to B<@@RXVT_NAME@@>, notably colours and key-handling, to be
316shared between different B<@@RXVTNAME@@> configurations. If no 319shared between different B<@@RXVT_NAME@@> configurations. If no
317resources are specified, suitable defaults will be used. Command-line 320resources are specified, suitable defaults will be used. Command-line
318arguments can be used to override resource settings. The following 321arguments can be used to override resource settings. The following
319resources are allowed: 322resources are allowed:
320 323
321=over 4 324=over 4
… …
462xterm style with 2.20 old word selection, or anything else which gives 465xterm style with 2.20 old word selection, or anything else which gives
463xterm style selection. 466xterm style selection.
464 467
465=item B<scrollstyle:> I<mode> 468=item B<scrollstyle:> I<mode>
466 469
467Set scrollbar style to B<@@RXVTNAME@@>, B<rxvt>, B<plain>, B<next> or 470Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
468B<xterm> 471the author's favourite..
469 472
470=item B<title:> I<string> 473=item B<title:> I<string>
471 474
472Set window title string, the default title is the command-line 475Set window title string, the default title is the command-line
473specified after the B<-e> option, if any, otherwise the application 476specified after the B<-e> option, if any, otherwise the application
… …
527Align the B<top>, B<bottom> or B<centre> [default] of the scrollbar 530Align the B<top>, B<bottom> or B<centre> [default] of the scrollbar
528thumb with the pointer on middle button press/drag. 531thumb with the pointer on middle button press/drag.
529 532
530=item B<scrollTtyOutput:> I<boolean> 533=item B<scrollTtyOutput:> I<boolean>
531 534
532B<True>: scroll to bottom when tty receives output; option B<+si>. 535B<True>: scroll to bottom when tty receives output; option B<-si>.
533B<False>: do not scroll to bottom when tty receives output; option 536B<False>: do not scroll to bottom when tty receives output; option
534B<-si>. 537B<+si>.
535 538
536=item B<scrollWithBuffer:> I<boolean> 539=item B<scrollWithBuffer:> I<boolean>
537 540
538B<True>: scroll with scrollback buffer when tty recieves new lines (and 541B<True>: scroll with scrollback buffer when tty recieves new lines (and
539B<scrollTtyOutput> is False); option B<+sw>. B<False>: do not scroll 542B<scrollTtyOutput> is False); option B<+sw>. B<False>: do not scroll
540with scrollback buffer when tty recieves new lines; option B<-sw>. 543with scrollback buffer when tty recieves new lines; option B<-sw>.
541 544
542=item B<scrollTtyKeypress:> I<boolean> 545=item B<scrollTtyKeypress:> I<boolean>
543 546
544B<True>: scroll to bottom when a non-special key is pressed. Special 547B<True>: scroll to bottom when a non-special key is pressed. Special keys
545keys are those which are intercepted by rxvt for special handling and 548are those which are intercepted by rxvt-unicode for special handling and
546are not passed onto the shell; option B<-sk>. B<False>: do not scroll 549are not passed onto the shell; option B<-sk>. B<False>: do not scroll to
547to bottom when a non-special key is pressed; option B<+sk>. 550bottom when a non-special key is pressed; option B<+sk>.
548 551
549=item B<smallfont_key:> I<keysym> 552=item B<smallfont_key:> I<keysym>
550 553
551If enabled, use B<@@HOTKEY@@->I<keysym> to toggle to a smaller font 554If enabled, use B<@@HOTKEY@@->I<keysym> to toggle to a smaller font
552[default B<@@HOTKEY@@-@@SMALLFONT@@>] 555[default B<@@HOTKEY@@-@@SMALLFONT@@>]
… …
572option B<-w>, B<-bw>, B<-borderwidth>. 575option B<-w>, B<-bw>, B<-borderwidth>.
573 576
574=item B<borderLess:> I<boolean> 577=item B<borderLess:> I<boolean>
575 578
576Set MWM hints to request a borderless window, i.e. if honoured by the 579Set MWM hints to request a borderless window, i.e. if honoured by the
577WM, the rxvt window will not have window decorations; option B<-bl>. 580WM, the rxvt-unicode window will not have window decorations; option B<-bl>.
578 581
579=item B<termName:> I<termname> 582=item B<termName:> I<termname>
580 583
581Specifies the terminal type name to be set in the B<TERM> environment 584Specifies the terminal type name to be set in the B<TERM> environment
582variable; option B<-tn>. 585variable; option B<-tn>.
… …
673B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option 676B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option
674B<-mod>. 677B<-mod>.
675 678
676=item B<answerbackString:> I<string> 679=item B<answerbackString:> I<string>
677 680
678Specify the reply rxvt sends to the shell when an ENQ (control-E) 681Specify the reply rxvt-unicode sends to the shell when an ENQ (control-E)
679character is passed through. It may contain escape values as described 682character is passed through. It may contain escape values as described
680in the entry on B<keysym> following. 683in the entry on B<keysym> following.
681 684
682=item B<secondaryScreen:> I<bool> 685=item B<secondaryScreen:> I<bool>
683 686
… …
703 706
704=back 707=back
705 708
706=head1 THE SCROLLBAR 709=head1 THE SCROLLBAR
707 710
708Lines of text that scroll off the top of the B<@@RXVTNAME@@> window 711Lines 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 712(resource: B<saveLines>) and can be scrolled back using the scrollbar
710or by keystrokes. The normal B<@@RXVTNAME@@> scrollbar has arrows and 713or by keystrokes. The normal B<@@RXVT_NAME@@> scrollbar has arrows and
711its behaviour is fairly intuitive. The B<xterm-scrollbar> is without 714its behaviour is fairly intuitive. The B<xterm-scrollbar> is without
712arrows and its behaviour mimics that of I<xterm> 715arrows and its behaviour mimics that of I<xterm>
713 716
714Scroll down with B<Button1> (B<xterm-scrollbar>) or B<Shift-Next>. 717Scroll down with B<Button1> (B<xterm-scrollbar>) or B<Shift-Next>.
715Scroll up with B<Button3> (B<xterm-scrollbar>) or B<Shift-Prior>. 718Scroll up with B<Button3> (B<xterm-scrollbar>) or B<Shift-Prior>.
… …
743line. 746line.
744 747
745=item B<Insertion>: 748=item B<Insertion>:
746 749
747Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in 750Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in
748an B<@@RXVTNAME@@> window causes the current text selection to be 751an B<@@RXVT_NAME@@> window causes the current text selection to be
749inserted as if it had been typed on the keyboard. 752inserted as if it had been typed on the keyboard.
750 753
751=back 754=back
752 755
753=head1 CHANGING FONTS 756=head1 CHANGING FONTS
… …
757B<Shift-KP_Subtract>. Or, alternatively (if enabled) with 760B<Shift-KP_Subtract>. Or, alternatively (if enabled) with
758B<@@HOTKEY@@-@@BIGFONT@@> and B<@@HOTKEY@@-@@SMALLFONT@@>, where the 761B<@@HOTKEY@@-@@BIGFONT@@> and B<@@HOTKEY@@-@@SMALLFONT@@>, where the
759actual key can be selected using resources 762actual key can be selected using resources
760B<smallfont_key>/B<bigfont_key>. 763B<smallfont_key>/B<bigfont_key>.
761 764
765=head1 ISO 14755 SUPPORT
766
767Partial ISO 14755-support is implemented. that means that pressing
768
769Section 5.1: Control and Shift together enters unicode input
770mode. Entering hex digits composes a Unicode character, pressing space or
771releasing the modifiers commits the keycode and every other key cancels
772the current input character.
773
774Section 5.2: Pressing and immediately releasing Control and Shift together
775enters keycap entry mode for the next key: pressing a function key (tab,
776return etc..) will enter the unicode character corresponding to the given
777key.
778
762=head1 LOGIN STAMP 779=head1 LOGIN STAMP
763 780
764B<@@RXVTNAME@@> tries to write an entry into the I<utmp>(5) file so 781B<@@RXVT_NAME@@> tries to write an entry into the I<utmp>(5) file so
765that it can be seen via the I<who(1)> command, and can accept messages. 782that it can be seen via the I<who(1)> command, and can accept messages.
766To allow this feature, B<@@RXVTNAME@@> must be installed setuid root on 783To allow this feature, B<@@RXVT_NAME@@> must be installed setuid root on
767some systems. 784some systems.
768 785
769=head1 COLORS AND GRAPHICS 786=head1 COLORS AND GRAPHICS
770 787
771In addition to the default foreground and background colours, 788In addition to the default foreground and background colours,
772B<@@RXVTNAME@@> can display up to 16 colours (8 ANSI colours plus 789B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus
773high-intensity bold/blink versions of the same). Here is a list of the 790high-intensity bold/blink versions of the same). Here is a list of the
774colours with their B<rgb.txt> names. 791colours with their B<rgb.txt> names.
775 792
776=begin table 793=begin table
777 794
… …
806I<xterm>(1) where the colours are only swapped if they have not otherwise 823I<xterm>(1) where the colours are only swapped if they have not otherwise
807been specified. For example, 824been specified. For example,
808 825
809=over 4 826=over 4
810 827
811=item B<rxvt -fg Black -bg White -rv> 828=item B<@@RXVT_NAME@@ -fg Black -bg White -rv>
812 829
813would yield White on Black, while on I<xterm>(1) it would yield Black 830would yield White on Black, while on I<xterm>(1) it would yield Black
814on White. 831on White.
815 832
816=back 833=back
817 834
818=head1 ENVIRONMENT 835=head1 ENVIRONMENT
819 836
820B<@@RXVTNAME@@> sets the environment variables B<TERM>, B<COLORTERM> 837B<@@RXVT_NAME@@> sets the environment variables B<TERM>, B<COLORTERM>
821and B<COLORFGBG>. The environment variable B<WINDOWID> is set to the X 838and B<COLORFGBG>. The environment variable B<WINDOWID> is set to the X
822window id number of the B<@@RXVTNAME@@> window and it also uses and 839window id number of the B<@@RXVT_NAME@@> window and it also uses and
823sets the environment variable B<DISPLAY> to specify which display 840sets the environment variable B<DISPLAY> to specify which display
824terminal to use. B<@@RXVTNAME@@> uses the environment variables 841terminal to use. B<@@RXVT_NAME@@> uses the environment variables
825B<RXVTPATH> and B<PATH> to find XPM files. 842B<RXVTPATH> and B<PATH> to find XPM files.
826 843
827=head1 FILES 844=head1 FILES
828 845
829=over 4 846=over 4
… …
836 853
837Color names. 854Color names.
838 855
839=back 856=back
840 857
858=head1 FREQUENTLY ASKED QUESTIONS (FAQ)
859
860=over 4
861
862=item How do I know which rxvt-unicode version I'm using?
863
864The version number is displayed with the usage (-h). For rxvt-unicode
865version 2.14 and later, the escape sequence C<ESC[8n> sets the window
866title to the version number.
867
868=item Mouse cut/paste suddenly no longer works.
869
870Make sure that mouse reporting is actually turned off since killing
871some editors prematurely may leave the mouse in mouse report mode. I've
872heard that tcsh may use mouse reporting unless it otherwise specified. A
873quick check is to see if cut/paste works when the Alt or Shift keys are
874depressed. See @@RXVT_NAME@@(7)
875
876=item What's with this bold/blink stuff?
877
878If no bold colour is set via C<colorBD:>, bold will invert text using the
879standard foreground colour.
880
881For the standard background colour, blinking will actually make the
882text blink when compiled with C<--enable-blinking>. with standard
883colours. Without C<--enable-blinking>, the blink attribute will be
884ignored.
885
886On ANSI colours, bold/blink attributes are used to set high-intensity
887foreground/background colors.
888
889color0-7 are the low-intensity colors.
890
891color8-15 are the corresponding high-intensity colors.
892
893=item I don't like the screen colors. How do I change them?
894
895You can change the screen colors at run-time using F<~/.Xdefaults>
896resources (or as long-options).
897
898Here are values that are supposed to resemble a VGA screen,
899including the murky brown that passes for low-intensity yellow:
900
901 Rxvt*color0: #000000
902 Rxvt*color1: #A80000
903 Rxvt*color2: #00A800
904 Rxvt*color3: #A8A800
905 Rxvt*color4: #0000A8
906 Rxvt*color5: #A800A8
907 Rxvt*color6: #00A8A8
908 Rxvt*color7: #A8A8A8
909
910 Rxvt*color8: #000054
911 Rxvt*color9: #FF0054
912 Rxvt*color10: #00FF54
913 Rxvt*color11: #FFFF54
914 Rxvt*color12: #0000FF
915 Rxvt*color13: #FF00FF
916 Rxvt*color14: #00FFFF
917 Rxvt*color15: #FFFFFF
918
919=item What's with the strange Backspace/Delete key behaviour?
920
921Assuming that the physical Backspace key corresponds to the
922BackSpace keysym (not likely for Linux ... see the following
923question) there are two standard values that can be used for
924Backspace: C<^H> and C<^?>.
925
926Historically, either value is correct, but rxvt-unicode adopts the debian
927policy of using C<^?> when unsure, because it's the one only only correct
928choice :).
929
930Rxvt-unicode tries to inherit the current stty settings and uses the value
931of `erase' to guess the value for backspace. If rxvt-unicode wasn't
932started from a terminal (say, from a menu or by remote shell), then the
933system value of `erase', which corresponds to CERASE in <termios.h>, will
934be used (which may not be the same as your stty setting).
935
936For starting a new rxvt-unicode:
937
938 # use Backspace = ^H
939 $ stty erase ^H
940 $ @@RXVT_NAME@@
941
942 # use Backspace = ^?
943 $ stty erase ^?
944 $ @@RXVT_NAME@@
945
946Toggle with "ESC[36h" / "ESC[36l" as documented in @@RXVT_NAME@@(7).
947
948For an existing rxvt-unicode:
949
950 # use Backspace = ^H
951 $ stty erase ^H
952 $ echo -n "^[[36h"
953
954 # use Backspace = ^?
955 $ stty erase ^?
956 $ echo -n "^[[36l"
957
958This helps satisfy some of the Backspace discrepancies that occur, but
959if you use Backspace = C<^H>, make sure that the termcap/terminfo value
960properly reflects that.
961
962The Delete key is a another casualty of the ill-defined Backspace problem.
963To avoid confusion between the Backspace and Delete keys, the Delete
964key has been assigned an escape sequence to match the vt100 for Execute
965(ESC[3~) and is in the supplied termcap/terminfo.
966
967Some other Backspace problems:
968
969some editors use termcap/terminfo,
970some editors (vim I'm told) expect Backspace = ^H,
971GNU Emacs (and Emacs-like editors) use ^H for help.
972
973Perhaps someday this will all be resolved in a consistent manner.
974
975=item I don't like the key-bindings. How do I change them?
976
977There are some compile-time selections available via configure. Unless
978you have run "configure" with the C<--disable-resources> option you can
979use the `keysym' resource to alter the keystrings associated with keysym
9800xFF00 - 0xFFFF (function, cursor keys, etc).
981
982Here's an example for a tn3270 session started using `@@RXVT_NAME@@ -name tn3270'
983
984 !# ----- special uses ------:
985 ! tn3270 login, remap function and arrow keys.
986 tn3270*font: *clean-bold-*-*--15-*
987
988 ! keysym - used by rxvt only
989 ! Delete - ^D
990 tn3270*keysym.0xFFFF: \004
991
992 ! Home - ^A
993 tn3270*keysym.0xFF50: \001
994 ! Left - ^B
995 tn3270*keysym.0xFF51: \002
996 ! Up - ^P
997 tn3270*keysym.0xFF52: \020
998 ! Right - ^F
999 tn3270*keysym.0xFF53: \006
1000 ! Down - ^N
1001 tn3270*keysym.0xFF54: \016
1002 ! End - ^E
1003 tn3270*keysym.0xFF57: \005
1004
1005 ! F1 - F12
1006 tn3270*keysym.0xFFBE: \e1
1007 tn3270*keysym.0xFFBF: \e2
1008 tn3270*keysym.0xFFC0: \e3
1009 tn3270*keysym.0xFFC1: \e4
1010 tn3270*keysym.0xFFC2: \e5
1011 tn3270*keysym.0xFFC3: \e6
1012 tn3270*keysym.0xFFC4: \e7
1013 tn3270*keysym.0xFFC5: \e8
1014 tn3270*keysym.0xFFC6: \e9
1015 tn3270*keysym.0xFFC7: \e0
1016 tn3270*keysym.0xFFC8: \e-
1017 tn3270*keysym.0xFFC9: \e=
1018
1019 ! map Prior/Next to F7/F8
1020 tn3270*keysym.0xFF55: \e7
1021 tn3270*keysym.0xFF56: \e8
1022
1023=item I'm using keyboard model XXX that has extra Prior/Next/Insert keys.
1024How do I make use of them? For example, the Sun Keyboard type 4
1025has the following mappings that rxvt-unicode doesn't recognize.
1026
1027 KP_Insert == Insert
1028 F22 == Print
1029 F27 == Home
1030 F29 == Prior
1031 F33 == End
1032 F35 == Next
1033
1034Rather than have rxvt-unicode try to accomodate all the various possible keyboard
1035mappings, it is better to use `xmodmap' to remap the keys as required for
1036your particular machine.
1037
1038=item How do I distinguish if I'm running rxvt-unicode or a regular xterm?
1039I need this to decide about setting colors etc.
1040
1041rxvt and rxvt-unicode always export the variable "COLORTERM", so you can
1042check and see if that is set. Note that several programs, JED, slrn,
1043Midnight Commander automatically check this variable to decide whether or
1044not to use color.
1045
1046=item How do I set the correct, full IP address for the DISPLAY variable?
1047
1048If you've compiled rxvt-unicode with DISPLAY_IS_IP and ahve enabled
1049insecure mode then it is possible to use the following shell script
1050snippets to correctly set the display. If your version of rxvt-unicode
1051wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then
1052the COLORTERM variable can be used to distinguish rxvt-unicode from a
1053regular xterm.
1054
1055Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script
1056snippets:
1057
1058 # Bourne/Korn/POSIX family of shells:
1059 [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
1060 if [ ${TERM:-foo} = xterm ]; then
1061 stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
1062 echo -n '^[Z'
1063 read term_id
1064 stty icanon echo
1065 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
1066 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
1067 read DISPLAY # set it in our local shell
1068 fi
1069 fi
1070
1071=item How do I compile the manual pages for myself?
1072
1073You need to have a recent version of perl installed as F</usr/bin/perl>,
1074one that comes with F<pod2man>, F<pod2text> and F<pod2html>. Then go to
1075the doc subdirectory and enter C<make alldoc>.
1076
1077=back
1078
841=head1 SEEALSO 1079=head1 SEE ALSO
842 1080
843I<xterm>(1), I<sh>(1), I<resize>(1), I<X>(1), I<pty>(4), I<tty>(4), I<utmp>(5) 1081@@RXVT_NAME@@(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
844
845See rxvtRef.html rxvtRef.txt for detailed information on recognized escape sequences and menuBar syntax, etc.
846 1082
847=head1 BUGS 1083=head1 BUGS
848 1084
849Check the BUGS file for an up-to-date list. 1085Check the BUGS file for an up-to-date list.
850 1086
851Cursor change support is not yet implemented. 1087Cursor change support is not yet implemented.
852 1088
853Click-and-drag doesn't work with X11 mouse report overriding. 1089Click-and-drag doesn't work with X11 mouse report overriding.
854 1090
855=head1 FTP LOCATION
856
857rxvt-+@@RXVTVERSION@@.tar.gz can be found at the following ftp sites L<@@RXVTFTPSITE@@>(@@RXVTFTPSITE@@)
858
859=head1 CURRENT PROJECT COORDINATOR 1091=head1 CURRENT PROJECT COORDINATOR
860 1092
861=over 4 1093=over 4
862 1094
863=item Project Coordinator 1095=item Project Coordinator
864 1096
865@@RXVTMAINT@@ L<@@RXVTMAINTEMAIL@@> 1097@@RXVTMAINT@@ L<@@RXVT_MAINTEMAIL@@>
866 1098
867=item Web page maintainter 1099=item Web page maintainter
868 1100
869@@RXVTWEBMAINT@@ L<@@RXVTWEBMAINTEMAIL@@> 1101@@RXVTWEBMAINT@@ L<@@RXVT_WEBMAINTEMAIL@@>
870 1102
871L<@@RXVTWEBPAGE@@>(@@RXVTWEBPAGE@@) 1103L<@@RXVT_WEBPAGE@@>
872 1104
873=back 1105=back
874 1106
875=head1 AUTHORS 1107=head1 AUTHORS
876 1108

Diff Legend

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