Mercurial > vim

annotate src/INSTALLpc.txt @ 30824:b7f12666bbb4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added tag v9.0.0746 for changeset 80a336303eb9e99be8d8d81c7e282ebdc3ce2bfd
author Bram Moolenaar <Bram@vim.org>
date Thu, 13 Oct 2022 23:00:04 +0200
parents 1e91e26ceebf
children 7449da0e006b
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
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
6 You can find the latest here: https://github.com/vim/vim-win32-installer
12610
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
30320
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
15 7/8/10/11). There are also instructions for pre-Vista and pre-XP systems, but
8960
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
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
19 build a 64 bit Vim if you like, the executable will be bigger and Vim won't be
12610
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++
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
25 2. Using MSYS2 with MinGW
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
26 3. Using MinGW
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
27 4. Cygwin
16606
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
28 5. Cross compiling for Win32 from a Linux machine
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
29 6. Building with Python support
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
30 7. Building with Python3 support
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
31 8. Building with Racket or MzScheme support
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
32 9. Building with Lua support
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
33 10. Building with Perl support
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
34 11. Building with Ruby support
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
35 12. Building with Tcl support
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
36 13. Building with DirectX (DirectWrite) support
27998
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
37 14. Building with libsodium support
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
38 15. Windows 3.1
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
39 16. MS-DOS
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
40
27998
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
41 17. Installing after building from sources
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
42
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
43
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
44 The currently recommended way (that means it has been verified to work) is
30320
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
45 using the "Visual Studio Community 2015" installation. This doesn't include
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
46 the SDK for older Windows versions (95, 98), see "OLDER VERSIONS" below for
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
47 that.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
48
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
49
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
50 1. Microsoft Visual C++
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
51 =======================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
52
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
53 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
54 can search for "Visual Studio Community 2015", for example. You will need to
29779
90a966f5c77a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 29163
diff changeset
55 create a Microsoft account (it's free). You need to download the "DVD", and
90a966f5c77a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 29163
diff changeset
56 execute the installer from it.
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
57
29779
90a966f5c77a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 29163
diff changeset
58 When installing "Visual Studio Community 2015 with Update 3" or "Visual C++
90a966f5c77a Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 29163
diff changeset
59 Build Tools for Visual Studio 2015 with Update 3" make sure to
30320
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
60 select "custom" and check all checkboxes under "Universal Windows App
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
61 Development Tools". Or whatever they are called now.
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
62 (If you still want to target Windows XP, check also "Windows XP Support for
30377
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
63 C++". Note that with the current source code this is no longer supported, you
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
64 will have to check out an older version).
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
65
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
66
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
67 Visual Studio
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
68 -------------
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
69
30377
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
70 Building with Visual Studio (VS2015, VS2017, VS2019 and VS2022) is
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
71 straightforward. Older versions probably don't work.
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
72
30385
54dda39c5bb3 patch 9.0.0528: MS-Windows: no batch files for more recent MSVC versions
Bram Moolenaar <Bram@vim.org>
parents: 30377
diff changeset
73 Visual Studio installed a batch file called vcvarsall.bat, which you must
30377
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
74 run to set up paths for nmake and MSVC. We provide a batch file
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
75 "msvc2015.bat" for this. You may need to edit it if you didn't instal Visual
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
76 Studio in the standard location.
30385
54dda39c5bb3 patch 9.0.0528: MS-Windows: no batch files for more recent MSVC versions
Bram Moolenaar <Bram@vim.org>
parents: 30377
diff changeset
77 If you use VS2017 or later, you can use "msvc-latest.bat" (or "msvc2017.bat"
54dda39c5bb3 patch 9.0.0528: MS-Windows: no batch files for more recent MSVC versions
Bram Moolenaar <Bram@vim.org>
parents: 30377
diff changeset
78 and so on for the specific version). You must specify the architecture (e.g.
54dda39c5bb3 patch 9.0.0528: MS-Windows: no batch files for more recent MSVC versions
Bram Moolenaar <Bram@vim.org>
parents: 30377
diff changeset
79 "x86", "x64", etc.) as the first argument when you use this. If you use VS2017
54dda39c5bb3 patch 9.0.0528: MS-Windows: no batch files for more recent MSVC versions
Bram Moolenaar <Bram@vim.org>
parents: 30377
diff changeset
80 Express, you must use "x86_amd64" instead of "x64" for targeting the x64
54dda39c5bb3 patch 9.0.0528: MS-Windows: no batch files for more recent MSVC versions
Bram Moolenaar <Bram@vim.org>
parents: 30377
diff changeset
81 platform.
3847
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
82
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
83 To build Vim from the command line with MSVC, use Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
84
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
85 nmake -f Make_mvc.mak console Win32 SDK or Microsoft Visual C++
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
86 nmake -f Make_mvc.mak GUI=yes GUI Microsoft Visual C++
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
87 nmake -f Make_mvc.mak OLE=yes OLE Microsoft Visual C++
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
88 nmake -f Make_mvc.mak PERL=C:\Perl PYTHON=C:\Python etc.
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
89 Perl, Python, etc.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
90
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
91 Make_mvc.mak allows a Vim to be built with various different features and
16580
09f560dde6be patch 8.1.1293: MSVC files are no longer useful
Bram Moolenaar <Bram@vim.org>
parents: 16229
diff changeset
92 debug support.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
93
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
94 For compiling gVim with IME support on far-east Windows, add IME=yes
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
95 to the parameters you pass to Make_mvc.mak.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
96
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
97 See the specific files for comments and options.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
98
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
99 These files have been supplied by George V. Reilly, Ben Singer, Ken Scott and
30377
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
100 Ron Aaron; they have been tested. But several things changed after that...
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
101
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
102
30377
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
103 Targeting Windows XP with MSVC 2015 and later *new-msvc-windows-xp*
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
104 ---------------------------------------------
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
105
30377
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
106 (The support for pre-Vista was removed in patch 9.0.0496. If you want to
30320
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
107 target Windows XP, use the source code before that.)
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
108
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
109 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
110 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
111 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
112 follows:
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
113 LINK ... /subsystem:console,5.01
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
114
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
115 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
116 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
117 2012 under 64-bit Windows):
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
118 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
119 set INCLUDE=%WinSdk71%\Include;%INCLUDE%
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
120 set LIB=%WinSdk71%\Lib;%LIB%
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
121 set CL=/D_USING_V110_SDK71_
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
122 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
123
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
124 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
125 LIB and SUBSYSTEM_VER:
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
126 ...
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
127 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
128 ...
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
129 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
130
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
131 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
132 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
133 options:
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
134 msvc2015
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
135 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
136 msvc2015 x86_amd64
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
137 This enables x86_x64 cross compiler. This works on any editions including
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
138 Express edition.
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
139 If you use Community (or Professional) edition, you can enable the x64 native
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
140 compiler by using the "x64" option:
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
141 msvc2015 x64
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
142
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
143 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
144 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
145
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
146
16229
081522b02c2d patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents: 15408
diff changeset
147 Cross compile support for Windows on ARM64
081522b02c2d patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents: 15408
diff changeset
148 ------------------------------------------
081522b02c2d patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents: 15408
diff changeset
149
081522b02c2d patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents: 15408
diff changeset
150 This depends on VS2017 with the optional ARM64 compiler and SDK
081522b02c2d patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents: 15408
diff changeset
151 installed. Use "vcvarsall.bat x64_arm64" as the build environment.
081522b02c2d patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents: 15408
diff changeset
152
081522b02c2d patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents: 15408
diff changeset
153 The ARM64 support was provided by Leendert van Doorn.
081522b02c2d patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents: 15408
diff changeset
154
081522b02c2d patch 8.1.1119: no support for Windows on ARM64.
Bram Moolenaar <Bram@vim.org>
parents: 15408
diff changeset
155
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
156 OLDER VERSIONS
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
157
30377
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
158 The minimal supported version is Windows 7. Building with compilers
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
159 older than 2015 most likely doesn't work. Since MSVC 2015 can be obtained for
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
160 free there is no point in supporting older versions.
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
161
27370
584f91cc2508 patch 8.2.4213: too much code for supporting old MSVC versions
Bram Moolenaar <Bram@vim.org>
parents: 24970
diff changeset
162 If you need the executable to run on Windows 98 or ME, use the 2005 one
30377
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
163 |msvc-2005-express|, and use the source code before 8.0.0029. See the
c9d2c554f314 patch 9.0.0524: build instructions for MS-Windows are outdated
Bram Moolenaar <Bram@vim.org>
parents: 30320
diff changeset
164 src/INSTALLpc.txt file for instructions.
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
165
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
166
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
167 2. MSYS2 with MinGW
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
168 ===================
6149
4c845a1600d2 updated for version 7.4.412
Bram Moolenaar <bram@vim.org>
parents: 3847
diff changeset
169
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
170 2.1. Setup the basic msys2 environment
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
171
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
172 Go to the official page of MSYS2: https://www.msys2.org
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
173 Download an installer:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
174
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
175 * msys2-x86_64-YYYYMMDD.exe for 64-bit Windows
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
176 (Even if you want to build 32-bit Vim)
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
177 * msys2-i686-YYYYMMDD.exe for 32-bit Windows
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
178
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
179 Execute the installer and follow the instructions to update basic packages.
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
180 At the end keep the checkbox checked to run msys2 now. If needed, you can
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
181 open the window from the start menu, MSYS2 64 bit / MSYS2 MSYS.
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
182
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
183 Execute:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
184 $ pacman -Syu
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
185
24911
fd37be6dc258 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 23047
diff changeset
186 And restart MSYS2 console (select "MSYS2 MSYS 32-Bit" icon from the Start
fd37be6dc258 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 23047
diff changeset
187 Menu for building 32 bit Vim, otherwise select "MSYS2 MinGW 64-Bit").
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
188 Then execute:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
189 $ pacman -Su
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
190
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
191 If pacman complains that `catgets` and `libcatgets` conflict with another
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
192 package, select `y` to remove them.
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
193
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
194
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
195 2.2. Install additional packages for building Vim
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
196
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
197 The following package groups are required for building Vim:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
198
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
199 * base-devel
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
200 * mingw-w64-i686-toolchain (for building 32-bit Vim)
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
201 * mingw-w64-x86_64-toolchain (for building 64-bit Vim)
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
202
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
203 (These groups also include some useful packages which are not used by Vim.)
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
204 Use the following command to install them:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
205
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
206 $ pacman -S base-devel mingw-w64-i686-toolchain mingw-w64-x86_64-toolchain
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
207
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
208 Or you can use the `pacboy` command to avoid long package names:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
209
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
210 $ pacboy -S base-devel: toolchain:m
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
211
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
212 The suffix ":" means that it disables the package name translation.
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
213 The suffix ":m" means both i686 and x86_64. You can also use the ":i" suffix
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
214 to install only i686, and the ":x" suffix to install only x86_64.
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
215 (See `pacboy help` for the help.)
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
216
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
217 See also the pacman page in ArchWiki for the general usage of pacman:
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
218 https://wiki.archlinux.org/index.php/pacman
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
219
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
220 MSYS2 has its own git package, and you can also install it via pacman:
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
221
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
222 $ pacman -S git
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
223
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
224
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
225 2.3. Keep the build environment up-to-date
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
226
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
227 After you have installed the build environment, you may want to keep it
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
228 up-to-date (E.g. always use the latest GCC).
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
229 In that case, you just need to execute the command:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
230 $ pacman -Syu
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
231
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
232
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
233 2.4. Build Vim
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
234
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
235 Select one of the following icon from the Start Menu:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
236
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
237 * MSYS2 MinGW 32-bit (To build 32-bit versions of Vim)
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
238 * MSYS2 MinGW 64-bit (To build 64-bit versions of Vim)
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
239
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
240 Go to the source directory of Vim, then execute the make command. E.g.:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
241
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
242 make -f Make_ming.mak
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
243 make -f Make_ming.mak GUI=no
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
244 make -f Make_ming.mak GUI=no DEBUG=yes
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
245
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
246 NOTE: you can't execute vim.exe in the MSYS2 console, open a normal Windows
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
247 console for that. You need to set $PATH to be able to build there, e.g.:
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
248
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
249 set PATH=c:\msys64\mingw32\bin;c:\msys64\usr\bin;%PATH%
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
250
14792
8eb8200a55b2 patch 8.1.0408: MSVC: cannot use the "x64" native compiler option
Christian Brabandt <cb@256bit.org>
parents: 14222
diff changeset
251 This command is in msys32.bat. Or for the 64 bit compiler use msys64.bat:
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
252
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
253 set PATH=c:\msys64\mingw64\bin;c:\msys64\usr\bin;%PATH%
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
254
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
255 If you have msys64 in another location you will need to adjust the paths for
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
256 that.
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
257
29134
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
258 2.5. Build Vim with Clang
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
259
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
260 The following package group is required for building Vim with Clang:
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
261
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
262 * mingw-w64-clang-x86_64-clang
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
263
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
264 Use the following command to install it:
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
265
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
266 $ pacman -S mingw-w64-clang-x86_64-clang
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
267
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
268 Go to the source directory of Vim, then execute the make command. E.g.:
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
269
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
270 CC=clang
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
271 CXX=clang++
29163
9288c636ffa5 patch 8.2.5101: MS-Windows with MinGW: $CC may be "cc" instead of "gcc"
Bram Moolenaar <Bram@vim.org>
parents: 29134
diff changeset
272 # To build Vim without the GUI support
29134
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
273 make -f Make_ming.mak GUI=no
29163
9288c636ffa5 patch 8.2.5101: MS-Windows with MinGW: $CC may be "cc" instead of "gcc"
Bram Moolenaar <Bram@vim.org>
parents: 29134
diff changeset
274 # To build Vim with the GUI support
9288c636ffa5 patch 8.2.5101: MS-Windows with MinGW: $CC may be "cc" instead of "gcc"
Bram Moolenaar <Bram@vim.org>
parents: 29134
diff changeset
275 make -f Make_ming.mak GUI=yes XPM=no
29134
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
276
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
277 To build Vim with the address sanitizer (ASAN), execute the following command:
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
278
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
279 CC=clang
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
280 CXX=clang++
cc1f2ef46aaa patch 8.2.5087: cannot build with clang on MS-Windows
Bram Moolenaar <Bram@vim.org>
parents: 27998
diff changeset
281 make -f Make_ming.mak DEBUG=yes ASAN=yes
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
282
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
283 3. MinGW
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
284 ========
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
285
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
286 (written by Ron Aaron: <ronaharon@yahoo.com>, updated by Ken Takata, et al.)
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
287
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
288 This is about how to produce a Win32 binary of gvim with MinGW from the normal
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
289 Command Prompt window. (To use MSYS2 console, see above.)
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
290
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
291 First, you need to get the 'MinGW-w64' compiler, which is free for the
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
292 download at:
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
293
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
294 http://mingw-w64.sourceforge.net/
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
295
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
296 Or a compiler provided on msys2:
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
297
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
298 https://www.msys2.org/
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
299
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
300 The original 'mingw32' compiler is outdated, and may no longer work:
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
301
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
302 http://www.mingw.org/
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
303
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
304 Once you have downloaded the compiler binaries, unpack them on your hard disk
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
305 somewhere, and put them on your PATH. Go to the Control Panel, (Performance
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
306 and Maintenance), System, Advanced, and edit the environment from there. If
23047
29c5f168c6fd Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 22880
diff changeset
307 you use the standalone MinGW-w64 compiler, the path may depend on your
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
308 installation. If you use msys2 compilers, set your installed paths (normally
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
309 one of the following):
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
310
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
311 C:\msys32\mingw32\bin (32-bit msys2, targeting 32-bit builds)
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
312 C:\msys64\mingw32\bin (64-bit msys2, targeting 32-bit builds)
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
313 C:\msys64\mingw64\bin (64-bit msys2, targeting 64-bit builds)
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
314
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
315 Test if gcc is on your path. From a Command Prompt window:
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
316
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
317 C:\> gcc --version
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
318 gcc (GCC) 4.8.1
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
319
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
320 C:\> mingw32-make --version
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
321 GNU Make 3.82.90 (...etc...)
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
322
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
323 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
324 www.vim.org for exactly which version of the vim files you need).
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
325
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
326 Change directory to 'vim\src':
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
327
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
328 C:\> cd vim\src
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
329 C:\VIM\SRC>
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
330
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
331 and you type:
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
332
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
333 mingw32-make -f Make_ming.mak gvim.exe
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
334
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
335 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
336 directory.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
337
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
338 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
339 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
340 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
341
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
342 mingw32-make -f Make_ming.mak GUI=no vim.exe
714
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 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
345 (also free!) and compress the file (typical compression is 50%). UPX can be
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
346 found at
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
347 http://www.upx.org/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
348
3388
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
349 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
350 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
351 at:
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
352 http://www.matcode.com/mpress.htm
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
353
981c7ad9dd48 updated for version 7.3.460
Bram Moolenaar <bram@vim.org>
parents: 2965
diff changeset
354
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
355 ADDITION: NLS support with MinGW
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
356
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
357 (by Eduardo F. Amatria <eferna1@platea.pntic.mec.es>)
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
358
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
359 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
360 You need to uncomment lines in Make_ming.mak to have NLS defined.
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
361
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
362
14222
78449866e9a9 patch 8.1.0128: building with MinGW does not work out-of-the-box
Christian Brabandt <cb@256bit.org>
parents: 13028
diff changeset
363 4. Cygwin
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
364 =========
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
365
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
366 Use Make_cyg.mak with Cygwin's GCC. See
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
367 http://users.skynet.be/antoine.mechelynck/vim/compile.htm
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
368
6326
112c80234ce3 updated for version 7.4.496
Bram Moolenaar <bram@vim.org>
parents: 6149
diff changeset
369 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
370 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
371 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
372 with the other makefiles).
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
373
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
374
16606
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
375 5. Cross compiling for Win32 from a Linux machine
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
376 =================================================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
377
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
378 [Update of 1) needs to be verified]
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
379
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
380 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
381 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
382 1) Install the mingw32 cross-compiler. See
2035
ca7d02cd5e49 Minor text file updates.
Bram Moolenaar <bram@zimbu.org>
parents: 1668
diff changeset
383 http://www.mingw.org/wiki/LinuxCrossMinGW
856
8cd729851562 updated for version 7.0g
vimboss
parents: 838
diff changeset
384 http://www.libsdl.org/extras/win32/cross/README.txt
1619
b9740fb41986 updated for version 7.2a
vimboss
parents: 1608
diff changeset
385 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
386 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
387 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
388 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
389 set 'CROSS_COMPILE' corresponding.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
390 4) make -f Make_ming.mak gvim.exe
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
391
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
392 Now you have created the Windows binary from your Linux box! Have fun...
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
393
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
394
16606
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
395 6. Building with Python support
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
396 ===============================
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
397
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
398 For building with MSVC the "Windows Installer" from www.python.org works fine.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
399
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
400 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
401
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
402 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
403 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
404 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
405
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
406 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
407
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
408 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
409 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
410
15408
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
411 When using MinGW and link with the official Python (as one line):
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
412
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
413 mingw32-make -f Make_ming.mak
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
414 PYTHON=C:/Python27 DYNAMIC_PYTHON=yes PYTHON_VER=27
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
415
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
416 When using msys2 and link with Python2 bundled with msys2 (as one line):
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
417
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
418 mingw32-make -f Make_ming.mak PYTHON=c:/msys64/mingw64
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
419 PYTHON_HOME=c:/msys64/mingw64
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
420 PYTHONINC=-Ic:/msys64/mingw64/include/python2.7
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
421 DYNAMIC_PYTHON=yes
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
422 PYTHON_VER=27
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
423 DYNAMIC_PYTHON_DLL=libpython2.7.dll
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
424 STATIC_STDCPLUS=yes
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
425
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
426 (This is for 64-bit builds. For 32-bit builds, replace mingw64 with mingw32.)
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
427 (STATIC_STDCPLUS is optional. Set to yes if you don't want to require
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
428 libstdc++-6.dll.)
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
429
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
430
3847
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
431 (rest written by Ron Aaron: <ronaharon@yahoo.com>)
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
432
1003f9b262d7 Update runtime files.
Bram Moolenaar <bram@vim.org>
parents: 3388
diff changeset
433 Building with the mingw32 compiler, and the ActiveState ActivePython:
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
434 http://www.ActiveState.com/Products/ActivePython/
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
435
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
436 After installing the ActivePython, you will have to create a 'mingw32'
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
437 'libpython20.a' to link with:
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
438 cd $PYTHON/libs
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
439 pexports python20.dll > python20.def
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
440 dlltool -d python20.def -l libpython20.a
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
441
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
442 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
443 the root of the Python installation (C:\Python20, for example). If you are
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
444 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
445 the 'Include' files to *unix* line-endings. This bash command will do it
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
446 easily:
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
447 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
448
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
449 Now just do:
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
450 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
451
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
452 You will end up with a Python-enabled, Win32 version. Enjoy!
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
453
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
454
16606
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
455 7. Building with Python3 support
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
456 ================================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
457
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
458 For building with MSVC the "Windows Installer" from www.python.org works fine.
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
459 Python 3.6 is recommended.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
460
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
461 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
462
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
463 PYTHON3: Where Python3 is installed. E.g. C:\Python36
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
464 DYNAMIC_PYTHON3: Whether dynamic linking is used. Usually, set to yes.
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
465 PYTHON3_VER: Python3 version. E.g. 36 for Python 3.6.X.
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
466
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
467 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
468
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
469 nmake -f Make_mvc.mak
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
470 PYTHON3=C:\Python36 DYNAMIC_PYTHON3=yes PYTHON3_VER=36
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
471
15408
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
472 When using MinGW and link with the official Python3 (as one line):
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
473
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
474 mingw32-make -f Make_ming.mak
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
475 PYTHON3=C:/Python36 DYNAMIC_PYTHON3=yes PYTHON3_VER=36
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
476
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
477 When using msys2 and link with Python3 bundled with msys2 (as one line):
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
478
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
479 mingw32-make -f Make_ming.mak PYTHON3=c:/msys64/mingw64
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
480 PYTHON3_HOME=c:/msys64/mingw64
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
481 PYTHON3INC=-Ic:/msys64/mingw64/include/python3.6m
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
482 DYNAMIC_PYTHON3=yes
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
483 PYTHON3_VER=36
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
484 DYNAMIC_PYTHON3_DLL=libpython3.6m.dll
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
485 STATIC_STDCPLUS=yes
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
486
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
487 (This is for 64-bit builds. For 32-bit builds, replace mingw64 with mingw32.)
15408
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
488 (STATIC_STDCPLUS is optional. Set to yes if you don't want to require
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
489 libstdc++-6.dll.)
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
490
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
491
16606
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
492 8. Building with Racket or MzScheme support
18662
652ac5edf8d0 patch 8.1.2323: Old MSVC version no longer tested.
Bram Moolenaar <Bram@vim.org>
parents: 18174
diff changeset
493 ===========================================
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
494
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
495 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
496
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
497 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
498 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
499 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
500
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
501 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
502 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
503 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
504 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
505 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
506
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
507 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
508
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
509 MZSCHEME: Where Racket is installed.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
510 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
511 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
512 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
513 See below for a list of MZSCHEME_VER.
11914
4f7081eb1e26 Updated runtime files
Christian Brabandt <cb@256bit.org>
parents: 11774
diff changeset
514 The DLL can be found under the lib directory. E.g.
4f7081eb1e26 Updated runtime files
Christian Brabandt <cb@256bit.org>
parents: 11774
diff changeset
515 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
516 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
517 runtime. Default: $(MZSCHEME)\collects
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
518 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
519 variable.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
520
12600
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
521 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
522
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
523 Racket ver. | MZSCHEME_VER
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
524 ==========================
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
525 6.3 | 3m_9z0ds0
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
526 6.6 | 3m_a0solc
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
527 6.8 | 3m_a1zjsw
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
528 6.10 | 3m_a36fs8
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
529
590424e87b65 patch 8.0.1178: using old compiler on MS-Windows
Christian Brabandt <cb@256bit.org>
parents: 11914
diff changeset
530
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
531 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
532
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
533 nmake -f Make_mvc.mak
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
534 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
535 MZSCHEME_VER=3m_9z0ds0
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
536
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
537 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
538
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
539 mingw32-make -f Make_ming.mak
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
540 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
541 MZSCHEME_VER=3m_9z0ds0
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
542
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
543 Spaces should be escaped with '\'.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
544
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
545
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
546 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
547
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
548 (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
549
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
550 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
551 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
552 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
553
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
554 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
555 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
556 [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
557 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
558 (libmzschXXXXXXX.dll).
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
559 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
560 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
561
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
562 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
563 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
564 (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
565
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
566 "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
567 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
568
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
569 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
570 %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
571 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
572
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
573 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
574 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
575 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
576
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
577 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
578 %WINDOWS%\System32 only.
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
579
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
580
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
581
16606
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
582 9. Building with Lua support
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
583 ============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
584
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
585 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
586 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
587 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
588 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
589
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
590 1) Download and install LuaBinaries
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
591
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
592 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
593 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
594
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
595 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
596 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
597 MinGW.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
598
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
599 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
600 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
601
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
602 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
603 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
604 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
605 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
606 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
607
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
608 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
609 (or vim.exe) is.
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
610
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
611
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
612 2) Build
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
613
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
614 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
615
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
616 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
617 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
618 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
619
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
620 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
621
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
622 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
623 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
624
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
625 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
626
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
627 mingw32-make -f Make_ming.mak
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
628 LUA=C:/projects/lua53 DYNAMIC_LUA=yes LUA_VER=53
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
629
7609
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
630
77a14f3bc18b commit https://github.com/vim/vim/commit/4e640bd930d133889dbc9f9a77e29bab902e3b7d
Christian Brabandt <cb@256bit.org>
parents: 7553
diff changeset
631 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
632
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
633 make -f Make_cyg.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
634 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
635
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
636
16606
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
637 10. Building with Perl support
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
638 ==============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
639
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
640 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
641 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
642
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
643 http://www.activestate.com/activeperl
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
644 http://strawberryperl.com/
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
645
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
646 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
647
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
648 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
649 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
650 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
651
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
652 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
653
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
654 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
655 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
656
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
657 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
658
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
659 mingw32-make -f Make_ming.mak
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
660 PERL=C:/Perl DYNAMIC_PERL=yes PERL_VER=522
7553
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
16606
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
663 11. Building with Ruby support
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
664 ==============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
665
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
666 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
667 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
668 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
669
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
670 http://rubyinstaller.org/
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
671
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
672 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
673 you need some tricks described below.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
674 (Another binary distribution is ActiveScriptRuby:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
675 http://www.artonx.org/data/asr/)
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
676
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
677 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
678
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
679 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
680 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
681 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
682 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
683 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
684
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
685 Ruby version vs. Ruby API version:
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
686
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
687 Ruby ver. | Ruby API ver.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
688 =========================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
689 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
690 2.0.0 | 2.0.0
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
691 2.X.Y | 2.X.0
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
692
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
693 (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
694
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
695
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
696 A) Using MSVC
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
697
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
698 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
699 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
700 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
701 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
702 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
703
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
704 1) Download and Install RubyInstaller.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
705 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
706 E.g.:
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
707 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
708
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
709 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
710
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
711 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
712
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
713 cd C:\projects
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
714 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
715 cd ruby
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
716 win32\configure.bat
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
717 nmake .config.h.time
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
718
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
719 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
720 There is no need to build whole Ruby, just config.h is needed.
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
721 If you use 32-bit MSVC 2015, 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
722 .ext\include\i386-mswin32_140 directory.
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
723 If you use 64-bit MSVC 2015, the config.h is generated in the
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
724 .ext\include\x64-mswin64_140 directory.
7553
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 3) Install the generated config.h.
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
727
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
728 For 32-bit version:
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
729
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
730 xcopy /s .ext\include C:\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
731
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
732 For 64-bit version:
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
733
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
734 xcopy /s .ext\include C:\Ruby24-x64\include\ruby-2.4.0
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
735
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
736 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
737 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
738
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
739 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
740
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
741 For 32-bit version:
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
742
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
743 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
744 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
745 RUBY_MSVCRT_NAME=msvcrt
30320
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
746 WINVER=0x601
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
747
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
748 For 64-bit version, replace RUBY=C:\Ruby24 with RUBY=C:\Ruby24-x64.
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
749
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
750 If you set WINVER explicitly, it must be set to >=0x500, when building
30320
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
751 with Ruby 2.1 or later. (Default is 0x601.)
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
752 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
753 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
754
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
755 B) Using MinGW
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
756
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
757 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
758 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
759
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
760 mingw32-make -f Make_ming.mak
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
761 RUBY=C:/Ruby24 DYNAMIC_RUBY=yes RUBY_VER=24 RUBY_API_VER_LONG=2.4.0
30320
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
762 WINVER=0x601
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
763
13018
8862bf5adf7b patch 8.0.1385: Python 3.5 is getting old
Christian Brabandt <cb@256bit.org>
parents: 12781
diff changeset
764 For 64-bit version, replace RUBY=C:/Ruby24 with RUBY=C:/Ruby24-x64.
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
765 If you set WINVER explicitly, it must be set to >=0x500, when building with
30320
0763cb330a65 patch 9.0.0496: no good reason to keep supporting Windows-XP
Bram Moolenaar <Bram@vim.org>
parents: 29840
diff changeset
766 Ruby 2.1 or later. (Default is 0x601.)
8960
ea3eb5a815b5 commit https://github.com/vim/vim/commit/02cfac85b4e4b038bb2df6962699fa93a42c7eb1
Christian Brabandt <cb@256bit.org>
parents: 8265
diff changeset
767
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
768
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
769
16606
7e733046db1d patch 8.1.1306: Borland support is outdated and doesn't work
Bram Moolenaar <Bram@vim.org>
parents: 16580
diff changeset
770 12. Building with Tcl support
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
771 =============================
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
772
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
773 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
774 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
775
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
776 http://www.activestate.com/activetcl
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
777
15408
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
778 Alternatively, you can use the binaries provided by IronTcl from
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
779
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
780 https://www.irontcl.com/
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
781
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
782 They might lack behind the latest version a bit, but should provide 64bit
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
783 and 32bit versions even if ActiveTcl does not provide them anymore.
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
784
cd1b393ddb5f patch 8.1.0712: MS-Windows build instructions are a bit outdated
Bram Moolenaar <Bram@vim.org>
parents: 14792
diff changeset
785 For building with 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
786 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
787
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
788 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
789 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
790 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
791 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
792
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
793 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
794 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
795 the TCL_DLL variable:
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
796 TCL_DLL=tcl86t.dll
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
797
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
798 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
799
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
800 nmake -f Make_mvc.mak
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
801 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
802
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
803 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
804
12610
c6dc5d62cf5e patch 8.0.1183: MS-Windows build instructions are outdated
Christian Brabandt <cb@256bit.org>
parents: 12600
diff changeset
805 mingw32-make -f Make_ming.mak
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
806 TCL=C:/Tcl86 DYNAMIC_TCL=yes TCL_VER=86 TCL_VER_LONG=8.6
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
807
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
808
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
809 13. Building with DirectX (DirectWrite) support
13028
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
810 ===============================================
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
811
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
812 Vim with DirectX (DirectWrite) support can be built with either MSVC or MinGW.
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
813 This requires dwrite_2.h and some other header files which come with Windows
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
814 SDK 8.1 or later (or MinGW-w64), if you want to enable color emoji support.
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
815 This also requires MBYTE=yes which is enabled by default.
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
816
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
817 A) Using MSVC
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
818
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
819 If you use MSVC 2013 or later, Windows SDK 8.1 or later is used by default.
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
820 You just need to specify DIRECTX=yes:
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
821
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
822 nmake -f Make_mvc.mak DIRECTX=yes
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
823
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
824 If you use MSVC 2012 or earlier, the required header files are not available
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
825 by default. However, you can use the header files from newer SDKs with older
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
826 compilers. E.g.:
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
827
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
828 set "INCLUDE=%INCLUDE%;C:\Program Files (x86)\Windows Kits\8.1\Include\um"
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
829 nmake -f Make_mvc.mak DIRECTX=yes
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
830
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
831 If you don't need color emoji support, only dwrite.h is required. You can use
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
832 older compilers (e.g. VC2010) without Windows SDK 8.1. E.g.:
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
833
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
834 nmake -f Make_mvc.mak DIRECTX=yes COLOR_EMOJI=no
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
835
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
836 B) Using MinGW-w64
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
837
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
838 Just set DIRECTX to yes:
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
839
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
840 mingw32-make -f Make_ming.mak DIRECTX=yes
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
841
cfce9ac1d1e8 patch 8.0.1390: DirectX scrolling can be slow, vertical positioning is off
Christian Brabandt <cb@256bit.org>
parents: 13018
diff changeset
842
27998
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
843 14. Building with libsodium support
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
844 ===================================
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
845
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
846 For better encryption support, you can build Vim with libsodium.
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
847
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
848 A) Using MSVC
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
849
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
850 You can download the latest libsodium library from here:
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
851 https://download.libsodium.org/libsodium/releases/
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
852
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
853 At this moment, libsodium-1.0.18-stable-msvc.zip is the latest package.
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
854 Unpack it to anywhere you like, and specify the path to the SODIUM option:
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
855
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
856 nmake -f Make_mvc.mak SODIUM=C:/path/to/libsodium
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
857 (libsodium.dll will be used as the libsodium DLL name.)
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
858
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
859 B) Using MinGW
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
860
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
861 If you use msys2, you can install the libsodium package by pacman (or pacboy):
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
862
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
863 $ pacman -S mingw-w64-x86_64-libsodium # for 64-bit Vim
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
864 $ pacman -S mingw-w64-i686-libsodium # for 32-bit Vim
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
865 $ pacboy -S libsodium:m # for both 32-bit and 64-bit Vim
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
866
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
867 Then set SODIUM to yes:
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
868
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
869 mingw32-make -f Make_ming.mak SODIUM=yes
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
870 (libsodium-23.dll will be used as the libsodium DLL name.)
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
871
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
872 Or you can set the path to libsodium explicitly:
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
873
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
874 mingw32-make -f Make_ming.mak SODIUM=C:/path/to/libsodium
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
875 (libsodium.dll will be used as the libsodium DLL name.)
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
876
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
877
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
878 15. Windows 3.1x
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
879 ================
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
880
8265
792bc43e69a7 commit https://github.com/vim/vim/commit/6e722e2f948bc51fcb92d98d6f2a089dac01e2bd
Christian Brabandt <cb@256bit.org>
parents: 7609
diff changeset
881 The Windows 3.1x support was removed in patch 7.4.1364.
714
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
882
0f9f4761ad9c updated for version 7.0216
vimboss
parents: 605
diff changeset
883
27998
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
884 16. MS-DOS
7553
f0205ac9818f commit https://github.com/vim/vim/commit/30a89473ee64a276215a55e7fa99e008945022df
Christian Brabandt <cb@256bit.org>
parents: 7456
diff changeset
885 ==========
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
886
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
887 The MS-DOS support was removed in patch 7.4.1399. Only very old Vim versions
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
888 work on MS-DOS because of the limited amount of memory available.
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
889
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
890
27998
ef7d9789919d patch 8.2.4524: MS-Windows: cannot build with some sodium libraries
Bram Moolenaar <Bram@vim.org>
parents: 27370
diff changeset
891 17. Installing after building from sources
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
892 ==========================================
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
893
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
894 [provided by Michael Soyka, updated by Ken Takata]
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
895
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
896 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
897 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
898 using Git, Mercurial or by downloading them as a unix tar file, you must
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
899 first create a "vim82" 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
900 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
901 correct directory structure.
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
902
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
903 A. Create a Vim "runtime" subdirectory named "vim82"
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
904 -----------------------------------------------------
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
905 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
906 Otherwise, continue reading.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
907
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
908 Go to the directory that contains the Vim "src" and "runtime"
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
909 directories and create a new subdirectory named "vim82".
7456
2c5e813e8852 commit https://github.com/vim/vim/commit/3c6f92e52ef15df4aa248ce00eacd65928044210
Christian Brabandt <cb@256bit.org>
parents: 6326
diff changeset
910
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
911 Copy the "runtime" files into "vim82":
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
912 copy runtime\* vim82
19163
63beef1ca62c Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 19116
diff changeset
913 xcopy /s runtime\* vim82
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
914
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
915 B. Copy the new binaries into the "vim82" directory
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
916 ----------------------------------------------------
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
917 Regardless of how you installed the Vim sources, you need to copy the
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
918 new binaries you created above into "vim82":
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
919
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
920 copy src\*.exe vim82
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
921 copy src\tee\tee.exe vim82
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
922 copy src\xxd\xxd.exe vim82
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
923
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
924 To install the "Edit with Vim" popup menu, you need both 32-bit and 64-bit
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
925 versions of gvimext.dll. They should be copied to "vim82\GvimExt32" and
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
926 "vim82\GvimExt64" respectively.
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
927 First, build the 32-bit version, then:
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
928
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
929 mkdir vim82\GvimExt32
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
930 copy src\GvimExt\gvimext.dll vim82\GvimExt32
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
931
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
932 Next, clean the 32-bit version and build the 64-bit version, then:
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
933
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
934 mkdir vim82\GvimExt64
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
935 copy src\GvimExt\gvimext.dll vim82\GvimExt64
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
936
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
937 C. Copy gettext and iconv DLLs into the "vim82" directory
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
938 ----------------------------------------------------------
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
939 Get gettext and iconv DLLs from the following site:
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
940 https://github.com/mlocati/gettext-iconv-windows/releases
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
941 Both 64- and 32-bit versions are needed.
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
942 Download the files gettextX.X.X.X-iconvX.XX-shared-{32,64}.zip, extract
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
943 DLLs and place them as follows:
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
944
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
945 vim82\
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
946 | libintl-8.dll
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
947 | libiconv-2.dll
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
948 | libgcc_s_sjlj-1.dll (only for 32-bit)
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
949 |
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
950 + GvimExt32\
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
951 | libintl-8.dll
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
952 | libiconv-2.dll
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
953 | libgcc_s_sjlj-1.dll
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
954 |
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
955 ` GvimExt64\
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
956 libintl-8.dll
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
957 libiconv-2.dll
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
958
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
959 The DLLs in the "vim82" should be the same bitness with the (g)vim.exe.
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
960
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
961 D. Move the "vim82" directory into the Vim installation subdirectory
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
962 ---------------------------------------------------------------------
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
963 Move the "vim82" 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
964 to be installed. Typically, this subdirectory will be named "vim".
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
965 If you already have a "vim82" subdirectory in "vim", delete it first
18174
1ec6539cef68 patch 8.1.2082: some files have a weird name to fit in 8.3 characters
Bram Moolenaar <Bram@vim.org>
parents: 16606
diff changeset
966 by running its uninstall.exe program.
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
967
12781
cd41d47e6033 patch 8.0.1268: PC install instructions are incomplete
Christian Brabandt <cb@256bit.org>
parents: 12610
diff changeset
968 E. Install Vim
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
969 ---------------
19116
9b7f90e56753 Update runtime files.
Bram Moolenaar <Bram@vim.org>
parents: 18662
diff changeset
970 "cd" to your Vim installation subdirectory "vim\vim82" and run the
2951
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
971 "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
972 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
973 - 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
974 parent directory.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
975 - 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
976 popup menu.
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
977 - 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
978 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
979 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
980 - 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
981
57a7998e0fa8 updated for version 7.3.248
Bram Moolenaar <bram@vim.org>
parents: 2871
diff changeset
982 Happy Vimming!