… | |
… | |
78 | |
78 | |
79 | =item I need a termcap file entry. |
79 | =item I need a termcap file entry. |
80 | |
80 | |
81 | One reason you might want this is that some distributions or operating |
81 | One reason you might want this is that some distributions or operating |
82 | systems still compile some programs using the long-obsoleted termcap |
82 | systems still compile some programs using the long-obsoleted termcap |
83 | (Fedora Core's bash is one example) and rely on a termcap entry for |
83 | library (Fedora Core's bash is one example) and rely on a termcap entry |
84 | C<rxvt-unicode>. |
84 | for C<rxvt-unicode>. |
85 | |
85 | |
86 | You could use rxvt's termcap entry with resonable results in many cases. |
86 | You could use rxvt's termcap entry with resonable results in many cases. |
87 | You can also create a termcap entry by using terminfo's infocmp program |
87 | You can also create a termcap entry by using terminfo's infocmp program |
88 | like this: |
88 | like this: |
89 | |
89 | |
… | |
… | |
91 | |
91 | |
92 | Or you could use this termcap entry, generated by the command above: |
92 | Or you could use this termcap entry, generated by the command above: |
93 | |
93 | |
94 | rxvt-unicode|rxvt-unicode terminal (X Window System):\ |
94 | rxvt-unicode|rxvt-unicode terminal (X Window System):\ |
95 | :am:bw:eo:km:mi:ms:xn:xo:\ |
95 | :am:bw:eo:km:mi:ms:xn:xo:\ |
96 | :co#80:it#8:li#24:\ |
96 | :co#80:it#8:li#24:lm#0:\ |
97 | :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ |
97 | :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ |
98 | :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ |
98 | :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ |
99 | :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=^O:al=\E[L:\ |
99 | :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\ |
100 | :as=^N:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:cm=\E[%i%d;%dH:\ |
100 | :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\ |
101 | :cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:dl=\E[M:do=^J:\ |
101 | :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\ |
102 | :ec=\E[%dX:ei=\E[4l:ho=\E[H:i1=\E[?47l\E=\E[?1l:ic=\E[@:\ |
102 | :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\ |
|
|
103 | :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\ |
103 | :im=\E[4h:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ |
104 | :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ |
104 | :k0=\E[21~:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:\ |
105 | :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\ |
105 | :k5=\E[15~:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:\ |
106 | :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\ |
106 | :kD=\E[3~:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:\ |
107 | :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\ |
107 | :ke=\E[?1l\E>:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:\ |
108 | :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\ |
108 | :ku=\EOA:le=^H:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:\ |
109 | :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\ |
109 | :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\ |
110 | :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\ |
110 | :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\ |
111 | :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\ |
111 | :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ |
112 | :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ |
112 | :vs=\E[?25h: |
113 | :vs=\E[?25h: |
113 | |
114 | |
114 | =item Why does C<ls> no longer have coloured output? |
115 | =item Why does C<ls> no longer have coloured output? |
115 | |
116 | |
116 | The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to |
117 | The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to |
… | |
… | |
257 | might be forced to use a different font. |
258 | might be forced to use a different font. |
258 | |
259 | |
259 | All of this is not a problem when using X11 core fonts, as their bounding |
260 | All of this is not a problem when using X11 core fonts, as their bounding |
260 | box data is correct. |
261 | box data is correct. |
261 | |
262 | |
|
|
263 | =item On Solaris 9, many line-drawing characters are too wide. |
|
|
264 | |
|
|
265 | Seems to be a known bug, read |
|
|
266 | L<http://nixdoc.net/files/forum/about34198.html>. Some people use the |
|
|
267 | following ugly workaround to get non-double-wide-characters working: |
|
|
268 | |
|
|
269 | #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x) |
|
|
270 | |
262 | =item My Compose (Multi_key) key is no longer working. |
271 | =item My Compose (Multi_key) key is no longer working. |
263 | |
272 | |
264 | The most common causes for this are that either your locale is not set |
273 | The most common causes for this are that either your locale is not set |
265 | correctly, or you specified a B<preeditStyle> that is not supported by |
274 | correctly, or you specified a B<preeditStyle> that is not supported by |
266 | your input method. For example, if you specified B<OverTheSpot> and |
275 | your input method. For example, if you specified B<OverTheSpot> and |
… | |
… | |
309 | |
318 | |
310 | As you might have guessed, FreeBSD does neither define this symobl nor |
319 | As you might have guessed, FreeBSD does neither define this symobl nor |
311 | does it support it. Instead, it uses it's own internal representation of |
320 | does it support it. Instead, it uses it's own internal representation of |
312 | B<wchar_t>. This is, of course, completely fine with respect to standards. |
321 | B<wchar_t>. This is, of course, completely fine with respect to standards. |
313 | |
322 | |
|
|
323 | However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and |
|
|
324 | C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>. |
|
|
325 | |
314 | However, C<__STDC_ISO_10646__> is the only sane way to support |
326 | C<__STDC_ISO_10646__> is the only sane way to support multi-language |
315 | multi-language apps in an OS, as using a locale-dependent (and |
327 | apps in an OS, as using a locale-dependent (and non-standardized) |
316 | non-standardized) representation of B<wchar_t> makes it impossible to |
328 | representation of B<wchar_t> makes it impossible to convert between |
317 | convert between B<wchar_t> (as used by X11 and your applications) and any |
329 | B<wchar_t> (as used by X11 and your applications) and any other encoding |
318 | other encoding without implementing OS-specific-wrappers for each and |
330 | without implementing OS-specific-wrappers for each and every locale. There |
319 | every locale. There simply are no APIs to convert B<wchar_t> into anything |
331 | simply are no APIs to convert B<wchar_t> into anything except the current |
320 | except the current locale encoding. |
332 | locale encoding. |
321 | |
333 | |
322 | Some applications (such as the formidable B<mlterm>) work around this |
334 | Some applications (such as the formidable B<mlterm>) work around this |
323 | by carrying their own replacement functions for character set handling |
335 | by carrying their own replacement functions for character set handling |
324 | with them, and either implementing OS-dependent hacks or doing multiple |
336 | with them, and either implementing OS-dependent hacks or doing multiple |
325 | conversions (which is slow and unreliable in case the OS implements |
337 | conversions (which is slow and unreliable in case the OS implements |
326 | encodings slightly different than the terminal emulator). |
338 | encodings slightly different than the terminal emulator). |
327 | |
339 | |
328 | The rxvt-unicode author insists that the right way to fix this is in the |
340 | The rxvt-unicode author insists that the right way to fix this is in the |
329 | system libraries once and for all, instead of forcing every app to carry |
341 | system libraries once and for all, instead of forcing every app to carry |
330 | complete replacements for them :) |
342 | complete replacements for them :) |
|
|
343 | |
|
|
344 | =item I use Solaris 9 and it doesn't compile/work/etc. |
|
|
345 | |
|
|
346 | Try the diff in F<doc/solaris9.patch> as a base. It fixes the worst |
|
|
347 | problems with C<wcwidth> and a compile problem. |
|
|
348 | |
|
|
349 | =item How can I use rxvt-unicode under cygwin? |
|
|
350 | |
|
|
351 | rxvt-unicode should compile and run out of the box on cygwin, using |
|
|
352 | the X11 libraries that come with cygwin. libW11 emulation is no |
|
|
353 | longer supported (and makes no sense, either, as it only supported a |
|
|
354 | single font). I recommend starting the X-server in C<-multiwindow> or |
|
|
355 | C<-rootless> mode instead, which will result in similar look&feel as the |
|
|
356 | old libW11 emulation. |
|
|
357 | |
|
|
358 | At the time of this writing, cygwin didn't seem to support any multi-byte |
|
|
359 | encodings, so you are likely limited to 8-bit encodings. |
331 | |
360 | |
332 | =item How does rxvt-unicode determine the encoding to use? |
361 | =item How does rxvt-unicode determine the encoding to use? |
333 | |
362 | |
334 | =item Is there an option to switch encodings? |
363 | =item Is there an option to switch encodings? |
335 | |
364 | |
… | |
… | |
1474 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
1503 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
1475 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
1504 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
1476 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> |
1505 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> |
1477 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> |
1506 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> |
1478 | B<< C<Ps = 20> >> Change default background to B<< C<Pt> >> |
1507 | B<< C<Ps = 20> >> Change default background to B<< C<Pt> >> |
1479 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >> I<rxvt compile-time option> |
1508 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. |
1480 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
1509 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
1481 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >> I<rxvt compile-time option> |
1510 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. |
1482 | B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> |
1511 | B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> |
1483 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
1512 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
1484 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (@@RXVT_NAME@@ extension) |
1513 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills). |
1485 | B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> I<rxvt compile-time option> (rxvt-unicode extension) |
1514 | B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> (Compile menubar). |
1486 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
1515 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
1487 | B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> |
1516 | B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). |
1488 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
1517 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
1489 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
1518 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
1490 | B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
1519 | B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
1491 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
1520 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
|
|
1521 | B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
|
|
1522 | B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
1492 | |
1523 | |
1493 | =end table |
1524 | =end table |
1494 | |
1525 | |
1495 | =back |
1526 | =back |
1496 | |
1527 | |
… | |
… | |
1548 | |
1579 | |
1549 | =item B<< [title:+I<string>] >> |
1580 | =item B<< [title:+I<string>] >> |
1550 | |
1581 | |
1551 | set the current menuBar's title to I<string>, which may contain the |
1582 | set the current menuBar's title to I<string>, which may contain the |
1552 | following format specifiers: |
1583 | following format specifiers: |
1553 | B<%%> : literal B<%> character |
1584 | |
1554 | B<%n> : rxvt name (as per the B<-name> command-line option) |
1585 | B<%n> rxvt name (as per the B<-name> command-line option) |
1555 | B<%v> : rxvt version |
1586 | B<%v> rxvt version |
|
|
1587 | B<%%> literal B<%> character |
1556 | |
1588 | |
1557 | =item B<[done]> |
1589 | =item B<[done]> |
1558 | |
1590 | |
1559 | set menuBar access as B<readonly>. |
1591 | set menuBar access as B<readonly>. |
1560 | End-of-file tag for B<< [read:+I<file>] >> operations. |
1592 | End-of-file tag for B<< [read:+I<file>] >> operations. |
… | |
… | |
2180 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
2212 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
2181 | styles. The fonts can be set manually or automatically. |
2213 | styles. The fonts can be set manually or automatically. |
2182 | |
2214 | |
2183 | =item --with-codesets=NAME,... |
2215 | =item --with-codesets=NAME,... |
2184 | |
2216 | |
2185 | Compile in support for additional codeset (encoding) groups (eu, vn are |
2217 | Compile in support for additional codeset (encoding) groups (C<eu>, C<vn> |
2186 | always compiled in, which includes most 8-bit character sets). These |
2218 | are always compiled in, which includes most 8-bit character sets). These |
2187 | codeset tables are currently only used for driving X11 core fonts, they |
2219 | codeset tables are used for driving X11 core fonts, they are not required |
2188 | are not required for Xft fonts. Compiling them in will make your binary |
2220 | for Xft fonts, although having them compiled in lets rxvt-unicode choose |
2189 | bigger (together about 700kB), but it doesn't increase memory usage unless |
2221 | replacement fonts more intelligently. Compiling them in will make your |
|
|
2222 | binary bigger (all of together cost about 700kB), but it doesn't increase |
2190 | you use an X11 font requiring one of these encodings. |
2223 | memory usage unless you use a font requiring one of these encodings. |
2191 | |
2224 | |
2192 | =begin table |
2225 | =begin table |
2193 | |
2226 | |
2194 | all all available codeset groups |
2227 | all all available codeset groups |
2195 | zh common chinese encodings |
2228 | zh common chinese encodings |
… | |
… | |
2225 | composite characters. This is required for proper viewing of text |
2258 | composite characters. This is required for proper viewing of text |
2226 | where accents are encoded as seperate unicode characters. This is |
2259 | where accents are encoded as seperate unicode characters. This is |
2227 | done by using precomposited characters when available or creating |
2260 | done by using precomposited characters when available or creating |
2228 | new pseudo-characters when no precomposed form exists. |
2261 | new pseudo-characters when no precomposed form exists. |
2229 | |
2262 | |
2230 | Without --enable-unicode3, the number of additional precomposed |
2263 | Without --enable-unicode3, the number of additional precomposed characters |
2231 | characters is rather limited (2048, if this is full, rxvt will use the |
2264 | is rather limited (2048, if this is full, rxvt-unicode will use the |
2232 | private use area, extending the number of combinations to 8448). With |
2265 | private use area, extending the number of combinations to 8448). With |
2233 | --enable-unicode3, no practical limit exists. This will also enable |
2266 | --enable-unicode3, no practical limit exists. |
2234 | storage of characters >65535. |
2267 | |
|
|
2268 | This option will also enable storage (but not display) of characters |
|
|
2269 | beyond plane 0 (>65535) when --enable-unicode3 was not specified. |
2235 | |
2270 | |
2236 | The combining table also contains entries for arabic presentation forms, |
2271 | The combining table also contains entries for arabic presentation forms, |
2237 | but these are not currently used. Bug me if you want these to be used. |
2272 | but these are not currently used. Bug me if you want these to be used (and |
|
|
2273 | tell me how these are to be used...). |
2238 | |
2274 | |
2239 | =item --enable-fallback(=CLASS) |
2275 | =item --enable-fallback(=CLASS) |
2240 | |
2276 | |
2241 | When reading resource settings, also read settings for class CLASS |
2277 | When reading resource settings, also read settings for class CLASS |
2242 | (default: Rxvt). To disable resource fallback use --disable-fallback. |
2278 | (default: Rxvt). To disable resource fallback use --disable-fallback. |
… | |
… | |
2363 | |
2399 | |
2364 | A non-exhaustive list of features enabled by C<--enable-frills> (possibly |
2400 | A non-exhaustive list of features enabled by C<--enable-frills> (possibly |
2365 | in combination with other switches) is: |
2401 | in combination with other switches) is: |
2366 | |
2402 | |
2367 | MWM-hints |
2403 | MWM-hints |
|
|
2404 | EWMH-hints (pid, utf8 names) and protocols (ping) |
2368 | seperate underline colour |
2405 | seperate underline colour |
2369 | settable border widths and borderless switch |
2406 | settable border widths and borderless switch |
2370 | settable extra linespacing |
2407 | settable extra linespacing |
2371 | extra window properties (e.g. UTF-8 window names and PID) |
|
|
2372 | iso-14755-2 and -3, and visual feedback |
2408 | iso-14755-2 and -3, and visual feedback |
2373 | backindex and forwardindex escape sequence |
2409 | backindex and forwardindex escape sequence |
2374 | window op and locale change escape sequences |
2410 | window op and some xterm/OSC escape sequences |
2375 | tripleclickwords |
2411 | tripleclickwords |
2376 | settable insecure mode |
2412 | settable insecure mode |
2377 | keysym remapping support |
2413 | keysym remapping support |
|
|
2414 | cursor blinking and underline cursor |
|
|
2415 | -embed and -pty-fd options |
2378 | |
2416 | |
2379 | =item --enable-iso14755 |
2417 | =item --enable-iso14755 |
2380 | |
2418 | |
2381 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2419 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2382 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
2420 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
… | |
… | |
2421 | |
2459 | |
2422 | Add smart growth/shrink behaviour when changing font size via from hot |
2460 | Add smart growth/shrink behaviour when changing font size via from hot |
2423 | keys. This should keep in a fixed position the rxvt corner which is |
2461 | keys. This should keep in a fixed position the rxvt corner which is |
2424 | closest to a corner of the screen. |
2462 | closest to a corner of the screen. |
2425 | |
2463 | |
2426 | =item --enable-cursor-blink |
|
|
2427 | |
|
|
2428 | Add support for a blinking cursor. |
|
|
2429 | |
|
|
2430 | =item --enable-pointer-blank |
2464 | =item --enable-pointer-blank |
2431 | |
2465 | |
2432 | Add support to have the pointer disappear when typing or inactive. |
2466 | Add support to have the pointer disappear when typing or inactive. |
2433 | |
2467 | |
2434 | =item --with-name=NAME |
2468 | =item --with-name=NAME |