--- rxvt-unicode/doc/rxvt.7.html 2005/02/11 18:06:44 1.11 +++ rxvt-unicode/doc/rxvt.7.html 2005/11/08 17:35:28 1.25 @@ -85,13 +85,14 @@
I am using Debian GNU/Linux and have a problem...
-The Debian GNU/Linux package of rxvt-unicode 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). +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).

For other problems that also affect the Debian package, you can and @@ -139,15 +140,22 @@ the rxvt terminfo file with the rxvt-unicode one.

-
bash's readline does not work correctly under rxvt.
+
tic outputs some error when compiling the terminfo entry.
+
+
+Most likely it's the empty definition for enacs=. Just replace it by +enacs=\E[0@ and try again. +
+

+
bash's readline does not work correctly under urxvt.
I need a termcap file entry.
One reason you might want this is that some distributions or operating systems still compile some programs using the long-obsoleted termcap -(Fedora Core's bash is one example) and rely on a termcap entry for -rxvt-unicode. +library (Fedora Core's bash is one example) and rely on a termcap entry +for rxvt-unicode.

You could use rxvt's termcap entry with resonable results in many cases. @@ -165,22 +173,23 @@

    rxvt-unicode|rxvt-unicode terminal (X Window System):\
            :am:bw:eo:km:mi:ms:xn:xo:\
-           :co#80:it#8:li#24:\
+           :co#80:it#8:li#24:lm#0:\
            :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
            :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
-           :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=^O:al=\E[L:\
-           :as=^N:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:cm=\E[%i%d;%dH:\
-           :cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:dl=\E[M:do=^J:\
-           :ec=\E[%dX:ei=\E[4l:ho=\E[H:i1=\E[?47l\E=\E[?1l:ic=\E[@:\
-           :im=\E[4h:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
-           :k0=\E[21~:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:\
-           :k5=\E[15~:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:\
-           :kD=\E[3~:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:\
-           :ke=\E[?1l\E>:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:\
-           :ku=\EOA:le=^H:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:\
-           :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\
-           :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\
-           :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
+           :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
+           :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
+           :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
+           :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
+           :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
+           :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
+           :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
+           :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
+           :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
+           :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
+           :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
+           :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
+           :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
+           :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
            :vs=\E[?25h:

@@ -302,7 +311,7 @@
-   rxvt -fn basefont,font2,font3...
+ urxvt -fn basefont,font2,font3...

When rxvt-unicode sees a character, it will first look at the base @@ -372,6 +381,18 @@ box data is correct.

+
On Solaris 9, many line-drawing characters are too wide.
+
+
+Seems to be a known bug, read +http://nixdoc.net/files/forum/about34198.html. Some people use the +following ugly workaround to get non-double-wide-characters working: +
+
+
+   #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
+
+

My Compose (Multi_key) key is no longer working.
@@ -439,13 +460,17 @@ wchar_t. This is, of course, completely fine with respect to standards.

-

However, __STDC_ISO_10646__ is the only sane way to support -multi-language apps in an OS, as using a locale-dependent (and -non-standardized) representation of wchar_t makes it impossible to -convert between wchar_t (as used by X11 and your applications) and any -other encoding without implementing OS-specific-wrappers for each and -every locale. There simply are no APIs to convert wchar_t into anything -except the current locale encoding.

+

However, that means rxvt-unicode only works in POSIX, ISO-8859-1 and +UTF-8 locales under FreeBSD (which all use Unicode as wchar_t.

+
+
+

__STDC_ISO_10646__ is the only sane way to support multi-language +apps in an OS, as using a locale-dependent (and non-standardized) +representation of wchar_t makes it impossible to convert between +wchar_t (as used by X11 and your applications) and any other encoding +without implementing OS-specific-wrappers for each and every locale. There +simply are no APIs to convert wchar_t into anything except the current +locale encoding.

Some applications (such as the formidable mlterm) work around this @@ -460,6 +485,29 @@ complete replacements for them :)

+
I use Solaris 9 and it doesn't compile/work/etc.
+
+
+Try the diff in doc/solaris9.patch as a base. It fixes the worst +problems with wcwidth and a compile problem. +
+

+
How can I use rxvt-unicode under cygwin?
+
+
+rxvt-unicode should compile and run out of the box on cygwin, using +the X11 libraries that come with cygwin. libW11 emulation is no +longer supported (and makes no sense, either, as it only supported a +single font). I recommend starting the X-server in -multiwindow or +-rootless mode instead, which will result in similar look&feel as the +old libW11 emulation. +
+
+

At the time of this writing, cygwin didn't seem to support any multi-byte +encodings (you might try LC_CTYPE=C-UTF-8), so you are likely limited +to 8-bit encodings.

+
+

How does rxvt-unicode determine the encoding to use?
Is there an option to switch encodings?
@@ -586,6 +634,20 @@ method limits you.

+
Rxvt-unicode crashes when the X Input Method changes or exits.
+
+
+Unfortunately, this is unavoidable, as the XIM protocol is racy by +design. Applications can avoid some crashes at the expense of memory +leaks, and Input Methods can avoid some crashes by careful ordering at +exit time. kinput2 (and derived input methods) generally succeeds, +while SCIM (or similar input methods) fails. In the end, however, +crashes cannot be completely avoided even if both sides cooperate. +
+
+

So the only workaround is not to kill your Input Method Servers.

+
+

Rxvt-unicode uses gobs of memory, how can I reduce that?
@@ -597,10 +659,10 @@

Also, many people (me included) like large windows and even larger -scrollback buffers: Without --enable-unicode3, rxvt-unicode will use +scrollback buffers: Without --enable-unicode3, rxvt-unicode will use 6 bytes per screen cell. For a 160x?? window this amounts to almost a kilobyte per line. A scrollback buffer of 10000 lines will then (if full) -use 10 Megabytes of memory. With --enable-unicode3 it gets worse, as +use 10 Megabytes of memory. With --enable-unicode3 it gets worse, as rxvt-unicode then uses 8 bytes per screen cell.

@@ -609,7 +671,7 @@
Yes, the most obvious way to speed it up is to avoid Xft entirely, as it is simply slow. If you still want Xft fonts you might try to disable -antialiasing (by appending :antialiasing=false), which saves lots of +antialiasing (by appending :antialias=false), which saves lots of memory and also speeds up rendering considerably.

@@ -633,7 +695,7 @@ some editors prematurely may leave the mouse in mouse report mode. I've heard that tcsh may use mouse reporting unless it otherwise specified. A quick check is to see if cut/paste works when the Alt or Shift keys are -depressed. See rxvt(7) +depressed. See urxvt(7)

What's with this bold/blink stuff?
@@ -717,20 +779,11 @@ URxvt.color15: #e1dddd

-
How can I start rxvtd in a race-free way?
+
How can I start urxvtd in a race-free way?
-Despite it's name, rxvtd is not a real daemon, but more like a -server that answers rxvtc's requests, so it doesn't background -itself. -
-
-

To ensure rxvtd is listening on it's socket, you can use the -following method to wait for the startup message before continuing:

-
-
-
-  { rxvtd & } | read
+Try urxvtd -f -o, which tells urxvtd to open the +display, create the listening socket and then fork.

What's with the strange Backspace/Delete key behaviour?
@@ -760,16 +813,16 @@
    # use Backspace = ^H
    $ stty erase ^H
-   $ rxvt
+ $ urxvt
    # use Backspace = ^?
    $ stty erase ^?
-   $ rxvt
+ $ urxvt
-

Toggle with ESC [ 36 h / ESC [ 36 l as documented in rxvt(7).

+

Toggle with ESC [ 36 h / ESC [ 36 l as documented in urxvt(7).

For an existing rxvt-unicode:

@@ -817,7 +870,7 @@ use the `keysym' resource to alter the keystrings associated with keysyms.
-

Here's an example for a URxvt session started using rxvt -name URxvt

+

Here's an example for a URxvt session started using urxvt -name URxvt

@@ -1697,19 +1750,21 @@
 Ps = 18Change colour of bold characters to Pt
 Ps = 19Change colour of underlined characters to Pt
 Ps = 20Change default background to Pt
-Ps = 39Change default foreground colour to Pt rxvt compile-time option
+Ps = 39Change default foreground colour to Pt.
 Ps = 46Change Log File to Pt unimplemented
-Ps = 49Change default background colour to Pt rxvt compile-time option
+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 (rxvt extension)
-Ps = 703Menubar command Pt rxvt compile-time option (rxvt-unicode extension)
+Ps = 701Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
+Ps = 703Menubar command Pt (Compile menubar).
 Ps = 704Change colour of italic characters to Pt
-Ps = 705Change background pixmap tint colour to Pt
+Ps = 705Change background pixmap tint colour to Pt (Compile transparency).
 Ps = 710Set normal fontset to Pt. Same as Ps = 50.
-Ps = 711Set bold fontset to Pt. Similar to Ps = 50.
-Ps = 712Set italic fontset to Pt. Similar to Ps = 50.
-Ps = 713Set bold-italic fontset to Pt. Similar to Ps = 50.
+Ps = 711Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
+Ps = 712Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
+Ps = 713Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
+Ps = 720Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
+Ps = 721Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
 

@@ -1765,9 +1820,12 @@

set the current menuBar's title to string, which may contain the following format specifiers: -%% : literal % character -%n : rxvt name (as per the -name command-line option) -%v : rxvt version +
+
+
+   B<%n>  rxvt name (as per the B<-name> command-line option)
+   B<%v>  rxvt version
+   B<%%>  literal B<%> character

[done]
@@ -2478,22 +2536,28 @@

CONFIGURE OPTIONS

General hint: if you get compile errors, then likely your configuration -hasn't been tested well. Either try with --enable-everything or use the -./reconf script as a base for experiments. ./reconf is used by myself, -so it should generally be a working config. Of course, you should always -report when a combination doesn't work, so it can be fixed. Marc Lehmann -<rxvt@schmorp.de>.

+hasn't been tested well. Either try with --enable-everything or use +the ./reconf script as a base for experiments. ./reconf is used by +myself, so it should generally be a working config. Of course, you should +always report when a combination doesn't work, so it can be fixed. Marc +Lehmann <rxvt@schmorp.de>.

+

All

--enable-everything
-Add support for all non-multichoice options listed in ``./configure ---help''. Note that unlike other enable options this is order dependant. -You can specify this and then disable options which this enables by -following this with the appropriate commands. +Add (or remove) support for all non-multichoice options listed in ``./configure +--help''. +
+
+

You can specify this and then disable options you do not like by +following this with the appropriate --disable-... arguments, +or you can start with a minimal configuration by specifying +--disable-everything and than adding just the --enable-... arguments +you want.

-
--enable-xft
+
--enable-xft (default: enabled)
Add support for Xft (anti-aliases, among others) fonts. Xft fonts are @@ -2501,22 +2565,23 @@ don't pay for them.

-
--enable-font-styles
+
--enable-font-styles (default: on)
Add support for bold, italic and bold italic > font styles. The fonts can be set manually or automatically.

-
--with-codesets=NAME,...
+
--with-codesets=NAME,... (default: all)
-Compile in support for additional codeset (encoding) groups (eu, vn are -always compiled in, which includes most 8-bit character sets). These -codeset tables are currently only used for driving X11 core fonts, they -are not required for Xft fonts. Compiling them in will make your binary -bigger (together about 700kB), but it doesn't increase memory usage unless -you use an X11 font requiring one of these encodings. +Compile in support for additional codeset (encoding) groups (eu, vn +are always compiled in, which includes most 8-bit character sets). These +codeset tables are used for driving X11 core fonts, they are not required +for Xft fonts, although having them compiled in lets rxvt-unicode choose +replacement fonts more intelligently. Compiling them in will make your +binary bigger (all of together cost about 700kB), but it doesn't increase +memory usage unless you use a font requiring one of these encodings.
@@ -2526,7 +2591,7 @@
allall available codeset groups
jp_extrarely used but big japanese encodings
krkorean encodings

-
--enable-xim
+
--enable-xim (default: on)
Add support for XIM (X Input Method) protocol. This allows using @@ -2534,7 +2599,7 @@ set up the input for people using dead keys or compose keys.

-
--enable-unicode3
+
--enable-unicode3 (default: off)
Enable direct support for displaying unicode codepoints above @@ -2550,7 +2615,7 @@ (input/output and cut&paste still work, though).

-
--enable-combining
+
--enable-combining (default: on)
Enable automatic composition of combining characters into @@ -2560,47 +2625,50 @@ 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 will use the +

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. This will also enable -storage of characters >65535.

+--enable-unicode3, no practical limit exists.

+
+
+

This option will also enable storage (but not display) of characters +beyond plane 0 (>65535) when --enable-unicode3 was not specified.

The combining table also contains entries for arabic presentation forms, -but these are not currently used. Bug me if you want these to be used.

+but these are not currently used. Bug me if you want these to be used (and +tell me how these are to be used...).

-
--enable-fallback(=CLASS)
+
--enable-fallback(=CLASS) (default: Rxvt)
-When reading resource settings, also read settings for class CLASS -(default: Rxvt). 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
+
--with-res-name=NAME (default: urxvt)
-Use the given name (default: urxvt) as default application name when +Use the given name as default application name when reading resources. Specify --with-res-name=rxvt to replace rxvt.

-
--with-res-class=CLASS
+
--with-res-class=CLASS /default: URxvt)
-Use the given class (default: URxvt) as default application class -when reading resources. Specify --with-res-class=Rxvt to replace +Use the given class as default application class +when reading resources. Specify --with-res-class=Rxvt to replace rxvt.

-
--enable-utmp
+
--enable-utmp (default: on)
Write user and tty to utmp file (used by programs like w) at start of rxvt execution and delete information when rxvt exits.

-
--enable-wtmp
+
--enable-wtmp (default: on)
Write user and tty to wtmp file (used by programs like last) at @@ -2608,7 +2676,7 @@ option requires --enable-utmp to also be specified.

-
--enable-lastlog
+
--enable-lastlog (default: on)
Write user and tty to lastlog file (used by programs like @@ -2616,57 +2684,57 @@ --enable-utmp to also be specified.

-
--enable-xpm-background
+
--enable-xpm-background (default: off)
Add support for XPM background pixmaps.

-
--enable-transparency
+
--enable-transparency (default: off)
Add support for inheriting parent backgrounds thus giving a fake transparency to the term.

-
--enable-fading
+
--enable-fading (default: on)
-Add support for fading the text when focus is lost. +Add support for fading the text when focus is lost (requires --enable-transparency).

-
--enable-tinting
+
--enable-tinting (default: on)
-Add support for tinting of transparent backgrounds. +Add support for tinting of transparent backgrounds (requires --enable-transparency).

-
--enable-menubar
+
--enable-menubar (default: off)
Add support for our menu bar system (this interacts badly with dynamic locale switching currently).

-
--enable-rxvt-scroll
+
--enable-rxvt-scroll (default: on)
Add support for the original rxvt scrollbar.

-
--enable-next-scroll
+
--enable-next-scroll (default: on)
Add support for a NeXT-like scrollbar.

-
--enable-xterm-scroll
+
--enable-xterm-scroll (default: on)
Add support for an Xterm-like scrollbar.

-
--enable-plain-scroll
+
--enable-plain-scroll (default: on)
Add support for a very unobtrusive, plain-looking scrollbar that @@ -2674,14 +2742,14 @@ many years.

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

-
--enable-ttygid
+
--enable-ttygid (default: off)
Change tty device setting to group ``tty'' - only use this if @@ -2691,21 +2759,20 @@
--disable-backspace-key
-Disable any handling of the backspace key by us - let the X server -do it. +Removes any handling of the backspace key by us - let the X server do it.

--disable-delete-key
-Disable any handling of the delete key by us - let the X server +Removes any handling of the delete key by us - let the X server do it.

--disable-resources
-Remove all resources checking. +Removes any support for resource checking.

--enable-xgetdefault
@@ -2721,7 +2788,7 @@ small, if nonexistant.

-
--enable-strings
+
--enable-strings (default: off)
Add support for our possibly faster memset() function and other @@ -2734,10 +2801,10 @@
--disable-swapscreen
-Remove support for swap screen. +Remove support for secondary/swap screen.

-
--enable-frills
+
--enable-frills (default: on)
Add support for many small features that are not essential but nice to @@ -2745,47 +2812,49 @@ disable this.
-

A non-exhaustive list of features enabled by --enable-frills (possibly +

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
   settable border widths and borderless switch
   settable extra linespacing
-  extra window properties (e.g. UTF-8 window names and PID)
   iso-14755-2 and -3, and visual feedback
   backindex and forwardindex escape sequence
-  window op and locale change escape sequences
+  window op and some xterm/OSC escape sequences
   tripleclickwords
   settable insecure mode
-  keysym remapping support
+ keysym remapping support + cursor blinking and underline cursor + -embed and -pty-fd options

-
--enable-iso14755
+
--enable-iso14755 (default: on)
-Enable extended ISO 14755 support (see rxvt(1), or +Enable extended ISO 14755 support (see urxvt(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 +--enable-frills, while support for 5.2, 5.3 and 5.4 is enabled with this switch.

-
--enable-keepscrolling
+
--enable-keepscrolling (default: on)
Add support for continual scrolling of the display when you hold the mouse button down on a scrollbar arrow.

-
--enable-mousewheel
+
--enable-mousewheel (default: on)
Add support for scrolling via mouse wheel or buttons 4 & 5.

-
--enable-slipwheeling
+
--enable-slipwheeling (default: on)
Add support for continual scrolling (using the mouse wheel as an @@ -2799,7 +2868,7 @@ Remove support for mouse selection style like that of xterm.

-
--enable-dmalloc
+
--enable-dmalloc (default: off)
Use Gray Watson's malloc - which is good for debugging See @@ -2812,46 +2881,39 @@ you use either) .

-
--enable-dlmalloc
+
--enable-dlmalloc (default: off)
Use Doug Lea's malloc - which is good for a production version See http://g.oswego.edu/dl/html/malloc.html for details.

-
--enable-smart-resize
+
--enable-smart-resize (default: on)
-Add smart growth/shrink behaviour when changing font size via from hot -keys. This should keep in a fixed position the rxvt corner which is +Add smart growth/shrink behaviour when changing font size via hot +keys. This should keep in a fixed position the urxvt corner which is closest to a corner of the screen.

-
--enable-cursor-blink
-
-
-Add support for a blinking cursor. -
-

-
--enable-pointer-blank
+
--enable-pointer-blank (default: on)
Add support to have the pointer disappear when typing or inactive.

-
--with-name=NAME
+
--with-name=NAME (default: urxvt)
-Set the basename for the installed binaries (default: urxvt, resulting +Set the basename for the installed binaries, resulting in urxvt, urxvtd etc.). Specify --with-name=rxvt to replace with rxvt.

-
--with-term=NAME
+
--with-term=NAME (default: rxvt-unicode)
-Change the environmental variable for the terminal to NAME (default -rxvt-unicode) +Change the environmental variable for the terminal to NAME.

--with-terminfo=PATH