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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.62 by root, Sun Apr 17 22:36:13 2005 UTC vs.
Revision 1.72 by root, Wed Dec 7 20:55:52 2005 UTC

… …
105 105
106=item B<-j>|B<+j> 106=item B<-j>|B<+j>
107 107
108Turn on/off jump scrolling; resource B<jumpScroll>. 108Turn on/off jump scrolling; resource B<jumpScroll>.
109 109
110=item B<-ip>|B<+ip> 110=item B<-ip>|B<+ip> | B<-tr>|B<+tr>
111 111
112Turn on/off inheriting parent window's pixmap. Alternative form is 112Turn on/off inheriting parent window's pixmap. Alternative form is
113B<-tr>; resource B<inheritPixmap>. 113B<-tr>; resource B<inheritPixmap>.
114 114
115=item B<-fade> I<number> 115=item B<-fade> I<number>
116 116
117Fade the text by the given percentage when focus is lost. resource B<fading>. 117Fade the text by the given percentage when focus is lost. Small values
118fade a little only, 100 completely replaces all colours by the fade
119colour; resource B<fading>.
120
121=item B<-fadecolor> I<colour>
122
123Fade to this colour when fading is used (see B<-fade>). The default colour
124is black. resource B<fadeColor>.
118 125
119=item B<-tint> I<colour> 126=item B<-tint> I<colour>
120 127
121Tint the transparent background pixmap with the given colour when 128Tint the transparent background pixmap with the given colour when
122transparency is enabled with B<-tr> or B<-ip>. See also the B<-sh> 129transparency is enabled with B<-tr> or B<-ip>. This only works for
123option that can be used to brighten or darken the image in addition to 130non-tiled backgrounds, currently. See also the B<-sh> option that can be
124tinting it. 131used to brighten or darken the image in addition to tinting it; resource
132I<tintColor>. Example:
133
134 @@RXVT_NAME@@ -tr -tint blue -sh 40
125 135
126=item B<-sh> 136=item B<-sh>
127 137
128I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent 138I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent
129background image in addition to tinting it (i.e. B<-tint> must be 139background image in addition to tinting it (i.e. B<-tint> must be
… …
238 248
239Put scrollbar on right/left; resource B<scrollBar_right>. 249Put scrollbar on right/left; resource B<scrollBar_right>.
240 250
241=item B<-st>|B<+st> 251=item B<-st>|B<+st>
242 252
243Display normal (non XTerm/NeXT) scrollbar without/with a trough; 253Display rxvt (non XTerm/NeXT) scrollbar without/with a trough;
244resource B<scrollBar_floating>. 254resource B<scrollBar_floating>.
245 255
246=item B<-ptab>|B<+ptab> 256=item B<-ptab>|B<+ptab>
247 257
248If enabled (default), "Horizontal Tab" characters are being stored as 258If enabled (default), "Horizontal Tab" characters are being stored as
… …
548artificial transparency. B<False>: do not inherit the parent windows' 558artificial transparency. B<False>: do not inherit the parent windows'
549pixmap. 559pixmap.
550 560
551=item B<fading:> I<number> 561=item B<fading:> I<number>
552 562
553Fade the text by the given percentage when focus is lost. 563Fade the text by the given percentage when focus is lost; option B<-fade>.
564
565=item B<fadeColor:> I<colour>
566
567Fade to this colour, when fading is used (see B<fading:>). The default
568colour is black; option B<-fadecolor>.
554 569
555=item B<tintColor:> I<colour> 570=item B<tintColor:> I<colour>
556 571
557Tint the transparent background pixmap with the given colour. 572Tint the transparent background pixmap with the given colour; option
573B<-tint>.
558 574
559=item B<shading:> I<number> 575=item B<shading:> I<number>
560 576
561Darken (0 .. 100) or lighten (-1 .. -100) the transparent background 577Darken (0 .. 100) or lighten (-1 .. -100) the transparent background
562image in addition to tinting it. 578image in addition to tinting it.
… …
566Use the specified colour for the scrollbar [default #B2B2B2]. 582Use the specified colour for the scrollbar [default #B2B2B2].
567 583
568=item B<troughColor:> I<colour> 584=item B<troughColor:> I<colour>
569 585
570Use the specified colour for the scrollbar's trough area [default 586Use the specified colour for the scrollbar's trough area [default
571#969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. 587#969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar.
572 588
573=item B<borderColor:> I<colour> 589=item B<borderColor:> I<colour>
574 590
575The colour of the border around the text area and between the scrollbar 591The colour of the border around the text area and between the scrollbar
576and the text. 592and the text.
… …
668xterm style selection. 684xterm style selection.
669 685
670=item B<scrollstyle:> I<mode> 686=item B<scrollstyle:> I<mode>
671 687
672Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is 688Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
673the author's favourite.. 689the author's favourite.
674 690
675=item B<title:> I<string> 691=item B<title:> I<string>
676 692
677Set window title string, the default title is the command-line 693Set window title string, the default title is the command-line
678specified after the B<-e> option, if any, otherwise the application 694specified after the B<-e> option, if any, otherwise the application
… …
709=item B<print-pipe:> I<string> 725=item B<print-pipe:> I<string>
710 726
711Specify a command pipe for vt100 printer [default I<lpr(1)>]. Use 727Specify a command pipe for vt100 printer [default I<lpr(1)>]. Use
712B<Print> to initiate a screen dump to the printer and B<Ctrl-Print> or 728B<Print> to initiate a screen dump to the printer and B<Ctrl-Print> or
713B<Shift-Print> to include the scrollback as well. 729B<Shift-Print> to include the scrollback as well.
730
731The string will be interpreted as if typed into the shell as-is.
732
733Example:
734
735 URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)
736
737This creates a new file in your home directory with the screen contents
738everytime you hit C<Print>.
714 739
715=item B<scrollBar:> I<boolean> 740=item B<scrollBar:> I<boolean>
716 741
717B<True>: enable the scrollbar [default]; option B<-sb>. B<False>: 742B<True>: enable the scrollbar [default]; option B<-sb>. B<False>:
718disable the scrollbar; option B<+sb>. 743disable the scrollbar; option B<+sb>.
… …
958example the following means "change the current locale to C<zh_CN.GBK> 983example the following means "change the current locale to C<zh_CN.GBK>
959when Control-Meta-c is being pressed": 984when Control-Meta-c is being pressed":
960 985
961 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 986 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
962 987
988Due the the large number of modifier combinations, a defined key mapping
989will match if at I<at least> the specified identifiers are being set, and
990no other key mappings with those and more bits are being defined. That
991means that defining a key map for C<a> will automatically provide
992definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined
993mappings themselves.
994
995Unfortunately, this will override built-in key mappings. For example
996if you overwrite the C<Insert> key you will disable @@RXVT_NAME@@'s
997C<Shift-Insert> mapping. To re-enable that, you can poke "holes" into the
998user-defined keymap using the C<builtin:> replacement:
999
1000 URxvt.keysym.Insert: <my insert key sequence>
1001 URxvt.keysym.S-Insert: builtin:
1002
1003The first line defines a mapping for C<Insert> and I<any> combination
1004of modifiers. The second line re-establishes the default mapping for
1005C<Shift-Insert>.
1006
963The following example will map Control-Meta-1 and Control-Meta-2 to 1007The following example will map Control-Meta-1 and Control-Meta-2 to
964the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited 1008the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited
965font-switching at runtime: 1009font-switching at runtime:
966 1010
967 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007 1011 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007
… …
1033supported in rxvt-unicode. Bug me if you need this. 1077supported in rxvt-unicode. Bug me if you need this.
1034 1078
1035You can, however, switch fonts at runtime using escape sequences (and 1079You can, however, switch fonts at runtime using escape sequences (and
1036therefore using the menubar), e.g.: 1080therefore using the menubar), e.g.:
1037 1081
1038 printf '\e]701;%s\007' "9x15bold,xft:Kochi Gothic" 1082 printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"
1039 1083
1040rxvt-unicode will automatically re-apply these fonts to the output so far. 1084rxvt-unicode will automatically re-apply these fonts to the output so far.
1041 1085
1042=head1 ISO 14755 SUPPORT 1086=head1 ISO 14755 SUPPORT
1043 1087
… …
1219=item B<RXVT_SOCKET> 1263=item B<RXVT_SOCKET>
1220 1264
1221The unix domain socket path used by @@RXVT_NAME@@c(1) and 1265The unix domain socket path used by @@RXVT_NAME@@c(1) and
1222@@RXVT_NAME@@d(1). 1266@@RXVT_NAME@@d(1).
1223 1267
1224Default C<< $HOME/.rxvt-unicode-<nodename >>. 1268Default F<<< $HOME/.rxvt-unicode-I<< <nodename >> >>>.
1225 1269
1226=item B<HOME> 1270=item B<HOME>
1227 1271
1228Used to locate the default directory for the unix domain socket for 1272Used to locate the default directory for the unix domain socket for
1229daemon communications and to locate various resource files (such as 1273daemon communications and to locate various resource files (such as
… …
1250 1294
1251=back 1295=back
1252 1296
1253=head1 SEE ALSO 1297=head1 SEE ALSO
1254 1298
1255@@RXVT_NAME@@(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) 1299@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
1256
1257=head1 BUGS
1258
1259Check the BUGS file for an up-to-date list.
1260
1261Cursor change support is not yet implemented.
1262
1263Click-and-drag doesn't work with X11 mouse report overriding.
1264 1300
1265=head1 CURRENT PROJECT COORDINATOR 1301=head1 CURRENT PROJECT COORDINATOR
1266 1302
1267=over 4 1303=over 4
1268 1304

Diff Legend

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