--- rxvt-unicode/doc/rxvt.7.man.in 2006/07/17 19:20:29 1.78 +++ rxvt-unicode/doc/rxvt.7.man.in 2006/11/02 17:37:47 1.80 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04) +.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "@@RXVT_NAME@@ 7" -.TH @@RXVT_NAME@@ 7 "2006-07-17" "7.8" "RXVT-UNICODE" +.TH @@RXVT_NAME@@ 7 "2006-11-02" "8.0" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -137,10 +137,14 @@ .Vb 2 \& # set a new font set \& printf '\e33]50;%s\e007' 9x15,xft:Kochi" Mincho" -\& -\& # change the locale and tell rxvt\-unicode about it -\& export LC_CTYPE=ja_JP.EUC\-JP; printf "\e33]701;$LC_CTYPE\e007" -\& +.Ve +.PP +.Vb 2 +\& # change the locale and tell rxvt-unicode about it +\& export LC_CTYPE=ja_JP.EUC-JP; printf "\e33]701;$LC_CTYPE\e007" +.Ve +.PP +.Vb 2 \& # set window title \& printf '\e33]2;%s\e007' "new window title" .Ve @@ -150,7 +154,7 @@ all escape sequences, and other background information. .PP The newest version of this document is also available on the World Wide Web at -. +. .SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" .IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" .Sh "Meta, Features & Commandline Issues" @@ -170,9 +174,11 @@ give you tabs: .PP .Vb 1 -\& @@URXVT_NAME@@ \-pe tabbed -\& -\& URxvt.perl\-ext\-common: default,tabbed +\& @@URXVT_NAME@@ -pe tabbed +.Ve +.PP +.Vb 1 +\& URxvt.perl-ext-common: default,tabbed .Ve .PP It will also work fine with tabbing functionality of many window managers @@ -220,8 +226,8 @@ .Vb 6 \& #!/bin/sh \& @@URXVT_NAME@@c "$@" -\& if [ $? \-eq 2 ]; then -\& @@URXVT_NAME@@d \-q \-o \-f +\& if [ $? -eq 2 ]; then +\& @@URXVT_NAME@@d -q -o -f \& @@URXVT_NAME@@c "$@" \& fi .Ve @@ -231,8 +237,8 @@ re-run the command. Subsequent invocations of the script will re-use the existing daemon. .PP -\fIHow do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR -.IX Subsection "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc." +\fIHow do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR +.IX Subsection "How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc." .PP The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", so you can check and see if that is set. Note that several programs, \s-1JED\s0, @@ -254,14 +260,14 @@ .PP .Vb 12 \& # Bourne/Korn/POSIX family of shells: -\& [ ${TERM:\-foo} = foo ] && TERM=xterm # assume an xterm if we don't know -\& if [ ${TERM:\-foo} = xterm ]; then -\& stty \-icanon \-echo min 0 time 15 # see if enhanced rxvt or not -\& echo \-n '^[Z' +\& [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know +\& if [ ${TERM:-foo} = xterm ]; then +\& stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not +\& echo -n '^[Z' \& read term_id \& stty icanon echo -\& if [ ""${term_id} = '^[[?1;2C' \-a ${DISPLAY:\-foo} = foo ]; then -\& echo \-n '^[[7n' # query the rxvt we are in for the DISPLAY string +\& if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then +\& echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string \& read DISPLAY # set it in our local shell \& fi \& fi @@ -287,18 +293,18 @@ .PP .Vb 3 \& text data bss drs rss filename -\& 98398 1664 24 15695 1824 rxvt \-\-disable\-everything -\& 188985 9048 66616 18222 1788 urxvt \-\-disable\-everything +\& 98398 1664 24 15695 1824 rxvt --disable-everything +\& 188985 9048 66616 18222 1788 urxvt --disable-everything .Ve .PP When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft and full locale/XIM support which are quite bloaty inside libX11 and my -libc), the two diverge, but not unreasnobaly so. +libc), the two diverge, but not unreasonably so. .PP .Vb 3 \& text data bss drs rss filename -\& 163431 2152 24 20123 2060 rxvt \-\-enable\-everything -\& 1035683 49680 66648 29096 3680 urxvt \-\-enable\-everything +\& 163431 2152 24 20123 2060 rxvt --enable-everything +\& 1035683 49680 66648 29096 3680 urxvt --enable-everything .Ve .PP The very large size of the text section is explained by the east-asian @@ -344,7 +350,7 @@ \& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) \& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) \& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) -\& /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000) +\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) .Ve .PP And here is rxvt\-unicode: @@ -354,7 +360,7 @@ \& libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) \& libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) \& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) -\& /lib64/ld\-linux\-x86\-64.so.2 (0x00002aaaaaaab000) +\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) .Ve .PP No large bloated libraries (of course, none were linked in statically), @@ -376,7 +382,7 @@ .PP .Vb 2 \& Esetroot wallpaper.jpg -\& @@URXVT_NAME@@ \-ip \-tint red \-sh 40 +\& @@URXVT_NAME@@ -ip -tint red -sh 40 .Ve .PP That works. If you think it doesn't, you lack transparency and tinting @@ -387,8 +393,8 @@ your picture with gimp or any other tool: .PP .Vb 2 -\& convert wallpaper.jpg \-blur 20x20 \-modulate 30 background.xpm -\& @@URXVT_NAME@@ \-pixmap background.xpm \-pe automove\-background +\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm +\& @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background .Ve .PP That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you @@ -397,20 +403,20 @@ 3. Use an \s-1ARGB\s0 visual: .PP .Vb 1 -\& @@URXVT_NAME@@ \-depth 32 \-fg grey90 \-bg rgba:0000/0000/4444/cccc +\& @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc .Ve .PP This requires \s-1XFT\s0 support, and the support of your X\-server. If that doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't -there yet, no matter what they claim. Rxvt-Unicode contains the neccessary +there yet, no matter what they claim. Rxvt-Unicode contains the necessary bugfixes and workarounds for Xft and Xlib to make it work, but that doesn't mean that your \s-1WM\s0 has the required kludges in place. .PP 4. Use xcompmgr and let it do the job: .PP .Vb 2 -\& xprop \-frame \-f _NET_WM_WINDOW_OPACITY 32c \e -\& \-set _NET_WM_WINDOW_OPACITY 0xc0000000 +\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e +\& -set _NET_WM_WINDOW_OPACITY 0xc0000000 .Ve .PP Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR @@ -432,7 +438,7 @@ ask for the character bounding box, which unfortunately is wrong in these cases). .PP -It's not clear (to me at least), wether this is a bug in Xft, freetype, +It's not clear (to me at least), whether this is a bug in Xft, freetype, or the respective font. If you encounter this problem you might try using the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you might be forced to use a different font. @@ -549,7 +555,9 @@ \& URxvt.color5: #A800A8 \& URxvt.color6: #00A8A8 \& URxvt.color7: #A8A8A8 -\& +.Ve +.PP +.Vb 8 \& URxvt.color8: #000054 \& URxvt.color9: #FF0054 \& URxvt.color10: #00FF54 @@ -562,7 +570,7 @@ .PP And here is a more complete set of non-standard colors. .PP -.Vb 10 +.Vb 18 \& URxvt.cursorColor: #dc74d1 \& URxvt.pointerColor: #dc74d1 \& URxvt.background: #0e0e0e @@ -609,7 +617,7 @@ e.g.: .PP .Vb 1 -\& @@URXVT_NAME@@ \-fn basefont,font2,font3... +\& @@URXVT_NAME@@ -fn basefont,font2,font3... .Ve .PP When rxvt-unicode sees a character, it will first look at the base @@ -644,8 +652,7 @@ fonts for the same character at the same time, but no interface for this has been designed yet). .PP -Until then, you might get away with switching fonts at runtime (see \*(L"Can -I switch the fonts at runtime?\*(R" later in this document). +Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document). .Sh "Keyboard, Mouse & User Interaction" .IX Subsection "Keyboard, Mouse & User Interaction" \fIThe new selection selects pieces that are too big, how can I select single words?\fR @@ -655,7 +662,7 @@ setting: .PP .Vb 1 -\& URxvt.selection.pattern\-0: ([[:word:]]+) +\& URxvt.selection.pattern-0: ([[:word:]]+) .Ve .PP If you click more than twice, the selection will be extended @@ -664,7 +671,7 @@ To get a selection that is very similar to the old code, try this pattern: .PP .Vb 1 -\& URxvt.selection.pattern\-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) +\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) .Ve .PP Please also note that the \fILeftClick Shift-LeftClik\fR combination also @@ -684,7 +691,7 @@ this \fBperl-ext-common\fR resource: .PP .Vb 1 -\& URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup +\& URxvt.perl-ext-common: default,-selection-popup,-option-popup .Ve .PP This will keep the default extensions, but disable the two popup @@ -693,7 +700,7 @@ other combination either by setting the \fBsearchable-scrollback\fR resource: .PP .Vb 1 -\& URxvt.searchable\-scrollback: CM\-s +\& URxvt.searchable-scrollback: CM-s .Ve .PP \fIThe cursor moves when selecting text in the current input line, how do I switch this off?\fR @@ -710,11 +717,11 @@ but when running a program that doesn't parse cursor movements or in some cases during rlogin sessions, it fails to detect this properly. .PP -You can permamently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR +You can permanently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR extension: .PP .Vb 1 -\& URxvt.perl\-ext\-common: default,\-readline +\& URxvt.perl-ext-common: default,-readline .Ve .PP \fIMy numerical keypad acts weird and generates differing output?\fR @@ -722,7 +729,7 @@ .PP Some Debian GNUL/Linux users seem to have this problem, although no specific details were reported so far. It is possible that this is caused -by the wrong \f(CW\*(C`TERM\*(C'\fR setting, although the details of wether and how +by the wrong \f(CW\*(C`TERM\*(C'\fR setting, although the details of whether and how this can happen are unknown, as \f(CW\*(C`TERM=rxvt\*(C'\fR should offer a compatible keymap. See the answer to the previous question, and please report if that helped. @@ -762,7 +769,7 @@ .IX Subsection "What's with the strange Backspace/Delete key behaviour?" .PP Assuming that the physical Backspace key corresponds to the -BackSpace keysym (not likely for Linux ... see the following +Backspace keysym (not likely for Linux ... see the following question) there are two standard values that can be used for Backspace: \f(CW\*(C`^H\*(C'\fR and \f(CW\*(C`^?\*(C'\fR. .PP @@ -782,7 +789,9 @@ \& # use Backspace = ^H \& $ stty erase ^H \& $ @@URXVT_NAME@@ -\& +.Ve +.PP +.Vb 3 \& # use Backspace = ^? \& $ stty erase ^? \& $ @@URXVT_NAME@@ @@ -795,11 +804,13 @@ .Vb 3 \& # use Backspace = ^H \& $ stty erase ^H -\& $ echo \-n "^[[36h" -\& +\& $ echo -n "^[[36h" +.Ve +.PP +.Vb 3 \& # use Backspace = ^? \& $ stty erase ^? -\& $ echo \-n "^[[36l" +\& $ echo -n "^[[36l" .Ve .PP This helps satisfy some of the Backspace discrepancies that occur, but @@ -828,26 +839,26 @@ .PP Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR .PP -.Vb 10 +.Vb 20 \& URxvt.keysym.Home: \e033[1~ \& URxvt.keysym.End: \e033[4~ -\& URxvt.keysym.C\-apostrophe: \e033 -\& URxvt.keysym.C\-slash: \e033 -\& URxvt.keysym.C\-semicolon: \e033 -\& URxvt.keysym.C\-grave: \e033 -\& URxvt.keysym.C\-comma: \e033 -\& URxvt.keysym.C\-period: \e033 -\& URxvt.keysym.C\-0x60: \e033 -\& URxvt.keysym.C\-Tab: \e033 -\& URxvt.keysym.C\-Return: \e033 -\& URxvt.keysym.S\-Return: \e033 -\& URxvt.keysym.S\-space: \e033 -\& URxvt.keysym.M\-Up: \e033 -\& URxvt.keysym.M\-Down: \e033 -\& URxvt.keysym.M\-Left: \e033 -\& URxvt.keysym.M\-Right: \e033 -\& URxvt.keysym.M\-C\-0: list \e033 -\& URxvt.keysym.M\-C\-a: list \e033 +\& URxvt.keysym.C-apostrophe: \e033 +\& URxvt.keysym.C-slash: \e033 +\& URxvt.keysym.C-semicolon: \e033 +\& URxvt.keysym.C-grave: \e033 +\& URxvt.keysym.C-comma: \e033 +\& URxvt.keysym.C-period: \e033 +\& URxvt.keysym.C-0x60: \e033 +\& URxvt.keysym.C-Tab: \e033 +\& URxvt.keysym.C-Return: \e033 +\& URxvt.keysym.S-Return: \e033 +\& URxvt.keysym.S-space: \e033 +\& URxvt.keysym.M-Up: \e033 +\& URxvt.keysym.M-Down: \e033 +\& URxvt.keysym.M-Left: \e033 +\& URxvt.keysym.M-Right: \e033 +\& URxvt.keysym.M-C-0: list \e033 +\& URxvt.keysym.M-C-a: list \e033 \& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007 .Ve .PP @@ -883,13 +894,13 @@ .PP .Vb 2 \& URxvt.cutchars: "()*,<>[]{}|' -\& URxvt.print\-pipe: cat >/tmp/xxx +\& URxvt.print-pipe: cat >/tmp/xxx .Ve .PP These are just for testing stuff. .PP .Vb 2 -\& URxvt.imLocale: ja_JP.UTF\-8 +\& URxvt.imLocale: ja_JP.UTF-8 \& URxvt.preeditType: OnTheSpot,None .Ve .PP @@ -899,12 +910,12 @@ with correct-looking fonts. .PP .Vb 6 -\& URxvt.perl\-lib: /root/lib/urxvt -\& URxvt.perl\-ext\-common: default,selection\-autotransform,selection\-pastebin,xim\-onthespot,remote\-clipboard -\& URxvt.selection.pattern\-0: ( at .*? line \e\ed+) -\& URxvt.selection.pattern\-1: ^(/[^:]+):\e -\& URxvt.selection\-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ -\& URxvt.selection\-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ +\& URxvt.perl-lib: /root/lib/urxvt +\& URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard +\& URxvt.selection.pattern-0: ( at .*? line \e\ed+) +\& URxvt.selection.pattern-1: ^(/[^:]+):\e +\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ +\& URxvt.selection-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/ .Ve .PP This is my perl configuration. The first two set the perl library @@ -913,7 +924,7 @@ write. .PP The selection stuff mainly makes the selection perl-error-message aware -and tells it to convert pelr error mssages into vi-commands to load the +and tells it to convert perl error messages into vi-commands to load the relevant file and go tot he error line number. .PP .Vb 2 @@ -922,8 +933,8 @@ .Ve .PP As the documentation says: plain is the preferred scrollbar for the -author. The \f(CW\*(C`secondaryScroll\*(C'\fR confgiures urxvt to scroll in full-screen -apps, like screen, so lines scorlled out of screen end up in urxvt's +author. The \f(CW\*(C`secondaryScroll\*(C'\fR configures urxvt to scroll in full-screen +apps, like screen, so lines scrolled out of screen end up in urxvt's scrollback buffer. .PP .Vb 7 @@ -991,23 +1002,23 @@ .PP .Vb 9 \& urxvt.font: 9x15bold,\e -\& \-misc\-fixed\-bold\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1,\e -\& \-misc\-fixed\-medium\-r\-normal\-\-15\-140\-75\-75\-c\-90\-iso10646\-1, \e +\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e +\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e \& [codeset=JISX0208]xft:Kochi Gothic, \e \& xft:Bitstream Vera Sans Mono:autohint=true, \e \& xft:Code2000:antialias=false -\& urxvt.boldFont: \-xos4\-terminus\-bold\-r\-normal\-\-14\-140\-72\-72\-c\-80\-iso8859\-15 +\& urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15 \& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true \& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true .Ve .PP I wrote rxvt-unicode to be able to specify fonts exactly. So don't be -overwhelmed. A special note: the \f(CW\*(C`9x15bold\*(C'\fR mentioend above is actually +overwhelmed. A special note: the \f(CW\*(C`9x15bold\*(C'\fR mentioned above is actually the version from XFree\-3.3, as XFree\-4 replaced it by a totally different font (different glyphs for \f(CW\*(C`;\*(C'\fR and many other harmless characters), while the second font is actually the \f(CW\*(C`9x15bold\*(C'\fR from XFree4/XOrg. The bold version has less chars than the medium version, so I use it for rare -characters, too. Whene ditign sources with vim, I use italic for comments +characters, too. When editing sources with vim, I use italic for comments and other stuff, which looks quite good with Bitstream Vera anti\-aliased. .PP Terminus is a quite bad font (many very wrong glyphs), but for most of my @@ -1028,8 +1039,8 @@ \& IRC*font: suxuseuro \& IRC*boldFont: suxuseuro \& IRC*colorBD: white -\& IRC*keysym.M\-C\-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 -\& IRC*keysym.M\-C\-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 +\& IRC*keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007 +\& IRC*keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007 .Ve .PP \&\f(CW\*(C`Alt\-Shift\-1\*(C'\fR and \f(CW\*(C`Alt\-Shift\-2\*(C'\fR switch between two different font @@ -1042,11 +1053,11 @@ file for different hosts, for example, on ym main desktop, I use: .PP .Vb 5 -\& URxvt.keysym.C\-M\-q: command:\e033[3;5;5t -\& URxvt.keysym.C\-M\-y: command:\e033[3;5;606t -\& URxvt.keysym.C\-M\-e: command:\e033[3;1605;5t -\& URxvt.keysym.C\-M\-c: command:\e033[3;1605;606t -\& URxvt.keysym.C\-M\-p: perl:test +\& URxvt.keysym.C-M-q: command:\e033[3;5;5t +\& URxvt.keysym.C-M-y: command:\e033[3;5;606t +\& URxvt.keysym.C-M-e: command:\e033[3;1605;5t +\& URxvt.keysym.C-M-c: command:\e033[3;1605;606t +\& URxvt.keysym.C-M-p: perl:test .Ve .PP The first for keysym definitions allow me to quickly bring some windows @@ -1062,9 +1073,9 @@ applications. Most importantly, this means that if you or your \s-1OS\s0 loads resources into the X display (the right way to do it), rxvt-unicode will ignore any resource files in your home directory. It will only read -\&\fI\f(CI$HOME\fI/.Xdefaults\fR when no resources are attached to the display. +\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display. .PP -If you have or use an \fI\f(CI$HOME\fI/.Xresources\fR file, chances are that +If you have or use an \fI$HOME/.Xresources\fR file, chances are that resources are loaded into your X\-server. In this case, you have to re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR). .PP @@ -1075,7 +1086,7 @@ .Ve .PP If you want to use another form (there are lots of different ways of -specifying resources), make sure you understand wether and why it +specifying resources), make sure you understand whether and why it works. If unsure, use the form above. .PP \fIWhen I log-in to another system it tells me about missing terminfo data?\fR @@ -1085,15 +1096,18 @@ as that for xterm, or even rxvt (for which the same problem often arises). .PP The correct solution for this problem is to install the terminfo, this can -be done like this (with ncurses' infocmp): +be done like this (with ncurses' infocmp and works as user and admin): .PP .Vb 2 \& REMOTE=remotesystem.domain -\& infocmp rxvt\-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti" +\& infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti" .Ve .PP \&... or by installing rxvt-unicode normally on the remote system, .PP +One some systems you might need to set \f(CW$TERMINFO\fR to the full path of +\&\fI$HOME/.terminfo\fR for this to work. +.PP If you cannot or do not want to do this, then you can simply set \&\f(CW\*(C`TERM=rxvt\*(C'\fR or even \f(CW\*(C`TERM=xterm\*(C'\fR, and live with the small number of problems arising, which includes wrong keymapping, less and different @@ -1130,18 +1144,18 @@ library (Fedora Core's bash is one example) and rely on a termcap entry for \f(CW\*(C`rxvt\-unicode\*(C'\fR. .PP -You could use rxvt's termcap entry with resonable results in many cases. +You could use rxvt's termcap entry with reasonable results in many cases. You can also create a termcap entry by using terminfo's infocmp program like this: .PP .Vb 1 -\& infocmp \-C rxvt\-unicode +\& infocmp -C rxvt-unicode .Ve .PP Or you could use this termcap entry, generated by the command above: .PP -.Vb 10 -\& rxvt\-unicode|rxvt\-unicode terminal (X Window System):\e +.Vb 20 +\& rxvt-unicode|rxvt-unicode terminal (X Window System):\e \& :am:bw:eo:km:mi:ms:xn:xo:\e \& :co#80:it#8:li#24:lm#0:\e \& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e @@ -1167,18 +1181,18 @@ .IX Subsection "Why does ls no longer have coloured output?" .PP The \f(CW\*(C`ls\*(C'\fR in the \s-1GNU\s0 coreutils unfortunately doesn't use terminfo to -decide wether a terminal has colour, but uses its own configuration +decide whether a terminal has colour, but uses its own configuration file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in its default file (among with most other terminals supporting colour). Either add: .PP .Vb 1 -\& TERM rxvt\-unicode +\& TERM rxvt-unicode .Ve .PP to \f(CW\*(C`/etc/DIR_COLORS\*(C'\fR or simply add: .PP .Vb 1 -\& alias ls='ls \-\-color=auto' +\& alias ls='ls --color=auto' .Ve .PP to your \f(CW\*(C`.profile\*(C'\fR or \f(CW\*(C`.bashrc\*(C'\fR. @@ -1306,8 +1320,8 @@ .PP .Vb 3 \& printf '\e33]701;%s\e007' ja_JP.SJIS -\& xjdic \-js -\& printf '\e33]701;%s\e007' de_DE.UTF\-8 +\& xjdic -js +\& printf '\e33]701;%s\e007' de_DE.UTF-8 .Ve .PP You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except @@ -1335,13 +1349,13 @@ .IX Item "- Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode." .PD When you want to use e.g. \fBkinput2\fR, it must be set to -\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. Youc an see what input +\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. You can see what input method servers are running with this command: .Sp .Vb 1 -\& xprop \-root XIM_SERVERS +\& xprop -root XIM_SERVERS .Ve -.IP "" 4 +.IP "*" 4 .PP \fIMy input method wants but I want \s-1UTF\-8\s0, what can I do?\fR .IX Subsection "My input method wants but I want UTF-8, what can I do?" @@ -1350,7 +1364,7 @@ terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: .PP .Vb 1 -\& URxvt.imlocale: ja_JP.EUC\-JP +\& URxvt.imlocale: ja_JP.EUC-JP .Ve .PP Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still @@ -1393,7 +1407,7 @@ .PP You should build one binary with the default options. \fIconfigure\fR now enables most useful options, and the trend goes to making them -runtime\-switchable, too, so there is usually no drawback to enbaling them, +runtime\-switchable, too, so there is usually no drawback to enabling them, except higher disk and possibly memory usage. The perl interpreter should be enabled, as important functionality (menus, selection, likely more in the future) depends on it. @@ -1443,10 +1457,10 @@ .PP Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined in your compile environment, or an implementation that implements it, -wether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that +whether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that \&\fBwchar_t\fR is represented as unicode. .PP -As you might have guessed, FreeBSD does neither define this symobl nor +As you might have guessed, FreeBSD does neither define this symbol nor does it support it. Instead, it uses its own internal representation of \&\fBwchar_t\fR. This is, of course, completely fine with respect to standards. .PP @@ -1669,6 +1683,7 @@ C = C Finnish character set unimplemented C = K German character set unimplemented .TE + .PP .IX Xref "CSI" @@ -1727,6 +1742,7 @@ Ps = 1 Clear Above Ps = 2 Clear All .TE + .ie n .IP "\fB\fB""ESC [ Ps K""\fB\fR" 4 .el .IP "\fB\f(CBESC [ Ps K\fB\fR" 4 .IX Item "ESC [ Ps K" @@ -1737,6 +1753,7 @@ Ps = 1 Clear to Left Ps = 2 Clear All .TE + .ie n .IP "\fB\fB""ESC [ Ps L""\fB\fR" 4 .el .IP "\fB\f(CBESC [ Ps L\fB\fR" 4 .IX Item "ESC [ Ps L" @@ -1764,6 +1781,7 @@ Ps = 2 Tab Clear (TBC), Clear Current Column (default) Ps = 5 Tab Clear (TBC), Clear All .TE + .ie n .IP "\fB\fB""ESC [ Ps X""\fB\fR" 4 .el .IP "\fB\f(CBESC [ Ps X\fB\fR" 4 .IX Item "ESC [ Ps X" @@ -1808,6 +1826,7 @@ Ps = 0 Clear Current Column (default) Ps = 3 Clear All (TBC) .TE + .ie n .IP "\fB\fB""ESC [ Pm h""\fB\fR" 4 .el .IP "\fB\f(CBESC [ Pm h\fB\fR" 4 .IX Item "ESC [ Pm h" @@ -1822,6 +1841,7 @@ Ps = 4 disable transparent print mode (MC4) Ps = 5 enable transparent print mode (MC5) .TE + .ie n .IP "\fB\fB""ESC [ Pm l""\fB\fR" 4 .el .IP "\fB\f(CBESC [ Pm l\fB\fR" 4 .IX Item "ESC [ Pm l" @@ -1835,6 +1855,7 @@ h Insert Mode (SMIR) l Replace Mode (RMIR) .TE + .PD 0 .ie n .IP "\fB\fB""Ps = 20""\fB\fR (partially implemented)" 4 .el .IP "\fB\f(CBPs = 20\fB\fR (partially implemented)" 4 @@ -1844,6 +1865,7 @@ h Automatic Newline (LNM) l Normal Linefeed (LNM) .TE + .RE .RS 4 .RE @@ -1882,6 +1904,7 @@ Ps = 97 / 107 fg/bg Bright White Ps = 99 / 109 fg/bg Bright Default .TE + .ie n .IP "\fB\fB""ESC [ Ps n""\fB\fR" 4 .el .IP "\fB\f(CBESC [ Ps n\fB\fR" 4 .IX Item "ESC [ Ps n" @@ -1893,6 +1916,7 @@ Ps = 7 Request Display Name Ps = 8 Request Version Number (place in window title) .TE + .ie n .IP "\fB\fB""ESC [ Ps;Ps r""\fB\fR" 4 .el .IP "\fB\f(CBESC [ Ps;Ps r\fB\fR" 4 .IX Item "ESC [ Ps;Ps r" @@ -1925,6 +1949,7 @@ Ps = 21 Reports window title (ESC ] l NAME \234) Ps = 24.. Set window height to Ps rows .TE + .ie n .IP "\fB\fB""ESC [ u""\fB\fR" 4 .el .IP "\fB\f(CBESC [ u\fB\fR" 4 .IX Item "ESC [ u" @@ -1967,6 +1992,7 @@ h Application Cursor Keys l Normal Cursor Keys .TE + .PD 0 .ie n .IP "\fB\fB""Pm = 2""\fB\fR (\s-1ANSI/VT52\s0 mode)" 4 .el .IP "\fB\f(CBPm = 2\fB\fR (\s-1ANSI/VT52\s0 mode)" 4 @@ -1976,6 +2002,7 @@ h Enter VT52 mode l Enter VT52 mode .TE + .ie n .IP "\fB\fB""Pm = 3""\fB\fR" 4 .el .IP "\fB\f(CBPm = 3\fB\fR" 4 .IX Item "Pm = 3" @@ -1984,6 +2011,7 @@ h 132 Column Mode (DECCOLM) l 80 Column Mode (DECCOLM) .TE + .ie n .IP "\fB\fB""Pm = 4""\fB\fR" 4 .el .IP "\fB\f(CBPm = 4\fB\fR" 4 .IX Item "Pm = 4" @@ -1992,6 +2020,7 @@ h Smooth (Slow) Scroll (DECSCLM) l Jump (Fast) Scroll (DECSCLM) .TE + .ie n .IP "\fB\fB""Pm = 5""\fB\fR" 4 .el .IP "\fB\f(CBPm = 5\fB\fR" 4 .IX Item "Pm = 5" @@ -2000,6 +2029,7 @@ h Reverse Video (DECSCNM) l Normal Video (DECSCNM) .TE + .ie n .IP "\fB\fB""Pm = 6""\fB\fR" 4 .el .IP "\fB\f(CBPm = 6\fB\fR" 4 .IX Item "Pm = 6" @@ -2008,6 +2038,7 @@ h Origin Mode (DECOM) l Normal Cursor Mode (DECOM) .TE + .ie n .IP "\fB\fB""Pm = 7""\fB\fR" 4 .el .IP "\fB\f(CBPm = 7\fB\fR" 4 .IX Item "Pm = 7" @@ -2016,6 +2047,7 @@ h Wraparound Mode (DECAWM) l No Wraparound Mode (DECAWM) .TE + .ie n .IP "\fB\fB""Pm = 8""\fB\fR \fIunimplemented\fR" 4 .el .IP "\fB\f(CBPm = 8\fB\fR \fIunimplemented\fR" 4 .IX Item "Pm = 8 unimplemented" @@ -2024,6 +2056,7 @@ h Auto-repeat Keys (DECARM) l No Auto-repeat Keys (DECARM) .TE + .ie n .IP "\fB\fB""Pm = 9""\fB\fR X10 XTerm" 4 .el .IP "\fB\f(CBPm = 9\fB\fR X10 XTerm" 4 .IX Item "Pm = 9 X10 XTerm" @@ -2032,6 +2065,7 @@ h Send Mouse X & Y on button press. l No mouse reporting. .TE + .ie n .IP "\fB\fB""Pm = 25""\fB\fR" 4 .el .IP "\fB\f(CBPm = 25\fB\fR" 4 .IX Item "Pm = 25" @@ -2040,6 +2074,7 @@ h Visible cursor {cnorm/cvvis} l Invisible cursor {civis} .TE + .ie n .IP "\fB\fB""Pm = 30""\fB\fR" 4 .el .IP "\fB\f(CBPm = 30\fB\fR" 4 .IX Item "Pm = 30" @@ -2048,6 +2083,7 @@ h scrollBar visisble l scrollBar invisisble .TE + .ie n .IP "\fB\fB""Pm = 35""\fB\fR (\fBrxvt\fR)" 4 .el .IP "\fB\f(CBPm = 35\fB\fR (\fBrxvt\fR)" 4 .IX Item "Pm = 35 (rxvt)" @@ -2056,6 +2092,7 @@ h Allow XTerm Shift+key sequences l Disallow XTerm Shift+key sequences .TE + .ie n .IP "\fB\fB""Pm = 38""\fB\fR \fIunimplemented\fR" 4 .el .IP "\fB\f(CBPm = 38\fB\fR \fIunimplemented\fR" 4 .IX Item "Pm = 38 unimplemented" @@ -2069,6 +2106,7 @@ h Allow 80/132 Mode l Disallow 80/132 Mode .TE + .PD 0 .ie n .IP "\fB\fB""Pm = 44""\fB\fR \fIunimplemented\fR" 4 .el .IP "\fB\f(CBPm = 44\fB\fR \fIunimplemented\fR" 4 @@ -2078,6 +2116,7 @@ h Turn On Margin Bell l Turn Off Margin Bell .TE + .ie n .IP "\fB\fB""Pm = 45""\fB\fR \fIunimplemented\fR" 4 .el .IP "\fB\f(CBPm = 45\fB\fR \fIunimplemented\fR" 4 .IX Item "Pm = 45 unimplemented" @@ -2086,6 +2125,7 @@ h Reverse-wraparound Mode l No Reverse-wraparound Mode .TE + .ie n .IP "\fB\fB""Pm = 46""\fB\fR \fIunimplemented\fR" 4 .el .IP "\fB\f(CBPm = 46\fB\fR \fIunimplemented\fR" 4 .IX Item "Pm = 46 unimplemented" @@ -2097,6 +2137,7 @@ h Use Alternate Screen Buffer l Use Normal Screen Buffer .TE + .PD .IX Xref "Priv66" @@ -2108,6 +2149,7 @@ h Application Keypad (DECPAM) == ESC = l Normal Keypad (DECPNM) == ESC > .TE + .PD 0 .ie n .IP "\fB\fB""Pm = 67""\fB\fR" 4 .el .IP "\fB\f(CBPm = 67\fB\fR" 4 @@ -2117,6 +2159,7 @@ h Backspace key sends BS (DECBKM) l Backspace key sends DEL .TE + .ie n .IP "\fB\fB""Pm = 1000""\fB\fR (X11 XTerm)" 4 .el .IP "\fB\f(CBPm = 1000\fB\fR (X11 XTerm)" 4 .IX Item "Pm = 1000 (X11 XTerm)" @@ -2125,6 +2168,7 @@ h Send Mouse X & Y on button press and release. l No mouse reporting. .TE + .ie n .IP "\fB\fB""Pm = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4 .el .IP "\fB\f(CBPm = 1001\fB\fR (X11 XTerm) \fIunimplemented\fR" 4 .IX Item "Pm = 1001 (X11 XTerm) unimplemented" @@ -2133,6 +2177,7 @@ h Use Hilite Mouse Tracking. l No mouse reporting. .TE + .ie n .IP "\fB\fB""Pm = 1010""\fB\fR (\fBrxvt\fR)" 4 .el .IP "\fB\f(CBPm = 1010\fB\fR (\fBrxvt\fR)" 4 .IX Item "Pm = 1010 (rxvt)" @@ -2141,6 +2186,7 @@ h Don't scroll to bottom on TTY output l Scroll to bottom on TTY output .TE + .ie n .IP "\fB\fB""Pm = 1011""\fB\fR (\fBrxvt\fR)" 4 .el .IP "\fB\f(CBPm = 1011\fB\fR (\fBrxvt\fR)" 4 .IX Item "Pm = 1011 (rxvt)" @@ -2149,6 +2195,7 @@ h Scroll to bottom when a key is pressed l Don't scroll to bottom when a key is pressed .TE + .ie n .IP "\fB\fB""Pm = 1021""\fB\fR (\fBrxvt\fR)" 4 .el .IP "\fB\f(CBPm = 1021\fB\fR (\fBrxvt\fR)" 4 .IX Item "Pm = 1021 (rxvt)" @@ -2157,6 +2204,7 @@ h Bold/italic implies high intensity (see option -is) l Font styles have no effect on intensity (Compile styles) .TE + .ie n .IP "\fB\fB""Pm = 1047""\fB\fR" 4 .el .IP "\fB\f(CBPm = 1047\fB\fR" 4 .IX Item "Pm = 1047" @@ -2165,6 +2213,7 @@ h Use Alternate Screen Buffer l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it .TE + .ie n .IP "\fB\fB""Pm = 1048""\fB\fR" 4 .el .IP "\fB\f(CBPm = 1048\fB\fR" 4 .IX Item "Pm = 1048" @@ -2173,6 +2222,7 @@ h Save cursor position l Restore cursor position .TE + .ie n .IP "\fB\fB""Pm = 1049""\fB\fR" 4 .el .IP "\fB\f(CBPm = 1049\fB\fR" 4 .IX Item "Pm = 1049" @@ -2181,6 +2231,7 @@ h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it l Use Normal Screen Buffer .TE + .RE .RS 4 .RE @@ -2230,6 +2281,7 @@ Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). .TE + .SH "XPM" .IX Header "XPM" For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value @@ -2297,6 +2349,7 @@ 2 Button3 pressed 3 button released (X11 mouse report) .TE + .PP The upper bits of \fB\f(CB\*(C`\*(C'\fB\fR indicate the modifiers when the button was pressed and are added together (X11 mouse report only): @@ -2310,6 +2363,7 @@ 16 Control 32 Double Click (rxvt extension) .TE + Col = \fB\f(CB\*(C` \- SPACE\*(C'\fB\fR .Sp Row = \fB\f(CB\*(C` \- SPACE\*(C'\fB\fR @@ -2383,6 +2437,7 @@ XK_KP_8 8 ESC O x XK_KP_9 9 ESC O y .TE + .SH "CONFIGURE OPTIONS" .IX Header "CONFIGURE OPTIONS" General hint: if you get compile errors, then likely your configuration @@ -2430,6 +2485,7 @@ jp_ext rarely used but big japanese encodings kr korean encodings .TE + .IP "\-\-enable\-xim (default: on)" 4 .IX Item "--enable-xim (default: on)" Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using @@ -2547,29 +2603,29 @@ A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly in combination with other switches) is: .Sp -.Vb 10 -\& MWM\-hints -\& EWMH\-hints (pid, utf8 names) and protocols (ping) -\& seperate underline colour (\-underlineColor) -\& settable border widths and borderless switch (\-w, \-b, \-bl) -\& visual depth selection (\-depth) -\& settable extra linespacing /\-lsp) -\& iso\-14755\-2 and \-3, and visual feedback -\& tripleclickwords (\-tcw) -\& settable insecure mode (\-insecure) +.Vb 16 +\& MWM-hints +\& EWMH-hints (pid, utf8 names) and protocols (ping) +\& seperate underline colour (-underlineColor) +\& settable border widths and borderless switch (-w, -b, -bl) +\& visual depth selection (-depth) +\& settable extra linespacing /-lsp) +\& iso-14755-2 and -3, and visual feedback +\& tripleclickwords (-tcw) +\& settable insecure mode (-insecure) \& keysym remapping support -\& cursor blinking and underline cursor (\-cb, \-uc) -\& XEmbed support (\-embed) -\& user\-pty (\-pty\-fd) -\& hold on exit (\-hold) -\& skip builtin block graphics (\-sbg) -\& separate highlightcolor support (\-hc) +\& cursor blinking and underline cursor (-cb, -uc) +\& XEmbed support (-embed) +\& user-pty (-pty-fd) +\& hold on exit (-hold) +\& skip builtin block graphics (-sbg) +\& separate highlightcolor support (-hc) .Ve .Sp It also enables some non-essential features otherwise disabled, such as: .Sp .Vb 11 -\& some round\-trip time optimisations +\& some round-trip time optimisations \& nearest color allocation on pseudocolor screens \& UTF8_STRING supporr for selection \& sgr modes 90..97 and 100..107 @@ -2660,12 +2716,3 @@ reworked it from the original Rxvt documentation, which was done by Geoff Wing , who in turn used the XTerm documentation and other sources. -.SH "POD ERRORS" -.IX Header "POD ERRORS" -Hey! \fBThe above document had some coding errors, which are explained below:\fR -.IP "Around line 2952:" 4 -.IX Item "Around line 2952:" -=back doesn't take any parameters, but you said =back X -.IP "Around line 3048:" 4 -.IX Item "Around line 3048:" -=back doesn't take any parameters, but you said =back X