From: root Date: Mon, 17 Jan 2005 01:44:51 +0000 (+0000) Subject: *** empty log message *** X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=c144d04793b69ff0b07ff6f07bdb03065b49528d;p=dana%2Furxvt.git *** empty log message *** --- diff --git a/README.configure b/README.configure index 39c1b635..3957e37e 100644 --- a/README.configure +++ b/README.configure @@ -228,13 +228,13 @@ CONFIGURE OPTIONS Add support to have the pointer disappear when typing or inactive. --with-name=NAME - Set the basename for the installed binaries (default: urxvt, - resulting in urxvt, urxvtd etc.). Specify --with-name=rxvt to - replace rxvt. + Set the basename for the installed binaries (default: "urxvt", + resulting in "urxvt", "urxvtd" etc.). Specify "--with-name=rxvt" to + replace with "rxvt". --with-term=NAME Change the environmental variable for the terminal to NAME (default - "rxvt") + "rxvt-unicode") --with-terminfo=PATH Change the environmental variable for the path to the terminfo tree diff --git a/doc/rxvt.1.html b/doc/rxvt.1.html index 2d9b0b83..440b974c 100644 --- a/doc/rxvt.1.html +++ b/doc/rxvt.1.html @@ -196,8 +196,8 @@ Window foreground colour; resource foreground.
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.

@@ -578,7 +578,7 @@ changed using an escape command (see rxvt(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 +721,7 @@ appended to it. option -fn.

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 @@ -1103,52 +1103,62 @@ instead scroll the screen up.

keysym.sym: string
-Associate string with keysym sym. 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 ``(mask-)key'', -where mask can be any combination of Control, NumLock, -Shift, Meta, Lock, Mod1, Mod2, Mod3, Mod4, -Mod5, and the abbreviated -C, N, S, M, A, L, 1, 2, 3, 4, 5. -The spellings of key can be obtained by using xev(1) -command or searching keysym macros from -/usr/X11R6/include/X11/keysymdef.h and omit 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.

+

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.

-

string 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 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 artificial 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/STRING1/STRING2/STRING3, where the delimeter `/' -should be a character not used by the STRINGs.

+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:

-

Its usage can be demonstrated by an example: - URxvt.keysym.M-C-0x61: list.abc.\e<M-C-.>

+
+  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>

+

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, ``proto:\033]701;zh_CN.GBK\007'' -means changing the current locale to zh_CN.GBK.

+

If string takes the form of proto:STRING, the specified STRING is +interpreted and executed as rxvt's control sequence. For example, +proto:\033]701;zh_CN.GBK\007 means: change the current locale to +zh_CN.GBK.

@@ -1193,7 +1203,7 @@ line.

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.

diff --git a/doc/rxvt.1.man.in b/doc/rxvt.1.man.in index b58a7e5a..10c94ccc 100644 --- a/doc/rxvt.1.man.in +++ b/doc/rxvt.1.man.in @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 1" -.TH rxvt 1 "2005-01-16" "4.8" "RXVT-UNICODE" +.TH rxvt 1 "2005-01-17" "4.8" "RXVT-UNICODE" .SH "NAME" rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) .SH "SYNOPSIS" @@ -250,8 +250,8 @@ Window foreground colour; resource \fBforeground\fR. .IP "\fB\-pixmap\fR \fIfile[;geom]\fR" 4 .IX Item "-pixmap file[;geom]" Compile \fI\s-1XPM\s0\fR: Specify \s-1XPM\s0 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 \f(CW\*(C`;\*(C'\fR in the command\-line; resource \fBbackgroundPixmap\fR. .IP "\fB\-cr\fR \fIcolour\fR" 4 .IX Item "-cr colour" @@ -497,7 +497,7 @@ Colours 16\-79 form a standard 4x4x4 colour cube (the same as xterm with .PD 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 \fIstyles\fR) and this option is unset, reverse video is used instead. .IP "\fBcolorUL:\fR \fIcolour\fR" 4 .IX Item "colorUL: colour" Use the specified colour to display underlined characters when the @@ -585,7 +585,7 @@ be smaller, but not larger. A reasonable default font list is always appended to it. option \fB\-fn\fR. .Sp Each font can either be a standard X11 core font (\s-1XLFD\s0) name, with -optional prefix \f(CW\*(C`x:\*(C'\fR or a Xft font (Compile xft), prefixed with \f(CW\*(C`xft:\*(C'\fR. +optional prefix \f(CW\*(C`x:\*(C'\fR or a Xft font (Compile \fIxft\fR), prefixed with \f(CW\*(C`xft:\*(C'\fR. .Sp In addition, each font can be prefixed with additional hints and specifications enclosed in square brackets (\f(CW\*(C`[]\*(C'\fR). The only available @@ -830,46 +830,54 @@ scrollback buffer and switching to/from the secondary screen will instead scroll the screen up. .IP "\fBkeysym.\fR\fIsym\fR: \fIstring\fR" 4 .IX Item "keysym.sym: string" -Associate \fIstring\fR with keysym \fIsym\fR. The intervening resource -name \fBkeysym.\fR cannot be omitted. This resource is only available -when compiled with \s-1KEYSYM_RESOURCE\s0. +Compile \fIfrills\fR: Associate \fIstring\fR with keysym \fIsym\fR. The +intervening resource name \fBkeysym.\fR cannot be omitted. .Sp -The format of \fIsym\fR is "\fI(mask\-)key\fR", -where \fImask\fR can be any combination of \fBControl\fR, \fBNumLock\fR, -\&\fBShift\fR, \fBMeta\fR, \fBLock\fR, \fBMod1\fR, \fBMod2\fR, \fBMod3\fR, \fBMod4\fR, -\&\fBMod5\fR, and the abbreviated -\&\fBC\fR, \fBN\fR, \fBS\fR, \fBM\fR, \fBA\fR, \fBL\fR, \fB1\fR, \fB2\fR, \fB3\fR, \fB4\fR, \fB5\fR. -The spellings of \fIkey\fR can be obtained by using \fBxev\fR(1) -command or searching keysym macros from -\&\fB/usr/X11R6/include/X11/keysymdef.h\fR and omit the prefix \fB\s-1XK_\s0\fR. -Alternatively you can specify \fIkey\fR by its hex keysym value -(\fB0x0000 \- 0xFFFF\fR). -Note that the lookup of \fIsym\fRs is not performed in an exact manner; -however, the closest match is assured. +The format of \fIsym\fR is "\fI(modifiers\-)key\fR", where \fImodifiers\fR can be +any combination of \fBISOLevel3\fR, \fBAppKeypad\fR, \fBControl\fR, \fBNumLock\fR, +\&\fBShift\fR, \fBMeta\fR, \fBLock\fR, \fBMod1\fR, \fBMod2\fR, \fBMod3\fR, \fBMod4\fR, \fBMod5\fR, +and the abbreviated \fBI\fR, \fBK\fR, \fBC\fR, \fBN\fR, \fBS\fR, \fBM\fR, \fBA\fR, \fBL\fR, \fB1\fR, +\&\fB2\fR, \fB3\fR, \fB4\fR, \fB5\fR. .Sp -\&\fIstring\fR may -contain escape values (\ea: bell, \eb: backspace, \ee, \eE: escape, \en: -newline, \er: return, \et: -tab, \e000: octal number) or control characters (^?: delete, ^@: null, -^A ...) and may enclosed with double quotes so that it can start or end -with whitespace. +The \fBNumLock\fR, \fBMeta\fR and \fBISOLevel3\fR modifiers are usually aliased to +whatever modifier the NumLock key, Meta/Alt keys or \s-1ISO\s0 Level3 Shift/AltGr +keys are being mapped. \fBAppKeypad\fR is a artificial modifier mapped to the +current application keymap mode state. +.Sp +The spellings of \fIkey\fR can be obtained by using \fBxev\fR(1) command or +searching keysym macros from \fB/usr/X11R6/include/X11/keysymdef.h\fR and +omitting the prefix \fB\s-1XK_\s0\fR. Alternatively you can specify \fIkey\fR by its hex +keysym value (\fB0x0000 \- 0xFFFF\fR). Note that the lookup of \fIsym\fRs is not +performed in an exact manner; however, the closest match is assured. +.Sp +\&\fIstring\fR may contain escape values (\f(CW\*(C`\ea\*(C'\fR: bell, \f(CW\*(C`\eb\*(C'\fR: backspace, +\&\f(CW\*(C`\ee\*(C'\fR, \f(CW\*(C`\eE\*(C'\fR: escape, \f(CW\*(C`\en\*(C'\fR: newline, \f(CW\*(C`\er\*(C'\fR: carriage return, \f(CW\*(C`\et\*(C'\fR: tab, +\&\f(CW\*(C`\e000\*(C'\fR: octal number) or verbatim control characters (\f(CW\*(C`^?\*(C'\fR: delete, +\&\f(CW\*(C`^@\*(C'\fR: null, \f(CW\*(C`^A\*(C'\fR ...) and may be enclosed with double quotes so that it +can start or end with whitespace. .Sp You can define a range of keysyms in one shot by providing a \fIstring\fR -with pattern \fBlist/STRING1/STRING2/STRING3\fR, where the delimeter `/' -should be a character not used by the \fB\s-1STRING\s0\fRs. +with pattern \fBlist/PREFIX/MIDDLE/SUFFIX\fR, where the delimeter `/' +should be a character not used by the strings. .Sp Its usage can be demonstrated by an example: - URxvt.keysym.M\-C\-0x61: list.abc.\ee +.Sp +.Vb 1 +\& URxvt.keysym.M-C-0x61: list|\ee +.Ve .Sp The above line is equivalent to the following three lines: - URxvt.keysym.Meta\-Control\-0x61: \ee - URxvt.keysym.Meta\-Control\-0x62: \ee - URxvt.keysym.Meta\-Control\-0x63: \ee .Sp -If \fIstring\fR takes the form of \fBproto:STRING\fR, -the specified \fB\s-1STRING\s0\fR is interpreted and executed as \fB@@RXVT_NAME@@\fR's -control sequence. For example, \fB\*(L"proto:\e033]701;zh_CN.GBK\e007\*(R"\fR -means changing the current locale to zh_CN.GBK. +.Vb 3 +\& URxvt.keysym.Meta-Control-0x61: \ee +\& URxvt.keysym.Meta-Control-0x62: \ee +\& URxvt.keysym.Meta-Control-0x63: \ee +.Ve +.Sp +If \fIstring\fR takes the form of \f(CW\*(C`proto:STRING\*(C'\fR, the specified \fB\s-1STRING\s0\fR is +interpreted and executed as @@RXVT_NAME@@'s control sequence. For example, +\&\f(CW\*(C`proto:\e033]701;zh_CN.GBK\e007\*(C'\fR means: change the current locale to +\&\f(CW\*(C`zh_CN.GBK\*(C'\fR. .SH "THE SCROLLBAR" .IX Header "THE SCROLLBAR" Lines of text that scroll off the top of the \fB@@RXVT_NAME@@\fR window @@ -905,7 +913,7 @@ double-click to select a word; Left triple-click to select the entire line. .Sp Starting a selection while pressing the \fBMeta\fR key (or \fBMeta+Ctrl\fR keys) -(Compile: frills) will create a rectangular selection instead of a normal +(Compile: \fIfrills\fR) will create a rectangular selection instead of a normal one. .IP "\fBInsertion\fR:" 4 .IX Item "Insertion:" diff --git a/doc/rxvt.1.txt b/doc/rxvt.1.txt index bf2e70c9..d82b88dc 100644 --- a/doc/rxvt.1.txt +++ b/doc/rxvt.1.txt @@ -120,7 +120,7 @@ OPTIONS -pixmap *file[;geom]* 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 `;' + need to add quotes to avoid special shell interpretation of the ";" in the command-line; resource backgroundPixmap. -cr *colour* @@ -361,7 +361,7 @@ RESOURCES (available also as long-options) colorIT: *colour* 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 + available (Compile *styles*) and this option is unset, reverse video is used instead. colorUL: *colour* @@ -451,7 +451,7 @@ RESOURCES (available also as long-options) font list is always appended to it. option -fn. Each font can either be a standard X11 core font (XLFD) name, with - optional prefix "x:" or a Xft font (Compile xft), prefixed with + optional prefix "x:" or a Xft font (Compile *xft*), prefixed with "xft:". In addition, each font can be prefixed with additional hints and @@ -692,41 +692,50 @@ RESOURCES (available also as long-options) instead scroll the screen up. keysym.*sym*: *string* - Associate *string* with keysym *sym*. The intervening resource name - keysym. cannot be omitted. This resource is only available when - compiled with KEYSYM_RESOURCE. - - The format of *sym* is "*(mask-)key*", where *mask* can be any - combination of Control, NumLock, Shift, Meta, Lock, Mod1, Mod2, - Mod3, Mod4, Mod5, and the abbreviated C, N, S, M, A, L, 1, 2, 3, 4, - 5. The spellings of *key* can be obtained by using xev(1) command or + 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 artificial + 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 - omit the prefix XK_. Alternatively you can specify *key* by its hex - keysym value (0x0000 - 0xFFFF). Note that the lookup of *sym*s is - not performed in an exact manner; however, the closest match is + omitting the prefix XK_. Alternatively you can specify *key* by its + hex keysym value (0x0000 - 0xFFFF). Note that the lookup of *sym*s + 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: 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. + *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/STRING1/STRING2/STRING3, where the - delimeter `/' should be a character not used by the STRINGs. + *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.abc.\e + Its usage can be demonstrated by an example: + + URxvt.keysym.M-C-0x61: list|\e The above line is equivalent to the following three lines: - URxvt.keysym.Meta-Control-0x61: \e - URxvt.keysym.Meta-Control-0x62: \e - URxvt.keysym.Meta-Control-0x63: \e - If *string* takes the form of proto:STRING, the specified STRING is - interpreted and executed as rxvt's control sequence. For example, - "proto:\033]701;zh_CN.GBK\007" means changing the current locale to - zh_CN.GBK. + URxvt.keysym.Meta-Control-0x61: \e + URxvt.keysym.Meta-Control-0x62: \e + URxvt.keysym.Meta-Control-0x63: \e + + If *string* takes the form of "proto:STRING", the specified STRING + is interpreted and executed as rxvt's control sequence. For example, + "proto:\033]701;zh_CN.GBK\007" means: change the current locale to + "zh_CN.GBK". THE SCROLLBAR Lines of text that scroll off the top of the rxvt window (resource: @@ -761,7 +770,7 @@ TEXT SELECTION AND INSERTION entire line. Starting a selection while pressing the Meta key (or Meta+Ctrl keys) - (Compile: frills) will create a rectangular selection instead of a + (Compile: *frills*) will create a rectangular selection instead of a normal one. Insertion: diff --git a/doc/rxvt.7.html b/doc/rxvt.7.html index 47b57aa7..4e2f8268 100644 --- a/doc/rxvt.7.html +++ b/doc/rxvt.7.html @@ -2733,15 +2733,16 @@ Add support to have the pointer disappear when typing or inactive.
--with-name=NAME
-Set the basename for the installed binaries (default: urxvt, resulting in -urxvt, urxvtd etc.). Specify --with-name=rxvt to replace rxvt. +Set the basename for the installed binaries (default: urxvt, resulting +in urxvt, urxvtd etc.). Specify --with-name=rxvt to replace with +rxvt.

--with-term=NAME
Change the environmental variable for the terminal to NAME (default -``rxvt'') +rxvt-unicode)

--with-terminfo=PATH
diff --git a/doc/rxvt.7.man.in b/doc/rxvt.7.man.in index fbbb2529..87f303f0 100644 --- a/doc/rxvt.7.man.in +++ b/doc/rxvt.7.man.in @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "rxvt 7" -.TH rxvt 7 "2005-01-16" "4.8" "RXVT-UNICODE" +.TH rxvt 7 "2005-01-17" "4.8" "RXVT-UNICODE" .SH "NAME" RXVT REFERENCE \- FAQ, command sequences and other background information .SH "FREQUENTLY ASKED QUESTIONS" @@ -2292,12 +2292,13 @@ Add support for a blinking cursor. Add support to have the pointer disappear when typing or inactive. .IP "\-\-with\-name=NAME" 4 .IX Item "--with-name=NAME" -Set the basename for the installed binaries (default: urxvt, resulting in -urxvt, urxvtd etc.). Specify \-\-with\-name=rxvt to replace rxvt. +Set the basename for the installed binaries (default: \f(CW\*(C`urxvt\*(C'\fR, resulting +in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with +\&\f(CW\*(C`rxvt\*(C'\fR. .IP "\-\-with\-term=NAME" 4 .IX Item "--with-term=NAME" Change the environmental variable for the terminal to \s-1NAME\s0 (default -\&\*(L"rxvt\*(R") +\&\f(CW\*(C`rxvt\-unicode\*(C'\fR) .IP "\-\-with\-terminfo=PATH" 4 .IX Item "--with-terminfo=PATH" Change the environmental variable for the path to the terminfo tree to diff --git a/doc/rxvt.7.txt b/doc/rxvt.7.txt index 7eff48cb..42997cb5 100644 --- a/doc/rxvt.7.txt +++ b/doc/rxvt.7.txt @@ -1770,13 +1770,13 @@ CONFIGURE OPTIONS Add support to have the pointer disappear when typing or inactive. --with-name=NAME - Set the basename for the installed binaries (default: urxvt, - resulting in urxvt, urxvtd etc.). Specify --with-name=rxvt to - replace rxvt. + Set the basename for the installed binaries (default: "urxvt", + resulting in "urxvt", "urxvtd" etc.). Specify "--with-name=rxvt" to + replace with "rxvt". --with-term=NAME Change the environmental variable for the terminal to NAME (default - "rxvt") + "rxvt-unicode") --with-terminfo=PATH Change the environmental variable for the path to the terminfo tree