annotate runtime/doc/tips.txt @ 511:32cf0d2e14b4

updated for version 7.0143
author vimboss
date Wed, 07 Sep 2005 21:21:14 +0000
parents c8fd241d3cdd
children 9090f866cd57
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
246
c8fd241d3cdd updated for version 7.0068
vimboss
parents: 236
diff changeset
1 *tips.txt* For Vim version 7.0aa. Last change: 2005 Apr 19
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 VIM REFERENCE MANUAL by Bram Moolenaar
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 Tips and ideas for using Vim *tips*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 Don't forget to browse the user manual, it also contains lots of useful tips
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 |usr_toc.txt|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 Editing C programs |C-editing|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 Finding where identifiers are used |ident-search|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 Switching screens in an xterm |xterm-screens|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 Scrolling in Insert mode |scroll-insert|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 Smooth scrolling |scroll-smooth|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 Correcting common typing mistakes |type-mistakes|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 Counting words, lines, etc. |count-items|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 Restoring the cursor position |restore-position|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 Renaming files |rename-files|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 Speeding up external commands |speed-up|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22 Useful mappings |useful-mappings|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 Compressing the help files |gzip-helpfile|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 Hex editing |hex-editing|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 Executing shell commands in a window |shell-window|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 Using <> notation in autocommands |autocmd-<>|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 Editing C programs *C-editing*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 There are quite a few features in Vim to help you edit C program files. Here
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 is an overview with tags to jump to:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 |usr_29.txt| Moving through programs chapter in the user manual.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 |usr_30.txt| Editing programs chapter in the user manual.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 |C-indenting| Automatically set the indent of a line while typing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 text.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 |=| Re-indent a few lines.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 |format-comments| Format comments.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 |:checkpath| Show all recursively included files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 |[i| Search for identifier under cursor in current and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 included files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 |[_CTRL-I| Jump to match for "[i"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 |[I| List all lines in current and included files where
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 identifier under the cursor matches.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 |[d| Search for define under cursor in current and included
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 |CTRL-]| Jump to tag under cursor (e.g., definition of a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 function).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 |CTRL-T| Jump back to before a CTRL-] command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 |:tselect| Select one tag out of a list of matching tags.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 |gd| Go to Declaration of local variable under cursor.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 |gD| Go to Declaration of global variable under cursor.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 |gf| Go to file name under the cursor.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 |%| Go to matching (), {}, [], /* */, #if, #else, #endif.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 |[/| Go to previous start of comment.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 |]/| Go to next end of comment.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 |[#| Go back to unclosed #if, #ifdef, or #else.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 |]#| Go forward to unclosed #else or #endif.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65 |[(| Go back to unclosed '('
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66 |])| Go forward to unclosed ')'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 |[{| Go back to unclosed '{'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 |]}| Go forward to unclosed '}'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 |v_ab| Select "a block" from "[(" to "])", including braces
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 |v_ib| Select "inner block" from "[(" to "])"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72 |v_aB| Select "a block" from "[{" to "]}", including brackets
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 |v_iB| Select "inner block" from "[{" to "]}"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 Finding where identifiers are used *ident-search*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78 You probably already know that |tags| can be used to jump to the place where a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 function or variable is defined. But sometimes you wish you could jump to all
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 the places where a function or variable is being used. This is possible in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 two ways:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 1. Using the |:grep| command. This should work on most Unix systems,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 but can be slow (it reads all files) and only searches in one directory.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 2. Using ID utils. This is fast and works in multiple directories. It uses a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 database to store locations. You will need some additional programs for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86 this to work. And you need to keep the database up to date.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88 Using the GNU id-tools:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 What you need:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 - The GNU id-tools installed (mkid is needed to create ID and lid is needed to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92 use the macros).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 - An identifier database file called "ID" in the current directory. You can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94 create it with the shell command "mkid file1 file2 ..".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 Put this in your .vimrc: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
97 map _u :call ID_search()<Bar>execute "/\\<" . g:word . "\\>"<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98 map _n :n<Bar>execute "/\\<" . g:word . "\\>"<CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 function! ID_search()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 let g:word = expand("<cword>")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 let x = system("lid --key=none ". g:word)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 let x = substitute(x, "\n", " ", "g")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 execute "next " . x
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 endfun
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 To use it, place the cursor on a word, type "_u" and vim will load the file
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
108 that contains the word. Search for the next occurrence of the word in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 same file with "n". Go to the next file with "_n".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111 This has been tested with id-utils-3.2 (which is the name of the id-tools
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
112 archive file on your closest gnu-ftp-mirror).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114 [the idea for this comes from Andreas Kutschera]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 Switching screens in an xterm *xterm-screens* *xterm-save-screen*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 (From comp.editors, by Juergen Weigert, in reply to a question)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121 :> Another question is that after exiting vim, the screen is left as it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122 :> was, i.e. the contents of the file I was viewing (editing) was left on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 :> the screen. The output from my previous like "ls" were lost,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124 :> ie. no longer in the scrolling buffer. I know that there is a way to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 :> restore the screen after exiting vim or other vi like editors,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126 :> I just don't know how. Helps are appreciated. Thanks.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 :
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 :I imagine someone else can answer this. I assume though that vim and vi do
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 :the same thing as each other for a given xterm setup.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 They not necessarily do the same thing, as this may be a termcap vs.
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 170
diff changeset
132 terminfo problem. You should be aware that there are two databases for
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 describing attributes of a particular type of terminal: termcap and
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 170
diff changeset
134 terminfo. This can cause differences when the entries differ AND when of
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 the programs in question one uses terminfo and the other uses termcap
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
136 (also see |+terminfo|).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
137
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
138 In your particular problem, you are looking for the control sequences
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 170
diff changeset
139 ^[[?47h and ^[[?47l. These switch between xterms alternate and main screen
4707450c2b33 updated for version 7.0066
vimboss
parents: 170
diff changeset
140 buffer. As a quick workaround a command sequence like >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
141 echo -n "^[[?47h"; vim ... ; echo -n "^[[?47l"
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 170
diff changeset
142 may do what you want. (My notation ^[ means the ESC character, further down
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
143 you'll see that the databases use \E instead).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
144
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
145 On startup, vim echoes the value of the termcap variable ti (terminfo:
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 170
diff changeset
146 smcup) to the terminal. When exiting, it echoes te (terminfo: rmcup). Thus
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147 these two variables are the correct place where the above mentioned control
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
148 sequences should go.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
149
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150 Compare your xterm termcap entry (found in /etc/termcap) with your xterm
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 170
diff changeset
151 terminfo entry (retrieved with /usr/5bin/infocmp -C xterm). Both should
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
152 contain entries similar to: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
153 :te=\E[2J\E[?47l\E8:ti=\E7\E[?47h:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
154
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155 PS: If you find any difference, someone (your sysadmin?) should better check
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
156 the complete termcap and terminfo database for consistency.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
157
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158 NOTE 1: If you recompile Vim with FEAT_XTERM_SAVE defined in feature.h, the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159 builtin xterm will include the mentioned "te" and "ti" entries.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161 NOTE 2: If you want to disable the screen switching, and you don't want to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162 change your termcap, you can add these lines to your .vimrc: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
163 :set t_ti= t_te=
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
164
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
165 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
166 Scrolling in Insert mode *scroll-insert*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168 If you are in insert mode and you want to see something that is just off the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
169 screen, you can use CTRL-X CTRL-E and CTRL-X CTRL-Y to scroll the screen.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170 |i_CTRL-X_CTRL-E|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172 To make this easier, you could use these mappings: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
173 :inoremap <C-E> <C-X><C-E>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
174 :inoremap <C-Y> <C-X><C-Y>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
175 (Type this literally, make sure the '<' flag is not in 'cpoptions').
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
176 You then lose the ability to copy text from the line above/below the cursor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
177 |i_CTRL-E|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
178
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
179 Also consider setting 'scrolloff' to a larger value, so that you can always see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
180 some context around the cursor. If 'scrolloff' is bigger than half the window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
181 height, the cursor will always be in the middle and the text is scrolled when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
182 the cursor is moved up/down.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
183
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
185 Smooth scrolling *scroll-smooth*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 If you like the scrolling to go a bit smoother, you can use these mappings: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
188 :map <C-U> <C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y><C-Y>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
189 :map <C-D> <C-E><C-E><C-E><C-E><C-E><C-E><C-E><C-E><C-E><C-E><C-E><C-E><C-E><C-E><C-E><C-E>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
190
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
191 (Type this literally, make sure the '<' flag is not in 'cpoptions').
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
192
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
193 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
194 Correcting common typing mistakes *type-mistakes*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
195
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
196 When there are a few words that you keep on typing in the wrong way, make
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
197 abbreviations that correct them. For example: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
198 :ab teh the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
199 :ab fro for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
200
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
201 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
202 Counting words, lines, etc. *count-items*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
203
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
204 To count how often any pattern occurs in the current buffer use the substitute
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
205 command and add the 'n' flag to avoid the substitution. The reported number
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
206 of substitutions is the number of items. Examples: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
207
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
208 :%s/./&/gn characters
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
209 :%s/\i\+/&/gn words
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
210 :%s/^//n lines
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
211 :%s/the/&/gn "the" anywhere
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
212 :%s/\<the\>/&/gn "the" as a word
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
213
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
214 You might want to reset 'hlsearch' or do ":nohlsearch".
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
215 Add the 'e' flag if you don't want an error when there are no matches.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
216
170
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
217 An alternative is using |v_g_CTRL-G| in Visual mode.
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
218
8c60f65311fa updated for version 7.0052
vimboss
parents: 7
diff changeset
219 If you want to find matches in multiple files use |:vimgrep|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
220
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
221 *count-bytes*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
222 If you want to count bytes, you can use this:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
223
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
224 Visually select the characters (block is also possible)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
225 Use "y" to yank the characters
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
226 Use the strlen() function: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
227 :echo strlen(@")
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
228 A line break is counted for one byte.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
229
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
230 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
231 Restoring the cursor position *restore-position*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
232
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
233 Sometimes you want to write a mapping that makes a change somewhere in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
234 file and restores the cursor position, without scrolling the text. For
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
235 example, to change the date mark in a file: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236 :map <F2> msHmtgg/Last [cC]hange:\s*/e+1<CR>"_D"=strftime("%Y %b %d")<CR>p'tzt`s
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
237
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
238 Breaking up saving the position:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
239 ms store cursor position in the 's' mark
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
240 H go to the first line in the window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
241 mt store this position in the 't' mark
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
242
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
243 Breaking up restoring the position:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
244 't go to the line previously at the top of the window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
245 zt scroll to move this line to the top of the window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
246 `s jump to the original position of the cursor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
247
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
248 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
249 Renaming files *rename-files*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
250
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
251 Say I have a directory with the following files in them (directory picked at
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
252 random :-):
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
253
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
254 buffer.c
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
255 charset.c
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
256 digraph.c
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
257 ...
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
259 and I want to rename *.c *.bla. I'd do it like this: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
260
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
261 $ vim
246
c8fd241d3cdd updated for version 7.0068
vimboss
parents: 236
diff changeset
262 :r !ls *.c
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
263 :%s/\(.*\).c/mv & \1.bla
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
264 :w !sh
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
265 :q!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
266
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
267 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
268 Speeding up external commands *speed-up*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
269
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
270 In some situations, execution of an external command can be very slow. This
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
271 can also slow down wildcard expansion on Unix. Here are a few suggestions to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
272 increase the speed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
273
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
274 If your .cshrc (or other file, depending on the shell used) is very long, you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
275 should separate it into a section for interactive use and a section for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
276 non-interactive use (often called secondary shells). When you execute a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
277 command from Vim like ":!ls", you do not need the interactive things (for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
278 example, setting the prompt). Put the stuff that is not needed after these
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
279 lines: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
280
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
281 if ($?prompt == 0) then
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
282 exit 0
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
283 endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
284
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
285 Another way is to include the "-f" flag in the 'shell' option, e.g.: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
286
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
287 :set shell=csh\ -f
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 (the backslash is needed to include the space in the option).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
290 This will make csh completely skip the use of the .cshrc file. This may cause
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
291 some things to stop working though.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
292
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
293 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
294 Useful mappings *useful-mappings*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
295
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
296 Here are a few mappings that some people like to use.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
298 *map-backtick* >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299 :map ' `
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300 Make the single quote work like a backtick. Puts the cursor on the column of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 a mark, instead of going to the first non-blank character in the line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
302
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303 *emacs-keys*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
304 For Emacs-style editing on the command-line: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
305 " start of line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
306 :cnoremap <C-A> <Home>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
307 " back one character
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
308 :cnoremap <C-B> <Left>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
309 " delete character under cursor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
310 :cnoremap <C-D> <Del>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
311 " end of line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
312 :cnoremap <C-E> <End>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
313 " forward one character
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
314 :cnoremap <C-F> <Right>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
315 " recall newer command-line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
316 :cnoremap <C-N> <Down>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
317 " recall previous (older) command-line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
318 :cnoremap <C-P> <Up>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
319 " back one word
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
320 :cnoremap <Esc><C-B> <S-Left>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
321 " forward one word
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
322 :cnoremap <Esc><C-F> <S-Right>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
323
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
324 NOTE: This requires that the '<' flag is excluded from 'cpoptions'. |<>|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
325
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
326 *format-bullet-list*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
327 This mapping will format any bullet list. It requires that there is an empty
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
328 line above and below each list entry. The expression commands are used to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
329 be able to give comments to the parts of the mapping. >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
330
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
331 :let m = ":map _f :set ai<CR>" " need 'autoindent' set
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
332 :let m = m . "{O<Esc>" " add empty line above item
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
333 :let m = m . "}{)^W" " move to text after bullet
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
334 :let m = m . "i <CR> <Esc>" " add space for indent
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
335 :let m = m . "gq}" " format text after the bullet
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
336 :let m = m . "{dd" " remove the empty line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
337 :let m = m . "5lDJ" " put text after bullet
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
338 :execute m |" define the mapping
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
339
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
340 (<> notation |<>|. Note that this is all typed literally. ^W is "^" "W", not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
341 CTRL-W. You can copy/paste this into Vim if '<' is not included in
236
4707450c2b33 updated for version 7.0066
vimboss
parents: 170
diff changeset
342 'cpoptions'.)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
343
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
344 Note that the last comment starts with |", because the ":execute" command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
345 doesn't accept a comment directly.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
346
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
347 You also need to set 'textwidth' to a non-zero value, e.g., >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
348 :set tw=70
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
349
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
350 A mapping that does about the same, but takes the indent for the list from the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
351 first line (Note: this mapping is a single long line with a lot of spaces): >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
352 :map _f :set ai<CR>}{a <Esc>WWmmkD`mi<CR><Esc>kkddpJgq}'mJO<Esc>j
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
353 <
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
354 *collapse*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
355 These two mappings reduce a sequence of empty (;b) or blank (;n) lines into a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
356 single line >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
357 :map ;b GoZ<Esc>:g/^$/.,/./-j<CR>Gdd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
358 :map ;n GoZ<Esc>:g/^[ <Tab>]*$/.,/[^ <Tab>]/-j<CR>Gdd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
359
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
360 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
361 Compressing the help files *gzip-helpfile*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
362
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
363 For those of you who are really short on disk space, you can compress the help
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
364 files and still be able to view them with Vim. This makes accessing the help
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
365 files a bit slower and requires the "gzip" program.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
366
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
367 (1) Compress all the help files: "gzip doc/*.txt".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
368
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
369 (2) Edit "doc/tags" and change the ".txt" to ".txt.gz": >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
370 :%s=\(\t.*\.txt\)\t=\1.gz\t=
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
371
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
372 (3) Add this line to your vimrc: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
373 set helpfile={dirname}/help.txt.gz
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
374
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
375 Where {dirname} is the directory where the help files are. The |gzip| plugin
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
376 will take care of decompressing the files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
377 You must make sure that $VIMRUNTIME is set to where the other Vim files are,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
378 when they are not in the same location as the compressed "doc" directory. See
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
379 |$VIMRUNTIME|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
380
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
381 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
382 Executing shell commands in a window *shell-window*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
383
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
384 There have been questions for the possibility to execute a shell in a window
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
385 inside Vim. The answer: you can't! Including this would add a lot of code to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
386 Vim, which is a good reason not to do this. After all, Vim is an editor, it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
387 is not supposed to do non-editing tasks. However, to get something like this,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
388 you might try splitting your terminal screen or display window with the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
389 "splitvt" program. You can probably find it on some ftp server. The person
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
390 that knows more about this is Sam Lantinga <slouken@cs.ucdavis.edu>.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
391 An alternative is the "window" command, found on BSD Unix systems, which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
392 supports multiple overlapped windows. Or the "screen" program, found at
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
393 www.uni-erlangen.de, which supports a stack of windows.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
394
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
395 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
396 Hex editing *hex-editing* *using-xxd*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
397
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
398 See section |23.4| of the user manual.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
399
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
400 If one has a particular extension that one uses for binary files (such as exe,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
401 bin, etc), you may find it helpful to automate the process with the following
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
402 bit of autocmds for your <.vimrc>. Change that "*.bin" to whatever
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
403 comma-separated list of extension(s) you find yourself wanting to edit: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
404
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
405 " vim -b : edit binary using xxd-format!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
406 augroup Binary
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
407 au!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
408 au BufReadPre *.bin let &bin=1
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
409 au BufReadPost *.bin if &bin | %!xxd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
410 au BufReadPost *.bin set ft=xxd | endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
411 au BufWritePre *.bin if &bin | %!xxd -r
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
412 au BufWritePre *.bin endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
413 au BufWritePost *.bin if &bin | %!xxd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
414 au BufWritePost *.bin set nomod | endif
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
415 augroup END
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
416
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
417 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
418 Using <> notation in autocommands *autocmd-<>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
419
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
420 The <> notation is not recognized in the argument of an :autocmd. To avoid
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
421 having to use special characters, you could use a self-destroying mapping to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
422 get the <> notation and then call the mapping from the autocmd. Example:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
423
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
424 *map-self-destroy* >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
425 " This is for automatically adding the name of the file to the menu list.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
426 " It uses a self-destroying mapping!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
427 " 1. use a line in the buffer to convert the 'dots' in the file name to \.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
428 " 2. store that in register '"'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
429 " 3. add that name to the Buffers menu list
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
430 " WARNING: this does have some side effects, like overwriting the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
431 " current register contents and removing any mapping for the "i" command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
432 "
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
433 autocmd BufNewFile,BufReadPre * nmap i :nunmap i<CR>O<C-R>%<Esc>:.g/\./s/\./\\./g<CR>0"9y$u:menu Buffers.<C-R>9 :buffer <C-R>%<C-V><CR><CR>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
434 autocmd BufNewFile,BufReadPre * normal i
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
435
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
436 Another method, perhaps better, is to use the ":execute" command. In the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
437 string you can use the <> notation by preceding it with a backslash. Don't
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
438 forget to double the number of existing backslashes and put a backslash before
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
439 '"'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
440 >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
441 autocmd BufNewFile,BufReadPre * exe "normal O\<C-R>%\<Esc>:.g/\\./s/\\./\\\\./g\<CR>0\"9y$u:menu Buffers.\<C-R>9 :buffer \<C-R>%\<C-V>\<CR>\<CR>"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
442
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
443 For a real buffer menu, user functions should be used (see |:function|), but
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
444 then the <> notation isn't used, which defeats using it as an example here.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
445
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
446 vim:tw=78:ts=8:ft=help:norl: