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.64 by root, Sat Dec 24 12:55:17 2005 UTC vs.
Revision 1.73 by root, Mon Jan 9 01:54:43 2006 UTC

… …
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).
… …
1530 1569
1531=begin table 1570=begin table
1532 1571
1533 B<< C<h> >> Scroll to bottom when a key is pressed 1572 B<< C<h> >> Scroll to bottom when a key is pressed
1534 B<< C<l> >> Don't scroll to bottom when a key is pressed 1573 B<< C<l> >> Don't scroll to bottom when a key is pressed
1574
1575=end table
1576
1577=item B<< C<Ps = 1021> >> (B<rxvt>)
1578
1579=begin table
1580
1581 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>)
1582 B<< C<l> >> Font styles have no effect on intensity (Compile styles)
1535 1583
1536=end table 1584=end table
1537 1585
1538=item B<< C<Ps = 1047> >> 1586=item B<< C<Ps = 1047> >>
1539 1587
… …
1606 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).
1607 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).
1608 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).
1609 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).
1610 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).
1611 1660
1612=end table 1661=end table
1613 1662
1614=back 1663=back
1615 1664
… …
2396 2445
2397Write user and tty to lastlog file (used by programs like 2446Write user and tty to lastlog file (used by programs like
2398F<lastlogin>) at start of rxvt execution. This option requires 2447F<lastlogin>) at start of rxvt execution. This option requires
2399--enable-utmp to also be specified. 2448--enable-utmp to also be specified.
2400 2449
2401=item --enable-xpm-background (default: off) 2450=item --enable-xpm-background (default: on)
2402 2451
2403Add support for XPM background pixmaps. 2452Add support for XPM background pixmaps.
2404 2453
2405=item --enable-transparency (default: off) 2454=item --enable-transparency (default: on)
2406 2455
2407Add support for inheriting parent backgrounds thus giving a fake 2456Add support for inheriting parent backgrounds thus giving a fake
2408transparency to the term. 2457transparency to the term.
2409 2458
2410=item --enable-fading (default: on) 2459=item --enable-fading (default: on)
… …
2413 2462
2414=item --enable-tinting (default: on) 2463=item --enable-tinting (default: on)
2415 2464
2416Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). 2465Add support for tinting of transparent backgrounds (requires C<--enable-transparency>).
2417 2466
2418=item --enable-menubar (default: off) 2467=item --enable-menubar (default: off) [DEPRECATED]
2419 2468
2420Add support for our menu bar system (this interacts badly with 2469Add support for our menu bar system (this interacts badly with dynamic
2421dynamic locale switching currently). 2470locale switching currently). This option is DEPRECATED and will be removed
2471in the future.
2422 2472
2423=item --enable-rxvt-scroll (default: on) 2473=item --enable-rxvt-scroll (default: on)
2424 2474
2425Add support for the original rxvt scrollbar. 2475Add support for the original rxvt scrollbar.
2426 2476
… …
2492A non-exhaustive list of features enabled by C<--enable-frills> (possibly 2542A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2493in combination with other switches) is: 2543in combination with other switches) is:
2494 2544
2495 MWM-hints 2545 MWM-hints
2496 EWMH-hints (pid, utf8 names) and protocols (ping) 2546 EWMH-hints (pid, utf8 names) and protocols (ping)
2497 seperate underline colour 2547 seperate underline colour (-underlineColor)
2498 settable border widths and borderless switch 2548 settable border widths and borderless switch (-w, -b, -bl)
2499 settable extra linespacing 2549 settable extra linespacing /-lsp)
2500 iso-14755-2 and -3, and visual feedback 2550 iso-14755-2 and -3, and visual feedback
2501 backindex and forwardindex escape sequence 2551 backindex and forwardindex escape sequence
2502 window op and some xterm/OSC escape sequences 2552 window op and some xterm/OSC escape sequences
2503 tripleclickwords 2553 tripleclickwords (-tcw)
2504 settable insecure mode 2554 settable insecure mode (-insecure)
2505 keysym remapping support 2555 keysym remapping support
2506 cursor blinking and underline cursor 2556 cursor blinking and underline cursor (-cb, -uc)
2507 -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
2508 2562
2509=item --enable-iso14755 (default: on) 2563=item --enable-iso14755 (default: on)
2510 2564
2511Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2565Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2512F<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
… …
2555 2609
2556=item --enable-pointer-blank (default: on) 2610=item --enable-pointer-blank (default: on)
2557 2611
2558Add support to have the pointer disappear when typing or inactive. 2612Add support to have the pointer disappear when typing or inactive.
2559 2613
2614=item --enable-perl (default: off)
2615
2616Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2617manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files
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.
2621
2560=item --with-name=NAME (default: urxvt) 2622=item --with-name=NAME (default: urxvt)
2561 2623
2562Set the basename for the installed binaries, resulting 2624Set the basename for the installed binaries, resulting
2563in 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
2564C<rxvt>. 2626C<rxvt>.

Diff Legend

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