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.4 by root, Thu Aug 12 22:23:29 2004 UTC vs.
Revision 1.12 by root, Mon Aug 16 00:17:27 2004 UTC

187 187
188=back 188=back
189 189
190X<CSI> 190X<CSI>
191 191
192=head1 CSI (Code Sequence Introducer) Sequences 192=head1 CSI (Command Sequence Introducer) Sequences
193 193
194=over 4 194=over 4
195 195
196=item B<< C<ESC [ Ps @> >> 196=item B<< C<ESC [ Ps @> >>
197 197
360 B<< C<h> >> Insert Mode (SMIR) 360 B<< C<h> >> Insert Mode (SMIR)
361 B<< C<l> >> Replace Mode (RMIR) 361 B<< C<l> >> Replace Mode (RMIR)
362 362
363=end table 363=end table
364 364
365=item B<< C<Ps = 20> >> I<unimplemented> 365=item B<< C<Ps = 20> >> (partially implemented)
366 366
367=begin table 367=begin table
368 368
369 B<< C<h> >> Automatic Newline (LNM) 369 B<< C<h> >> Automatic Newline (LNM)
370 B<< C<h> >> Normal Linefeed (LNM) 370 B<< C<l> >> Normal Linefeed (LNM)
371 371
372=end table 372=end table
373 373
374=back 374=back
375 375
378Character Attributes (SGR) 378Character Attributes (SGR)
379 379
380=begin table 380=begin table
381 381
382 B<< C<Ps = 0> >> Normal (default) 382 B<< C<Ps = 0> >> Normal (default)
383 B<< C<Ps = 1 / 22> >> On / Off Bold (bright fg) 383 B<< C<Ps = 1 / 21> >> On / Off Bold (bright fg)
384 B<< C<Ps = 3 / 23> >> On / Off Italic (NYI)
384 B<< C<Ps = 4 / 24> >> On / Off Underline 385 B<< C<Ps = 4 / 24> >> On / Off Underline
385 B<< C<Ps = 5 / 25> >> On / Off Blink (bright bg) 386 B<< C<Ps = 5 / 25> >> On / Off Slow Blink (bright bg)
387 B<< C<Ps = 6 / 26> >> On / Off Rapid Blink (bright bg)
388 B<< C<Ps = 7 / 27> >> On / Off Invisible (NYI)
386 B<< C<Ps = 7 / 27> >> On / Off Inverse 389 B<< C<Ps = 8 / 27> >> On / Off Inverse
387 B<< C<Ps = 30 / 40> >> fg/bg Black 390 B<< C<Ps = 30 / 40> >> fg/bg Black
388 B<< C<Ps = 31 / 41> >> fg/bg Red 391 B<< C<Ps = 31 / 41> >> fg/bg Red
389 B<< C<Ps = 32 / 42> >> fg/bg Green 392 B<< C<Ps = 32 / 42> >> fg/bg Green
390 B<< C<Ps = 33 / 43> >> fg/bg Yellow 393 B<< C<Ps = 33 / 43> >> fg/bg Yellow
391 B<< C<Ps = 34 / 44> >> fg/bg Blue 394 B<< C<Ps = 34 / 44> >> fg/bg Blue
392 B<< C<Ps = 35 / 45> >> fg/bg Magenta 395 B<< C<Ps = 35 / 45> >> fg/bg Magenta
393 B<< C<Ps = 36 / 46> >> fg/bg Cyan 396 B<< C<Ps = 36 / 46> >> fg/bg Cyan
394 B<< C<Ps = 37 / 47> >> fg/bg White 397 B<< C<Ps = 37 / 47> >> fg/bg White
395 B<< C<Ps = 39 / 49> >> fg/bg Default 398 B<< C<Ps = 39 / 49> >> fg/bg Default
399 B<< C<Ps = 90 / 100> >> fg/bg Bright Black
400 B<< C<Ps = 91 / 101> >> fg/bg Bright Red
401 B<< C<Ps = 92 / 102> >> fg/bg Bright Green
402 B<< C<Ps = 93 / 103> >> fg/bg Bright Yellow
403 B<< C<Ps = 94 / 104> >> fg/bg Bright Blue
404 B<< C<Ps = 95 / 105> >> fg/bg Bright Magenta
405 B<< C<Ps = 96 / 106> >> fg/bg Bright Cyan
406 B<< C<Ps = 97 / 107> >> fg/bg Bright White
407 B<< C<Ps = 99 / 109> >> fg/bg Bright Default
396 408
397=end table 409=end table
398 410
399=item B<< C<ESC [ Ps n> >> 411=item B<< C<ESC [ Ps n> >>
400 412
535 B<< C<h> >> Send Mouse X & Y on button press. 547 B<< C<h> >> Send Mouse X & Y on button press.
536 B<< C<l> >> No mouse reporting. 548 B<< C<l> >> No mouse reporting.
537 549
538=end table 550=end table
539 551
540X<Priv10>
541
542=item B<< C<Ps = 10> >> (B<rxvt>) 552=item B<< C<Ps = 10> >> (B<rxvt>)
543 553
544=begin table 554=begin table
545 555
546 B<< C<h> >> visible 556 B<< C<h> >> menuBar visible
547 B<< C<l> >> invisible 557 B<< C<l> >> menuBar invisible
548 558
549=end table 559=end table
550 560
551=item B<< C<Ps = 25> >> 561=item B<< C<Ps = 25> >>
552 562
653 B<< C<h> >> Use Hilite Mouse Tracking. 663 B<< C<h> >> Use Hilite Mouse Tracking.
654 B<< C<l> >> No mouse reporting. 664 B<< C<l> >> No mouse reporting.
655 665
656=end table 666=end table
657 667
658=item B<< C<Ps = 1010> >> 668=item B<< C<Ps = 1010> >> (B<rxvt>)
659 669
660=begin table 670=begin table
661 671
662 B<< C<h> >> Don't scroll to bottom on TTY output 672 B<< C<h> >> Don't scroll to bottom on TTY output
663 B<< C<l> >> Scroll to bottom on TTY output 673 B<< C<l> >> Scroll to bottom on TTY output
664 674
665=end table 675=end table
666 676
667=item B<< C<Ps = 1011> >> 677=item B<< C<Ps = 1011> >> (B<rxvt>)
668 678
669=begin table 679=begin table
670 680
671 B<< C<h> >> Scroll to bottom when a key is pressed 681 B<< C<h> >> Scroll to bottom when a key is pressed
672 B<< C<l> >> Don't scroll to bottom when a key is pressed 682 B<< C<l> >> Don't scroll to bottom when a key is pressed
686 696
687=begin table 697=begin table
688 698
689 B<< C<h> >> Save cursor position 699 B<< C<h> >> Save cursor position
690 B<< C<l> >> Restore cursor position 700 B<< C<l> >> Restore cursor position
701
702=end table
703
704=item B<< C<Ps = 1049> >>
705
706=begin table
707
708 B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
709 B<< C<l> >> Use Normal Screen Buffer
691 710
692=end table 711=end table
693 712
694=back 713=back
695 714
727 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >> I<rxvt compile-time option> 746 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >> I<rxvt compile-time option>
728 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> >> 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> >>
729 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> 748 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >>
730 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) 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)
731 B<< C<Ps = 702> >> find font for character, used for debugging (@@RXVT_NAME@@ extension) 750 B<< C<Ps = 702> >> find font for character, used for debugging (@@RXVT_NAME@@ extension)
732 B<< C<Ps = 703> >> command B<< C<Pt> >> I<rxvt compile-time option> (@@RXVT_NAME@@ extension) 751 B<< C<Ps = 703> >> menubar command B<< C<Pt> >> I<rxvt compile-time option> (@@RXVT_NAME@@ extension)
733 752
734=end table 753=end table
735 754
736=back 755=back
737 756
1390 XK_KP_8 8 ESC O x 1409 XK_KP_8 8 ESC O x
1391 XK_KP_9 9 ESC O y 1410 XK_KP_9 9 ESC O y
1392 1411
1393=end table 1412=end table
1394 1413
1414=head1 CONFIGURE OPTIONS
1415
1416General hint: if you get compile errors, then likely your configuration
1417hasn't been tested well. Either try with --enable-everything or use the
1418./reconf script as a base for experiments. ./reconf is used by myself,
1419so it should generally be a working config. Of course, you should always
1420report when a combination doesn't work, so it can be fixed. Marc Lehmann
1421<rxvt@schmorp.de>.
1422
1423=over 4
1424
1425=item --enable-everything
1426
1427Add support for all non-multichoice options listed in "./configure
1428--help". Note that unlike other enable options this is order dependant.
1429You can specify this and then disable options which this enables by
1430I<following> this with the appropriate commands.
1431
1432=item --enable-xft
1433
1434Add support for Xft (anti-aliases, among others) fonts. Xft fonts are
1435slower and require lots of memory, but as long as you don't use them, you
1436don't pay for them.
1437
1438=item --with-codesets=NAME,...
1439
1440Compile in support for additional codeset (encoding) groups. These codeset
1441tables are currently only used for driving X11 core fonts, they are not
1442required for Xft fonts. Compiling them in will make your binary bigger
1443(together about 700kB), but it doesn't increase memory usage unless you
1444use an X11 font requiring one of these encodings.
1445
1446=begin table
1447
1448 all all available codeset groups
1449 cn common chinese encodings
1450 cn_ext rarely used but very big chinese encodigs
1451 jp common japanese encodings
1452 jp_ext rarely used but big japanese encodings
1453 kr korean encodings
1454
1455=end table
1456
1457=item --enable-xim
1458
1459Add support for XIM (X Input Method) protocol. This allows using
1460alternative input methods (e.g. kinput2) and will also correctly
1461set up the input for people using dead keys or compose keys.
1462
1463=item --enable-unicode3
1464
1465Enable direct support for displaying unicode codepoints above
146665535 (the basic multilingual page). This increases storage
1467requirements per character from 2 to 4 bytes. X11 fonts do not yet
1468support these extra characters, but Xft does.
1469
1470Please note that rxvt-unicode can store unicode code points >65535
1471even without this flag, but the number of such characters is
1472limited to a view thousand (shared with combining characters,
1473see next switch), and right now rxvt-unicode cannot display them
1474(input/output and cut&paste still work, though).
1475
1476=item --enable-combining
1477
1478Enable automatic composition of combining characters into
1479composite characters. This is required for proper viewing of text
1480where accents are encoded as seperate unicode characters. This is
1481done by using precomposited characters when available or creating
1482new pseudo-characters when no precomposed form exists.
1483
1484Without --enable-unicode3, the number of additional precomposed
1485characters is rather limited (2048, if this is full, rxvt will use the
1486private use area, extending the number of combinations to 8448). With
1487--enable-unicode3, no practical limit exists. This will also enable
1488storage of characters >65535.
1489
1490The combining table also contains entries for arabic presentation forms,
1491but these are not currently used. Bug me if you want these to be used.
1492
1493=item --enable-fallback(=CLASS)
1494
1495When reading resource settings, also read settings for class CLASS
1496(default: Rxvt). To disable resource fallback use --disable-fallback.
1497
1498=item --with-res-name=NAME
1499
1500Use the given name (default: urxvt) as default application name when
1501reading resources. Specify --with-res-name=rxvt to replace rxvt.
1502
1503=item --with-res-class=CLASS
1504
1505Use the given class (default: URxvt) as default application class
1506when reading resources. Specify --with-res-class=Rxvt to replace
1507rxvt.
1508
1509=item --enable-utmp
1510
1511Write user and tty to utmp file (used by programs like F<w>) at
1512start of rxvt execution and delete information when rxvt exits.
1513
1514=item --enable-wtmp
1515
1516Write user and tty to wtmp file (used by programs like F<last>) at
1517start of rxvt execution and write logout when rxvt exits. This
1518option requires --enable-utmp to also be specified.
1519
1520=item --enable-lastlog
1521
1522Write user and tty to lastlog file (used by programs like
1523F<lastlogin>) at start of rxvt execution. This option requires
1524--enable-utmp to also be specified.
1525
1526=item --enable-xpm-background
1527
1528Add support for XPM background pixmaps.
1529
1530=item --enable-transparency
1531
1532Add support for inheriting parent backgrounds thus giving a fake
1533transparency to the term.
1534
1535=item --enable-fading
1536
1537Add support for fading the text when focus is lost.
1538
1539=item --enable-tinting
1540
1541Add support for tinting of transparent backgrounds.
1542
1543=item --enable-menubar
1544
1545Add support for our menu bar system (this interacts badly with
1546dynamic locale switching currently).
1547
1548=item --enable-rxvt-scroll
1549
1550Add support for the original rxvt scrollbar.
1551
1552=item --enable-next-scroll
1553
1554Add support for a NeXT-like scrollbar.
1555
1556=item --enable-xterm-scroll
1557
1558Add support for an Xterm-like scrollbar.
1559
1560=item --enable-plain-scroll
1561
1562Add support for a very unobtrusive, plain-looking scrollbar that
1563is the favourite of the rxvt-unicode author, having used it for
1564many years.
1565
1566=item --enable-half-shadow
1567
1568Make shadows on the scrollbar only half the normal width & height.
1569only applicable to rxvt scrollbars.
1570
1571=item --enable-ttygid
1572
1573Change tty device setting to group "tty" - only use this if
1574your system uses this type of security.
1575
1576=item --disable-backspace-key
1577
1578Disable any handling of the backspace key by us - let the X server
1579do it.
1580
1581=item --disable-delete-key
1582
1583Disable any handling of the delete key by us - let the X server
1584do it.
1585
1586=item --disable-resources
1587
1588Remove all resources checking.
1589
1590=item --enable-xgetdefault
1591
1592Make resources checking via XGetDefault() instead of our small
1593version which only checks ~/.Xdefaults, or if that doesn't exist
1594then ~/.Xresources.
1595
1596=item --enable-strings
1597
1598Add support for our possibly faster memset() function and other
1599various routines, overriding your system's versions which may
1600have been hand-crafted in assembly or may require extra libraries
1601to link in. (this breaks ANSI-C rules and has problems on many
1602GNU/Linux systems).
1603
1604=item --disable-swapscreen
1605
1606Remove support for swap screen.
1607
1608=item --enable-frills
1609
1610Add support for many small features that are not essential but nice to
1611have. Normally you want this, but for very small binaries you may want to
1612disable this.
1613
1614=item --enable-iso14755
1615
1616Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
1617F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by
1618C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with
1619this switch.
1620
1621=item --enable-linespace
1622
1623Add support to provide user specified line spacing between text rows.
1624
1625=item --enable-keepscrolling
1626
1627Add support for continual scrolling of the display when you hold
1628the mouse button down on a scrollbar arrow.
1629
1630=item --enable-mousewheel
1631
1632Add support for scrolling via mouse wheel or buttons 4 & 5.
1633
1634=item --enable-slipwheeling
1635
1636Add support for continual scrolling (using the mouse wheel as an
1637accelerator) while the control key is held down. This option
1638requires --enable-mousewheel to also be specified.
1639
1640=item --disable-new-selection
1641
1642Remove support for mouse selection style like that of xterm.
1643
1644=item --enable-dmalloc
1645
1646Use Gray Watson's malloc - which is good for debugging See
1647http://www.letters.com/dmalloc/ for details If you use either this or the
1648next option, you may need to edit src/Makefile after compiling to point
1649DINCLUDE and DLIB to the right places.
1650
1651You can only use either this option and the following (should
1652you use either) .
1653
1654=item --enable-dlmalloc
1655
1656Use Doug Lea's malloc - which is good for a production version
1657See L<http://g.oswego.edu/dl/html/malloc.html> for details.
1658
1659=item --enable-smart-resize
1660
1661Add smart growth/shrink behaviour when changing font size via from hot
1662keys. This should keep in a fixed position the rxvt corner which is
1663closest to a corner of the screen.
1664
1665=item --enable-256-color
1666
1667Add support for 256 colours rather than the base 16 colours.
1668
1669This option will likely go away in the future. Speak up if you don't want
1670this.
1671
1672=item --enable-cursor-blink
1673
1674Add support for a blinking cursor.
1675
1676=item --enable-pointer-blank
1677
1678Add support to have the pointer disappear when typing or inactive.
1679
1680=item --with-name=NAME
1681
1682Set the basename for the installed binaries (default: urxvt, resulting in
1683urxvt, urxvtd etc.). Specify --with-name=rxvt to replace rxvt.
1684
1685=item --with-term=NAME
1686
1687Change the environmental variable for the terminal to NAME (default
1688"rxvt")
1689
1690=item --with-terminfo=PATH
1691
1692Change the environmental variable for the path to the terminfo tree to
1693PATH.
1694
1695=item --with-x
1696
1697Use the X Window System (pretty much default, eh?).
1698
1699=item --with-xpm-includes=DIR
1700
1701Look for the XPM includes in DIR.
1702
1703=item --with-xpm-library=DIR
1704
1705Look for the XPM library in DIR.
1706
1707=item --with-xpm
1708
1709Not needed - define via --enable-xpm-background.
1710
1711=back
1712
1395=head1 AUTHORS 1713=head1 AUTHORS
1396 1714
1397Marc Lehmann <rxvt@schmorp.de>, converted this document to pod and 1715Marc Lehmann <rxvt@schmorp.de> converted this document to pod and
1398reworked it from the original Rxvt documentation, which was done by Geoff 1716reworked it from the original Rxvt documentation, which was done by Geoff
1399Wing <gcw@pobox.com>, who in turn used the XTerm documentation and other 1717Wing <gcw@pobox.com>, who in turn used the XTerm documentation and other
1400sources. 1718sources.
1401 1719

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines