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.67 by root, Mon Jan 2 19:36:07 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).
… …
1615 B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 1654 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). 1655 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). 1656 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). 1657 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). 1658 B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
1659 B<< C<Ps = 777> >> Call the perl extension with the given string, which should be of the form C<extension:parameters> (Compile perl).
1620 1660
1621=end table 1661=end table
1622 1662
1623=back 1663=back
1624 1664
… …
2405 2445
2406Write user and tty to lastlog file (used by programs like 2446Write user and tty to lastlog file (used by programs like
2407F<lastlogin>) at start of rxvt execution. This option requires 2447F<lastlogin>) at start of rxvt execution. This option requires
2408--enable-utmp to also be specified. 2448--enable-utmp to also be specified.
2409 2449
2410=item --enable-xpm-background (default: off) 2450=item --enable-xpm-background (default: on)
2411 2451
2412Add support for XPM background pixmaps. 2452Add support for XPM background pixmaps.
2413 2453
2414=item --enable-transparency (default: off) 2454=item --enable-transparency (default: on)
2415 2455
2416Add support for inheriting parent backgrounds thus giving a fake 2456Add support for inheriting parent backgrounds thus giving a fake
2417transparency to the term. 2457transparency to the term.
2418 2458
2419=item --enable-fading (default: on) 2459=item --enable-fading (default: on)
… …
2422 2462
2423=item --enable-tinting (default: on) 2463=item --enable-tinting (default: on)
2424 2464
2425Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). 2465Add support for tinting of transparent backgrounds (requires C<--enable-transparency>).
2426 2466
2427=item --enable-menubar (default: off) 2467=item --enable-menubar (default: off) [DEPRECATED]
2428 2468
2429Add support for our menu bar system (this interacts badly with 2469Add support for our menu bar system (this interacts badly with dynamic
2430dynamic locale switching currently). 2470locale switching currently). This option is DEPRECATED and will be removed
2471in the future.
2431 2472
2432=item --enable-rxvt-scroll (default: on) 2473=item --enable-rxvt-scroll (default: on)
2433 2474
2434Add support for the original rxvt scrollbar. 2475Add support for the original rxvt scrollbar.
2435 2476
… …
2501A non-exhaustive list of features enabled by C<--enable-frills> (possibly 2542A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2502in combination with other switches) is: 2543in combination with other switches) is:
2503 2544
2504 MWM-hints 2545 MWM-hints
2505 EWMH-hints (pid, utf8 names) and protocols (ping) 2546 EWMH-hints (pid, utf8 names) and protocols (ping)
2506 seperate underline colour 2547 seperate underline colour (-underlineColor)
2507 settable border widths and borderless switch 2548 settable border widths and borderless switch (-w, -b, -bl)
2508 settable extra linespacing 2549 settable extra linespacing /-lsp)
2509 iso-14755-2 and -3, and visual feedback 2550 iso-14755-2 and -3, and visual feedback
2510 backindex and forwardindex escape sequence 2551 backindex and forwardindex escape sequence
2511 window op and some xterm/OSC escape sequences 2552 window op and some xterm/OSC escape sequences
2512 tripleclickwords 2553 tripleclickwords (-tcw)
2513 settable insecure mode 2554 settable insecure mode (-insecure)
2514 keysym remapping support 2555 keysym remapping support
2515 cursor blinking and underline cursor 2556 cursor blinking and underline cursor (-cb, -uc)
2516 -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
2517 2562
2518=item --enable-iso14755 (default: on) 2563=item --enable-iso14755 (default: on)
2519 2564
2520Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2565Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2521F<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
… …
2566 2611
2567Add support to have the pointer disappear when typing or inactive. 2612Add support to have the pointer disappear when typing or inactive.
2568 2613
2569=item --enable-perl (default: off) 2614=item --enable-perl (default: off)
2570 2615
2571Enable an embedded perl interpreter. See the B<rxvtperl(3)> manpage 2616Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2572(F<doc/rxvtperl.txt>) for more info on this feature, or the files in 2617manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files
2573F<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.
2574 2621
2575=item --with-name=NAME (default: urxvt) 2622=item --with-name=NAME (default: urxvt)
2576 2623
2577Set the basename for the installed binaries, resulting 2624Set the basename for the installed binaries, resulting
2578in 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