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.69 by root, Wed Jan 4 00:10:29 2006 UTC vs.
Revision 1.74 by root, Mon Jan 9 07:24:43 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
160not bad at it, I think it is simply unreasonable to expect all of
161freetype + fontconfig + xft + xlib + ... + 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.
164
165Elevated privileges are only required for utmp and pty operations on some
166systems (for example, GNU/Linux doesn't need any extra privileges for
167ptys, but some need it for utmp support). If rxvt-unicode doesn't support
168the library/setuid helper that your OS needs I'll be happy to assist you
169in implementing support for it.
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).
… …
2406 2445
2407Write user and tty to lastlog file (used by programs like 2446Write user and tty to lastlog file (used by programs like
2408F<lastlogin>) at start of rxvt execution. This option requires 2447F<lastlogin>) at start of rxvt execution. This option requires
2409--enable-utmp to also be specified. 2448--enable-utmp to also be specified.
2410 2449
2411=item --enable-xpm-background (default: off) 2450=item --enable-xpm-background (default: on)
2412 2451
2413Add support for XPM background pixmaps. 2452Add support for XPM background pixmaps.
2414 2453
2415=item --enable-transparency (default: off) 2454=item --enable-transparency (default: on)
2416 2455
2417Add support for inheriting parent backgrounds thus giving a fake 2456Add support for inheriting parent backgrounds thus giving a fake
2418transparency to the term. 2457transparency to the term.
2419 2458
2420=item --enable-fading (default: on) 2459=item --enable-fading (default: on)
… …
2423 2462
2424=item --enable-tinting (default: on) 2463=item --enable-tinting (default: on)
2425 2464
2426Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). 2465Add support for tinting of transparent backgrounds (requires C<--enable-transparency>).
2427 2466
2428=item --enable-menubar (default: off) 2467=item --enable-menubar (default: off) [DEPRECATED]
2429 2468
2430Add support for our menu bar system (this interacts badly with 2469Add support for our menu bar system (this interacts badly with dynamic
2431dynamic locale switching currently). 2470locale switching currently). This option is DEPRECATED and will be removed
2471in the future.
2432 2472
2433=item --enable-rxvt-scroll (default: on) 2473=item --enable-rxvt-scroll (default: on)
2434 2474
2435Add support for the original rxvt scrollbar. 2475Add support for the original rxvt scrollbar.
2436 2476
… …
2502A non-exhaustive list of features enabled by C<--enable-frills> (possibly 2542A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2503in combination with other switches) is: 2543in combination with other switches) is:
2504 2544
2505 MWM-hints 2545 MWM-hints
2506 EWMH-hints (pid, utf8 names) and protocols (ping) 2546 EWMH-hints (pid, utf8 names) and protocols (ping)
2507 seperate underline colour 2547 seperate underline colour (-underlineColor)
2508 settable border widths and borderless switch 2548 settable border widths and borderless switch (-w, -b, -bl)
2509 settable extra linespacing 2549 settable extra linespacing /-lsp)
2510 iso-14755-2 and -3, and visual feedback 2550 iso-14755-2 and -3, and visual feedback
2511 backindex and forwardindex escape sequence 2551 backindex and forwardindex escape sequence
2512 window op and some xterm/OSC escape sequences 2552 window op and some xterm/OSC escape sequences
2513 tripleclickwords 2553 tripleclickwords (-tcw)
2514 settable insecure mode 2554 settable insecure mode (-insecure)
2515 keysym remapping support 2555 keysym remapping support
2516 cursor blinking and underline cursor 2556 cursor blinking and underline cursor (-cb, -uc)
2517 -embed, -pty-fd and -hold options 2557 XEmbed support (-embed)
2558 user-pty (-pty-fd)
2559 hold on exit (-hold)
2560 skip builtin block graphics (-sbg)
2561 sgr modes 90..97 and 100..107
2518 2562
2519=item --enable-iso14755 (default: on) 2563=item --enable-iso14755 (default: on)
2520 2564
2521Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2565Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2522F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2566F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by
… …
2569 2613
2570=item --enable-perl (default: off) 2614=item --enable-perl (default: off)
2571 2615
2572Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> 2616Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2573manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files 2617manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files
2574in F<src/perl-ext/> for the extensions that are installed by default. 2618in F<src/perl-ext/> for the extensions that are installed by default. The
2619perl interpreter that is used can be specified via the C<PERL> environment
2620variable when running configure.
2575 2621
2576=item --with-name=NAME (default: urxvt) 2622=item --with-name=NAME (default: urxvt)
2577 2623
2578Set the basename for the installed binaries, resulting 2624Set the basename for the installed binaries, resulting
2579in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with 2625in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with

Diff Legend

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