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.14 by root, Mon Feb 14 10:44:50 2005 UTC vs.
Revision 1.20 by root, Sun Apr 17 22:36:13 2005 UTC

… …
127.\} 127.\}
128.rm #[ #] #H #V #F C 128.rm #[ #] #H #V #F C
129.\" ======================================================================== 129.\" ========================================================================
130.\" 130.\"
131.IX Title "rxvt 7" 131.IX Title "rxvt 7"
132.TH rxvt 7 "2005-02-14" "" "RXVT-UNICODE" 132.TH rxvt 7 "2005-04-17" "5.3" "RXVT-UNICODE"
133.SH "NAME" 133.SH "NAME"
134RXVT REFERENCE \- FAQ, command sequences and other background information 134RXVT REFERENCE \- FAQ, command sequences and other background information
135.SH "SYNOPSIS" 135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS" 136.IX Header "SYNOPSIS"
137.Vb 2 137.Vb 2
… …
214.IP "I need a termcap file entry." 4 214.IP "I need a termcap file entry." 4
215.IX Item "I need a termcap file entry." 215.IX Item "I need a termcap file entry."
216.PD 216.PD
217One reason you might want this is that some distributions or operating 217One reason you might want this is that some distributions or operating
218systems still compile some programs using the long-obsoleted termcap 218systems still compile some programs using the long-obsoleted termcap
219(Fedora Core's bash is one example) and rely on a termcap entry for 219library (Fedora Core's bash is one example) and rely on a termcap entry
220\&\f(CW\*(C`rxvt\-unicode\*(C'\fR. 220for \f(CW\*(C`rxvt\-unicode\*(C'\fR.
221.Sp 221.Sp
222You could use rxvt's termcap entry with resonable results in many cases. 222You could use rxvt's termcap entry with resonable results in many cases.
223You can also create a termcap entry by using terminfo's infocmp program 223You can also create a termcap entry by using terminfo's infocmp program
224like this: 224like this:
225.Sp 225.Sp
… …
227\& infocmp -C rxvt-unicode 227\& infocmp -C rxvt-unicode
228.Ve 228.Ve
229.Sp 229.Sp
230Or you could use this termcap entry, generated by the command above: 230Or you could use this termcap entry, generated by the command above:
231.Sp 231.Sp
232.Vb 19 232.Vb 20
233\& rxvt-unicode|rxvt-unicode terminal (X Window System):\e 233\& rxvt-unicode|rxvt-unicode terminal (X Window System):\e
234\& :am:bw:eo:km:mi:ms:xn:xo:\e 234\& :am:bw:eo:km:mi:ms:xn:xo:\e
235\& :co#80:it#8:li#24:\e 235\& :co#80:it#8:li#24:lm#0:\e
236\& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e 236\& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e
237\& :K1=\eEOw:K2=\eEOu:K3=\eEOy:K4=\eEOq:K5=\eEOs:LE=\eE[%dD:\e 237\& :K1=\eEOw:K2=\eEOu:K3=\eEOy:K4=\eEOq:K5=\eEOs:LE=\eE[%dD:\e
238\& :RI=\eE[%dC:SF=\eE[%dS:SR=\eE[%dT:UP=\eE[%dA:ae=^O:al=\eE[L:\e 238\& :RI=\eE[%dC:SF=\eE[%dS:SR=\eE[%dT:UP=\eE[%dA:ae=\eE(B:al=\eE[L:\e
239\& :as=^N:bl=^G:cd=\eE[J:ce=\eE[K:cl=\eE[H\eE[2J:cm=\eE[%i%d;%dH:\e 239\& :as=\eE(0:bl=^G:cd=\eE[J:ce=\eE[K:cl=\eE[H\eE[2J:\e
240\& :cr=^M:cs=\eE[%i%d;%dr:ct=\eE[3g:dc=\eE[P:dl=\eE[M:do=^J:\e 240\& :cm=\eE[%i%d;%dH:cr=^M:cs=\eE[%i%d;%dr:ct=\eE[3g:dc=\eE[P:\e
241\& :ec=\eE[%dX:ei=\eE[4l:ho=\eE[H:i1=\eE[?47l\eE=\eE[?1l:ic=\eE[@:\e 241\& :dl=\eE[M:do=^J:ec=\eE[%dX:ei=\eE[4l:ho=\eE[H:\e
242\& :i1=\eE[?47l\eE=\eE[?1l:ic=\eE[@:im=\eE[4h:\e
242\& :im=\eE[4h:is=\eE[r\eE[m\eE[2J\eE[H\eE[?7h\eE[?1;3;4;6l\eE[4l:\e 243\& :is=\eE[r\eE[m\eE[2J\eE[H\eE[?7h\eE[?1;3;4;6l\eE[4l:\e
243\& :k0=\eE[21~:k1=\eE[11~:k2=\eE[12~:k3=\eE[13~:k4=\eE[14~:\e 244\& :k1=\eE[11~:k2=\eE[12~:k3=\eE[13~:k4=\eE[14~:k5=\eE[15~:\e
244\& :k5=\eE[15~:k6=\eE[17~:k7=\eE[18~:k8=\eE[19~:k9=\eE[20~:\e 245\& :k6=\eE[17~:k7=\eE[18~:k8=\eE[19~:k9=\eE[20~:kD=\eE[3~:\e
245\& :kD=\eE[3~:kI=\eE[2~:kN=\eE[6~:kP=\eE[5~:kb=\e177:kd=\eEOB:\e 246\& :kI=\eE[2~:kN=\eE[6~:kP=\eE[5~:kb=\e177:kd=\eEOB:ke=\eE[?1l\eE>:\e
246\& :ke=\eE[?1l\eE>:kh=\eE[7~:kl=\eEOD:kr=\eEOC:ks=\eE[?1h\eE=:\e 247\& :kh=\eE[7~:kl=\eEOD:kr=\eEOC:ks=\eE[?1h\eE=:ku=\eEOA:le=^H:\e
247\& :ku=\eEOA:le=^H:mb=\eE[5m:md=\eE[1m:me=\eE[m\e017:mr=\eE[7m:\e 248\& :mb=\eE[5m:md=\eE[1m:me=\eE[m\e017:mr=\eE[7m:nd=\eE[C:rc=\eE8:\e
248\& :nd=\eE[C:rc=\eE8:sc=\eE7:se=\eE[27m:sf=^J:so=\eE[7m:sr=\eEM:\e 249\& :sc=\eE7:se=\eE[27m:sf=^J:so=\eE[7m:sr=\eEM:st=\eEH:ta=^I:\e
249\& :st=\eEH:ta=^I:te=\eE[r\eE[?1049l:ti=\eE[?1049h:ue=\eE[24m:\e 250\& :te=\eE[r\eE[?1049l:ti=\eE[?1049h:ue=\eE[24m:up=\eE[A:\e
250\& :up=\eE[A:us=\eE[4m:vb=\eE[?5h\eE[?5l:ve=\eE[?25h:vi=\eE[?25l:\e 251\& :us=\eE[4m:vb=\eE[?5h\eE[?5l:ve=\eE[?25h:vi=\eE[?25l:\e
251\& :vs=\eE[?25h: 252\& :vs=\eE[?25h:
252.Ve 253.Ve
253.ie n .IP "Why does ""ls"" no longer have coloured output?" 4 254.ie n .IP "Why does ""ls"" no longer have coloured output?" 4
254.el .IP "Why does \f(CWls\fR no longer have coloured output?" 4 255.el .IP "Why does \f(CWls\fR no longer have coloured output?" 4
255.IX Item "Why does ls no longer have coloured output?" 256.IX Item "Why does ls no longer have coloured output?"
… …
456.Sp 457.Sp
457As you might have guessed, FreeBSD does neither define this symobl nor 458As you might have guessed, FreeBSD does neither define this symobl nor
458does it support it. Instead, it uses it's own internal representation of 459does it support it. Instead, it uses it's own internal representation of
459\&\fBwchar_t\fR. This is, of course, completely fine with respect to standards. 460\&\fBwchar_t\fR. This is, of course, completely fine with respect to standards.
460.Sp 461.Sp
462However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and
463\&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR.
464.Sp
461However, \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support 465\&\f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support multi-language
462multi-language apps in an \s-1OS\s0, as using a locale-dependent (and 466apps in an \s-1OS\s0, as using a locale-dependent (and non\-standardized)
463non\-standardized) representation of \fBwchar_t\fR makes it impossible to 467representation of \fBwchar_t\fR makes it impossible to convert between
464convert between \fBwchar_t\fR (as used by X11 and your applications) and any 468\&\fBwchar_t\fR (as used by X11 and your applications) and any other encoding
465other encoding without implementing OS-specific-wrappers for each and 469without implementing OS-specific-wrappers for each and every locale. There
466every locale. There simply are no APIs to convert \fBwchar_t\fR into anything 470simply are no APIs to convert \fBwchar_t\fR into anything except the current
467except the current locale encoding. 471locale encoding.
468.Sp 472.Sp
469Some applications (such as the formidable \fBmlterm\fR) work around this 473Some applications (such as the formidable \fBmlterm\fR) work around this
470by carrying their own replacement functions for character set handling 474by carrying their own replacement functions for character set handling
471with them, and either implementing OS-dependent hacks or doing multiple 475with them, and either implementing OS-dependent hacks or doing multiple
472conversions (which is slow and unreliable in case the \s-1OS\s0 implements 476conversions (which is slow and unreliable in case the \s-1OS\s0 implements
… …
1612Ps = 13 Change colour of mouse foreground to Pt 1616Ps = 13 Change colour of mouse foreground to Pt
1613Ps = 17 Change colour of highlight characters to Pt 1617Ps = 17 Change colour of highlight characters to Pt
1614Ps = 18 Change colour of bold characters to Pt 1618Ps = 18 Change colour of bold characters to Pt
1615Ps = 19 Change colour of underlined characters to Pt 1619Ps = 19 Change colour of underlined characters to Pt
1616Ps = 20 Change default background to Pt 1620Ps = 20 Change default background to Pt
1617Ps = 39 Change default foreground colour to Pt rxvt compile-time option 1621Ps = 39 Change default foreground colour to Pt.
1618Ps = 46 Change Log File to Pt unimplemented 1622Ps = 46 Change Log File to Pt unimplemented
1619Ps = 49 Change default background colour to Pt rxvt compile-time option 1623Ps = 49 Change default background colour to Pt.
1620Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n 1624Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n
1621Ps = 55 Log all scrollback buffer and all of screen to Pt 1625Ps = 55 Log all scrollback buffer and all of screen to Pt
1622Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (@@RXVT_NAME@@ extension) 1626Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
1623Ps = 703 Menubar command Pt rxvt compile-time option (rxvt-unicode extension) 1627Ps = 703 Menubar command Pt (Compile menubar).
1624Ps = 704 Change colour of italic characters to Pt 1628Ps = 704 Change colour of italic characters to Pt
1625Ps = 705 Change background pixmap tint colour to Pt 1629Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
1626Ps = 710 Set normal fontset to Pt. Same as Ps = 50. 1630Ps = 710 Set normal fontset to Pt. Same as Ps = 50.
1627Ps = 711 Set bold fontset to Pt. Similar to Ps = 50. 1631Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
1628Ps = 712 Set italic fontset to Pt. Similar to Ps = 50. 1632Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1629Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50. 1633Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1634Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1635Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1630.TE 1636.TE
1631 1637
1632.PP 1638.PP
1633 1639
1634.IX Xref "menuBar" 1640.IX Xref "menuBar"
… …
2184.IX Item "--enable-font-styles" 2190.IX Item "--enable-font-styles"
2185Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font 2191Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font
2186styles. The fonts can be set manually or automatically. 2192styles. The fonts can be set manually or automatically.
2187.IP "\-\-with\-codesets=NAME,..." 4 2193.IP "\-\-with\-codesets=NAME,..." 4
2188.IX Item "--with-codesets=NAME,..." 2194.IX Item "--with-codesets=NAME,..."
2189Compile in support for additional codeset (encoding) groups (eu, vn are 2195Compile in support for additional codeset (encoding) groups (\f(CW\*(C`eu\*(C'\fR, \f(CW\*(C`vn\*(C'\fR
2190always compiled in, which includes most 8\-bit character sets). These 2196are always compiled in, which includes most 8\-bit character sets). These
2191codeset tables are currently only used for driving X11 core fonts, they 2197codeset tables are used for driving X11 core fonts, they are not required
2192are not required for Xft fonts. Compiling them in will make your binary 2198for Xft fonts, although having them compiled in lets rxvt-unicode choose
2193bigger (together about 700kB), but it doesn't increase memory usage unless 2199replacement fonts more intelligently. Compiling them in will make your
2200binary bigger (all of together cost about 700kB), but it doesn't increase
2194you use an X11 font requiring one of these encodings. 2201memory usage unless you use a font requiring one of these encodings.
2195.TS 2202.TS
2196l l . 2203l l .
2197all all available codeset groups 2204all all available codeset groups
2198zh common chinese encodings 2205zh common chinese encodings
2199zh_ext rarely used but very big chinese encodigs 2206zh_ext rarely used but very big chinese encodigs
… …
2341disable this. 2348disable this.
2342.Sp 2349.Sp
2343A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly 2350A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2344in combination with other switches) is: 2351in combination with other switches) is:
2345.Sp 2352.Sp
2346.Vb 11 2353.Vb 13
2347\& MWM-hints 2354\& MWM-hints
2355\& EWMH-hints (pid, utf8 names) and protocols (ping)
2348\& seperate underline colour 2356\& seperate underline colour
2349\& settable border widths and borderless switch 2357\& settable border widths and borderless switch
2350\& settable extra linespacing 2358\& settable extra linespacing
2351\& extra window properties (e.g. UTF-8 window names and PID)
2352\& iso-14755-2 and -3, and visual feedback 2359\& iso-14755-2 and -3, and visual feedback
2353\& backindex and forwardindex escape sequence 2360\& backindex and forwardindex escape sequence
2354\& window op and locale change escape sequences 2361\& window op and some xterm/OSC escape sequences
2355\& tripleclickwords 2362\& tripleclickwords
2356\& settable insecure mode 2363\& settable insecure mode
2357\& keysym remapping support 2364\& keysym remapping support
2365\& cursor blinking and underline cursor
2366\& -embed and -pty-fd options
2358.Ve 2367.Ve
2359.IP "\-\-enable\-iso14755" 4 2368.IP "\-\-enable\-iso14755" 4
2360.IX Item "--enable-iso14755" 2369.IX Item "--enable-iso14755"
2361Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or 2370Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or
2362\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by 2371\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by
… …
2393.IP "\-\-enable\-smart\-resize" 4 2402.IP "\-\-enable\-smart\-resize" 4
2394.IX Item "--enable-smart-resize" 2403.IX Item "--enable-smart-resize"
2395Add smart growth/shrink behaviour when changing font size via from hot 2404Add smart growth/shrink behaviour when changing font size via from hot
2396keys. This should keep in a fixed position the rxvt corner which is 2405keys. This should keep in a fixed position the rxvt corner which is
2397closest to a corner of the screen. 2406closest to a corner of the screen.
2398.IP "\-\-enable\-cursor\-blink" 4
2399.IX Item "--enable-cursor-blink"
2400Add support for a blinking cursor.
2401.IP "\-\-enable\-pointer\-blank" 4 2407.IP "\-\-enable\-pointer\-blank" 4
2402.IX Item "--enable-pointer-blank" 2408.IX Item "--enable-pointer-blank"
2403Add support to have the pointer disappear when typing or inactive. 2409Add support to have the pointer disappear when typing or inactive.
2404.IP "\-\-with\-name=NAME" 4 2410.IP "\-\-with\-name=NAME" 4
2405.IX Item "--with-name=NAME" 2411.IX Item "--with-name=NAME"

Diff Legend

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