--- rxvt-unicode/doc/rxvt.1.html 2005/01/11 02:24:59 1.1 +++ rxvt-unicode/doc/rxvt.1.html 2005/02/03 10:24:10 1.6 @@ -49,7 +49,7 @@


DESCRIPTION

-

rxvt-unicode, version 4.8, is a colour vt102 terminal +

rxvt-unicode, version 4.9, 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 -- @@ -196,8 +196,8 @@

Compile XPM: Specify XPM file for the background and also optionally -specify its scaling with a geometry string. Note you may need to add -quotes to avoid special shell interpretation of the `;' in the +specify its scaling with a geometry string. Note you may need to +add quotes to avoid special shell interpretation of the ; in the command-line; resource backgroundPixmap.

@@ -460,10 +460,25 @@
-imlocale string
-The locale to use for opening the IM. You can use an LC_CTYPE of e.g. -de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the input -extension to be able to input japanese characters while staying in -another locale. +The locale to use for opening the IM. You can use an LC_CTYPE of e.g. +de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the +input extension to be able to input japanese characters while staying in +another locale. resource imLocale. +
+

+
-imfont fontset
+
+
+Set the font set to use for the X Input Method, see resource imFont +for more info. +
+

+
-tcw
+
+
+Change the meaning of triple-click selection with the left mouse +button. Instead of selecting a full line it will extend the selection the +end of the logical line only. resource tripleclickwords.

-insecure
@@ -578,7 +593,7 @@
Use the specified colour to display bold or italic characters when the foreground colour is the default. If font styles are not available -(Compile styles) and this option is unset, reverse video is used instead. +(Compile styles) and this option is unset, reverse video is used instead.

colorUL: colour
@@ -721,7 +736,7 @@

Each font can either be a standard X11 core font (XLFD) name, with -optional prefix x: or a Xft font (Compile xft), prefixed with xft:.

+optional prefix x: or a Xft font (Compile xft), prefixed with xft:.

In addition, each font can be prefixed with additional hints and @@ -1048,12 +1063,31 @@

imLocale: name
-The locale to use for opening the IM. You can use an LC_CTYPE of e.g. -de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the input -extension to be able to input japanese characters while staying in +The locale to use for opening the IM. You can use an LC_CTYPE of e.g. +de_DE.UTF-8 for normal text processing but ja_JP.EUC-JP for the +input extension to be able to input japanese characters while staying in another locale. option -imlocale.

+
imFont: fontset
+
+
+Specify the font-set used for XIM styles OverTheSpot or +OffTheSpot. It must be a standard X font set (XLFD patterns separated +by commas), i.e. it's not in the same format as the other font lists used +in rxvt. The default will be set-up to chose *any* suitable found +found, preferably one or two pixels differing in size to the base font. +option -imfont. +
+

+
tripleclickwords: boolean
+
+
+Change the meaning of triple-click selection with the left mouse +button. Instead of selecting a full line it will extend the selection to +the end of the logical line only. option -tcw. +
+

insecure: boolean
@@ -1103,14 +1137,80 @@
keysym.sym: string
-Associate string with keysym sym (0xFF00 - 0xFFFF). It may -contain escape values (\a: bell, \b: backspace, \e, \E: escape, \n: -newline, \r: return, \t: -tab, \000: octal number) or control characters (^?: delete, ^@: null, -^A ...) and may enclosed with double quotes so that it can start or end -with whitespace. The intervening resource name keysym. cannot be -omitted. This resource is only available when compiled with -KEYSYM_RESOURCE. +Compile frills: Associate string with keysym sym. The +intervening resource name keysym. cannot be omitted. +
+
+

The format of sym is ``(modifiers-)key'', where modifiers can be +any combination of ISOLevel3, AppKeypad, Control, NumLock, +Shift, Meta, Lock, Mod1, Mod2, Mod3, Mod4, Mod5, +and the abbreviated I, K, C, N, S, M, A, L, 1, +2, 3, 4, 5.

+
+
+

The NumLock, Meta and ISOLevel3 modifiers are usually aliased to +whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr +keys are being mapped. AppKeypad is a synthetic modifier mapped to the +current application keymap mode state.

+
+
+

The spellings of key can be obtained by using xev(1) command or +searching keysym macros from /usr/X11R6/include/X11/keysymdef.h and +omitting the prefix XK_. Alternatively you can specify key by its hex +keysym value (0x0000 - 0xFFFF). Note that the lookup of syms is not +performed in an exact manner; however, the closest match is assured.

+
+
+

string may contain escape values (\a: bell, \b: backspace, +\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.

+
+
+

You can define a range of keysyms in one shot by providing a string +with pattern list/PREFIX/MIDDLE/SUFFIX, where the delimeter `/' +should be a character not used by the strings.

+
+
+

Its usage can be demonstrated by an example:

+
+
+
+  URxvt.keysym.M-C-0x61:    list|\e<M-C-|abc|>
+
+
+

The above line is equivalent to the following three lines:

+
+
+
+  URxvt.keysym.Meta-Control-0x61:    \e<M-C-a>
+  URxvt.keysym.Meta-Control-0x62:    \e<M-C-b>
+  URxvt.keysym.Meta-Control-0x63:    \e<M-C-c>
+
+
+

If string takes the form of proto:STRING, the specified STRING +is interpreted and executed as rxvt's control sequence. For +example the following means ``change the current locale to zh_CN.GBK +when Control-Meta-c is being pressed'':

+
+
+
+  URxvt.keysym.M-C-c: proto:\033]701;zh_CN.GBK\007
+
+
+

The following example will map Control-Meta-1 and Control-Meta-2 to +the fonts suxuseuro and 9x15bold, so you cna have some limited +font-switching at runtime:

+
+
+
+  URxvt.keysym.M-C-1: proto:\033]50;suxuseuro\007
+  URxvt.keysym.M-C-2: proto:\033]50;9x15bold\007
+
+
+

proto:\033]701;zh_CN.GBK\007 means: change the current locale to +zh_CN.GBK.

@@ -1148,14 +1248,15 @@

Selection:
-Left click at the beginning of the region, drag to the end of the -region and release; Right click to extend the marked region; Left -double-click to select a word; Left triple-click to select the entire -line. +Left click at the beginning of the region, drag to the end of the region +and release; Right click to extend the marked region; Left double-click +to select a word; Left triple-click to select the entire logical line +(which can span multiple screen lines), unless modified by resource +tripleclickwords.

Starting a selection while pressing the Meta key (or Meta+Ctrl keys) -(Compile: frills) will create a rectangular selection instead of a normal +(Compile: frills) will create a rectangular selection instead of a normal one.

@@ -1187,8 +1288,8 @@ first part is available rxvt-unicode has been compiled with --enable-frills, the rest is available when rxvt-unicode was compiled with --enable-iso14755.

-
    -
  1. 1: Basic method
    +
+

With respect to conformance, rxvt-unicode is supposed to be compliant to both scenario A and B of ISO 14755, including part 5.2.


LOGIN STAMP

-

rxvt tries to write an entry into the utmp(5) file so -that it can be seen via the who(1) command, and can accept messages. -To allow this feature, rxvt must be installed setuid root on -some systems.

+

rxvt tries to write an entry into the utmp(5) file so that +it can be seen via the who(1) command, and can accept messages. To +allow this feature, rxvt may need to be installed setuid root +on some systems or setgid to root or to some other group on others.


@@ -1301,12 +1402,6 @@

FILES

-
/etc/utmp
-
-
-System file for login records. -
-

/usr/lib/X11/rgb.txt