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

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.86 by root, Wed Aug 1 18:38:16 2007 UTC vs.
Revision 1.87 by sasha, Fri Oct 26 18:27:29 2007 UTC

1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
2.\" 2.\"
3.\" Standard preamble: 3.\" Standard preamble:
4.\" ======================================================================== 4.\" ========================================================================
5.de Sh \" Subsection heading 5.de Sh \" Subsection heading
6.br 6.br
… …
127.\} 127.\}
128.rm #[ #] #H #V #F C 128.rm #[ #] #H #V #F C
129.\" ======================================================================== 129.\" ========================================================================
130.\" 130.\"
131.IX Title "@@RXVT_NAME@@ 7" 131.IX Title "@@RXVT_NAME@@ 7"
132.TH @@RXVT_NAME@@ 7 "2007-08-01" "8.3" "RXVT-UNICODE" 132.TH @@RXVT_NAME@@ 7 "2007-10-26" "8.3" "RXVT-UNICODE"
133.SH "NAME" 133.SH "NAME"
134RXVT REFERENCE \- FAQ, command sequences and other background information 134RXVT REFERENCE \- FAQ, command sequences and other background information
135.SH "SYNOPSIS" 135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS" 136.IX Header "SYNOPSIS"
137.Vb 2 137.Vb 2
138\& # set a new font set 138\& # set a new font set
139\& printf '\e33]50;%s\e007' 9x15,xft:Kochi" Mincho" 139\& printf '\e33]50;%s\e007' 9x15,xft:Kochi" Mincho"
140.Ve 140.Ve
141.PP 141.PP
142.Vb 2 142.Vb 2
143\& # change the locale and tell rxvt-unicode about it 143\& # change the locale and tell rxvt\-unicode about it
144\& export LC_CTYPE=ja_JP.EUC-JP; printf "\e33]701;$LC_CTYPE\e007" 144\& export LC_CTYPE=ja_JP.EUC\-JP; printf "\e33]701;$LC_CTYPE\e007"
145.Ve 145.Ve
146.PP 146.PP
147.Vb 2 147.Vb 2
148\& # set window title 148\& # set window title
149\& printf '\e33]2;%s\e007' "new window title" 149\& printf '\e33]2;%s\e007' "new window title"
… …
172Beginning with version 7.3, there is a perl extension that implements a 172Beginning with version 7.3, there is a perl extension that implements a
173simple tabbed terminal. It is installed by default, so any of these should 173simple tabbed terminal. It is installed by default, so any of these should
174give you tabs: 174give you tabs:
175.PP 175.PP
176.Vb 1 176.Vb 1
177\& @@URXVT_NAME@@ -pe tabbed 177\& @@URXVT_NAME@@ \-pe tabbed
178.Ve 178.Ve
179.PP 179.PP
180.Vb 1 180.Vb 1
181\& URxvt.perl-ext-common: default,tabbed 181\& URxvt.perl\-ext\-common: default,tabbed
182.Ve 182.Ve
183.PP 183.PP
184It will also work fine with tabbing functionality of many window managers 184It will also work fine with tabbing functionality of many window managers
185or similar tabbing programs, and its embedding-features allow it to be 185or similar tabbing programs, and its embedding-features allow it to be
186embedded into other programs, as witnessed by \fIdoc/rxvt\-tabbed\fR or 186embedded into other programs, as witnessed by \fIdoc/rxvt\-tabbed\fR or
… …
224@@URXVT_NAME@@c and the daemon isn't running yet, use this script: 224@@URXVT_NAME@@c and the daemon isn't running yet, use this script:
225.PP 225.PP
226.Vb 6 226.Vb 6
227\& #!/bin/sh 227\& #!/bin/sh
228\& @@URXVT_NAME@@c "$@" 228\& @@URXVT_NAME@@c "$@"
229\& if [ $? -eq 2 ]; then 229\& if [ $? \-eq 2 ]; then
230\& @@URXVT_NAME@@d -q -o -f 230\& @@URXVT_NAME@@d \-q \-o \-f
231\& @@URXVT_NAME@@c "$@" 231\& @@URXVT_NAME@@c "$@"
232\& fi 232\& fi
233.Ve 233.Ve
234.PP 234.PP
235This tries to create a new terminal, and if fails with exit status 2, 235This tries to create a new terminal, and if fails with exit status 2,
… …
258Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script 258Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script
259snippets: 259snippets:
260.PP 260.PP
261.Vb 12 261.Vb 12
262\& # Bourne/Korn/POSIX family of shells: 262\& # Bourne/Korn/POSIX family of shells:
263\& [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know 263\& [ ${TERM:\-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
264\& if [ ${TERM:-foo} = xterm ]; then 264\& if [ ${TERM:\-foo} = xterm ]; then
265\& stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not 265\& stty \-icanon \-echo min 0 time 15 # see if enhanced rxvt or not
266\& echo -n '^[Z' 266\& echo \-n '^[Z'
267\& read term_id 267\& read term_id
268\& stty icanon echo 268\& stty icanon echo
269\& if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then 269\& if [ ""${term_id} = '^[[?1;2C' \-a ${DISPLAY:\-foo} = foo ]; then
270\& echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string 270\& echo \-n '^[[7n' # query the rxvt we are in for the DISPLAY string
271\& read DISPLAY # set it in our local shell 271\& read DISPLAY # set it in our local shell
272\& fi 272\& fi
273\& fi 273\& fi
274.Ve 274.Ve
275.PP 275.PP
… …
291features unique to urxvt (locale, encoding conversion, iso14755 etc.) are 291features unique to urxvt (locale, encoding conversion, iso14755 etc.) are
292already in use in this mode. 292already in use in this mode.
293.PP 293.PP
294.Vb 3 294.Vb 3
295\& text data bss drs rss filename 295\& text data bss drs rss filename
296\& 98398 1664 24 15695 1824 rxvt --disable-everything 296\& 98398 1664 24 15695 1824 rxvt \-\-disable\-everything
297\& 188985 9048 66616 18222 1788 urxvt --disable-everything 297\& 188985 9048 66616 18222 1788 urxvt \-\-disable\-everything
298.Ve 298.Ve
299.PP 299.PP
300When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft 300When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft
301and full locale/XIM support which are quite bloaty inside libX11 and my 301and full locale/XIM support which are quite bloaty inside libX11 and my
302libc), the two diverge, but not unreasonably so. 302libc), the two diverge, but not unreasonably so.
303.PP 303.PP
304.Vb 3 304.Vb 3
305\& text data bss drs rss filename 305\& text data bss drs rss filename
306\& 163431 2152 24 20123 2060 rxvt --enable-everything 306\& 163431 2152 24 20123 2060 rxvt \-\-enable\-everything
307\& 1035683 49680 66648 29096 3680 urxvt --enable-everything 307\& 1035683 49680 66648 29096 3680 urxvt \-\-enable\-everything
308.Ve 308.Ve
309.PP 309.PP
310The very large size of the text section is explained by the east-asian 310The very large size of the text section is explained by the east-asian
311encoding tables, which, if unused, take up disk space but nothing else 311encoding tables, which, if unused, take up disk space but nothing else
312and can be compiled out unless you rely on X11 core fonts that use those 312and can be compiled out unless you rely on X11 core fonts that use those
… …
348.PP 348.PP
349.Vb 4 349.Vb 4
350\& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 350\& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
351\& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) 351\& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000)
352\& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) 352\& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000)
353\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 353\& /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000)
354.Ve 354.Ve
355.PP 355.PP
356And here is rxvt\-unicode: 356And here is rxvt\-unicode:
357.PP 357.PP
358.Vb 5 358.Vb 5
359\& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 359\& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
360\& libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) 360\& libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
361\& libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) 361\& libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)
362\& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) 362\& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)
363\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 363\& /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000)
364.Ve 364.Ve
365.PP 365.PP
366No large bloated libraries (of course, none were linked in statically), 366No large bloated libraries (of course, none were linked in statically),
367except maybe libX11 :) 367except maybe libX11 :)
368.Sh "Rendering, Font & Look and Feel Issues" 368.Sh "Rendering, Font & Look and Feel Issues"
369.IX Subsection "Rendering, Font & Look and Feel Issues" 369.IX Subsection "Rendering, Font & Look and Feel Issues"
370\fII can't get transparency working, what am I doing wrong?\fR 370\fII can't get transparency working, what am I doing wrong?\fR
371.IX Subsection "I can't get transparency working, what am I doing wrong?" 371.IX Subsection "I can't get transparency working, what am I doing wrong?"
372.PP 372.PP
373First of all, transparency isn't officially supported in rxvt\-unicode, so 373First of all, please address all transparency related issues to Sasha Vasko at
374you are mostly on your own. Do not bug the author about it (but you may 374sasha@aftercode.net and do not bug the author about it. Also, if you can't
375bug everybody else). Also, if you can't get it working consider it a rite 375get it working consider it a rite of passage: ... and you failed.
376of passage: ... and you failed.
377.PP 376.PP
378Here are four ways to get transparency. \fBDo\fR read the manpage and option 377Here are four ways to get transparency. \fBDo\fR read the manpage and option
379descriptions for the programs mentioned and rxvt\-unicode. Really, do it! 378descriptions for the programs mentioned and rxvt\-unicode. Really, do it!
380.PP 379.PP
3811. Use inheritPixmap: 3801. Use inheritPixmap:
382.PP 381.PP
383.Vb 2 382.Vb 2
384\& Esetroot wallpaper.jpg 383\& Esetroot wallpaper.jpg
385\& @@URXVT_NAME@@ -ip -tint red -sh 40 384\& @@URXVT_NAME@@ \-ip \-tint red \-sh 40
386.Ve 385.Ve
387.PP 386.PP
388That works. If you think it doesn't, you lack transparency and tinting 387That works. If you think it doesn't, you lack transparency and tinting
389support, or you are unable to read. 388support, or you are unable to read.
390.PP 389.PP
3912. Use a simple pixmap and emulate pseudo\-transparency. This enables you 3902. Use a simple pixmap and emulate pseudo\-transparency. This enables you
392to use effects other than tinting and shading: Just shade/tint/whatever 391to use effects other than tinting and shading: Just shade/tint/whatever
393your picture with gimp or any other tool: 392your picture with gimp or any other tool:
394.PP 393.PP
395.Vb 2 394.Vb 2
396\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 395\& convert wallpaper.jpg \-blur 20x20 \-modulate 30 background.jpg
397\& @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background 396\& @@URXVT_NAME@@ \-pixmap background.jpg \-pe automove\-background
398.Ve 397.Ve
399.PP 398.PP
400That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you 399That works. If you think it doesn't, you lack AfterImage and Perl support, or you
401are unable to read. 400are unable to read.
402.PP 401.PP
4033. Use an \s-1ARGB\s0 visual: 4023. Use an \s-1ARGB\s0 visual:
404.PP 403.PP
405.Vb 1 404.Vb 1
406\& @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 405\& @@URXVT_NAME@@ \-depth 32 \-fg grey90 \-bg rgba:0000/0000/4444/cccc
407.Ve 406.Ve
408.PP 407.PP
409This requires \s-1XFT\s0 support, and the support of your X\-server. If that 408This requires \s-1XFT\s0 support, and the support of your X\-server. If that
410doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't 409doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't
411there yet, no matter what they claim. Rxvt-Unicode contains the necessary 410there yet, no matter what they claim. Rxvt-Unicode contains the necessary
… …
413doesn't mean that your \s-1WM\s0 has the required kludges in place. 412doesn't mean that your \s-1WM\s0 has the required kludges in place.
414.PP 413.PP
4154. Use xcompmgr and let it do the job: 4144. Use xcompmgr and let it do the job:
416.PP 415.PP
417.Vb 2 416.Vb 2
418\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e 417\& xprop \-frame \-f _NET_WM_WINDOW_OPACITY 32c \e
419\& -set _NET_WM_WINDOW_OPACITY 0xc0000000 418\& \-set _NET_WM_WINDOW_OPACITY 0xc0000000
420.Ve 419.Ve
421.PP 420.PP
422Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR 421Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR
423by other values to change the degree of opacity. If it doesn't work and 422by other values to change the degree of opacity. If it doesn't work and
424your server crashes, you got to keep the pieces. 423your server crashes, you got to keep the pieces.
… …
615.PP 614.PP
616In that case, select a font of your taste and add it to the font list, 615In that case, select a font of your taste and add it to the font list,
617e.g.: 616e.g.:
618.PP 617.PP
619.Vb 1 618.Vb 1
620\& @@URXVT_NAME@@ -fn basefont,font2,font3... 619\& @@URXVT_NAME@@ \-fn basefont,font2,font3...
621.Ve 620.Ve
622.PP 621.PP
623When rxvt-unicode sees a character, it will first look at the base 622When rxvt-unicode sees a character, it will first look at the base
624font. If the base font does not contain the character, it will go to the 623font. If the base font does not contain the character, it will go to the
625next font, and so on. Specifying your own fonts will also speed up this 624next font, and so on. Specifying your own fonts will also speed up this
… …
651runtime (the internal data structure has no problem with using different 650runtime (the internal data structure has no problem with using different
652fonts for the same character at the same time, but no interface for this 651fonts for the same character at the same time, but no interface for this
653has been designed yet). 652has been designed yet).
654.PP 653.PP
655Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document). 654Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document).
655.PP
656\fIHow can I make mplayer display video correctly?\fR
657.IX Subsection "How can I make mplayer display video correctly?"
658.PP
659We are working on it, in the meantime, as a workaround, use something like:
660.PP
661.Vb 1
662\& @@URXVT_NAME@@ \-b 600 \-geometry 20x1 \-e sh \-c 'mplayer \-wid $WINDOWID file...'
663.Ve
656.Sh "Keyboard, Mouse & User Interaction" 664.Sh "Keyboard, Mouse & User Interaction"
657.IX Subsection "Keyboard, Mouse & User Interaction" 665.IX Subsection "Keyboard, Mouse & User Interaction"
658\fIThe new selection selects pieces that are too big, how can I select single words?\fR 666\fIThe new selection selects pieces that are too big, how can I select single words?\fR
659.IX Subsection "The new selection selects pieces that are too big, how can I select single words?" 667.IX Subsection "The new selection selects pieces that are too big, how can I select single words?"
660.PP 668.PP
661If you want to select e.g. alphanumeric words, you can use the following 669If you want to select e.g. alphanumeric words, you can use the following
662setting: 670setting:
663.PP 671.PP
664.Vb 1 672.Vb 1
665\& URxvt.selection.pattern-0: ([[:word:]]+) 673\& URxvt.selection.pattern\-0: ([[:word:]]+)
666.Ve 674.Ve
667.PP 675.PP
668If you click more than twice, the selection will be extended 676If you click more than twice, the selection will be extended
669more and more. 677more and more.
670.PP 678.PP
671To get a selection that is very similar to the old code, try this pattern: 679To get a selection that is very similar to the old code, try this pattern:
672.PP 680.PP
673.Vb 1 681.Vb 1
674\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) 682\& URxvt.selection.pattern\-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+)
675.Ve 683.Ve
676.PP 684.PP
677Please also note that the \fILeftClick Shift-LeftClik\fR combination also 685Please also note that the \fILeftClick Shift-LeftClik\fR combination also
678selects words like the old code. 686selects words like the old code.
679.PP 687.PP
… …
689\&\fB\s-1PREPACKAGED\s0 \s-1EXTENSIONS\s0\fR in the @@URXVT_NAME@@\fIperl\fR\|(3) manpage. For 697\&\fB\s-1PREPACKAGED\s0 \s-1EXTENSIONS\s0\fR in the @@URXVT_NAME@@\fIperl\fR\|(3) manpage. For
690example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify 698example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify
691this \fBperl-ext-common\fR resource: 699this \fBperl-ext-common\fR resource:
692.PP 700.PP
693.Vb 1 701.Vb 1
694\& URxvt.perl-ext-common: default,-selection-popup,-option-popup 702\& URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup
695.Ve 703.Ve
696.PP 704.PP
697This will keep the default extensions, but disable the two popup 705This will keep the default extensions, but disable the two popup
698extensions. Some extensions can also be configured, for example, 706extensions. Some extensions can also be configured, for example,
699scrollback search mode is triggered by \fBM\-s\fR. You can move it to any 707scrollback search mode is triggered by \fBM\-s\fR. You can move it to any
700other combination either by setting the \fBsearchable-scrollback\fR resource: 708other combination either by setting the \fBsearchable-scrollback\fR resource:
701.PP 709.PP
702.Vb 1 710.Vb 1
703\& URxvt.searchable-scrollback: CM-s 711\& URxvt.searchable\-scrollback: CM\-s
704.Ve 712.Ve
705.PP 713.PP
706\fIThe cursor moves when selecting text in the current input line, how do I switch this off?\fR 714\fIThe cursor moves when selecting text in the current input line, how do I switch this off?\fR
707.IX Subsection "The cursor moves when selecting text in the current input line, how do I switch this off?" 715.IX Subsection "The cursor moves when selecting text in the current input line, how do I switch this off?"
708.PP 716.PP
… …
719.PP 727.PP
720You can permanently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR 728You can permanently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR
721extension: 729extension:
722.PP 730.PP
723.Vb 1 731.Vb 1
724\& URxvt.perl-ext-common: default,-readline 732\& URxvt.perl\-ext\-common: default,\-readline
725.Ve 733.Ve
726.PP 734.PP
727\fIMy numerical keypad acts weird and generates differing output?\fR 735\fIMy numerical keypad acts weird and generates differing output?\fR
728.IX Subsection "My numerical keypad acts weird and generates differing output?" 736.IX Subsection "My numerical keypad acts weird and generates differing output?"
729.PP 737.PP
… …
802For an existing rxvt\-unicode: 810For an existing rxvt\-unicode:
803.PP 811.PP
804.Vb 3 812.Vb 3
805\& # use Backspace = ^H 813\& # use Backspace = ^H
806\& $ stty erase ^H 814\& $ stty erase ^H
807\& $ echo -n "^[[36h" 815\& $ echo \-n "^[[36h"
808.Ve 816.Ve
809.PP 817.PP
810.Vb 3 818.Vb 3
811\& # use Backspace = ^? 819\& # use Backspace = ^?
812\& $ stty erase ^? 820\& $ stty erase ^?
813\& $ echo -n "^[[36l" 821\& $ echo \-n "^[[36l"
814.Ve 822.Ve
815.PP 823.PP
816This helps satisfy some of the Backspace discrepancies that occur, but 824This helps satisfy some of the Backspace discrepancies that occur, but
817if you use Backspace = \f(CW\*(C`^H\*(C'\fR, make sure that the termcap/terminfo value 825if you use Backspace = \f(CW\*(C`^H\*(C'\fR, make sure that the termcap/terminfo value
818properly reflects that. 826properly reflects that.
… …
840Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR 848Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR
841.PP 849.PP
842.Vb 20 850.Vb 20
843\& URxvt.keysym.Home: \e033[1~ 851\& URxvt.keysym.Home: \e033[1~
844\& URxvt.keysym.End: \e033[4~ 852\& URxvt.keysym.End: \e033[4~
845\& URxvt.keysym.C-apostrophe: \e033<C-'> 853\& URxvt.keysym.C\-apostrophe: \e033<C\-'>
846\& URxvt.keysym.C-slash: \e033<C-/> 854\& URxvt.keysym.C\-slash: \e033<C\-/>
847\& URxvt.keysym.C-semicolon: \e033<C-;> 855\& URxvt.keysym.C\-semicolon: \e033<C\-;>
848\& URxvt.keysym.C-grave: \e033<C-`> 856\& URxvt.keysym.C\-grave: \e033<C\-`>
849\& URxvt.keysym.C-comma: \e033<C-,> 857\& URxvt.keysym.C\-comma: \e033<C\-,>
850\& URxvt.keysym.C-period: \e033<C-.> 858\& URxvt.keysym.C\-period: \e033<C\-.>
851\& URxvt.keysym.C-0x60: \e033<C-`> 859\& URxvt.keysym.C\-0x60: \e033<C\-`>
852\& URxvt.keysym.C-Tab: \e033<C-Tab> 860\& URxvt.keysym.C\-Tab: \e033<C\-Tab>
853\& URxvt.keysym.C-Return: \e033<C-Return> 861\& URxvt.keysym.C\-Return: \e033<C\-Return>
854\& URxvt.keysym.S-Return: \e033<S-Return> 862\& URxvt.keysym.S\-Return: \e033<S\-Return>
855\& URxvt.keysym.S-space: \e033<S-Space> 863\& URxvt.keysym.S\-space: \e033<S\-Space>
856\& URxvt.keysym.M-Up: \e033<M-Up> 864\& URxvt.keysym.M\-Up: \e033<M\-Up>
857\& URxvt.keysym.M-Down: \e033<M-Down> 865\& URxvt.keysym.M\-Down: \e033<M\-Down>
858\& URxvt.keysym.M-Left: \e033<M-Left> 866\& URxvt.keysym.M\-Left: \e033<M\-Left>
859\& URxvt.keysym.M-Right: \e033<M-Right> 867\& URxvt.keysym.M\-Right: \e033<M\-Right>
860\& URxvt.keysym.M-C-0: list \e033<M-C- 0123456789 > 868\& URxvt.keysym.M\-C\-0: list \e033<M\-C\- 0123456789 >
861\& URxvt.keysym.M-C-a: list \e033<M-C- abcdefghijklmnopqrstuvwxyz > 869\& URxvt.keysym.M\-C\-a: list \e033<M\-C\- abcdefghijklmnopqrstuvwxyz >
862\& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007 870\& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007
863.Ve 871.Ve
864.PP 872.PP
865See some more examples in the documentation for the \fBkeysym\fR resource. 873See some more examples in the documentation for the \fBkeysym\fR resource.
866.PP 874.PP
… …
892author's .Xdefaults entries, with comments on what they do. It's certainly 900author's .Xdefaults entries, with comments on what they do. It's certainly
893not \fItypical\fR, but what's typical... 901not \fItypical\fR, but what's typical...
894.PP 902.PP
895.Vb 2 903.Vb 2
896\& URxvt.cutchars: "()*,<>[]{}|' 904\& URxvt.cutchars: "()*,<>[]{}|'
897\& URxvt.print-pipe: cat >/tmp/xxx 905\& URxvt.print\-pipe: cat >/tmp/xxx
898.Ve 906.Ve
899.PP 907.PP
900These are just for testing stuff. 908These are just for testing stuff.
901.PP 909.PP
902.Vb 2 910.Vb 2
903\& URxvt.imLocale: ja_JP.UTF-8 911\& URxvt.imLocale: ja_JP.UTF\-8
904\& URxvt.preeditType: OnTheSpot,None 912\& URxvt.preeditType: OnTheSpot,None
905.Ve 913.Ve
906.PP 914.PP
907This tells rxvt-unicode to use a special locale when communicating with 915This tells rxvt-unicode to use a special locale when communicating with
908the X Input Method, and also tells it to only use the OnTheSpot pre-edit 916the X Input Method, and also tells it to only use the OnTheSpot pre-edit
909type, which requires the \f(CW\*(C`xim\-onthespot\*(C'\fR perl extension but rewards me 917type, which requires the \f(CW\*(C`xim\-onthespot\*(C'\fR perl extension but rewards me
910with correct-looking fonts. 918with correct-looking fonts.
911.PP 919.PP
912.Vb 6 920.Vb 6
913\& URxvt.perl-lib: /root/lib/urxvt 921\& URxvt.perl\-lib: /root/lib/urxvt
914\& URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard 922\& URxvt.perl\-ext\-common: default,selection\-autotransform,selection\-pastebin,xim\-onthespot,remote\-clipboard
915\& URxvt.selection.pattern-0: ( at .*? line \e\ed+) 923\& URxvt.selection.pattern\-0: ( at .*? line \e\ed+)
916\& URxvt.selection.pattern-1: ^(/[^:]+):\e 924\& URxvt.selection.pattern\-1: ^(/[^:]+):\e
917\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ 925\& URxvt.selection\-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
918\& URxvt.selection-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ 926\& URxvt.selection\-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
919.Ve 927.Ve
920.PP 928.PP
921This is my perl configuration. The first two set the perl library 929This is my perl configuration. The first two set the perl library
922directory and also tells urxvt to use a large number of extensions. I 930directory and also tells urxvt to use a large number of extensions. I
923develop for myself mostly, so I actually use most of the extensions I 931develop for myself mostly, so I actually use most of the extensions I
… …
1000.PP 1008.PP
1001I once thought this is a great idea. 1009I once thought this is a great idea.
1002.PP 1010.PP
1003.Vb 9 1011.Vb 9
1004\& urxvt.font: 9x15bold,\e 1012\& urxvt.font: 9x15bold,\e
1005\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e 1013\& \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e
1006\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e 1014\& \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e
1007\& [codeset=JISX0208]xft:Kochi Gothic, \e 1015\& [codeset=JISX0208]xft:Kochi Gothic, \e
1008\& xft:Bitstream Vera Sans Mono:autohint=true, \e 1016\& xft:Bitstream Vera Sans Mono:autohint=true, \e
1009\& xft:Code2000:antialias=false 1017\& xft:Code2000:antialias=false
1010\& urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15 1018\& urxvt.boldFont: \-xos4\-terminus\-bold\-r\-normal\-\-14\-140\-72\-72\-c\-80\-iso8859\-15
1011\& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true 1019\& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
1012\& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true 1020\& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
1013.Ve 1021.Ve
1014.PP 1022.PP
1015I wrote rxvt-unicode to be able to specify fonts exactly. So don't be 1023I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
… …
1037\& IRC*saveLines: 0 1045\& IRC*saveLines: 0
1038\& IRC*mapAlert: true 1046\& IRC*mapAlert: true
1039\& IRC*font: suxuseuro 1047\& IRC*font: suxuseuro
1040\& IRC*boldFont: suxuseuro 1048\& IRC*boldFont: suxuseuro
1041\& IRC*colorBD: white 1049\& IRC*colorBD: white
1042\& IRC*keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 1050\& IRC*keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
1043\& IRC*keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 1051\& IRC*keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
1044.Ve 1052.Ve
1045.PP 1053.PP
1046\&\f(CW\*(C`Alt\-Shift\-1\*(C'\fR and \f(CW\*(C`Alt\-Shift\-2\*(C'\fR switch between two different font 1054\&\f(CW\*(C`Alt\-Shift\-1\*(C'\fR and \f(CW\*(C`Alt\-Shift\-2\*(C'\fR switch between two different font
1047sizes. \f(CW\*(C`suxuseuro\*(C'\fR allows me to keep an eye (and actually read) 1055sizes. \f(CW\*(C`suxuseuro\*(C'\fR allows me to keep an eye (and actually read)
1048stuff while keeping a very small window. If somebody pastes something 1056stuff while keeping a very small window. If somebody pastes something
… …
1051The above is all in my \f(CW\*(C`.Xdefaults\*(C'\fR (I don't use \f(CW\*(C`.Xresources\*(C'\fR nor 1059The above is all in my \f(CW\*(C`.Xdefaults\*(C'\fR (I don't use \f(CW\*(C`.Xresources\*(C'\fR nor
1052\&\f(CW\*(C`xrdb\*(C'\fR). I also have some resources in a separate \f(CW\*(C`.Xdefaults\-hostname\*(C'\fR 1060\&\f(CW\*(C`xrdb\*(C'\fR). I also have some resources in a separate \f(CW\*(C`.Xdefaults\-hostname\*(C'\fR
1053file for different hosts, for example, on ym main desktop, I use: 1061file for different hosts, for example, on ym main desktop, I use:
1054.PP 1062.PP
1055.Vb 5 1063.Vb 5
1056\& URxvt.keysym.C-M-q: command:\e033[3;5;5t 1064\& URxvt.keysym.C\-M\-q: command:\e033[3;5;5t
1057\& URxvt.keysym.C-M-y: command:\e033[3;5;606t 1065\& URxvt.keysym.C\-M\-y: command:\e033[3;5;606t
1058\& URxvt.keysym.C-M-e: command:\e033[3;1605;5t 1066\& URxvt.keysym.C\-M\-e: command:\e033[3;1605;5t
1059\& URxvt.keysym.C-M-c: command:\e033[3;1605;606t 1067\& URxvt.keysym.C\-M\-c: command:\e033[3;1605;606t
1060\& URxvt.keysym.C-M-p: perl:test 1068\& URxvt.keysym.C\-M\-p: perl:test
1061.Ve 1069.Ve
1062.PP 1070.PP
1063The first for keysym definitions allow me to quickly bring some windows 1071The first for keysym definitions allow me to quickly bring some windows
1064in the layout I like most. Ion users might start laughing but will stop 1072in the layout I like most. Ion users might start laughing but will stop
1065immediately when I tell them that I use my own Fvwm2 module for much the 1073immediately when I tell them that I use my own Fvwm2 module for much the
… …
1098The correct solution for this problem is to install the terminfo, this can 1106The correct solution for this problem is to install the terminfo, this can
1099be done like this (with ncurses' infocmp and works as user and admin): 1107be done like this (with ncurses' infocmp and works as user and admin):
1100.PP 1108.PP
1101.Vb 2 1109.Vb 2
1102\& REMOTE=remotesystem.domain 1110\& REMOTE=remotesystem.domain
1103\& infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" 1111\& infocmp rxvt\-unicode | ssh $REMOTE "mkdir \-p .terminfo && cat >/tmp/ti && tic /tmp/ti"
1104.Ve 1112.Ve
1105.PP 1113.PP
1106\&... or by installing rxvt-unicode normally on the remote system, 1114\&... or by installing rxvt-unicode normally on the remote system,
1107.PP 1115.PP
1108One some systems you might need to set \f(CW$TERMINFO\fR to the full path of 1116One some systems you might need to set \f(CW$TERMINFO\fR to the full path of
… …
1147You could use rxvt's termcap entry with reasonable results in many cases. 1155You could use rxvt's termcap entry with reasonable results in many cases.
1148You can also create a termcap entry by using terminfo's infocmp program 1156You can also create a termcap entry by using terminfo's infocmp program
1149like this: 1157like this:
1150.PP 1158.PP
1151.Vb 1 1159.Vb 1
1152\& infocmp -C rxvt-unicode 1160\& infocmp \-C rxvt\-unicode
1153.Ve 1161.Ve
1154.PP 1162.PP
1155Or you could use this termcap entry, generated by the command above: 1163Or you could use this termcap entry, generated by the command above:
1156.PP 1164.PP
1157.Vb 20 1165.Vb 20
1158\& rxvt-unicode|rxvt-unicode terminal (X Window System):\e 1166\& rxvt\-unicode|rxvt\-unicode terminal (X Window System):\e
1159\& :am:bw:eo:km:mi:ms:xn:xo:\e 1167\& :am:bw:eo:km:mi:ms:xn:xo:\e
1160\& :co#80:it#8:li#24:lm#0:\e 1168\& :co#80:it#8:li#24:lm#0:\e
1161\& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e 1169\& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e
1162\& :K1=\eEOw:K2=\eEOu:K3=\eEOy:K4=\eEOq:K5=\eEOs:LE=\eE[%dD:\e 1170\& :K1=\eEOw:K2=\eEOu:K3=\eEOy:K4=\eEOq:K5=\eEOs:LE=\eE[%dD:\e
1163\& :RI=\eE[%dC:SF=\eE[%dS:SR=\eE[%dT:UP=\eE[%dA:ae=\eE(B:al=\eE[L:\e 1171\& :RI=\eE[%dC:SF=\eE[%dS:SR=\eE[%dT:UP=\eE[%dA:ae=\eE(B:al=\eE[L:\e
… …
1184decide whether a terminal has colour, but uses its own configuration 1192decide whether a terminal has colour, but uses its own configuration
1185file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in its default file (among 1193file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in its default file (among
1186with most other terminals supporting colour). Either add: 1194with most other terminals supporting colour). Either add:
1187.PP 1195.PP
1188.Vb 1 1196.Vb 1
1189\& TERM rxvt-unicode 1197\& TERM rxvt\-unicode
1190.Ve 1198.Ve
1191.PP 1199.PP
1192to \f(CW\*(C`/etc/DIR_COLORS\*(C'\fR or simply add: 1200to \f(CW\*(C`/etc/DIR_COLORS\*(C'\fR or simply add:
1193.PP 1201.PP
1194.Vb 1 1202.Vb 1
1195\& alias ls='ls --color=auto' 1203\& alias ls='ls \-\-color=auto'
1196.Ve 1204.Ve
1197.PP 1205.PP
1198to your \f(CW\*(C`.profile\*(C'\fR or \f(CW\*(C`.bashrc\*(C'\fR. 1206to your \f(CW\*(C`.profile\*(C'\fR or \f(CW\*(C`.bashrc\*(C'\fR.
1199.PP 1207.PP
1200\fIWhy doesn't vim/emacs etc. use the 88 colour mode?\fR 1208\fIWhy doesn't vim/emacs etc. use the 88 colour mode?\fR
… …
1319(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which 1327(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which
1320first switches to a locale supported by xjdic and back later: 1328first switches to a locale supported by xjdic and back later:
1321.PP 1329.PP
1322.Vb 3 1330.Vb 3
1323\& printf '\e33]701;%s\e007' ja_JP.SJIS 1331\& printf '\e33]701;%s\e007' ja_JP.SJIS
1324\& xjdic -js 1332\& xjdic \-js
1325\& printf '\e33]701;%s\e007' de_DE.UTF-8 1333\& printf '\e33]701;%s\e007' de_DE.UTF\-8
1326.Ve 1334.Ve
1327.PP 1335.PP
1328You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except 1336You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except
1329for some locales where character width differs between program\- and 1337for some locales where character width differs between program\- and
1330rxvt\-unicode\-locales. 1338rxvt\-unicode\-locales.
… …
1352When you want to use e.g. \fBkinput2\fR, it must be set to 1360When you want to use e.g. \fBkinput2\fR, it must be set to
1353\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. You can see what input 1361\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. You can see what input
1354method servers are running with this command: 1362method servers are running with this command:
1355.Sp 1363.Sp
1356.Vb 1 1364.Vb 1
1357\& xprop -root XIM_SERVERS 1365\& xprop \-root XIM_SERVERS
1358.Ve 1366.Ve
1359.IP "*" 4 1367.IP "*" 4
1360.PP 1368.PP
1361\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR 1369\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR
1362.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?" 1370.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
1363.PP 1371.PP
1364You can specify separate locales for the input method and the rest of the 1372You can specify separate locales for the input method and the rest of the
1365terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: 1373terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
1366.PP 1374.PP
1367.Vb 1 1375.Vb 1
1368\& URxvt.imlocale: ja_JP.EUC-JP 1376\& URxvt.imlocale: ja_JP.EUC\-JP
1369.Ve 1377.Ve
1370.PP 1378.PP
1371Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still 1379Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still
1372use your input method. Please note, however, that, depending on your Xlib 1380use your input method. Please note, however, that, depending on your Xlib
1373version, you may not be able to input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a 1381version, you may not be able to input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a
… …
2174l l . 2182l l .
2175h Use Hilite Mouse Tracking. 2183h Use Hilite Mouse Tracking.
2176l No mouse reporting. 2184l No mouse reporting.
2177.TE 2185.TE
2178 2186
2187.ie n .IP "\fB\fB""Pm = 1002""\fB\fR (X11 XTerm)" 4
2188.el .IP "\fB\f(CBPm = 1002\fB\fR (X11 XTerm)" 4
2189.IX Item "Pm = 1002 (X11 XTerm)"
2190.TS
2191l l .
2192h Send Mouse X & Y on button press and release, and motion with a button pressed.
2193l No mouse reporting.
2194.TE
2195
2196.ie n .IP "\fB\fB""Pm = 1003""\fB\fR (X11 XTerm)" 4
2197.el .IP "\fB\f(CBPm = 1003\fB\fR (X11 XTerm)" 4
2198.IX Item "Pm = 1003 (X11 XTerm)"
2199.TS
2200l l .
2201h Send Mouse X & Y on button press and release, and motion.
2202l No mouse reporting.
2203.TE
2204
2179.ie n .IP "\fB\fB""Pm = 1010""\fB\fR (\fBrxvt\fR)" 4 2205.ie n .IP "\fB\fB""Pm = 1010""\fB\fR (\fBrxvt\fR)" 4
2180.el .IP "\fB\f(CBPm = 1010\fB\fR (\fBrxvt\fR)" 4 2206.el .IP "\fB\f(CBPm = 1010\fB\fR (\fBrxvt\fR)" 4
2181.IX Item "Pm = 1010 (rxvt)" 2207.IX Item "Pm = 1010 (rxvt)"
2182.TS 2208.TS
2183l l . 2209l l .
… …
2257Ps = 12 Change colour of text cursor foreground to Pt 2283Ps = 12 Change colour of text cursor foreground to Pt
2258Ps = 13 Change colour of mouse foreground to Pt 2284Ps = 13 Change colour of mouse foreground to Pt
2259Ps = 17 Change colour of highlight characters to Pt 2285Ps = 17 Change colour of highlight characters to Pt
2260Ps = 18 Change colour of bold characters to Pt [deprecated, see 706] 2286Ps = 18 Change colour of bold characters to Pt [deprecated, see 706]
2261Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707] 2287Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707]
2262Ps = 20 Change background pixmap parameters (see section XPM) (Compile XPM). 2288Ps = 20 Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage).
2263Ps = 39 Change default foreground colour to Pt. 2289Ps = 39 Change default foreground colour to Pt.
2264Ps = 46 Change Log File to Pt unimplemented 2290Ps = 46 Change Log File to Pt unimplemented
2265Ps = 49 Change default background colour to Pt. 2291Ps = 49 Change default background colour to Pt.
2266Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n 2292Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n
2267Ps = 55 Log all scrollback buffer and all of screen to Pt 2293Ps = 55 Log all scrollback buffer and all of screen to Pt
… …
2278Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 2304Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2279Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 2305Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
2280Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). 2306Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
2281.TE 2307.TE
2282 2308
2283.SH "XPM" 2309.SH "BACKGROUND IMAGE"
2284.IX Header "XPM" 2310.IX Header "BACKGROUND IMAGE"
2285For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value 2311For the \s-1BACGROUND\s0 \s-1IMAGE\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value
2286of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a 2312of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background image file followed by a
2287sequence of scaling/positioning commands separated by semi\-colons. The 2313sequence of scaling/positioning commands separated by semi\-colons. The
2288scaling/positioning commands are as follows: 2314scaling/positioning commands are as follows:
2289.IP "query scale/position" 4 2315.IP "query scale/position" 4
2290.IX Item "query scale/position" 2316.IX Item "query scale/position"
2291\&\fB?\fR 2317\&\fB?\fR
… …
2317\&\fBWx0\fR \-> \fBW *= (W/100)\fR 2343\&\fBWx0\fR \-> \fBW *= (W/100)\fR
2318.Sp 2344.Sp
2319\&\fB0xH\fR \-> \fBH *= (H/100)\fR 2345\&\fB0xH\fR \-> \fBH *= (H/100)\fR
2320.PP 2346.PP
2321For example: 2347For example:
2322.IP "\fB\eE]20;funky\ea\fR" 4 2348.IP "\fB\eE]20;funky.jpg\ea\fR" 4
2323.IX Item "E]20;funkya" 2349.IX Item "E]20;funky.jpga"
2324load \fBfunky.xpm\fR as a tiled image 2350load \fBfunky.jpg\fR as a tiled image
2325.IP "\fB\eE]20;mona;100\ea\fR" 4 2351.IP "\fB\eE]20;mona.jpg;100\ea\fR" 4
2326.IX Item "E]20;mona;100a" 2352.IX Item "E]20;mona.jpg;100a"
2327load \fBmona.xpm\fR with a scaling of 100% 2353load \fBmona.jpg\fR with a scaling of 100%
2328.IP "\fB\eE]20;;200;?\ea\fR" 4 2354.IP "\fB\eE]20;;200;?\ea\fR" 4
2329.IX Item "E]20;;200;?a" 2355.IX Item "E]20;;200;?a"
2330rescale the current pixmap to 200% and display the image geometry in 2356rescale the current pixmap to 200% and display the image geometry in
2331the title 2357the title
2332.SH "Mouse Reporting" 2358.SH "Mouse Reporting"
… …
2438 2464
2439.SH "CONFIGURE OPTIONS" 2465.SH "CONFIGURE OPTIONS"
2440.IX Header "CONFIGURE OPTIONS" 2466.IX Header "CONFIGURE OPTIONS"
2441General hint: if you get compile errors, then likely your configuration 2467General hint: if you get compile errors, then likely your configuration
2442hasn't been tested well. Either try with \f(CW\*(C`\-\-enable\-everything\*(C'\fR or use 2468hasn't been tested well. Either try with \f(CW\*(C`\-\-enable\-everything\*(C'\fR or use
2443the default configuration (i.e. \f(CW\*(C`\-\-enable\-xxx\*(C'\fR or \f(CW\*(C`\-\-disable\-xxx\*(C'\fR). Of 2469the default configuration (i.e. no \f(CW\*(C`\-\-enable\-xxx\*(C'\fR or \f(CW\*(C`\-\-disable\-xxx\*(C'\fR
2444course, you should always report when a combination doesn't work, so it 2470switches). Of course, you should always report when a combination doesn't
2445can be fixed. Marc Lehmann <rxvt@schmorp.de>. 2471work, so it can be fixed. Marc Lehmann <rxvt@schmorp.de>.
2446.PP 2472.PP
2447All 2473All
2448.IP "\-\-enable\-everything" 4 2474.IP "\-\-enable\-everything" 4
2449.IX Item "--enable-everything" 2475.IX Item "--enable-everything"
2450Add (or remove) support for all non-multichoice options listed in \*(L"./configure 2476Add (or remove) support for all non-multichoice options listed in \*(L"./configure
… …
2545.IP "\-\-enable\-lastlog (default: on)" 4 2571.IP "\-\-enable\-lastlog (default: on)" 4
2546.IX Item "--enable-lastlog (default: on)" 2572.IX Item "--enable-lastlog (default: on)"
2547Write user and tty to lastlog file (used by programs like 2573Write user and tty to lastlog file (used by programs like
2548\&\fIlastlogin\fR) at start of rxvt execution. This option requires 2574\&\fIlastlogin\fR) at start of rxvt execution. This option requires
2549\&\-\-enable\-utmp to also be specified. 2575\&\-\-enable\-utmp to also be specified.
2550.IP "\-\-enable\-xpm\-background (default: on)" 4
2551.IX Item "--enable-xpm-background (default: on)"
2552Add support for \s-1XPM\s0 background pixmaps.
2553.IP "\-\-enable\-afterimage (default: on)" 4 2576.IP "\-\-enable\-afterimage (default: on)" 4
2554.IX Item "--enable-afterimage (default: on)" 2577.IX Item "--enable-afterimage (default: on)"
2555Add support for libAfterImage to be used for transparency and background 2578Add support for libAfterImage to be used for transparency and background
2556images. It adds support for many file formats including \s-1JPG\s0, \s-1PNG\s0, 2579images. It adds support for many file formats including \s-1JPG\s0, \s-1PNG\s0,
2557\&\s-1SVG\s0, \s-1TIFF\s0, \s-1GIF\s0, \s-1XPM\s0, \s-1BMP\s0, \s-1ICO\s0, \s-1XCF\s0, \s-1TGA\s0 and AfterStep image \s-1XML\s0 2580\&\s-1SVG\s0, \s-1TIFF\s0, \s-1GIF\s0, \s-1XPM\s0, \s-1BMP\s0, \s-1ICO\s0, \s-1XCF\s0, \s-1TGA\s0 and AfterStep image \s-1XML\s0
… …
2569Add support for inheriting parent backgrounds thus giving a fake 2592Add support for inheriting parent backgrounds thus giving a fake
2570transparency to the term. 2593transparency to the term.
2571.IP "\-\-enable\-fading (default: on)" 4 2594.IP "\-\-enable\-fading (default: on)" 4
2572.IX Item "--enable-fading (default: on)" 2595.IX Item "--enable-fading (default: on)"
2573Add support for fading the text when focus is lost. 2596Add support for fading the text when focus is lost.
2574.IP "\-\-enable\-tinting (default: on)" 4
2575.IX Item "--enable-tinting (default: on)"
2576Add support for tinting of transparent backgrounds (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR).
2577.IP "\-\-enable\-rxvt\-scroll (default: on)" 4 2597.IP "\-\-enable\-rxvt\-scroll (default: on)" 4
2578.IX Item "--enable-rxvt-scroll (default: on)" 2598.IX Item "--enable-rxvt-scroll (default: on)"
2579Add support for the original rxvt scrollbar. 2599Add support for the original rxvt scrollbar.
2580.IP "\-\-enable\-next\-scroll (default: on)" 4 2600.IP "\-\-enable\-next\-scroll (default: on)" 4
2581.IX Item "--enable-next-scroll (default: on)" 2601.IX Item "--enable-next-scroll (default: on)"
… …
2613.Sp 2633.Sp
2614A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly 2634A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2615in combination with other switches) is: 2635in combination with other switches) is:
2616.Sp 2636.Sp
2617.Vb 17 2637.Vb 17
2618\& MWM-hints 2638\& MWM\-hints
2619\& EWMH-hints (pid, utf8 names) and protocols (ping) 2639\& EWMH\-hints (pid, utf8 names) and protocols (ping)
2620\& urgency hint 2640\& urgency hint
2621\& seperate underline colour (-underlineColor) 2641\& seperate underline colour (\-underlineColor)
2622\& settable border widths and borderless switch (-w, -b, -bl) 2642\& settable border widths and borderless switch (\-w, \-b, \-bl)
2623\& visual depth selection (-depth) 2643\& visual depth selection (\-depth)
2624\& settable extra linespacing /-lsp) 2644\& settable extra linespacing /\-lsp)
2625\& iso-14755 5.1 (basic) support 2645\& iso\-14755 5.1 (basic) support
2626\& tripleclickwords (-tcw) 2646\& tripleclickwords (\-tcw)
2627\& settable insecure mode (-insecure) 2647\& settable insecure mode (\-insecure)
2628\& keysym remapping support 2648\& keysym remapping support
2629\& cursor blinking and underline cursor (-cb, -uc) 2649\& cursor blinking and underline cursor (\-cb, \-uc)
2630\& XEmbed support (-embed) 2650\& XEmbed support (\-embed)
2631\& user-pty (-pty-fd) 2651\& user\-pty (\-pty\-fd)
2632\& hold on exit (-hold) 2652\& hold on exit (\-hold)
2633\& skip builtin block graphics (-sbg) 2653\& skip builtin block graphics (\-sbg)
2634\& separate highlightcolor support (-hc) 2654\& separate highlightcolor support (\-hc)
2635.Ve 2655.Ve
2636.Sp 2656.Sp
2637It also enables some non-essential features otherwise disabled, such as: 2657It also enables some non-essential features otherwise disabled, such as:
2638.Sp 2658.Sp
2639.Vb 11 2659.Vb 11
2640\& some round-trip time optimisations 2660\& some round\-trip time optimisations
2641\& nearest color allocation on pseudocolor screens 2661\& nearest color allocation on pseudocolor screens
2642\& UTF8_STRING support for selection 2662\& UTF8_STRING support for selection
2643\& sgr modes 90..97 and 100..107 2663\& sgr modes 90..97 and 100..107
2644\& backindex and forwardindex escape sequences 2664\& backindex and forwardindex escape sequences
2645\& view change/zero scrollback escape sequences 2665\& view change/zero scrollback escape sequences
… …
2705Change the environmental variable for the path to the terminfo tree to 2725Change the environmental variable for the path to the terminfo tree to
2706\&\s-1PATH\s0. 2726\&\s-1PATH\s0.
2707.IP "\-\-with\-x" 4 2727.IP "\-\-with\-x" 4
2708.IX Item "--with-x" 2728.IX Item "--with-x"
2709Use the X Window System (pretty much default, eh?). 2729Use the X Window System (pretty much default, eh?).
2710.IP "\-\-with\-xpm\-includes=DIR" 4
2711.IX Item "--with-xpm-includes=DIR"
2712Look for the \s-1XPM\s0 includes in \s-1DIR\s0.
2713.IP "\-\-with\-xpm\-library=DIR" 4
2714.IX Item "--with-xpm-library=DIR"
2715Look for the \s-1XPM\s0 library in \s-1DIR\s0.
2716.IP "\-\-with\-xpm" 4
2717.IX Item "--with-xpm"
2718Not needed \- define via \-\-enable\-xpm\-background.
2719.SH "AUTHORS" 2730.SH "AUTHORS"
2720.IX Header "AUTHORS" 2731.IX Header "AUTHORS"
2721Marc Lehmann <rxvt@schmorp.de> converted this document to pod and 2732Marc Lehmann <rxvt@schmorp.de> converted this document to pod and
2722reworked it from the original Rxvt documentation, which was done by Geoff 2733reworked it from the original Rxvt documentation, which was done by Geoff
2723Wing <gcw@pobox.com>, who in turn used the XTerm documentation and other 2734Wing <gcw@pobox.com>, who in turn used the XTerm documentation and other

Diff Legend

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