ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.txt
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents):
Revision 1.31 by root, Wed Jan 4 00:12:12 2006 UTC vs.
Revision 1.36 by root, Tue Jan 10 04:26:54 2006 UTC

56 56
57 Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), 57 Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k),
58 this still fares rather well. And compared to some monsters like 58 this still fares rather well. And compared to some monsters like
59 gnome-terminal (21152k + extra 4204k in separate processes) or 59 gnome-terminal (21152k + extra 4204k in separate processes) or
60 konsole (22200k + extra 43180k in daemons that stay around after 60 konsole (22200k + extra 43180k in daemons that stay around after
61 exit, plus half aminute of startup time, including the hundreds of 61 exit, plus half a minute of startup time, including the hundreds of
62 warnings it spits out), it fares extremely well *g*. 62 warnings it spits out), it fares extremely well *g*.
63 63
64 Why C++, isn't that unportable/bloated/uncool? 64 Why C++, isn't that unportable/bloated/uncool?
65 Is this a question? :) It comes up very often. The simple answer is: 65 Is this a question? :) It comes up very often. The simple answer is:
66 I had to write it, and C++ allowed me to write and maintain it in a 66 I had to write it, and C++ allowed me to write and maintain it in a
121 121
122 For other problems that also affect the Debian package, you can and 122 For other problems that also affect the Debian package, you can and
123 probably should use the Debian BTS, too, because, after all, it's 123 probably should use the Debian BTS, too, because, after all, it's
124 also a bug in the Debian version and it serves as a reminder for 124 also a bug in the Debian version and it serves as a reminder for
125 other users that might encounter the same issue. 125 other users that might encounter the same issue.
126
127 I am maintaining rxvt-unicode for distribution/OS XXX, any
128 recommendation?
129 You should build one binary with the default options. configure now
130 enables most useful options, and the trend goes to making them
131 runtime-switchable, too, so there is usually no drawback to enbaling
132 them, except higher disk and possibly memory usage. The perl
133 interpreter should be enabled, as important functionality (menus,
134 selection, likely more in the future) depends on it.
135
136 You should not overwrite the "perl-ext-common" snd "perl-ext"
137 resources system-wide (except maybe with "defaults"). This will
138 result in useful behaviour. If your distribution aims at low memory,
139 add an empty "perl-ext-common" resource to the app-defaults file.
140 This will keep the perl interpreter disabled until the user enables
141 it.
142
143 If you can/want build more binaries, I recommend building a minimal
144 one with "--disable-everything" (very useful) and a maximal one with
145 "--enable-everything" (less useful, it will be very big due to a lot
146 of encodings built-in that increase download times and are rarely
147 used).
148
149 I need to make it setuid/setgid to support utmp/ptys on my OS, is this
150 safe?
151 Likely not. While I honestly try to make it secure, and am probably
152 not bad at it, I think it is simply unreasonable to expect all of
153 freetype + fontconfig + xft + xlib + ... + rxvt-unicode itself to
154 all be secure. Also, rxvt-unicode disables some options when it
155 detects that it runs setuid or setgid, which is not nice.
156
157 Elevated privileges are only required for utmp and pty operations on
158 some systems (for example, GNU/Linux doesn't need any extra
159 privileges for ptys, but some need it for utmp support). If
160 rxvt-unicode doesn't support the library/setuid helper that your OS
161 needs I'll be happy to assist you in implementing support for it.
162
163 So, while setuid/setgid operation is supported and not a problem on
164 your typical single-user-no-other-logins unix desktop, always
165 remember that its an awful lot of code, most of which isn't checked
166 for security issues regularly.
126 167
127 When I log-in to another system it tells me about missing terminfo data? 168 When I log-in to another system it tells me about missing terminfo data?
128 The terminal description used by rxvt-unicode is not as widely 169 The terminal description used by rxvt-unicode is not as widely
129 available as that for xterm, or even rxvt (for which the same 170 available as that for xterm, or even rxvt (for which the same
130 problem often arises). 171 problem often arises).
1865 --enable-lastlog (default: on) 1906 --enable-lastlog (default: on)
1866 Write user and tty to lastlog file (used by programs like lastlogin) 1907 Write user and tty to lastlog file (used by programs like lastlogin)
1867 at start of rxvt execution. This option requires --enable-utmp to 1908 at start of rxvt execution. This option requires --enable-utmp to
1868 also be specified. 1909 also be specified.
1869 1910
1870 --enable-xpm-background (default: off) 1911 --enable-xpm-background (default: on)
1871 Add support for XPM background pixmaps. 1912 Add support for XPM background pixmaps.
1872 1913
1873 --enable-transparency (default: off) 1914 --enable-transparency (default: on)
1874 Add support for inheriting parent backgrounds thus giving a fake 1915 Add support for inheriting parent backgrounds thus giving a fake
1875 transparency to the term. 1916 transparency to the term.
1876 1917
1877 --enable-fading (default: on) 1918 --enable-fading (default: on)
1878 Add support for fading the text when focus is lost (requires 1919 Add support for fading the text when focus is lost (requires
1880 1921
1881 --enable-tinting (default: on) 1922 --enable-tinting (default: on)
1882 Add support for tinting of transparent backgrounds (requires 1923 Add support for tinting of transparent backgrounds (requires
1883 "--enable-transparency"). 1924 "--enable-transparency").
1884 1925
1885 --enable-menubar (default: off) 1926 --enable-menubar (default: off) [DEPRECATED]
1886 Add support for our menu bar system (this interacts badly with 1927 Add support for our menu bar system (this interacts badly with
1887 dynamic locale switching currently). 1928 dynamic locale switching currently). This option is DEPRECATED and
1929 will be removed in the future.
1888 1930
1889 --enable-rxvt-scroll (default: on) 1931 --enable-rxvt-scroll (default: on)
1890 Add support for the original rxvt scrollbar. 1932 Add support for the original rxvt scrollbar.
1891 1933
1892 --enable-next-scroll (default: on) 1934 --enable-next-scroll (default: on)
1946 A non-exhaustive list of features enabled by "--enable-frills" 1988 A non-exhaustive list of features enabled by "--enable-frills"
1947 (possibly in combination with other switches) is: 1989 (possibly in combination with other switches) is:
1948 1990
1949 MWM-hints 1991 MWM-hints
1950 EWMH-hints (pid, utf8 names) and protocols (ping) 1992 EWMH-hints (pid, utf8 names) and protocols (ping)
1951 seperate underline colour 1993 seperate underline colour (-underlineColor)
1952 settable border widths and borderless switch 1994 settable border widths and borderless switch (-w, -b, -bl)
1953 settable extra linespacing 1995 settable extra linespacing /-lsp)
1954 iso-14755-2 and -3, and visual feedback 1996 iso-14755-2 and -3, and visual feedback
1955 backindex and forwardindex escape sequence 1997 backindex and forwardindex escape sequence
1956 window op and some xterm/OSC escape sequences 1998 window op and some xterm/OSC escape sequences
1957 tripleclickwords 1999 tripleclickwords (-tcw)
1958 settable insecure mode 2000 settable insecure mode (-insecure)
1959 keysym remapping support 2001 keysym remapping support
1960 cursor blinking and underline cursor 2002 cursor blinking and underline cursor (-cb, -uc)
1961 -embed, -pty-fd and -hold options 2003 XEmbed support (-embed)
2004 user-pty (-pty-fd)
2005 hold on exit (-hold)
2006 skip builtin block graphics (-sbg)
2007 sgr modes 90..97 and 100..107
1962 2008
1963 --enable-iso14755 (default: on) 2009 --enable-iso14755 (default: on)
1964 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). 2010 Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt).
1965 Basic support (section 5.1) is enabled by "--enable-frills", while 2011 Basic support (section 5.1) is enabled by "--enable-frills", while
1966 support for 5.2, 5.3 and 5.4 is enabled with this switch. 2012 support for 5.2, 5.3 and 5.4 is enabled with this switch.
2002 Add support to have the pointer disappear when typing or inactive. 2048 Add support to have the pointer disappear when typing or inactive.
2003 2049
2004 --enable-perl (default: off) 2050 --enable-perl (default: off)
2005 Enable an embedded perl interpreter. See the rxvtperl(3) manpage 2051 Enable an embedded perl interpreter. See the rxvtperl(3) manpage
2006 (doc/rxvtperl.txt) for more info on this feature, or the files in 2052 (doc/rxvtperl.txt) for more info on this feature, or the files in
2007 src/perl-ext/ for the extensions that are installed by default. 2053 src/perl-ext/ for the extensions that are installed by default. The
2054 perl interpreter that is used can be specified via the "PERL"
2055 environment variable when running configure.
2008 2056
2009 --with-name=NAME (default: urxvt) 2057 --with-name=NAME (default: urxvt)
2010 Set the basename for the installed binaries, resulting in "urxvt", 2058 Set the basename for the installed binaries, resulting in "urxvt",
2011 "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt". 2059 "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt".
2012 2060

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines