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.151 by sasha, Thu Nov 15 18:40:10 2007 UTC vs.
Revision 1.164 by ayin, Sun Jan 20 14:12:39 2008 UTC

17 17
18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting 18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
19all escape sequences, and other background information. 19all escape sequences, and other background information.
20 20
21The newest version of this document is also available on the World Wide Web at 21The newest version of this document is also available on the World Wide Web at
22L<http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html>. 22L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod>.
23
24The main manual page for @@RXVT_NAME@@ itself is available at
25L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod>.
23 26
24=head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 27=head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
25 28
26 29
27=head2 Meta, Features & Commandline Issues 30=head2 Meta, Features & Commandline Issues
341=head3 What's with this bold/blink stuff? 344=head3 What's with this bold/blink stuff?
342 345
343If no bold colour is set via C<colorBD:>, bold will invert text using the 346If no bold colour is set via C<colorBD:>, bold will invert text using the
344standard foreground colour. 347standard foreground colour.
345 348
346For the standard background colour, blinking will actually make the 349For the standard background colour, blinking will actually make
347text blink when compiled with C<--enable-blinking>. with standard 350the text blink when compiled with C<--enable-text-blink>. Without
348colours. Without C<--enable-blinking>, the blink attribute will be 351C<--enable-text-blink>, the blink attribute will be ignored.
349ignored.
350 352
351On ANSI colours, bold/blink attributes are used to set high-intensity 353On ANSI colours, bold/blink attributes are used to set high-intensity
352foreground/background colors. 354foreground/background colors.
353 355
354color0-7 are the low-intensity colors. 356color0-7 are the low-intensity colors.
482 484
483To get a selection that is very similar to the old code, try this pattern: 485To get a selection that is very similar to the old code, try this pattern:
484 486
485 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) 487 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+)
486 488
487Please also note that the I<LeftClick Shift-LeftClik> combination also 489Please also note that the I<LeftClick Shift-LeftClick> combination also
488selects words like the old code. 490selects words like the old code.
489 491
490=head3 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it? 492=head3 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?
491 493
492You can disable the perl extension completely by setting the 494You can disable the perl extension completely by setting the
1810 1812
1811=item B<< C<Pm = 30> >> 1813=item B<< C<Pm = 30> >>
1812 1814
1813=begin table 1815=begin table
1814 1816
1815 B<< C<h> >> scrollBar visisble 1817 B<< C<h> >> scrollBar visible
1816 B<< C<l> >> scrollBar invisisble 1818 B<< C<l> >> scrollBar invisible
1817 1819
1818=end table 1820=end table
1819 1821
1820=item B<< C<Pm = 35> >> (B<rxvt>) 1822=item B<< C<Pm = 35> >> (B<rxvt>)
1821 1823
1973 1975
1974=begin table 1976=begin table
1975 1977
1976 B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it 1978 B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
1977 B<< C<l> >> Use Normal Screen Buffer 1979 B<< C<l> >> Use Normal Screen Buffer
1980
1981=end table
1982
1983=item B<< C<Pm = 2004> >>
1984
1985=begin table
1986
1987 B<< C<h> >> Enable bracketed paste mode - prepend / append to the pasted text the control sequences C<ESC [ 200 ~> / C<ESC [ 201 ~>
1988 B<< C<l> >> Disable bracketed paste mode
1978 1989
1979=end table 1990=end table
1980 1991
1981=back 1992=back
1982 1993
1999 B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >> 2010 B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >>
2000 B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >> 2011 B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >>
2001 B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >> 2012 B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >>
2002 B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it. If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property. 2013 B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it. If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property.
2003 B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an index to a colour and B<name> is the name of a colour. Each pair causes the B<number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white 2014 B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an index to a colour and B<name> is the name of a colour. Each pair causes the B<number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white
2004 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<(NB: may change in future)> 2015 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >>
2005 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> B<(NB: may change in future)> 2016 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >>
2006 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> 2017 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >>
2007 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> 2018 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >>
2008 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> 2019 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >>
2009 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706] 2020 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706]
2010 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707] 2021 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707]
2011 B<< C<Ps = 20> >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage). 2022 B<< C<Ps = 20> >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage).
2012 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. 2023 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10]
2013 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> 2024 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
2014 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. 2025 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11]
2015 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> 2026 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >>
2016 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> 2027 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> [disabled]
2017 B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills). 2028 B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills).
2018 B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>. 2029 B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>.
2019 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> 2030 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >>
2020 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). 2031 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency).
2021 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> 2032 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
2032 2043
2033=back 2044=back
2034 2045
2035=head1 BACKGROUND IMAGE 2046=head1 BACKGROUND IMAGE
2036 2047
2037For the BACGROUND IMAGE XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value 2048For the BACKGROUND IMAGE XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> the value
2038of B<< C<Pt> >> can be the name of the background image file followed by a 2049of B<< C<Pt> >> can be the name of the background image file followed by a
2039sequence of scaling/positioning commands separated by semi-colons. The 2050sequence of scaling/positioning commands separated by semi-colons. The
2040scaling/positioning commands are as follows: 2051scaling/positioning commands are as follows:
2041 2052
2042=over 4 2053=over 4
2325=item --with-res-name=NAME (default: urxvt) 2336=item --with-res-name=NAME (default: urxvt)
2326 2337
2327Use the given name as default application name when 2338Use the given name as default application name when
2328reading resources. Specify --with-res-name=rxvt to replace rxvt. 2339reading resources. Specify --with-res-name=rxvt to replace rxvt.
2329 2340
2330=item --with-res-class=CLASS /default: URxvt) 2341=item --with-res-class=CLASS (default: URxvt)
2331 2342
2332Use the given class as default application class 2343Use the given class as default application class
2333when reading resources. Specify --with-res-class=Rxvt to replace 2344when reading resources. Specify --with-res-class=Rxvt to replace
2334rxvt. 2345rxvt.
2335 2346
2388=item --enable-plain-scroll (default: on) 2399=item --enable-plain-scroll (default: on)
2389 2400
2390Add support for a very unobtrusive, plain-looking scrollbar that 2401Add support for a very unobtrusive, plain-looking scrollbar that
2391is the favourite of the rxvt-unicode author, having used it for 2402is the favourite of the rxvt-unicode author, having used it for
2392many years. 2403many years.
2393
2394=item --enable-ttygid (default: off)
2395
2396Change tty device setting to group "tty" - only use this if
2397your system uses this type of security.
2398 2404
2399=item --disable-backspace-key 2405=item --disable-backspace-key
2400 2406
2401Removes any handling of the backspace key by us - let the X server do it. 2407Removes any handling of the backspace key by us - let the X server do it.
2402 2408
2435 keysym remapping support 2441 keysym remapping support
2436 cursor blinking and underline cursor (-cb, -uc) 2442 cursor blinking and underline cursor (-cb, -uc)
2437 XEmbed support (-embed) 2443 XEmbed support (-embed)
2438 user-pty (-pty-fd) 2444 user-pty (-pty-fd)
2439 hold on exit (-hold) 2445 hold on exit (-hold)
2446 compile in built-in block graphics
2440 skip builtin block graphics (-sbg) 2447 skip builtin block graphics (-sbg)
2441 separate highlightcolor support (-hc) 2448 separate highlightcolor support (-hc)
2442 2449
2443It also enables some non-essential features otherwise disabled, such as: 2450It also enables some non-essential features otherwise disabled, such as:
2444 2451
2485 2492
2486Add smart growth/shrink behaviour when resizing. 2493Add smart growth/shrink behaviour when resizing.
2487This should keep the window corner which is closest to a corner of 2494This should keep the window corner which is closest to a corner of
2488the screen in a fixed position. 2495the screen in a fixed position.
2489 2496
2497=item --enable-text-blink (default: on)
2498
2499Add support for blinking text.
2500
2490=item --enable-pointer-blank (default: on) 2501=item --enable-pointer-blank (default: on)
2491 2502
2492Add support to have the pointer disappear when typing or inactive. 2503Add support to have the pointer disappear when typing or inactive.
2493 2504
2494=item --enable-perl (default: on) 2505=item --enable-perl (default: on)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines