--- rxvt-unicode/doc/rxvt.7.html 2006/01/16 15:12:48 1.47 +++ rxvt-unicode/doc/rxvt.7.html 2006/01/28 22:16:58 1.52 @@ -220,12 +220,24 @@
Does it support tabs, can I have a tabbed rxvt-unicode?
-rxvt-unicode does not directly support tabs. It will work fine with -tabbing functionality of many window managers or similar tabbing programs, -and its embedding-features allow it to be embedded into other programs, -as witnessed by doc/rxvt-tabbed or the upcoming Gtk2::URxvt perl -module, which features a tabbed urxvt (murxvt) terminal as an example -embedding application. +Beginning with version 7.3, there is a perl extension that implements a +simple tabbed terminal. It is installed by default, so any of these should +give you tabs: +
+
+
+   rxvt -pe tabbed
+
+
+
+   URxvt.perl-ext-common: default,tabbed
+
+
+

It will also work fine with tabbing functionality of many window managers +or similar tabbing programs, and its embedding-features allow it to be +embedded into other programs, as witnessed by doc/rxvt-tabbed or +the upcoming Gtk2::URxvt perl module, which features a tabbed urxvt +(murxvt) terminal as an example embedding application.

How do I know which rxvt-unicode version I'm using?
@@ -241,13 +253,13 @@
The Debian GNU/Linux package of rxvt-unicode in sarge contains large -patches that considerably change the behaviour of rxvt-unicode. Before -reporting a bug to the original rxvt-unicode author please download and -install the genuine version (http://software.schmorp.de#rxvt-unicode) -and try to reproduce the problem. If you cannot, chances are that the -problems are specific to Debian GNU/Linux, in which case it should be -reported via the Debian Bug Tracking System (use reportbug to report -the bug). +patches that considerably change the behaviour of rxvt-unicode (but +unfortunately this notice has been removed). Before reporting a bug to +the original rxvt-unicode author please download and install the genuine +version (http://software.schmorp.de#rxvt-unicode) and try to reproduce +the problem. If you cannot, chances are that the problems are specific to +Debian GNU/Linux, in which case it should be reported via the Debian Bug +Tracking System (use reportbug to report the bug).

For other problems that also affect the Debian package, you can and @@ -256,7 +268,8 @@ might encounter the same issue.

-
I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
+
I am maintaining rxvt-unicode for distribution/OS XXX, any +recommendation?
You should build one binary with the default options. configure @@ -283,24 +296,22 @@
I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?
-Likely not. While I honestly try to make it secure, and am probably not -bad at it, I think it is simply unreasonable to expect all of freetype -+ fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be -secure. Also, rxvt-unicode disables some options when it detects that it -runs setuid or setgid, which is not nice. Besides, with the embedded perl -interpreter the possibility for security problems easily multiplies. -
-
-

Elevated privileges are only required for utmp and pty operations on some -systems (for example, GNU/Linux doesn't need any extra privileges for -ptys, but some need it for utmp support). It is planned to mvoe this into -a forked handler process, but this is not yet done.

-
-
-

So, while setuid/setgid operation is supported and not a problem on your -typical single-user-no-other-logins unix desktop, always remember that -its an awful lot of code, most of which isn't checked for security issues -regularly.

+It should be, starting with release 7.1. You are encouraged to properly +install urxvt with privileges necessary for your OS now. +
+
+

When rxvt-unicode detects that it runs setuid or setgid, it will fork +into a helper process for privileged operations (pty handling on some +systems, utmp/wtmp/lastlog handling on others) and drop privileges +immediately. This is much safer than most other terminals that keep +privileges while running (but is more relevant to urxvt, as it contains +things as perl interpreters, which might be ``helpful'' to attackers).

+
+
+

This forking is done as the very first within main(), which is very early +and reduces possible bugs to initialisation code run before main(), or +things like the dynamic loader of your system, which should result in very +little risk.

When I log-in to another system it tells me about missing terminfo data?
@@ -1951,13 +1962,14 @@ Ps = 17Change colour of highlight characters to Pt Ps = 18Change colour of bold characters to Pt [deprecated, see 706] Ps = 19Change colour of underlined characters to Pt [deprecated, see 707] -Ps = 20Change default background to Pt +Ps = 20Change background pixmap parameters (see section XPM) (Compile XPM). Ps = 39Change default foreground colour to Pt. Ps = 46Change Log File to Pt unimplemented Ps = 49Change default background colour to Pt. Ps = 50Set 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 Ps = 55Log all scrollback buffer and all of screen to Pt Ps = 701Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). +Ps = 702Request 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. Ps = 704Change colour of italic characters to Pt Ps = 705Change background pixmap tint colour to Pt (Compile transparency). Ps = 706Change colour of bold characters to Pt @@ -2229,10 +2241,13 @@
--enable-unicode3 (default: off)
-Enable direct support for displaying unicode codepoints above +Recommended to stay off unless you really need non-BMP characters. +
+
+

Enable direct support for displaying unicode codepoints above 65535 (the basic multilingual page). This increases storage requirements per character from 2 to 4 bytes. X11 fonts do not yet -support these extra characters, but Xft does. +support these extra characters, but Xft does.

Please note that rxvt-unicode can store unicode code points >65535 @@ -2252,10 +2267,9 @@ new pseudo-characters when no precomposed form exists.

-

Without --enable-unicode3, the number of additional precomposed characters -is rather limited (2048, if this is full, rxvt-unicode will use the -private use area, extending the number of combinations to 8448). With ---enable-unicode3, no practical limit exists.

+

Without --enable-unicode3, the number of additional precomposed +characters is somewhat limited (the 6400 private use characters will be +(ab-)used). With --enable-unicode3, no practical limit exists.

This option will also enable storage (but not display) of characters @@ -2270,7 +2284,8 @@

--enable-fallback(=CLASS) (default: Rxvt)
-When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. +When reading resource settings, also read settings for class CLASS. To +disable resource fallback use --disable-fallback.

--with-res-name=NAME (default: urxvt)
@@ -2362,13 +2377,6 @@ many years.

-
--enable-half-shadow (default: off)
-
-
-Make shadows on the scrollbar only half the normal width & height. -only applicable to rxvt scrollbars. -
-

--enable-ttygid (default: off)
@@ -2418,6 +2426,7 @@ EWMH-hints (pid, utf8 names) and protocols (ping) seperate underline colour (-underlineColor) settable border widths and borderless switch (-w, -b, -bl) + visual selection (-depth) settable extra linespacing /-lsp) iso-14755-2 and -3, and visual feedback backindex and forwardindex escape sequence @@ -2503,7 +2512,7 @@ Add support to have the pointer disappear when typing or inactive.

-
--enable-perl (default: off)
+
--enable-perl (default: on)
Enable an embedded perl interpreter. See the rxvtperl(3)