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.87 by sasha, Fri Oct 26 18:27:29 2007 UTC vs.
Revision 1.88 by root, Sat Oct 27 12:09:02 2007 UTC

1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3 1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.35
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-10-26" "8.3" "RXVT-UNICODE" 132.TH @@RXVT_NAME@@ 7 "2007-10-27" "8.4" "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"
379.PP 379.PP
3801. Use inheritPixmap: 3801. Use inheritPixmap:
381.PP 381.PP
382.Vb 2 382.Vb 2
383\& Esetroot wallpaper.jpg 383\& Esetroot wallpaper.jpg
384\& @@URXVT_NAME@@ \-ip \-tint red \-sh 40 384\& @@URXVT_NAME@@ -ip -tint red -sh 40
385.Ve 385.Ve
386.PP 386.PP
387That 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
388support, or you are unable to read. 388support, or you are unable to read.
389.PP 389.PP
3902. Use a simple pixmap and emulate pseudo\-transparency. This enables you 3902. Use a simple pixmap and emulate pseudo\-transparency. This enables you
391to use effects other than tinting and shading: Just shade/tint/whatever 391to use effects other than tinting and shading: Just shade/tint/whatever
392your picture with gimp or any other tool: 392your picture with gimp or any other tool:
393.PP 393.PP
394.Vb 2 394.Vb 2
395\& convert wallpaper.jpg \-blur 20x20 \-modulate 30 background.jpg 395\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
396\& @@URXVT_NAME@@ \-pixmap background.jpg \-pe automove\-background 396\& @@URXVT_NAME@@ -pixmap background.jpg -pe automove-background
397.Ve 397.Ve
398.PP 398.PP
399That works. If you think it doesn't, you lack AfterImage and Perl support, or you 399That works. If you think it doesn't, you lack AfterImage and Perl support, or you
400are unable to read. 400are unable to read.
401.PP 401.PP
4023. Use an \s-1ARGB\s0 visual: 4023. Use an \s-1ARGB\s0 visual:
403.PP 403.PP
404.Vb 1 404.Vb 1
405\& @@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
406.Ve 406.Ve
407.PP 407.PP
408This 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
409doesn'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
410there yet, no matter what they claim. Rxvt-Unicode contains the necessary 410there yet, no matter what they claim. Rxvt-Unicode contains the necessary
412doesn'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.
413.PP 413.PP
4144. Use xcompmgr and let it do the job: 4144. Use xcompmgr and let it do the job:
415.PP 415.PP
416.Vb 2 416.Vb 2
417\& xprop \-frame \-f _NET_WM_WINDOW_OPACITY 32c \e 417\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e
418\& \-set _NET_WM_WINDOW_OPACITY 0xc0000000 418\& -set _NET_WM_WINDOW_OPACITY 0xc0000000
419.Ve 419.Ve
420.PP 420.PP
421Then 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
422by 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
423your server crashes, you got to keep the pieces. 423your server crashes, you got to keep the pieces.
614.PP 614.PP
615In 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,
616e.g.: 616e.g.:
617.PP 617.PP
618.Vb 1 618.Vb 1
619\& @@URXVT_NAME@@ \-fn basefont,font2,font3... 619\& @@URXVT_NAME@@ -fn basefont,font2,font3...
620.Ve 620.Ve
621.PP 621.PP
622When 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
623font. 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
624next 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
657.IX Subsection "How can I make mplayer display video correctly?" 657.IX Subsection "How can I make mplayer display video correctly?"
658.PP 658.PP
659We are working on it, in the meantime, as a workaround, use something like: 659We are working on it, in the meantime, as a workaround, use something like:
660.PP 660.PP
661.Vb 1 661.Vb 1
662\& @@URXVT_NAME@@ \-b 600 \-geometry 20x1 \-e sh \-c 'mplayer \-wid $WINDOWID file...' 662\& @@URXVT_NAME@@ -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
663.Ve 663.Ve
664.Sh "Keyboard, Mouse & User Interaction" 664.Sh "Keyboard, Mouse & User Interaction"
665.IX Subsection "Keyboard, Mouse & User Interaction" 665.IX Subsection "Keyboard, Mouse & User Interaction"
666\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
667.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?"
668.PP 668.PP
669If 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
670setting: 670setting:
671.PP 671.PP
672.Vb 1 672.Vb 1
673\& URxvt.selection.pattern\-0: ([[:word:]]+) 673\& URxvt.selection.pattern-0: ([[:word:]]+)
674.Ve 674.Ve
675.PP 675.PP
676If you click more than twice, the selection will be extended 676If you click more than twice, the selection will be extended
677more and more. 677more and more.
678.PP 678.PP
679To 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:
680.PP 680.PP
681.Vb 1 681.Vb 1
682\& URxvt.selection.pattern\-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) 682\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+)
683.Ve 683.Ve
684.PP 684.PP
685Please also note that the \fILeftClick Shift-LeftClik\fR combination also 685Please also note that the \fILeftClick Shift-LeftClik\fR combination also
686selects words like the old code. 686selects words like the old code.
687.PP 687.PP
697\&\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
698example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify 698example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify
699this \fBperl-ext-common\fR resource: 699this \fBperl-ext-common\fR resource:
700.PP 700.PP
701.Vb 1 701.Vb 1
702\& URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup 702\& URxvt.perl-ext-common: default,-selection-popup,-option-popup
703.Ve 703.Ve
704.PP 704.PP
705This will keep the default extensions, but disable the two popup 705This will keep the default extensions, but disable the two popup
706extensions. Some extensions can also be configured, for example, 706extensions. Some extensions can also be configured, for example,
707scrollback 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
708other combination either by setting the \fBsearchable-scrollback\fR resource: 708other combination either by setting the \fBsearchable-scrollback\fR resource:
709.PP 709.PP
710.Vb 1 710.Vb 1
711\& URxvt.searchable\-scrollback: CM\-s 711\& URxvt.searchable-scrollback: CM-s
712.Ve 712.Ve
713.PP 713.PP
714\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
715.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?"
716.PP 716.PP
727.PP 727.PP
728You 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
729extension: 729extension:
730.PP 730.PP
731.Vb 1 731.Vb 1
732\& URxvt.perl\-ext\-common: default,\-readline 732\& URxvt.perl-ext-common: default,-readline
733.Ve 733.Ve
734.PP 734.PP
735\fIMy numerical keypad acts weird and generates differing output?\fR 735\fIMy numerical keypad acts weird and generates differing output?\fR
736.IX Subsection "My numerical keypad acts weird and generates differing output?" 736.IX Subsection "My numerical keypad acts weird and generates differing output?"
737.PP 737.PP
810For an existing rxvt\-unicode: 810For an existing rxvt\-unicode:
811.PP 811.PP
812.Vb 3 812.Vb 3
813\& # use Backspace = ^H 813\& # use Backspace = ^H
814\& $ stty erase ^H 814\& $ stty erase ^H
815\& $ echo \-n "^[[36h" 815\& $ echo -n "^[[36h"
816.Ve 816.Ve
817.PP 817.PP
818.Vb 3 818.Vb 3
819\& # use Backspace = ^? 819\& # use Backspace = ^?
820\& $ stty erase ^? 820\& $ stty erase ^?
821\& $ echo \-n "^[[36l" 821\& $ echo -n "^[[36l"
822.Ve 822.Ve
823.PP 823.PP
824This helps satisfy some of the Backspace discrepancies that occur, but 824This helps satisfy some of the Backspace discrepancies that occur, but
825if 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
826properly reflects that. 826properly reflects that.
848Here'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
849.PP 849.PP
850.Vb 20 850.Vb 20
851\& URxvt.keysym.Home: \e033[1~ 851\& URxvt.keysym.Home: \e033[1~
852\& URxvt.keysym.End: \e033[4~ 852\& URxvt.keysym.End: \e033[4~
853\& URxvt.keysym.C\-apostrophe: \e033<C\-'> 853\& URxvt.keysym.C-apostrophe: \e033<C-'>
854\& URxvt.keysym.C\-slash: \e033<C\-/> 854\& URxvt.keysym.C-slash: \e033<C-/>
855\& URxvt.keysym.C\-semicolon: \e033<C\-;> 855\& URxvt.keysym.C-semicolon: \e033<C-;>
856\& URxvt.keysym.C\-grave: \e033<C\-`> 856\& URxvt.keysym.C-grave: \e033<C-`>
857\& URxvt.keysym.C\-comma: \e033<C\-,> 857\& URxvt.keysym.C-comma: \e033<C-,>
858\& URxvt.keysym.C\-period: \e033<C\-.> 858\& URxvt.keysym.C-period: \e033<C-.>
859\& URxvt.keysym.C\-0x60: \e033<C\-`> 859\& URxvt.keysym.C-0x60: \e033<C-`>
860\& URxvt.keysym.C\-Tab: \e033<C\-Tab> 860\& URxvt.keysym.C-Tab: \e033<C-Tab>
861\& URxvt.keysym.C\-Return: \e033<C\-Return> 861\& URxvt.keysym.C-Return: \e033<C-Return>
862\& URxvt.keysym.S\-Return: \e033<S\-Return> 862\& URxvt.keysym.S-Return: \e033<S-Return>
863\& URxvt.keysym.S\-space: \e033<S\-Space> 863\& URxvt.keysym.S-space: \e033<S-Space>
864\& URxvt.keysym.M\-Up: \e033<M\-Up> 864\& URxvt.keysym.M-Up: \e033<M-Up>
865\& URxvt.keysym.M\-Down: \e033<M\-Down> 865\& URxvt.keysym.M-Down: \e033<M-Down>
866\& URxvt.keysym.M\-Left: \e033<M\-Left> 866\& URxvt.keysym.M-Left: \e033<M-Left>
867\& URxvt.keysym.M\-Right: \e033<M\-Right> 867\& URxvt.keysym.M-Right: \e033<M-Right>
868\& URxvt.keysym.M\-C\-0: list \e033<M\-C\- 0123456789 > 868\& URxvt.keysym.M-C-0: list \e033<M-C- 0123456789 >
869\& URxvt.keysym.M\-C\-a: list \e033<M\-C\- abcdefghijklmnopqrstuvwxyz > 869\& URxvt.keysym.M-C-a: list \e033<M-C- abcdefghijklmnopqrstuvwxyz >
870\& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007 870\& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007
871.Ve 871.Ve
872.PP 872.PP
873See some more examples in the documentation for the \fBkeysym\fR resource. 873See some more examples in the documentation for the \fBkeysym\fR resource.
874.PP 874.PP
900author'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
901not \fItypical\fR, but what's typical... 901not \fItypical\fR, but what's typical...
902.PP 902.PP
903.Vb 2 903.Vb 2
904\& URxvt.cutchars: "()*,<>[]{}|' 904\& URxvt.cutchars: "()*,<>[]{}|'
905\& URxvt.print\-pipe: cat >/tmp/xxx 905\& URxvt.print-pipe: cat >/tmp/xxx
906.Ve 906.Ve
907.PP 907.PP
908These are just for testing stuff. 908These are just for testing stuff.
909.PP 909.PP
910.Vb 2 910.Vb 2
911\& URxvt.imLocale: ja_JP.UTF\-8 911\& URxvt.imLocale: ja_JP.UTF-8
912\& URxvt.preeditType: OnTheSpot,None 912\& URxvt.preeditType: OnTheSpot,None
913.Ve 913.Ve
914.PP 914.PP
915This tells rxvt-unicode to use a special locale when communicating with 915This tells rxvt-unicode to use a special locale when communicating with
916the 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
917type, 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
918with correct-looking fonts. 918with correct-looking fonts.
919.PP 919.PP
920.Vb 6 920.Vb 6
921\& URxvt.perl\-lib: /root/lib/urxvt 921\& URxvt.perl-lib: /root/lib/urxvt
922\& 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
923\& URxvt.selection.pattern\-0: ( at .*? line \e\ed+) 923\& URxvt.selection.pattern-0: ( at .*? line \e\ed+)
924\& URxvt.selection.pattern\-1: ^(/[^:]+):\e 924\& URxvt.selection.pattern-1: ^(/[^:]+):\e
925\& 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/
926\& 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/
927.Ve 927.Ve
928.PP 928.PP
929This is my perl configuration. The first two set the perl library 929This is my perl configuration. The first two set the perl library
930directory 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
931develop 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
1008.PP 1008.PP
1009I once thought this is a great idea. 1009I once thought this is a great idea.
1010.PP 1010.PP
1011.Vb 9 1011.Vb 9
1012\& urxvt.font: 9x15bold,\e 1012\& urxvt.font: 9x15bold,\e
1013\& \-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
1014\& \-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
1015\& [codeset=JISX0208]xft:Kochi Gothic, \e 1015\& [codeset=JISX0208]xft:Kochi Gothic, \e
1016\& xft:Bitstream Vera Sans Mono:autohint=true, \e 1016\& xft:Bitstream Vera Sans Mono:autohint=true, \e
1017\& xft:Code2000:antialias=false 1017\& xft:Code2000:antialias=false
1018\& 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
1019\& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true 1019\& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
1020\& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true 1020\& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
1021.Ve 1021.Ve
1022.PP 1022.PP
1023I 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
1045\& IRC*saveLines: 0 1045\& IRC*saveLines: 0
1046\& IRC*mapAlert: true 1046\& IRC*mapAlert: true
1047\& IRC*font: suxuseuro 1047\& IRC*font: suxuseuro
1048\& IRC*boldFont: suxuseuro 1048\& IRC*boldFont: suxuseuro
1049\& IRC*colorBD: white 1049\& IRC*colorBD: white
1050\& 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
1051\& 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
1052.Ve 1052.Ve
1053.PP 1053.PP
1054\&\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
1055sizes. \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)
1056stuff while keeping a very small window. If somebody pastes something 1056stuff while keeping a very small window. If somebody pastes something
1059The 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
1060\&\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
1061file for different hosts, for example, on ym main desktop, I use: 1061file for different hosts, for example, on ym main desktop, I use:
1062.PP 1062.PP
1063.Vb 5 1063.Vb 5
1064\& URxvt.keysym.C\-M\-q: command:\e033[3;5;5t 1064\& URxvt.keysym.C-M-q: command:\e033[3;5;5t
1065\& URxvt.keysym.C\-M\-y: command:\e033[3;5;606t 1065\& URxvt.keysym.C-M-y: command:\e033[3;5;606t
1066\& URxvt.keysym.C\-M\-e: command:\e033[3;1605;5t 1066\& URxvt.keysym.C-M-e: command:\e033[3;1605;5t
1067\& URxvt.keysym.C\-M\-c: command:\e033[3;1605;606t 1067\& URxvt.keysym.C-M-c: command:\e033[3;1605;606t
1068\& URxvt.keysym.C\-M\-p: perl:test 1068\& URxvt.keysym.C-M-p: perl:test
1069.Ve 1069.Ve
1070.PP 1070.PP
1071The first for keysym definitions allow me to quickly bring some windows 1071The first for keysym definitions allow me to quickly bring some windows
1072in 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
1073immediately 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
1106The 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
1107be 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):
1108.PP 1108.PP
1109.Vb 2 1109.Vb 2
1110\& REMOTE=remotesystem.domain 1110\& REMOTE=remotesystem.domain
1111\& 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"
1112.Ve 1112.Ve
1113.PP 1113.PP
1114\&... or by installing rxvt-unicode normally on the remote system, 1114\&... or by installing rxvt-unicode normally on the remote system,
1115.PP 1115.PP
1116One 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
1155You 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.
1156You 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
1157like this: 1157like this:
1158.PP 1158.PP
1159.Vb 1 1159.Vb 1
1160\& infocmp \-C rxvt\-unicode 1160\& infocmp -C rxvt-unicode
1161.Ve 1161.Ve
1162.PP 1162.PP
1163Or you could use this termcap entry, generated by the command above: 1163Or you could use this termcap entry, generated by the command above:
1164.PP 1164.PP
1165.Vb 20 1165.Vb 20
1166\& rxvt\-unicode|rxvt\-unicode terminal (X Window System):\e 1166\& rxvt-unicode|rxvt-unicode terminal (X Window System):\e
1167\& :am:bw:eo:km:mi:ms:xn:xo:\e 1167\& :am:bw:eo:km:mi:ms:xn:xo:\e
1168\& :co#80:it#8:li#24:lm#0:\e 1168\& :co#80:it#8:li#24:lm#0:\e
1169\& :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
1170\& :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
1171\& :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
1192decide whether a terminal has colour, but uses its own configuration 1192decide whether a terminal has colour, but uses its own configuration
1193file. 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
1194with most other terminals supporting colour). Either add: 1194with most other terminals supporting colour). Either add:
1195.PP 1195.PP
1196.Vb 1 1196.Vb 1
1197\& TERM rxvt\-unicode 1197\& TERM rxvt-unicode
1198.Ve 1198.Ve
1199.PP 1199.PP
1200to \f(CW\*(C`/etc/DIR_COLORS\*(C'\fR or simply add: 1200to \f(CW\*(C`/etc/DIR_COLORS\*(C'\fR or simply add:
1201.PP 1201.PP
1202.Vb 1 1202.Vb 1
1203\& alias ls='ls \-\-color=auto' 1203\& alias ls='ls --color=auto'
1204.Ve 1204.Ve
1205.PP 1205.PP
1206to 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.
1207.PP 1207.PP
1208\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
1327(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
1328first switches to a locale supported by xjdic and back later: 1328first switches to a locale supported by xjdic and back later:
1329.PP 1329.PP
1330.Vb 3 1330.Vb 3
1331\& printf '\e33]701;%s\e007' ja_JP.SJIS 1331\& printf '\e33]701;%s\e007' ja_JP.SJIS
1332\& xjdic \-js 1332\& xjdic -js
1333\& printf '\e33]701;%s\e007' de_DE.UTF\-8 1333\& printf '\e33]701;%s\e007' de_DE.UTF-8
1334.Ve 1334.Ve
1335.PP 1335.PP
1336You 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
1337for some locales where character width differs between program\- and 1337for some locales where character width differs between program\- and
1338rxvt\-unicode\-locales. 1338rxvt\-unicode\-locales.
1360When 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
1361\&\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
1362method servers are running with this command: 1362method servers are running with this command:
1363.Sp 1363.Sp
1364.Vb 1 1364.Vb 1
1365\& xprop \-root XIM_SERVERS 1365\& xprop -root XIM_SERVERS
1366.Ve 1366.Ve
1367.IP "*" 4 1367.IP "*" 4
1368.PP 1368.PP
1369\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
1370.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?"
1371.PP 1371.PP
1372You 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
1373terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: 1373terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
1374.PP 1374.PP
1375.Vb 1 1375.Vb 1
1376\& URxvt.imlocale: ja_JP.EUC\-JP 1376\& URxvt.imlocale: ja_JP.EUC-JP
1377.Ve 1377.Ve
1378.PP 1378.PP
1379Now 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
1380use your input method. Please note, however, that, depending on your Xlib 1380use your input method. Please note, however, that, depending on your Xlib
1381version, 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
2633.Sp 2633.Sp
2634A 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
2635in combination with other switches) is: 2635in combination with other switches) is:
2636.Sp 2636.Sp
2637.Vb 17 2637.Vb 17
2638\& MWM\-hints 2638\& MWM-hints
2639\& EWMH\-hints (pid, utf8 names) and protocols (ping) 2639\& EWMH-hints (pid, utf8 names) and protocols (ping)
2640\& urgency hint 2640\& urgency hint
2641\& seperate underline colour (\-underlineColor) 2641\& seperate underline colour (-underlineColor)
2642\& settable border widths and borderless switch (\-w, \-b, \-bl) 2642\& settable border widths and borderless switch (-w, -b, -bl)
2643\& visual depth selection (\-depth) 2643\& visual depth selection (-depth)
2644\& settable extra linespacing /\-lsp) 2644\& settable extra linespacing /-lsp)
2645\& iso\-14755 5.1 (basic) support 2645\& iso-14755 5.1 (basic) support
2646\& tripleclickwords (\-tcw) 2646\& tripleclickwords (-tcw)
2647\& settable insecure mode (\-insecure) 2647\& settable insecure mode (-insecure)
2648\& keysym remapping support 2648\& keysym remapping support
2649\& cursor blinking and underline cursor (\-cb, \-uc) 2649\& cursor blinking and underline cursor (-cb, -uc)
2650\& XEmbed support (\-embed) 2650\& XEmbed support (-embed)
2651\& user\-pty (\-pty\-fd) 2651\& user-pty (-pty-fd)
2652\& hold on exit (\-hold) 2652\& hold on exit (-hold)
2653\& skip builtin block graphics (\-sbg) 2653\& skip builtin block graphics (-sbg)
2654\& separate highlightcolor support (\-hc) 2654\& separate highlightcolor support (-hc)
2655.Ve 2655.Ve
2656.Sp 2656.Sp
2657It also enables some non-essential features otherwise disabled, such as: 2657It also enables some non-essential features otherwise disabled, such as:
2658.Sp 2658.Sp
2659.Vb 11 2659.Vb 11
2660\& some round\-trip time optimisations 2660\& some round-trip time optimisations
2661\& nearest color allocation on pseudocolor screens 2661\& nearest color allocation on pseudocolor screens
2662\& UTF8_STRING support for selection 2662\& UTF8_STRING support for selection
2663\& sgr modes 90..97 and 100..107 2663\& sgr modes 90..97 and 100..107
2664\& backindex and forwardindex escape sequences 2664\& backindex and forwardindex escape sequences
2665\& view change/zero scrollback escape sequences 2665\& view change/zero scrollback escape sequences

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines