[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.36 by root, Tue Jan 10 04:26: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 + ... + 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.
+        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). If
+        rxvt-unicode doesn't support the library/setuid helper that your OS
+        needs I'll be happy to assist you in implementing support for it.
+        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 = 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)
         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.36 by root, Tue Jan 10 04:26: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.36 by root, Tue Jan 10 04:26:54 2006 UTC