annotate README_dos.txt @ 6693:8faab3792a92 v7.4.671

updated for version 7.4.671 Problem: Warning for shadowing a variable. Solution: Rename off to mb_off. (Kazunobu Kuriyama)
author Bram Moolenaar <bram@vim.org>
date Sat, 21 Mar 2015 14:20:16 +0100
parents 359743c1f59a
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5294
359743c1f59a release version 7.4
Bram Moolenaar <bram@vim.org>
parents: 5247
diff changeset
1 README_dos.txt for version 7.4 of Vim: Vi IMproved.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3 This file explains the installation of Vim on MS-DOS and MS-Windows systems.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 See "README.txt" for general information about Vim.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6 There are two ways to install Vim:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 A. Use the self-installing .exe file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8 B. Unpack .zip files and run the install.exe program.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 A. Using the self-installing .exe
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 ---------------------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 This is mostly self-explaining. Just follow the prompts and make the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15 selections. A few things to watch out for:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 - When an existing installation is detected, you are offered to first remove
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18 this. The uninstall program is then started while the install program waits
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 for it to complete. Sometimes the windows overlap each other, which can be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 confusing. Be sure the complete the uninstalling before continuing the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 installation. Watch the taskbar for uninstall windows.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 - When selecting a directory to install Vim, use the same place where other
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 versions are located. This makes it easier to find your _vimrc file. For
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25 example "C:\Program Files\vim" or "D:\vim". A name ending in "vim" is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 preferred.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 - After selecting the directory where to install Vim, clicking on "Next" will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29 start the installation.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 B. Using .zip files
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33 -------------------
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35 These are the normal steps to install Vim from the .zip archives:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 1. Go to the directory where you want to put the Vim files. Examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38 cd C:\
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 cd D:\editors
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40 If you already have a "vim" directory, go to the directory in which it is
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 located. Check the $VIM setting to see where it points to:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42 set VIM
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 For example, if you have
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 C:\vim\vim54
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45 do
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46 cd C:\
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 Binary and runtime Vim archives are normally unpacked in the same location,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48 on top of each other.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49
5146
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
50 2. Unpack the zip archives. This will create a new directory "vim\vim74",
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 in which all the distributed Vim files are placed. Since the directory
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 name includes the version number, it is unlikely that you overwrite
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 existing files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 Examples:
5146
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
55 pkunzip -d gvim74.zip
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
56 unzip vim74w32.zip
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
57
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
58 You need to unpack the runtime archive and at least one of the binary
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
59 archives. When using more than one binary version, be careful not to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
60 overwrite one version with the other, the names of the executables
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
61 "vim.exe" and "gvim.exe" are the same.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
62
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
63 After you unpacked the files, you can still move the whole directory tree
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
64 to another location. That is where they will stay, the install program
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
65 won't move or copy the runtime files.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
66
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
67 Only for the 32 bit DOS version on MS-DOS without DPMI support (trying to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
68 run install.exe will produce an error message): Unpack the CSDPMI4B.ZIP
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
69 archive and follow the instructions in the documentation.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
70
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
71 3. Change to the new directory:
5146
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
72 cd vim\vim74
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
73 Run the "install.exe" program. It will ask you a number of questions about
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
74 how you would like to have your Vim setup. Among these are:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
75 - You can tell it to write a "_vimrc" file with your preferences in the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
76 parent directory.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
77 - It can also install an "Edit with Vim" entry in the Windows Explorer
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
78 popup menu.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
79 - You can have it create batch files, so that you can run Vim from the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
80 console or in a shell. You can select one of the directories in your
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
81 $PATH. If you skip this, you can add Vim to the search path manually:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
82 The simplest is to add a line to your autoexec.bat. Examples:
5146
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
83 set path=%path%;C:\vim\vim74
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
84 set path=%path%;D:\editors\vim\vim74
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
85 - Create entries for Vim on the desktop and in the Start menu.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
86
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
87 That's it!
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
88
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
89
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
90 Remarks:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
91
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
92 - If Vim can't find the runtime files, ":help" won't work and the GUI version
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
93 won't show a menubar. Then you need to set the $VIM environment variable to
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
94 point to the top directory of your Vim files. Example:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
95 set VIM=C:\editors\vim
5146
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
96 Vim version 7.4 will look for your vimrc file in $VIM, and for the runtime
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
97 files in $VIM/vim74. See ":help $VIM" for more information.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
98
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
99 - To avoid confusion between distributed files of different versions and your
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
100 own modified vim scripts, it is recommended to use this directory layout:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
101 ("C:\vim" is used here as the root, replace it with the path you use)
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
102 Your own files:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
103 C:\vim\_vimrc Your personal vimrc.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
104 C:\vim\_viminfo Dynamic info for 'viminfo'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
105 C:\vim\vimfiles\ftplugin\*.vim Filetype plugins
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
106 C:\vim\... Other files you made.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
107 Distributed files:
5146
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
108 C:\vim\vim74\vim.exe The Vim version 7.4 executable.
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
109 C:\vim\vim74\doc\*.txt The version 7.4 documentation files.
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
110 C:\vim\vim74\bugreport.vim A Vim version 7.4 script.
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
111 C:\vim\vim74\... Other version 7.4 distributed files.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
112 In this case the $VIM environment variable would be set like this:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
113 set VIM=C:\vim
5146
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
114 Then $VIMRUNTIME will automatically be set to "$VIM\vim74". Don't add
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
115 "vim74" to $VIM, that won't work.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
116
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
117 - You can put your Vim executable anywhere else. If the executable is not
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
118 with the other Vim files, you should set $VIM. The simplest is to add a line
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
119 to your autoexec.bat. Examples:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
120 set VIM=c:\vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
121 set VIM=d:\editors\vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
122
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
123 - If you have told the "install.exe" program to add the "Edit with Vim" menu
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
124 entry, you can remove it by running the "uninstal.exe". See
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
125 ":help win32-popup-menu".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
126
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
127 - In Windows 95/98/NT you can create a shortcut to Vim. This works for all
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
128 DOS and Win32 console versions. For the console version this gives you the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
129 opportunity to set defaults for the Console where Vim runs in.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
130
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
131 1. On the desktop, click right to get a menu. Select New/Shortcut.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
132 2. In the dialog, enter Command line: "C:\command.com". Click "Next".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
133 3. Enter any name. Click "Finish".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
134 The new shortcut will appear on the desktop.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
135 4. With the mouse pointer on the new shortcut, click right to get a menu.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
136 Select Properties.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
137 5. In the Program tab, change the "Cmdline" to add "/c" and the name of the
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
138 Vim executable. Examples:
5146
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
139 C:\command.com /c C:\vim\vim74\vim.exe
6ec6b7ff2d43 Vim 7.4a BETA release.
Bram Moolenaar <bram@vim.org>
parents: 2577
diff changeset
140 C:\command.com /c D:\editors\vim\vim74\vim.exe
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
141 6. Select the font, window size, etc. that you like. If this isn't
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
142 possible, select "Advanced" in the Program tab, and deselect "MS-DOS
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
143 mode".
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
144 7. Click OK.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
145
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
146 For gvim, you can use a normal shortcut on the desktop, and set the size of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
147 the Window in your $VIM/_gvimrc:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
148 set lines=30 columns=90
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
149
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
150
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
151 For further information, type one of these inside Vim:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
152 :help dos
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
153 :help msdos
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
154 :help win32