--- rxvt-unicode/doc/rxvt.7.man.in 2006/02/21 11:34:05 1.74 +++ rxvt-unicode/doc/rxvt.7.man.in 2006/07/06 18:56:10 1.76 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 +.\" Automatically generated by Pod::Man 2.09 (Pod::Simple 3.04) .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 7" -.TH rxvt 7 "2006-02-21" "7.7" "RXVT-UNICODE" +.TH rxvt 7 "2006-07-06" "7.7" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "SYNOPSIS" @@ -137,14 +137,10 @@ .Vb 2 \& # set a new font set \& printf '\e33]50;%s\e007' 9x15,xft:Kochi" Mincho" -.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 +\& +\& # change the locale and tell rxvt\-unicode about it +\& export LC_CTYPE=ja_JP.EUC\-JP; printf "\e33]701;$LC_CTYPE\e007" +\& \& # set window title \& printf '\e33]2;%s\e007' "new window title" .Ve @@ -174,11 +170,9 @@ give you tabs: .PP .Vb 1 -\& @@URXVT_NAME@@ -pe tabbed -.Ve -.PP -.Vb 1 -\& URxvt.perl-ext-common: default,tabbed +\& @@URXVT_NAME@@ \-pe tabbed +\& +\& URxvt.perl\-ext\-common: default,tabbed .Ve .PP It will also work fine with tabbing functionality of many window managers @@ -226,8 +220,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 @@ -260,14 +254,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 @@ -293,8 +287,8 @@ .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 @@ -303,8 +297,8 @@ .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 @@ -350,7 +344,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: @@ -360,7 +354,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), @@ -382,7 +376,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 @@ -393,8 +387,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 @@ -403,7 +397,7 @@ 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 @@ -415,8 +409,8 @@ 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 @@ -478,7 +472,7 @@ effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately: .PP .Vb 1 -\& printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic" +\& printf '\e33]50;%s\e007' "9x15bold,xft:Kochi Gothic" .Ve .PP This is useful if you e.g. work primarily with japanese (and prefer a @@ -555,9 +549,7 @@ \& URxvt.color5: #A800A8 \& URxvt.color6: #00A8A8 \& URxvt.color7: #A8A8A8 -.Ve -.PP -.Vb 8 +\& \& URxvt.color8: #000054 \& URxvt.color9: #FF0054 \& URxvt.color10: #00FF54 @@ -570,7 +562,7 @@ .PP And here is a more complete set of non-standard colors. .PP -.Vb 18 +.Vb 10 \& URxvt.cursorColor: #dc74d1 \& URxvt.pointerColor: #dc74d1 \& URxvt.background: #0e0e0e @@ -617,7 +609,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 @@ -652,7 +644,8 @@ 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 @@ -662,7 +655,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 @@ -671,7 +664,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 @@ -691,7 +684,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 @@ -700,7 +693,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 @@ -721,7 +714,7 @@ 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 @@ -789,9 +782,7 @@ \& # use Backspace = ^H \& $ stty erase ^H \& $ @@URXVT_NAME@@ -.Ve -.PP -.Vb 3 +\& \& # use Backspace = ^? \& $ stty erase ^? \& $ @@URXVT_NAME@@ @@ -804,13 +795,11 @@ .Vb 3 \& # use Backspace = ^H \& $ stty erase ^H -\& $ echo -n "^[[36h" -.Ve -.PP -.Vb 3 +\& $ echo \-n "^[[36h" +\& \& # use Backspace = ^? \& $ stty erase ^? -\& $ echo -n "^[[36l" +\& $ echo \-n "^[[36l" .Ve .PP This helps satisfy some of the Backspace discrepancies that occur, but @@ -839,26 +828,26 @@ .PP Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR .PP -.Vb 20 +.Vb 10 \& 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 @@ -894,13 +883,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 @@ -910,12 +899,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 @@ -1002,12 +991,12 @@ .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 @@ -1039,8 +1028,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 @@ -1053,11 +1042,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 @@ -1073,9 +1062,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$HOME/.Xdefaults\fR when no resources are attached to the display. +\&\fI\f(CI$HOME\fI/.Xdefaults\fR when no resources are attached to the display. .PP -If you have or use an \fI$HOME/.Xresources\fR file, chances are that +If you have or use an \fI\f(CI$HOME\fI/.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 @@ -1100,7 +1089,7 @@ .PP .Vb 2 \& REMOTE=remotesystem.domain -\& infocmp rxvt-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti" +\& infocmp rxvt\-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti" .Ve .PP \&... or by installing rxvt-unicode normally on the remote system, @@ -1146,13 +1135,13 @@ 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 20 -\& rxvt-unicode|rxvt-unicode terminal (X Window System):\e +.Vb 10 +\& 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 @@ -1183,13 +1172,13 @@ 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. @@ -1238,7 +1227,7 @@ into other problems. If nothing works you can try this in your .profile. .PP .Vb 1 -\& printf '\ee]701;%s\e007' "$LC_CTYPE" +\& printf '\e33]701;%s\e007' "$LC_CTYPE" .Ve .PP If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not @@ -1305,7 +1294,7 @@ rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR. .PP .Vb 1 -\& printf '\ee]701;%s\e007' ja_JP.SJIS +\& printf '\e33]701;%s\e007' ja_JP.SJIS .Ve .PP See also the previous answer. @@ -1316,9 +1305,9 @@ first switches to a locale supported by xjdic and back later: .PP .Vb 3 -\& printf '\ee]701;%s\e007' ja_JP.SJIS -\& xjdic -js -\& printf '\ee]701;%s\e007' de_DE.UTF-8 +\& printf '\e33]701;%s\e007' ja_JP.SJIS +\& 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 @@ -1350,9 +1339,9 @@ 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?" @@ -1361,7 +1350,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 @@ -1680,7 +1669,6 @@ C = C Finnish character set unimplemented C = K German character set unimplemented .TE - .PP .IX Xref "CSI" @@ -1739,7 +1727,6 @@ 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" @@ -1750,7 +1737,6 @@ 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" @@ -1778,7 +1764,6 @@ 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" @@ -1823,7 +1808,6 @@ 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" @@ -1838,7 +1822,6 @@ 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" @@ -1852,7 +1835,6 @@ 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 @@ -1862,7 +1844,6 @@ h Automatic Newline (LNM) l Normal Linefeed (LNM) .TE - .RE .RS 4 .RE @@ -1901,7 +1882,6 @@ 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" @@ -1913,7 +1893,6 @@ 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" @@ -1946,7 +1925,6 @@ 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" @@ -1981,254 +1959,228 @@ .IX Item "ESC [ ? Pm t" Toggle \s-1DEC\s0 Private Mode Values (rxvt extension). \fIwhere\fR .RS 4 -.ie n .IP "\fB\fB""Ps = 1""\fB\fR (\s-1DECCKM\s0)" 4 -.el .IP "\fB\f(CBPs = 1\fB\fR (\s-1DECCKM\s0)" 4 -.IX Item "Ps = 1 (DECCKM)" +.ie n .IP "\fB\fB""Pm = 1""\fB\fR (\s-1DECCKM\s0)" 4 +.el .IP "\fB\f(CBPm = 1\fB\fR (\s-1DECCKM\s0)" 4 +.IX Item "Pm = 1 (DECCKM)" .TS l l . h Application Cursor Keys l Normal Cursor Keys .TE - .PD 0 -.ie n .IP "\fB\fB""Ps = 2""\fB\fR (\s-1ANSI/VT52\s0 mode)" 4 -.el .IP "\fB\f(CBPs = 2\fB\fR (\s-1ANSI/VT52\s0 mode)" 4 -.IX Item "Ps = 2 (ANSI/VT52 mode)" +.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 +.IX Item "Pm = 2 (ANSI/VT52 mode)" .TS l l . h Enter VT52 mode l Enter VT52 mode .TE - -.ie n .IP "\fB\fB""Ps = 3""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 3\fB\fR" 4 -.IX Item "Ps = 3" +.ie n .IP "\fB\fB""Pm = 3""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 3\fB\fR" 4 +.IX Item "Pm = 3" .TS l l . h 132 Column Mode (DECCOLM) l 80 Column Mode (DECCOLM) .TE - -.ie n .IP "\fB\fB""Ps = 4""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 4\fB\fR" 4 -.IX Item "Ps = 4" +.ie n .IP "\fB\fB""Pm = 4""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 4\fB\fR" 4 +.IX Item "Pm = 4" .TS l l . h Smooth (Slow) Scroll (DECSCLM) l Jump (Fast) Scroll (DECSCLM) .TE - -.ie n .IP "\fB\fB""Ps = 5""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 5\fB\fR" 4 -.IX Item "Ps = 5" +.ie n .IP "\fB\fB""Pm = 5""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 5\fB\fR" 4 +.IX Item "Pm = 5" .TS l l . h Reverse Video (DECSCNM) l Normal Video (DECSCNM) .TE - -.ie n .IP "\fB\fB""Ps = 6""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 6\fB\fR" 4 -.IX Item "Ps = 6" +.ie n .IP "\fB\fB""Pm = 6""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 6\fB\fR" 4 +.IX Item "Pm = 6" .TS l l . h Origin Mode (DECOM) l Normal Cursor Mode (DECOM) .TE - -.ie n .IP "\fB\fB""Ps = 7""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 7\fB\fR" 4 -.IX Item "Ps = 7" +.ie n .IP "\fB\fB""Pm = 7""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 7\fB\fR" 4 +.IX Item "Pm = 7" .TS l l . h Wraparound Mode (DECAWM) l No Wraparound Mode (DECAWM) .TE - -.ie n .IP "\fB\fB""Ps = 8""\fB\fR \fIunimplemented\fR" 4 -.el .IP "\fB\f(CBPs = 8\fB\fR \fIunimplemented\fR" 4 -.IX Item "Ps = 8 unimplemented" +.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" .TS l l . h Auto-repeat Keys (DECARM) l No Auto-repeat Keys (DECARM) .TE - -.ie n .IP "\fB\fB""Ps = 9""\fB\fR X10 XTerm" 4 -.el .IP "\fB\f(CBPs = 9\fB\fR X10 XTerm" 4 -.IX Item "Ps = 9 X10 XTerm" +.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" .TS l l . h Send Mouse X & Y on button press. l No mouse reporting. .TE - -.ie n .IP "\fB\fB""Ps = 25""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 25\fB\fR" 4 -.IX Item "Ps = 25" +.ie n .IP "\fB\fB""Pm = 25""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 25\fB\fR" 4 +.IX Item "Pm = 25" .TS l l . h Visible cursor {cnorm/cvvis} l Invisible cursor {civis} .TE - -.ie n .IP "\fB\fB""Ps = 30""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 30\fB\fR" 4 -.IX Item "Ps = 30" +.ie n .IP "\fB\fB""Pm = 30""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 30\fB\fR" 4 +.IX Item "Pm = 30" .TS l l . h scrollBar visisble l scrollBar invisisble .TE - -.ie n .IP "\fB\fB""Ps = 35""\fB\fR (\fBrxvt\fR)" 4 -.el .IP "\fB\f(CBPs = 35\fB\fR (\fBrxvt\fR)" 4 -.IX Item "Ps = 35 (rxvt)" +.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)" .TS l l . h Allow XTerm Shift+key sequences l Disallow XTerm Shift+key sequences .TE - -.ie n .IP "\fB\fB""Ps = 38""\fB\fR \fIunimplemented\fR" 4 -.el .IP "\fB\f(CBPs = 38\fB\fR \fIunimplemented\fR" 4 -.IX Item "Ps = 38 unimplemented" +.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" .PD Enter Tektronix Mode (\s-1DECTEK\s0) -.ie n .IP "\fB\fB""Ps = 40""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 40\fB\fR" 4 -.IX Item "Ps = 40" +.ie n .IP "\fB\fB""Pm = 40""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 40\fB\fR" 4 +.IX Item "Pm = 40" .TS l l . h Allow 80/132 Mode l Disallow 80/132 Mode .TE - .PD 0 -.ie n .IP "\fB\fB""Ps = 44""\fB\fR \fIunimplemented\fR" 4 -.el .IP "\fB\f(CBPs = 44\fB\fR \fIunimplemented\fR" 4 -.IX Item "Ps = 44 unimplemented" +.ie n .IP "\fB\fB""Pm = 44""\fB\fR \fIunimplemented\fR" 4 +.el .IP "\fB\f(CBPm = 44\fB\fR \fIunimplemented\fR" 4 +.IX Item "Pm = 44 unimplemented" .TS l l . h Turn On Margin Bell l Turn Off Margin Bell .TE - -.ie n .IP "\fB\fB""Ps = 45""\fB\fR \fIunimplemented\fR" 4 -.el .IP "\fB\f(CBPs = 45\fB\fR \fIunimplemented\fR" 4 -.IX Item "Ps = 45 unimplemented" +.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" .TS l l . h Reverse-wraparound Mode l No Reverse-wraparound Mode .TE - -.ie n .IP "\fB\fB""Ps = 46""\fB\fR \fIunimplemented\fR" 4 -.el .IP "\fB\f(CBPs = 46\fB\fR \fIunimplemented\fR" 4 -.IX Item "Ps = 46 unimplemented" -.ie n .IP "\fB\fB""Ps = 47""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 47\fB\fR" 4 -.IX Item "Ps = 47" +.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" +.ie n .IP "\fB\fB""Pm = 47""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 47\fB\fR" 4 +.IX Item "Pm = 47" .TS l l . h Use Alternate Screen Buffer l Use Normal Screen Buffer .TE - .PD .IX Xref "Priv66" -.ie n .IP "\fB\fB""Ps = 66""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 66\fB\fR" 4 -.IX Item "Ps = 66" +.ie n .IP "\fB\fB""Pm = 66""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 66\fB\fR" 4 +.IX Item "Pm = 66" .TS l l . h Application Keypad (DECPAM) == ESC = l Normal Keypad (DECPNM) == ESC > .TE - .PD 0 -.ie n .IP "\fB\fB""Ps = 67""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 67\fB\fR" 4 -.IX Item "Ps = 67" +.ie n .IP "\fB\fB""Pm = 67""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 67\fB\fR" 4 +.IX Item "Pm = 67" .TS l l . h Backspace key sends BS (DECBKM) l Backspace key sends DEL .TE - -.ie n .IP "\fB\fB""Ps = 1000""\fB\fR (X11 XTerm)" 4 -.el .IP "\fB\f(CBPs = 1000\fB\fR (X11 XTerm)" 4 -.IX Item "Ps = 1000 (X11 XTerm)" +.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)" .TS l l . h Send Mouse X & Y on button press and release. l No mouse reporting. .TE - -.ie n .IP "\fB\fB""Ps = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4 -.el .IP "\fB\f(CBPs = 1001\fB\fR (X11 XTerm) \fIunimplemented\fR" 4 -.IX Item "Ps = 1001 (X11 XTerm) unimplemented" +.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" .TS l l . h Use Hilite Mouse Tracking. l No mouse reporting. .TE - -.ie n .IP "\fB\fB""Ps = 1010""\fB\fR (\fBrxvt\fR)" 4 -.el .IP "\fB\f(CBPs = 1010\fB\fR (\fBrxvt\fR)" 4 -.IX Item "Ps = 1010 (rxvt)" +.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)" .TS l l . h Don't scroll to bottom on TTY output l Scroll to bottom on TTY output .TE - -.ie n .IP "\fB\fB""Ps = 1011""\fB\fR (\fBrxvt\fR)" 4 -.el .IP "\fB\f(CBPs = 1011\fB\fR (\fBrxvt\fR)" 4 -.IX Item "Ps = 1011 (rxvt)" +.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)" .TS l l . 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""Ps = 1021""\fB\fR (\fBrxvt\fR)" 4 -.el .IP "\fB\f(CBPs = 1021\fB\fR (\fBrxvt\fR)" 4 -.IX Item "Ps = 1021 (rxvt)" +.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)" .TS l l . 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""Ps = 1047""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 1047\fB\fR" 4 -.IX Item "Ps = 1047" +.ie n .IP "\fB\fB""Pm = 1047""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 1047\fB\fR" 4 +.IX Item "Pm = 1047" .TS l l . h Use Alternate Screen Buffer l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it .TE - -.ie n .IP "\fB\fB""Ps = 1048""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 1048\fB\fR" 4 -.IX Item "Ps = 1048" +.ie n .IP "\fB\fB""Pm = 1048""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 1048\fB\fR" 4 +.IX Item "Pm = 1048" .TS l l . h Save cursor position l Restore cursor position .TE - -.ie n .IP "\fB\fB""Ps = 1049""\fB\fR" 4 -.el .IP "\fB\f(CBPs = 1049\fB\fR" 4 -.IX Item "Ps = 1049" +.ie n .IP "\fB\fB""Pm = 1049""\fB\fR" 4 +.el .IP "\fB\f(CBPm = 1049\fB\fR" 4 +.IX Item "Pm = 1049" .TS l l . h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it l Use Normal Screen Buffer .TE - .RE .RS 4 .RE @@ -2278,7 +2230,6 @@ 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 @@ -2346,7 +2297,6 @@ 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): @@ -2360,7 +2310,6 @@ 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 @@ -2434,7 +2383,6 @@ 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 @@ -2482,7 +2430,6 @@ 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 @@ -2600,28 +2547,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 15 -\& 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 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) \& 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) +\& 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 enabled some non-essential features otherwise disabled, such as: +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 @@ -2712,3 +2660,12 @@ 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