annotate runtime/doc/intro.txt @ 1272:9e58270f87a8

updated for version 7.1
author vimboss
date Sat, 12 May 2007 15:00:32 +0000
parents 756bed568f5d
children 18ee39301b82
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1272
9e58270f87a8 updated for version 7.1
vimboss
parents: 1222
diff changeset
1 *intro.txt* For Vim version 7.1. Last change: 2007 May 07
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 Introduction to Vim *ref* *reference*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 1. Introduction |intro|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 2. Vim on the internet |internet|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 3. Credits |credits|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 4. Notation |notation|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 5. Modes, introduction |vim-modes-intro|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 6. Switching from mode to mode |mode-switching|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 7. The window contents |window-contents|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 8. Definitions |definitions|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 1. Introduction *intro*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 Vim stands for Vi IMproved. It used to be Vi IMitation, but there are so many
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22 improvements that a name change was appropriate. Vim is a text editor which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 includes almost all the commands from the Unix program "Vi" and a lot of new
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 ones. It is very useful for editing programs and other plain text.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 All commands are given with the keyboard. This has the advantage that you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 can keep your fingers on the keyboard and your eyes on the screen. For those
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27 who want it, there is mouse support and a GUI version with scrollbars and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 menus (see |gui.txt|).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 An overview of this manual can be found in the file "help.txt", |help.txt|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31 It can be accessed from within Vim with the <Help> or <F1> key and with the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 |:help| command (just type ":help", without the bars or quotes).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 The 'helpfile' option can be set to the name of the help file, in case it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 is not located in the default place. You can jump to subjects like with tags:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 Use CTRL-] to jump to a subject under the cursor, use CTRL-T to jump back.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 Throughout this manual the differences between Vi and Vim are mentioned in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 curly braces, like this: {Vi does not have on-line help}. See |vi_diff.txt|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 for a summary of the differences between Vim and Vi.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 This manual refers to Vim on various machines. There may be small differences
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 between different computers and terminals. Besides the remarks given in this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 document, there is a separate document for each supported system, see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 |sys-file-list|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 This manual is a reference for all the Vim commands and options. This is not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 an introduction to the use of Vi or Vim, it gets a bit complicated here and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 there. For beginners, there is a hands-on |tutor|. To learn using Vim, read
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 the user manual |usr_toc.txt|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 *book*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 There are many books on Vi that contain a section for beginners. There are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 two books I can recommend:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 "Vim - Vi Improved" by Steve Oualline
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57 This is the very first book completely dedicated to Vim. It is very good for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 beginners. The most often used commands are explained with pictures and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59 examples. The less often used commands are also explained, the more advanced
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 features are summarized. There is a comprehensive index and a quick
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 reference. Parts of this book have been included in the user manual
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62 |frombook|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 Published by New Riders Publishing. ISBN: 0735710015
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 For more information try one of these:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65 http://iccf-holland.org/click5.html
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66 http://www.vim.org/iccf/click5.html
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 "Learning the Vi editor" by Linda Lamb and Arnold Robbins
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70 This is a book about Vi that includes a chapter on Vim (in the sixth edition).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 The first steps in Vi are explained very well. The commands that Vim adds are
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
72 only briefly mentioned. There is also a German translation.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 Published by O'Reilly. ISBN: 1-56592-426-6.
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 2. Vim on the internet *internet*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77
838
8e5830943bff updated for version 7.0e04
vimboss
parents: 834
diff changeset
78 *www* *WWW* *faq* *FAQ* *distribution* *download*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 The Vim pages contain the most recent information about Vim. They also
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 contain links to the most recent version of Vim. The FAQ is a list of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 Frequently Asked Questions. Read this if you have problems.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
83 VIM home page: http://www.vim.org/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
84 VIM FAQ: http://vimdoc.sf.net/
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 Downloading: ftp://ftp.vim.org/pub/vim/MIRRORS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88 Usenet News group where Vim is discussed: *news* *usenet*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89 comp.editors
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 This group is also for other editors. If you write about Vim, don't forget to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91 mention that.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 *mail-list* *maillist*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94 There are several mailing lists for Vim:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 <vim@vim.org>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
96 For discussions about using existing versions of Vim: Useful mappings,
824
8dd456c1e283 updated for version 7.0c13
vimboss
parents: 810
diff changeset
97 questions, answers, where to get a specific version, etc. There are
8dd456c1e283 updated for version 7.0c13
vimboss
parents: 810
diff changeset
98 quite a few people watching this list and answering questions, also
8dd456c1e283 updated for version 7.0c13
vimboss
parents: 810
diff changeset
99 for beginners. Don't hesitate to ask your question here.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 <vim-dev@vim.org> *vim-dev* *vimdev*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 For discussions about changing Vim: New features, porting, patches,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 beta-test versions, etc.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 <vim-announce@vim.org> *vim-announce*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 Announcements about new versions of Vim; also for beta-test versions
824
8dd456c1e283 updated for version 7.0c13
vimboss
parents: 810
diff changeset
105 and ports to different systems. This is a read-only list.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 <vim-multibyte@vim.org> *vim-multibyte*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 For discussions about using and improving the multi-byte aspects of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
108 Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
109 <vim-mac@vim.org> *vim-mac*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
110 For discussions about using and improving the Macintosh version of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
111 Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
112
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113 See http://www.vim.org/maillist.php for the latest information.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
114
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
115 NOTE:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116 - You can only send messages to these lists if you have subscribed!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 - You need to send the messages from the same location as where you subscribed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118 from (to avoid spam mail).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 - Maximum message size is 40000 characters.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121 *subscribe-maillist*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122 If you want to join, send a message to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 <vim-help@vim.org>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124 Make sure that your "From:" address is correct. Then the list server will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 give you help on how to subscribe.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 You can retrieve old messages from the maillist software, and an index of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 messages. Ask vim-help for instructions.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130 Archives are kept at: *maillist-archive*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 http://groups.yahoo.com/group/vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 http://groups.yahoo.com/group/vimdev
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 http://groups.yahoo.com/group/vimannounce
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134 http://groups.yahoo.com/group/vim-multibyte
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 http://groups.yahoo.com/group/vim-mac
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
136
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
137
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
138 Additional maillists:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
139
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
140 <vim-fr@club.voila.fr> *french-maillist*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
141 Vim list in the French language. Subscribe by sending a message to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
142 <vim-fr-subscribe@club.voila.fr>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
143 Or go to http://groups.yahoo.com/group/vim-fr.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
144
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
145
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
146 Bug reports: *bugs* *bug-reports* *bugreport.vim*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
148 Send bug reports to: Vim bugs <bugs@vim.org>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
149 This is not a maillist but the message is redirected to the Vim maintainer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150 Please be brief; all the time that is spent on answering mail is subtracted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
151 from the time that is spent on improving Vim! Always give a reproducible
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
152 example and try to find out which settings or other things influence the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
153 appearance of the bug. Try different machines, if possible. Send me patches
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
154 if you can!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
155
502
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 323
diff changeset
156 It will help to include information about the version of Vim you are using and
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 323
diff changeset
157 your setup. You can get the information with this command: >
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
158 :so $VIMRUNTIME/bugreport.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
159 This will create a file "bugreport.txt" in the current directory, with a lot
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
160 of information of your environment. Before sending this out, check if it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
161 doesn't contain any confidential information!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
162
502
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 323
diff changeset
163 If Vim crashes, please try to find out where. You can find help on this here:
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 323
diff changeset
164 |debug.txt|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
165
502
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 323
diff changeset
166 In case of doubt or when you wonder if the problem has already been fixed but
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 323
diff changeset
167 you can't find a fix for it, become a member of the vim-dev maillist and ask
52e76e2b5b65 updated for version 7.0140
vimboss
parents: 323
diff changeset
168 your question there. |maillist|
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
169
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
170 *year-2000* *Y2K*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
171 Since Vim internally doesn't use dates for editing, there is no year 2000
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
172 problem to worry about. Vim does use the time in the form of seconds since
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
173 January 1st 1970. It is used for a time-stamp check of the edited file and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
174 the swap file, which is not critical and should only cause warning messages.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
175
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
176 There might be a year 2038 problem, when the seconds don't fit in a 32 bit int
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
177 anymore. This depends on the compiler, libraries and operating system.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
178 Specifically, time_t and the ctime() function are used. And the time_t is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
179 stored in four bytes in the swap file. But that's only used for printing a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
180 file date/time for recovery, it will never affect normal editing.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
181
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
182 The Vim strftime() function directly uses the strftime() system function.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
183 localtime() uses the time() system function. getftime() uses the time
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
184 returned by the stat() system function. If your system libraries are year
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
185 2000 compliant, Vim is too.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
186
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
187 The user may create scripts for Vim that use external commands. These might
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
188 introduce Y2K problems, but those are not really part of Vim itself.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
189
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
190 ==============================================================================
323
03b3684919e3 updated for version 7.0084
vimboss
parents: 237
diff changeset
191 3. Credits *credits* *author* *Bram* *Moolenaar*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
192
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
193 Most of Vim was written by Bram Moolenaar <Bram@vim.org>.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
194
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
195 Parts of the documentation come from several Vi manuals, written by:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
196 W.N. Joy
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
197 Alan P.W. Hewett
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
198 Mark Horton
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
199
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
200 The Vim editor is based on Stevie and includes (ideas from) other software,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
201 worked on by the people mentioned here. Other people helped by sending me
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
202 patches, suggestions and giving feedback about what is good and bad in Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
203
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
204 Vim would never have become what it is now, without the help of these people!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
205
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
206 Ron Aaron Win32 GUI changes
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
207 Zoltan Arpadffy work on VMS port
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
208 Tony Andrews Stevie
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
209 Gert van Antwerpen changes for DJGPP on MS-DOS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
210 Berkeley DB(3) ideas for swap file implementation
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
211 Keith Bostic Nvi
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
212 Walter Briscoe Makefile updates, various patches
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
213 Ralf Brown SPAWNO library for MS-DOS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
214 Robert Colon many useful remarks
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
215 Marcin Dalecki GTK+ GUI port, toolbar icons, gettext()
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
216 Kayhan Demirel sent me news in Uganda
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
217 Chris & John Downey xvi (ideas for multi-windows version)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
218 Henk Elbers first VMS port
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 7
diff changeset
219 Daniel Elstner GTK+ 2 port
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
220 Eric Fischer Mac port, 'cindent', and other improvements
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
221 Benji Fisher Answering lots of user questions
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
222 Bill Foster Athena GUI port
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
223 Loic Grenie xvim (ideas for multi windows version)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
224 Sven Guckes Vim promotor and previous WWW page maintainer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
225 Darren Hiebert Exuberant ctags
29
ac33b7c03fac updated for version 7.0018
vimboss
parents: 7
diff changeset
226 Jason Hildebrand GTK+ 2 port
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
227 Bruce Hunsaker improvements for VMS port
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
228 Andy Kahn Cscope support, GTK+ GUI port
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
229 Oezguer Kesim Maintainer of Vim Mailing Lists
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
230 Axel Kielhorn work on the Macintosh port
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
231 Steve Kirkendall Elvis
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
232 Roger Knobbe original port to Windows NT
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
233 Sergey Laskavy Vim's help from Moscow
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
234 Felix von Leitner Maintainer of Vim Mailing Lists
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
235 David Leonard Port of Python extensions to Unix
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
236 Avner Lottem Edit in right-to-left windows
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
237 Flemming Madsen X11 client-server, various features and patches
1222
756bed568f5d updated for version 7.1b
vimboss
parents: 1125
diff changeset
238 Microsoft Gave me a copy of DevStudio to compile Vim with
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
239 Paul Moore Python interface extensions, many patches
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
240 Katsuhito Nagano Work on multi-byte versions
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
241 Sung-Hyun Nam Work on multi-byte versions
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
242 Vince Negri Win32 GUI and generic console enhancements
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
243 Steve Oualline Author of the first Vim book |frombook|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
244 George V. Reilly Win32 port, Win32 GUI start-off
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
245 Stephen Riehm bug collector
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
246 Stefan Roemer various patches and help to users
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
247 Ralf Schandl IBM OS/390 port
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
248 Olaf Seibert DICE and BeBox version, regexp improvements
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
249 Mortaza Shiran Farsi patches
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
250 Peter da Silva termlib
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
251 Paul Slootman OS/2 port
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
252 Henry Spencer regular expressions
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
253 Dany St-Amant Macintosh port
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
254 Tim Thompson Stevie
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
255 G. R. (Fred) Walter Stevie
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
256 Sven Verdoolaege Perl interface
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
257 Robert Webb Command-line completion, GUI versions, and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258 lots of patches
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
259 Ingo Wilken Tcl interface
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
260 Mike Williams PostScript printing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
261 Juergen Weigert Lattice version, AUX improvements, UNIX and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
262 MS-DOS ports, autoconf
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
263 Stefan 'Sec' Zehl Maintainer of vim.org
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
264
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
265 I wish to thank all the people that sent me bug reports and suggestions. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
266 list is too long to mention them all here. Vim would not be the same without
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
267 the ideas from all these people: They keep Vim alive!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
268
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
269
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
270 In this documentation there are several references to other versions of Vi:
39
410fa1a31baf updated for version 7.0023
vimboss
parents: 36
diff changeset
271 *Vi* *vi*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
272 Vi "the original". Without further remarks this is the version
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
273 of Vi that appeared in Sun OS 4.x. ":version" returns
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
274 "Version 3.7, 6/7/85". Sometimes other versions are referred
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
275 to. Only runs under Unix. Source code only available with a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
276 license. More information on Vi can be found through:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
277 http://vi-editor.org [doesn't currently work...]
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
278 *Posix*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
279 Posix From the IEEE standard 1003.2, Part 2: Shell and utilities.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
280 Generally known as "Posix". This is a textual description of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
281 how Vi is supposed to work.
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 39
diff changeset
282 See |posix-compliance|.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
283 *Nvi*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
284 Nvi The "New" Vi. The version of Vi that comes with BSD 4.4 and FreeBSD.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
285 Very good compatibility with the original Vi, with a few extensions.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
286 The version used is 1.79. ":version" returns "Version 1.79
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
287 (10/23/96)". There has been no release the last few years, although
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
288 there is a development version 1.81.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
289 Source code is freely available.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
290 *Elvis*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
291 Elvis Another Vi clone, made by Steve Kirkendall. Very compact but isn't
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
292 as flexible as Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
293 The version used is 2.1. It is still being developed. Source code is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
294 freely available.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
295
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
296 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
297 4. Notation *notation*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
298
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
299 When syntax highlighting is used to read this, text that is not typed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
300 literally is often highlighted with the Special group. These are items in [],
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
301 {} and <>, and CTRL-X.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
302
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
303 Note that Vim uses all possible characters in commands. Sometimes the [], {}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
304 and <> are part of what you type, the context should make this clear.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
305
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
306
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
307 [] Characters in square brackets are optional.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
308
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
309 *count* *[count]* *E489*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
310 [count] An optional number that may precede the command to multiply
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
311 or iterate the command. If no number is given, a count of one
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
312 is used, unless otherwise noted. Note that in this manual the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
313 [count] is not mentioned in the description of the command,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
314 but only in the explanation. This was done to make the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
315 commands easier to look up. If the 'showcmd' option is on,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
316 the (partially) entered count is shown at the bottom of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
317 window. You can use <Del> to erase the last digit (|N<Del>|).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
318
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
319 *[quotex]*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
320 ["x] An optional register designation where text can be stored.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
321 See |registers|. The x is a single character between 'a' and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
322 'z' or 'A' and 'Z' or '"', and in some cases (with the put
237
73354c21f1e4 updated for version 7.0066
vimboss
parents: 161
diff changeset
323 command) between '0' and '9', '%', '#', or others. The
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
324 uppercase and lowercase letter designate the same register,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
325 but the lowercase letter is used to overwrite the previous
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
326 register contents, while the uppercase letter is used to
237
73354c21f1e4 updated for version 7.0066
vimboss
parents: 161
diff changeset
327 append to the previous register contents. Without the ""x" or
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
328 with """" the stored text is put into the unnamed register.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
329
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
330 *{}*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
331 {} Curly braces denote parts of the command which must appear,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
332 but which can take a number of different values. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
333 differences between Vim and Vi are also given in curly braces
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
334 (this will be clear from the context).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
335
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
336 *{char1-char2}*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
337 {char1-char2} A single character from the range char1 to char2. For
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
338 example: {a-z} is a lowercase letter. Multiple ranges may be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
339 concatenated. For example, {a-zA-Z0-9} is any alphanumeric
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
340 character.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
341
36
125e80798a85 updated for version 7.0021
vimboss
parents: 29
diff changeset
342 *{motion}* *movement*
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
343 {motion} A command that moves the cursor. These are explained in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
344 |motion.txt|. Examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
345 w to start of next word
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
346 b to begin of current word
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
347 4j four lines down
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
348 /The<CR> to next occurrence of "The"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
349 This is used after an |operator| command to move over the text
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
350 that is to be operated upon.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
351 - If the motion includes a count and the operator also has a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
352 count, the two counts are multiplied. For example: "2d3w"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
353 deletes six words.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
354 - The motion can be backwards, e.g. "db" to delete to the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
355 start of the word.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
356 - The motion can also be a mouse click. The mouse is not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
357 supported in every terminal though.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
358 - The ":omap" command can be used to map characters while an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
359 operator is pending.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
360 - Ex commands can be used to move the cursor. This can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
361 used to call a function that does some complicated motion.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
362 The motion is always characterwise exclusive, no matter
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
363 what ":" command is used. This means it's impossible to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
364 include the last character of a line without the line break
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
365 (unless 'virtualedit' is set).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
366 If the Ex command changes the text before where the operator
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
367 starts or jumps to another buffer the result is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
368 unpredictable. It is possible to change the text further
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
369 down. Jumping to another buffer is possible if the current
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
370 buffer is not unloaded.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
371
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
372 *{Visual}*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
373 {Visual} A selected text area. It is started with the "v", "V", or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
374 CTRL-V command, then any cursor movement command can be used
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
375 to change the end of the selected text.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
376 This is used before an |operator| command to highlight the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
377 text that is to be operated upon.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
378 See |Visual-mode|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
379
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
380 *<character>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
381 <character> A special character from the table below, optionally with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
382 modifiers, or a single ASCII character with modifiers.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
383
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
384 *'character'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
385 'c' A single ASCII character.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
386
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
387 *CTRL-{char}*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
388 CTRL-{char} {char} typed as a control character; that is, typing {char}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
389 while holding the CTRL key down. The case of {char} does not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
390 matter; thus CTRL-A and CTRL-a are equivalent. But on some
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
391 terminals, using the SHIFT key will produce another code,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
392 don't use it then.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
393
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
394 *'option'*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
395 'option' An option, or parameter, that can be set to a value, is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
396 enclosed in single quotes. See |options|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
397
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
398 *quotecommandquote*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
399 "command" A reference to a command that you can type is enclosed in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
400 double quotes.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
401
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
402 *key-notation* *key-codes* *keycodes*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
403 These names for keys are used in the documentation. They can also be used
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
404 with the ":map" command (insert the key name by pressing CTRL-K and then the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
405 key you want the name for).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
406
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
407 notation meaning equivalent decimal value(s) ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
408 -----------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
409 <Nul> zero CTRL-@ 0 (stored as 10) *<Nul>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
410 <BS> backspace CTRL-H 8 *backspace*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
411 <Tab> tab CTRL-I 9 *tab* *Tab*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
412 *linefeed*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
413 <NL> linefeed CTRL-J 10 (used for <Nul>)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
414 <FF> formfeed CTRL-L 12 *formfeed*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
415 <CR> carriage return CTRL-M 13 *carriage-return*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
416 <Return> same as <CR> *<Return>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
417 <Enter> same as <CR> *<Enter>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
418 <Esc> escape CTRL-[ 27 *escape* *<Esc>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
419 <Space> space 32 *space*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
420 <lt> less-than < 60 *<lt>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
421 <Bslash> backslash \ 92 *backslash* *<Bslash>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
422 <Bar> vertical bar | 124 *<Bar>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
423 <Del> delete 127
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
424 <CSI> command sequence intro ALT-Esc 155 *<CSI>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
425 <xCSI> CSI when typed in the GUI *<xCSI>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
426
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
427 <EOL> end-of-line (can be <CR>, <LF> or <CR><LF>,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
428 depends on system and 'fileformat') *<EOL>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
429
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
430 <Up> cursor-up *cursor-up* *cursor_up*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
431 <Down> cursor-down *cursor-down* *cursor_down*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
432 <Left> cursor-left *cursor-left* *cursor_left*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
433 <Right> cursor-right *cursor-right* *cursor_right*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
434 <S-Up> shift-cursor-up
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
435 <S-Down> shift-cursor-down
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
436 <S-Left> shift-cursor-left
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
437 <S-Right> shift-cursor-right
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
438 <C-Left> control-cursor-left
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
439 <C-Right> control-cursor-right
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
440 <F1> - <F12> function keys 1 to 12 *function_key* *function-key*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
441 <S-F1> - <S-F12> shift-function keys 1 to 12 *<S-F1>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
442 <Help> help key
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
443 <Undo> undo key
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
444 <Insert> insert key
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
445 <Home> home *home*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
446 <End> end *end*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
447 <PageUp> page-up *page_up* *page-up*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
448 <PageDown> page-down *page_down* *page-down*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
449 <kHome> keypad home (upper left) *keypad-home*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
450 <kEnd> keypad end (lower left) *keypad-end*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
451 <kPageUp> keypad page-up (upper right) *keypad-page-up*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
452 <kPageDown> keypad page-down (lower right) *keypad-page-down*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
453 <kPlus> keypad + *keypad-plus*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
454 <kMinus> keypad - *keypad-minus*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
455 <kMultiply> keypad * *keypad-multiply*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
456 <kDivide> keypad / *keypad-divide*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
457 <kEnter> keypad Enter *keypad-enter*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
458 <kPoint> keypad Decimal point *keypad-point*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
459 <k0> - <k9> keypad 0 to 9 *keypad-0* *keypad-9*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
460 <S-...> shift-key *shift* *<S-*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
461 <C-...> control-key *control* *ctrl* *<C-*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
462 <M-...> alt-key or meta-key *meta* *alt* *<M-*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
463 <A-...> same as <M-...> *<A-*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
464 <D-...> command-key (Macintosh only) *<D-*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
465 <t_xx> key with "xx" entry in termcap
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
466 -----------------------------------------------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
467
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
468 Note: The shifted cursor keys, the help key, and the undo key are only
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
469 available on a few terminals. On the Amiga, shifted function key 10 produces
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
470 a code (CSI) that is also used by key sequences. It will be recognized only
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
471 after typing another key.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
472
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
473 Note: There are two codes for the delete key. 127 is the decimal ASCII value
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
474 for the delete key, which is always recognized. Some delete keys send another
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
475 value, in which case this value is obtained from the termcap entry "kD". Both
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
476 values have the same effect. Also see |:fixdel|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
477
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
478 Note: The keypad keys are used in the same way as the corresponding "normal"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
479 keys. For example, <kHome> has the same effect as <Home>. If a keypad key
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
480 sends the same raw key code as its non-keypad equivalent, it will be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
481 recognized as the non-keypad code. For example, when <kHome> sends the same
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
482 code as <Home>, when pressing <kHome> Vim will think <Home> was pressed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
483 Mapping <kHome> will not work then.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
484
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
485 *<>*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
486 Examples are often given in the <> notation. Sometimes this is just to make
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
487 clear what you need to type, but often it can be typed literally, e.g., with
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
488 the ":map" command. The rules are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
489 1. Any printable characters are typed directly, except backslash and '<'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
490 2. A backslash is represented with "\\", double backslash, or "<Bslash>".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
491 3. A real '<' is represented with "\<" or "<lt>". When there is no
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
492 confusion possible, a '<' can be used directly.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
493 4. "<key>" means the special key typed. This is the notation explained in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
494 the table above. A few examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
495 <Esc> Escape key
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
496 <C-G> CTRL-G
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
497 <Up> cursor up key
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
498 <C-LeftMouse> Control- left mouse click
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
499 <S-F11> Shifted function key 11
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
500 <M-a> Meta- a ('a' with bit 8 set)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
501 <M-A> Meta- A ('A' with bit 8 set)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
502 <t_kd> "kd" termcap entry (cursor down key)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
503
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
504 If you want to use the full <> notation in Vim, you have to make sure the '<'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
505 flag is excluded from 'cpoptions' (when 'compatible' is not set, it already is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
506 by default). >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
507 :set cpo-=<
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
508 The <> notation uses <lt> to escape the special meaning of key names. Using a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
509 backslash also works, but only when 'cpoptions' does not include the 'B' flag.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
510
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
511 Examples for mapping CTRL-H to the six characters "<Home>": >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
512 :imap <C-H> \<Home>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
513 :imap <C-H> <lt>Home>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
514 The first one only works when the 'B' flag is not in 'cpoptions'. The second
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
515 one always works.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
516 To get a literal "<lt>" in a mapping: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
517 :map <C-L> <lt>lt>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
518
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
519 For mapping, abbreviation and menu commands you can then copy-paste the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
520 examples and use them directly. Or type them literally, including the '<' and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
521 '>' characters. This does NOT work for other commands, like ":set" and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
522 ":autocmd"!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
523
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
524 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
525 5. Modes, introduction *vim-modes-intro* *vim-modes*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
526
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
527 Vim has six BASIC modes:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
528
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
529 *Normal* *Normal-mode* *command-mode*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
530 Normal mode In Normal mode you can enter all the normal editor
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
531 commands. If you start the editor you are in this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
532 mode (unless you have set the 'insertmode' option,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
533 see below). This is also known as command mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
534
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
535 Visual mode This is like Normal mode, but the movement commands
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
536 extend a highlighted area. When a non-movement
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
537 command is used, it is executed for the highlighted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
538 area. See |Visual-mode|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
539 If the 'showmode' option is on "-- VISUAL --" is shown
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
540 at the bottom of the window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
541
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
542 Select mode This looks most like the MS-Windows selection mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
543 Typing a printable character deletes the selection
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
544 and starts Insert mode. See |Select-mode|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
545 If the 'showmode' option is on "-- SELECT --" is shown
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
546 at the bottom of the window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
547
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
548 Insert mode In Insert mode the text you type is inserted into the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
549 buffer. See |Insert-mode|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
550 If the 'showmode' option is on "-- INSERT --" is shown
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
551 at the bottom of the window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
552
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
553 Command-line mode In Command-line mode (also called Cmdline mode) you
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
554 Cmdline mode can enter one line of text at the bottom of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
555 window. This is for the Ex commands, ":", the pattern
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
556 search commands, "?" and "/", and the filter command,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
557 "!". |Cmdline-mode|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
558
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
559 Ex mode Like Command-line mode, but after entering a command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
560 you remain in Ex mode. Very limited editing of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
561 command line. |Ex-mode|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
562
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
563 There are five ADDITIONAL modes. These are variants of the BASIC modes:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
564
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
565 *Operator-pending* *Operator-pending-mode*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
566 Operator-pending mode This is like Normal mode, but after an operator
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
567 command has started, and Vim is waiting for a {motion}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
568 to specify the text that the operator will work on.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
569
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
570 Replace mode Replace mode is a special case of Insert mode. You
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
571 can do the same things as in Insert mode, but for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
572 each character you enter, one character of the existing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
573 text is deleted. See |Replace-mode|.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
574 If the 'showmode' option is on "-- REPLACE --" is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
575 shown at the bottom of the window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
576
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
577 Insert Normal mode Entered when CTRL-O given in Insert mode. This is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
578 like Normal mode, but after executing one command Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
579 returns to Insert mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
580 If the 'showmode' option is on "-- (insert) --" is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
581 shown at the bottom of the window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
582
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
583 Insert Visual mode Entered when starting a Visual selection from Insert
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
584 mode, e.g., by using CTRL-O and then "v", "V" or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
585 CTRL-V. When the Visual selection ends, Vim returns
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
586 to Insert mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
587 If the 'showmode' option is on "-- (insert) VISUAL --"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
588 is shown at the bottom of the window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
589
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
590 Insert Select mode Entered when starting Select mode from Insert mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
591 E.g., by dragging the mouse or <S-Right>.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
592 When the Select mode ends, Vim returns to Insert mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
593 If the 'showmode' option is on "-- (insert) SELECT --"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
594 is shown at the bottom of the window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
595
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
596 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
597 6. Switching from mode to mode *mode-switching*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
598
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
599 If for any reason you do not know which mode you are in, you can always get
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
600 back to Normal mode by typing <Esc> twice. This doesn't work for Ex mode
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
601 though, use ":visual".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
602 You will know you are back in Normal mode when you see the screen flash or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
603 hear the bell after you type <Esc>. However, when pressing <Esc> after using
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
604 CTRL-O in Insert mode you get a beep but you are still in Insert mode, type
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
605 <Esc> again.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
606
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
607 *i_esc*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
608 TO mode ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
609 Normal Visual Select Insert Replace Cmd-line Ex ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
610 FROM mode ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
611 Normal v V ^V *4 *1 R : / ? ! Q
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
612 Visual *2 ^G c C -- : --
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
613 Select *5 ^O ^G *6 -- -- --
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
614 Insert <Esc> -- -- <Insert> -- --
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
615 Replace <Esc> -- -- <Insert> -- --
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
616 Command-line *3 -- -- :start -- --
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
617 Ex :vi -- -- -- -- --
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
618
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
619 - NA
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
620 -- not possible
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
621
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
622 *1 Go from Normal mode to Insert mode by giving the command "i", "I", "a",
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
623 "A", "o", "O", "c", "C", "s" or S".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
624 *2 Go from Visual mode to Normal mode by giving a non-movement command, which
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
625 causes the command to be executed, or by hitting <Esc> "v", "V" or "CTRL-V"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
626 (see |v_v|), which just stops Visual mode without side effects.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
627 *3 Go from Command-line mode to Normal mode by:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
628 - Hitting <CR> or <NL>, which causes the entered command to be executed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
629 - Deleting the complete line (e.g., with CTRL-U) and giving a final <BS>.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
630 - Hitting CTRL-C or <Esc>, which quits the command-line without executing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
631 the command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
632 In the last case <Esc> may be the character defined with the 'wildchar'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
633 option, in which case it will start command-line completion. You can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
634 ignore that and type <Esc> again. {Vi: when hitting <Esc> the command-line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
635 is executed. This is unexpected for most people; therefore it was changed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
636 in Vim. But when the <Esc> is part of a mapping, the command-line is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
637 executed. If you want the Vi behaviour also when typing <Esc>, use ":cmap
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
638 ^V<Esc> ^V^M"}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
639 *4 Go from Normal to Select mode by:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
640 - use the mouse to select text while 'selectmode' contains "mouse"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
641 - use a non-printable command to move the cursor while keeping the Shift
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
642 key pressed, and the 'selectmode' option contains "key"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
643 - use "v", "V" or "CTRL-V" while 'selectmode' contains "cmd"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
644 - use "gh", "gH" or "g CTRL-H" |g_CTRL-H|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
645 *5 Go from Select mode to Normal mode by using a non-printable command to move
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
646 the cursor, without keeping the Shift key pressed.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
647 *6 Go from Select mode to Insert mode by typing a printable character. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
648 selection is deleted and the character is inserted.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
649
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
650 If the 'insertmode' option is on, editing a file will start in Insert mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
651
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
652 *CTRL-\_CTRL-N* *i_CTRL-\_CTRL-N* *c_CTRL-\_CTRL-N* *v_CTRL-\_CTRL-N*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
653 Additionally the command CTRL-\ CTRL-N or <C-\><C-N> can be used to go to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
654 Normal mode from any other mode. This can be used to make sure Vim is in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
655 Normal mode, without causing a beep like <Esc> would. However, this does not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
656 work in Ex mode. When used after a command that takes an argument, such as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
657 |f| or |m|, the timeout set with 'ttimeoutlen' applies.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
658
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
659 *CTRL-\_CTRL-G* *i_CTRL-\_CTRL-G* *c_CTRL-\_CTRL-G* *v_CTRL-\_CTRL-G*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
660 The command CTRL-\ CTRL-G or <C-\><C-G> can be used to go to Insert mode when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
661 'insertmode' is set. Otherwise it goes to Normal mode. This can be used to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
662 make sure Vim is in the mode indicated by 'insertmode', without knowing in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
663 what mode Vim currently is.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
664
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
665 *Q* *mode-Ex* *Ex-mode* *Ex* *EX* *E501*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
666 Q Switch to "Ex" mode. This is a bit like typing ":"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
667 commands one after another, except:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
668 - You don't have to keep pressing ":".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
669 - The screen doesn't get updated after each command.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
670 - There is no normal command-line editing.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
671 - Mappings and abbreviations are not used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
672 In fact, you are editing the lines with the "standard"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
673 line-input editing commands (<Del> or <BS> to erase,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
674 CTRL-U to kill the whole line).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
675 Vim will enter this mode by default if it's invoked as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
676 "ex" on the command-line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
677 Use the ":vi" command |:visual| to exit "Ex" mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
678 Note: In older versions of Vim "Q" formatted text,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
679 that is now done with |gq|. But if you use the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
680 |vimrc_example.vim| script "Q" works like "gq".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
681
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
682 *gQ*
161
6df0106fc595 updated for version 7.0049
vimboss
parents: 39
diff changeset
683 gQ Switch to "Ex" mode like with "Q", but really behave
6df0106fc595 updated for version 7.0049
vimboss
parents: 39
diff changeset
684 like typing ":" commands after another. All command
6df0106fc595 updated for version 7.0049
vimboss
parents: 39
diff changeset
685 line editing, completion etc. is available.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
686 Use the ":vi" command |:visual| to exit "Ex" mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
687 {not in Vi}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
688
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
689 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
690 7. The window contents *window-contents*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
691
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
692 In Normal mode and Insert/Replace mode the screen window will show the current
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
693 contents of the buffer: What You See Is What You Get. There are two
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
694 exceptions:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
695 - When the 'cpoptions' option contains '$', and the change is within one line,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
696 the text is not directly deleted, but a '$' is put at the last deleted
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
697 character.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
698 - When inserting text in one window, other windows on the same text are not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
699 updated until the insert is finished.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
700 {Vi: The screen is not always updated on slow terminals}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
701
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
702 Lines longer than the window width will wrap, unless the 'wrap' option is off
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
703 (see below). The 'linebreak' option can be set to wrap at a blank character.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
704
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
705 If the window has room after the last line of the buffer, Vim will show '~' in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
706 the first column of the last lines in the window, like this: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
707
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
708 +-----------------------+
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
709 |some line |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
710 |last line |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
711 |~ |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
712 |~ |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
713 +-----------------------+
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
714
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
715 Thus the '~' lines indicate that the end of the buffer was reached.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
716
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
717 If the last line in a window doesn't fit, Vim will indicate this with a '@' in
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
718 the first column of the last lines in the window, like this: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
719
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
720 +-----------------------+
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
721 |first line |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
722 |second line |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
723 |@ |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
724 |@ |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
725 +-----------------------+
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
726
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
727 Thus the '@' lines indicate that there is a line that doesn't fit in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
728 window.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
729
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
730 When the "lastline" flag is present in the 'display' option, you will not see
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
731 '@' characters at the left side of window. If the last line doesn't fit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
732 completely, only the part that fits is shown, and the last three characters of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
733 the last line are replaced with "@@@", like this: >
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
734
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
735 +-----------------------+
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
736 |first line |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
737 |second line |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
738 |a very long line that d|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
739 |oesn't fit in the wi@@@|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
740 +-----------------------+
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
741
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
742 If there is a single line that is too long to fit in the window, this is a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
743 special situation. Vim will show only part of the line, around where the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
744 cursor is. There are no special characters shown, so that you can edit all
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
745 parts of this line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
746 {Vi: gives an "internal error" on lines that do not fit in the window}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
747
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
748 The '@' occasion in the 'highlight' option can be used to set special
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
749 highlighting for the '@' and '~' characters. This makes it possible to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
750 distinguish them from real characters in the buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
751
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
752 The 'showbreak' option contains the string to put in front of wrapped lines.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
753
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
754 *wrap-off*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
755 If the 'wrap' option is off, long lines will not wrap. Only the part that
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
756 fits on the screen is shown. If the cursor is moved to a part of the line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
757 that is not shown, the screen is scrolled horizontally. The advantage of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
758 this method is that columns are shown as they are and lines that cannot fit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
759 on the screen can be edited. The disadvantage is that you cannot see all the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
760 characters of a line at once. The 'sidescroll' option can be set to the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
761 minimal number of columns to scroll. {Vi: has no 'wrap' option}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
762
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
763 All normal ASCII characters are displayed directly on the screen. The <Tab>
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
764 is replaced with the number of spaces that it represents. Other non-printing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
765 characters are replaced with "^{char}", where {char} is the non-printing
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
766 character with 64 added. Thus character 7 (bell) will be shown as "^G".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
767 Characters between 127 and 160 are replaced with "~{char}", where {char} is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
768 the character with 64 subtracted. These characters occupy more than one
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
769 position on the screen. The cursor can only be positioned on the first one.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
770
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
771 If you set the 'number' option, all lines will be preceded with their
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
772 number. Tip: If you don't like wrapping lines to mix with the line numbers,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
773 set the 'showbreak' option to eight spaces:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
774 ":set showbreak=\ \ \ \ \ \ \ \ "
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
775
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
776 If you set the 'list' option, <Tab> characters will not be shown as several
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
777 spaces, but as "^I". A '$' will be placed at the end of the line, so you can
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
778 find trailing blanks.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
779
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
780 In Command-line mode only the command-line itself is shown correctly. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
781 display of the buffer contents is updated as soon as you go back to Command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
782 mode.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
783
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
784 The last line of the window is used for status and other messages. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
785 status messages will only be used if an option is on:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
786
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
787 status message option default Unix default ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
788 current mode 'showmode' on on
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
789 command characters 'showcmd' on off
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
790 cursor position 'ruler' off off
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
791
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
792 The current mode is "-- INSERT --" or "-- REPLACE --", see |'showmode'|. The
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
793 command characters are those that you typed but were not used yet. {Vi: does
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
794 not show the characters you typed or the cursor position}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
795
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
796 If you have a slow terminal you can switch off the status messages to speed
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
797 up editing:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
798 :set nosc noru nosm
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
799
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
800 If there is an error, an error message will be shown for at least one second
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
801 (in reverse video). {Vi: error messages may be overwritten with other
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
802 messages before you have a chance to read them}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
803
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
804 Some commands show how many lines were affected. Above which threshold this
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
805 happens can be controlled with the 'report' option (default 2).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
806
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
807 On the Amiga Vim will run in a CLI window. The name Vim and the full name of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
808 the current file name will be shown in the title bar. When the window is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
809 resized, Vim will automatically redraw the window. You may make the window as
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
810 small as you like, but if it gets too small not a single line will fit in it.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
811 Make it at least 40 characters wide to be able to read most messages on the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
812 last line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
813
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
814 On most Unix systems, resizing the window is recognized and handled correctly
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
815 by Vim. {Vi: not ok}
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
816
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
817 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
818 8. Definitions *definitions*
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
819
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
820 screen The whole area that Vim uses to work in. This can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
821 a terminal emulator window. Also called "the Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
822 window".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
823 window A view on a buffer.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
824
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
825 A screen contains one or more windows, separated by status lines and with the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
826 command line at the bottom.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
827
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
828 +-------------------------------+
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
829 screen | window 1 | window 2 |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
830 | | |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
831 | | |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
832 |= status line =|= status line =|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
833 | window 3 |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
834 | |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
835 | |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
836 |==== status line ==============|
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
837 |command line |
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
838 +-------------------------------+
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
839
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
840 The command line is also used for messages. It scrolls up the screen when
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
841 there is not enough room in the command line.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
842
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
843 A difference is made between four types of lines:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
844
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
845 buffer lines The lines in the buffer. This is the same as the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
846 lines as they are read from/written to a file. They
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
847 can be thousands of characters long.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
848 logical lines The buffer lines with folding applied. Buffer lines
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
849 in a closed fold are changed to a single logical line:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
850 "+-- 99 lines folded". They can be thousands of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
851 characters long.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
852 window lines The lines displayed in a window: A range of logical
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
853 lines with wrapping, line breaks, etc. applied. They
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
854 can only be as long as the width of the window allows,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
855 longer lines are wrapped or truncated.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
856 screen lines The lines of the screen that Vim uses. Consists of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
857 the window lines of all windows, with status lines
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
858 and the command line added. They can only be as long
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
859 as the width of the screen allows. When the command
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
860 line gets longer it wraps and lines are scrolled to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
861 make room.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
862
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
863 buffer lines logical lines window lines screen lines ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
864
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
865 1. one 1. one 1. +-- folded 1. +-- folded
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
866 2. two 2. +-- folded 2. five 2. five
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
867 3. three 3. five 3. six 3. six
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
868 4. four 4. six 4. seven 4. seven
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
869 5. five 5. seven 5. === status line ===
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
870 6. six 6. aaa
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
871 7. seven 7. bbb
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
872 8. ccc ccc c
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
873 1. aaa 1. aaa 1. aaa 9. cc
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
874 2. bbb 2. bbb 2. bbb 10. ddd
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
875 3. ccc ccc ccc 3. ccc ccc ccc 3. ccc ccc c 11. ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
876 4. ddd 4. ddd 4. cc 12. === status line ===
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
877 5. ddd 13. (command line)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
878 6. ~
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
879
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
880 ==============================================================================
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
881 vim:tw=78:ts=8:ft=help:norl: