ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.html
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.html (file contents):
Revision 1.47 by root, Mon Jan 16 15:12:48 2006 UTC vs.
Revision 1.52 by root, Sat Jan 28 22:16:58 2006 UTC

… …
218</dd> 218</dd>
219<p></p> 219<p></p>
220<dt><strong><a name="item_does_it_support_tabs_2c_can_i_have_a_tabbed_rxvt_2">Does it support tabs, can I have a tabbed rxvt-unicode?</a></strong><br /> 220<dt><strong><a name="item_does_it_support_tabs_2c_can_i_have_a_tabbed_rxvt_2">Does it support tabs, can I have a tabbed rxvt-unicode?</a></strong><br />
221</dt> 221</dt>
222<dd> 222<dd>
223rxvt-unicode does not directly support tabs. It will work fine with 223Beginning with version 7.3, there is a perl extension that implements a
224tabbing functionality of many window managers or similar tabbing programs, 224simple tabbed terminal. It is installed by default, so any of these should
225and its embedding-features allow it to be embedded into other programs, 225give you tabs:
226as witnessed by <em>doc/rxvt-tabbed</em> or the upcoming <code>Gtk2::URxvt</code> perl 226</dd>
227module, which features a tabbed urxvt (murxvt) terminal as an example 227<dd>
228embedding application. 228<pre>
229 rxvt -pe tabbed</pre>
230</dd>
231<dd>
232<pre>
233 URxvt.perl-ext-common: default,tabbed</pre>
234</dd>
235<dd>
236<p>It will also work fine with tabbing functionality of many window managers
237or similar tabbing programs, and its embedding-features allow it to be
238embedded into other programs, as witnessed by <em>doc/rxvt-tabbed</em> or
239the upcoming <code>Gtk2::URxvt</code> perl module, which features a tabbed urxvt
240(murxvt) terminal as an example embedding application.</p>
229</dd> 241</dd>
230<p></p> 242<p></p>
231<dt><strong><a name="item_how_do_i_know_which_rxvt_2dunicode_version_i_27m_u">How do I know which rxvt-unicode version I'm using?</a></strong><br /> 243<dt><strong><a name="item_how_do_i_know_which_rxvt_2dunicode_version_i_27m_u">How do I know which rxvt-unicode version I'm using?</a></strong><br />
232</dt> 244</dt>
233<dd> 245<dd>
… …
239<p></p> 251<p></p>
240<dt><strong><a name="item_i_am_using_debian_gnu_2flinux_and_have_a_problem_2">I am using Debian GNU/Linux and have a problem...</a></strong><br /> 252<dt><strong><a name="item_i_am_using_debian_gnu_2flinux_and_have_a_problem_2">I am using Debian GNU/Linux and have a problem...</a></strong><br />
241</dt> 253</dt>
242<dd> 254<dd>
243The Debian GNU/Linux package of rxvt-unicode in sarge contains large 255The Debian GNU/Linux package of rxvt-unicode in sarge contains large
244patches that considerably change the behaviour of rxvt-unicode. Before 256patches that considerably change the behaviour of rxvt-unicode (but
245reporting a bug to the original rxvt-unicode author please download and 257unfortunately this notice has been removed). Before reporting a bug to
258the original rxvt-unicode author please download and install the genuine
246install the genuine version (<a href="http://software.schmorp.de#rxvt-unicode">http://software.schmorp.de#rxvt-unicode</a>) 259version (<a href="http://software.schmorp.de#rxvt-unicode">http://software.schmorp.de#rxvt-unicode</a>) and try to reproduce
247and try to reproduce the problem. If you cannot, chances are that the 260the problem. If you cannot, chances are that the problems are specific to
248problems are specific to Debian GNU/Linux, in which case it should be 261Debian GNU/Linux, in which case it should be reported via the Debian Bug
249reported via the Debian Bug Tracking System (use <code>reportbug</code> to report 262Tracking System (use <code>reportbug</code> to report the bug).
250the bug).
251</dd> 263</dd>
252<dd> 264<dd>
253<p>For other problems that also affect the Debian package, you can and 265<p>For other problems that also affect the Debian package, you can and
254probably should use the Debian BTS, too, because, after all, it's also a 266probably should use the Debian BTS, too, because, after all, it's also a
255bug in the Debian version and it serves as a reminder for other users that 267bug in the Debian version and it serves as a reminder for other users that
256might encounter the same issue.</p> 268might encounter the same issue.</p>
257</dd> 269</dd>
258<p></p> 270<p></p>
259<dt><strong><a name="item_i_am_maintaining_rxvt_2dunicode_for_distribution_2">I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?</a></strong><br /> 271<dt><strong><a name="item_i_am_maintaining_rxvt_2dunicode_for_distribution_2">I am maintaining rxvt-unicode for distribution/OS XXX, any
272recommendation?</a></strong><br />
260</dt> 273</dt>
261<dd> 274<dd>
262You should build one binary with the default options. <em>configure</em> 275You should build one binary with the default options. <em>configure</em>
263now enables most useful options, and the trend goes to making them 276now enables most useful options, and the trend goes to making them
264runtime-switchable, too, so there is usually no drawback to enbaling them, 277runtime-switchable, too, so there is usually no drawback to enbaling them,
… …
281</dd> 294</dd>
282<p></p> 295<p></p>
283<dt><strong><a name="item_i_need_to_make_it_setuid_2fsetgid_to_support_utmp_">I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?</a></strong><br /> 296<dt><strong><a name="item_i_need_to_make_it_setuid_2fsetgid_to_support_utmp_">I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?</a></strong><br />
284</dt> 297</dt>
285<dd> 298<dd>
286Likely not. While I honestly try to make it secure, and am probably not 299It should be, starting with release 7.1. You are encouraged to properly
287bad at it, I think it is simply unreasonable to expect all of freetype 300install urxvt with privileges necessary for your OS now.
288+ fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be
289secure. Also, rxvt-unicode disables some options when it detects that it
290runs setuid or setgid, which is not nice. Besides, with the embedded perl
291interpreter the possibility for security problems easily multiplies.
292</dd>
293<dd> 301</dd>
294<p>Elevated privileges are only required for utmp and pty operations on some
295systems (for example, GNU/Linux doesn't need any extra privileges for
296ptys, but some need it for utmp support). It is planned to mvoe this into
297a forked handler process, but this is not yet done.</p>
298</dd> 302<dd>
303<p>When rxvt-unicode detects that it runs setuid or setgid, it will fork
304into a helper process for privileged operations (pty handling on some
305systems, utmp/wtmp/lastlog handling on others) and drop privileges
306immediately. This is much safer than most other terminals that keep
307privileges while running (but is more relevant to urxvt, as it contains
308things as perl interpreters, which might be ``helpful'' to attackers).</p>
299<dd> 309</dd>
300<p>So, while setuid/setgid operation is supported and not a problem on your 310<dd>
301typical single-user-no-other-logins unix desktop, always remember that 311<p>This forking is done as the very first within main(), which is very early
302its an awful lot of code, most of which isn't checked for security issues 312and reduces possible bugs to initialisation code run before main(), or
303regularly.</p> 313things like the dynamic loader of your system, which should result in very
314little risk.</p>
304</dd> 315</dd>
305<p></p> 316<p></p>
306<dt><strong><a name="item_when_i_log_2din_to_another_system_it_tells_me_abou">When I log-in to another system it tells me about missing terminfo data?</a></strong><br /> 317<dt><strong><a name="item_when_i_log_2din_to_another_system_it_tells_me_abou">When I log-in to another system it tells me about missing terminfo data?</a></strong><br />
307</dt> 318</dt>
308<dd> 319<dd>
… …
1949<tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr> 1960<tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr>
1950<tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr> 1961<tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr>
1951<tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr> 1962<tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr>
1952<tr><td>Ps = 18</td><td>Change colour of bold characters to Pt [deprecated, see 706]</td></tr> 1963<tr><td>Ps = 18</td><td>Change colour of bold characters to Pt [deprecated, see 706]</td></tr>
1953<tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt [deprecated, see 707]</td></tr> 1964<tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt [deprecated, see 707]</td></tr>
1954<tr><td>Ps = 20</td><td>Change default background to Pt</td></tr> 1965<tr><td>Ps = 20</td><td>Change background pixmap parameters (see section XPM) (Compile XPM).</td></tr>
1955<tr><td>Ps = 39</td><td>Change default foreground colour to Pt.</td></tr> 1966<tr><td>Ps = 39</td><td>Change default foreground colour to Pt.</td></tr>
1956<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr> 1967<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr>
1957<tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr> 1968<tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr>
1958<tr><td>Ps = 50</td><td>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</td></tr> 1969<tr><td>Ps = 50</td><td>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</td></tr>
1959<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr> 1970<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr>
1960<tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).</td></tr> 1971<tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).</td></tr>
1972<tr><td>Ps = 702</td><td>Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST.</td></tr>
1961<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr> 1973<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr>
1962<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr> 1974<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr>
1963<tr><td>Ps = 706</td><td>Change colour of bold characters to Pt</td></tr> 1975<tr><td>Ps = 706</td><td>Change colour of bold characters to Pt</td></tr>
1964<tr><td>Ps = 707</td><td>Change colour of underlined characters to Pt</td></tr> 1976<tr><td>Ps = 707</td><td>Change colour of underlined characters to Pt</td></tr>
1965<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr> 1977<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr>
… …
2227</dd> 2239</dd>
2228<p></p> 2240<p></p>
2229<dt><strong><a name="item_unicode3">--enable-unicode3 (default: off)</a></strong><br /> 2241<dt><strong><a name="item_unicode3">--enable-unicode3 (default: off)</a></strong><br />
2230</dt> 2242</dt>
2231<dd> 2243<dd>
2244Recommended to stay off unless you really need non-BMP characters.
2245</dd>
2246<dd>
2232Enable direct support for displaying unicode codepoints above 2247<p>Enable direct support for displaying unicode codepoints above
223365535 (the basic multilingual page). This increases storage 224865535 (the basic multilingual page). This increases storage
2234requirements per character from 2 to 4 bytes. X11 fonts do not yet 2249requirements per character from 2 to 4 bytes. X11 fonts do not yet
2235support these extra characters, but Xft does. 2250support these extra characters, but Xft does.</p>
2236</dd> 2251</dd>
2237<dd> 2252<dd>
2238<p>Please note that rxvt-unicode can store unicode code points &gt;65535 2253<p>Please note that rxvt-unicode can store unicode code points &gt;65535
2239even without this flag, but the number of such characters is 2254even without this flag, but the number of such characters is
2240limited to a view thousand (shared with combining characters, 2255limited to a view thousand (shared with combining characters,
… …
2250where accents are encoded as seperate unicode characters. This is 2265where accents are encoded as seperate unicode characters. This is
2251done by using precomposited characters when available or creating 2266done by using precomposited characters when available or creating
2252new pseudo-characters when no precomposed form exists. 2267new pseudo-characters when no precomposed form exists.
2253</dd> 2268</dd>
2254<dd> 2269<dd>
2255<p>Without --enable-unicode3, the number of additional precomposed characters 2270<p>Without --enable-unicode3, the number of additional precomposed
2256is rather limited (2048, if this is full, rxvt-unicode will use the 2271characters is somewhat limited (the 6400 private use characters will be
2257private use area, extending the number of combinations to 8448). With
2258--enable-unicode3, no practical limit exists.</p> 2272(ab-)used). With --enable-unicode3, no practical limit exists.</p>
2259</dd> 2273</dd>
2260<dd> 2274<dd>
2261<p>This option will also enable storage (but not display) of characters 2275<p>This option will also enable storage (but not display) of characters
2262beyond plane 0 (&gt;65535) when --enable-unicode3 was not specified.</p> 2276beyond plane 0 (&gt;65535) when --enable-unicode3 was not specified.</p>
2263</dd> 2277</dd>
… …
2268</dd> 2282</dd>
2269<p></p> 2283<p></p>
2270<dt><strong><a name="item_fallback">--enable-fallback(=CLASS) (default: Rxvt)</a></strong><br /> 2284<dt><strong><a name="item_fallback">--enable-fallback(=CLASS) (default: Rxvt)</a></strong><br />
2271</dt> 2285</dt>
2272<dd> 2286<dd>
2273When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. 2287When reading resource settings, also read settings for class CLASS. To
2288disable resource fallback use --disable-fallback.
2274</dd> 2289</dd>
2275<p></p> 2290<p></p>
2276<dt><strong><a name="item_name">--with-res-name=NAME (default: urxvt)</a></strong><br /> 2291<dt><strong><a name="item_name">--with-res-name=NAME (default: urxvt)</a></strong><br />
2277</dt> 2292</dt>
2278<dd> 2293<dd>
… …
2358</dt> 2373</dt>
2359<dd> 2374<dd>
2360Add support for a very unobtrusive, plain-looking scrollbar that 2375Add support for a very unobtrusive, plain-looking scrollbar that
2361is the favourite of the rxvt-unicode author, having used it for 2376is the favourite of the rxvt-unicode author, having used it for
2362many years. 2377many years.
2363</dd>
2364<p></p>
2365<dt><strong><a name="item_shadow">--enable-half-shadow (default: off)</a></strong><br />
2366</dt>
2367<dd>
2368Make shadows on the scrollbar only half the normal width &amp; height.
2369only applicable to rxvt scrollbars.
2370</dd> 2378</dd>
2371<p></p> 2379<p></p>
2372<dt><strong><a name="item_ttygid">--enable-ttygid (default: off)</a></strong><br /> 2380<dt><strong><a name="item_ttygid">--enable-ttygid (default: off)</a></strong><br />
2373</dt> 2381</dt>
2374<dd> 2382<dd>
… …
2416<pre> 2424<pre>
2417 MWM-hints 2425 MWM-hints
2418 EWMH-hints (pid, utf8 names) and protocols (ping) 2426 EWMH-hints (pid, utf8 names) and protocols (ping)
2419 seperate underline colour (-underlineColor) 2427 seperate underline colour (-underlineColor)
2420 settable border widths and borderless switch (-w, -b, -bl) 2428 settable border widths and borderless switch (-w, -b, -bl)
2429 visual selection (-depth)
2421 settable extra linespacing /-lsp) 2430 settable extra linespacing /-lsp)
2422 iso-14755-2 and -3, and visual feedback 2431 iso-14755-2 and -3, and visual feedback
2423 backindex and forwardindex escape sequence 2432 backindex and forwardindex escape sequence
2424 window op and some xterm/OSC escape sequences 2433 window op and some xterm/OSC escape sequences
2425 tripleclickwords (-tcw) 2434 tripleclickwords (-tcw)
… …
2501</dt> 2510</dt>
2502<dd> 2511<dd>
2503Add support to have the pointer disappear when typing or inactive. 2512Add support to have the pointer disappear when typing or inactive.
2504</dd> 2513</dd>
2505<p></p> 2514<p></p>
2506<dt><strong><a name="item_perl">--enable-perl (default: off)</a></strong><br /> 2515<dt><strong><a name="item_perl">--enable-perl (default: on)</a></strong><br />
2507</dt> 2516</dt>
2508<dd> 2517<dd>
2509Enable an embedded perl interpreter. See the <strong>rxvtperl(3)</strong> 2518Enable an embedded perl interpreter. See the <strong>rxvtperl(3)</strong>
2510manpage (<em>doc/rxvtperl.txt</em>) for more info on this feature, or the files 2519manpage (<em>doc/rxvtperl.txt</em>) for more info on this feature, or the files
2511in <em>src/perl-ext/</em> for the extensions that are installed by default. The 2520in <em>src/perl-ext/</em> for the extensions that are installed by default. The

Diff Legend

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