--- rxvt-unicode/doc/rxvt.1.txt 2006/07/06 19:43:21 1.60 +++ rxvt-unicode/doc/rxvt.1.txt 2006/11/02 17:37:47 1.63 @@ -6,7 +6,7 @@ rxvt [options] [-e command [ args ]] DESCRIPTION - rxvt-unicode, version 7.7, is a colour vt102 terminal emulator intended + rxvt-unicode, version 8.0, is a colour vt102 terminal emulator intended as an *xterm*(1) replacement for users who do not require features such as Tektronix 4014 emulation and toolkit-style configurability. As a result, rxvt-unicode uses much less swap space -- a significant @@ -16,7 +16,7 @@ See rxvt(7) (try "man 7 rxvt") for a list of frequently asked questions and answer to them and some common problems. That document is also accessible on the World-Wide-Web at - . + . RXVT-UNICODE VS. RXVT Unlike the original rxvt, rxvt-unicode stores all text in Unicode @@ -26,14 +26,14 @@ scripts like mongolian or scripts requiring extremely complex combining rules, like tibetan or devenagari. Don't expect pretty output when using these scripts. Most other scripts, latin, cyrillic, kanji, thai etc. - should work fine, though. A somewhat difficult case are left-to-right + should work fine, though. A somewhat difficult case are right-to-left scripts, such as hebrew: rxvt-unicode adopts the view that bidirectional algorithms belong into the application, not the terminal emulator (too many things -- such as cursor-movement while editing -- break otherwise), but that might change. If you are looking for a terminal that supports more exotic scripts, let - me recommend "mlterm", which is a very userfriendly, lean and clean + me recommend "mlterm", which is a very user friendly, lean and clean terminal emulator. In fact, the reason rxvt-unicode was born was solely because the author couldn't get "mlterm" to use one font for latin1 and another for japanese. @@ -45,7 +45,7 @@ Apart from that, rxvt-unicode is also much better internationalised than its predecessor, supports things such as XFT and ISO 14755 that are - handy in i18n-environments, is faster, and has a lot less bugs than the + handy in i18n-environments, is faster, and has a lot bugs less than the original rxvt. This all in addition to dozens of other small improvements. @@ -58,7 +58,7 @@ (client). It also makes technical information about escape sequences (which have - been extended) easier accessible: see rxvt(7) for technical reference + been extended) more accessible: see rxvt(7) for technical reference documentation (escape sequences etc.). OPTIONS @@ -104,7 +104,8 @@ -tr; resource inheritPixmap. *Please note that transparency of any kind if completely unsupported - by the author. Don't bug him with installation questions!* + by the author. Don't bug him with installation questions! Read the + FAQ (man 7 rxvt)!* -fade *number* Fade the text by the given percentage when focus is lost. Small @@ -372,7 +373,7 @@ It might be useful to know that rxvt will not close file descriptors passed to it (except for stdin/out/err, of course), so you can use file descriptors to communicate with the programs within the - terminal. This works regardless of wether the "-embed" option was + terminal. This works regardless of whether the "-embed" option was used or not. Here is a short Gtk2-perl snippet that illustrates how this option @@ -386,7 +387,7 @@ -pty-fd *file descriptor* Tells rxvt NOT to execute any commands or create a new pty/tty pair - but instead use the given filehandle as the tty master. This is + but instead use the given file descriptor as the tty master. This is useful if you want to drive rxvt as a generic terminal emulator without having to run a program within it. @@ -624,7 +625,7 @@ intensityStyles: *boolean* When font styles are not enabled, or this option is enabled (True, option -is, the default), bold and italic font styles imply high - intensity foreground/backround colours. Disabling this option + intensity foreground/background colours. Disabling this option (False, option +is) disables this behaviour, the high intensity colours are not reachable. @@ -677,7 +678,7 @@ URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) This creates a new file in your home directory with the screen - contents everytime you hit "Print". + contents every time you hit "Print". scrollBar: *boolean* True: enable the scrollbar [default]; option -sb. False: disable the @@ -702,7 +703,7 @@ scrollWithBuffer: *boolean* True: scroll with scrollback buffer when tty receives new lines (and scrollTtyOutput is False); option -sw. False: do not scroll with - scrollback buffer when tty recieves new lines; option +sw. + scrollback buffer when tty receives new lines; option +sw. scrollTtyKeypress: *boolean* True: scroll to bottom when a non-special key is pressed. Special @@ -887,7 +888,8 @@ "\e", "\E": escape, "\n": newline, "\r": carriage return, "\t": tab, "\000": octal number) or verbatim control characters ("^?": delete, "^@": null, "^A" ...) and may be enclosed with double quotes so that - it can start or end with whitespace. + it can start or end with whitespace. This feature is deprecated and + will be removed. Please note that you need to double the "\" in resource files, as Xlib itself does its own de-escaping (you can use "\033" instead of @@ -895,7 +897,7 @@ processing). You can define a range of keysyms in one shot by providing a - *string* with pattern list/PREFIX/MIDDLE/SUFFIX, where the delimeter + *string* with pattern list/PREFIX/MIDDLE/SUFFIX, where the delimiter `/' should be a character not used by the strings. Its usage can be demonstrated by an example: @@ -967,7 +969,7 @@ Extension names can also be followed by an argument in angle brackets (e.g. "searchable-scrollback", which binds the hotkey - for searchable scorllback to Alt/Meta-s). Mentioning the same + for searchable scrollback to Alt/Meta-s). Mentioning the same extension multiple times with different arguments will pass multiple arguments to the extension. @@ -1090,8 +1092,7 @@ the rest is available when rxvt-unicode was compiled with "--enable-iso14755". - * 5.1: Basic method - + * 5.1: Basic method This allows you to enter unicode characters using their hexcode. Start by pressing and holding both "Control" and "Shift", then enter @@ -1107,8 +1108,7 @@ easily by pressing "Control" and "Shift", followed by "6-7-1-D-SPACE-6-5-E-5", followed by releasing the modifier keys. - * 5.2: Keyboard symbols entry method - + * 5.2: Keyboard symbols entry method This mode lets you input characters representing the keycap symbols of your keyboard, if representable in the current locale encoding. @@ -1120,15 +1120,13 @@ enter the symbol for "ISO Level 2 Switch", although your intention might have been to enter a reverse tab (Shift-Tab). - * 5.3: Screen-selection entry method - + * 5.3: Screen-selection entry method While this is implemented already (it's basically the selection mechanism), it could be extended by displaying a unicode character map. - * 5.4: Feedback method for identifying displayed characters for later - input - + * 5.4: Feedback method for identifying displayed characters for later + input This method lets you display the unicode character code associated with characters already displayed. @@ -1157,24 +1155,25 @@ display up to 16 colours (8 ANSI colours plus high-intensity bold/blink versions of the same). Here is a list of the colours with their names. - color0 (black) = Black - color1 (red) = Red3 - color2 (green) = Green3 - color3 (yellow) = Yellow3 - color4 (blue) = Blue3 - color5 (magenta) = Magenta3 - color6 (cyan) = Cyan3 - color7 (white) = AntiqueWhite - color8 (bright black) = Grey25 - color9 (bright red) = Red - color10 (bright green) = Green - color11 (bright yellow) = Yellow - color12 (bright blue) = Blue - color13 (bright magenta) = Magenta - color14 (bright cyan) = Cyan - color15 (bright white) = White - foreground = Black - background = White + color0 (black) = Black + color1 (red) = Red3 + color2 (green) = Green3 + color3 (yellow) = Yellow3 + color4 (blue) = Blue3 + color5 (magenta) = Magenta3 + color6 (cyan) = Cyan3 + color7 (white) = AntiqueWhite + color8 (bright black) = Grey25 + color9 (bright red) = Red + color10 (bright green) = Green + color11 (bright yellow) = Yellow + color12 (bright blue) = Blue + color13 (bright magenta) = Magenta + color14 (bright cyan) = Cyan + color15 (bright white) = White + foreground = Black + background = White + It is also possible to specify the colour values of foreground, background, cursorColor, cursorColor2, colorBD, colorUL as a number 0-15, as a convenient shorthand to reference the colour name of @@ -1225,10 +1224,10 @@ TERM Normally set to "rxvt-unicode", unless overwritten at configure - time, via resources or on the commandline. + time, via resources or on the command line. COLORTERM - Either "rxvt", "rxvt-xpm", depending on wether rxvt was compiled + Either "rxvt", "rxvt-xpm", depending on whether rxvt was compiled with XPM support, and optionally with the added extension "-mono" to indicate that rxvt-unicode runs on a monochrome screen.