Mercurial > vim

annotate src/INSTALLpc.txt @ 12610:c6dc5d62cf5e v8.0.1183

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
patch 8.0.1183: MS-Windows build instructions are outdated commit https://github.com/vim/vim/commit/18cfa940e2bbf657e8f90e6486812876198ef963 Author: Bram Moolenaar <Bram@vim.org> Date: Sun Oct 8 17:58:44 2017 +0200 patch 8.0.1183: MS-Windows build instructions are outdated Problem: MS-Windows build instructions are outdated. Solution: Update instructions for MSVC 2015. Update the build script.
author Christian Brabandt <cb@256bit.org>
date Sun, 08 Oct 2017 18:00:05 +0200
parents 590424e87b65
children cd41d47e6033
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
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
6 You can find the lastest here: https://github.com/vim/vim-win32-installer
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
7 This page also has links to install support for interfaces such as Perl,
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
8 Python, Lua, etc.
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
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
14 This document assumes that you are building Vim for Win32 or later (Windows
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
15 XP/2003/Vista/7/8/10). There are also instructions for pre-XP systems, but
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
16 they might no longer work.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
17
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
18 The recommended way is to build a 32 bit Vim, also on 64 bit systems. You can
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
19 build a 64 bit Vim if you like, the executable will be bigger and Vim wan't be
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
20 any faster, but you can edit files larger than 2 Gbyte.
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
21
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 Contents:
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
24 1. Microsoft Visual C++
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
25 2. Using MinGW
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
26 3. Cygwin
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
27 4. Borland
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
28 5. Cross compiling for Win32 from a Linux machine
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
29 6. Building with Python support
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
30 7. Building with Python3 support
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
31 8. Building with Racket or MzScheme support
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
32 9. Building with Lua support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
33 10. Building with Perl support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
34 11. Building with Ruby support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
35 12. Building with Tcl support
11719
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
36 13. Building with Terminal support
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
37 14. Windows 3.1
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
38 15. MS-DOS
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
39
11719
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
40 16. Installing after building from sources
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
41
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
42
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
43 The currently recommended way (that means it has been verified to work) is
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
44 using the "Visual Studio Community 2015" installation. This includes the SDK
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
45 needed to target Windows XP. But not older Windows versions (95, 97), see
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
46 |msvc-2008-express| below for that
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
47
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
48
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
49 1. Microsoft Visual C++
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
50 =======================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
51
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
52 We do not provide download links, since Microsoft keeps changing them. You
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
53 can search for "Visual Studio Community 2015", for example. You will need to
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
54 create a Microsoft account (it's free).
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
55
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
56
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
57 Visual Studio
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
58 -------------
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
59
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
60 Building with Visual Studio (VS 98, VS .NET, VS .NET 2003, VS 2005, VS 2008,
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
61 VS2010, VS2012, VS2013 and VS2015) is straightforward. (These instructions
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
62 should also work for VS 4 and VS 5.)
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
63
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
64 Using VS C++ 2008 Express is recommended if you need the binary to run on
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
65 Windows 95 or 97, see |msvc-2008-express| below.
3847
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
66
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
67 To build Vim from the command line with MSVC, use Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
68 Visual Studio installed a batch file called vcvars32.bat, which you must
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
69 run to set up paths for nmake and MSVC.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
70
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
71 nmake -f Make_mvc.mak console Win32 SDK or Microsoft Visual C++
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
72 nmake -f Make_mvc.mak GUI=yes GUI Microsoft Visual C++
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
73 nmake -f Make_mvc.mak OLE=yes OLE Microsoft Visual C++
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
74 nmake -f Make_mvc.mak PERL=C:\Perl PYTHON=C:\Python etc.
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
75 Perl, Python, etc.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
76
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
77 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
78 debug support. Debugging with MS Devstudio is provided by Make_dvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
79 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
80
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
81 For compiling Gvim with IME support on far-east Windows, add IME=yes
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
82 to the parameters you pass to Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
83
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
84 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
85 (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
86 far more configuration.) Make_ivc.mak can also be built with nmake.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
87
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
88 nmake -f Make_ivc.mak CFG="Vim - Win32 Release gvim"
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
89 GUI Microsoft Visual C++ 4.x or later
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
90 nmake -f Make_ivc.mak CFG="Vim - Win32 Release gvim OLE"
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
91 OLE Microsoft Visual C++ 4.x or later
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
92
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
93 See the specific files for comments and options.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
94
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
95 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
96 Ron Aaron; they have been tested.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
97
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
98
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
99 Visual C++ 2008 Express Edition *msvc-2008-express*
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
100 -------------------------------
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
101
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
102 Visual C++ 2008 Express Edition can be downloaded for free from:
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
103 http://www.microsoft.com/express/downloads/
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
104 This includes the IDE and the debugger.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
105
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
106 To set the environment execute the msvc2008.bat script. You can then build
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
107 Vim with Make_mvc.mak.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
108
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
109 For building 64 bit binaries you also need to install the SDK:
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
110 "Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1"
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
111 You don't need the examples and documentation.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
112
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
113 If you get an error that Win32.mak can't be found, you have to set the
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
114 variable SDK_INCLUDE_DIR. For example, on Windows 10, installation of MSVC
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
115 puts include files in the following directory:
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
116 set SDK_INCLUDE_DIR=C:\Program Files\Microsoft SDKs\Windows\v6.0A\Include
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
117
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
118
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
119 Visual C++ 2010 Express Edition *msvc-2010-express*
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
120 -------------------------------
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
121
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
122 Visual C++ 2010 Express Edition can be downloaded for free from:
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
123 http://www.microsoft.com/express/vc/Default.aspx
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
124 This includes the IDE and the debugger.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
125
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
126 To set the environment execute the msvc2010.bat script. You can then build
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
127 Vim with Make_mvc.mak.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
128
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
129
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
130 Targeting Windows XP with MSVC 2012 and later *new-msvc-windows-xp*
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
131 ---------------------------------------------
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
132
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
133 Beginning with Visual C++ 2012, Microsoft changed the behavior of LINK.EXE
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
134 so that it targets Windows 6.0 (Vista) by default. In order to override
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
135 this, the target Windows version number needs to be passed to LINK like
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
136 follows:
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
137 LINK ... /subsystem:console,5.01
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
138
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
139 Make_mvc.mak now supports a macro SUBSYSTEM_VER to pass the Windows version.
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
140 Use lines like follows to target Windows XP x86 (assuming using Visual C++
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
141 2012 under 64-bit Windows):
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
142 set WinSdk71=%ProgramFiles(x86)%\Microsoft SDKs\Windows\v7.1A
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
143 set INCLUDE=%WinSdk71%\Include;%INCLUDE%
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
144 set LIB=%WinSdk71%\Lib;%LIB%
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
145 set CL=/D_USING_V110_SDK71_
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
146 nmake -f Make_mvc.mak ... WINVER=0x0501 SUBSYSTEM_VER=5.01
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
147
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
148 To target Windows XP x64 instead of x86, you need to change the settings of
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
149 LIB and SUBSYSTEM_VER:
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
150 ...
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
151 set LIB=%WinSdk71%\Lib\x64;%LIB%
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
152 ...
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
153 nmake -f Make_mvc.mak ... WINVER=0x0501 SUBSYSTEM_VER=5.02
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
154
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
155 If you use Visual C++ 2015 (either Express or Community Edition), executing
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
156 msvc2015.bat will set them automatically. For x86 builds run this without
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
157 options:
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
158 msvc2015
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
159 For x64 builds run this with the "x86_amd64" option:
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
160 msvc2015 x86_amd64
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
161
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
162 The following Visual C++ team blog can serve as a reference page:
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
163 http://blogs.msdn.com/b/vcblog/archive/2012/10/08/windows-xp-targeting-with-c-in-visual-studio-2012.aspx
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
164
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
165
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
166 OLDER VERSIONS
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
167
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
168 The minimal supported version is Windows XP. Building with older compilers
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
169 might still work, but these instructions might be outdated.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
170
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
171 If you need the executable to run on Windows 98 or ME, use the 2003 one
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
172 |msvc-2003-toolkit|.
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
173
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
174 Visual C++ Toolkit 2003 *msvc-2003-toolkit*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
175 -----------------------
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
176
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
177 You could download the Microsoft Visual C++ Toolkit 2003 from
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
178 http://msdn.microsoft.com/visualc/vctoolkit2003/
1668
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
179 Unfortunately this URL is no longer valid. Inofficial downloads appear to be
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
180 available from links mentioned on these pages (use at your own risk):
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
181 http://www.filewatcher.com/m/VCToolkitSetup.exe.32952488.0.0.html
0b796e045c42 updated for version 7.2b-000
vimboss
parents: 1619
diff changeset
182 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
183
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
184 This contains the command-line tools (compiler, linker, CRT headers,
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
185 and libraries) for Visual Studio .NET 2003, but not the Visual Studio IDE.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
186 To compile and debug Vim with the VC2003 Toolkit, you will also need
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
187 |ms-platform-sdk|, |dotnet-1.1-redist|, |dotnet-1.1-sdk|,
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
188 and |windbg-download|.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
189
1569
9fbb40a1228a updated for version 7.1-282
vimboss
parents: 856
diff changeset
190 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
191 which is freely available in perpetuity.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
192
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
193 The free Code::Blocks IDE works with the VC2003 Toolkit, as described at
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
194 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
195 (This site also takes you through configuring a number of other
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
196 free C compilers for Win32.)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
197
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
198 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
199 execute the following commands in a cmd.exe window (the msvcsetup.bat batch
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
200 file can be used):
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
201
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
202 set PATH=%SystemRoot%\Microsoft.NET\Framework\v1.1.4322;%PATH%
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
203 call "%VCToolkitInstallDir%vcvars32.bat"
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
204 set MSVCVer=7.1
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
205 call "%ProgramFiles%\Microsoft Platform SDK\SetEnv.Cmd"
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
206 set LIB=%ProgramFiles%\Microsoft Visual Studio .NET 2003\Vc7\lib;%LIB%
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
207
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
208 Now you can build Vim with Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
209
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
210
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
211 Getting the Windows Platform SDK *ms-platform-sdk*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
212
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
213 You will also need a copy of the Windows Platform SDK. Specifically, you need
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
214 the Windows Core SDK subset of the Platform SDK, which contains the Windows
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
215 headers and libraries. You need to search for it, Microsoft keeps changing
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
216 the URL.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
217
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
218
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
219 Getting the .NET Framework 1.1 Runtime *dotnet-1.1-redist*
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
220
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
221 You need the .NET Framework 1.1 Redistributable Package from
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
222 http://www.microsoft.com/downloads/details.aspx?familyid=262d25e3-f589-4842-8157-034d1e7cf3a3
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
223 or from Windows Update:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
224 http://windowsupdate.microsoft.com/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
225 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
226 which is needed to link Vim.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
227
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
228
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
229 Getting the .NET Framework 1.1 SDK *dotnet-1.1-sdk*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
230
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
231 You need the .NET Framework 1.1 SDK from
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
232 http://www.microsoft.com/downloads/details.aspx?familyid=9b3a2ca6-3647-4070-9f41-a333c6b9181d
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
233 This contains some additional libraries needed to compile Vim,
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
234 such as msvcrt.lib. You must install |dotnet-1.1-redist| before
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
235 installing the .NET 1.1 SDK.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
236
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
237
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
238 Getting the WinDbg debugger *windbg-download*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
239
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
240 The Debugging Tools for Windows can be downloaded from
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
241 http://www.microsoft.com/whdc/devtools/debugging/default.mspx
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
242 This includes the WinDbg debugger, which you will want if you ever need
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
243 to debug Vim itself. An earlier version of the Debugging Tools
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
244 is also available through the Platform SDK, |ms-platform-sdk|.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
245
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
246
1608
152883db0edf updated for version 7.1-321
vimboss
parents: 1569
diff changeset
247 Visual C++ 2005 Express Edition *msvc-2005-express*
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
248 -------------------------------
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
249
838
8e5830943bff updated for version 7.0e04
vimboss
parents: 714
diff changeset
250 Visual C++ 2005 Express Edition can be downloaded for free from:
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
251 http://msdn.microsoft.com/vstudio/express/visualC/default.aspx
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
252 This includes the IDE and the debugger. You will also need
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
253 |ms-platform-sdk|. You can build Vim with Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
254
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
255 Instructions for integrating the Platform SDK into VC Express:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
256 http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/default.aspx
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
257
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
258
6149
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
259
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
260 2. MinGW
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
261 ========
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
262
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
263 (written by Ron Aaron: <ronaharon@yahoo.com>)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
264
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
265 This is about how to produce a Win32 binary of gvim with MinGW.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
266
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
267 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
268 at:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
269
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
270 http://www.mingw.org/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
271
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
272 or you can use 'MinGW-w64' compiler.
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
273
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
274 http://mingw-w64.sourceforge.net/
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
275
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
276 Or a compiler provided on msys2:
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
277
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
278 https://msys2.github.io/
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
279
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
280 Once you have downloaded the compiler binaries, unpack them on your hard disk
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
281 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
282 your AUTOEXEC.BAT file with a line like:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
283
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
284 set PATH=C:\MinGW\bin;%PATH%
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
285
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
286 or on NT/2000/XP, go to the Control Panel, (Performance and Maintenance),
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
287 System, Advanced, and edit the environment from there. If you use msys2
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
288 compilers, set your installed paths:
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
289
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
290 C:\msys2\mingw32\bin
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
291 or
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
292 C:\msys64\mingw32\bin
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
293
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
294 for 32bit. And 64bit:
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
295
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
296 C:\msys2\mingw64\bin
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
297 or
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
298 C:\msys64\mingw64\bin
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
299
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
300 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
301
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
302 C:\> gcc --version
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
303 gcc (GCC) 4.8.1
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
304
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
305 C:\> mingw32-make --version
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
306 GNU Make 3.82.90 (...etc...)
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
307
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
308 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
309 www.vim.org for exactly which version of the vim files you need).
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
310
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
311 Change directory to 'vim\src':
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
312
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
313 C:\> cd vim\src
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
314 C:\VIM\SRC>
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
315
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
316 and you type:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
317
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
318 mingw32-make -f Make_ming.mak gvim.exe
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
319
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
320 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
321 directory.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
322
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
323 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
324 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
325 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
326
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
327 mingw32-make -f Make_ming.mak GUI=no vim.exe
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
328
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
329 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
330 (also free!) and compress the file (typical compression is 50%). UPX can be
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
331 found at
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
332 http://www.upx.org/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
333
3388
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
334 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
335 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
336 at:
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
337 http://www.matcode.com/mpress.htm
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
338
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
339
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
340 ADDITION: NLS support with MinGW
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
341
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
342 (by Eduardo F. Amatria <eferna1@platea.pntic.mec.es>)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
343
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
344 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
345 You need to uncomment lines in Make_ming.mak to have NLS defined.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
346
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
347
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
348 3. Cygwin
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
349 =========
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
350
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
351 Use Make_cyg.mak with Cygwin's GCC. See
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
352 http://users.skynet.be/antoine.mechelynck/vim/compile.htm
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
353
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
354 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
355 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
356 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
357 with the other makefiles).
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
358
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
359
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
360 4. Borland
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
361 ===========
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
362
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
363 Use Make_bc5.mak with Borland C++ 5.x. See
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
364 http://users.skynet.be/antoine.mechelynck/vim/compile.htm
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
365
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
366
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
367 5. Cross compiling for Win32 from a Linux machine
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
368 =================================================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
369
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
370 [Update of 1) needs to be verified]
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
371
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
372 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
373 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
374 1) Install the mingw32 cross-compiler. See
2035
ca7d02cd5e49 Minor text file updates.
Bram Moolenaar <bram@zimbu.org>
parents: 1668
diff changeset
375 http://www.mingw.org/wiki/LinuxCrossMinGW
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
376 http://www.libsdl.org/extras/win32/cross/README.txt
1619
b9740fb41986 updated for version 7.2a
vimboss
parents: 1608
diff changeset
377 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
378 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
379 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
380 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
381 set 'CROSS_COMPILE' corresponding.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
382 4) make -f Make_ming.mak gvim.exe
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
383
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
384 Now you have created the Windows binary from your Linux box! Have fun...
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
385
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
386
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
387 6. Building with Python support
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
388 ===============================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
389
3847
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
390 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
391 works fine.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
392
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
393 When building, you need to set the following variables at least:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
394
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
395 PYTHON: Where Python is installed. E.g. C:\Python27
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
396 DYNAMIC_PYTHON: Whether dynamic linking is used. Usually, set to yes.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
397 PYTHON_VER: Python version. E.g. 27 for Python 2.7.X.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
398
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
399 E.g. When using MSVC (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
400
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
401 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
402 PYTHON=C:\Python27 DYNAMIC_PYTHON=yes PYTHON_VER=27
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
403
3847
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
404 (rest written by Ron Aaron: <ronaharon@yahoo.com>)
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
405
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
406 Building with the mingw32 compiler, and the ActiveState ActivePython:
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
407 http://www.ActiveState.com/Products/ActivePython/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
408
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
409 After installing the ActivePython, you will have to create a 'mingw32'
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
410 'libpython20.a' to link with:
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
411 cd $PYTHON/libs
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
412 pexports python20.dll > python20.def
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
413 dlltool -d python20.def -l libpython20.a
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
414
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
415 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
416 the root of the Python installation (C:\Python20, for example). If you are
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
417 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
418 the 'Include' files to *unix* line-endings. This bash command will do it
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
419 easily:
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
420 for fil in *.h ; do vim -e -c 'set ff=unix|w|q' $fil
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
421
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
422 Now just do:
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
423 make -f Make_ming.mak gvim.exe
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
424
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
425 And if you use msys2 to build python support (as one line):
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
426
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
427 mingw32-make -f Make_ming.mak PYTHON=c:/msys64/mingw64
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
428 PYTHON_HOME=c:/msys64/mingw64
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
429 PYTHONINC=-Ic:/msys64/mingw64/include/python2.7
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
430 DYNAMIC_PYTHON=yes
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
431 PYTHON_VER=27
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
432 DYNAMIC_PYTHON_DLL=libpython2.7.dll
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
433 ARCH=x86-64
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
434 STATIC_STDCPLUS=yes
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
435
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
436 You will end up with a Python-enabled, Win32 version. Enjoy!
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
437
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
438
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
439 7. Building with Python3 support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
440 ================================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
441
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
442 For building with MSVC 2008 the "Windows Installer" from www.python.org
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
443 works fine. Python 3.4 is recommended.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
444
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
445 When building, you need to set the following variables at least:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
446
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
447 PYTHON3: Where Python3 is installed. E.g. C:\Python34
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
448 DYNAMIC_PYTHON3: Whether dynamic linking is used. Usually, set to yes.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
449 PYTHON3_VER: Python3 version. E.g. 34 for Python 3.4.X.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
450
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
451 E.g. When using MSVC (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
452
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
453 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
454 PYTHON3=C:\Python34 DYNAMIC_PYTHON3=yes PYTHON3_VER=34
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
455
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
456
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
457 8. Building with Racket or MzScheme support
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
458 ========================================
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
459
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
460 1) Building with Racket support (newest)
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
461
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
462 MzScheme and PLT Scheme names have been rebranded as Racket. Vim with Racket
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
463 support can be built with either MSVC or MinGW (or Cygwin).
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
464 Get it from https://download.racket-lang.org/
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
465
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
466 Copy lib/libracket{version}.dll to your Windows system directory. The system
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
467 directory depends on your Windows bitness and Vim bitness:
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
468 32-bit Vim on 32-bit Windows: C:\Windows\System32
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
469 32-bit Vim on 64-bit Windows: C:\Windows\SysWOW64
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
470 64-bit Vim on 64-bit Windows: C:\Windows\System32
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
471
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
472 For building you need to set the following variables:
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
473
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
474 MZSCHEME: Where Racket is installed.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
475 E.g. C:\Program Files (x86)\Racket
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
476 DYNAMIC_MZSCHEME: Whether dynamic linking is used. Usually, set to yes.
11914
4f7081eb1e26 Updated runtime files
Christian Brabandt <cb@256bit.org>
parents: 11774
diff changeset
477 MZSCHEME_VER: Racket DLL version which is used for the file name.
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
478 See below for a list of MZSCHEME_VER.
11914
4f7081eb1e26 Updated runtime files
Christian Brabandt <cb@256bit.org>
parents: 11774
diff changeset
479 The DLL can be found under the lib directory. E.g.
4f7081eb1e26 Updated runtime files
Christian Brabandt <cb@256bit.org>
parents: 11774
diff changeset
480 C:\Program Files (x86)\Racket\lib\libracket3m_XXXXXX.dll
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
481 MZSCHEME_COLLECTS: (Optional) Path of the collects directory used at
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
482 runtime. Default: $(MZSCHEME)\collects
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
483 User can override this with the PLTCOLLECTS environment
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
484 variable.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
485
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
486 List of MZSCHEME_VER (incomplete):
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
487
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
488 Racket ver. | MZSCHEME_VER
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
489 ==========================
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
490 6.3 | 3m_9z0ds0
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
491 6.6 | 3m_a0solc
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
492 6.8 | 3m_a1zjsw
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
493 6.10 | 3m_a36fs8
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
494
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
495
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
496 E.g. When using MSVC (as one line):
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
497
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
498 nmake -f Make_mvc.mak
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
499 MZSCHEME="C:\Program Files (x86)\Racket" DYNAMIC_MZSCHEME=yes
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
500 MZSCHEME_VER=3m_9z0ds0
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
501
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
502 Or when using MinGW (as one line):
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
503
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
504 mingw32-make -f Make_ming.mak
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
505 MZSCHEME='C:/Program\ Files\ (x86)/Racket' DYNAMIC_MZSCHEME=yes
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
506 MZSCHEME_VER=3m_9z0ds0
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
507
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
508 Spaces should be escaped with '\'.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
509
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
510
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
511 2) Building with MzScheme support (older)
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
512
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
513 (written by Sergey Khorev <sergey.khorev@gmail.com>)
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
514
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
515 Vim with MzScheme (http://www.plt-scheme.org/software/mzscheme) support can
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
516 be built with either MSVC, or MinGW, or Cygwin. Supported versions are 205 and
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
517 above (including 299 and 30x series).
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
518
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
519 The MSVC build is quite straightforward. Simply invoke (in one line)
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
520 nmake -fMake_mvc.mak MZSCHEME=<Path-to-MzScheme>
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
521 [MZSCHEME_VER=<MzScheme-version>] [DYNAMIC_MZSCHEME=<yes or no>]
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
522 where <MzScheme-version> is the last seven characters from MzScheme dll name
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
523 (libmzschXXXXXXX.dll).
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
524 If DYNAMIC_MZSCHEME=yes, resulting executable will not depend on MzScheme
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
525 DLL's, but will load them in runtime on demand.
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
526
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
527 Building dynamic MzScheme support on MinGW and Cygwin is similar. Take into
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
528 account that <Path-to-MzScheme> should contain slashes rather than backslashes
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
529 (e.g. d:/Develop/MzScheme)
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
530
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
531 "Static" MzScheme support (Vim executable will depend on MzScheme DLLs
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
532 explicitly) on MinGW and Cygwin requires additional step.
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
533
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
534 libmzschXXXXXXX.dll and libmzgcXXXXXXX.dll should be copied from
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
535 %WINDOWS%\System32 to other location (either build directory, some temporary
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
536 dir or even MzScheme home).
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
537
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
538 Pass that path as MZSCHEME_DLLS parameter for Make. E.g.,
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
539 make -f Make_cyg.mak MZSCHEME=d:/Develop/MzScheme MZSCHEME_VER=209_000
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
540 MZSCHEME_DLLS=c:/Temp DYNAMIC_MZSCHEME=no
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
541
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
542 After a successful build, these dlls can be freely removed, leaving them in
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
543 %WINDOWS%\System32 only.
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
544
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
545
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
546
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
547 9. Building with Lua support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
548 ============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
549
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
550 Vim with Lua support can be built with either MSVC or MinGW (or maybe Cygwin).
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
551 You can use binaries from LuaBinaries: http://luabinaries.sourceforge.net/
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
552 This also applies to when you get a Vim executable and don't build yourself,
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
553 do the part up to "Build".
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
554
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
555 1) Download and install LuaBinaries
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
556
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
557 Go to the Download page of LuaBinaries:
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
558 http://luabinaries.sourceforge.net/download.html
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
559
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
560 Download lua-X.Y.Z_Win32_dllw4_lib.zip for x86 or
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
561 lua-X.Y.Z_Win64_dllw4_lib.zip for x64. You can use them both for MSVC and
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
562 MinGW.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
563
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
564 Unpack it to a working directory. E.g. C:\projects\lua53.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
565 Lua's header files will be installed under the include directory.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
566
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
567 Copy luaXY.dll to your Windows system directory. The system directory depends
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
568 on your Windows bitness and Vim bitness:
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
569 32-bit Vim on 32-bit Windows: C:\Windows\System32
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
570 32-bit Vim on 64-bit Windows: C:\Windows\SysWOW64
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
571 64-bit Vim on 64-bit Windows: C:\Windows\System32
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
572
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
573 Or another option is copying luaXY.dll to the directory where gvim.exe
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
574 (or vim.exe) is.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
575
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
576
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
577 2) Build
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
578
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
579 You need to set LUA, DYNAMIC_LUA and LUA_VER.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
580
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
581 LUA: Where Lua's header files are installed. E.g. C:\projects\lua53.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
582 DYNAMIC_LUA: Whether dynamic linking is used. Set to yes.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
583 LUA_VER: Lua version. E.g. 53 for Lua 5.3.X.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
584
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
585 E.g. When using MSVC (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
586
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
587 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
588 LUA=C:\projects\lua53 DYNAMIC_LUA=yes LUA_VER=53
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
589
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
590 Or when using MinGW (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
591
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
592 mingw32-make -f Make_ming.mak
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
593 LUA=C:\projects\lua53 DYNAMIC_LUA=yes LUA_VER=53
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
594
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
595
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
596 Or when using Cygwin (as one line) (untested):
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
597
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
598 make -f Make_cyg.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
599 LUA=/cygdrive/c/projects/lua53 DYNAMIC_LUA=yes LUA_VER=53
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
600
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
601
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
602 10. Building with Perl support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
603 ==============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
604
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
605 Vim with Perl support can be built with either MSVC or MinGW (or Cygwin).
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
606 You can use binaries from ActiveState (ActivePerl) or Strawberry Perl.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
607
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
608 http://www.activestate.com/activeperl
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
609 http://strawberryperl.com/
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
610
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
611 When building, you need to set the following variables:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
612
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
613 PERL: Where perl is installed. E.g. C:\Perl, C:\Strawberry\perl
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
614 DYNAMIC_PERL: Whether dynamic linking is used. Usually, set to yes.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
615 PERL_VER: Perl version. E.g. 522 for Perl 5.22.X.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
616
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
617 E.g. When using MSVC (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
618
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
619 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
620 PERL=C:\Perl DYNAMIC_PERL=yes PERL_VER=522
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
621
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
622 Or when using MinGW (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
623
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
624 mingw32-make -f Make_ming.mak
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
625 PERL=C:\Perl DYNAMIC_PERL=yes PERL_VER=522
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
626
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
627
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
628 11. Building with Ruby support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
629 ==============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
630
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
631 Vim with Ruby support can be built with either MSVC or MinGW (or Cygwin).
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
632 Ruby doesn't provide the official Windows binaries. The most widely used
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
633 Windows binaries might be RubyInstaller. Currently Ruby 2.4 is recommended.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
634
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
635 http://rubyinstaller.org/
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
636
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
637 If you use MinGW you can easily build with RubyInstaller, but if you use MSVC
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
638 you need some tricks described below.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
639 (Another binary distribution is ActiveScriptRuby:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
640 http://www.artonx.org/data/asr/)
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
641
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
642 When building, you need to set the following variables at least:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
643
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
644 RUBY: Where ruby is installed. E.g. C:\Ruby24
10138
8bfcb960e6bd commit https://github.com/vim/vim/commit/6384c5db8dda70076c878d393ba19a1510695228
Christian Brabandt <cb@256bit.org>
parents: 9719
diff changeset
645 DYNAMIC_RUBY: Whether dynamic linking is used. Usually, set to yes.
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
646 RUBY_VER: Ruby version. E.g. 24 for Ruby 2.4.X.
10138
8bfcb960e6bd commit https://github.com/vim/vim/commit/6384c5db8dda70076c878d393ba19a1510695228
Christian Brabandt <cb@256bit.org>
parents: 9719
diff changeset
647 RUBY_API_VER_LONG: Ruby API version in a long format.
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
648 E.g. 2.4.0 for Ruby 2.4.X.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
649
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
650 Ruby version vs. Ruby API version:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
651
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
652 Ruby ver. | Ruby API ver.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
653 =========================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
654 1.8.X | 1.8
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
655 1.9.[1-3] | 1.9.1
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
656 2.0.0 | 2.0.0
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
657 2.X.Y | 2.X.0
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
658
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
659 (Ruby 1.9.0 is excluded from the table because it is an unstable version.)
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
660
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
661
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
662 A) Using MSVC
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
663
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
664 If you want to link with ruby, normally you must use the same compiler as
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
665 which was used to build the ruby binary. RubyInstaller is built with MinGW,
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
666 so normally you cannot use MSVC for building Vim if you want to link with
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
667 RubyInstaller. If you use a different compiler, there are mainly two problems:
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
668 config.h and Ruby's DLL name. Here are the steps for working around them:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
669
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
670 1) Download and Install RubyInstaller.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
671 You can install RubyInstaller with the default options and directory.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
672 E.g.:
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
673 C:\Ruby24 (32-bit) or C:\Ruby24-x64 (64-bit)
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
674
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
675 Ruby 2.4.X is used in this example.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
676
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
677 2) Download Ruby 2.4.X's source code and generate config.h:
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
678
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
679 cd C:\projects
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
680 git clone https://github.com/ruby/ruby.git -b ruby_2_4
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
681 cd ruby
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
682 win32\configure.bat
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
683 nmake .config.h.time
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
684
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
685 Note that ruby_2_4 is the branch name for Ruby 2.4.X's source code.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
686 There is no need to build whole Ruby, just config.h is needed.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
687 If you use 32-bit MSVC10, the config.h is generated in the
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
688 .ext\include\i386-mswin32_140 directory.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
689
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
690 3) Install the generated config.h.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
691
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
692 xcopy /s .ext\include E:\Ruby24\include\ruby-2.4.0
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
693
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
694 Note that 2.4.0 is Ruby API version of Ruby 2.4.X.
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
695 You may need to close the console and reopen it to pick up the new $PATH.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
696
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
697 4) Build Vim. Note that you need to adjust some variables (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
698
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
699 nmake -f Make_mvc.mak
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
700 RUBY=C:\Ruby24 DYNAMIC_RUBY=yes RUBY_VER=24 RUBY_API_VER_LONG=2.4.0
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
701 RUBY_MSVCRT_NAME=msvcrt
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
702 WINVER=0x501
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
703
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
704 If you set WINVER explicitly, it must be set to >=0x500, when building
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
705 with Ruby 2.1 or later. (Default is 0x501.)
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
706 When using this trick, you also need to set RUBY_MSVCRT_NAME to msvcrt
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
707 which is used for the Ruby's DLL name.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
708
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
709 B) Using MinGW
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
710
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
711 Using MinGW is easier than using MSVC when linking with RubyInstaller.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
712 After you install RubyInstaller, just type this (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
713
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
714 mingw32-make -f Make_ming.mak
10138
8bfcb960e6bd commit https://github.com/vim/vim/commit/6384c5db8dda70076c878d393ba19a1510695228
Christian Brabandt <cb@256bit.org>
parents: 9719
diff changeset
715 RUBY=C:/Ruby22 DYNAMIC_RUBY=yes RUBY_VER=22 RUBY_API_VER_LONG=2.2.0
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
716 WINVER=0x501
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
717
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
718 If you set WINVER explicitly, it must be set to >=0x500, when building with
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
719 Ruby 2.1 or later. (Default is 0x501.)
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
720
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
721
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
722
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
723 12. Building with Tcl support
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
724 =============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
725
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
726 Vim with Tcl support can be built with either MSVC or MinGW (or Cygwin).
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
727 You can use binaries from ActiveState (ActiveTcl).
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
728
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
729 http://www.activestate.com/activetcl
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
730
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
731 For MSVC 2015 use version 8.6.6 or later.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
732 When building, you need to set the following variables:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
733
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
734 TCL: Where tcl is installed. E.g. C:\Tcl86
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
735 DYNAMIC_TCL: Whether dynamic linking is used. Usually, set to yes.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
736 TCL_VER: Tcl version in a short format. E.g. 86 for Tcl 8.6.X.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
737 TCL_VER_LONG: Tcl version in a long format. E.g. 8.6 for Tcl 8.6.X.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
738
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
739 Sometimes the Tcl dll name changes. E.g. ActiveTcl 8.6.4 comes with tcl86.dll,
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
740 but ActiveTcl 8.6.6 comes with tcl86t.dll. You can set the dll name by setting
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
741 the TCL_DLL variable:
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
742 TCL_DLL=tcl86t.dll
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
743
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
744 E.g. When using MSVC (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
745
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
746 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
747 TCL=C:\Tcl86 DYNAMIC_TCL=yes TCL_VER=86 TCL_VER_LONG=8.6
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
748
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
749 Or when using MinGW (as one line):
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
750
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
751 mingw32-make -f Make_ming.mak
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
752 TCL=C:\Tcl86 DYNAMIC_TCL=yes TCL_VER=86 TCL_VER_LONG=8.6
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
753
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
754
11719
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
755 13. Building with Terminal support
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
756 ==================================
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
757
11774
edf1a2a247fa patch 8.0.0769: build problems with terminal on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11747
diff changeset
758 Vim with Terminal support can be built with either MSVC, MinGW or Cygwin.
11747
9dd958aba769 patch 8.0.0756: cannot build libvterm with MSVC
Christian Brabandt <cb@256bit.org>
parents: 11719
diff changeset
759 This uses the included libvterm and winpty. No extra header files or
11774
edf1a2a247fa patch 8.0.0769: build problems with terminal on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11747
diff changeset
760 libraries are needed for building. Just set TERMINAL to yes.
11747
9dd958aba769 patch 8.0.0756: cannot build libvterm with MSVC
Christian Brabandt <cb@256bit.org>
parents: 11719
diff changeset
761
11774
edf1a2a247fa patch 8.0.0769: build problems with terminal on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11747
diff changeset
762 E.g. When using MSVC:
11719
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
763
11774
edf1a2a247fa patch 8.0.0769: build problems with terminal on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11747
diff changeset
764 nmake -f Make_mvc.mak TERMINAL=yes
11719
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
765
11774
edf1a2a247fa patch 8.0.0769: build problems with terminal on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11747
diff changeset
766 Or when using MinGW (as one line):
11719
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
767
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
768 mingw32-make -f Make_ming.mak TERMINAL=yes
11719
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
769
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
770
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
771 14. Windows 3.1x
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
772 ================
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
773
8265
792bc43e69a7 commit https://github.com/vim/vim/commit/6e722e2f948bc51fcb92d98d6f2a089dac01e2bd
Christian Brabandt <cb@256bit.org>
parents: 7609
diff changeset
774 The Windows 3.1x support was removed in patch 7.4.1364.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
775
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
776
11719
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
777 15. MS-DOS
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
778 ==========
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
779
8265
792bc43e69a7 commit https://github.com/vim/vim/commit/6e722e2f948bc51fcb92d98d6f2a089dac01e2bd
Christian Brabandt <cb@256bit.org>
parents: 7609
diff changeset
780 The MS-DOS support was removed in patch 7.4.1399.
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
781
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
782
11719
13ecb3e64399 patch 8.0.0742: terminal feature does not work on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 10214
diff changeset
783 16. Installing after building from sources
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
784 ==========================================
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
785
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
786 [provided by Michael Soyka]
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
787
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
788 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
789 install Vim on your system. However, if you've obtained the Vim sources
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
790 using Git, Mercurial or by downloading them as a unix tar file, you must
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
791 first create a "vim80" directory. If you instead downloaded the sources as
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
792 zip files, you can skip this setup as the zip archives already have the
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
793 correct directory structure.
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
794
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
795 A. Create a Vim "runtime" subdirectory named "vim80"
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
796 -----------------------------------------------------
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
797 If you obtained your Vim sources as zip files, you can skip this step.
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
798 Otherwise, continue reading.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
799
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
800 Go to the directory that contains the Vim "src" and "runtime"
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
801 directories and create a new subdirectory named "vim80".
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
802
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
803 Copy the "runtime" files into "vim80":
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
804 copy runtime\* vim80
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
805
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
806 B. Copy the new binaries into the "vim80" directory
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
807 ----------------------------------------------------
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
808 Regardless of how you installed the Vim sources, you need to copy the
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
809 new binaries you created above into "vim80":
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
810
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
811 copy src\*.exe vim80
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
812 copy src\GvimExt\gvimext.dll vim80
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
813 copy src\xxd\xxd.exe vim80
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
814
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
815 C. Move the "vim80" directory into the Vim installation subdirectory
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
816 ---------------------------------------------------------------------
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
817 Move the "vim80" subdirectory into the subdirectory where you want Vim
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
818 to be installed. Typically, this subdirectory will be named "vim".
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
819 If you already have a "vim80" subdirectory in "vim", delete it first
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
820 by running its uninstal.exe program.
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
821
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
822 D. Install Vim
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
823 ---------------
10214
3a6b2d4c71d6 commit https://github.com/vim/vim/commit/bbe917d9d465a66a29e38879c7f66df51b0b0dc3
Christian Brabandt <cb@256bit.org>
parents: 10138
diff changeset
824 "cd" to your Vim installation subdirectory "vim\vim80" and run the
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
825 "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
826 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
827 - 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
828 parent directory.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
829 - 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
830 popup menu.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
831 - 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
832 console or in a shell. You can select one of the directories in your
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
833 PATH or add the directory to PATH using the Windows Control Panel.
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
834 - 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
835
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
836 Happy Vimming!