|
|
1 | =head1 NAME |
|
|
2 | |
|
|
3 | RXVT TECHNICAL REFERENCE - command sequences and background information |
|
|
4 | |
|
|
5 | =head1 SYNOPSIS |
|
|
6 | |
|
|
7 | # set a new font set |
|
|
8 | printf '\33]50;%s\007' 9x15,xft:Kochi" Mincho" |
|
|
9 | |
|
|
10 | # change the locale and tell rxvt-unicode about it |
|
|
11 | export LC_CTYPE=ja_JP.EUC-JP; printf "\33]701;$LC_CTYPE\007" |
|
|
12 | |
|
|
13 | # set window title |
|
|
14 | printf '\33]2;%s\007' "new window title" |
|
|
15 | |
|
|
16 | =head1 DESCRIPTION |
|
|
17 | |
|
|
18 | The rest of this document describes various technical aspects of |
|
|
19 | B<rxvt-unicode>. First the description of supported command sequences, |
|
|
20 | followed by menu and pixmap support and last by a description of all |
|
|
21 | features selectable at C<configure> time. |
|
|
22 | |
1 | =head1 RXVT TECHNICAL REFERENCE |
23 | =head1 RXVT TECHNICAL REFERENCE |
2 | |
24 | |
3 | =head1 Definitions |
25 | =head1 Definitions |
4 | |
26 | |
5 | =over 4 |
27 | =over 4 |
… | |
… | |
149 | |
171 | |
150 | =item B<< C<ESC o> >> |
172 | =item B<< C<ESC o> >> |
151 | |
173 | |
152 | Invoke the G3 Character Set (LS3) |
174 | Invoke the G3 Character Set (LS3) |
153 | |
175 | |
154 | =item B<< C<ESC>(C<C> >> |
176 | =item B<< C<ESC> ( C> >> |
155 | |
177 | |
156 | Designate G0 Character Set (ISO 2022), see below for values of C<C>. |
178 | Designate G0 Character Set (ISO 2022), see below for values of C<C>. |
157 | |
179 | |
158 | =item B<< C<ESC>)C<C> >> |
180 | =item B<< C<ESC> ) C> >> |
159 | |
181 | |
160 | Designate G1 Character Set (ISO 2022), see below for values of C<C>. |
182 | Designate G1 Character Set (ISO 2022), see below for values of C<C>. |
161 | |
183 | |
162 | =item B<< C<ESC * C> >> |
184 | =item B<< C<ESC * C> >> |
163 | |
185 | |
… | |
… | |
330 | B<< C<Ps = 0> >> Clear Current Column (default) |
352 | B<< C<Ps = 0> >> Clear Current Column (default) |
331 | B<< C<Ps = 3> >> Clear All (TBC) |
353 | B<< C<Ps = 3> >> Clear All (TBC) |
332 | |
354 | |
333 | =end table |
355 | =end table |
334 | |
356 | |
|
|
357 | =item B<< C<ESC [ Pm h> >> |
|
|
358 | |
|
|
359 | Set Mode (SM). See B<< C<ESC [ Pm l> >> sequence for description of C<Pm>. |
|
|
360 | |
335 | =item B<< C<ESC [ Ps i> >> |
361 | =item B<< C<ESC [ Ps i> >> |
336 | |
362 | |
337 | Printing |
363 | Printing. See also the C<print-pipe> resource. |
338 | |
364 | |
339 | =begin table |
365 | =begin table |
340 | |
366 | |
|
|
367 | B<< C<Ps = 0> >> print screen (MC0) |
341 | B<< C<Ps = 4> >> disable transparent print mode (MC4) |
368 | B<< C<Ps = 4> >> disable transparent print mode (MC4) |
342 | B<< C<Ps = 5> >> enable transparent print mode (MC5) I<unimplemented> |
369 | B<< C<Ps = 5> >> enable transparent print mode (MC5) |
343 | |
370 | |
344 | =end table |
371 | =end table |
345 | |
|
|
346 | =item B<< C<ESC [ Pm h> >> |
|
|
347 | |
|
|
348 | Set Mode (SM). See next sequence for description of C<Pm>. |
|
|
349 | |
372 | |
350 | =item B<< C<ESC [ Pm l> >> |
373 | =item B<< C<ESC [ Pm l> >> |
351 | |
374 | |
352 | Reset Mode (RM) |
375 | Reset Mode (RM) |
353 | |
376 | |
… | |
… | |
379 | |
402 | |
380 | =begin table |
403 | =begin table |
381 | |
404 | |
382 | B<< C<Ps = 0> >> Normal (default) |
405 | B<< C<Ps = 0> >> Normal (default) |
383 | B<< C<Ps = 1 / 21> >> On / Off Bold (bright fg) |
406 | B<< C<Ps = 1 / 21> >> On / Off Bold (bright fg) |
384 | B<< C<Ps = 3 / 23> >> On / Off Italic (NYI) |
407 | B<< C<Ps = 3 / 23> >> On / Off Italic |
385 | B<< C<Ps = 4 / 24> >> On / Off Underline |
408 | B<< C<Ps = 4 / 24> >> On / Off Underline |
386 | B<< C<Ps = 5 / 25> >> On / Off Slow Blink (bright bg) |
409 | B<< C<Ps = 5 / 25> >> On / Off Slow Blink (bright bg) |
387 | B<< C<Ps = 6 / 26> >> On / Off Rapid Blink (bright bg) |
410 | B<< C<Ps = 6 / 26> >> On / Off Rapid Blink (bright bg) |
|
|
411 | B<< C<Ps = 7 / 27> >> On / Off Inverse |
388 | B<< C<Ps = 7 / 27> >> On / Off Invisible (NYI) |
412 | B<< C<Ps = 8 / 27> >> On / Off Invisible (NYI) |
389 | B<< C<Ps = 8 / 27> >> On / Off Inverse |
|
|
390 | B<< C<Ps = 30 / 40> >> fg/bg Black |
413 | B<< C<Ps = 30 / 40> >> fg/bg Black |
391 | B<< C<Ps = 31 / 41> >> fg/bg Red |
414 | B<< C<Ps = 31 / 41> >> fg/bg Red |
392 | B<< C<Ps = 32 / 42> >> fg/bg Green |
415 | B<< C<Ps = 32 / 42> >> fg/bg Green |
393 | B<< C<Ps = 33 / 43> >> fg/bg Yellow |
416 | B<< C<Ps = 33 / 43> >> fg/bg Yellow |
394 | B<< C<Ps = 34 / 44> >> fg/bg Blue |
417 | B<< C<Ps = 34 / 44> >> fg/bg Blue |
395 | B<< C<Ps = 35 / 45> >> fg/bg Magenta |
418 | B<< C<Ps = 35 / 45> >> fg/bg Magenta |
396 | B<< C<Ps = 36 / 46> >> fg/bg Cyan |
419 | B<< C<Ps = 36 / 46> >> fg/bg Cyan |
|
|
420 | B<< C<Ps = 38;5 / 48;5> >> set fg/bg to color #m (ISO 8613-6) |
397 | B<< C<Ps = 37 / 47> >> fg/bg White |
421 | B<< C<Ps = 37 / 47> >> fg/bg White |
398 | B<< C<Ps = 39 / 49> >> fg/bg Default |
422 | B<< C<Ps = 39 / 49> >> fg/bg Default |
399 | B<< C<Ps = 90 / 100> >> fg/bg Bright Black |
423 | B<< C<Ps = 90 / 100> >> fg/bg Bright Black |
400 | B<< C<Ps = 91 / 101> >> fg/bg Bright Red |
424 | B<< C<Ps = 91 / 101> >> fg/bg Bright Red |
401 | B<< C<Ps = 92 / 102> >> fg/bg Bright Green |
425 | B<< C<Ps = 92 / 102> >> fg/bg Bright Green |
… | |
… | |
745 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
769 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
746 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >> I<rxvt compile-time option> |
770 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >> I<rxvt compile-time option> |
747 | 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> >> |
771 | 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> >> |
748 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
772 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
749 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (@@RXVT_NAME@@ extension) |
773 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (@@RXVT_NAME@@ extension) |
750 | B<< C<Ps = 702> >> find font for character, used for debugging (@@RXVT_NAME@@ extension) |
|
|
751 | B<< C<Ps = 703> >> menubar command B<< C<Pt> >> I<rxvt compile-time option> (@@RXVT_NAME@@ extension) |
774 | B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> I<rxvt compile-time option> (rxvt-unicode extension) |
|
|
775 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
|
|
776 | B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> |
|
|
777 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
|
|
778 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
|
|
779 | B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
|
|
780 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
752 | |
781 | |
753 | =end table |
782 | =end table |
754 | |
783 | |
755 | =back |
784 | =back |
756 | |
785 | |
… | |
… | |
1433 | |
1462 | |
1434 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts are |
1463 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts are |
1435 | slower and require lots of memory, but as long as you don't use them, you |
1464 | slower and require lots of memory, but as long as you don't use them, you |
1436 | don't pay for them. |
1465 | don't pay for them. |
1437 | |
1466 | |
|
|
1467 | =item --enable-font-styles |
|
|
1468 | |
|
|
1469 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
|
|
1470 | styles. The fonts can be set manually or automatically. |
|
|
1471 | |
1438 | =item --with-codesets=NAME,... |
1472 | =item --with-codesets=NAME,... |
1439 | |
1473 | |
1440 | Compile in support for additional codeset (encoding) groups. These codeset |
1474 | Compile in support for additional codeset (encoding) groups (eu, vn are |
|
|
1475 | always compiled in, which includes most 8-bit character sets). These |
1441 | tables are currently only used for driving X11 core fonts, they are not |
1476 | codeset tables are currently only used for driving X11 core fonts, they |
1442 | required for Xft fonts. Compiling them in will make your binary bigger |
1477 | are not required for Xft fonts. Compiling them in will make your binary |
1443 | (together about 700kB), but it doesn't increase memory usage unless you |
1478 | bigger (together about 700kB), but it doesn't increase memory usage unless |
1444 | use an X11 font requiring one of these encodings. |
1479 | you use an X11 font requiring one of these encodings. |
1445 | |
1480 | |
1446 | =begin table |
1481 | =begin table |
1447 | |
1482 | |
1448 | all all available codeset groups |
1483 | all all available codeset groups |
1449 | cn common chinese encodings |
1484 | cn common chinese encodings |
… | |
… | |
1660 | |
1695 | |
1661 | Add smart growth/shrink behaviour when changing font size via from hot |
1696 | Add smart growth/shrink behaviour when changing font size via from hot |
1662 | keys. This should keep in a fixed position the rxvt corner which is |
1697 | keys. This should keep in a fixed position the rxvt corner which is |
1663 | closest to a corner of the screen. |
1698 | closest to a corner of the screen. |
1664 | |
1699 | |
1665 | =item --enable-256-color |
|
|
1666 | |
|
|
1667 | Add support for 256 colours rather than the base 16 colours. |
|
|
1668 | |
|
|
1669 | This option will likely go away in the future. Speak up if you don't want |
|
|
1670 | this. |
|
|
1671 | |
|
|
1672 | =item --enable-cursor-blink |
1700 | =item --enable-cursor-blink |
1673 | |
1701 | |
1674 | Add support for a blinking cursor. |
1702 | Add support for a blinking cursor. |
1675 | |
1703 | |
1676 | =item --enable-pointer-blank |
1704 | =item --enable-pointer-blank |