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

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.188 by sf-exg, Sat Apr 24 20:14:27 2010 UTC vs.
Revision 1.189 by root, Sun May 23 00:48:53 2010 UTC

105This tries to create a new terminal, and if fails with exit status 2, 105This tries to create a new terminal, and if fails with exit status 2,
106meaning it couldn't connect to the daemon, it will start the daemon and 106meaning it couldn't connect to the daemon, it will start the daemon and
107re-run the command. Subsequent invocations of the script will re-use the 107re-run the command. Subsequent invocations of the script will re-use the
108existing daemon. 108existing daemon.
109 109
110=head3 How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc. 110=head3 How do I distinguish whether I'm running rxvt-unicode or a regular
111xterm? I need this to decide about setting colours etc.
111 112
112The original rxvt and rxvt-unicode always export the variable "COLORTERM", 113The original rxvt and rxvt-unicode always export the variable "COLORTERM",
113so you can check and see if that is set. Note that several programs, JED, 114so you can check and see if that is set. Note that several programs, JED,
114slrn, Midnight Commander automatically check this variable to decide 115slrn, Midnight Commander automatically check this variable to decide
115whether or not to use color. 116whether or not to use colour.
116 117
117=head3 How do I set the correct, full IP address for the DISPLAY variable? 118=head3 How do I set the correct, full IP address for the DISPLAY variable?
118 119
119If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled 120If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
120insecure mode then it is possible to use the following shell script 121insecure mode then it is possible to use the following shell script
361For the standard background colour, blinking will actually make 362For the standard background colour, blinking will actually make
362the text blink when compiled with C<--enable-text-blink>. Without 363the text blink when compiled with C<--enable-text-blink>. Without
363C<--enable-text-blink>, the blink attribute will be ignored. 364C<--enable-text-blink>, the blink attribute will be ignored.
364 365
365On ANSI colours, bold/blink attributes are used to set high-intensity 366On ANSI colours, bold/blink attributes are used to set high-intensity
366foreground/background colors. 367foreground/background colours.
367 368
368color0-7 are the low-intensity colors. 369color0-7 are the low-intensity colours.
369 370
370color8-15 are the corresponding high-intensity colors. 371color8-15 are the corresponding high-intensity colours.
371 372
372=head3 I don't like the screen colors. How do I change them? 373=head3 I don't like the screen colours. How do I change them?
373 374
374You can change the screen colors at run-time using F<~/.Xdefaults> 375You can change the screen colours at run-time using F<~/.Xdefaults>
375resources (or as long-options). 376resources (or as long-options).
376 377
377Here are values that are supposed to resemble a VGA screen, 378Here are values that are supposed to resemble a VGA screen,
378including the murky brown that passes for low-intensity yellow: 379including the murky brown that passes for low-intensity yellow:
379 380
393 URxvt.color12: #0000FF 394 URxvt.color12: #0000FF
394 URxvt.color13: #FF00FF 395 URxvt.color13: #FF00FF
395 URxvt.color14: #00FFFF 396 URxvt.color14: #00FFFF
396 URxvt.color15: #FFFFFF 397 URxvt.color15: #FFFFFF
397 398
398And here is a more complete set of non-standard colors. 399And here is a more complete set of non-standard colours.
399 400
400 URxvt.cursorColor: #dc74d1 401 URxvt.cursorColor: #dc74d1
401 URxvt.pointerColor: #dc74d1 402 URxvt.pointerColor: #dc74d1
402 URxvt.background: #0e0e0e 403 URxvt.background: #0e0e0e
403 URxvt.foreground: #4ad5e1 404 URxvt.foreground: #4ad5e1
1623 B<< C<Ps = 32 / 42> >> fg/bg Green 1624 B<< C<Ps = 32 / 42> >> fg/bg Green
1624 B<< C<Ps = 33 / 43> >> fg/bg Yellow 1625 B<< C<Ps = 33 / 43> >> fg/bg Yellow
1625 B<< C<Ps = 34 / 44> >> fg/bg Blue 1626 B<< C<Ps = 34 / 44> >> fg/bg Blue
1626 B<< C<Ps = 35 / 45> >> fg/bg Magenta 1627 B<< C<Ps = 35 / 45> >> fg/bg Magenta
1627 B<< C<Ps = 36 / 46> >> fg/bg Cyan 1628 B<< C<Ps = 36 / 46> >> fg/bg Cyan
1628 B<< C<Ps = 38;5 / 48;5> >> set fg/bg to color #m (ISO 8613-6) 1629 B<< C<Ps = 38;5 / 48;5> >> set fg/bg to colour #m (ISO 8613-6)
1629 B<< C<Ps = 37 / 47> >> fg/bg White 1630 B<< C<Ps = 37 / 47> >> fg/bg White
1630 B<< C<Ps = 39 / 49> >> fg/bg Default 1631 B<< C<Ps = 39 / 49> >> fg/bg Default
1631 B<< C<Ps = 90 / 100> >> fg/bg Bright Black 1632 B<< C<Ps = 90 / 100> >> fg/bg Bright Black
1632 B<< C<Ps = 91 / 101> >> fg/bg Bright Red 1633 B<< C<Ps = 91 / 101> >> fg/bg Bright Red
1633 B<< C<Ps = 92 / 102> >> fg/bg Bright Green 1634 B<< C<Ps = 92 / 102> >> fg/bg Bright Green
2252 2253
2253=over 4 2254=over 4
2254 2255
2255=item --enable-everything 2256=item --enable-everything
2256 2257
2257Add (or remove) support for all non-multichoice options listed in 2258Add (or remove) support for all non-multichoice options listed
2258C<./configure --help>, except for C<--enable-assert>. 2259in C<./configure --help>, except for C<--enable-assert> and
2260C<--enable-256-color>.
2259 2261
2260You can specify this and then disable options you do not like by 2262You can specify this and then disable options you do not like by
2261I<following> this with the appropriate C<--disable-...> arguments, 2263I<following> this with the appropriate C<--disable-...> arguments,
2262or you can start with a minimal configuration by specifying 2264or you can start with a minimal configuration by specifying
2263C<--disable-everything> and than adding just the C<--enable-...> arguments 2265C<--disable-everything> and than adding just the C<--enable-...> arguments
2264you want. 2266you want.
2265
2266=item --enable-256-color (default: off)
2267
2268Add support for 256 colors.
2269 2267
2270=item --enable-xft (default: enabled) 2268=item --enable-xft (default: enabled)
2271 2269
2272Add support for Xft (anti-aliases, among others) fonts. Xft fonts are 2270Add support for Xft (anti-aliases, among others) fonts. Xft fonts are
2273slower and require lots of memory, but as long as you don't use them, you 2271slower and require lots of memory, but as long as you don't use them, you
2453 separate highlight colour (-highlightColor, -highlightTextColor) 2451 separate highlight colour (-highlightColor, -highlightTextColor)
2454 2452
2455It also enables some non-essential features otherwise disabled, such as: 2453It also enables some non-essential features otherwise disabled, such as:
2456 2454
2457 some round-trip time optimisations 2455 some round-trip time optimisations
2458 nearest color allocation on pseudocolor screens 2456 nearest colour allocation on pseudocolor screens
2459 UTF8_STRING support for selection 2457 UTF8_STRING support for selection
2460 sgr modes 90..97 and 100..107 2458 sgr modes 90..97 and 100..107
2461 backindex and forwardindex escape sequences 2459 backindex and forwardindex escape sequences
2462 view change/zero scrollback escape sequences 2460 view change/zero scrollback escape sequences
2463 locale switching escape sequence 2461 locale switching escape sequence
2520=item --enable-assert (default: off) 2518=item --enable-assert (default: off)
2521 2519
2522Enables the assertions in the code, normally disabled. This switch is only 2520Enables the assertions in the code, normally disabled. This switch is only
2523useful when developing rxvt-unicode. 2521useful when developing rxvt-unicode.
2524 2522
2523=item --enable-256-color (default: off)
2524
2525Force use of so-called 256 colour mode, to work around buggy applications
2526that do not support termcap/terminfo, or simply improve support for
2527applications hardcoding the xterm 256 colour table.
2528
2529This switch breaks termcap/terminfo compatibility to C<TERM=rxvt-unicode>,
2530and consequently sets C<TERM> to C<rxvt-unicode-256color> by default
2531(F<doc/etc/> conatins termcap/terminfo defintiions for both).
2532
2533It also results in higher memory usage and can slow down @@RXVT_NAME@@
2534dramatically when more than six fonts are in use by a terminal instance.
2535
2525=item --with-afterimage-config=DIR 2536=item --with-afterimage-config=DIR
2526 2537
2527Look for the libAfterImage config script in DIR. 2538Look for the libAfterImage config script in DIR.
2528 2539
2529=item --with-name=NAME (default: urxvt) 2540=item --with-name=NAME (default: urxvt)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines