Mercurial > vim
annotate README.txt @ 8897:a410390e340b v7.4.1735
commit https://github.com/vim/vim/commit/451f849fd6282a4facd4f0f58af62837443fb5a6
Author: Bram Moolenaar <Bram@vim.org>
Date: Thu Apr 14 17:16:22 2016 +0200
patch 7.4.1735
Problem: It is not possible to only see part of the message history. It is
not possible to clear messages.
Solution: Add a count to ":messages" and a clear argument. (Yasuhiro
Matsumoto)
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Thu, 14 Apr 2016 17:30:07 +0200 |
parents | 43b5ff7837ea |
children | d07e51166f08 |
rev | line source |
---|---|
5294 | 1 README.txt for version 7.4 of Vim: Vi IMproved. |
0 | 2 |
3 | |
7177
c4d677c50b9b
commit https://github.com/vim/vim/commit/c92399f4ee6d0289dbe5d708d14a84e32f617bd5
Christian Brabandt <cb@256bit.org>
parents:
6918
diff
changeset
|
4 WHAT IS VIM? |
0 | 5 |
8791
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
6 Vim is a greatly improved version of the good old UNIX editor Vi. Many new |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
7 features have been added: multi-level undo, syntax highlighting, command line |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
8 history, on-line help, spell checking, filename completion, block operations, |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
9 script language, etc. There is also a Graphical User Interface (GUI) |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
10 available. Still, Vi compatibility is maintained, those who have Vi "in the |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
11 fingers" will feel at home. See "runtime/doc/vi_diff.txt" for differences with |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
12 Vi. |
0 | 13 |
2564
f85004953416
README and help file updates.
Bram Moolenaar <bram@vim.org>
parents:
2561
diff
changeset
|
14 This editor is very useful for editing programs and other plain text files. |
0 | 15 All commands are given with normal keyboard characters, so those who can type |
16 with ten fingers can work very fast. Additionally, function keys can be | |
8791
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
17 mapped to commands by the user, and the mouse can be used. |
0 | 18 |
8791
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
19 Vim runs under MS-Windows (NT, 2000, XP, Vista, 7, 8, 10), Macintosh, VMS and |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
20 almost all flavours of UNIX. Porting to other systems should not be very |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
21 difficult. Older versions of Vim run on MS-DOS, MS-Windows 95/98/Me, Amiga |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
22 DOS, Atari MiNT, BeOS, RISC OS and OS/2. These are no longer maintained. |
0 | 23 |
24 | |
25 DISTRIBUTION | |
26 | |
7177
c4d677c50b9b
commit https://github.com/vim/vim/commit/c92399f4ee6d0289dbe5d708d14a84e32f617bd5
Christian Brabandt <cb@256bit.org>
parents:
6918
diff
changeset
|
27 You can often use your favorite package manager to install Vim. On Mac and |
c4d677c50b9b
commit https://github.com/vim/vim/commit/c92399f4ee6d0289dbe5d708d14a84e32f617bd5
Christian Brabandt <cb@256bit.org>
parents:
6918
diff
changeset
|
28 Linux a small version of Vim is pre-installed, you still need to install Vim |
c4d677c50b9b
commit https://github.com/vim/vim/commit/c92399f4ee6d0289dbe5d708d14a84e32f617bd5
Christian Brabandt <cb@256bit.org>
parents:
6918
diff
changeset
|
29 if you want more features. |
c4d677c50b9b
commit https://github.com/vim/vim/commit/c92399f4ee6d0289dbe5d708d14a84e32f617bd5
Christian Brabandt <cb@256bit.org>
parents:
6918
diff
changeset
|
30 |
0 | 31 There are separate distributions for Unix, PC, Amiga and some other systems. |
32 This README.txt file comes with the runtime archive. It includes the | |
33 documentation, syntax files and other files that are used at runtime. To run | |
34 Vim you must get either one of the binary archives or a source archive. | |
35 Which one you need depends on the system you want to run it on and whether you | |
36 want or must compile it yourself. Check "http://www.vim.org/download.php" for | |
37 an overview of currently available distributions. | |
38 | |
39 | |
8791
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
40 COMPILING |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
41 |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
42 If you obtained a binary distribution you don't need to compile Vim. If you |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
43 obtained a source distribution, all the stuff for compiling Vim is in the |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
44 "src" directory. See src/INSTALL for instructions. |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
45 |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
46 |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
47 INSTALLATION |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
48 |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
49 See one of these files for system-specific instructions. Either in the |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
50 READMEdir directory (in the repository) or the top directory (if you unpack an |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
51 archive): |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
52 |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
53 README_ami.txt Amiga |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
54 README_unix.txt Unix |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
55 README_dos.txt MS-DOS and MS-Windows |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
56 README_mac.txt Macintosh |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
57 README_vms.txt VMS |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
58 |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
59 There are more README_*.txt files, depending on the distribution you used. |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
60 |
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
61 |
0 | 62 DOCUMENTATION |
63 | |
8791
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
64 The Vim tutor is a one hour training course for beginners. Often it can be |
2564
f85004953416
README and help file updates.
Bram Moolenaar <bram@vim.org>
parents:
2561
diff
changeset
|
65 started as "vimtutor". See ":help tutor" for more information. |
f85004953416
README and help file updates.
Bram Moolenaar <bram@vim.org>
parents:
2561
diff
changeset
|
66 |
0 | 67 The best is to use ":help" in Vim. If you don't have an executable yet, read |
68 "runtime/doc/help.txt". It contains pointers to the other documentation | |
69 files. The User Manual reads like a book and is recommended to learn to use | |
70 Vim. See ":help user-manual". | |
71 | |
72 | |
73 COPYING | |
74 | |
75 Vim is Charityware. You can use and copy it as much as you like, but you are | |
2564
f85004953416
README and help file updates.
Bram Moolenaar <bram@vim.org>
parents:
2561
diff
changeset
|
76 encouraged to make a donation to help orphans in Uganda. Please read the file |
0 | 77 "runtime/doc/uganda.txt" for details (do ":help uganda" inside Vim). |
78 | |
79 Summary of the license: There are no restrictions on using or distributing an | |
80 unmodified copy of Vim. Parts of Vim may also be distributed, but the license | |
81 text must always be included. For modified versions a few restrictions apply. | |
82 The license is GPL compatible, you may compile Vim with GPL libraries and | |
83 distribute it. | |
84 | |
85 | |
86 SPONSORING | |
87 | |
826 | 88 Fixing bugs and adding new features takes a lot of time and effort. To show |
89 your appreciation for the work and motivate Bram and others to continue | |
90 working on Vim please send a donation. | |
0 | 91 |
826 | 92 Since Bram is back to a paid job the money will now be used to help children |
93 in Uganda. See runtime/doc/uganda.txt. But at the same time donations | |
94 increase Bram's motivation to keep working on Vim! | |
0 | 95 |
96 For the most recent information about sponsoring look on the Vim web site: | |
826 | 97 |
0 | 98 http://www.vim.org/sponsor/ |
99 | |
100 | |
8791
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
101 CONTRIBUTING |
0 | 102 |
8791
43b5ff7837ea
commit https://github.com/vim/vim/commit/d18cfb7dbfd32af729d3ac5136f77dcdbefe5dee
Christian Brabandt <cb@256bit.org>
parents:
7437
diff
changeset
|
103 If you would like to help making Vim better, see the CONTRIBUTING.md file. |
2564
f85004953416
README and help file updates.
Bram Moolenaar <bram@vim.org>
parents:
2561
diff
changeset
|
104 |
0 | 105 |
106 INFORMATION | |
107 | |
108 The latest news about Vim can be found on the Vim home page: | |
109 http://www.vim.org/ | |
110 | |
6918 | 111 If you have problems, have a look at the Vim documentation or tips: |
112 http://www.vim.org/docs.php | |
113 http://vim.wikia.com/wiki/Vim_Tips_Wiki | |
0 | 114 |
3941 | 115 If you still have problems or any other questions, use one of the mailing |
116 lists to discuss them with Vim users and developers: | |
3935 | 117 http://www.vim.org/maillist.php |
118 | |
119 If nothing else works, report bugs directly: | |
0 | 120 Bram Moolenaar <Bram@vim.org> |
121 | |
122 | |
123 MAIN AUTHOR | |
124 | |
2502
e6420d275b6a
Update README files. Remove references to extra and lang archives.
Bram Moolenaar <bram@vim.org>
parents:
2490
diff
changeset
|
125 Send any other comments, patches, flowers and suggestions to: |
0 | 126 |
127 Bram Moolenaar E-mail: Bram@vim.org |