ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.man.in
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.1.man.in (file contents):
Revision 1.18 by root, Thu Feb 17 15:07:48 2005 UTC vs.
Revision 1.23 by root, Sat Jun 18 11:01:41 2005 UTC

… …
127.\} 127.\}
128.rm #[ #] #H #V #F C 128.rm #[ #] #H #V #F C
129.\" ======================================================================== 129.\" ========================================================================
130.\" 130.\"
131.IX Title "rxvt 1" 131.IX Title "rxvt 1"
132.TH rxvt 1 "2005-02-17" "5.2" "RXVT-UNICODE" 132.TH rxvt 1 "2005-06-18" "5.5" "RXVT-UNICODE"
133.SH "NAME" 133.SH "NAME"
134rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) 134rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
135.SH "SYNOPSIS" 135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS" 136.IX Header "SYNOPSIS"
137\&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]] 137\&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]]
… …
334.IP "\fB\-sr\fR|\fB+sr\fR" 4 334.IP "\fB\-sr\fR|\fB+sr\fR" 4
335.IX Item "-sr|+sr" 335.IX Item "-sr|+sr"
336Put scrollbar on right/left; resource \fBscrollBar_right\fR. 336Put scrollbar on right/left; resource \fBscrollBar_right\fR.
337.IP "\fB\-st\fR|\fB+st\fR" 4 337.IP "\fB\-st\fR|\fB+st\fR" 4
338.IX Item "-st|+st" 338.IX Item "-st|+st"
339Display normal (non XTerm/NeXT) scrollbar without/with a trough; 339Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
340resource \fBscrollBar_floating\fR. 340resource \fBscrollBar_floating\fR.
341.IP "\fB\-ptab\fR|\fB+ptab\fR" 4 341.IP "\fB\-ptab\fR|\fB+ptab\fR" 4
342.IX Item "-ptab|+ptab" 342.IX Item "-ptab|+ptab"
343If enabled (default), \*(L"Horizontal Tab\*(R" characters are being stored as 343If enabled (default), \*(L"Horizontal Tab\*(R" characters are being stored as
344actual wide characters in the screen buffer, which makes it possible to 344actual wide characters in the screen buffer, which makes it possible to
… …
465not. 465not.
466.Sp 466.Sp
467Here is a short Gtk2\-perl snippet that illustrates how this option can be 467Here is a short Gtk2\-perl snippet that illustrates how this option can be
468used (a longer example is in \fIdoc/embed\fR): 468used (a longer example is in \fIdoc/embed\fR):
469.Sp 469.Sp
470.Vb 4 470.Vb 5
471\& my $rxvt = new Gtk2::DrawingArea; 471\& my $rxvt = new Gtk2::Socket;
472\& $...->add ($rxvt); # important to add it somewhere first 472\& $rxvt->signal_connect_after (realize => sub {
473\& $rxvt->realize; # now it can be realized
474\& my $xid = $rxvt->window->get_xid; 473\& my $xid = $_[0]->window->get_xid;
475.Ve
476.Sp
477.Vb 1
478\& system "@@RXVT_NAME@@ -embed $xid &"; 474\& system "@@RXVT_NAME@@ -embed $xid &";
475\& });
479.Ve 476.Ve
480.IP "\fB\-pty\-fd\fR \fIfileno\fR" 4 477.IP "\fB\-pty\-fd\fR \fIfileno\fR" 4
481.IX Item "-pty-fd fileno" 478.IX Item "-pty-fd fileno"
482Tells @@RXVT_NAME@@ \s-1NOT\s0 to execute any commands or create a new pty/tty 479Tells @@RXVT_NAME@@ \s-1NOT\s0 to execute any commands or create a new pty/tty
483pair but instead use the given filehandle as the tty master. This is 480pair but instead use the given filehandle as the tty master. This is
… …
494.Vb 2 491.Vb 2
495\& use IO::Pty; 492\& use IO::Pty;
496\& use Fcntl; 493\& use Fcntl;
497.Ve 494.Ve
498.Sp 495.Sp
499.Vb 2 496.Vb 4
500\& my $pty = new IO::Pty; 497\& my $pty = new IO::Pty;
501\& fcntl $pty, F_SETFD, 0; # clear close-on-exec 498\& fcntl $pty, F_SETFD, 0; # clear close-on-exec
502.Ve
503.Sp
504.Vb 1
505\& system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&"; 499\& system "@@RXVT_NAME@@ -pty-fd " . (fileno $pty) . "&";
500\& close $pty;
506.Ve 501.Ve
507.Sp 502.Sp
508.Vb 3 503.Vb 3
509\& # now communicate with rxvt 504\& # now communicate with rxvt
510\& my $slave = $pty->slave; 505\& my $slave = $pty->slave;
… …
631.IX Item "scrollColor: colour" 626.IX Item "scrollColor: colour"
632Use the specified colour for the scrollbar [default #B2B2B2]. 627Use the specified colour for the scrollbar [default #B2B2B2].
633.IP "\fBtroughColor:\fR \fIcolour\fR" 4 628.IP "\fBtroughColor:\fR \fIcolour\fR" 4
634.IX Item "troughColor: colour" 629.IX Item "troughColor: colour"
635Use the specified colour for the scrollbar's trough area [default 630Use the specified colour for the scrollbar's trough area [default
636#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. 631#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
637.IP "\fBborderColor:\fR \fIcolour\fR" 4 632.IP "\fBborderColor:\fR \fIcolour\fR" 4
638.IX Item "borderColor: colour" 633.IX Item "borderColor: colour"
639The colour of the border around the text area and between the scrollbar 634The colour of the border around the text area and between the scrollbar
640and the text. 635and the text.
641.IP "\fBbackgroundPixmap:\fR \fIfile[;geom]\fR" 4 636.IP "\fBbackgroundPixmap:\fR \fIfile[;geom]\fR" 4
… …
729xterm style with 2.20 old word selection, or anything else which gives 724xterm style with 2.20 old word selection, or anything else which gives
730xterm style selection. 725xterm style selection.
731.IP "\fBscrollstyle:\fR \fImode\fR" 4 726.IP "\fBscrollstyle:\fR \fImode\fR" 4
732.IX Item "scrollstyle: mode" 727.IX Item "scrollstyle: mode"
733Set scrollbar style to \fBrxvt\fR, \fBplain\fR, \fBnext\fR or \fBxterm\fR. \fBplain\fR is 728Set scrollbar style to \fBrxvt\fR, \fBplain\fR, \fBnext\fR or \fBxterm\fR. \fBplain\fR is
734the author's favourite.. 729the author's favourite.
735.IP "\fBtitle:\fR \fIstring\fR" 4 730.IP "\fBtitle:\fR \fIstring\fR" 4
736.IX Item "title: string" 731.IX Item "title: string"
737Set window title string, the default title is the command-line 732Set window title string, the default title is the command-line
738specified after the \fB\-e\fR option, if any, otherwise the application 733specified after the \fB\-e\fR option, if any, otherwise the application
739name; option \fB\-title\fR. 734name; option \fB\-title\fR.
… …
848.IP "\fBpointerColor2:\fR \fIcolour\fR" 4 843.IP "\fBpointerColor2:\fR \fIcolour\fR" 4
849.IX Item "pointerColor2: colour" 844.IX Item "pointerColor2: colour"
850Mouse pointer background colour. 845Mouse pointer background colour.
851.IP "\fBpointerBlankDelay:\fR \fInumber\fR" 4 846.IP "\fBpointerBlankDelay:\fR \fInumber\fR" 4
852.IX Item "pointerBlankDelay: number" 847.IX Item "pointerBlankDelay: number"
853Specifies number of seconds before blanking the pointer [default 2]. 848Specifies number of seconds before blanking the pointer [default 2]. Use a
849large number (e.g. \f(CW987654321\fR) to effectively disable the timeout.
854.IP "\fBbackspacekey:\fR \fIstring\fR" 4 850.IP "\fBbackspacekey:\fR \fIstring\fR" 4
855.IX Item "backspacekey: string" 851.IX Item "backspacekey: string"
856The string to send when the backspace key is pressed. If set to \fB\s-1DEC\s0\fR 852The string to send when the backspace key is pressed. If set to \fB\s-1DEC\s0\fR
857or unset it will send \fBDelete\fR (code 127) or, if shifted, \fBBackspace\fR 853or unset it will send \fBDelete\fR (code 127) or, if shifted, \fBBackspace\fR
858(code 8) \- which can be reversed with the appropriate \s-1DEC\s0 private mode 854(code 8) \- which can be reversed with the appropriate \s-1DEC\s0 private mode
… …
982.Sp 978.Sp
983.Vb 1 979.Vb 1
984\& URxvt.keysym.M-C-c: command:\e033]701;zh_CN.GBK\e007 980\& URxvt.keysym.M-C-c: command:\e033]701;zh_CN.GBK\e007
985.Ve 981.Ve
986.Sp 982.Sp
983Due the the large number of modifier combinations, a defined key mapping
984will match if at \fIat least\fR the specified identifiers are being set, and
985no other key mappings with those and more bits are being defined. That
986means that defining a key map for \f(CW\*(C`a\*(C'\fR will automatically provide
987definitions for \f(CW\*(C`Meta\-a\*(C'\fR, \f(CW\*(C`Shift\-a\*(C'\fR and so on, unless some of those are defined
988mappings themselves.
989.Sp
990Unfortunately, this will override built-in key mappings. For example
991if you overwrite the \f(CW\*(C`Insert\*(C'\fR key you will disable @@RXVT_NAME@@'s
992\&\f(CW\*(C`Shift\-Insert\*(C'\fR mapping. To re-enable that, you can poke \*(L"holes\*(R" into the
993user-defined keymap using the \f(CW\*(C`builtin:\*(C'\fR replacement:
994.Sp
995.Vb 2
996\& URxvt.keysym.Insert: <my insert key sequence>
997\& URxvt.keysym.S-Insert: builtin:
998.Ve
999.Sp
1000The first line defines a mapping for \f(CW\*(C`Insert\*(C'\fR and \fIany\fR combination
1001of modifiers. The second line re-establishes the default mapping for
1002\&\f(CW\*(C`Shift\-Insert\*(C'\fR.
1003.Sp
987The following example will map Control\-Meta\-1 and Control\-Meta\-2 to 1004The following example will map Control\-Meta\-1 and Control\-Meta\-2 to
988the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can have some limited 1005the fonts \f(CW\*(C`suxuseuro\*(C'\fR and \f(CW\*(C`9x15bold\*(C'\fR, so you can have some limited
989font-switching at runtime: 1006font-switching at runtime:
990.Sp 1007.Sp
991.Vb 2 1008.Vb 2

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines