--- rxvt-unicode/doc/rxvt.1.pod 2004/09/08 17:10:23 1.30 +++ rxvt-unicode/doc/rxvt.1.pod 2005/01/16 19:22:16 1.43 @@ -112,7 +112,7 @@ =item B<-fade> I -Fade the text by the given percentage when focus is lost. +Fade the text by the given percentage when focus is lost. resource B. =item B<-tint> I @@ -125,7 +125,7 @@ I Darken (0 .. 100) or lighten (-1 .. -100) the transparent background image in addition to tinting it (i.e. B<-tint> must be -specified, too). +specified, too, e.g. C<-tint white>). =item B<-bg> I @@ -138,8 +138,8 @@ =item B<-pixmap> I Compile I: 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 C<;> in the command-line; resource B. =item B<-cr> I @@ -164,8 +164,15 @@ Select the fonts to be used. This is a comma separated list of font names that are used in turn when trying to display Unicode characters. The first font defines the cell size for characters; other fonts might be -smaller, but not (in general) larger. A reasonable default font list is -always appended to it. See resource B for details. +smaller, but not (in general) larger. A (hopefully) reasonable default +font list is always appended to it. See resource B for more details. + +In short, to specify an X11 core font, just specify it's name or prefix it +with C. To specify an XFT-font, you need to prefix it with C, +e.g.: + + @@RXVT_NAME@@ -fn "xft:Bitstream Vera Sans Mono:pixelsize=15" + @@RXVT_NAME@@ -fn "9x15bold,xft:Bitstream Vera Sans Mono" See also the question "How does rxvt-unicode choose fonts?" in the FAQ section of @@RXVT_NAME@@(7). @@ -234,6 +241,14 @@ Display normal (non XTerm/NeXT) scrollbar without/with a trough; resource B. +=item B<-ptab>|B<+ptab> + +If enabled (default), "Horizontal Tab" characters are being stored as +actual wide characters in the screen buffer, which makes it possible to +select and paste them. Since a horizontal tab is a cursor movement and +not an actual glyph, this can sometimes be visually annoying as the cursor +on a tab character is displayed as a wide cursor; resource B. + =item B<-bc>|B<+bc> Blink the cursor; resource B. @@ -267,8 +282,9 @@ =item B<-lsp> I -Compile I: Lines (pixel height) to insert between each row -of the display; resource B. +Compile I: Lines (pixel height) to insert between each row of +the display. Useful to work around font rendering problems; resource +B. =item B<-tn> I @@ -414,7 +430,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 I) and this option is unset, reverse video is used instead. =item B I @@ -426,6 +442,11 @@ Use the specified colour as the background for reverse video characters. +=item B I + +If set, use the specified colour as the colour for the underline +itself. If unset, use the foreground colour. + =item B I Use the specified colour for the cursor. The default is to use the @@ -468,10 +489,6 @@ Darken (0 .. 100) or lighten (-1 .. -100) the transparent background image in addition to tinting it. -=item B I - -Scale the tint colour by the given percentage. - =item B I Use the specified colour for the scrollbar [default #B2B2B2]. @@ -519,7 +536,7 @@ appended to it. option B<-fn>. Each font can either be a standard X11 core font (XLFD) name, with -optional prefix C or a Xft font (Compile xft), prefixed with C. +optional prefix C or a Xft font (Compile I), prefixed with C. In addition, each font can be prefixed with additional hints and specifications enclosed in square brackets (C<[]>). The only available @@ -539,7 +556,7 @@ it is named first) and thus defines the character cell grid to be 9 pixels wide and 15 pixels high. -the second font is just used to add additional unicode characters not in +The second font is just used to add additional unicode characters not in the base font, likewise the third, which is unfortunately non-bold, but the bold version of the font does contain less characters, so this is a useful supplement. @@ -702,6 +719,11 @@ B: the mouse wheel scrolls a page full. B: the mouse wheel scrolls five lines [default]. +=item B I + +B: store tabs as wide characters. B: interpret tabs as cursor +movement only; option C<-ptab>. + =item B I B: blink the cursor. B: do not blink the cursor [default]; @@ -798,14 +820,50 @@ =item BI: I -Associate I with keysym I (B<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 B cannot be -omitted. This resource is only available when compiled with -KEYSYM_RESOURCE. +Compile I: Associate I with keysym I. The +intervening resource name B cannot be omitted. + +The format of I is "I<(modifiers-)key>", where I can be +any combination of B, B, B, B, +B, B, B, B, B, B, B, B, +and the abbreviated B, B, B, B, B, B, B, B, B<1>, +B<2>, B<3>, B<4>, B<5>. + +The B, B and B modifiers are usually aliased to +whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr +keys are being mapped. B is a artificial modifier mapped to the +current application keymap mode state. + +The spellings of I can be obtained by using B(1) command or +searching keysym macros from B and +omitting the prefix B. Alternatively you can specify I by its hex +keysym value (B<0x0000 - 0xFFFF>). Note that the lookup of Is is not +performed in an exact manner; however, the closest match is assured. + +I may contain escape values (C<\a>: bell, C<\b>: backspace, +C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab, +C<\000>: octal number) or verbatim control characters (C<^?>: delete, +C<^@>: null, C<^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 I +with pattern B, 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 + +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 I takes the form of C, the specified B is +interpreted and executed as @@RXVT_NAME@@'s control sequence. For example, +C means: change the current locale to +C. =back @@ -849,7 +907,7 @@ line. Starting a selection while pressing the B key (or B keys) -(Compile: frills) will create a rectangular selection instead of a normal +(Compile: I) will create a rectangular selection instead of a normal one. =item B: