--- 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 = 17 | Change colour of highlight characters to Pt |
Ps = 18 | Change colour of bold characters to Pt [deprecated, see 706] |
Ps = 19 | Change colour of underlined characters to Pt [deprecated, see 707] |
-Ps = 20 | Change default background to Pt |
+Ps = 20 | Change background pixmap parameters (see section XPM) (Compile XPM). |
Ps = 39 | Change default foreground colour to Pt. |
Ps = 46 | Change Log File to Pt unimplemented |
Ps = 49 | Change default background colour to Pt. |
Ps = 50 | Set 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 = 55 | Log all scrollback buffer and all of screen to Pt |
Ps = 701 | Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). |
+Ps = 702 | Request 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 = 704 | Change colour of italic characters to Pt |
Ps = 705 | Change background pixmap tint colour to Pt (Compile transparency). |
Ps = 706 | Change 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)