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

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.65 by root, Sat Dec 31 17:16:17 2005 UTC vs.
Revision 1.76 by root, Wed Jan 11 19:55:34 2006 UTC

… …
62memory. 62memory.
63 63
64Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this 64Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this
65still fares rather well. And compared to some monsters like gnome-terminal 65still fares rather well. And compared to some monsters like gnome-terminal
66(21152k + extra 4204k in separate processes) or konsole (22200k + extra 66(21152k + extra 4204k in separate processes) or konsole (22200k + extra
6743180k in daemons that stay around after exit, plus half aminute of 6743180k in daemons that stay around after exit, plus half a minute of
68startup time, including the hundreds of warnings it spits out), it fares 68startup time, including the hundreds of warnings it spits out), it fares
69extremely well *g*. 69extremely well *g*.
70 70
71=item Why C++, isn't that unportable/bloated/uncool? 71=item Why C++, isn't that unportable/bloated/uncool?
72 72
… …
131 131
132For other problems that also affect the Debian package, you can and 132For other problems that also affect the Debian package, you can and
133probably should use the Debian BTS, too, because, after all, it's also a 133probably should use the Debian BTS, too, because, after all, it's also a
134bug in the Debian version and it serves as a reminder for other users that 134bug in the Debian version and it serves as a reminder for other users that
135might encounter the same issue. 135might encounter the same issue.
136
137=item I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
138
139You should build one binary with the default options. F<configure>
140now enables most useful options, and the trend goes to making them
141runtime-switchable, too, so there is usually no drawback to enbaling them,
142except higher disk and possibly memory usage. The perl interpreter should
143be enabled, as important functionality (menus, selection, likely more in
144the future) depends on it.
145
146You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources
147system-wide (except maybe with C<defaults>). This will result in useful
148behaviour. If your distribution aims at low memory, add an empty
149C<perl-ext-common> resource to the app-defaults file. This will keep the
150perl interpreter disabled until the user enables it.
151
152If you can/want build more binaries, I recommend building a minimal
153one with C<--disable-everything> (very useful) and a maximal one with
154C<--enable-everything> (less useful, it will be very big due to a lot of
155encodings built-in that increase download times and are rarely used).
156
157=item I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?
158
159Likely not. While I honestly try to make it secure, and am probably not
160bad at it, I think it is simply unreasonable to expect all of freetype
161+ fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be
162secure. Also, rxvt-unicode disables some options when it detects that it
163runs setuid or setgid, which is not nice. Besides, with the embedded perl
164interpreter the possibility for security problems easily multiplies.
165
166Elevated privileges are only required for utmp and pty operations on some
167systems (for example, GNU/Linux doesn't need any extra privileges for
168ptys, but some need it for utmp support). It is planned to mvoe this into
169a forked handler process, but this is not yet done.
170
171So, while setuid/setgid operation is supported and not a problem on your
172typical single-user-no-other-logins unix desktop, always remember that
173its an awful lot of code, most of which isn't checked for security issues
174regularly.
136 175
137=item When I log-in to another system it tells me about missing terminfo data? 176=item When I log-in to another system it tells me about missing terminfo data?
138 177
139The terminal description used by rxvt-unicode is not as widely available 178The terminal description used by rxvt-unicode is not as widely available
140as that for xterm, or even rxvt (for which the same problem often arises). 179as that for xterm, or even rxvt (for which the same problem often arises).
… …
1538=item B<< C<Ps = 1021> >> (B<rxvt>) 1577=item B<< C<Ps = 1021> >> (B<rxvt>)
1539 1578
1540=begin table 1579=begin table
1541 1580
1542 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>) 1581 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>)
1543 B<< C<l> >> Font styles have no effect on intensity. 1582 B<< C<l> >> Font styles have no effect on intensity (Compile styles)
1544 1583
1545=end table 1584=end table
1546 1585
1547=item B<< C<Ps = 1047> >> 1586=item B<< C<Ps = 1047> >>
1548 1587
… …
1597 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<(NB: may change in future)> 1636 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<(NB: may change in future)>
1598 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> B<(NB: may change in future)> 1637 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> B<(NB: may change in future)>
1599 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> 1638 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >>
1600 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> 1639 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >>
1601 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> 1640 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >>
1602 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> 1641 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706]
1603 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> 1642 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707]
1604 B<< C<Ps = 20> >> Change default background to B<< C<Pt> >> 1643 B<< C<Ps = 20> >> Change default background to B<< C<Pt> >>
1605 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. 1644 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>.
1606 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> 1645 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
1607 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. 1646 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>.
1608 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> >> 1647 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> >>
1609 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> 1648 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >>
1610 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). 1649 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).
1611 B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> (Compile menubar). 1650 B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> (Compile menubar).
1612 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> 1651 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >>
1613 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). 1652 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency).
1653 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
1654 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >>
1614 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. 1655 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>.
1615 B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 1656 B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
1616 B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 1657 B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
1617 B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 1658 B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
1618 B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). 1659 B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
1619 B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). 1660 B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
1661 B<< C<Ps = 777> >> Call the perl extension with the given string, which should be of the form C<extension:parameters> (Compile perl).
1620 1662
1621=end table 1663=end table
1622 1664
1623=back 1665=back
1624 1666
… …
2405 2447
2406Write user and tty to lastlog file (used by programs like 2448Write user and tty to lastlog file (used by programs like
2407F<lastlogin>) at start of rxvt execution. This option requires 2449F<lastlogin>) at start of rxvt execution. This option requires
2408--enable-utmp to also be specified. 2450--enable-utmp to also be specified.
2409 2451
2410=item --enable-xpm-background (default: off) 2452=item --enable-xpm-background (default: on)
2411 2453
2412Add support for XPM background pixmaps. 2454Add support for XPM background pixmaps.
2413 2455
2414=item --enable-transparency (default: off) 2456=item --enable-transparency (default: on)
2415 2457
2416Add support for inheriting parent backgrounds thus giving a fake 2458Add support for inheriting parent backgrounds thus giving a fake
2417transparency to the term. 2459transparency to the term.
2418 2460
2419=item --enable-fading (default: on) 2461=item --enable-fading (default: on)
… …
2422 2464
2423=item --enable-tinting (default: on) 2465=item --enable-tinting (default: on)
2424 2466
2425Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). 2467Add support for tinting of transparent backgrounds (requires C<--enable-transparency>).
2426 2468
2427=item --enable-menubar (default: off) 2469=item --enable-menubar (default: off) [DEPRECATED]
2428 2470
2429Add support for our menu bar system (this interacts badly with 2471Add support for our menu bar system (this interacts badly with dynamic
2430dynamic locale switching currently). 2472locale switching currently). This option is DEPRECATED and will be removed
2473in the future.
2431 2474
2432=item --enable-rxvt-scroll (default: on) 2475=item --enable-rxvt-scroll (default: on)
2433 2476
2434Add support for the original rxvt scrollbar. 2477Add support for the original rxvt scrollbar.
2435 2478
… …
2501A non-exhaustive list of features enabled by C<--enable-frills> (possibly 2544A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2502in combination with other switches) is: 2545in combination with other switches) is:
2503 2546
2504 MWM-hints 2547 MWM-hints
2505 EWMH-hints (pid, utf8 names) and protocols (ping) 2548 EWMH-hints (pid, utf8 names) and protocols (ping)
2506 seperate underline colour 2549 seperate underline colour (-underlineColor)
2507 settable border widths and borderless switch 2550 settable border widths and borderless switch (-w, -b, -bl)
2508 settable extra linespacing 2551 settable extra linespacing /-lsp)
2509 iso-14755-2 and -3, and visual feedback 2552 iso-14755-2 and -3, and visual feedback
2510 backindex and forwardindex escape sequence 2553 backindex and forwardindex escape sequence
2511 window op and some xterm/OSC escape sequences 2554 window op and some xterm/OSC escape sequences
2512 tripleclickwords 2555 tripleclickwords (-tcw)
2513 settable insecure mode 2556 settable insecure mode (-insecure)
2514 keysym remapping support 2557 keysym remapping support
2515 cursor blinking and underline cursor 2558 cursor blinking and underline cursor (-cb, -uc)
2516 -embed, -pty-fd and -hold options 2559 XEmbed support (-embed)
2560 user-pty (-pty-fd)
2561 hold on exit (-hold)
2562 skip builtin block graphics (-sbg)
2563 sgr modes 90..97 and 100..107
2517 2564
2518=item --enable-iso14755 (default: on) 2565=item --enable-iso14755 (default: on)
2519 2566
2520Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2567Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2521F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2568F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by
… …
2564 2611
2565=item --enable-pointer-blank (default: on) 2612=item --enable-pointer-blank (default: on)
2566 2613
2567Add support to have the pointer disappear when typing or inactive. 2614Add support to have the pointer disappear when typing or inactive.
2568 2615
2616=item --enable-perl (default: off)
2617
2618Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2619manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files
2620in F<src/perl-ext/> for the extensions that are installed by default. The
2621perl interpreter that is used can be specified via the C<PERL> environment
2622variable when running configure.
2623
2569=item --with-name=NAME (default: urxvt) 2624=item --with-name=NAME (default: urxvt)
2570 2625
2571Set the basename for the installed binaries, resulting 2626Set the basename for the installed binaries, resulting
2572in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with 2627in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with
2573C<rxvt>. 2628C<rxvt>.

Diff Legend

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