[ViewVC] Diff of: cvs/rxvt-unicode/doc/rxvt.7.txt

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents):
Revision 1.29 by root, Mon Jan 2 15:11:05 2006 UTC vs.
Revision 1.39 by root, Wed Jan 11 23:08:54 2006 UTC

         Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k),
         this still fares rather well. And compared to some monsters like
         gnome-terminal (21152k + extra 4204k in separate processes) or
         konsole (22200k + extra 43180k in daemons that stay around after
-        exit, plus half aminute of startup time, including the hundreds of
+        exit, plus half a minute of startup time, including the hundreds of
         warnings it spits out), it fares extremely well *g*.
     Why C++, isn't that unportable/bloated/uncool?
         Is this a question? :) It comes up very often. The simple answer is:
         I had to write it, and C++ allowed me to write and maintain it in a
         For other problems that also affect the Debian package, you can and
         probably should use the Debian BTS, too, because, after all, it's
         also a bug in the Debian version and it serves as a reminder for
         other users that might encounter the same issue.
+    I am maintaining rxvt-unicode for distribution/OS XXX, any
+    recommendation?
+        You should build one binary with the default options. configure now
+        enables most useful options, and the trend goes to making them
+        runtime-switchable, too, so there is usually no drawback to enbaling
+        them, except higher disk and possibly memory usage. The perl
+        interpreter should be enabled, as important functionality (menus,
+        selection, likely more in the future) depends on it.
+        You should not overwrite the "perl-ext-common" snd "perl-ext"
+        resources system-wide (except maybe with "defaults"). This will
+        result in useful behaviour. If your distribution aims at low memory,
+        add an empty "perl-ext-common" resource to the app-defaults file.
+        This will keep the perl interpreter disabled until the user enables
+        it.
+        If you can/want build more binaries, I recommend building a minimal
+        one with "--disable-everything" (very useful) and a maximal one with
+        "--enable-everything" (less useful, it will be very big due to a lot
+        of encodings built-in that increase download times and are rarely
+        used).
+    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.
     When I log-in to another system it tells me about missing terminfo data?
         The terminal description used by rxvt-unicode is not as widely
         available as that for xterm, or even rxvt (for which the same
         problem often arises).
            Ps = 10         Change colour of text foreground to Pt (NB: may change in future)
            Ps = 11         Change colour of text background to Pt (NB: may change in future)
            Ps = 12         Change colour of text cursor foreground to Pt
            Ps = 13         Change colour of mouse foreground to Pt
            Ps = 17         Change colour of highlight characters to Pt
-           Ps = 18         Change colour of bold characters to Pt
+           Ps = 18         Change colour of bold characters to Pt [deprecated, see 706]
-           Ps = 19         Change colour of underlined characters to Pt
+           Ps = 19         Change colour of underlined characters to Pt [deprecated, see 707]
            Ps = 20         Change default background to Pt
            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 = 703        Menubar command Pt (Compile menubar).
            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
+           Ps = 707        Change colour of underlined characters to Pt
            Ps = 710        Set normal fontset to Pt. Same as Ps = 50.
            Ps = 711        Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
            Ps = 712        Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
            Ps = 713        Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
            Ps = 720        Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
            Ps = 721        Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
+           Ps = 777        Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
 menuBar
     The exact syntax used is *almost* solidified. In the menus, DON'T try to
     --enable-lastlog (default: on)
         Write user and tty to lastlog file (used by programs like lastlogin)
         at start of rxvt execution. This option requires --enable-utmp to
         also be specified.
-    --enable-xpm-background (default: off)
+    --enable-xpm-background (default: on)
         Add support for XPM background pixmaps.
-    --enable-transparency (default: off)
+    --enable-transparency (default: on)
         Add support for inheriting parent backgrounds thus giving a fake
         transparency to the term.
     --enable-fading (default: on)
         Add support for fading the text when focus is lost (requires
     --enable-tinting (default: on)
         Add support for tinting of transparent backgrounds (requires
         "--enable-transparency").
-    --enable-menubar (default: off)
+    --enable-menubar (default: off) [DEPRECATED]
         Add support for our menu bar system (this interacts badly with
-        dynamic locale switching currently).
+        dynamic locale switching currently). This option is DEPRECATED and
+        will be removed in the future.
     --enable-rxvt-scroll (default: on)
         Add support for the original rxvt scrollbar.
     --enable-next-scroll (default: on)
         Removes any handling of the delete key by us - let the X server do
         it.
     --disable-resources
         Removes any support for resource checking.
-    --enable-xgetdefault
-        Make resources checking via XGetDefault() instead of our small
-        version which only checks ~/.Xdefaults, or if that doesn't exist
-        then ~/.Xresources.
-        Please note that nowadays, things like XIM will automatically pull
-        in and use the full X resource manager, so the overhead of using it
-        might be very small, if nonexistant.
     --enable-strings (default: off)
         Add support for our possibly faster memset() function and other
         various routines, overriding your system's versions which may have
         been hand-crafted in assembly or may require extra libraries to link
         A non-exhaustive list of features enabled by "--enable-frills"
         (possibly in combination with other switches) is:
           MWM-hints
           EWMH-hints (pid, utf8 names) and protocols (ping)
-          seperate underline colour
+          seperate underline colour (-underlineColor)
-          settable border widths and borderless switch
+          settable border widths and borderless switch (-w, -b, -bl)
-          settable extra linespacing
+          settable extra linespacing /-lsp)
           iso-14755-2 and -3, and visual feedback
           backindex and forwardindex escape sequence
           window op and some xterm/OSC escape sequences
-          tripleclickwords
+          tripleclickwords (-tcw)
-          settable insecure mode
+          settable insecure mode (-insecure)
           keysym remapping support
-          cursor blinking and underline cursor
+          cursor blinking and underline cursor (-cb, -uc)
-          -embed, -pty-fd and -hold options
+          XEmbed support (-embed)
+          user-pty (-pty-fd)
+          hold on exit (-hold)
+          skip builtin block graphics (-sbg)
+          sgr modes 90..97 and 100..107
     --enable-iso14755 (default: on)
         Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt).
         Basic support (section 5.1) is enabled by "--enable-frills", while
         support for 5.2, 5.3 and 5.4 is enabled with this switch.
         corner of the screen in a fixed position.
     --enable-pointer-blank (default: on)
         Add support to have the pointer disappear when typing or inactive.
+    --enable-perl (default: off)
+        Enable an embedded perl interpreter. See the rxvtperl(3) manpage
+        (doc/rxvtperl.txt) for more info on this feature, or the files in
+        src/perl-ext/ for the extensions that are installed by default. The
+        perl interpreter that is used can be specified via the "PERL"
+        environment variable when running configure.
     --with-name=NAME (default: urxvt)
         Set the basename for the installed binaries, resulting in "urxvt",
         "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt".
     --with-term=NAME (default: rxvt-unicode)

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents): Revision 1.29 by root, Mon Jan 2 15:11:05 2006 UTC vs. Revision 1.39 by root, Wed Jan 11 23:08:54 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents):
Revision 1.29 by root, Mon Jan 2 15:11:05 2006 UTC vs.
Revision 1.39 by root, Wed Jan 11 23:08:54 2006 UTC