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.177 by root, Sat May 30 08:53:48 2009 UTC vs.
Revision 1.185 by sf-exg, Sun Apr 18 11:06:46 2010 UTC

557does not support this (for instance because it is not visual), then 557does not support this (for instance because it is not visual), then
558rxvt-unicode will continue without an input method. 558rxvt-unicode will continue without an input method.
559 559
560In this case either do not specify a B<preeditStyle> or specify more than 560In this case either do not specify a B<preeditStyle> or specify more than
561one pre-edit style, such as B<OverTheSpot,Root,None>. 561one pre-edit style, such as B<OverTheSpot,Root,None>.
562
563If it still doesn't work, then maybe your input method doesn't support
564compose sequences - to fall back to the built-in one, make sure you don't
565specify an input method via C<-im> or C<XMODIFIERS>.
562 566
563=head3 I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755 567=head3 I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755
564 568
565Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on 569Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on
566international keyboards) or simply use ISO 14755 support to your 570international keyboards) or simply use ISO 14755 support to your
714develop for myself mostly, so I actually use most of the extensions I 718develop for myself mostly, so I actually use most of the extensions I
715write. 719write.
716 720
717The selection stuff mainly makes the selection perl-error-message aware 721The selection stuff mainly makes the selection perl-error-message aware
718and tells it to convert perl error messages into vi-commands to load the 722and tells it to convert perl error messages into vi-commands to load the
719relevant file and go tot he error line number. 723relevant file and go to the error line number.
720 724
721 URxvt.scrollstyle: plain 725 URxvt.scrollstyle: plain
722 URxvt.secondaryScroll: true 726 URxvt.secondaryScroll: true
723 727
724As the documentation says: plain is the preferred scrollbar for the 728As the documentation says: plain is the preferred scrollbar for the
796purposes, it works, and gives a different look, as my normal (Non-bold) 800purposes, it works, and gives a different look, as my normal (Non-bold)
797font is already bold, and I want to see a difference between bold and 801font is already bold, and I want to see a difference between bold and
798normal fonts. 802normal fonts.
799 803
800Please note that I used the C<urxvt> instance name and not the C<URxvt> 804Please note that I used the C<urxvt> instance name and not the C<URxvt>
801class name. Thats because I use different configs for different purposes, 805class name. That is because I use different configs for different purposes,
802for example, my IRC window is started with C<-name IRC>, and uses these 806for example, my IRC window is started with C<-name IRC>, and uses these
803defaults: 807defaults:
804 808
805 IRC*title: IRC 809 IRC*title: IRC
806 IRC*geometry: 87x12+535+542 810 IRC*geometry: 87x12+535+542
1129runtime-switchable, too, so there is usually no drawback to enabling them, 1133runtime-switchable, too, so there is usually no drawback to enabling them,
1130except higher disk and possibly memory usage. The perl interpreter should 1134except higher disk and possibly memory usage. The perl interpreter should
1131be enabled, as important functionality (menus, selection, likely more in 1135be enabled, as important functionality (menus, selection, likely more in
1132the future) depends on it. 1136the future) depends on it.
1133 1137
1134You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources 1138You should not overwrite the C<perl-ext-common> and C<perl-ext> resources
1135system-wide (except maybe with C<defaults>). This will result in useful 1139system-wide (except maybe with C<defaults>). This will result in useful
1136behaviour. If your distribution aims at low memory, add an empty 1140behaviour. If your distribution aims at low memory, add an empty
1137C<perl-ext-common> resource to the app-defaults file. This will keep the 1141C<perl-ext-common> resource to the app-defaults file. This will keep the
1138perl interpreter disabled until the user enables it. 1142perl interpreter disabled until the user enables it.
1139 1143
1215The solution is to upgrade your system or switch to a better one. A 1219The solution is to upgrade your system or switch to a better one. A
1216possibly working workaround is to use a wcwidth implementation like 1220possibly working workaround is to use a wcwidth implementation like
1217 1221
1218http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c 1222http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
1219 1223
1220=head3 I want 256 colors
1221
1222Are you sure you need 256 colors? 88 colors should be enough for most
1223purposes. If you really need more, there is an unsupported patch for
1224it in the doc directory, but please do not ask for it to be applied.
1225
1226=head1 RXVT-UNICODE TECHNICAL REFERENCE 1224=head1 RXVT-UNICODE TECHNICAL REFERENCE
1227 1225
1228The rest of this document describes various technical aspects of 1226The rest of this document describes various technical aspects of
1229B<rxvt-unicode>. First the description of supported command sequences, 1227B<rxvt-unicode>. First the description of supported command sequences,
1230followed by pixmap support and last by a description of all features 1228followed by pixmap support and last by a description of all features
1329 1327
1330=item B<< C<ESC => >> 1328=item B<< C<ESC => >>
1331 1329
1332Application Keypad (SMKX). See also next sequence. 1330Application Keypad (SMKX). See also next sequence.
1333 1331
1334=item B<<< C<< ESC >> >>> 1332=item B<<< C<< ESC > >> >>>
1335 1333
1336Normal Keypad (RMKX) 1334Normal Keypad (RMKX)
1337 1335
1338B<Note:> If the numeric keypad is activated, eg, B<Num_Lock> has been 1336B<Note:> If the numeric keypad is activated, eg, B<Num_Lock> has been
1339pressed, numbers or control functions are generated by the numeric keypad 1337pressed, numbers or control functions are generated by the numeric keypad
1881 1879
1882=item B<< C<Pm = 66> >> 1880=item B<< C<Pm = 66> >>
1883 1881
1884=begin table 1882=begin table
1885 1883
1886 B<< C<h> >> Application Keypad (DECPAM) == C<ESC => 1884 B<< C<h> >> Application Keypad (DECKPAM/DECPAM) == C<ESC =>
1887 B<< C<l> >> Normal Keypad (DECPNM) == C<< ESC > >> 1885 B<< C<l> >> Normal Keypad (DECKPNM/DECPNM) == C<< ESC > >>
1888 1886
1889=end table 1887=end table
1890 1888
1891=item B<< C<Pm = 67> >> 1889=item B<< C<Pm = 67> >>
1892 1890
2022 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> 2020 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >>
2023 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> 2021 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >>
2024 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> 2022 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >>
2025 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> 2023 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >>
2026 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> 2024 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >>
2027 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706]
2028 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707]
2029 B<< C<Ps = 20> >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage). 2025 B<< C<Ps = 20> >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage).
2030 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10] 2026 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10]
2031 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> 2027 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
2032 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11] 2028 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11]
2033 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> >> 2029 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> >>
2255 2251
2256=over 4 2252=over 4
2257 2253
2258=item --enable-everything 2254=item --enable-everything
2259 2255
2260Add (or remove) support for all non-multichoice options listed in "./configure 2256Add (or remove) support for all non-multichoice options listed in
2261--help". 2257C<./configure --help>, except for C<--enable-assert>.
2262 2258
2263You can specify this and then disable options you do not like by 2259You can specify this and then disable options you do not like by
2264I<following> this with the appropriate C<--disable-...> arguments, 2260I<following> this with the appropriate C<--disable-...> arguments,
2265or you can start with a minimal configuration by specifying 2261or you can start with a minimal configuration by specifying
2266C<--disable-everything> and than adding just the C<--enable-...> arguments 2262C<--disable-everything> and than adding just the C<--enable-...> arguments
2267you want. 2263you want.
2264
2265=item --enable-256-color (default: off)
2266
2267Add support for 256 colors.
2268 2268
2269=item --enable-xft (default: enabled) 2269=item --enable-xft (default: enabled)
2270 2270
2271Add support for Xft (anti-aliases, among others) fonts. Xft fonts are 2271Add support for Xft (anti-aliases, among others) fonts. Xft fonts are
2272slower and require lots of memory, but as long as you don't use them, you 2272slower and require lots of memory, but as long as you don't use them, you
2321 2321
2322=item --enable-combining (default: on) 2322=item --enable-combining (default: on)
2323 2323
2324Enable automatic composition of combining characters into 2324Enable automatic composition of combining characters into
2325composite characters. This is required for proper viewing of text 2325composite characters. This is required for proper viewing of text
2326where accents are encoded as seperate unicode characters. This is 2326where accents are encoded as separate unicode characters. This is
2327done by using precomposited characters when available or creating 2327done by using precomposited characters when available or creating
2328new pseudo-characters when no precomposed form exists. 2328new pseudo-characters when no precomposed form exists.
2329 2329
2330Without --enable-unicode3, the number of additional precomposed 2330Without --enable-unicode3, the number of additional precomposed
2331characters is somewhat limited (the 6400 private use characters will be 2331characters is somewhat limited (the 6400 private use characters will be
2433in combination with other switches) is: 2433in combination with other switches) is:
2434 2434
2435 MWM-hints 2435 MWM-hints
2436 EWMH-hints (pid, utf8 names) and protocols (ping) 2436 EWMH-hints (pid, utf8 names) and protocols (ping)
2437 urgency hint 2437 urgency hint
2438 seperate underline colour (-underlineColor) 2438 separate underline colour (-underlineColor)
2439 settable border widths and borderless switch (-w, -b, -bl) 2439 settable border widths and borderless switch (-w, -b, -bl)
2440 visual depth selection (-depth) 2440 visual depth selection (-depth)
2441 settable extra linespacing /-lsp) 2441 settable extra linespacing /-lsp)
2442 iso-14755 5.1 (basic) support 2442 iso-14755 5.1 (basic) support
2443 tripleclickwords (-tcw) 2443 tripleclickwords (-tcw)
2514environment variable when running configure. Even when compiled in, 2514environment variable when running configure. Even when compiled in,
2515perl will I<not> be initialised when all extensions have been disabled 2515perl will I<not> be initialised when all extensions have been disabled
2516C<-pe "" --perl-ext-common "">, so it should be safe to enable from a 2516C<-pe "" --perl-ext-common "">, so it should be safe to enable from a
2517resource standpoint. 2517resource standpoint.
2518 2518
2519=item --enable-assert (default: off)
2520
2521Enables the assertions in the code, normally disabled. This switch is only
2522useful when developing rxvt-unicode.
2523
2519=item --with-afterimage-config=DIR 2524=item --with-afterimage-config=DIR
2520 2525
2521Look for the libAfterImage config script in DIR. 2526Look for the libAfterImage config script in DIR.
2522 2527
2523=item --with-name=NAME (default: urxvt) 2528=item --with-name=NAME (default: urxvt)

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines