annotate src/INSTALLpc.txt @ 6929:e55929fca0cf v7.4.783

patch 7.4.783 Problem: copy_chars() and copy_spaces() are inefficient. Solution: Use memset() instead. (Dominique Pelle)
author Bram Moolenaar <bram@vim.org>
date Fri, 17 Jul 2015 13:22:51 +0200
parents 112c80234ce3
children 2c5e813e8852
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1 INSTALLpc.txt - Installation of Vim on PC
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3 This file contains instructions for compiling Vim. If you already have an
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 executable version of Vim, you don't need this.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
6 More information can be found here: (Very stale now.)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
8 http://mywebpage.netscape.com/sharppeople/vim/howto/
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 The file "feature.h" can be edited to match your preferences. You can skip
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 this, then you will get the default behavior as is documented, which should
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12 be fine for most people.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
14 With the exception of two sections (Windows 3.1 and MS-DOS), this document
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
15 assumes that you are building Vim for Win32 or later.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
16 (Windows 95/98/Me/NT/2000/XP/2003/Vista/7)
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
17
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 Contents:
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
20 1. Microsoft Visual C++
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
21 2. Using MinGW
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
22 3. Cygwin
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
23 4. Borland
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
24 5. Cross compiling for Win32 from a Linux machine
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
25 6. Building with Python support
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
26 7. Building with MzScheme support
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
27 8. Windows 3.1
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
28 9. MS-DOS
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
29
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
30 10. Installing after building from sources
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
31
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
32
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
33 The currently preferred method is using the free Visual C++ Toolkit 2008
2871
82cd9f1e8d6b updated for version 7.3.209
Bram Moolenaar <bram@vim.org>
parents: 2217
diff changeset
34 |msvc-2008-express|, the produced binary runs on most MS-Windows systems. If
82cd9f1e8d6b updated for version 7.3.209
Bram Moolenaar <bram@vim.org>
parents: 2217
diff changeset
35 you need the executable to run on Windows 98 or ME, use the 2003 one
82cd9f1e8d6b updated for version 7.3.209
Bram Moolenaar <bram@vim.org>
parents: 2217
diff changeset
36 |msvc-2003-toolkit|.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
37
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
38
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
39 1. Microsoft Visual C++
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
40 =======================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
41
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
42 Visual Studio
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
43 -------------
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
44
1608
152883db0edf updated for version 7.1-321
vimboss
parents: 1569
diff changeset
45 Building with Visual Studio (VS 98, VS .NET, VS .NET 2003, VS 2005, and VS 2008)
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
46 is straightforward. (These instructions should also work for VS 4 and VS 5.)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
47
3847
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
48 Using VS C++ 2008 Express is recommended, the binaries build with that run on
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
49 nearly all platforms. Binaries from later versions may not run on Windows 95
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
50 or XP.
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
51
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
52 To build Vim from the command line with MSVC, use Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
53 Visual Studio installed a batch file called vcvars32.bat, which you must
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
54 run to set up paths for nmake and MSVC.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
55
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
56 nmake -f Make_mvc.mak console Win32 SDK or Microsoft Visual C++
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
57 nmake -f Make_mvc.mak GUI=yes GUI Microsoft Visual C++
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
58 nmake -f Make_mvc.mak OLE=yes OLE Microsoft Visual C++
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
59 nmake -f Make_mvc.mak PERL=C:\Perl PYTHON=C:\Python etc.
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
60 Perl, Python, etc.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
61
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
62 Make_mvc.mak allows a Vim to be built with various different features and
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
63 debug support. Debugging with MS Devstudio is provided by Make_dvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
64 For a description of the use of Make_dvc.mak, look in Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
65
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
66 For compiling Gvim with IME support on far-east Windows, add IME=yes
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
67 to the parameters you pass to Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
68
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
69 To build Vim from within the Visual Studio IDE, open the Make_ivc.mak project.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
70 (Note: Make_ivc.mak is not as rich as Make_mvc.mak, which allows for
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
71 far more configuration.) Make_ivc.mak can also be built with nmake.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
72
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
73 nmake -f Make_ivc.mak CFG="Vim - Win32 Release gvim"
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
74 GUI Microsoft Visual C++ 4.x or later
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
75 nmake -f Make_ivc.mak CFG="Vim - Win32 Release gvim OLE"
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
76 OLE Microsoft Visual C++ 4.x or later
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
77
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
78 See the specific files for comments and options.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
79
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
80 These files have been supplied by George V. Reilly, Ben Singer, Ken Scott and
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
81 Ron Aaron; they have been tested.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
82
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
83
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
84 Visual C++ Toolkit 2003 *msvc-2003-toolkit*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
85 -----------------------
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
86
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
87 You could download the Microsoft Visual C++ Toolkit 2003 from
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
88 http://msdn.microsoft.com/visualc/vctoolkit2003/
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
89 Unfortunately this URL is no longer valid. Inofficial downloads appear to be
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
90 available from links mentioned on these pages (use at your own risk):
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
91 http://www.filewatcher.com/m/VCToolkitSetup.exe.32952488.0.0.html
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
92 http://feargame.net/wiki/index.php?title=Building_Source_with_the_VC2003_Toolkit
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
93
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
94 This contains the command-line tools (compiler, linker, CRT headers,
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
95 and libraries) for Visual Studio .NET 2003, but not the Visual Studio IDE.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
96 To compile and debug Vim with the VC2003 Toolkit, you will also need
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
97 |ms-platform-sdk|, |dotnet-1.1-redist|, |dotnet-1.1-sdk|,
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
98 and |windbg-download|.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
99
1569
9fbb40a1228a updated for version 7.1-282
vimboss
parents: 856
diff changeset
100 It's easier to download Visual C++ 2008 Express Edition, |msvc-2008-express|,
9fbb40a1228a updated for version 7.1-282
vimboss
parents: 856
diff changeset
101 which is freely available in perpetuity.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
102
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
103 The free Code::Blocks IDE works with the VC2003 Toolkit, as described at
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
104 http://wiki.codeblocks.org/index.php?title=Integrating_Microsoft_Visual_Toolkit_2003_with_Code::Blocks_IDE
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
105 (This site also takes you through configuring a number of other
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
106 free C compilers for Win32.)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
107
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
108 To compile Vim using the VC2003 Toolkit and Make_mvc.mak, you must first
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
109 execute the following commands in a cmd.exe window (the msvcsetup.bat batch
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
110 file can be used):
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
111
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
112 set PATH=%SystemRoot%\Microsoft.NET\Framework\v1.1.4322;%PATH%
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
113 call "%VCToolkitInstallDir%vcvars32.bat"
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
114 set MSVCVer=7.1
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
115 call "%ProgramFiles%\Microsoft Platform SDK\SetEnv.Cmd"
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
116 set LIB=%ProgramFiles%\Microsoft Visual Studio .NET 2003\Vc7\lib;%LIB%
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
117
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
118 Now you can build Vim with Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
119
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
120
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
121 Getting the Windows Platform SDK *ms-platform-sdk*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
122
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
123 You will also need a copy of the Windows Platform SDK from
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
124 http://www.microsoft.com/msdownload/platformsdk/sdkupdate/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
125 Specifically, you need the Windows Core SDK subset of the Platform SDK,
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
126 which contains the Windows headers and libraries.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
127
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
128
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
129 Getting the .NET Framework 1.1 Runtime *dotnet-1.1-redist*
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
130
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
131 You need the .NET Framework 1.1 Redistributable Package from
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
132 http://www.microsoft.com/downloads/details.aspx?familyid=262d25e3-f589-4842-8157-034d1e7cf3a3
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
133 or from Windows Update:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
134 http://windowsupdate.microsoft.com/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
135 This is needed to install |dotnet-1.1-sdk|. It also contains cvtres.exe,
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
136 which is needed to link Vim.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
137
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
138
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
139 Getting the .NET Framework 1.1 SDK *dotnet-1.1-sdk*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
140
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
141 You need the .NET Framework 1.1 SDK from
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
142 http://www.microsoft.com/downloads/details.aspx?familyid=9b3a2ca6-3647-4070-9f41-a333c6b9181d
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
143 This contains some additional libraries needed to compile Vim,
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
144 such as msvcrt.lib. You must install |dotnet-1.1-redist| before
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
145 installing the .NET 1.1 SDK.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
146
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
147
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
148 Getting the WinDbg debugger *windbg-download*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
149
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
150 The Debugging Tools for Windows can be downloaded from
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
151 http://www.microsoft.com/whdc/devtools/debugging/default.mspx
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
152 This includes the WinDbg debugger, which you will want if you ever need
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
153 to debug Vim itself. An earlier version of the Debugging Tools
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
154 is also available through the Platform SDK, |ms-platform-sdk|.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
155
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
156
1608
152883db0edf updated for version 7.1-321
vimboss
parents: 1569
diff changeset
157 Visual C++ 2005 Express Edition *msvc-2005-express*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
158 -------------------------------
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
159
838
8e5830943bff updated for version 7.0e04
vimboss
parents: 714
diff changeset
160 Visual C++ 2005 Express Edition can be downloaded for free from:
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
161 http://msdn.microsoft.com/vstudio/express/visualC/default.aspx
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
162 This includes the IDE and the debugger. You will also need
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
163 |ms-platform-sdk|. You can build Vim with Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
164
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
165 Instructions for integrating the Platform SDK into VC Express:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
166 http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/default.aspx
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
167
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
168
1569
9fbb40a1228a updated for version 7.1-282
vimboss
parents: 856
diff changeset
169 Visual C++ 2008 Express Edition *msvc-2008-express*
9fbb40a1228a updated for version 7.1-282
vimboss
parents: 856
diff changeset
170 -------------------------------
9fbb40a1228a updated for version 7.1-282
vimboss
parents: 856
diff changeset
171
9fbb40a1228a updated for version 7.1-282
vimboss
parents: 856
diff changeset
172 Visual C++ 2008 Express Edition can be downloaded for free from:
2217
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
173 http://www.microsoft.com/express/downloads/
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
174 This includes the IDE and the debugger.
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
175
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
176 To set the environment execute the msvc2008.bat script. You can then build
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
177 Vim with Make_mvc.mak.
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
178
3847
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
179 For building 64 bit binaries you also need to install the SDK:
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
180 "Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1"
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
181 You don't need the examples and documentation.
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
182
2217
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
183
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
184 Visual C++ 2010 Express Edition *msvc-2010-express*
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
185 -------------------------------
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
186
120502692d82 Improve the MS-Windows installer.
Bram Moolenaar <bram@vim.org>
parents: 2098
diff changeset
187 Visual C++ 2010 Express Edition can be downloaded for free from:
1619
b9740fb41986 updated for version 7.2a
vimboss
parents: 1608
diff changeset
188 http://www.microsoft.com/express/vc/Default.aspx
b9740fb41986 updated for version 7.2a
vimboss
parents: 1608
diff changeset
189 This includes the IDE and the debugger.
1569
9fbb40a1228a updated for version 7.1-282
vimboss
parents: 856
diff changeset
190
2871
82cd9f1e8d6b updated for version 7.3.209
Bram Moolenaar <bram@vim.org>
parents: 2217
diff changeset
191 To set the environment execute the msvc2010.bat script. You can then build
1619
b9740fb41986 updated for version 7.2a
vimboss
parents: 1608
diff changeset
192 Vim with Make_mvc.mak.
1608
152883db0edf updated for version 7.1-321
vimboss
parents: 1569
diff changeset
193
152883db0edf updated for version 7.1-321
vimboss
parents: 1569
diff changeset
194
6149
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
195 Targeting Windows XP with new MSVC *new-msvc-windows-xp*
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
196 ----------------------------------
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
197
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
198 Beginning with Visual C++ 2010, Microsoft changed the behavior of LINK.EXE
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
199 so that it targets Windows 6.0 (Vista) by default. In order to override
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
200 this, the target Windows version number needs to be passed to LINK like
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
201 follows:
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
202 LINK ... /subsystem:console,5.01
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
203
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
204 Make_mvc.mak now supports a macro SUBSYSTEM_VER to pass the Windows version.
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
205 Use lines like follows to target Windows XP (assuming using Visual C++ 2012
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
206 under 64-bit Windows):
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
207 set WinSdk71=%ProgramFiles(x86)%\Microsoft SDKs\Windows\v7.1A
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
208 set SDK_INCLUDE_DIR=%WinSdk71%\Include
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
209 set INCLUDE=%WinSdk71%\Include;%INCLUDE%
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
210 set LIB=%WinSdk71%\Lib;%LIB%
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
211 set PATH=%WinSdk71%\Bin;%PATH%
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
212 set CL=/D_USING_V110_SDK71_
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
213 nmake -f Make_mvc.mak ... WINVER=0x0501 SUBSYSTEM_VER=5.01
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
214
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
215 The following Visual C++ team blog can serve as a reference page:
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
216 http://blogs.msdn.com/b/vcblog/archive/2012/10/08/windows-xp-targeting-with-c-in-visual-studio-2012.aspx
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
217
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
218
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
219 2. MinGW
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
220 ========
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
221
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
222 (written by Ron Aaron: <ronaharon@yahoo.com>)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
223
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
224 This is about how to produce a Win32 binary of gvim with MinGW.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
225
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
226 First, you need to get the 'mingw32' compiler, which is free for the download
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
227 at:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
228
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
229 http://www.mingw.org/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
230
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
231 or you can use 'MinGW-w64' compiler.
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
232
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
233 http://mingw-w64.sourceforge.net/
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
234
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
235 Once you have downloaded the compiler binaries, unpack them on your hard disk
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
236 somewhere, and put them on your PATH. If you are on Win95/98 you can edit
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
237 your AUTOEXEC.BAT file with a line like:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
238
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
239 set PATH=C:\MinGW\bin;%PATH%
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
240
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
241 or on NT/2000/XP, go to the Control Panel, (Performance and Maintenance),
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
242 System, Advanced, and edit the environment from there.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
243
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
244 Test if gcc is on your path. From a CMD (or COMMAND on '95/98) window:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
245
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
246 C:\> gcc --version
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
247 gcc (GCC) 4.8.1
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
248
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
249 C:\> mingw32-make --version
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
250 GNU Make 3.82.90 (...etc...)
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
251
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
252 Now you are ready to rock 'n' roll. Unpack the vim sources (look on
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
253 www.vim.org for exactly which version of the vim files you need).
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
254
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
255 Change directory to 'vim\src':
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
256
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
257 C:\> cd vim\src
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
258 C:\VIM\SRC>
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
259
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
260 and you type:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
261
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
262 mingw32-make -f Make_ming.mak gvim.exe
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
263
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
264 After churning for a while, you will end up with 'gvim.exe' in the 'vim\src'
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
265 directory.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
266
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
267 You should not need to do *any* editing of any files to get vim compiled this
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
268 way. If, for some reason, you want the console-mode-only version of vim (this
2098
3259c3923c1e Updated runtime an documentation files.
Bram Moolenaar <bram@zimbu.org>
parents: 2088
diff changeset
269 is NOT recommended on Win32, especially on '95/'98!!!), you can use:
2035
ca7d02cd5e49 Minor text file updates.
Bram Moolenaar <bram@zimbu.org>
parents: 1668
diff changeset
270
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
271 mingw32-make -f Make_ming.mak GUI=no vim.exe
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
272
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
273 If you are dismayed by how big the EXE is, I strongly recommend you get 'UPX'
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
274 (also free!) and compress the file (typical compression is 50%). UPX can be
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
275 found at
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
276 http://www.upx.org/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
277
3388
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
278 As of 2011, UPX still does not support compressing 64-bit EXE's; if you have
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
279 built a 64-bit vim then an alternative to UPX is 'MPRESS'. MPRESS can be found
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
280 at:
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
281 http://www.matcode.com/mpress.htm
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
282
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
283
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
284 ADDITION: NLS support with MinGW
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
285
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
286 (by Eduardo F. Amatria <eferna1@platea.pntic.mec.es>)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
287
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
288 If you want National Language Support, read the file src/po/README_mingw.txt.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
289 You need to uncomment lines in Make_ming.mak to have NLS defined.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
290
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
291
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
292 3. Cygwin
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
293 =========
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
294
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
295 Use Make_cyg.mak with Cygwin's GCC. See
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
296 http://users.skynet.be/antoine.mechelynck/vim/compile.htm
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
297
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
298 With Cygnus gcc you should use the Unix Makefile instead (you need to get the
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
299 Unix archive then). Then you get a Cygwin application (feels like Vim is
2088
4ec11bb387a5 updated for version 7.2.372
Bram Moolenaar <bram@zimbu.org>
parents: 2035
diff changeset
300 running on Unix), while with Make_cyg.mak you get a Windows application (like
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
301 with the other makefiles).
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
302
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
303
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
304 4. Borland
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
305 ===========
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
306
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
307 Use Make_bc5.mak with Borland C++ 5.x. See
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
308 http://users.skynet.be/antoine.mechelynck/vim/compile.htm
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
309
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
310
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
311 5. Cross compiling for Win32 from a Linux machine
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
312 =================================================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
313
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
314 [Update of 1) needs to be verified]
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
315
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
316 If you like, you can compile the 'mingw' Win32 version from the comfort of
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
317 your Linux (or other unix) box. To do this, you need to follow a few steps:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
318 1) Install the mingw32 cross-compiler. See
2035
ca7d02cd5e49 Minor text file updates.
Bram Moolenaar <bram@zimbu.org>
parents: 1668
diff changeset
319 http://www.mingw.org/wiki/LinuxCrossMinGW
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
320 http://www.libsdl.org/extras/win32/cross/README.txt
1619
b9740fb41986 updated for version 7.2a
vimboss
parents: 1608
diff changeset
321 2) Get and unpack both the Unix sources and the extra archive
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
322 3) in 'Make_cyg_ming.mak', set 'CROSS' to 'yes' instead of 'no'.
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
323 Make further changes to 'Make_cyg_ming.mak' and 'Make_ming.mak' as you
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
324 wish. If your cross-compiler prefix differs from the predefined value,
2035
ca7d02cd5e49 Minor text file updates.
Bram Moolenaar <bram@zimbu.org>
parents: 1668
diff changeset
325 set 'CROSS_COMPILE' corresponding.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
326 4) make -f Make_ming.mak gvim.exe
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
327
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
328 Now you have created the Windows binary from your Linux box! Have fun...
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
329
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
330
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
331 6. Building with Python support
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
332 ===============================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
333
3847
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
334 For building with MSVC 2008 the "Windows Installer" from www.python.org
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
335 works fine.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
336
3847
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
337 (rest written by Ron Aaron: <ronaharon@yahoo.com>)
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
338
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
339 Building with the mingw32 compiler, and the ActiveState ActivePython:
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
340 http://www.ActiveState.com/Products/ActivePython/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
341
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
342 After installing the ActivePython, you will have to create a 'mingw32'
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
343 'libpython20.a' to link with:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
344 cd $PYTHON/libs
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
345 pexports python20.dll > python20.def
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
346 dlltool -d python20.def -l libpython20.a
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
347
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
348 Once that is done, edit the 'Make_ming.mak' so the PYTHON variable points to
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
349 the root of the Python installation (C:\Python20, for example). If you are
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
350 cross-compiling on Linux with the mingw32 setup, you need to also convert all
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
351 the 'Include' files to *unix* line-endings. This bash command will do it
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
352 easily:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
353 for fil in *.h ; do vim -e -c 'set ff=unix|w|q' $fil
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
354
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
355 Now just do:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
356 make -f Make_ming.mak gvim.exe
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
357
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
358 and you will end up with a Python-enabled, Win32 version. Enjoy!
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
359
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
360
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
361 7. Building with MzScheme support
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
362 =================================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
363
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
364 (written by Sergey Khorev <sergey.khorev@gmail.com>)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
365
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
366 Vim with MzScheme (http://www.plt-scheme.org/software/mzscheme) support can
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
367 be built with either MSVC, or MinGW, or Cygwin. Supported versions are 205 and
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
368 above (including 299 and 30x series).
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
369
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
370 The MSVC build is quite straightforward. Simply invoke (in one line)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
371 nmake -fMake_mvc.mak MZSCHEME=<Path-to-MzScheme>
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
372 [MZSCHEME_VER=<MzScheme-version>] [DYNAMIC_MZSCHEME=<yes or no>]
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
373 where <MzScheme-version> is the last seven characters from MzScheme dll name
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
374 (libmzschXXXXXXX.dll).
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
375 If DYNAMIC_MZSCHEME=yes, resulting executable will not depend on MzScheme
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
376 DLL's, but will load them in runtime on demand.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
377
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
378 Building dynamic MzScheme support on MinGW and Cygwin is similar. Take into
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
379 account that <Path-to-MzScheme> should contain slashes rather than backslashes
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
380 (e.g. d:/Develop/MzScheme)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
381
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
382 "Static" MzScheme support (Vim executable will depend on MzScheme DLLs
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
383 explicitly) on MinGW and Cygwin requires additional step.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
384
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
385 libmzschXXXXXXX.dll and libmzgcXXXXXXX.dll should be copied from
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
386 %WINDOWS%\System32 to other location (either build directory, some temporary
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
387 dir or even MzScheme home).
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
388
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
389 Pass that path as MZSCHEME_DLLS parameter for Make. E.g.,
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
390 make -f Make_cyg.mak MZSCHEME=d:/Develop/MzScheme MZSCHEME_VER=209_000
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
391 MZSCHEME_DLLS=c:/Temp DYNAMIC_MZSCHEME=no
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
392
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
393 After a successful build, these dlls can be freely removed, leaving them in
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
394 %WINDOWS%\System32 only.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
395
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
396
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
397 8. Windows 3.1x
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
398 ===============
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
399
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
400 make -f Make_w16.mak 16 bit, Borland C++ 5.0
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
401
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
402 Warning: Be sure to use the right make.exe. It should be Borland make.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
403
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
404 You will almost certainly have to change the paths for libs and include files
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
405 in the Makefile. Look for "D:\BC5" and "ctl3dv2". You will get a number of
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
406 warnings which can be ignored ( _chmod, precompiled header files, and
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
407 "possibly incorrect assignment").
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
408
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
409 The makefile should also work for BC++ 4.0 and 4.5, but may need tweaking to
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
410 remove unsupported compiler & liker options.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
411
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
412 For making the Win32s version, you need Microsoft Visual C++ 4.1 OR EARLIER.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
413 In MSVC 4.2 support for Win32s was dropped! Use this command:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
414 nmake -f Make_mvc.mak GUI=yes
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
415
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
416
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
417 9. MS-DOS
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
418 =========
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
419
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
420 Summary:
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
421 ren Make_bc3.mak Makefile; make 16 bit, Borland C++ and Turbo C++
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
422 ren Make_tcc.mak Makefile; make 16 bit, Turbo C
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
423 make -f Make_djg.mak 32 bit, DJGPP 2.0
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
424 make -f Make_bc5.mak 32 bit, Borland C++ 5.x (edit it to
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
425 define DOS)
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
426
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
427 Warning: Be sure to use the right make.exe. Microsoft C make doesn't work;
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
428 Borland make only works with Make_bc3.mak, Make_bc5.mak and Make_tcc.mak;
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
429 DJGPP/GNU make must be used for Make_djg.mak.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
430
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
431 The Borland C++ compiler has been used to generate the MS-DOS executable; it
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
432 should work without problems. You will probably have to change the paths for
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
433 LIBPATH and INCLUDEPATH in the start of the Makefile. You will get two
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
434 warnings which can be ignored (one about _chmod and one about precompiled
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
435 header files).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
436
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
437 The "spawno" library by Ralf Brown was used in order to free memory when Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
438 starts a shell or other external command. Only about 200 bytes are taken from
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
439 conventional memory. When recompiling get the spawno library from Simtel,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
440 directory "msdos/c". It is called something like "spwno413.zip". Or follow
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
441 the instructions in the Makefile to remove the library.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
442
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
443 The Turbo C Makefile has not been tested much lately. It is included for those
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
444 that don't have C++. You may need to make a few changes to get it to work.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
445
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
446 DJGPP needs to be installed properly to compile Vim; you need a lot of things
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
447 before it works. When your setup is OK, Vim should compile with just one
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
448 warning (about an argument to signal()).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
449
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
450 Make_bc5.mak is for those that have Borland C++ 5.0 or later. At the top of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
451 the file, there are some variables you can change to make either a 32-bit
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
452 Windows exe (GUI or console mode), or a 16-bit MS-DOS version.
39
410fa1a31baf updated for version 7.0023
vimboss
parents: 7
diff changeset
453 NOTE: multi-byte support is broken in the Borland libraries, not everything
410fa1a31baf updated for version 7.0023
vimboss
parents: 7
diff changeset
454 will work properly! Esp. handling multi-byte file names.
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
455
2965
f2de38a019a2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2951
diff changeset
456 If you get all kinds of strange error messages when compiling, try changing
f2de38a019a2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2951
diff changeset
457 the file format from "unix" to "dos".
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
458
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
459
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
460 10. Installing after building from sources
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
461 ==========================================
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
462
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
463 [provided by Michael Soyka]
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
464
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
465 After you've built the Vim binaries as described above, you're ready to
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
466 install Vim on your system. However, if you've obtained the Vim sources
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
467 using Mercurial or by downloading them as a unix tar file, you must first
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
468 create a "vim73" directory. If you instead downloaded the sources as
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
469 zip files, you can skip this setup as the zip archives already have the
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
470 correct directory structure.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
471
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
472 A. Create a Vim "runtime" subdirectory named "vim73"
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
473 -----------------------------------------------------
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
474 If you obtained your Vim sources as zip files, you can skip this step.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
475 Otherwise, continue reading.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
476
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
477 Go to the directory that contains the Vim "src" and "runtime"
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
478 directories and create a new subdirectory named "vim73".
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
479
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
480 Copy the "runtime" files into "vim73":
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
481 copy runtime\* vim73
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
482
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
483 B. Copy the new binaries into the "vim73" directory
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
484 ----------------------------------------------------
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
485 Regardless of how you installed the Vim sources, you need to copy the
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
486 new binaries you created above into "vim73":
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
487
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
488 copy src\*.exe vim73
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
489 copy src\GvimExt\gvimext.dll vim73
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
490 copy src\xxd\xxd.exe vim73
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
491
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
492 C. Move the "vim73" directory into the Vim installation subdirectory
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
493 ---------------------------------------------------------------------
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
494 Move the "vim73" subdirectory into the subdirectory where you want Vim
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
495 to be installed. Typically, this subdirectory will be named "vim".
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
496 If you already have a "vim73" subdirectory in "vim", delete it first
2965
f2de38a019a2 Updated runtime files.
Bram Moolenaar <bram@vim.org>
parents: 2951
diff changeset
497 by running its uninstal.exe program.
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
498
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
499 D. Install Vim
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
500 ---------------
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
501 "cd" to your Vim installation subdirectory "vim\vim73" and run the
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
502 "install.exe" program. It will ask you a number of questions about
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
503 how you would like to have your Vim setup. Among these are:
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
504 - You can tell it to write a "_vimrc" file with your preferences in the
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
505 parent directory.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
506 - It can also install an "Edit with Vim" entry in the Windows Explorer
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
507 popup menu.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
508 - You can have it create batch files, so that you can run Vim from the
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
509 console or in a shell. You can select one of the directories in your
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
510 PATH or add the directory to PATH using the Windows Control Panel.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
511 - Create entries for Vim on the desktop and in the Start menu.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
512
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
513 Happy Vimming!