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

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.114 by root, Tue Feb 21 00:59:59 2006 UTC vs.
Revision 1.135 by ayin, Sun Jun 24 23:30:17 2007 UTC

17 17
18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting 18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
19all escape sequences, and other background information. 19all escape sequences, and other background information.
20 20
21The newest version of this document is also available on the World Wide Web at 21The newest version of this document is also available on the World Wide Web at
22L<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>. 22L<http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html>.
23 23
24=head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 24=head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
25 25
26 26
27=head2 Meta, Features & Commandline Issues 27=head2 Meta, Features & Commandline Issues
73=head3 How can I start @@URXVT_NAME@@d in a race-free way? 73=head3 How can I start @@URXVT_NAME@@d in a race-free way?
74 74
75Try C<@@URXVT_NAME@@d -f -o>, which tells @@URXVT_NAME@@d to open the 75Try C<@@URXVT_NAME@@d -f -o>, which tells @@URXVT_NAME@@d to open the
76display, create the listening socket and then fork. 76display, create the listening socket and then fork.
77 77
78=head3 How can I start @@URXVT_NAME@@d automatically when I run URXVT_NAME@@c? 78=head3 How can I start @@URXVT_NAME@@d automatically when I run @@URXVT_NAME@@c?
79 79
80If you want to start @@URXVT_NAME@@d automatically whenever you run 80If you want to start @@URXVT_NAME@@d automatically whenever you run
81@@URXVT_NAME@@c and the daemon isn't running yet, use this script: 81@@URXVT_NAME@@c and the daemon isn't running yet, use this script:
82 82
83 #!/bin/sh 83 #!/bin/sh
90This tries to create a new terminal, and if fails with exit status 2, 90This tries to create a new terminal, and if fails with exit status 2,
91meaning it couldn't connect to the daemon, it will start the daemon and 91meaning it couldn't connect to the daemon, it will start the daemon and
92re-run the command. Subsequent invocations of the script will re-use the 92re-run the command. Subsequent invocations of the script will re-use the
93existing daemon. 93existing daemon.
94 94
95=head3 How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc. 95=head3 How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.
96 96
97The original rxvt and rxvt-unicode always export the variable "COLORTERM", 97The original rxvt and rxvt-unicode always export the variable "COLORTERM",
98so you can check and see if that is set. Note that several programs, JED, 98so you can check and see if that is set. Note that several programs, JED,
99slrn, Midnight Commander automatically check this variable to decide 99slrn, Midnight Commander automatically check this variable to decide
100whether or not to use color. 100whether or not to use color.
125 fi 125 fi
126 126
127=head3 How do I compile the manual pages on my own? 127=head3 How do I compile the manual pages on my own?
128 128
129You need to have a recent version of perl installed as F</usr/bin/perl>, 129You need to have a recent version of perl installed as F</usr/bin/perl>,
130one that comes with F<pod2man>, F<pod2text> and F<pod2html>. Then go to 130one that comes with F<pod2man>, F<pod2text> and F<pod2xhtml> (from
131the doc subdirectory and enter C<make alldoc>. 131F<Pod::Xhtml>). Then go to the doc subdirectory and enter C<make alldoc>.
132 132
133=head3 Isn't rxvt-unicode supposed to be small? Don't all those features bloat? 133=head3 Isn't rxvt-unicode supposed to be small? Don't all those features bloat?
134 134
135I often get asked about this, and I think, no, they didn't cause extra 135I often get asked about this, and I think, no, they didn't cause extra
136bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 136bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
144 98398 1664 24 15695 1824 rxvt --disable-everything 144 98398 1664 24 15695 1824 rxvt --disable-everything
145 188985 9048 66616 18222 1788 urxvt --disable-everything 145 188985 9048 66616 18222 1788 urxvt --disable-everything
146 146
147When you C<--enable-everything> (which I<is> unfair, as this involves xft 147When you C<--enable-everything> (which I<is> unfair, as this involves xft
148and full locale/XIM support which are quite bloaty inside libX11 and my 148and full locale/XIM support which are quite bloaty inside libX11 and my
149libc), the two diverge, but not unreasnobaly so. 149libc), the two diverge, but not unreasonably so.
150 150
151 text data bss drs rss filename 151 text data bss drs rss filename
152 163431 2152 24 20123 2060 rxvt --enable-everything 152 163431 2152 24 20123 2060 rxvt --enable-everything
153 1035683 49680 66648 29096 3680 urxvt --enable-everything 153 1035683 49680 66648 29096 3680 urxvt --enable-everything
154 154
241 241
242 @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 242 @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
243 243
244This requires XFT support, and the support of your X-server. If that 244This requires XFT support, and the support of your X-server. If that
245doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't 245doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
246there yet, no matter what they claim. Rxvt-Unicode contains the neccessary 246there yet, no matter what they claim. Rxvt-Unicode contains the necessary
247bugfixes and workarounds for Xft and Xlib to make it work, but that 247bugfixes and workarounds for Xft and Xlib to make it work, but that
248doesn't mean that your WM has the required kludges in place. 248doesn't mean that your WM has the required kludges in place.
249 249
2504. Use xcompmgr and let it do the job: 2504. Use xcompmgr and let it do the job:
251 251
268however: Xft fonts often draw glyphs larger than their acclaimed bounding 268however: Xft fonts often draw glyphs larger than their acclaimed bounding
269box, and rxvt-unicode has no way of detecting this (the correct way is to 269box, and rxvt-unicode has no way of detecting this (the correct way is to
270ask for the character bounding box, which unfortunately is wrong in these 270ask for the character bounding box, which unfortunately is wrong in these
271cases). 271cases).
272 272
273It's not clear (to me at least), wether this is a bug in Xft, freetype, 273It's not clear (to me at least), whether this is a bug in Xft, freetype,
274or the respective font. If you encounter this problem you might try using 274or the respective font. If you encounter this problem you might try using
275the C<-lsp> option to give the font more height. If that doesn't work, you 275the C<-lsp> option to give the font more height. If that doesn't work, you
276might be forced to use a different font. 276might be forced to use a different font.
277 277
278All of this is not a problem when using X11 core fonts, as their bounding 278All of this is not a problem when using X11 core fonts, as their bounding
302=head3 Can I switch the fonts at runtime? 302=head3 Can I switch the fonts at runtime?
303 303
304Yes, using an escape sequence. Try something like this, which has the same 304Yes, using an escape sequence. Try something like this, which has the same
305effect as using the C<-fn> switch, and takes effect immediately: 305effect as using the C<-fn> switch, and takes effect immediately:
306 306
307 printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic" 307 printf '\33]50;%s\007' "9x15bold,xft:Kochi Gothic"
308 308
309This is useful if you e.g. work primarily with japanese (and prefer a 309This is useful if you e.g. work primarily with japanese (and prefer a
310japanese font), but you have to switch to chinese temporarily, where 310japanese font), but you have to switch to chinese temporarily, where
311japanese fonts would only be in your way. 311japanese fonts would only be in your way.
312 312
314 314
315=head3 Why do italic characters look as if clipped? 315=head3 Why do italic characters look as if clipped?
316 316
317Many fonts have difficulties with italic characters and hinting. For 317Many fonts have difficulties with italic characters and hinting. For
318example, the otherwise very nicely hinted font C<xft:Bitstream Vera Sans 318example, the otherwise very nicely hinted font C<xft:Bitstream Vera Sans
319Mono> completely fails in it's italic face. A workaround might be to 319Mono> completely fails in its italic face. A workaround might be to
320enable freetype autohinting, i.e. like this: 320enable freetype autohinting, i.e. like this:
321 321
322 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true 322 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
323 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true 323 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
324 324
330memory and also speeds up rendering considerably. 330memory and also speeds up rendering considerably.
331 331
332=head3 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? 332=head3 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
333 333
334Rxvt-unicode will use whatever you specify as a font. If it needs to 334Rxvt-unicode will use whatever you specify as a font. If it needs to
335fall back to it's default font search list it will prefer X11 core 335fall back to its default font search list it will prefer X11 core
336fonts, because they are small and fast, and then use Xft fonts. It has 336fonts, because they are small and fast, and then use Xft fonts. It has
337antialiasing disabled for most of them, because the author thinks they 337antialiasing disabled for most of them, because the author thinks they
338look best that way. 338look best that way.
339 339
340If you want antialiasing, you have to specify the fonts manually. 340If you want antialiasing, you have to specify the fonts manually.
512circumstances, it will move your cursor around when you click into the 512circumstances, it will move your cursor around when you click into the
513line that contains it. It tries hard not to do this at the wrong moment, 513line that contains it. It tries hard not to do this at the wrong moment,
514but when running a program that doesn't parse cursor movements or in some 514but when running a program that doesn't parse cursor movements or in some
515cases during rlogin sessions, it fails to detect this properly. 515cases during rlogin sessions, it fails to detect this properly.
516 516
517You can permamently switch this feature off by disabling the C<readline> 517You can permanently switch this feature off by disabling the C<readline>
518extension: 518extension:
519 519
520 URxvt.perl-ext-common: default,-readline 520 URxvt.perl-ext-common: default,-readline
521 521
522=head3 My numerical keypad acts weird and generates differing output? 522=head3 My numerical keypad acts weird and generates differing output?
523 523
524Some Debian GNUL/Linux users seem to have this problem, although no 524Some Debian GNUL/Linux users seem to have this problem, although no
525specific details were reported so far. It is possible that this is caused 525specific details were reported so far. It is possible that this is caused
526by the wrong C<TERM> setting, although the details of wether and how 526by the wrong C<TERM> setting, although the details of whether and how
527this can happen are unknown, as C<TERM=rxvt> should offer a compatible 527this can happen are unknown, as C<TERM=rxvt> should offer a compatible
528keymap. See the answer to the previous question, and please report if that 528keymap. See the answer to the previous question, and please report if that
529helped. 529helped.
530 530
531=head3 My Compose (Multi_key) key is no longer working. 531=head3 My Compose (Multi_key) key is no longer working.
557depressed. 557depressed.
558 558
559=head3 What's with the strange Backspace/Delete key behaviour? 559=head3 What's with the strange Backspace/Delete key behaviour?
560 560
561Assuming that the physical Backspace key corresponds to the 561Assuming that the physical Backspace key corresponds to the
562BackSpace keysym (not likely for Linux ... see the following 562Backspace keysym (not likely for Linux ... see the following
563question) there are two standard values that can be used for 563question) there are two standard values that can be used for
564Backspace: C<^H> and C<^?>. 564Backspace: C<^H> and C<^?>.
565 565
566Historically, either value is correct, but rxvt-unicode adopts the debian 566Historically, either value is correct, but rxvt-unicode adopts the debian
567policy of using C<^?> when unsure, because it's the one only only correct 567policy of using C<^?> when unsure, because it's the one and only correct
568choice :). 568choice :).
569 569
570Rxvt-unicode tries to inherit the current stty settings and uses the value 570Rxvt-unicode tries to inherit the current stty settings and uses the value
571of `erase' to guess the value for backspace. If rxvt-unicode wasn't 571of `erase' to guess the value for backspace. If rxvt-unicode wasn't
572started from a terminal (say, from a menu or by remote shell), then the 572started from a terminal (say, from a menu or by remote shell), then the
665The default configuration tries to be xterm-like, which I don't like that 665The default configuration tries to be xterm-like, which I don't like that
666much, but it's least surprise to regular users. 666much, but it's least surprise to regular users.
667 667
668As a rxvt or rxvt-unicode user, you are practically supposed to invest 668As a rxvt or rxvt-unicode user, you are practically supposed to invest
669time into customising your terminal. To get you started, here is the 669time into customising your terminal. To get you started, here is the
670author's .Xdefaults entries, with comments on what they do: 670author's .Xdefaults entries, with comments on what they do. It's certainly
671not I<typical>, but what's typical...
671 672
672 URxvt.cutchars: "()*,<>[]{}|' 673 URxvt.cutchars: "()*,<>[]{}|'
673 URxvt.print-pipe: cat >/tmp/xxx 674 URxvt.print-pipe: cat >/tmp/xxx
674 675
675These are just for testing stuff. 676These are just for testing stuff.
693directory and also tells urxvt to use a large number of extensions. I 694directory and also tells urxvt to use a large number of extensions. I
694develop for myself mostly, so I actually use most of the extensions I 695develop for myself mostly, so I actually use most of the extensions I
695write. 696write.
696 697
697The selection stuff mainly makes the selection perl-error-message aware 698The selection stuff mainly makes the selection perl-error-message aware
698and tells it to convert pelr error mssages into vi-commands to load the 699and tells it to convert perl error messages into vi-commands to load the
699relevant file and go tot he error line number. 700relevant file and go tot he error line number.
700 701
701 URxvt.scrollstyle: plain 702 URxvt.scrollstyle: plain
702 URxvt.secondaryScroll: true 703 URxvt.secondaryScroll: true
703 704
704As the documentation says: plain is the preferred scrollbar for the 705As the documentation says: plain is the preferred scrollbar for the
705author. The C<secondaryScroll> confgiures urxvt to scroll in full-screen 706author. The C<secondaryScroll> configures urxvt to scroll in full-screen
706apps, like screen, so lines scorlled out of screen end up in urxvt's 707apps, like screen, so lines scrolled out of screen end up in urxvt's
707scrollback buffer. 708scrollback buffer.
708 709
709 URxvt.background: #000000 710 URxvt.background: #000000
710 URxvt.foreground: gray90 711 URxvt.foreground: gray90
711 URxvt.color7: gray90 712 URxvt.color7: gray90
762 urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15 763 urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
763 urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true 764 urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
764 urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true 765 urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
765 766
766I wrote rxvt-unicode to be able to specify fonts exactly. So don't be 767I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
767overwhelmed. A special note: the C<9x15bold> mentioend above is actually 768overwhelmed. A special note: the C<9x15bold> mentioned above is actually
768the version from XFree-3.3, as XFree-4 replaced it by a totally different 769the version from XFree-3.3, as XFree-4 replaced it by a totally different
769font (different glyphs for C<;> and many other harmless characters), 770font (different glyphs for C<;> and many other harmless characters),
770while the second font is actually the C<9x15bold> from XFree4/XOrg. The 771while the second font is actually the C<9x15bold> from XFree4/XOrg. The
771bold version has less chars than the medium version, so I use it for rare 772bold version has less chars than the medium version, so I use it for rare
772characters, too. Whene ditign sources with vim, I use italic for comments 773characters, too. When editing sources with vim, I use italic for comments
773and other stuff, which looks quite good with Bitstream Vera anti-aliased. 774and other stuff, which looks quite good with Bitstream Vera anti-aliased.
774 775
775Terminus is a quite bad font (many very wrong glyphs), but for most of my 776Terminus is a quite bad font (many very wrong glyphs), but for most of my
776purposes, it works, and gives a different look, as my normal (Non-bold) 777purposes, it works, and gives a different look, as my normal (Non-bold)
777font is already bold, and I want to see a difference between bold and 778font is already bold, and I want to see a difference between bold and
828Also consider the form resources have to use: 829Also consider the form resources have to use:
829 830
830 URxvt.resource: value 831 URxvt.resource: value
831 832
832If you want to use another form (there are lots of different ways of 833If you want to use another form (there are lots of different ways of
833specifying resources), make sure you understand wether and why it 834specifying resources), make sure you understand whether and why it
834works. If unsure, use the form above. 835works. If unsure, use the form above.
835 836
836=head3 When I log-in to another system it tells me about missing terminfo data? 837=head3 When I log-in to another system it tells me about missing terminfo data?
837 838
838The terminal description used by rxvt-unicode is not as widely available 839The terminal description used by rxvt-unicode is not as widely available
839as that for xterm, or even rxvt (for which the same problem often arises). 840as that for xterm, or even rxvt (for which the same problem often arises).
840 841
841The correct solution for this problem is to install the terminfo, this can 842The correct solution for this problem is to install the terminfo, this can
842be done like this (with ncurses' infocmp): 843be done like this (with ncurses' infocmp and works as user and admin):
843 844
844 REMOTE=remotesystem.domain 845 REMOTE=remotesystem.domain
845 infocmp rxvt-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti" 846 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
846 847
847... or by installing rxvt-unicode normally on the remote system, 848... or by installing rxvt-unicode normally on the remote system,
849
850One some systems you might need to set C<$TERMINFO> to the full path of
851F<$HOME/.terminfo> for this to work.
848 852
849If you cannot or do not want to do this, then you can simply set 853If you cannot or do not want to do this, then you can simply set
850C<TERM=rxvt> or even C<TERM=xterm>, and live with the small number of 854C<TERM=rxvt> or even C<TERM=xterm>, and live with the small number of
851problems arising, which includes wrong keymapping, less and different 855problems arising, which includes wrong keymapping, less and different
852colours and some refresh errors in fullscreen applications. It's a nice 856colours and some refresh errors in fullscreen applications. It's a nice
875One reason you might want this is that some distributions or operating 879One reason you might want this is that some distributions or operating
876systems still compile some programs using the long-obsoleted termcap 880systems still compile some programs using the long-obsoleted termcap
877library (Fedora Core's bash is one example) and rely on a termcap entry 881library (Fedora Core's bash is one example) and rely on a termcap entry
878for C<rxvt-unicode>. 882for C<rxvt-unicode>.
879 883
880You could use rxvt's termcap entry with resonable results in many cases. 884You could use rxvt's termcap entry with reasonable results in many cases.
881You can also create a termcap entry by using terminfo's infocmp program 885You can also create a termcap entry by using terminfo's infocmp program
882like this: 886like this:
883 887
884 infocmp -C rxvt-unicode 888 infocmp -C rxvt-unicode
885 889
907 :vs=\E[?25h: 911 :vs=\E[?25h:
908 912
909=head3 Why does C<ls> no longer have coloured output? 913=head3 Why does C<ls> no longer have coloured output?
910 914
911The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to 915The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to
912decide wether a terminal has colour, but uses it's own configuration 916decide whether a terminal has colour, but uses its own configuration
913file. Needless to say, C<rxvt-unicode> is not in it's default file (among 917file. Needless to say, C<rxvt-unicode> is not in its default file (among
914with most other terminals supporting colour). Either add: 918with most other terminals supporting colour). Either add:
915 919
916 TERM rxvt-unicode 920 TERM rxvt-unicode
917 921
918to C</etc/DIR_COLORS> or simply add: 922to C</etc/DIR_COLORS> or simply add:
952If you encounter strange problems like typing an accented character but 956If you encounter strange problems like typing an accented character but
953getting two unrelated other characters or similar, or if program output is 957getting two unrelated other characters or similar, or if program output is
954subtly garbled, then you should check your locale settings. 958subtly garbled, then you should check your locale settings.
955 959
956Rxvt-unicode must be started with the same C<LC_CTYPE> setting as the 960Rxvt-unicode must be started with the same C<LC_CTYPE> setting as the
957programs. Often rxvt-unicode is started in the C<C> locale, while the 961programs running in it. Often rxvt-unicode is started in the C<C> locale,
958login script running within the rxvt-unicode window changes the locale to 962while the login script running within the rxvt-unicode window changes the
959something else, e.g. C<en_GB.UTF-8>. Needless to say, this is not going to work. 963locale to something else, e.g. C<en_GB.UTF-8>. Needless to say, this is
964not going to work, and is the most common cause for problems.
960 965
961The best thing is to fix your startup environment, as you will likely run 966The best thing is to fix your startup environment, as you will likely run
962into other problems. If nothing works you can try this in your .profile. 967into other problems. If nothing works you can try this in your .profile.
963 968
964 printf '\e]701;%s\007' "$LC_CTYPE" 969 printf '\33]701;%s\007' "$LC_CTYPE" # $LANG or $LC_ALL are worth a try, too
965 970
966If this doesn't work, then maybe you use a C<LC_CTYPE> specification not 971If this doesn't work, then maybe you use a C<LC_CTYPE> specification not
967supported on your systems. Some systems have a C<locale> command which 972supported on your systems. Some systems have a C<locale> command which
968displays this (also, C<perl -e0> can be used to check locale settings, as 973displays this (also, C<perl -e0> can be used to check locale settings, as
969it will complain loudly if it cannot set the locale). If it displays something 974it will complain loudly if it cannot set the locale). If it displays something
990The reasons is that there exists a perfectly fine mechanism for selecting 995The reasons is that there exists a perfectly fine mechanism for selecting
991the encoding, doing I/O and (most important) communicating this to all 996the encoding, doing I/O and (most important) communicating this to all
992applications so everybody agrees on character properties such as width 997applications so everybody agrees on character properties such as width
993and code number. This mechanism is the I<locale>. Applications not using 998and code number. This mechanism is the I<locale>. Applications not using
994that info will have problems (for example, C<xterm> gets the width of 999that info will have problems (for example, C<xterm> gets the width of
995characters wrong as it uses it's own, locale-independent table under all 1000characters wrong as it uses its own, locale-independent table under all
996locales). 1001locales).
997 1002
998Rxvt-unicode uses the C<LC_CTYPE> locale category to select encoding. All 1003Rxvt-unicode uses the C<LC_CTYPE> locale category to select encoding. All
999programs doing the same (that is, most) will automatically agree in the 1004programs doing the same (that is, most) will automatically agree in the
1000interpretation of characters. 1005interpretation of characters.
1019=head3 Can I switch locales at runtime? 1024=head3 Can I switch locales at runtime?
1020 1025
1021Yes, using an escape sequence. Try something like this, which sets 1026Yes, using an escape sequence. Try something like this, which sets
1022rxvt-unicode's idea of C<LC_CTYPE>. 1027rxvt-unicode's idea of C<LC_CTYPE>.
1023 1028
1024 printf '\e]701;%s\007' ja_JP.SJIS 1029 printf '\33]701;%s\007' ja_JP.SJIS
1025 1030
1026See also the previous answer. 1031See also the previous answer.
1027 1032
1028Sometimes this capability is rather handy when you want to work in 1033Sometimes this capability is rather handy when you want to work in
1029one locale (e.g. C<de_DE.UTF-8>) but some programs don't support it 1034one locale (e.g. C<de_DE.UTF-8>) but some programs don't support it
1030(e.g. UTF-8). For example, I use this script to start C<xjdic>, which 1035(e.g. UTF-8). For example, I use this script to start C<xjdic>, which
1031first switches to a locale supported by xjdic and back later: 1036first switches to a locale supported by xjdic and back later:
1032 1037
1033 printf '\e]701;%s\007' ja_JP.SJIS 1038 printf '\33]701;%s\007' ja_JP.SJIS
1034 xjdic -js 1039 xjdic -js
1035 printf '\e]701;%s\007' de_DE.UTF-8 1040 printf '\33]701;%s\007' de_DE.UTF-8
1036 1041
1037You can also use xterm's C<luit> program, which usually works fine, except 1042You can also use xterm's C<luit> program, which usually works fine, except
1038for some locales where character width differs between program- and 1043for some locales where character width differs between program- and
1039rxvt-unicode-locales. 1044rxvt-unicode-locales.
1040 1045
1058=item - Make sure your XIM server is actually running. 1063=item - Make sure your XIM server is actually running.
1059 1064
1060=item - Make sure the C<XMODIFIERS> environment variable is set correctly when I<starting> rxvt-unicode. 1065=item - Make sure the C<XMODIFIERS> environment variable is set correctly when I<starting> rxvt-unicode.
1061 1066
1062When you want to use e.g. B<kinput2>, it must be set to 1067When you want to use e.g. B<kinput2>, it must be set to
1063C<@im=kinput2>. For B<scim>, use C<@im=SCIM>. Youc an see what input 1068C<@im=kinput2>. For B<scim>, use C<@im=SCIM>. You can see what input
1064method servers are running with this command: 1069method servers are running with this command:
1065 1070
1066 xprop -root XIM_SERVERS 1071 xprop -root XIM_SERVERS
1067 1072
1068=item 1073=item
1113 1118
1114=head3 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation? 1119=head3 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
1115 1120
1116You should build one binary with the default options. F<configure> 1121You should build one binary with the default options. F<configure>
1117now enables most useful options, and the trend goes to making them 1122now enables most useful options, and the trend goes to making them
1118runtime-switchable, too, so there is usually no drawback to enbaling them, 1123runtime-switchable, too, so there is usually no drawback to enabling them,
1119except higher disk and possibly memory usage. The perl interpreter should 1124except higher disk and possibly memory usage. The perl interpreter should
1120be enabled, as important functionality (menus, selection, likely more in 1125be enabled, as important functionality (menus, selection, likely more in
1121the future) depends on it. 1126the future) depends on it.
1122 1127
1123You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources 1128You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources
1158 1163
1159=head3 I am on FreeBSD and rxvt-unicode does not seem to work at all. 1164=head3 I am on FreeBSD and rxvt-unicode does not seem to work at all.
1160 1165
1161Rxvt-unicode requires the symbol C<__STDC_ISO_10646__> to be defined 1166Rxvt-unicode requires the symbol C<__STDC_ISO_10646__> to be defined
1162in your compile environment, or an implementation that implements it, 1167in your compile environment, or an implementation that implements it,
1163wether it defines the symbol or not. C<__STDC_ISO_10646__> requires that 1168whether it defines the symbol or not. C<__STDC_ISO_10646__> requires that
1164B<wchar_t> is represented as unicode. 1169B<wchar_t> is represented as unicode.
1165 1170
1166As you might have guessed, FreeBSD does neither define this symobl nor 1171As you might have guessed, FreeBSD does neither define this symbol nor
1167does it support it. Instead, it uses it's own internal representation of 1172does it support it. Instead, it uses its own internal representation of
1168B<wchar_t>. This is, of course, completely fine with respect to standards. 1173B<wchar_t>. This is, of course, completely fine with respect to standards.
1169 1174
1170However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and 1175However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and
1171C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>. 1176C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>.
1172 1177
1706 1711
1707Toggle DEC Private Mode Values (rxvt extension). I<where> 1712Toggle DEC Private Mode Values (rxvt extension). I<where>
1708 1713
1709=over 4 1714=over 4
1710 1715
1711=item B<< C<Ps = 1> >> (DECCKM) 1716=item B<< C<Pm = 1> >> (DECCKM)
1712 1717
1713=begin table 1718=begin table
1714 1719
1715 B<< C<h> >> Application Cursor Keys 1720 B<< C<h> >> Application Cursor Keys
1716 B<< C<l> >> Normal Cursor Keys 1721 B<< C<l> >> Normal Cursor Keys
1717 1722
1718=end table 1723=end table
1719 1724
1720=item B<< C<Ps = 2> >> (ANSI/VT52 mode) 1725=item B<< C<Pm = 2> >> (ANSI/VT52 mode)
1721 1726
1722=begin table 1727=begin table
1723 1728
1724 B<< C<h> >> Enter VT52 mode 1729 B<< C<h> >> Enter VT52 mode
1725 B<< C<l> >> Enter VT52 mode 1730 B<< C<l> >> Enter VT52 mode
1726 1731
1727=end table 1732=end table
1728 1733
1729=item B<< C<Ps = 3> >> 1734=item B<< C<Pm = 3> >>
1730 1735
1731=begin table 1736=begin table
1732 1737
1733 B<< C<h> >> 132 Column Mode (DECCOLM) 1738 B<< C<h> >> 132 Column Mode (DECCOLM)
1734 B<< C<l> >> 80 Column Mode (DECCOLM) 1739 B<< C<l> >> 80 Column Mode (DECCOLM)
1735 1740
1736=end table 1741=end table
1737 1742
1738=item B<< C<Ps = 4> >> 1743=item B<< C<Pm = 4> >>
1739 1744
1740=begin table 1745=begin table
1741 1746
1742 B<< C<h> >> Smooth (Slow) Scroll (DECSCLM) 1747 B<< C<h> >> Smooth (Slow) Scroll (DECSCLM)
1743 B<< C<l> >> Jump (Fast) Scroll (DECSCLM) 1748 B<< C<l> >> Jump (Fast) Scroll (DECSCLM)
1744 1749
1745=end table 1750=end table
1746 1751
1747=item B<< C<Ps = 5> >> 1752=item B<< C<Pm = 5> >>
1748 1753
1749=begin table 1754=begin table
1750 1755
1751 B<< C<h> >> Reverse Video (DECSCNM) 1756 B<< C<h> >> Reverse Video (DECSCNM)
1752 B<< C<l> >> Normal Video (DECSCNM) 1757 B<< C<l> >> Normal Video (DECSCNM)
1753 1758
1754=end table 1759=end table
1755 1760
1756=item B<< C<Ps = 6> >> 1761=item B<< C<Pm = 6> >>
1757 1762
1758=begin table 1763=begin table
1759 1764
1760 B<< C<h> >> Origin Mode (DECOM) 1765 B<< C<h> >> Origin Mode (DECOM)
1761 B<< C<l> >> Normal Cursor Mode (DECOM) 1766 B<< C<l> >> Normal Cursor Mode (DECOM)
1762 1767
1763=end table 1768=end table
1764 1769
1765=item B<< C<Ps = 7> >> 1770=item B<< C<Pm = 7> >>
1766 1771
1767=begin table 1772=begin table
1768 1773
1769 B<< C<h> >> Wraparound Mode (DECAWM) 1774 B<< C<h> >> Wraparound Mode (DECAWM)
1770 B<< C<l> >> No Wraparound Mode (DECAWM) 1775 B<< C<l> >> No Wraparound Mode (DECAWM)
1771 1776
1772=end table 1777=end table
1773 1778
1774=item B<< C<Ps = 8> >> I<unimplemented> 1779=item B<< C<Pm = 8> >> I<unimplemented>
1775 1780
1776=begin table 1781=begin table
1777 1782
1778 B<< C<h> >> Auto-repeat Keys (DECARM) 1783 B<< C<h> >> Auto-repeat Keys (DECARM)
1779 B<< C<l> >> No Auto-repeat Keys (DECARM) 1784 B<< C<l> >> No Auto-repeat Keys (DECARM)
1780 1785
1781=end table 1786=end table
1782 1787
1783=item B<< C<Ps = 9> >> X10 XTerm 1788=item B<< C<Pm = 9> >> X10 XTerm
1784 1789
1785=begin table 1790=begin table
1786 1791
1787 B<< C<h> >> Send Mouse X & Y on button press. 1792 B<< C<h> >> Send Mouse X & Y on button press.
1788 B<< C<l> >> No mouse reporting. 1793 B<< C<l> >> No mouse reporting.
1789 1794
1790=end table 1795=end table
1791 1796
1792=item B<< C<Ps = 25> >> 1797=item B<< C<Pm = 25> >>
1793 1798
1794=begin table 1799=begin table
1795 1800
1796 B<< C<h> >> Visible cursor {cnorm/cvvis} 1801 B<< C<h> >> Visible cursor {cnorm/cvvis}
1797 B<< C<l> >> Invisible cursor {civis} 1802 B<< C<l> >> Invisible cursor {civis}
1798 1803
1799=end table 1804=end table
1800 1805
1801=item B<< C<Ps = 30> >> 1806=item B<< C<Pm = 30> >>
1802 1807
1803=begin table 1808=begin table
1804 1809
1805 B<< C<h> >> scrollBar visisble 1810 B<< C<h> >> scrollBar visisble
1806 B<< C<l> >> scrollBar invisisble 1811 B<< C<l> >> scrollBar invisisble
1807 1812
1808=end table 1813=end table
1809 1814
1810=item B<< C<Ps = 35> >> (B<rxvt>) 1815=item B<< C<Pm = 35> >> (B<rxvt>)
1811 1816
1812=begin table 1817=begin table
1813 1818
1814 B<< C<h> >> Allow XTerm Shift+key sequences 1819 B<< C<h> >> Allow XTerm Shift+key sequences
1815 B<< C<l> >> Disallow XTerm Shift+key sequences 1820 B<< C<l> >> Disallow XTerm Shift+key sequences
1816 1821
1817=end table 1822=end table
1818 1823
1819=item B<< C<Ps = 38> >> I<unimplemented> 1824=item B<< C<Pm = 38> >> I<unimplemented>
1820 1825
1821Enter Tektronix Mode (DECTEK) 1826Enter Tektronix Mode (DECTEK)
1822 1827
1823=item B<< C<Ps = 40> >> 1828=item B<< C<Pm = 40> >>
1824 1829
1825=begin table 1830=begin table
1826 1831
1827 B<< C<h> >> Allow 80/132 Mode 1832 B<< C<h> >> Allow 80/132 Mode
1828 B<< C<l> >> Disallow 80/132 Mode 1833 B<< C<l> >> Disallow 80/132 Mode
1829 1834
1830=end table 1835=end table
1831 1836
1832=item B<< C<Ps = 44> >> I<unimplemented> 1837=item B<< C<Pm = 44> >> I<unimplemented>
1833 1838
1834=begin table 1839=begin table
1835 1840
1836 B<< C<h> >> Turn On Margin Bell 1841 B<< C<h> >> Turn On Margin Bell
1837 B<< C<l> >> Turn Off Margin Bell 1842 B<< C<l> >> Turn Off Margin Bell
1838 1843
1839=end table 1844=end table
1840 1845
1841=item B<< C<Ps = 45> >> I<unimplemented> 1846=item B<< C<Pm = 45> >> I<unimplemented>
1842 1847
1843=begin table 1848=begin table
1844 1849
1845 B<< C<h> >> Reverse-wraparound Mode 1850 B<< C<h> >> Reverse-wraparound Mode
1846 B<< C<l> >> No Reverse-wraparound Mode 1851 B<< C<l> >> No Reverse-wraparound Mode
1847 1852
1848=end table 1853=end table
1849 1854
1850=item B<< C<Ps = 46> >> I<unimplemented> 1855=item B<< C<Pm = 46> >> I<unimplemented>
1851 1856
1852=item B<< C<Ps = 47> >> 1857=item B<< C<Pm = 47> >>
1853 1858
1854=begin table 1859=begin table
1855 1860
1856 B<< C<h> >> Use Alternate Screen Buffer 1861 B<< C<h> >> Use Alternate Screen Buffer
1857 B<< C<l> >> Use Normal Screen Buffer 1862 B<< C<l> >> Use Normal Screen Buffer
1858 1863
1859=end table 1864=end table
1860 1865
1861X<Priv66> 1866X<Priv66>
1862 1867
1863=item B<< C<Ps = 66> >> 1868=item B<< C<Pm = 66> >>
1864 1869
1865=begin table 1870=begin table
1866 1871
1867 B<< C<h> >> Application Keypad (DECPAM) == C<ESC => 1872 B<< C<h> >> Application Keypad (DECPAM) == C<ESC =>
1868 B<< C<l> >> Normal Keypad (DECPNM) == C<< ESC > >> 1873 B<< C<l> >> Normal Keypad (DECPNM) == C<< ESC > >>
1869 1874
1870=end table 1875=end table
1871 1876
1872=item B<< C<Ps = 67> >> 1877=item B<< C<Pm = 67> >>
1873 1878
1874=begin table 1879=begin table
1875 1880
1876 B<< C<h> >> Backspace key sends B<< C<BS> (DECBKM) >> 1881 B<< C<h> >> Backspace key sends B<< C<BS> (DECBKM) >>
1877 B<< C<l> >> Backspace key sends B<< C<DEL> >> 1882 B<< C<l> >> Backspace key sends B<< C<DEL> >>
1878 1883
1879=end table 1884=end table
1880 1885
1881=item B<< C<Ps = 1000> >> (X11 XTerm) 1886=item B<< C<Pm = 1000> >> (X11 XTerm)
1882 1887
1883=begin table 1888=begin table
1884 1889
1885 B<< C<h> >> Send Mouse X & Y on button press and release. 1890 B<< C<h> >> Send Mouse X & Y on button press and release.
1886 B<< C<l> >> No mouse reporting. 1891 B<< C<l> >> No mouse reporting.
1887 1892
1888=end table 1893=end table
1889 1894
1890=item B<< C<Ps = 1001> >> (X11 XTerm) I<unimplemented> 1895=item B<< C<Pm = 1001> >> (X11 XTerm) I<unimplemented>
1891 1896
1892=begin table 1897=begin table
1893 1898
1894 B<< C<h> >> Use Hilite Mouse Tracking. 1899 B<< C<h> >> Use Hilite Mouse Tracking.
1895 B<< C<l> >> No mouse reporting. 1900 B<< C<l> >> No mouse reporting.
1896 1901
1897=end table 1902=end table
1898 1903
1899=item B<< C<Ps = 1010> >> (B<rxvt>) 1904=item B<< C<Pm = 1010> >> (B<rxvt>)
1900 1905
1901=begin table 1906=begin table
1902 1907
1903 B<< C<h> >> Don't scroll to bottom on TTY output 1908 B<< C<h> >> Don't scroll to bottom on TTY output
1904 B<< C<l> >> Scroll to bottom on TTY output 1909 B<< C<l> >> Scroll to bottom on TTY output
1905 1910
1906=end table 1911=end table
1907 1912
1908=item B<< C<Ps = 1011> >> (B<rxvt>) 1913=item B<< C<Pm = 1011> >> (B<rxvt>)
1909 1914
1910=begin table 1915=begin table
1911 1916
1912 B<< C<h> >> Scroll to bottom when a key is pressed 1917 B<< C<h> >> Scroll to bottom when a key is pressed
1913 B<< C<l> >> Don't scroll to bottom when a key is pressed 1918 B<< C<l> >> Don't scroll to bottom when a key is pressed
1914 1919
1915=end table 1920=end table
1916 1921
1917=item B<< C<Ps = 1021> >> (B<rxvt>) 1922=item B<< C<Pm = 1021> >> (B<rxvt>)
1918 1923
1919=begin table 1924=begin table
1920 1925
1921 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>) 1926 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>)
1922 B<< C<l> >> Font styles have no effect on intensity (Compile styles) 1927 B<< C<l> >> Font styles have no effect on intensity (Compile styles)
1923 1928
1924=end table 1929=end table
1925 1930
1926=item B<< C<Ps = 1047> >> 1931=item B<< C<Pm = 1047> >>
1927 1932
1928=begin table 1933=begin table
1929 1934
1930 B<< C<h> >> Use Alternate Screen Buffer 1935 B<< C<h> >> Use Alternate Screen Buffer
1931 B<< C<l> >> Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it 1936 B<< C<l> >> Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
1932 1937
1933=end table 1938=end table
1934 1939
1935=item B<< C<Ps = 1048> >> 1940=item B<< C<Pm = 1048> >>
1936 1941
1937=begin table 1942=begin table
1938 1943
1939 B<< C<h> >> Save cursor position 1944 B<< C<h> >> Save cursor position
1940 B<< C<l> >> Restore cursor position 1945 B<< C<l> >> Restore cursor position
1941 1946
1942=end table 1947=end table
1943 1948
1944=item B<< C<Ps = 1049> >> 1949=item B<< C<Pm = 1049> >>
1945 1950
1946=begin table 1951=begin table
1947 1952
1948 B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it 1953 B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
1949 B<< C<l> >> Use Normal Screen Buffer 1954 B<< C<l> >> Use Normal Screen Buffer
2196 2201
2197=head1 CONFIGURE OPTIONS 2202=head1 CONFIGURE OPTIONS
2198 2203
2199General hint: if you get compile errors, then likely your configuration 2204General hint: if you get compile errors, then likely your configuration
2200hasn't been tested well. Either try with C<--enable-everything> or use 2205hasn't been tested well. Either try with C<--enable-everything> or use
2201the F<./reconf> script as a base for experiments. F<./reconf> is used by 2206the default configuration (i.e. C<--enable-xxx> or C<--disable-xxx>). Of
2202myself, so it should generally be a working config. Of course, you should 2207course, you should always report when a combination doesn't work, so it
2203always report when a combination doesn't work, so it can be fixed. Marc 2208can be fixed. Marc Lehmann <rxvt@schmorp.de>.
2204Lehmann <rxvt@schmorp.de>.
2205 2209
2206All 2210All
2207 2211
2208=over 4 2212=over 4
2209 2213
2241 2245
2242=begin table 2246=begin table
2243 2247
2244 all all available codeset groups 2248 all all available codeset groups
2245 zh common chinese encodings 2249 zh common chinese encodings
2246 zh_ext rarely used but very big chinese encodigs 2250 zh_ext rarely used but very big chinese encodings
2247 jp common japanese encodings 2251 jp common japanese encodings
2248 jp_ext rarely used but big japanese encodings 2252 jp_ext rarely used but big japanese encodings
2249 kr korean encodings 2253 kr korean encodings
2250 2254
2251=end table 2255=end table
2265requirements per character from 2 to 4 bytes. X11 fonts do not yet 2269requirements per character from 2 to 4 bytes. X11 fonts do not yet
2266support these extra characters, but Xft does. 2270support these extra characters, but Xft does.
2267 2271
2268Please note that rxvt-unicode can store unicode code points >65535 2272Please note that rxvt-unicode can store unicode code points >65535
2269even without this flag, but the number of such characters is 2273even without this flag, but the number of such characters is
2270limited to a view thousand (shared with combining characters, 2274limited to a few thousand (shared with combining characters,
2271see next switch), and right now rxvt-unicode cannot display them 2275see next switch), and right now rxvt-unicode cannot display them
2272(input/output and cut&paste still work, though). 2276(input/output and cut&paste still work, though).
2273 2277
2274=item --enable-combining (default: on) 2278=item --enable-combining (default: on)
2275 2279
2389A non-exhaustive list of features enabled by C<--enable-frills> (possibly 2393A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2390in combination with other switches) is: 2394in combination with other switches) is:
2391 2395
2392 MWM-hints 2396 MWM-hints
2393 EWMH-hints (pid, utf8 names) and protocols (ping) 2397 EWMH-hints (pid, utf8 names) and protocols (ping)
2398 urgency hint
2394 seperate underline colour (-underlineColor) 2399 seperate underline colour (-underlineColor)
2395 settable border widths and borderless switch (-w, -b, -bl) 2400 settable border widths and borderless switch (-w, -b, -bl)
2396 visual depth selection (-depth) 2401 visual depth selection (-depth)
2397 settable extra linespacing /-lsp) 2402 settable extra linespacing /-lsp)
2398 iso-14755-2 and -3, and visual feedback 2403 iso-14755 5.1 (basic) support
2399 tripleclickwords (-tcw) 2404 tripleclickwords (-tcw)
2400 settable insecure mode (-insecure) 2405 settable insecure mode (-insecure)
2401 keysym remapping support 2406 keysym remapping support
2402 cursor blinking and underline cursor (-cb, -uc) 2407 cursor blinking and underline cursor (-cb, -uc)
2403 XEmbed support (-embed) 2408 XEmbed support (-embed)
2404 user-pty (-pty-fd) 2409 user-pty (-pty-fd)
2405 hold on exit (-hold) 2410 hold on exit (-hold)
2406 skip builtin block graphics (-sbg) 2411 skip builtin block graphics (-sbg)
2412 separate highlightcolor support (-hc)
2407 2413
2408It also enabled some non-essential features otherwise disabled, such as: 2414It also enables some non-essential features otherwise disabled, such as:
2409 2415
2410 some round-trip time optimisations 2416 some round-trip time optimisations
2411 nearest color allocation on pseudocolor screens 2417 nearest color allocation on pseudocolor screens
2412 UTF8_STRING supporr for selection 2418 UTF8_STRING support for selection
2413 sgr modes 90..97 and 100..107 2419 sgr modes 90..97 and 100..107
2414 backindex and forwardindex escape sequences 2420 backindex and forwardindex escape sequences
2415 view change/zero scorllback esacpe sequences 2421 view change/zero scrollback escape sequences
2416 locale switching escape sequence 2422 locale switching escape sequence
2417 window op and some xterm/OSC escape sequences 2423 window op and some xterm/OSC escape sequences
2418 rectangular selections 2424 rectangular selections
2419 trailing space removal for selections 2425 trailing space removal for selections
2420 verbose X error handling 2426 verbose X error handling
2439 2445
2440Add support for continual scrolling (using the mouse wheel as an 2446Add support for continual scrolling (using the mouse wheel as an
2441accelerator) while the control key is held down. This option 2447accelerator) while the control key is held down. This option
2442requires --enable-mousewheel to also be specified. 2448requires --enable-mousewheel to also be specified.
2443 2449
2444=item --disable-new-selection
2445
2446Remove support for mouse selection style like that of xterm.
2447
2448=item --enable-dmalloc (default: off)
2449
2450Use Gray Watson's malloc - which is good for debugging See
2451L<http://www.letters.com/dmalloc/> for details If you use either this or the
2452next option, you may need to edit src/Makefile after compiling to point
2453DINCLUDE and DLIB to the right places.
2454
2455You can only use either this option and the following (should
2456you use either) .
2457
2458=item --enable-dlmalloc (default: off)
2459
2460Use Doug Lea's malloc - which is good for a production version
2461See L<http://g.oswego.edu/dl/html/malloc.html> for details.
2462
2463=item --enable-smart-resize (default: on) 2450=item --enable-smart-resize (default: on)
2464 2451
2465Add smart growth/shrink behaviour when changing font size via hot 2452Add smart growth/shrink behaviour when changing font size via hot
2466keys. This should keep the window corner which is closest to a corner of 2453keys. This should keep the window corner which is closest to a corner of
2467the screen in a fixed position. 2454the screen in a fixed position.
2471Add support to have the pointer disappear when typing or inactive. 2458Add support to have the pointer disappear when typing or inactive.
2472 2459
2473=item --enable-perl (default: on) 2460=item --enable-perl (default: on)
2474 2461
2475Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> 2462Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2476manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files 2463manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the
2477in F<src/perl-ext/> for the extensions that are installed by default. The 2464files in F<src/perl-ext/> for the extensions that are installed by
2478perl interpreter that is used can be specified via the C<PERL> environment 2465default. The perl interpreter that is used can be specified via the
2479variable when running configure. 2466C<PERL> environment variable when running configure. Even when compiled
2467in, perl will I<not> be initialised when all extensions have been disabled
2468C<-pe "" --perl-ext-common "">, so it should be safe to enable from a
2469resource standpoint.
2480 2470
2481=item --with-name=NAME (default: urxvt) 2471=item --with-name=NAME (default: urxvt)
2482 2472
2483Set the basename for the installed binaries, resulting 2473Set the basename for the installed binaries, resulting
2484in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with 2474in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines