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

Comparing rxvt-unicode/doc/rxvtperl.3.txt (file contents):
Revision 1.33 by root, Fri Jan 20 22:49:34 2006 UTC vs.
Revision 1.34 by root, Sat Jan 21 19:50:53 2006 UTC

112 "End" jumps to the bottom. "Escape" leaves search mode and returns 112 "End" jumps to the bottom. "Escape" leaves search mode and returns
113 to the point where search was started, while "Enter" or "Return" 113 to the point where search was started, while "Enter" or "Return"
114 stay at the current position and additionally stores the first match 114 stay at the current position and additionally stores the first match
115 in the current line into the primary selection. 115 in the current line into the primary selection.
116 116
117 selection-autotransform 117 readline (enabled by default)
118 This selection allows you to do automatic transforms on a selection
119 whenever a selection is made.
120
121 It works by specifying perl snippets (most useful is a single "s///"
122 operator) that modify $_ as resources:
123
124 URxvt.selection-autotransform.0: transform
125 URxvt.selection-autotransform.1: transform
126 ...
127
128 For example, the following will transform selections of the form
129 "filename:number", often seen in compiler messages, into "vi
130 +$filename $word":
131
132 URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\\d+):?$/vi +$2 \\Q$1\\E\\x0d/
133
134 And this example matches the same,but replaces it with vi-commands
135 you can paste directly into your (vi :) editor:
136
137 URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/
138
139 Of course, this can be modified to suit your needs and your editor
140 :)
141
142 To expand the example above to typical perl error messages ("XXX at
143 FILENAME line YYY."), you need a slightly more elaborate solution:
144
145 URxvt.selection.pattern-0: ( at .*? line \\d+[,.])
146 URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)[,.]$/:e \\Q$1\E\\x0d:$2\\x0d/
147
148 The first line tells the selection code to treat the unchanging part
149 of every error message as a selection pattern, and the second line
150 transforms the message into vi commands to load the file.
151
152 readline
153 A support package that tries to make editing with readline easier. 118 A support package that tries to make editing with readline easier.
154 At the moment, it reacts to clicking with the left mouse button by 119 At the moment, it reacts to clicking with the left mouse button by
155 trying to move the text cursor to this position. It does so by 120 trying to move the text cursor to this position. It does so by
156 generating as many cursor-left or cursor-right keypresses as 121 generating as many cursor-left or cursor-right keypresses as
157 required (the this only works for programs that correctly support 122 required (the this only works for programs that correctly support
158 wide characters). 123 wide characters).
159 124
160 It only works when clicking into the same line (possibly extended 125 To avoid too many false positives, this is only done when:
161 over multiple rows) as the text cursor and on the primary screen, to 126
162 reduce the risk of misinterpreting. The normal selection isn't 127 - the mouse is on the same (multi-row-) line as the text cursor.
163 disabled, so quick successive clicks might interfere with selection 128 - the primary screen is currently being displayed.
164 creation in harmless ways. 129 - the text cursor is visible.
130
131 The normal selection mechanism isn't disabled, so quick successive
132 clicks might interfere with selection creation in harmless ways.
133
134 selection-autotransform
135 This selection allows you to do automatic transforms on a selection
136 whenever a selection is made.
137
138 It works by specifying perl snippets (most useful is a single "s///"
139 operator) that modify $_ as resources:
140
141 URxvt.selection-autotransform.0: transform
142 URxvt.selection-autotransform.1: transform
143 ...
144
145 For example, the following will transform selections of the form
146 "filename:number", often seen in compiler messages, into "vi
147 +$filename $word":
148
149 URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\\d+):?$/vi +$2 \\Q$1\\E\\x0d/
150
151 And this example matches the same,but replaces it with vi-commands
152 you can paste directly into your (vi :) editor:
153
154 URxvt.selection-autotransform.0: s/^([^:[:space:]]+(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/
155
156 Of course, this can be modified to suit your needs and your editor
157 :)
158
159 To expand the example above to typical perl error messages ("XXX at
160 FILENAME line YYY."), you need a slightly more elaborate solution:
161
162 URxvt.selection.pattern-0: ( at .*? line \\d+[,.])
163 URxvt.selection-autotransform.0: s/^ at (.*?) line (\\d+)[,.]$/:e \\Q$1\E\\x0d:$2\\x0d/
164
165 The first line tells the selection code to treat the unchanging part
166 of every error message as a selection pattern, and the second line
167 transforms the message into vi commands to load the file.
165 168
166 tabbed 169 tabbed
167 This transforms the terminal into a tabbar with additional 170 This transforms the terminal into a tabbar with additional
168 terminals, that is, it implements what is commonly refered to as 171 terminals, that is, it implements what is commonly refered to as
169 "tabbed terminal". The topmost line displays a "[NEW]" button, 172 "tabbed terminal". The topmost line displays a "[NEW]" button,
840 applicable. 843 applicable.
841 844
842 $screen = $term->current_screen 845 $screen = $term->current_screen
843 Returns the currently displayed screen (0 primary, 1 secondary). 846 Returns the currently displayed screen (0 primary, 1 secondary).
844 847
848 $cursor_is_hidden = $term->hidden_cursor
849 Returns wether the cursor is currently hidden or not.
850
845 $view_start = $term->view_start ([$newvalue]) 851 $view_start = $term->view_start ([$newvalue])
846 Returns the row number of the topmost displayed line. Maximum value 852 Returns the row number of the topmost displayed line. Maximum value
847 is 0, which displays the normal terminal contents. Lower values 853 is 0, which displays the normal terminal contents. Lower values
848 scroll this many lines into the scrollback buffer. 854 scroll this many lines into the scrollback buffer.
849 855

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines