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.177 by root, Sun May 23 00:48:53 2010 UTC vs.
Revision 1.239 by sf-exg, Sun Oct 12 20:51:51 2014 UTC

98is still respected. but deprecated). In the absence of this option, the 98is still respected. but deprecated). In the absence of this option, the
99display specified by the B<DISPLAY> environment variable is used. 99display specified by the B<DISPLAY> environment variable is used.
100 100
101=item B<-depth> I<bitdepth> 101=item B<-depth> I<bitdepth>
102 102
103Compile I<xft>: Attempt to find a visual with the given bit depth; 103Compile I<frills>: Attempt to find a visual with the given bit depth;
104resource B<depth>. 104resource B<depth>.
105 105
106[Please note that many X servers (and libXft) are buggy with 106[Please note that many X servers (and libXft) are buggy with
107respect to C<-depth 32> and/or alpha channels, and will cause all sorts 107respect to C<-depth 32> and/or alpha channels, and will cause all sorts
108of graphical corruption. This is harmless, but we can't do anything about 108of graphical corruption. This is harmless, but we can't do anything about
109this, so watch out] 109this, so watch out]
110 110
111=item B<-visual> I<visualID>
112
113Compile I<frills>: Use the given visual (see e.g. C<xdpyinfo> for possible
114visual ids).
115
111=item B<-geometry> I<geom> 116=item B<-geometry> I<geom>
112 117
113Window geometry (B<-g> still respected); resource B<geometry>. 118Window geometry (B<-g> still respected); resource B<geometry>.
114 119
115=item B<-rv>|B<+rv> 120=item B<-rv>|B<+rv>
121Turn on/off jump scrolling (allow multiple lines per refresh); resource B<jumpScroll>. 126Turn on/off jump scrolling (allow multiple lines per refresh); resource B<jumpScroll>.
122 127
123=item B<-ss>|B<+ss> 128=item B<-ss>|B<+ss>
124 129
125Turn on/off skip scrolling (allow multiple screens per refresh); resource B<skipScroll>. 130Turn on/off skip scrolling (allow multiple screens per refresh); resource B<skipScroll>.
126
127=item B<-tr>|B<+tr>
128
129Turn on/off illusion of a transparent window background; resource B<transparent>.
130
131B<-ip> is still accepted as an obsolete alias but will be removed in
132future versions.
133
134I<Please address all transparency related issues to Sasha Vasko at
135sasha@aftercode.net. Read the FAQ (man 7 @@RXVT_NAME@@)!>
136 131
137=item B<-fade> I<number> 132=item B<-fade> I<number>
138 133
139Fade the text by the given percentage when focus is lost. Small values 134Fade the text by the given percentage when focus is lost. Small values
140fade a little only, 100 completely replaces all colours by the fade 135fade a little only, 100 completely replaces all colours by the fade
143=item B<-fadecolor> I<colour> 138=item B<-fadecolor> I<colour>
144 139
145Fade to this colour when fading is used (see B<-fade>). The default colour 140Fade to this colour when fading is used (see B<-fade>). The default colour
146is opaque black. resource B<fadeColor>. 141is opaque black. resource B<fadeColor>.
147 142
148=item B<-tint> I<colour>
149
150Tint the transparent background pixmap with the given colour when
151transparency is enabled with B<-tr>. This only works for
152non-tiled backgrounds, currently. See also the B<-sh> option that can be
153used to brighten or darken the image in addition to tinting it.
154Please note that certain tint colours can be applied on the server-side,
155thus yielding performance gain of two orders of magnitude. These colours are:
156blue, red, green, cyan, magenta, yellow, and those close to them. Also
157pure black and pure white colours essentially mean no tinting; resource
158I<tintColor>. Example:
159
160 @@RXVT_NAME@@ -tr -tint blue -sh 40
161
162=item B<-sh> I<number>
163
164Darken (0 .. 100) or lighten (100 .. 200) the transparent
165background image in addition to (or instead of) tinting it;
166resource I<shading>.
167
168=item B<-blt> I<string>
169
170Specify background blending type. If background pixmap is specified
171at the same time as transparency - such pixmap will be blended over
172transparency image, using method specified. Supported values are :
173B<add>, B<alphablend>, B<allanon> - colour values averaging, B<colorize>,
174B<darken>, B<diff>, B<dissipate>, B<hue>, B<lighten>, B<overlay>,
175B<saturate>, B<screen>, B<sub>, B<tint>, B<value>. The default is
176alpha-blending. Compile I<afterimage>; resource I<blendType>.
177
178=item B<-blr> I<HxV>
179
180Apply Gaussian Blur with the specified radii to the transparent
181background image. If single number is specified - both vertical and
182horizontal radii are considered to be the same. Setting one of the
183radii to 1 and another to a large number creates interesting effects
184on some backgrounds. Maximum radius value is 128. Compile I<afterimage>;
185resource I<blurRadius>.
186
187=item B<-icon> I<file> 143=item B<-icon> I<file>
188 144
189Compile I<afterimage>: Use the specified image as application icon. This 145Compile I<pixbuf>: Use the specified image as application icon. This
190is used by many window managers, taskbars and pagers to represent the 146is used by many window managers, taskbars and pagers to represent the
191application window; resource I<iconFile>. 147application window; resource I<iconFile>.
192 148
193=item B<-bg> I<colour> 149=item B<-bg> I<colour>
194 150
195Window background colour; resource B<background>. 151Window background colour; resource B<background>.
196 152
197=item B<-fg> I<colour> 153=item B<-fg> I<colour>
198 154
199Window foreground colour; resource B<foreground>. 155Window foreground colour; resource B<foreground>.
200
201=item B<-pixmap> I<file[;geom[:op1][:op2][...]]>
202
203Compile I<afterimage>: Specify image file for the background and also
204optionally specify its scaling with a geometry string. Note you may need to
205add quotes to avoid special shell interpretation of the C<;> in the
206command-line; for more details see resource B<backgroundPixmap>.
207 156
208=item B<-cr> I<colour> 157=item B<-cr> I<colour>
209 158
210The cursor colour; resource B<cursorColor>. 159The cursor colour; resource B<cursorColor>.
211 160
270 219
271=item B<-ls>|B<+ls> 220=item B<-ls>|B<+ls>
272 221
273Start as a login-shell/sub-shell; resource B<loginShell>. 222Start as a login-shell/sub-shell; resource B<loginShell>.
274 223
224=item B<-mc> I<milliseconds>
225
226Specify the maximum time between multi-click selections.
227
275=item B<-ut>|B<+ut> 228=item B<-ut>|B<+ut>
276 229
277Compile I<utmp>: Inhibit/enable writing a utmp entry; resource 230Compile I<utmp>: Inhibit/enable writing a utmp entry; resource
278B<utmpInhibit>. 231B<utmpInhibit>.
279 232
357 310
358=item B<-override-redirect> 311=item B<-override-redirect>
359 312
360Compile I<frills>: Sets override-redirect on the window; resource 313Compile I<frills>: Sets override-redirect on the window; resource
361B<override-redirect>. 314B<override-redirect>.
315
316=item B<-dockapp>
317
318Sets the initial state of the window to WithdrawnState, which makes
319window managers that support this extension treat it as a dockapp.
362 320
363=item B<-sbg> 321=item B<-sbg>
364 322
365Compile I<frills>: Disable the usage of the built-in block graphics/line 323Compile I<frills>: Disable the usage of the built-in block graphics/line
366drawing characters and just rely on what the specified fonts provide. Use 324drawing characters and just rely on what the specified fonts provide. Use
571You can set and change the resources using X11 tools like B<xrdb>. Many 529You can set and change the resources using X11 tools like B<xrdb>. Many
572distribution do also load settings from the B<~/.Xresources> file when X 530distribution do also load settings from the B<~/.Xresources> file when X
573starts. @@RXVT_NAME@@ will consult the following files/resources in order, 531starts. @@RXVT_NAME@@ will consult the following files/resources in order,
574with later settings overwriting earlier ones: 532with later settings overwriting earlier ones:
575 533
576 1. system-wide app-defaults file, either locale-dependent OR global
577 2. app-defaults file in $XAPPLRESDIR 534 1. app-defaults file in $XAPPLRESDIR
535 2. $HOME/.Xdefaults
578 3. RESOURCE_MANAGER property on root-window OR $HOME/.Xdefaults 536 3. RESOURCE_MANAGER property on root-window of screen 0
579 4. SCREEN_RESOURCES for the current screen 537 4. SCREEN_RESOURCES property on root-window of the current screen
580 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename> 538 5. $XENVIRONMENT file OR $HOME/.Xdefaults-<nodename>
581 6. resources specified via -xrm on the commandline 539 6. resources specified via -xrm on the commandline
582 540
583Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two class 541Note that when reading X resources, B<@@RXVT_NAME@@> recognizes two class
584names: B<Rxvt> and B<URxvt>. The class name B<Rxvt> allows resources 542names: B<Rxvt> and B<URxvt>. The class name B<Rxvt> allows resources
700 658
701B<False>: specify that everything is to be displayed, even 659B<False>: specify that everything is to be displayed, even
702if the refresh is too fast for the human eye to read anything (or the 660if the refresh is too fast for the human eye to read anything (or the
703monitor to display anything); option B<+ss>. 661monitor to display anything); option B<+ss>.
704 662
705=item B<transparent:> I<boolean>
706
707Turn on/off illusion of a transparent window background.
708
709B<inheritPixmap> is still accepted as an obsolete alias but will be removed in
710future versions.
711
712I<Please address all transparency related issues to Sasha Vasko at
713sasha@aftercode.net. Read the FAQ (man 7 @@RXVT_NAME@@)!>
714
715=item B<fading:> I<number> 663=item B<fading:> I<number>
716 664
717Fade the text by the given percentage when focus is lost; option B<-fade>. 665Fade the text by the given percentage when focus is lost; option B<-fade>.
718 666
719=item B<fadeColor:> I<colour> 667=item B<fadeColor:> I<colour>
720 668
721Fade to this colour, when fading is used (see B<fading:>). The default 669Fade to this colour, when fading is used (see B<fading:>). The default
722colour is black; option B<-fadecolor>. 670colour is black; option B<-fadecolor>.
723 671
724=item B<tintColor:> I<colour>
725
726Tint the transparent background pixmap with the given colour; option
727B<-tint>.
728
729=item B<shading:> I<number>
730
731Darken (0 .. 100) or lighten (-1 .. -100) the transparent background image
732in addition to tinting it; option B<-sh>.
733
734=item B<blendType:> I<string>
735
736Specify background blending type; option B<-blt>.
737
738=item B<blurRadius:> I<number>
739
740Apply gaussian blur with the specified radius to the transparent
741background image; option B<-blr>.
742
743=item B<iconFile:> I<file> 672=item B<iconFile:> I<file>
744 673
745Set the application icon pixmap; option B<-icon>. 674Set the application icon pixmap; option B<-icon>.
746 675
747=item B<scrollColor:> I<colour> 676=item B<scrollColor:> I<colour>
755 684
756=item B<borderColor:> I<colour> 685=item B<borderColor:> I<colour>
757 686
758The colour of the border around the text area and between the scrollbar 687The colour of the border around the text area and between the scrollbar
759and the text. 688and the text.
760
761=item B<backgroundPixmap:> I<file[;geom[:op1][:op2][...]]>
762
763Use the specified image file for the background and also
764optionally specify its scaling with a geometry string B<WxH+X+Y>,
765(default C<0x0+50+50>) in which B<"W" / "H"> specify the
766horizontal/vertical scale (percent), and B<"X" / "Y"> locate the image
767centre (percent). A scale of 0 displays the image with tiling. A scale
768of 1 displays the image without any scaling. A scale of 2 to 9 specifies
769an integer number of images in that direction. No image will be magnified
770beyond 10 times its original size. The maximum permitted scale is 1000.
771Additional operations can be specified after colon B<:op1:op2...>.
772Supported operations are:
773
774 tile force background image to be tiled and not scaled. Equivalent to 0x0
775 propscale will scale image keeping proportions
776 auto will scale image to match window size. Equivalent to 100x100
777 hscale will scale image horizontally to the window size
778 vscale will scale image vertically to the window size
779 scale will scale image to match window size
780 root will tile image as if it was a root window background, auto-adjusting
781 whenever terminal window moves
782
783If used in conjunction with B<-tr> option, the specified pixmap will be
784blended over transparency image using either alpha-blending, or any
785other blending type, specified with B<-blt "type"> option.
786
787=item B<path:> I<path>
788
789Specify the colon-delimited search path for finding background image files.
790 689
791=item B<font:> I<fontlist> 690=item B<font:> I<fontlist>
792 691
793Select the fonts to be used. This is a comma separated list of font names 692Select the fonts to be used. This is a comma separated list of font names
794that are checked in order when trying to find glyphs for characters. The 693that are checked in order when trying to find glyphs for characters. The
891 790
892B<True>: start as a login shell by prepending a `-' to B<argv[0]> of 791B<True>: start as a login shell by prepending a `-' to B<argv[0]> of
893the shell; option B<-ls>. B<False>: start as a normal sub-shell 792the shell; option B<-ls>. B<False>: start as a normal sub-shell
894[default]; option B<+ls>. 793[default]; option B<+ls>.
895 794
795=item B<multiClickTime:> I<number>
796
797Specify the maximum time in milliseconds between multi-click select
798events. The default is 500 milliseconds; option B<-mc>.
799
896=item B<utmpInhibit:> I<boolean> 800=item B<utmpInhibit:> I<boolean>
897 801
898B<True>: inhibit writing record into the system log file B<utmp>; 802B<True>: inhibit writing record into the system log file B<utmp>;
899option B<-ut>. B<False>: write record into the system log file B<utmp> 803option B<-ut>. B<False>: write record into the system log file B<utmp>
900[default]; option B<+ut>. 804[default]; option B<+ut>.
917=item B<scrollstyle:> I<mode> 821=item B<scrollstyle:> I<mode>
918 822
919Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is 823Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is
920the author's favourite. 824the author's favourite.
921 825
826=item B<thickness:> I<number>
827
828Set the scrollbar width in pixels.
829
922=item B<scrollBar:> I<boolean> 830=item B<scrollBar:> I<boolean>
923 831
924B<True>: enable the scrollbar [default]; option B<-sb>. B<False>: 832B<True>: enable the scrollbar [default]; option B<-sb>. B<False>:
925disable the scrollbar; option B<+sb>. 833disable the scrollbar; option B<+sb>.
926 834
945B<False>: do not scroll to bottom when tty receives output; option 853B<False>: do not scroll to bottom when tty receives output; option
946B<+si>. 854B<+si>.
947 855
948=item B<scrollWithBuffer:> I<boolean> 856=item B<scrollWithBuffer:> I<boolean>
949 857
950B<True>: scroll with scrollback buffer when tty receives new lines (and 858B<True>: scroll with scrollback buffer when tty receives new lines (i.e.
951B<scrollTtyOutput> is False); option B<-sw>. B<False>: do not scroll 859try to show the same lines) and B<scrollTtyOutput> is False; option
952with scrollback buffer when tty receives new lines; option B<+sw>. 860B<-sw>. B<False>: do not scroll with scrollback buffer when tty receives
861new lines; option B<+sw>.
953 862
954=item B<scrollTtyKeypress:> I<boolean> 863=item B<scrollTtyKeypress:> I<boolean>
955 864
956B<True>: scroll to bottom when a non-special key is pressed. Special keys 865B<True>: scroll to bottom when a non-special key is pressed. Special keys
957are those which are intercepted by rxvt-unicode for special handling and 866are those which are intercepted by rxvt-unicode for special handling and
1040large number (e.g. C<987654321>) to effectively disable the timeout. 949large number (e.g. C<987654321>) to effectively disable the timeout.
1041 950
1042=item B<backspacekey:> I<string> 951=item B<backspacekey:> I<string>
1043 952
1044The string to send when the backspace key is pressed. If set to B<DEC> 953The string to send when the backspace key is pressed. If set to B<DEC>
1045or unset it will send B<Delete> (code 127) or, if shifted, B<Backspace> 954or unset it will send B<Delete> (code 127) or, with control, B<Backspace>
1046(code 8) - which can be reversed with the appropriate DEC private mode 955(code 8) - which can be reversed with the appropriate DEC private mode
1047escape sequence. 956escape sequence.
1048 957
1049=item B<deletekey:> I<string> 958=item B<deletekey:> I<string>
1050 959
1146Sets the working directory for the shell (or the command specified via 1055Sets the working directory for the shell (or the command specified via
1147B<-e>). The I<path> must be an absolute path and it must exist for 1056B<-e>). The I<path> must be an absolute path and it must exist for
1148@@RXVT_NAME@@ to start. If it isn't specified then the current working 1057@@RXVT_NAME@@ to start. If it isn't specified then the current working
1149directory will be used; option B<-cd>. 1058directory will be used; option B<-cd>.
1150 1059
1151=item B<keysym.>I<sym>: I<string> 1060=item B<keysym.>I<sym>: I<action>
1152 1061
1153Compile I<frills>: Associate I<string> with keysym I<sym>. The 1062Compile I<frills>: Associate I<action> with keysym I<sym>. The intervening
1154intervening resource name B<keysym.> cannot be omitted. 1063resource name B<keysym.> cannot be omitted.
1155 1064
1156The format of I<sym> is "I<(modifiers-)key>", where I<modifiers> can be 1065Using this resource, you can map key combinations such as
1157any combination of B<ISOLevel3>, B<AppKeypad>, B<Control>, B<NumLock>, 1066C<Ctrl-Shift-BackSpace> to various actions, such as outputting a different
1158B<Shift>, B<Meta>, B<Lock>, B<Mod1>, B<Mod2>, B<Mod3>, B<Mod4>, B<Mod5>, 1067string than would normally result from that combination, making the
1159and the abbreviated B<I>, B<K>, B<C>, B<N>, B<S>, B<M>, B<A>, B<L>, B<1>, 1068terminal scroll up or down the way you want it, or any other thing an
1160B<2>, B<3>, B<4>, B<5>. 1069extension might provide.
1070
1071The key combination that triggers the action, I<sym>, has the following format:
1072
1073 (modifiers-)key
1074
1075Where I<modifiers> can be any combination of B<ISOLevel3>, B<AppKeypad>,
1076B<Control>, B<NumLock>, B<Shift>, B<Meta>, B<Lock>, B<Mod1>, B<Mod2>,
1077B<Mod3>, B<Mod4>, B<Mod5>, and the abbreviated B<I>, B<K>, B<C>, B<N>,
1078B<S>, B<M>, B<A>, B<L>, B<1>, B<2>, B<3>, B<4>, B<5>.
1161 1079
1162The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to 1080The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to
1163whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr 1081whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr
1164keys are being mapped. B<AppKeypad> is a synthetic modifier mapped to the 1082keys are being mapped. B<AppKeypad> is a synthetic modifier mapped to the
1165current application keymap mode state. 1083current application keymap mode state.
1166 1084
1167The spellings of I<key> can be obtained by using B<xev>(1) command or 1085Due the the large number of modifier combinations, a key mapping will
1168searching keysym macros from B</usr/X11R6/include/X11/keysymdef.h> and 1086match if I<at least> the specified identifiers are being set, and no other
1087key mappings with those and more bits are being defined. That means that
1088defining a mapping for C<a> will automatically provide definitions for
1089C<Meta-a>, C<Shift-a> and so on, unless some of those are defined mappings
1090themselves. See the C<builtin:> action, below, for a way to work around
1091this when this is a problem.
1092
1093The spelling of I<key> depends on your implementation of X. An easy way to
1094find a key name is to use the B<xev>(1) command. You can find a list by
1095looking for the C<XK_> macros in the B<X11/keysymdef.h> include file (omit
1169omitting the prefix B<XK_>. Alternatively you can specify I<key> by its hex 1096the C<XK_> prefix). Alternatively you can specify I<key> by its hex keysym
1170keysym value (B<0x0000 - 0xFFFF>). Note that the lookup of I<sym>s is not 1097value (B<0x0000 - 0xFFFF>).
1171performed in an exact manner; however, the closest match is assured.
1172 1098
1173I<string> may contain escape values (C<\n>: newline, C<\000>: octal 1099As with any resource value, the I<action> string may contain backslash
1100escape sequences (C<\n>: newline, C<\\>: backslash, C<\000>: octal
1174number), see RESOURCES in C<man 7 X> for futher details. 1101number), see RESOURCES in C<man 7 X> for further details.
1175 1102
1176You can define a range of keysyms in one shot by providing a I<string> 1103An action starts with an action prefix that selects a certain type
1177with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimiter `/' 1104of action, followed by a colon. An action string without colons is
1178should be a character not used by the strings. 1105interpreted as a literal string to pass to the tty (as if it was
1106prefixed with C<string:>).
1179 1107
1180Its usage can be demonstrated by an example: 1108The following action prefixes are known - extensions can provide
1109additional prefixes:
1181 1110
1182 URxvt.keysym.M-C-0x61: list|\033<M-C-|abc|> 1111=over 4
1183 1112
1184The above line is equivalent to the following three lines: 1113=item string:STRING
1185 1114
1186 URxvt.keysym.Meta-Control-0x61: \033<M-C-a> 1115If the I<action> starts with C<string:> (or otherwise contains no colons),
1187 URxvt.keysym.Meta-Control-0x62: \033<M-C-b> 1116then the remaining C<STRING> will be passed to the program running in the
1188 URxvt.keysym.Meta-Control-0x63: \033<M-C-c> 1117terminal. For example, you could replace whatever Shift-Tab outputs by the
1118string C<echo rm -rf /> followed by a newline:
1189 1119
1120 URxvt.keysym.Shift-Tab: string:echo rm -rf /\n
1121
1122This could in theory be used to completely redefine your keymap.
1123
1124=item command:STRING
1125
1190If I<string> takes the form of C<command:STRING>, the specified B<STRING> 1126If I<action> takes the form of C<command:STRING>, the specified B<STRING>
1191is interpreted and executed as @@RXVT_NAME@@'s control sequence. For 1127is interpreted and executed as @@RXVT_NAME@@'s control sequence (basically
1128the opposite of C<string:> - instead of sending it to the program running
1129in the terminal, it will be treated as if it were program output). This is
1130most useful to feed command sequences into @@RXVT_NAME@@.
1131
1192example the following means "change the current locale to C<zh_CN.GBK> 1132For example the following means "change the current locale to C<zh_CN.GBK>
1193when Control-Meta-c is being pressed": 1133when Control-Meta-c is being pressed":
1194 1134
1195 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 1135 URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007
1196 1136
1197If I<string> takes the form C<perl:STRING>, then the specified B<STRING> 1137The following example will map Control-Meta-1 and Control-Meta-2 to
1198is passed to the C<on_user_command> perl handler. See the @@RXVT_NAME@@perl(3) 1138the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited
1199manpage. For example, the F<selection> extension (activated via 1139font-switching at runtime:
1200C<@@RXVT_NAME@@ -pe selection>) listens for C<selection:rot13> events:
1201 1140
1202 URxvt.keysym.M-C-c: perl:selection:rot13 1141 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007
1142 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007
1203 1143
1204Due the the large number of modifier combinations, a defined key mapping 1144Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more
1205will match if at I<at least> the specified identifiers are being set, and 1145info):
1206no other key mappings with those and more bits are being defined. That
1207means that defining a key map for C<a> will automatically provide
1208definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined
1209mappings themselves.
1210 1146
1211Unfortunately, this will override built-in key mappings. For example 1147 URxvt.keysym.M-C-3: command:\033[8;25;80t
1148 URxvt.keysym.M-C-4: command:\033[8;48;110t
1149
1150=item builtin:
1151
1152The builtin action is the action that @@RXVT_NAME@@ would execute if no
1153key binding existed for the key combination. The obvious use is to undo
1154the effect of existing bindings. The not so obvious use is to reinstate
1155bindings when another binding overrides too many modifiers.
1156
1212if you overwrite the C<Insert> key you will disable @@RXVT_NAME@@'s 1157For example if you overwrite the C<Insert> key you will disable
1213C<Shift-Insert> mapping. To re-enable that, you can poke "holes" into the 1158@@RXVT_NAME@@'s C<Shift-Insert> mapping. To re-enable that, you can poke
1214user-defined keymap using the C<builtin:> replacement: 1159"holes" into the user-defined keymap using the C<builtin:> replacement:
1215 1160
1216 URxvt.keysym.Insert: <my insert key sequence> 1161 URxvt.keysym.Insert: <my insert key sequence>
1217 URxvt.keysym.S-Insert: builtin: 1162 URxvt.keysym.S-Insert: builtin:
1218 1163
1219The first line defines a mapping for C<Insert> and I<any> combination 1164The first line defines a mapping for C<Insert> and I<any> combination
1220of modifiers. The second line re-establishes the default mapping for 1165of modifiers. The second line re-establishes the default mapping for
1221C<Shift-Insert>. 1166C<Shift-Insert>.
1222 1167
1223The following example will map Control-Meta-1 and Control-Meta-2 to 1168=item builtin-string:
1224the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited
1225font-switching at runtime:
1226 1169
1227 URxvt.keysym.M-C-1: command:\033]50;suxuseuro\007 1170This action is mainly useful to restore string mappings for keys that
1228 URxvt.keysym.M-C-2: command:\033]50;9x15bold\007 1171have predefined actions in @@RXVT_NAME@@. The exact semantics are a bit
1172difficult to explain - basically, this action will send the string to the
1173application that would be sent if @@RXVT_NAME@@ wouldn't have a built-in
1174action for it.
1229 1175
1230Other things are possible, e.g. resizing (see @@RXVT_NAME@@(7) for more 1176An example might make it clearer: @@RXVT_NAME@@ normally pastes the
1231info): 1177selection when you press C<Shift-Insert>. With the following bindings, it
1178would instead emit the (undocumented, but what applications running in the
1179terminal might expect) sequence C<ESC [ 2 $> instead:
1232 1180
1233 URxvt.keysym.M-C-3: command:\033[8;25;80t 1181 URxvt.keysym.S-Insert: builtin-string:
1234 URxvt.keysym.M-C-4: command:\033[8;48;110t 1182 URxvt.keysym.C-S-Insert: builtin:
1183
1184The first line disables the paste functionality for that key
1185combination, and the second reinstates the default behaviour for
1186C<Control-Shift-Insert>, which would otherwise be overridden.
1187
1188Similarly, to let applications gain access to the C<C-M-c> (copy to
1189clipboard) and C<C-M-v> (paste clipboard) key combination, you can do
1190this:
1191
1192 URxvt.keysym.C-M-c: builtin-string:
1193 URxvt.keysym.C-M-v: builtin-string:
1194
1195=item EXTENSION:STRING
1196
1197An action of this form invokes the action B<STRING>, if any, provided
1198by the @@RXVT_NAME@@perl(3) extension B<EXTENSION>. The extension will
1199be loaded automatically if necessary.
1200
1201Not all extensions define actions, but popular extensions that do
1202include the I<selection> and I<matcher> extensions (documented in their
1203own manpages, @@RXVT_NAME@@-selection(1) and @@RXVT_NAME@@-matcher(1),
1204respectively).
1205
1206From the silly examples department, this will rot13-"encrypt"
1207@@RXVT_NAME@@'s selection when Alt-Control-c is pressed on typical PC
1208keyboards:
1209
1210 URxvt.keysym.M-C-c: selection:rot13
1211
1212=item perl:STRING *DEPRECATED*
1213
1214This is a deprecated way of invoking commands provided by perl
1215extensions. It is still supported, but should not be used anymore.
1216
1217=back
1235 1218
1236=item B<perl-ext-common>: I<string> 1219=item B<perl-ext-common>: I<string>
1237 1220
1238=item B<perl-ext>: I<string> 1221=item B<perl-ext>: I<string>
1239 1222
1241use in this terminal instance; option B<-pe>. 1224use in this terminal instance; option B<-pe>.
1242 1225
1243Extension names can be prefixed with a C<-> sign to prohibit using 1226Extension names can be prefixed with a C<-> sign to prohibit using
1244them. This can be useful to selectively disable some extensions loaded 1227them. This can be useful to selectively disable some extensions loaded
1245by default, or specified via the C<perl-ext-common> resource. For 1228by default, or specified via the C<perl-ext-common> resource. For
1246example, C<default,-selection> will use all the default extension except 1229example, C<default,-selection> will use all the default extensions except
1247C<selection>. 1230C<selection>.
1248 1231
1249Extension names can also be followed by an argument in angle brackets 1232The default set includes the C<selection>, C<option-popup>,
1250(e.g. C<< searchable-scrollback<M-s> >>, which binds the hotkey for 1233C<selection-popup> and C<readline> extensions, any extensions that
1251searchable scrollback to Alt/Meta-s). Mentioning the same extension 1234define keybindings via C<BINDING> meta comments, and extensions which
1252multiple times with different arguments will pass multiple arguments to 1235are mentioned in B<keysym> resources.
1253the extension. 1236
1237Any extension such that a corresponding resource is given on the
1238command line is automatically appended to B<perl-ext>.
1254 1239
1255Each extension is looked up in the library directories, loaded if 1240Each extension is looked up in the library directories, loaded if
1256necessary, and bound to the current terminal instance. 1241necessary, and bound to the current terminal instance. When the library
1242search path contains multiple extension files of the same name, then the
1243first one found will be used.
1257 1244
1258If both of these resources are the empty string, then the perl 1245If both of these resources are the empty string, then the perl interpreter
1259interpreter will not be initialized. The idea behind two options is that 1246will not be initialized. The rationale for having two options is that
1260B<perl-ext-common> will be used for extensions that should be available to 1247B<perl-ext-common> will be used for extensions that should be available to
1261all instances, while B<perl-ext> is used for specific instances. 1248all instances, while B<perl-ext> is used for specific instances.
1262 1249
1263=item B<perl-eval>: I<string> 1250=item B<perl-eval>: I<string>
1264 1251
1266the @@RXVT_NAME@@perl(3) manpage. 1253the @@RXVT_NAME@@perl(3) manpage.
1267 1254
1268=item B<perl-lib>: I<path> 1255=item B<perl-lib>: I<path>
1269 1256
1270Colon-separated list of additional directories that hold extension 1257Colon-separated list of additional directories that hold extension
1271scripts. When looking for extensions specified by the C<perl> resource, 1258scripts. When looking for perl extensions, @@RXVT_NAME@@ will first look
1272@@RXVT_NAME@@ will first look in these directories and then in 1259in these directories, then in C<$URXVT_PERL_LIB>, F<$HOME/.urxvt/ext> and
1273F<@@RXVT_LIBDIR@@/urxvt/perl/>. 1260lastly in F<@@RXVT_LIBDIR@@/urxvt/perl/>.
1274 1261
1275See the @@RXVT_NAME@@perl(3) manpage. 1262See the @@RXVT_NAME@@perl(3) manpage.
1276 1263
1277=item B<< selection.pattern-I<idx> >>: I<perl-regex> 1264=item B<< selection.pattern-I<idx> >>: I<perl-regex>
1278 1265
1282=item B<< selection-autotransform.I<idx> >>: I<perl-transform> 1269=item B<< selection-autotransform.I<idx> >>: I<perl-transform>
1283 1270
1284Selection auto-transform patterns, see the @@RXVT_NAME@@perl(3) manpage 1271Selection auto-transform patterns, see the @@RXVT_NAME@@perl(3) manpage
1285for details. 1272for details.
1286 1273
1287=item B<searchable-scrollback:> I<keysym> 1274=item B<searchable-scrollback:> I<keysym> *DEPRECATED*
1288 1275
1289Sets the hotkey that starts the incremental scrollback buffer search 1276This resource is deprecated and will be removed. Use a B<keysym> resource
1290(default: C<M-s>). 1277instead, e.g.:
1291 1278
1279 URxvt.keysym.M-s: searchable-scrollback:start
1280
1292=item B<urlLauncher>: I<string> 1281=item B<url-launcher>: I<string>
1293 1282
1294Specifies the program to be started with a URL argument. Used by the 1283Specifies the program to be started with a URL argument. Used by the
1295C<selection-popup> and C<matcher> perl extensions. 1284C<selection-popup> and C<matcher> perl extensions.
1296 1285
1297=item B<transient-for>: I<windowid> 1286=item B<transient-for>: I<windowid>
1308Turn on/off ISO 14755 (default enabled). 1297Turn on/off ISO 14755 (default enabled).
1309 1298
1310=item B<iso14755_52:> I<boolean> 1299=item B<iso14755_52:> I<boolean>
1311 1300
1312Turn on/off ISO 14755 5.2 mode (default enabled). 1301Turn on/off ISO 14755 5.2 mode (default enabled).
1302
1303=back
1304
1305=head1 BACKGROUND IMAGE OPTIONS AND RESOURCES
1306
1307=over 4
1308
1309=item B<-pixmap> I<file[;oplist]>
1310
1311=item B<backgroundPixmap:> I<file[;oplist]>
1312
1313Compile I<pixbuf>: Use the specified image file as the window's
1314background and also optionally specify a colon separated list of
1315operations to modify it. Note that you may need to quote the C<;>
1316character when using the command line option, as C<;> is usually a
1317metacharacter in shells. Supported operations are:
1318
1319=over 4
1320
1321=item B<WxH+X+Y>
1322
1323sets scale and position. B<"W" / "H"> specify the horizontal/vertical
1324scale (percent), and B<"X" / "Y"> locate the image centre (percent). A
1325scale of 0 disables scaling.
1326
1327=item B<op=tile>
1328
1329enables tiling
1330
1331=item B<op=keep-aspect>
1332
1333maintain the image aspect ratio when scaling
1334
1335=item B<op=root-align>
1336
1337use the position of the terminal window relative to the root window as
1338the image offset, simulating a root window background
1339
1340=back
1341
1342The default scale and position setting is C<100x100+50+50>.
1343Alternatively, a predefined set of templates can be used to achieve
1344the most common setups:
1345
1346=over 4
1347
1348=item B<style=tiled>
1349
1350the image is tiled with no scaling. Equivalent to 0x0+0+0:op=tile
1351
1352=item B<style=aspect-stretched>
1353
1354the image is scaled to fill the whole window maintaining the aspect
1355ratio and centered. Equivalent to 100x100+50+50:op=keep-aspect
1356
1357=item B<style=stretched>
1358
1359the image is scaled to fill the whole window. Equivalent to 100x100
1360
1361=item B<style=centered>
1362
1363the image is centered with no scaling. Equivalent to 0x0+50+50
1364
1365=item B<style=root-tiled>
1366
1367the image is tiled with no scaling and using 'root' positioning.
1368Equivalent to 0x0:op=tile:op=root-align
1369
1370=back
1371
1372If multiple templates are specified the last one wins. Note that a
1373template overrides all the scale, position and operations settings.
1374
1375If used in conjunction with pseudo-transparency, the specified pixmap
1376will be blended over the transparent background using alpha-blending.
1377
1378=item B<-tr>|B<+tr>
1379
1380=item B<transparent:> I<boolean>
1381
1382Turn on/off pseudo-transparency by using the root pixmap as background.
1383
1384B<-ip> (B<inheritPixmap>) is still accepted as an obsolete alias but
1385will be removed in future versions.
1386
1387=item B<-tint> I<colour>
1388
1389=item B<tintColor:> I<colour>
1390
1391Tint the transparent background with the given colour. Note that a
1392black tint yields a completely black image while a white tint yields
1393the image unchanged.
1394
1395=item B<-sh> I<number>
1396
1397=item B<shading:> I<number>
1398
1399Darken (0 .. 99) or lighten (101 .. 200) the transparent background.
1400A value of 100 means no shading.
1401
1402=item B<-blr> I<HxV>
1403
1404=item B<blurRadius:> I<HxV>
1405
1406Apply gaussian blur with the specified radius to the transparent
1407background. If a single number is specified, the vertical and
1408horizontal radii are considered to be the same. Setting one of the
1409radii to 1 and the other to a large number creates interesting effects
1410on some backgrounds. The maximum radius value is 128. An horizontal or
1411vertical radius of 0 disables blurring.
1412
1413=item B<path:> I<path>
1414
1415Specify the colon-delimited search path for finding background image files.
1313 1416
1314=back 1417=back
1315 1418
1316=head1 THE SCROLLBAR 1419=head1 THE SCROLLBAR
1317 1420
1365window causes the value of the PRIMARY selection (or CLIPBOARD with the 1468window causes the value of the PRIMARY selection (or CLIPBOARD with the
1366B<Meta> modifier) to be inserted as if it had been typed on the keyboard. 1469B<Meta> modifier) to be inserted as if it had been typed on the keyboard.
1367 1470
1368Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be 1471Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be
1369inserted too. 1472inserted too.
1473
1474rxvt-unicode also provides the bindings B<Ctrl-Meta-c> and
1475<Ctrl-Meta-v> to interact with the CLIPBOARD selection. The first
1476binding causes the value of the internal selection to be copied to the
1477CLIPBOARD selection, while the second binding causes the value of the
1478CLIPBOARD selection to be inserted.
1370 1479
1371=back 1480=back
1372 1481
1373=head1 CHANGING FONTS 1482=head1 CHANGING FONTS
1374 1483
1459on some systems or setgid to root or to some other group on others. 1568on some systems or setgid to root or to some other group on others.
1460 1569
1461=head1 COLOURS AND GRAPHICS 1570=head1 COLOURS AND GRAPHICS
1462 1571
1463In addition to the default foreground and background colours, 1572In addition to the default foreground and background colours,
1464B<@@RXVT_NAME@@> can display up to 16 colours (8 ANSI colours plus 1573B<@@RXVT_NAME@@> can display up to 88/256 colours: 8 ANSI colours plus
1465high-intensity bold/blink versions of the same). Here is a list of the 1574high-intensity (potentially bold/blink) versions of the same, and 72 (or
1466colours with their names. 1575240 in 256 colour mode) colours arranged in an 4x4x4 (or 6x6x6) colour RGB
1576cube plus a 8 (24) colour greyscale ramp.
1577
1578Here is a list of the ANSI colours with their names.
1467 1579
1468=begin table 1580=begin table
1469 1581
1470 B<color0> (black) = Black 1582 B<color0> (black) = Black
1471 B<color1> (red) = Red3 1583 B<color1> (red) = Red3
1491It is also possible to specify the colour values of B<foreground>, 1603It is also possible to specify the colour values of B<foreground>,
1492B<background>, B<cursorColor>, B<cursorColor2>, B<colorBD>, B<colorUL> as 1604B<background>, B<cursorColor>, B<cursorColor2>, B<colorBD>, B<colorUL> as
1493a number 0-15, as a convenient shorthand to reference the colour name of 1605a number 0-15, as a convenient shorthand to reference the colour name of
1494color0-color15. 1606color0-color15.
1495 1607
1496In addition to the colours defined above, @@RXVT_NAME@@ offers an 1608The following text gives values for the standard 88 colour mode (and
1497additional 72 colours. The first 64 of those (with indices 16 to 79) 1609values for the 256 colour mode in parentheses).
1498consist of a 4*4*4 RGB colour cube (i.e. I<index = r * 16 + g * 4 + b +
149916>), followed by 8 additional shades of gray (with indices 80 to 87).
1500 1610
1611The RGB cube uses indices 16..79 (16..231) using the following formulas:
1612
1613 index_88 = (r * 4 + g) * 4 + b + 16 # r, g, b = 0..3
1614 index_256 = (r * 6 + g) * 6 + b + 16 # r, g, b = 0..5
1615
1616The grayscale ramp uses indices 80..87 (232..239), from 10% to 90% in 10%
1617steps (1/26 to 25/26 in 1/26 steps) - black and white are already part of
1618the RGB cube.
1619
1501Together, all those colours implement the 88 colour xterm colours. Only 1620Together, all those colours implement the 88 (256) colour xterm
1502the first 16 can be changed using resources currently, the rest can only 1621colours. Only the first 16 can be changed using resources currently, the
1503be changed via command sequences ("escape codes"). 1622rest can only be changed via command sequences ("escape codes").
1623
1624Applications are advised to use terminfo or command sequences to discover
1625number and RGB values of all colours (yes, you can query this...).
1504 1626
1505Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by 1627Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by
1506always swapping the foreground/background colours. This is in contrast to 1628always swapping the foreground/background colours. This is in contrast to
1507I<xterm>(1) where the colours are only swapped if they have not otherwise 1629I<xterm>(1) where the colours are only swapped if they have not otherwise
1508been specified. For example, 1630been specified. For example,
1513White. 1635White.
1514 1636
1515=head2 ALPHA CHANNEL SUPPORT 1637=head2 ALPHA CHANNEL SUPPORT
1516 1638
1517If Xft support has been compiled in and as long as Xft/Xrender/X don't get 1639If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1518their act together, rxvt-unicode will do it's own alpha channel management: 1640their act together, rxvt-unicode will do its own alpha channel management:
1519 1641
1520You can prefix any colour with an opaquenes percentage enclosed in 1642You can prefix any colour with an opaqueness percentage enclosed in
1521brackets, i.e. C<[percent]>, where C<percent> is a decimal percentage 1643brackets, i.e. C<[percent]>, where C<percent> is a decimal percentage
1522(0-100) that specifies the opacity of the colour, where C<0> is completely 1644(0-100) that specifies the opacity of the colour, where C<0> is completely
1523transparent and C<100> is completely opaque. For example, C<[50]red> is a 1645transparent and C<100> is completely opaque. For example, C<[50]red> is a
1524half-transparent red, while C<[95]#00ff00> is an almost opaque green. This 1646half-transparent red, while C<[95]#00ff00> is an almost opaque green. This
1525is the recommended format to specify transparency values, and works with 1647is the recommended format to specify transparency values, and works with
1605 1727
1606=item B<SHELL> 1728=item B<SHELL>
1607 1729
1608The shell to be used for command execution, defaults to C</bin/sh>. 1730The shell to be used for command execution, defaults to C</bin/sh>.
1609 1731
1610=item B<RXVT_SOCKET> 1732=item B<RXVT_SOCKET> [I<sic>]
1611 1733
1612The unix domain socket path used by @@RXVT_NAME@@c(1) and 1734The unix domain socket path used by @@RXVT_NAME@@c(1) and
1613@@RXVT_NAME@@d(1). 1735@@RXVT_NAME@@d(1).
1614 1736
1615Default F<<< $HOME/.rxvt-unicode-I<< <nodename >> >>>. 1737Default F<<< $HOME/.urxvt/urxvtd-I<< <nodename> >> >>>.
1738
1739=item B<URXVT_PERL_LIB>
1740
1741Additional F<:>-separated library search path for perl extensions. Will be
1742searched after B<-perl-lib> but before F<~/.urxvt/ext> and the system library
1743directory.
1744
1745=item B<URXVT_PERL_VERBOSITY>
1746
1747See L<@@RXVT_NAME@@perl>(3).
1616 1748
1617=item B<HOME> 1749=item B<HOME>
1618 1750
1619Used to locate the default directory for the unix domain socket for 1751Used to locate the default directory for the unix domain socket for
1620daemon communications and to locate various resource files (such as 1752daemon communications and to locate various resource files (such as
1621C<.Xdefaults>) 1753C<.Xdefaults>)
1622 1754
1623=item B<XAPPLRESDIR> 1755=item B<XAPPLRESDIR>
1624 1756
1625Directory where various X resource files are being located. 1757Directory where application-specific X resource files are located.
1626 1758
1627=item B<XENVIRONMENT> 1759=item B<XENVIRONMENT>
1628 1760
1629If set and accessible, gives the name of a X resource file to be loaded by 1761If set and accessible, gives the name of a X resource file to be loaded by
1630@@RXVT_NAME@@. 1762@@RXVT_NAME@@.
1641 1773
1642=back 1774=back
1643 1775
1644=head1 SEE ALSO 1776=head1 SEE ALSO
1645 1777
1778@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@-extensions(1),
1646@@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) 1779@@RXVT_NAME@@perl(3), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
1647 1780
1648=head1 CURRENT PROJECT COORDINATOR 1781=head1 CURRENT PROJECT COORDINATOR
1649 1782
1650=over 4 1783=over 4
1651 1784
1652=item Project Coordinator 1785=item Project Coordinator
1653 1786
1654Marc A. Lehmann L<< <rxvt-unicode@schmorp.de> >> 1787Marc A. Lehmann <rxvt-unicode@schmorp.de>.
1655 1788
1656L<http://software.schmorp.de/pkg/rxvt-unicode.html> 1789L<http://software.schmorp.de/pkg/rxvt-unicode.html>
1657 1790
1658=back 1791=back
1659 1792
1663 1796
1664=item John Bovey 1797=item John Bovey
1665 1798
1666University of Kent, 1992, wrote the original Xvt. 1799University of Kent, 1992, wrote the original Xvt.
1667 1800
1668=item Rob Nation L<< <nation@rocket.sanders.lockheed.com> >> 1801=item Rob Nation <nation@rocket.sanders.lockheed.com>
1669 1802
1670very heavily modified Xvt and came up with Rxvt 1803very heavily modified Xvt and came up with Rxvt
1671 1804
1672=item Angelo Haritsis L<< <ah@doc.ic.ac.uk> >> 1805=item Angelo Haritsis <ah@doc.ic.ac.uk>
1673 1806
1674wrote the Greek Keyboard Input (no longer in code) 1807wrote the Greek Keyboard Input (no longer in code)
1675 1808
1676=item mj olesen L<< <olesen@me.QueensU.CA> >> 1809=item mj olesen <olesen@me.QueensU.CA>
1677 1810
1678Wrote the menu system. 1811Wrote the menu system.
1679 1812
1680Project Coordinator (changes.txt 2.11 to 2.21) 1813Project Coordinator (changes.txt 2.11 to 2.21)
1681 1814
1682=item Oezguer Kesim L<< <kesim@math.fu-berlin.de> >> 1815=item Oezguer Kesim <kesim@math.fu-berlin.de>
1683 1816
1684Project Coordinator (changes.txt 2.21a to 2.4.5) 1817Project Coordinator (changes.txt 2.21a to 2.4.5)
1685 1818
1686=item Geoff Wing L<< <gcw@pobox.com> >> 1819=item Geoff Wing <gcw@pobox.com>
1687 1820
1688Rewrote screen display and text selection routines. 1821Rewrote screen display and text selection routines.
1689 1822
1690Project Coordinator (changes.txt 2.4.6 - rxvt-unicode) 1823Project Coordinator (changes.txt 2.4.6 - rxvt-unicode)
1691 1824
1692=item Marc Alexander Lehmann L<< <rxvt-unicode@schmorp.de> >> 1825=item Marc Alexander Lehmann <rxvt-unicode@schmorp.de>
1693 1826
1694Forked rxvt-unicode, unicode support, rewrote almost all the code, perl 1827Forked rxvt-unicode, unicode support, rewrote almost all the code, perl
1695extension, random hacks, numerous bugfixes and extensions. 1828extension, random hacks, numerous bugfixes and extensions.
1696 1829
1697Project Coordinator (Changes 1.0 -) 1830Project Coordinator (Changes 1.0 -)
1698 1831
1699=item Emanuele Giaquinta L<< <e.giaquinta@glauco.it> >> 1832=item Emanuele Giaquinta <emanuele.giaquinta@gmail.com>
1700 1833
1701Pty/tty/utmp/wtmp rewrite, lots of random hacking and bugfixing. 1834pty/utmp code rewrite, image code improvements, many random hacks and bugfixes.
1702 1835
1703=back 1836=back
1704 1837

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines